docs(db): v4 定稿 - 决策确认,Phase D 完成

决策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 (系统设计) 正式完成
This commit is contained in:
2026-02-17 13:17:01 +01:00
parent 3f5652e235
commit fda1c8bdda
3 changed files with 279 additions and 122 deletions

108
DECISIONS.md Normal file
View File

@@ -0,0 +1,108 @@
# 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 存 RedisTTL 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*