Inicio Explorar Ayuda
Registro Iniciar sesión
liaoxg
/
num
1
0
Fork 0
Archivos Incidencias 0 Pull Requests 0 Wiki
Árbol: e2d0281551
Ramas Etiquetas
num
/
docs
/
phase1-user-stories.md

phase1-user-stories.md 14 KB
Histórico Raw

Phase 1 用户故事与验收标准

基于 phase1-product-plan.md，每个用户故事包含：标题、描述、验收标准、优先级

EPIC 1：命盘生成与展示（P0）

US-1.1 生日输入与命盘生成

作为 数字能量师
我希望 输入客户的姓名和出生年月日，3秒内生成完整的三角形命盘
以便 取代手动画图，提高工作效率

验收标准：

  1. 输入页面包含：姓名（选填）、出生年份（4位数字）、月份（1-12）、日期（1-31）
  2. 月份和日期支持数字键盘输入，也有下拉选择器
  3. 验证：年份必须为 1900-当前年份、月份 1-12、日期根据月份合法性验证
  4. 输入无效时显示具体错误提示（如"请输入正确的出生日期"）
  5. 点击"生成命盘"后，3秒内显示结果（纯前端计算，无需联网）
  6. 命盘页面 URL 可分享

US-1.2 三角形命盘可视化展示

作为 数字能量师
我希望 看到一个清晰、美观的数字三角形，每个位置都标有数字
以便 直接用于客户讲解

验收标准：

  1. 页面使用 Canvas 绘制三角形，5层15个数字位置完整展示

  2. 布局严格遵循：

         O
   J   K
 F   G   H   I
A   B   C   D   E

  3. 每个数字使用单独的圆形/方形卡片展示，字体清晰易读

  4. 五区使用不同背景色区分（左区/中区/右区/父源/母源/主性格）

  5. 数字颜色：1-9 每个数字有独立颜色（参考能量数字配色）

  6. 卓越数（11/22/33）用特殊标记突出

  7. 底部显示姓名和出生日期信息

US-1.3 数字点击查看含义

作为 数字能量师
我希望 点击三角形中的每个数字可以查看该位置的含义和能量解读
以便 快速向客户解释命盘

验收标准：

  1. 点击三角形中的任一数字卡片，底部弹出该位置的解释面板
  2. 解释面板显示：位置名称（如"主性格"）、数字、性格特质描述
  3. 再次点击或点击空白区域关闭面板
  4. 5区位置的描述文字可配置（后续通过后台修改）

EPIC 2：分享与导出（P0）

US-2.1 命盘分享图片

作为 数字能量师
我希望 将命盘生成为一张精美的图片，分享到微信或保存到相册
以便 发给客户或在朋友圈展示

验收标准：

  1. 分享按钮位于命盘展示页下方
  2. 点击"分享"按钮，生成包含命盘图+姓名+生日的分享卡片
  3. 分享卡片支持：保存到相册 / 分享给微信好友 / 分享到朋友圈
  4. 分享卡片设计精美，带有品牌水印（可选）
  5. 免费用户每日限制 1 次分享，已付费用户不限

US-2.2 命盘PDF导出

作为 数字能量师
我希望 将命盘导出为 PDF 文件，可以直接打印或微信发送
以便 客户获得正式的纸质/电子版报告

验收标准：

  1. PDF 按钮位于命盘展示页（仅已付费用户可见）
  2. 点击后生成包含命盘三角形+姓名+生日+日期的 PDF
  3. PDF 使用 A4 竖版排版，适合打印
  4. 生成过程不超过 5 秒
  5. 生成后自动进入微信文件预览，支持转发给微信好友

EPIC 3：AI 解读（P0）

US-3.1 AI 解读展示

作为 数字能量师
我希望 在命盘生成后，看到由AI自动生成的完整文字解读
以便 直接发给客户或稍作润色后使用，节省自己查资料写解读的时间

验收标准：

  1. 命盘展示页底部有"查看AI解读"按钮，点击跳转到AI解读页
  2. 解读内容由LLM生成，通过云函数调用，首次加载等待时间 < 5秒
  3. 加载过程中显示骨架屏或loading动画，避免用户以为卡死
  4. 解读内容至少包含以下章节：
    • 主性格解读：顶端数字的核心特质、性格描述、代表人物
    • 左区（0-20岁）：早年运势、成长环境
    • 中区（20-40岁）：中年事业、人际关系
    • 右区（40-60岁）：晚年成就、财运趋势
    • 父源区：父亲遗传、先天能量
    • 母源区：母亲遗传、后天影响
  5. 每个章节独立卡片展示，可折叠展开
  6. 解读内容基于命盘的实际数字，同一数字对不同命盘解读不同（位置差异）
  7. 页面底部显示"本解读由AI生成，仅供参考"的免责声明

US-3.2 AI 解读的免费/付费控制

作为 平台运营者
我希望 控制AI解读功能的免费与付费边界
以便 激励用户订阅能量师年服务包

验收标准：

  1. 未付费用户点击"查看AI解读"时，仅显示主性格概要（1段文字）
  2. 未付费用户每日可查看主性格概要 1 次
  3. 五区完整解读仅在已付费后可用
  4. 已付费能量师可无限次查看完整解读
  5. 每次解读请求记录到数据库，用于成本控制和限流

US-3.3 解读内容缓存

作为 系统
我希望 同一命盘的重复解读请求不重复调用LLM API
以便 控制成本，避免同一命盘每次查看都消耗API费用

验收标准：

  1. 首次生成解读后，将解读内容与命盘ID绑定存储到数据库
  2. 后续同一命盘再次查看解读时，直接从数据库读取，不调用LLM
  3. 用户自行重新生成解读时，覆盖旧的缓存内容
  4. 解读缓存永久保留，不自动过期

EPIC 4：付费与订阅（P0）

US-4.1 付费订阅页

作为 数字能量师
我希望 看到清晰的定价方案并进行年费支付
以便 获得AI完整解读等全部功能以及分销推广权限

验收标准：

  1. 付费入口：未付费用户在首页/命盘页/解读页/分享时均会看到升级引导
  2. 付费页展示：功能对比表（普通用户 vs 能量师，突出AI完整解读+分销权）、价格、支付按钮
  3. 价格展示：年费 ¥398（种子价），无首年/续费区分
  4. 功能对比表清晰展示：免费只能看主性格概要，能量师可看五区全解+推广码
  5. 通过微信支付完成订阅
  6. 支付成功后，用户状态即时更新为"能量师"，自动生成专属推广码
  7. 支付失败显示友好提示

US-4.2 订阅状态与续费

作为 付费能量师
我希望 在个人中心看到我的订阅状态、到期日，并能续费
以便 管理我的会员身份

验收标准：

  1. 个人中心显示：订阅状态（能量师/已过期/普通用户）
  2. 显示到期日期，到期前 7 天显示续费提醒
  3. 到期后自动降级为普通用户，分销面板关闭
  4. 续费操作与原付费流程一致

EPIC 5：用户与历史（P1）

US-5.1 微信一键登录

作为 能量师
我希望 使用微信一键登录
以便 不需要注册账号，降低使用门槛

验收标准：

  1. 首次使用点击"生成命盘"时弹出微信授权
  2. 授权后自动完成注册，无需填写额外信息
  3. 后续使用自动登录
  4. 用户信息存储在云数据库中

US-5.2 历史命盘记录

作为 能量师
我希望 查看我过去生成的所有命盘记录
以便 回顾和重用

验收标准：

  1. 个人中心页包含"我的命盘"列表
  2. 列表按生成时间倒序排列
  3. 每条记录显示：姓名、生日、生成时间
  4. 点击记录可跳转到对应的命盘展示页
  5. 支持单条删除
  6. 免费用户仅能看到近 7 天记录，已付费用户可见全部

EPIC 6：分销推广与佣金（P0-P1）

US-6.1 推广码生成

作为 能量师
我希望 在支付升级后自动获得专属推广二维码和推广卡片
以便 分享给微信好友和朋友圈来发展下级能量师

验收标准：

  1. 支付升级成功时，系统自动为该用户生成唯一6位推广码（字母+数字）
  2. 分销面板中展示：专属小程序码图片（可通过云函数生成）、推广卡片、可复制链接
  3. 推广码永久有效，不随年费到期失效
  4. 推广卡片包含：能量师昵称头像 + 小程序码 + "扫码免费测命盘"文案
  5. 支持保存到相册 / 分享给微信好友 / 分享到朋友圈

US-6.2 分享带参注册与上下级绑定

作为 平台
我希望 当用户通过能量师分享的链接/扫码打开小程序时，自动记录上下级关系
以便 为佣金分成打好基础

验收标准：

  1. 能量师分享路径携带推广码参数：/pages/index/index?ref=ABC123
  2. 用户通过该路径打开小程序时：
    • 从 onLoad(options) 读取 ref 参数
    • 将推广码存入本地缓存 pending_referrer
  3. 用户完成微信登录注册时：
    • 检查本地缓存是否有 pending_referrer
    • 若有，解析推广码对应的能量师用户ID
    • 将当前用户的 invitedBy 字段设为该能量师的ID
  4. 关系锁定规则：
    • 上下级关系在首次注册时一次性锁定
    • 后续无论通过谁的链接打开，均不覆盖已有关系
    • 一个用户最多只有一个上级（能量师）
  5. 普通用户注册时未带推广参数 → invitedBy 为空，无上级

US-6.3 佣金结算

作为 平台
我希望 当用户通过能量师A的链接注册并升级为能量师时，自动计算并记录佣金
以便 能量师获得推广收益

验收标准：

  1. 用户支付成功后，云函数触发佣金结算流程
  2. 佣金比例从后台配置读取（默认一级30%/二级10%）
  3. 查询该用户的 invitedBy 字段
  4. 若上级存在且是能量师（订阅有效期内）：
    • 创建一级佣金记录：金额按比例计算（默认 ¥119.4），状态"可提现"
  5. 查询上级的上级：
    • 若上上级存在且是能量师：
    • 创建二级佣金记录：金额按比例计算（默认 ¥39.8），状态"可提现"
  6. 佣金记录写入 commissions 集合，关联订单ID
  7. 无冷静期，支付成功即结算。退款发生时：若佣金未提现则直接撤销；若已提现则从后续佣金中抵扣

US-6.4 分销面板

作为 能量师
我希望 在分销面板中查看我的收益和团队数据
以便 追踪推广效果，激励持续推广

验收标准：

  1. 个人中心有"我的收益"入口（仅能量师可见）
  2. 分销面板展示：
    • 总收益：累计佣金总额
    • 可提现：当前可提现佣金余额
    • 今日新增：今日新增佣金
    • 团队统计：直接下级数 / 间接下级数 / 下级升级为能量师数
  3. 团队列表：按注册时间倒序展示下级用户
  4. 佣金明细列表：展示每笔佣金的时间、来源、金额、状态
  5. "推广工具"区域：重置/保存推广码图片、复制推广链接
  6. "申请提现"按钮（Phase 1 提交申请，平台手动打款）

US-6.5 提现申请

作为 能量师
我希望 在可提现金额达到最低限额后申请提现
以便 将推广收益变现

验收标准：

  1. 可提现金额 ≥ ¥100 时，"申请提现"按钮可点击
  2. 点击后填写提现金额（不得超过可提现金额）
  3. 提交后生成提现申请记录，状态为"待审核"
  4. 平台在后台查看提现申请，手动审核打款
  5. 审核通过后，对应佣金标记为"已完成"，不可再提现
  6. 提现申请记录保留流水号供后续对账
  7. Phase 1 不接入自动打款API，平台手动处理

EPIC 7：批注与客户管理（P2）

US-6.1 命盘批注

作为 能量师
我希望 在命盘图上添加文字批注或标记
以便 为每个客户记录个性化的解读要点

验收标准：

  1. 在命盘展示页添加"编辑批注"按钮（仅已付费用户可见）
  2. 点击后进入批注模式，可添加自由文本
  3. 批注内容保存后，下次查看该命盘时依然可见
  4. 批注支持简单的富文本（分段、加粗等）
  5. 导出的 PDF 中可包含批注内容

US-6.2 客户标签分组

作为 能量师
我希望 为命盘记录添加简单的标签或分组
以便 对客户进行分类管理

验收标准：

  1. 创建命盘时可选择已有标签或新建标签
  2. 标签以颜色 + 文字形式展示
  3. 历史列表支持按标签筛选
  4. 标签管理：新增、编辑、删除

开发优先级总表

用户故事 优先级 预估工期 依赖
US-1.1 生日输入与命盘生成 P0 3天 无
US-1.2 三角形可视化 P0 3天 US-1.1
US-1.3 数字点击查看含义 P2 1天 US-1.2
US-2.1 分享图片 P0 2天 US-1.2
US-2.2 PDF导出 P0 2天 US-1.2
US-3.1 AI解读展示 P0 3天 US-1.1 + LLM API接入
US-3.2 AI解读免费/付费控制 P0 1天 US-3.1
US-3.3 解读内容缓存 P0 1天 US-3.1
US-4.1 付费订阅页 P0 2天 US-5.1
US-4.2 订阅状态 P0 1天 US-4.1
US-5.1 微信登录 P1 2天 无
US-5.2 历史记录 P1 2天 US-5.1
US-6.1 推广码生成 P0 1天 US-4.1
US-6.2 分享带参注册与上下级绑定 P1 2天 US-5.1
US-6.3 佣金结算 P1 2天 US-4.1 + US-6.2
US-6.4 分销面板 P1 2天 US-6.1 + US-6.3
US-6.5 提现申请 P2 1天 US-6.4
US-7.1 批注功能 P2 2天 P0完成
US-7.2 客户分组 P2 2天 P0完成

P0 合计工期：18天（3.5周） P0+P1 合计工期：27天（5.5周）

佣金分成带来裂变增长——每个能量师都成为推广员，获客成本从 ¥50+ 降至 佣金比例（¥119.4/成功转化）。 分销是 Phase 1 增长的引擎，不要砍。