Admin
fda1c8bdda
决策1: 余额+支付宝+微信（复用 pigx-pay） 决策2: 拼车广场 Phase2，一期仅自营 决策3: 凭据查看需二次验证（SMS OTP） 决策4: 邀请返现完全可配置，新增 as_invite_config 表 决策5: 已在 v3 改为关联表 决策6: 提现 Phase2，一期只充值+消费 变更： - 新增 db/ishare_schema_v4_delta.sql（含 as_invite_config） - 新增 DECISIONS.md（完整决策记录） - 更新 DATABASE_DESIGN_OVERVIEW.md（v4 定稿，28张表） Phase D (系统设计) 正式完成
109 lines
3.2 KiB
Markdown
109 lines
3.2 KiB
Markdown
# iShare 设计决策记录
|
||
|
||
> 决策时间：2026-02-17
|
||
> 阶段：Phase D（系统设计）
|
||
|
||
---
|
||
|
||
## 决策1：付费方式（一期）
|
||
|
||
**结论：C — 余额 + 支付宝 + 微信全支持**
|
||
|
||
**原因：** PigX 框架已集成支付功能，无需自行实现，接入成本低。
|
||
|
||
**影响：**
|
||
- `as_order.pay_type`：1=余额, 2=支付宝, 3=微信 ✅（已支持）
|
||
- `as_recharge.pay_type`：同上 ✅
|
||
- 支付接入：复用 `pigx-pay` 模块，配置支付宝/微信商户信息即可
|
||
|
||
---
|
||
|
||
## 决策2：拼车广场
|
||
|
||
**结论：C — 一期不做广场，仅平台自营商品**
|
||
|
||
**原因：** 简化一期功能，降低开发复杂度；拼车广场作为 Phase 2 功能后续追加。
|
||
|
||
**影响：**
|
||
- `as_sub_product.product_type=2`（个人发布）一期不启用
|
||
- `as_user_sub_member.status=4`（等待车主录入凭据）一期不启用
|
||
- `as_user_sub.host_user_id` 一期始终为平台管理员账号
|
||
- 管理后台的"广场审核"模块 Phase 2 再开发
|
||
|
||
---
|
||
|
||
## 决策3：账号凭据展示方式
|
||
|
||
**结论：B — 需二次验证（短信/密码）才能查看**
|
||
|
||
**原因：** 安全优先，防止他人借用设备盗取账号密码。
|
||
|
||
**影响：**
|
||
- 查看凭据接口前置二次验证步骤
|
||
- 验证方式：短信验证码（发到注册手机号）or 账号密码重新输入
|
||
- 实现：OTP 存 Redis（TTL 5min），无需额外数据库表
|
||
- 凭据展示后建议前端自动隐藏倒计时（UX 优化，非强制）
|
||
|
||
---
|
||
|
||
## 决策4：邀请返现规则
|
||
|
||
**结论：完全可配置，无上限**
|
||
|
||
| 配置项 | 说明 |
|
||
|--------|------|
|
||
| 返现类型 | 可配置：固定金额 or 按比例（%） |
|
||
| 返现值 | 数字，根据类型解释为金额或百分比 |
|
||
| 触发条件 | 可配置：仅首次购买 or 每次购买 |
|
||
| 最低订单金额 | 可配置（NULL=不限） |
|
||
| 延迟发放天数 | 可配置（0=立即，N天后发放，防退款刷单） |
|
||
| 返现上限 | 无上限 |
|
||
|
||
**影响：**
|
||
- 新增 `as_invite_config` 表（管理后台可配置规则，同时启用一套）
|
||
- `as_invite.reward_amount` 记录实际发放金额（创建时从当前有效规则快照）
|
||
|
||
---
|
||
|
||
## 决策5：`sub_plan_ids` 关联方式
|
||
|
||
**结论：改为关联表** ✅（已在 v3 执行）
|
||
|
||
---
|
||
|
||
## 决策6：提现功能
|
||
|
||
**结论：B — 二期再做，一期只充值+消费**
|
||
|
||
**原因：** 提现涉及实名认证、合规审核等复杂流程，MVP 阶段不上线。
|
||
|
||
**影响：**
|
||
- `as_wallet_log.type=5`（提现）一期不启用
|
||
- `as_wallet.frozen_amount` 字段保留，一期无写入场景
|
||
- 管理后台"提现审核"模块 Phase 2 开发
|
||
|
||
---
|
||
|
||
## Phase 1 功能范围（最终确认）
|
||
|
||
### ✅ Phase 1 包含
|
||
- 用户注册/登录（手机/邮箱）
|
||
- 首页（Banner + 商品列表）
|
||
- 平台自营商品（product_type=1）购买
|
||
- 余额 + 支付宝 + 微信支付（复用 pigx-pay）
|
||
- 我的订阅 + 账号凭据查看（二次验证）
|
||
- 余额充值（支付宝/微信/人工充值）
|
||
- 邀请推广 + 可配置返现
|
||
- 系统通知（续费提醒/订单通知）
|
||
- 管理后台：平台/商品/账号/订单/用户管理
|
||
|
||
### ❌ Phase 2 延期
|
||
- 拼车广场（个人发布 + 审核流程）
|
||
- 提现功能
|
||
- 微信/社交登录
|
||
- 小程序端
|
||
|
||
---
|
||
|
||
*决策人：Ami · 2026-02-17*
|