# 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 增长的引擎，不要砍。