# 小程序改造 TDD需求方案 v1.1

**创建日期**：2026年1月23日  
**更新日期**：2026年1月23日  
**创建人**：卡若AI  
**状态**：开发中

---

## 一、需求摘要

**一句话定位**：优化Soul创业实验小程序的用户体验，增强核心功能，提升变现转化率。

**核心闭环**：
```
用户打开小程序 → 微信登录 → 浏览内容 → 付费购买 → 推广获益 → 自动提现
                                    ↓
                              匹配合伙人 → 查看档案/认证 → 建立合作
```

---

## 二、项目背景

| 维度 | 内容 |
|:---|:---|
| **项目名称** | 一场Soul的创业实验 - 小程序改造 |
| **项目阶段** | 已上线，功能迭代 |
| **核心目标** | 交互体验优化 + 支付分销上线 |
| **验收人** | 卡若 |
| **代码位置** | `/Users/karuo/Documents/开发/3、自营项目/一场soul的创业实验/miniprogram/` |
| **数据库** | 腾讯云MySQL：56b4c23f6853c.gz.cdb.myqcloud.com:14413 |
| **域名** | https://soul.quwanzhi.com |

### 当前问题（已修复）

| 问题类型 | 具体表现 | 修复状态 |
|:---|:---|:---|
| 登录流程 | 未登录时显示过多功能，干扰用户 | ✅ 已修复 |
| 支付流程 | 需要反复登录才能支付 | ✅ 已修复 |
| 章节显示 | 锁图标和标题错位 | ✅ 已修复 |
| 匹配页面 | 图标和文字对齐问题 | ✅ 已修复 |
| 文案问题 | "分享赚钱"不够高大上 | ✅ 已修复 |
| 数据库 | 使用本地数据库 | ✅ 切换腾讯云 |

---

## 三、已完成功能清单

### 3.1 界面优化

| 模块 | 功能点 | 状态 |
|:---|:---|:---|
| **我的页面** | 未登录只显示登录按钮 | ✅ |
| **章节列表** | 简化锁图标，修复对齐 | ✅ |
| **匹配页面** | 修复次数栏图标对齐 | ✅ |
| **匹配页面** | 删除底部免费次数提示 | ✅ |
| **阅读页面** | 文案优化（推广收益） | ✅ |

### 3.2 支付功能

| 模块 | 功能点 | 状态 |
|:---|:---|:---|
| **微信支付** | 小程序直接调起微信支付 | ✅ |
| **重复购买检测** | 避免重复支付同一章节 | ✅ |
| **静默获取openId** | 已登录用户无需重复登录 | ✅ |
| **测试模式** | 支付服务不可用时可测试 | ✅ |

### 3.3 分销功能

| 模块 | 功能点 | 状态 |
|:---|:---|:---|
| **推广中心** | 显示收益、绑定用户列表 | ✅ |
| **邀请码** | 自动生成专属邀请码 | ✅ |
| **绑定关系** | H5/小程序统一绑定 | ✅ |
| **推广API** | `/api/referral/data` 接口 | ✅ |

### 3.4 后台管理

| 模块 | 功能点 | 状态 |
|:---|:---|:---|
| **章节管理** | `/admin/chapters` 管理页面 | ✅ |
| **价格设置** | 可修改章节价格 | ✅ |
| **免费设置** | 可设置章节免费状态 | ✅ |
| **匹配配置** | `/api/match/config` 接口 | ✅ |

### 3.5 数据库

| 模块 | 表名 | 状态 |
|:---|:---|:---|
| **用户表** | users | ✅ |
| **订单表** | orders | ✅ |
| **推广关系** | referral_bindings | ✅ |
| **匹配记录** | match_records | ✅ |
| **系统配置** | system_config | ✅ |

---

## 四、上线检查清单

### 4.1 小程序配置

- [ ] AppID配置正确：`wxb8bbb2b10dec74aa`
- [ ] 域名白名单：`soul.quwanzhi.com`
- [ ] 支付功能开通
- [ ] 提交审核

### 4.2 服务端配置

- [ ] 腾讯云数据库连接正常
- [ ] 微信支付证书配置
- [ ] API接口全部可用
- [ ] SSL证书有效

### 4.3 支付配置

| 配置项 | 值 |
|:---|:---|
| 小程序AppID | wxb8bbb2b10dec74aa |
| 商户号 | 1318592501 |
| API密钥 | wx3e31b068be59ddc131b068be59ddc2 |
| 回调地址 | https://soul.quwanzhi.com/api/miniprogram/pay/notify |

---

## 五、API接口清单

### 5.1 小程序专用接口

| 接口 | 方法 | 说明 |
|:---|:---|:---|
| `/api/miniprogram/login` | POST | 微信登录获取openId |
| `/api/miniprogram/pay` | POST | 创建支付订单 |
| `/api/miniprogram/pay/notify` | POST | 支付回调 |

### 5.2 通用接口

| 接口 | 方法 | 说明 |
|:---|:---|:---|
| `/api/referral/data` | GET/POST | 推广数据/绑定关系 |
| `/api/match/config` | GET/POST | 匹配规则配置 |
| `/api/admin/chapters` | GET/POST | 章节管理 |
| `/api/db/init` | POST | 数据库初始化 |
| `/api/db/chapters` | GET | 章节内容 |

---

## 六、文案规范

### 6.1 推广相关

| 原文案 | 优化后 |
|:---|:---|
| 分享赚钱 | 立即推广 |
| 分享给好友 | 推荐好友，共同成长 |
| 好友购买你获得90%佣金 | 邀请好友加入，享90%推广收益 |

### 6.2 匹配相关

| 位置 | 文案 |
|:---|:---|
| 匹配次数 | 今日剩余 X次 |
| 购买次数 | ¥1购买1次 |
| 当前模式 | 当前模式: 创业合伙 |

---

## 七、测试用例

### 7.1 登录流程

| 用例 | 操作 | 期望结果 |
|:---|:---|:---|
| 未登录访问"我的" | 打开小程序进入"我的"页面 | 只显示登录按钮，不显示其他功能 |
| 微信登录 | 点击微信登录按钮 | 调起微信授权，登录成功 |
| 登录后显示 | 登录成功 | 显示用户信息和完整功能菜单 |

### 7.2 支付流程

| 用例 | 操作 | 期望结果 |
|:---|:---|:---|
| 购买章节 | 点击"购买本章" | 直接调起微信支付 |
| 重复购买 | 已购章节再次点击购买 | 提示"已购买过此章节" |
| 支付成功 | 完成支付 | 立即更新购买状态，可阅读 |

### 7.3 推广流程

| 用例 | 操作 | 期望结果 |
|:---|:---|:---|
| 查看推广中心 | 点击推广中心 | 显示收益、绑定用户列表 |
| 复制邀请链接 | 点击复制链接 | 链接包含专属邀请码 |
| 分享文案 | 点击分享到朋友圈 | 复制推广文案 |

---

## 八、下一步计划

### 待开发功能

| 功能 | 优先级 | 说明 |
|:---|:---|:---|
| 全站搜索 | P1 | 搜索章节标题和内容 |
| 阅读进度同步 | P1 | 小程序↔网页端同步 |
| 自动提现 | P2 | 满100元自动提现 |
| 合伙人档案 | P2 | 详细档案和认证体系 |

### 本期目标

1. ✅ 支付功能可用
2. ✅ 分销功能可用
3. ✅ 界面优化完成
4. ⏳ 提交小程序审核上线

---

**方案版本**：v1.1  
**创建时间**：2026-01-23  
**更新时间**：2026-01-23  
**下次评审**：上线后