fnvtk/soul

Files

🎨 界面修复:
- 修复章节列表锁图标和标题错位（用简单符号替代emoji）
- 修复匹配页今日剩余图标和文字对齐
- 删除匹配页底部'每天3次免费匹配'提示

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

📄 文档更新:
- 更新需求方案文档v1.1
- 添加上线检查清单
- 完善API接口文档

2026-01-23 17:37:40 +08:00

6.2 KiB

Raw Permalink Blame History

小程序改造 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	详细档案和认证体系

本期目标

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

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

6.2 KiB Raw Permalink Blame History Unescape Escape