Files
work_flow_ishare/DECISIONS.md
Admin 2e34dd172b init: iShare Phase D 设计文档完整归档
文档清单:
- README.md                     仓库导航
- iShare-dev-plan.md            开发规划
- SYSTEM_DESIGN.md              系统设计(角色/流程/接口)
- DATABASE_DESIGN_V2.md         数据库完整字段设计
- DATABASE_DESIGN_OVERVIEW.md   设计概要 v4(28张表)
- DECISIONS.md                  6个关键决策记录
- db/ishare_schema_v2.sql       基础建表 SQL
- db/ishare_schema_v3_delta.sql v2→v3 增量(评审修复)
- db/ishare_schema_v4_delta.sql v3→v4 增量(决策确认)
- memory_2026-02-17.md          工作日志

Phase D 完成:28张表定稿,所有决策已确认
2026-02-17 13:27:34 +01:00

3.2 KiB
Raw Permalink Blame History

iShare 设计决策记录

决策时间2026-02-17
阶段Phase D系统设计


决策1付费方式一期

结论C — 余额 + 支付宝 + 微信全支持

原因: PigX 框架已集成支付功能,无需自行实现,接入成本低。

影响:

  • as_order.pay_type1=余额, 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 记录实际发放金额(创建时从当前有效规则快照)

决策5sub_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