数字能量小程序测试清单

所属角色: shu-zi-neng-liang-test-engineer 基于: phase1-product-plan.md, phase1-user-stories.md, system-spec.md 版本: v1.0

模块清单

模块	文件/组件	优先级
首页输入	index.js + index.wxml + index.wxss	P0
三角形命盘	chart.js + chart.wxml + chart.wxss + triangle组件	P0
AI解读	reading.js + reading.wxml + reading.wxss	P0
付费订阅	subscribe.js + subscribe.wxml + subscribe.wxss	P0
个人中心	profile.js + profile.wxml + profile.wxss	P1
分销面板	distribution.js + distribution.wxml + distribution.wxss	P1
计算引擎	calculator.js	P0
App全局	app.js + app.wxss + app.json	P1
云函数: 用户注册	registerUser/index.js	P1
云函数: 会话检查	checkSession/index.js	P1
云函数: AI解读	generateReading/index.js	P0
云函数: 支付创建	createPayment/index.js	P0
云函数: 佣金查询	getCommission/index.js	P1
云函数: 提现申请	applyWithdraw/index.js	P1
云函数: 二维码	getQRCode/index.js	P1
云函数: 上级查询	getReferrerInfo/index.js	P1
云函数: 支付回调	paymentCallback/index.js	P0

测试用例清单

TC-01: 计算引擎 (P0)

#	用例	输入	预期结果
1.1	个位数原样返回	reduceToDigit(5)	5
1.2	两位数归约	reduceToDigit(10)	1
1.3	多位数归约	reduceToDigit(99)	9
1.4	多位数归约链	reduceToDigit(999)	9
1.5	卓越数11保留	reduceToDigit(11)	11
1.6	卓越数22保留	reduceToDigit(22)	22
1.7	卓越数33保留	reduceToDigit(33)	33
1.8	完整命盘-已知日期	calculateTriangle(1990, 1, 1)	手算验真15个位置
1.9	完整命盘-月份两位数	calculateTriangle(1985, 12, 25)	D=3, E=7
1.10	完整命盘-日两位数	calculateTriangle(2000, 6, 15)	D=6, E=6
1.11	完整命盘-年份奇数	calculateTriangle(2001, 3, 8)	A=2, B=0, C=1
1.12	主性格卓越数	calculateTriangle(1994, 5, 12)	O 可能是22/33
1.13	五区sum值	各场景	sum=reduceToDigit(各位置值和)
1.14	数字含义1-9完整	1-9	均有title和trait
1.15	卓越数字含义	11, 22, 33	有特殊含义

TC-02: 页面交互与状态 (P0)

#	用例	步骤	预期结果
2.1	未登录用户可输入	打开首页，填写日期	可操作，不强制登录
2.2	推广链接打开	URL带?ref=ABC123	底部显示分享者信息，缓存推广码
2.3	免费用户3次限制	连续生成4次命盘	第4次弹出"次数已用完"引导订阅
2.4	能量师无限生成	能量师身份不限次	不会触发次数限制
2.5	跨午夜重置	00:00后检查	免费配额重置为0/3
2.6	无效日期输入	月份=13, 日期=32	显示验证错误提示
2.7	空字段提交	不选择年月日直接点生成	提示"请填写完整的出生日期"
2.8	chart页历史id查找	点击历史记录中的命盘	正确加载对应命盘数据
2.9	chart页无效id	URL手动修改为不存在id	显示空状态/错误提示
2.10	免费用户解读限制	免费用户查看AI解读	仅显示主性格概要
2.11	能量师完整解读	能量师查看AI解读	显示主性格+五区完整内容
2.12	解读缓存	两次进入同一命盘解读页	第二次不调用云函数，使用本地缓存
2.13	解读加载状态	首次进入解读页	显示骨架屏/loading动画
2.14	解读内容折叠展开	点击章节标题	正确折叠/展开内容卡片
2.15	免责声明存在	解读页底部	显示"本解读由AI生成，仅供参考"

TC-03: Canvas可视化 (P0)

#	用例	步骤	预期结果
3.1	五层十五格绘制	生成命盘 → chart页	5层15个数字卡片完整绘制
3.2	连接线	检查线条	底层→顶层所有连接线正确
3.3	数字颜色	1-9每个数字	颜色与DIGIT_COLORS配置一致
3.4	卓越数高亮	主性格=11/22/33	金底+星标+边框加粗
3.5	位置标签	每个数字下方	显示getPositionName的对应名称
3.6	点击交互	点击数字卡片	弹出含义面板（title+trait+position）
3.7	区域背景色	五区	使用ZONE_COLORS颜色区分
3.8	姓名生日显示	命盘上方	显示姓名和出生日期
3.9	320px宽屏幕	iPhone SE	不溢出，数字不重叠
3.10	414px宽屏幕	iPhone Plus	布局适配
3.11	2x倍屏	devicePixelRatio=2	渲染清晰无锯齿
3.12	3x倍屏	devicePixelRatio=3	渲染清晰无锯齿

TC-04: 云函数 - generateReading (P0)

#	用例	输入	预期结果
4.1	正常请求	完整chartData + name	code=0, 6段解读字符串非空
4.2	缺少positions	{}	code=400, error="缺少命盘数据"
4.3	LLM超时	模拟超时	触发_fallbackReading降级解读
4.4	LLM返回非JSON	非法响应	code=0, mainCharacter=原始文本
4.5	LLM返回JSON in markdown	`json ...`	正确解析JSON内容
4.6	缓存读取	第二次请求同命盘	不走云函数，从本地存储读取

TC-05: 支付订阅 (P0)

#	用例	步骤	预期结果
5.1	未登录跳转支付	未登录用户点击订阅	引导登录或正常跳转
5.2	支付loading	点击"立即开通"	按钮变为loading状态，不可重复点击
5.3	支付成功	模拟支付成功回调	role→practitioner, expireAt→+1年
5.4	支付后推广码	支付成功后的checkSession	referralCode非空(6位)
5.5	支付取消	用户取消支付	停留在当前页，角色不变
5.6	支付失败	模拟支付失败	显示"支付失败，请重试"
5.7	功能对比表	订阅页内容	正确展示免费vs能量师差异
5.8	价格显示	订阅页	¥398/年，¥1.09/天正确

TC-06: 分销链路 (P1)

#	用例	步骤	预期结果
6.1	推广码自动生成	支付成功后	6位字母+数字唯一码
6.2	推广码持久化	重新登录	推广码不变
6.3	分享卡片携带ref	能量师分享	path包含?ref=CODE
6.4	推广链接打开参数	onLoad(options)	正确读取ref并缓存
6.5	注册时绑定上级	新用户带ref注册	invitedBy=上级openid
6.6	上级统计更新	新用户注册	directCount+1
6.7	关系终身锁定	第二次通过他人链接注册	不覆盖原有invitedBy
6.8	自邀请不绑定	自己扫自己的码	invitedBy为空
6.9	一级佣金结算	下级付费¥398	佣金=¥119.4, status=available
6.10	二级佣金结算	下级的下级付费	佣金=¥39.8, status=available
6.11	佣金取值精确	浮动计算	两位小数精确
6.12	佣金状态流转	pending→available→completed	按业务规则流转
6.13	提现条件验证	可提现金额<¥100	"申请提现"不可点击
6.14	提现申请提交	金额合法	记录创建status=pending
6.15	提全额按钮	点击"全部提现"	输入框填充可提现金额
6.16	超额提现拦截	输入>可提现	提示"超出可提现金额"

TC-07: 用户体系与历史记录 (P1)

#	用例	步骤	预期结果
7.1	微信登录	点击微信登录	获取用户信息，创建/查询用户
7.2	重复登录	同一用户再次登录	返回isNew=false
7.3	登录后状态持久化	关闭重开小程序	token有效时自动登录
7.4	会话过期	token无效	自动跳转为未登录状态
7.5	历史列表显示	个人中心页	按时间倒序，显示姓名/生日/主性格
7.6	历史点击跳转	点击历史记录	跳转到对应chart页
7.7	免费用户7天限制	8天前的记录	不显示
7.8	能量师全部历史	所有记录	全部显示
7.9	历史记录超100条	生成101+命盘	仅保留最近100条
7.10	订阅状态显示	个人中心	能量师显示"已开通"+到期日

TC-08: 边界与异常 (P0/P1)

#	用例	预期结果
8.1	年月日全部为空	提示填写完整日期
8.2	年份=1899	日期选择器不可选
8.3	年份=2100	不可选（超过当前年份）
8.4	月份=0	picker限制不可选
8.5	月份=13	picker限制不可选
8.6	日期=0	picker限制不可选
8.7	日期=32	picker限制不可选
8.8	闰年2/29	合法输入，正常计算
8.9	非闰年2/29	picker不可选
8.10	姓名20字符	截断处理
8.11	姓名全空格	显示"未知"
8.12	姓名特殊字符	正常显示
8.13	命盘id含特殊字符	能正确查找
8.14	弱网场景(3G模拟)	云函数超时能有降级UI
8.15	断网场景	提示网络错误，不崩溃
8.16	存储空间满	存储失败时的降级

TC-09: 合规检查 (P0)

#	检查项	通过标准
9.1	首页文案	不含"算命、占卜、预测、占星"
9.2	AI解读免责声明	末尾包含"本解读由AI生成，仅供参考"
9.3	用户协议链接	可点击，打开的页面有效
9.4	隐私政策链接	可点击，打开的页面有效
9.5	不得收集敏感信息	无身份证/银行卡输入
9.6	支付合规	微信支付规范无违规文案
9.7	分销合规	两级分销，无团队计酬，无入门费

测试环境要求

项目	配置
微信基础库	3.7.1+
iOS	iPhone 13/14/15, iOS 16+
Android	华为/小米/OPPO, Android 12+
微信版本	8.0+
云开发环境	test/dev独立环境（非production）
测试账号	至少3个：普通用户A、能量师B、普通用户C(从B邀请注册)

严重等级定义

等级	定义	响应时间
S0-Critical	核心链路阻塞（无法生成命盘/支付/解读）	立即修复
S1-Major	功能严重异常（计算错误/状态错乱/数据丢失）	24h内
S2-Minor	功能可用但体验缺陷（UI错位/文案错误）	下一迭代
S3-Trivial	视觉/文案微调建议	积攒修复