# 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*