219 lines
6.2 KiB
Markdown
219 lines
6.2 KiB
Markdown
# 小程序改造 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
|
||
**下次评审**：上线后 |