小程序改造 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 小程序配置
4.2 服务端配置
4.3 支付配置
五、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 |
详细档案和认证体系 |
本期目标
- ✅ 支付功能可用
- ✅ 分销功能可用
- ✅ 界面优化完成
- ⏳ 提交小程序审核上线
方案版本：v1.1
创建时间：2026-01-23
更新时间：2026-01-23
下次评审：上线后
