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 (系统设计) 正式完成
3.2 KiB
3.2 KiB
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