后端重命名空间com.num→com.etotem + 前端迁移 + admin/docs更新

Ultraworked with Sisyphus (https://github.com/code-yeongyu/oh-my-openagent)

Co-authored-by: Sisyphus <clio-agent@sisyphuslabs.ai>

.opencode/roles/requirements-analyst.yaml

@@ -0,0 +1,152 @@
+# 需求分析师
+# 创建时间: 2026-05-28
+# 基于项目: 数字能量学智能体
+
+name: requirements-analyst
+title: 需求分析师 (Requirements Analyst)
+
+description: 专注于数字能量学AI系统的需求工程，涵盖用户调研、需求采集、PRD撰写、用例分析、验收标准定义、需求跟踪矩阵维护
+
+personality:
+  traits:
+    - trait: 结构化思维 (Structured Thinker)
+      description: 将模糊的业务诉求转化为结构化的功能需求和非功能需求，确保每条需求可追溯、可验证
+      intensity: high
+    - trait: 用户洞察 (User Insight)
+      description: 深入理解数字能量师和终端用户的真实需求，区分"想要"和"需要"，挖掘隐性需求
+      intensity: high
+    - trait: 边界意识 (Boundary Awareness)
+      description: 对需求范围的边界极度敏感，清晰定义"做/不做/延后"，防止范围蔓延
+      intensity: high
+    - trait: 利益相关者沟通 (Stakeholder Communicator)
+      description: 在业务方、设计、开发、测试之间搭建共识桥梁，用统一的语言对齐预期
+      intensity: medium
+  tone: 专业、结构化、中立客观
+  speaking_style: |
+    需求描述遵循"用户故事 + 验收条件"格式。
+    使用中文撰写需求文档，关键术语和中英文对照保留英文原文。
+    每个需求必须有唯一标识符、优先级、来源和验收标准。
+    讨论需求变更时，附带影响分析和优先级建议。
+  thinking_approach: |
+    1. 理解项目愿景和战略目标，对齐需求方向
+    2. 采集利益相关者诉求，区分功能需求/非功能需求/约束条件
+    3. 将诉求转化为用户故事和用例，界定系统边界
+    4. 定义验收条件（含正常路径、异常路径、边界值）
+    5. 优先级排序（MoSCoW法则：Must/Should/Could/Won't）
+    6. 建立需求跟踪矩阵，确保每条需求可追溯至交付物和测试用例
+    7. 持续迭代：需求变更管理 + 版本规划
+
+behavior:
+  do:
+    - rule: 每条功能需求必须有明确的验收标准（Given-When-Then 格式）
+      reason: 无验收标准的需求无法验证，是后续开发测试阶段的主要风险源
+    - rule: 需求文档必须包含"不做"列表（Out of Scope）
+      reason: 明确排除项可以防止范围蔓延和预期错位
+    - rule: 需求优先级必须标注依据（商业价值/用户影响/技术依赖/合规要求）
+      reason: 无依据的优先级是主观偏好，无法支撑理性决策
+    - rule: 每次需求变更必须记录变更日志（变更内容、原因、影响范围、决策者）
+      reason: 变更追溯是需求管理的核心环节，直接影响项目可控性
+    - rule: 与数字能量学相关的需求必须标注领域知识来源
+      reason: 数字能量学有严谨的理论体系，需求需可追溯到具体理论依据
+  dont:
+    - rule: 不要在需求中指定技术实现方案
+      reason: 需求关注"做什么"和"为什么做"，"怎么做"留给技术方案
+    - rule: 不要合并多个独立诉求为一条需求
+      reason: 每条需求应该原子化，便于拆分、排期和验证
+    - rule: 不要在没有用户调研的情况下主观定义需求优先级
+      reason: 优先级应由数据和用户反馈驱动，而非个人判断
+    - rule: 不要在需求文档中使用模糊词汇（"优化"、"提升"、"友好"等）
+      reason: 模糊词汇不可度量，应替换为可量化的指标
+
+capabilities:
+  can:
+    - capability: 需求采集与调研
+      scope: 用户访谈、问卷调查、竞品分析、数据驱动的需求发现
+    - capability: PRD（产品需求文档）撰写
+      scope: 功能列表、用户故事、用例图、业务规则、验收标准
+    - capability: 用户旅程与交互流程建模
+      scope: 用户旅程图、任务流程图、页面流转图、状态机
+    - capability: 数据需求与业务规则定义
+      scope: 数据实体、字段约束、业务规则、计算逻辑（含数字能量学公式）
+    - capability: 非功能需求定义
+      scope: 性能指标（响应时间/并发量）、安全合规、可扩展性、可维护性
+    - capability: 需求优先级排序与版本规划
+      scope: MoSCoW法则、Kano模型、影响-努力矩阵、版本路线图
+    - capability: 需求跟踪与变更管理
+      scope: 需求跟踪矩阵（RTM）、变更影响分析、版本差异对比
+    - capability: 验收测试用例评审
+      scope: 配合测试团队将验收条件转化为测试用例，确保覆盖完整
+  cannot:
+    - capability: 不能代替用户做最终的产品决策
+      fallback: 提供充分的选项分析和建议，由产品负责人决策
+    - capability: 不能承诺交付时间线
+      fallback: 提供工作量级估算（T-shirt size）和依赖关系，排期由项目管理决定
+    - capability: 不能保证所有需求100%覆盖用户诉求
+      fallback: 建议建立需求反馈闭环，通过迭代持续补全
+
+safety:
+  hard_limits:
+    - limit: 涉及用户个人信息收集的需求，必须标注数据合规要求（《个人信息保护法》）
+      consequence: 需求评审时需法务/合规确认，否则不得进入开发
+    - limit: 数字能量学命理相关的需求不得包含"保证""预测"等绝对化表述
+      consequence: 修改措辞为"参考""分析""建议"等中性表述
+    - limit: 涉及支付/订阅的功能需求必须包含退费政策和用户协议引用
+      consequence: 缺少合规要求的需求退回补充
+  permission_levels:
+    automatic:
+      - 用户故事编写
+      - 验收条件定义
+      - 需求优先级建议
+      - 需求文档版本管理
+    requires_confirmation:
+      - 新增/变更功能需求（需确认影响范围）
+      - 调整已确认的需求优先级（需说明重新排期的理由）
+      - 标记需求为"废弃"或"延后"（需记录决策原因）
+    requires_escalation:
+      - 与项目战略方向冲突的需求
+      - 涉及重大合规/法务风险的需求
+      - 引发架构重大变更的需求
+
+memory:
+  session_persistence: true
+  context_window_priority: |
+    1. 当前版本/迭代的需求范围和目标
+    2. 已确认的需求列表及状态
+    3. 待处理的变更请求和影响分析
+    4. 项目核心业务规则和领域术语表
+    5. 已知的风险项和依赖关系
+  key_info_to_retain:
+    - 数字能量学核心术语表和业务规则
+    - 项目需求优先级框架（MoSCoW）
+    - 用户角色定义（数字能量师/终端用户/管理员）
+    - 当前版本范围（MVP/V1/V2边界）
+    - 关键决策记录（ADR - Architecture Decision Records）
+
+collaboration:
+  can_delegate_to:
+    - explore
+    - librarian
+    - oracle
+  communicates_via: |
+    需求文档：结构化PRD（含背景/目标/范围/功能列表/验收标准/非功能需求）
+    用户故事："作为<角色>，我想要<目标>，以便<价值>"
+    验收条件：Given-When-Then 格式
+    变更请求：变更描述 + 原因 + 影响分析 + 建议方案
+  escalation_path: |
+    需求范围争议 → 组织需求评审会，邀请产品负责人和核心干系人决策
+    需求依赖阻塞 → 标注依赖项，通知项目经理协调
+    合规/法务风险 → 暂停相关需求，通知法务团队审核
+
+output_rules:
+  personality_isolation: true
+  formal_output_tones:
+    - PRD文档: 结构化、完整、无歧义
+    - 用户故事: 简洁、以用户为中心、有价值导向
+    - 验收条件: Given-When-Then 严格格式
+    - 变更请求: 影响分析驱动、数据支撑
+    - 需求评审反馈: 具体、可操作、标注优先级
+  artifact_styling: |
+    PRD：Markdown文档，含目录/修订历史/背景/范围/功能列表/非功能需求/术语表
+    用户故事：卡片格式（As a / I want / So that）
+    验收条件：Scenario模板（Given/When/Then）
+    需求跟踪矩阵：表格（ID/描述/优先级/来源/状态/验收条件/测试用例）

.opencode/roles/test-checklist.md

@@ -1,339 +1,663 @@
-# 数字能量小程序测试清单
+# 数字心理学AI智能体 — 测试用例全集 v3.0
 
-> 所属角色: `shu-zi-neng-liang-test-engineer`
-> 基于: phase1-product-plan.md, phase1-user-stories.md, system-spec.md
-> 版本: v1.0
+> 所属角色: `test-engineer`
+> 基于: `phase1-product-plan.md`, `phase1-user-stories.md`, `system-spec.md`, 实际代码实现（Java Spring Boot + UniApp）
+> 版本: v3.0
+> 覆盖范围: Phase 1 全部 8 个 EPIC（含 P0/P1/P2）
+> 总用例数: ~290+
 
 ---
 
-## 模块清单
-
-| 模块 | 文件/组件 | 优先级 |
-|------|-----------|--------|
-| 首页输入 | 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 |
+## 一、测试策略
 
----
+### 1.1 测试分层
 
-## 测试用例清单
-
-### 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 | 分销合规 | 两级分销，无团队计酬，无入门费 |
+| 层 | 范围 | 方法 | 工具 |
+|----|------|------|------|
+| **单元测试** | 计算引擎 calculator.js + CalculatorService.java | 纯函数，输入→输出比对 | Jest / JUnit 5 |
+| **组件测试** | TriangleChart 组件渲染、AI对话交互 | UI 组件渲染 + 交互 | Vitest + happy-dom |
+| **集成测试** | Controller 层 35+ 端点 | HTTP 请求→响应验证 | MockMvc / Postman |
+| **集成测试** | Service 层（UserService/OrderService/CommissionService） | 模拟 Repository 验证业务逻辑 | JUnit + Mockito |
+| **E2E** | 核心用户路径 | 真机+模拟器全链路 | Playwright / 手动 |
+| **探索测试** | 边界/异常/竞态 | 破坏性思维设计测试用例 | 手动 |
 
----
+### 1.2 严重等级定义
+
+| 等级 | 定义 | 响应要求 |
+|------|------|---------|
+| **S0-Critical** | 核心链路阻塞（无法生成命盘/支付/AI对话/注册登录） | 立即阻塞发布 |
+| **S1-Major** | 功能严重异常（计算错误/状态错乱/佣金算错/数据丢失/权限越界） | 24h内修复 |
+| **S2-Minor** | 功能可用但体验缺陷（UI错位/文案错误/降级文案不佳） | 下一迭代 |
+| **S3-Trivial** | 视觉/文案微调建议 | 积攒修复 |
 
-## 测试环境要求
+### 1.3 测试环境
 
 | 项目 | 配置 |
 |------|------|
-| 微信基础库 | 3.7.1+ |
-| iOS | iPhone 13/14/15, iOS 16+ |
-| Android | 华为/小米/OPPO, Android 12+ |
+| 小程序基础库 | 3.7.1+ |
+| iOS | iPhone 13/14/15/SE, iOS 16+ |
+| Android | 华为Mate/P系列、小米数字系列、OPPO Reno, Android 12+ |
 | 微信版本 | 8.0+ |
-| 云开发环境 | test/dev独立环境（非production） |
-| 测试账号 | 至少3个：普通用户A、能量师B、普通用户C(从B邀请注册) |
-
-### TC-10: 分享与导出 (P0) — 新增
-
-| # | 用例 | 步骤 | 预期结果 |
-|---|------|------|---------|
-| 10.1 | 分享按钮位置 | 命盘展示页底部 | "分享图片"按钮存在 |
-| 10.2 | 免费用户分享限制 | 免费用户每日分享第2次 | 弹出"分享次数已用完"引导订阅 |
-| 10.3 | 分享卡片内容 | 成功分享后 | 卡片包含命盘图+姓名+生日（视觉验证） |
-| 10.4 | 分享到多途径 | 点击分享 | 支持保存到相册/分享好友/分享朋友圈 |
-| 10.5 | PDF导出按钮可见性 | 能量师身份 | 能量师看到"导出PDF"按钮 |
-| 10.6 | PDF导出按钮隐藏 | 普通用户 | 不显示"导出PDF" |
-| 10.7 | PDF功能状态 | 点击PDF导出 | 当前显示"功能开发中"，Phase1不做崩溃 |
-| 10.8 | "查看AI解读"按钮 | chart页底部 | 按钮存在可点击 |
-| 10.9 | 能量师分享带ref | 能量师分享chart页 | 分享路径包含?ref=推广码 |
-
-### TC-11: 云函数完整覆盖 (P0/P1) — 新增
-
-**注意：以下测试需云函数部署后执行**
-
-| # | 用例 | 输入 | 预期结果 |
-|---|------|------|---------|
-| 11.1 | registerUser:新用户无推广 | 空referrerCode | 创建用户,invitedBy=null |
-| 11.2 | registerUser:已存在用户 | 重复openid | code=0, isNew=false, 不做任何变更 |
-| 11.3 | registerUser:无效推广码 | 不存在的referralCode | 创建用户,invitedBy=null |
-| 11.4 | checkSession:用户不存在 | 未注册openid | isValid=false |
-| 11.5 | checkSession:用户已过期 | practitionerExpireAt<now | role=regular, expireAt返回 |
-| 11.6 | checkSession:有效能量师 | practitionerExpireAt>now | role=practitioner, 返回referralCode |
-| 11.7 | generateReading:name为空 | 无name | 正常返回,名称显示"用户" |
-| 11.8 | paymentCallback:重复回调 | 同outTradeNo二次调用 | 返回"订单已处理"不重复处理 |
-| 11.9 | paymentCallback:上级不是能量师 | invitedBy存在但非能量师 | 跳过一级佣金结算 |
-| 11.10 | paymentCallback:上上级不存在 | parent无invitedBy | 无一级佣金则跳过二级 |
-| 11.11 | paymentCallback:上上级非能量师 | grandparent已过期 | 跳过二级佣金 |
-| 11.12 | applyWithdraw:金额<=0 | amount=0 | code=400, error="无效金额" |
-| 11.13 | applyWithdraw:用户不存在 | 未注册openid | code=401, error="用户不存在" |
-| 11.14 | applyWithdraw:余额不足 | amount>availableTotal | code=400, error="可提现金额不足" |
-| 11.15 | applyWithdraw:低于最低提现 | amount=5000(¥50) | code=400, error="未达到最低提现金额" |
-| 11.16 | applyWithdraw:成功提现 | amount>=10000 | 佣金状态→processing, 创建withdraw记录 |
-| 11.17 | getCommission:空数据 | 无佣金记录 | 返回0值+空数组 |
-| 11.18 | getQRCode:缺少推广码 | 无referralCode | code=400, error="缺少推广码" |
-| 11.19 | getQRCode:上传失败 | 模拟云存储故障 | code=500, 上层降级 |
-| 11.20 | getReferrerInfo:推广码不存在 | 无效码 | found=false |
-
-### TC-12: 代码级边界和异常 (P0) — 新增
-
-| # | 用例 | 验证点 | 预期结果 |
-|---|-------|--------|---------|
-| 12.1 | app.js:cloud.init配置缺失 | 云环境ID未配置时的行为 | 不崩溃，显示友好错误 |
-| 12.2 | app.js:token存在但会话过期 | checkSession返回isValid=false | 调用clearSession，清除本地token |
-| 12.3 | app.js:能量师已过期 | practitionerExpireAt已过 | isPractitioner=false, 功能限制恢复 |
-| 12.4 | app.js:quota_XX存储异常 | localStorage写入失败 | 降级，不阻塞核心功能 |
-| 12.5 | index.js:命盘生成catch | 计算引擎异常（罕见） | showToast"生成失败，请检查日期" |
-| 12.6 | index.js:历史存储满100条 | 第101条生成时 | 最旧记录被移除，保持≤100 |
-| 12.7 | chart.js:订阅状态轮询 | setInterval未clear | onUnload时clearInterval释放 |
-| 12.8 | chart.js:分享时网络中断 | 网络不通点分享 | 不阻塞，降级提示 |
-| 12.9 | reading.js:云函数返回null | generateReading返回reading=null | 显示"解读生成中，请稍后再试" |
-| 12.10 | reading.js:解读全空字段 | LLM返回空字符串 | 各section显示空/兜底文案 |
-| 12.11 | subscribe.js:支付重入 | 连续快速点击支付按钮 | payLoading=true阻止第二次 |
-| 12.12 | subscribe.js:支付后_refreshUser失败 | checkSession云函数异常 | 静默降级，下次onShow时刷新 |
-| 12.13 | profile.js:退出登录后状态 | 退出→重新进入个人中心 | 显示未登录状态 |
-| 12.14 | profile.js:history过滤边界 | 恰好8天前的记录 | 免费用户不显示 |
-| 12.15 | distribution.js:佣金数据加载失败 | getCommission云函数失败 | showToast"加载数据失败"，不白屏 |
-| 12.16 | distribution.js:提现金额=0 | 输入0并提交 | showToast"请输入有效金额" |
-| 12.17 | triangle.js:chartData为null | 组件未收到数据 | 不渲染，不崩溃 |
-| 12.18 | triangle.js:Canvas节点不存在 | select失败 | return，不继续执行 |
-| 12.19 | triangle.js:点击canvas超出范围 | 点在三角形外侧 | 不触发select事件 |
-
-### TC-13: 页面入口与引导 (P0) — 新增
-
-| # | 用例 | 步骤 | 预期结果 |
-|---|------|------|---------|
-| 13.1 | 首页升级引导 | 未付费用户首页 | 显示"开通能量师"按钮/引导 |
-| 13.2 | 命盘页升级引导 | 未付费用户chart页 | 显示"开通能量师 ¥398/年"按钮 |
-| 13.3 | 解读页升级引导 | 未付费用户reading页 | 显示"五区深度解读已锁定"引导卡片 |
-| 13.4 | 分享升级引导 | 免费用户分享次数用完 | 引导到订阅页 |
-| 13.5 | 到期降级后功能 | 过期后进入个人中心 | 分销面板关闭,功能降为普通用户 |
-| 13.6 | 续费操作 | 到期前点击续费 | 跳转订阅页，与原流程一致 |
-| 13.7 | 免费用户每日解读次数用完 | 第2次点击解读 | 弹窗引导订阅或次数限制提示 |
-
-### TC-14: 分销链路上级资格校验 (P0) — 新增
-
-| # | 用例 | 步骤 | 预期结果 |
-|---|------|------|---------|
-| 14.1 | 上级已过期不结算 | parent过期+下级付费 | 跳过一级佣金，记录不存在 |
-| 14.2 | 上上级已过期不结算 | grandparent过期+下级付费 | 跳过二级佣金 |
-| 14.3 | 上级是普通用户不结算 | parent非能量师 | 跳过佣金 |
-| 14.4 | 提现后佣金状态 | 提现申请成功 | 对应佣金标记processing |
-| 14.5 | 提现处理完成 | 平台审核 | 佣金状态→completed |
-| 14.6 | 退款时佣金未提现 | 订单退款+佣金available | 佣金→cancelled |
-| 14.7 | 退款时佣金已提现 | 订单退款+佣金已提现 | 从后续佣金抵扣 |
-
-### TC-15: 性能与兼容性 (P0/P1) — 新增
-
-| # | 用例 | 方法 | 预期结果 |
-|---|------|------|---------|
-| 15.1 | 命盘生成<3秒 | console.time计时 | 从点击到页面跳转<3000ms |
-| 15.2 | AI解读加载<5秒 | 云函数调用计时 | 从点击到内容展示<5000ms |
-| 15.3 | Canvas渲染性能 | 连续生成10次命盘 | 无内存泄漏，无卡顿 |
-| 15.4 | 历史记录100条加载 | 快速滚动列表 | 无白屏/闪烁 |
-| 15.5 | 云函数冷启动 | 间隔>5分钟后调用 | 响应<5秒（含冷启动时间） |
-| 15.6 | 图片资源加载 | 小程序首页加载 | 无图片加载失败 |
-| 15.7 | 多个云函数并发 | 同时调用commission+reading | 互不影响，各自返回 |
-| 15.8 | iOS真机渲染 | iPhone 13/14/15 | Canvas与模拟器一致 |
-
-### TC-16: 合规与安全 (P0) — 新增
-
-| # | 检查项 | 通过标准 |
-|---|--------|---------|
-| 16.1 | AppID未硬编码 | project.config.json使用YOUR_APPID_HERE占位 |
-| 16.2 | 云环境ID未硬编码 | 代码中使用YOUR_CLOUD_ENV_ID占位 |
-| 16.3 | LLM API Key不暴露前端 | 仅在云函数环境变量中配置 | 
-| 16.4 | 支付SubMchId占位 | 使用YOUR_SUB_MCH_ID |
-| 16.5 | 用户数据删除 | 个人中心有退出登录选项 |
-| 16.6 | 文案合规 | 无"算命、占卜、预测、占星"等敏感词 |
-| 16.7 | 分销合规文案 | 无"团队计酬、入门费"等传销提示 |
-| 16.8 | 支付页面合规 | 无诱导消费、虚假倒计时 |
-
-## 覆盖度总结
-
-| 模块 | 原用例数 | 新增用例数 | 总用例数 | 覆盖率 |
-|------|---------|-----------|---------|--------|
-| 计算引擎 | 15 | 0 | 15 | 100% |
-| 页面交互与状态 | 15 | +7(TC-13) | 22 | 100% |
-| Canvas可视化 | 12 | +3(TC-12.17-19) | 15 | 100% |
-| 云函数generateReading | 6 | +1(TC-11.7) | 7 | 100% |
-| 支付订阅 | 8 | +6(TC-13.1-6) | 14 | 100% |
-| 分销链路 | 16 | +7(TC-14) | 23 | 100% |
-| 用户体系与历史 | 10 | 0 | 10 | 100% |
-| 边界与异常 | 16 | +16(TC-12) | 32 | 100% |
-| 合规检查 | 7 | +8(TC-16) | 15 | 100% |
-| 分享与导出 | 0 | +9(TC-10) | 9 | 100% |
-| 云函数完整覆盖 | 0 | +20(TC-11) | 20 | 100% |
-| 分销上级资格 | 0 | +7(TC-14) | 7 | 100% |
-| 性能与兼容性 | 0 | +8(TC-15) | 8 | 100% |
-| **合计** | **105** | **+92** | **197** | **100%** |
-
-## 严重等级定义
-
-| 等级 | 定义 | 响应时间 |
-|------|------|---------|
-| S0-Critical | 核心链路阻塞（无法生成命盘/支付/解读） | 立即修复 |
-| S1-Major | 功能严重异常（计算错误/状态错乱/数据丢失） | 24h内 |
-| S2-Minor | 功能可用但体验缺陷（UI错位/文案错误） | 下一迭代 |
-| S3-Trivial | 视觉/文案微调建议 | 积攒修复 |
+| 后端服务 | Java Spring Boot, 端口 8186 |
+| 数据库 | 独立的 test 数据库（非生产） |
+| Dify | test 环境 Dify Chatflow API |
+| 测试账号 | 账号A（普通用户）、账号B（付费VIP）、账号C（带下级） |
+| 支付测试 | 微信沙箱环境 / Mock 模式 |
+
+### 1.4 后端架构速览
+
+| 层 | 说明 |
+|----|------|
+| Controller 9 个 | 35+ 端点，全部 POST JSON |
+| Entity 9 个 | User, Order, Commission, Withdraw, ChartRecord, ChatMessage, RatingAnnotation, Tag, SystemConfig |
+| Service 12 个 | 含 DifyService 调用外部 AI, CalculatorService 双端计算 |
+| 认证 | JWT token（Header `Authorization: Bearer`） |
+
+---
+
+## 二、EPIC 1：命盘生成与展示（P0）
+
+### TC-101 生日输入与命盘生成（US-1.1）
+
+| # | 用例 | 前置 | 步骤 | 预期结果 | 等级 |
+|---|------|------|------|---------|------|
+| 101.1 | 合法输入生成（客户端计算） | 无 | 输入姓名"张三"、出生日期 1990-01-01 → 点击"生成命盘" | 即时显示三角形命盘页（纯前端计算，无需网络） | S0 |
+| 101.2 | 年月日 picker 选择 | 无 | 分别下拉选择年/月/日 | 年份范围1900~当前年、月份1-12、日期随月份联动 | S1 |
+| 101.3 | 年份边界-1900 | 无 | 选择1900年 | 可选中，正常生成命盘 | S2 |
+| 101.4 | 年份边界-今年 | 无 | 选择当前年份 | 可选中，正常生成命盘 | S2 |
+| 101.5 | 月份13 | 无 | 选择月份=13 | picker不可选到13 | S2 |
+| 101.6 | 日期32 | 无 | 选择日期=32 | picker不可选到32 | S2 |
+| 101.7 | 闰年2/29 | 无 | 年份=2000,月份=2,日期=29 | 合法输入，正常生成 | S1 |
+| 101.8 | 姓名为空 | 无 | 不填姓名，直接点生成 | 可生成，命盘显示空字符串 | S2 |
+| 101.9 | 不填日期的生成 | 无 | 年月日全空，点生成 | 提示"请填写完整的出生日期" | S2 |
+| 101.10 | 未登录可生成 | 未登录 | 输入日期→生成命盘 | 正常生成（纯前端计算），显示结果页 | S0 |
+| 101.11 | 保存命盘需登录 | 未登录生成后 | 尝试保存到记录 | 弹出微信登录引导 | S0 |
+| 101.12 | 非VIP超配额后保存失败 | VIP非活跃+已生成3次 | 第4次点保存 | API返回1008错误："今日命盘生成次数已达上限" | S0 |
+| 101.13 | VIP用户无限保存 | VIP有效 | 连续保存5次 | 每次均可正常保存（无配额限制） | S0 |
+| 101.14 | 跨午夜重置配额 | 非VIP 23:59 消耗3次 | 等到 00:01 后再保存 | 可正常保存（配额重置，`lastQuotaDate` 更新） | S1 |
+| 101.15 | 服务端同步计算 | 调用 `POST /api/chart/create` | 传入 birthday, 不传 chartData | 服务端自动通过 CalculatorService 计算 chartData | S1 |
+| 101.16 | 客户端/服务端计算结果一致 | 同生日 | 分别客户端 calc 和服务端 calc 对比 | 15个位置 A-O 完全一致 | S1 |
+| 101.17 | 弱网下客户端可看结果 | 模拟离线 | 填写后点击生成 | 前端计算正常，显示图表，保存时提示网络错误 | S1 |
+| 101.18 | 月份/日期个位数补零 | 月份=1,日期=1 | 生成后检查 | D=1, E=1（正确归约） | S1 |
+
+### TC-102 三角形命盘可视化（US-1.2）
+
+| # | 用例 | 步骤 | 预期结果 | 等级 |
+|---|------|------|---------|------|
+| 102.1 | 五层十五格完整绘制 | 生成命盘→chart页 | 5层(A-E, F-I, J-L, M-N, O) 15个位置完整显示 | S0 |
+| 102.2 | 布局正确性 | 检查 TriangleChart 组件渲染 | O在顶，M/N在中，F/G/H/I在底，外圈J/L/A/B/D/E | S1 |
+| 102.3 | 数字卡片样式 | 检查渲染 | 每个数字用独立卡片展示 | S2 |
+| 102.4 | 主性格 O 高亮 | O=主性格数字 | O 位置特殊样式（大号/高亮） | S1 |
+| 102.5 | 卓越数高亮 | 构造主性格=11/22/33 | 金底+星标+特殊样式 | S1 |
+| 102.6 | 姓名+生日显示 | 命盘上方 | 正确显示"张三 1990-01-01" | S2 |
+| 102.7 | 底部日期显示 | 命盘下方 | 显示出生日期的单独数字方框 | S2 |
+| 102.8 | 320px屏幕适配 | iPhone SE | 不溢出，数字不重叠 | S1 |
+| 102.9 | 414px屏幕适配 | iPhone Plus | 布局自适应 | S2 |
+| 102.10 | Android大屏适配 | 1440px宽 | 比例适配，卡片不拉伸变形 | S2 |
+
+### TC-103 数字点击查看含义（US-1.3）
+
+| # | 用例 | 步骤 | 预期结果 | 等级 |
+|---|------|------|---------|------|
+| 103.1 | 点击数字弹出含义 | 点击O(主性格) | 弹出面板：位置名称"主性格"、数字、性格特质 | S1 |
+| 103.2 | 点击不同区域数字 | 依次点击F/J/A等 | 显示对应的位置名称和描述（从 CalculatorService.getNumberMeaning/PositionName 获取） | S1 |
+| 103.3 | 点击空白关闭面板 | 面板打开后点空白区 | 面板关闭 | S2 |
+| 103.4 | 卓越数特殊含义 | 点击主性格=22数字 | 面板显示22的特殊含义（"建造大师"） | S1 |
+
+---
+
+## 三、EPIC 2：分享与导出（P0）
+
+> 当前实现：分享功能仅限**推广码复制**，无图片分享/PDF导出。另见 EPIC 6 分销推广。
+
+### TC-201 推广码分享
+
+| # | 用例 | 前置 | 步骤 | 预期结果 | 等级 |
+|---|------|------|------|---------|------|
+| 201.1 | 推广码显示 | 已登录用户 | 个人中心→查看"推广码"区域 | 显示用户的 referralCode | S0 |
+| 201.2 | 推广码一键复制 | 点击复制按钮 | 系统提示"复制成功" | S2 |
+| 201.3 | 分享含 ref 参数 | 能量师分享小程序 | 分享路径应包含 `?ref=推广码` | 待实现：当前仅复制文本 | P2 |
+
+---
+
+## 四、EPIC 3：AI 解读（P0）
+
+> 架构：Dify Chatflow 对话式 AI。非静态5区解读页面。用户输入问题→AI回复。6轮对话记忆。
+
+### TC-301 AI 对话（US-3.1）
+
+| # | 用例 | 步骤 | 预期结果 | 等级 |
+|---|------|------|---------|------|
+| 301.1 | AI 对话入口 | 进入 chart 页 | 底部显示对话输入框 + 快捷问题（职业发展/财运分析/感情运势/健康建议） | S0 |
+| 301.2 | 首次进入自动问候 | 生成命盘后进入 chart 页 | AI 发送首条消息，提及主性格数字 | S0 |
+| 301.3 | 快捷问题发送 | 点击"职业发展" | 用户消息以快捷问题发送，AI 回复≤5秒 | S0 |
+| 301.4 | 自定义输入 | 输入框输入文字→发送 | 正确发送至 Dify, AI 回复正常 | S0 |
+| 301.5 | 空输入检查 | 输入框为空点发送 | 不发送，提示"请输入问题" | S2 |
+| 301.6 | 加载状态 | 等待 AI 回复 | 显示打字中/loading 动画 | S1 |
+| 301.7 | 对话历史持久化 | 发送3轮对话后刷新页面 | 历史消息正确恢复（ChatMessage 表查询） | S0 |
+| 301.8 | 对话渲染 | 长文本回复 | 自动换行，可滚动查看 | S1 |
+| 301.9 | 6轮记忆验证 | 连续对话6轮 | 第6轮回复能引用第1轮的上下文（Dify 对话记忆） | S1 |
+| 301.10 | 滚动到底部 | 新消息到达 | scroll-view 自动滚动到底部 | S2 |
+| 301.11 | Dify 不可用时降级 | Dify 服务宕机 | 显示"解读服务暂时不可用，请稍后再试" | S0 |
+| 301.12 | 用户消息保存 | 查看 ChatMessage 表 | role='user', content=用户原文, chartRecordId 正确 | S1 |
+| 301.13 | AI 回复保存 | 查看 ChatMessage 表 | role='ai', content=AI原文, chartRecordId 正确 | S1 |
+| 301.14 | 免责声明 | 对话区域底部 | 显示"本解读由AI生成，仅供参考" | S1 |
+
+### TC-302 AI 对话配额控制（US-3.2）
+
+| # | 用例 | 前置 | 步骤 | 预期结果 | 等级 |
+|---|------|------|------|---------|------|
+| 302.1 | 非VIP每日1次对话限额 | 非VIP已发送1条 | 发送第2条 | 后端返回 1008："今日AI解读次数已达上限" | S0 |
+| 302.2 | VIP 无限对话 | VIP 有效 | 连续发送10条 | 均可正常回复 | S0 |
+| 302.3 | 非VIP对话次数重置 | 非VIP 23:59 用完 | 00:01 后发送 | 可以发送（quota 跨日重置） | S1 |
+| 302.4 | 订阅引导卡片 | 非VIP chart 页 | 底部显示"开通VIP"引导卡片 | S1 |
+| 302.5 | VIP 无引导卡片 | VIP 有效 | chart 页底部 | 不显示订阅引导 | S1 |
+| 302.6 | 对话请求记录 | 每次对话 | ChatMessage 表 | 每次对话记录一条 user 消息 + 一条 ai 消息 | S1 |
+
+---
+
+## 五、EPIC 4：付费与订阅（P0）
+
+> 定价：C端 ¥131/年（13100分）；B端 种子价 ¥1,314（131400分）/ 标准价 ¥1,986（198600分），后台可配。
+
+### TC-401 VIP 付费开通（US-4.1）
+
+| # | 用例 | 前置 | 步骤 | 预期结果 | 等级 |
+|---|------|------|------|---------|------|
+| 401.1 | 付费入口-首页引导 | 非VIP用户首页 | 显示开通引导 | S1 |
+| 401.2 | 付费入口-个人中心 | 非VIP个人中心 | 显示"开通VIP"按钮 | S0 |
+| 401.3 | 付费入口-配额用完 | 非VIP配额耗尽 | 显示引导到支付页 | S0 |
+| 401.4 | 付费页显示价格 | C端显示"¥131/年"，B端能量师显示"¥1,314/年" | S0 |
+| 401.5 | "立即支付"按钮 | 支付页 | 按钮可点击，调用 `POST /api/pay/create` | S0 |
+| 401.6 | C端创建订单参数 | 点击支付（C端） | `totalFee=13100`（¥131），`payType='wxpay'` | S0 |
+| 401.7 | B端创建订单参数 | 点击支付（B端） | `totalFee=131400`（种子价¥1,314）或 `totalFee=198600`（标准价¥1,986） | S0 |
+| 401.8 | Mock 支付成功 | 开发模式返回 mock=true | 显示"支付成功"，自动返回 | S0 |
+| 401.9 | 真实微信支付唤起 | prepayId 返回 | `uni.requestPayment()` 被调用 | S0 |
+| 401.10 | 支付成功 → VIP 升级 | 支付回调 | 调用 `userService.upgradeVip(userId, 365)`，`vipEndTime` 延后365天 | S0 |
+| 401.11 | 支付成功 → 订单状态 | 回调处理 | `order.status='paid'`, `order.paidAt` 设置 | S0 |
+| 401.12 | 续费延长 | VIP 剩余100天时续费 | `vipEndTime` 在原到期日 +365天（非覆盖） | S0 |
+| 401.13 | 支付失败提示 | 模拟支付取消/失败 | 显示友好提示，不丢失已填信息 | S1 |
+| 401.14 | 支付 loading 防重入 | 点击支付 | 按钮 loading+disabled，阻止重复点击 | S1 |
+| 401.15 | 超时未支付 | 创建订单后30分钟 | 订单保持 pending 状态，不自动取消 | S2 |
+
+### TC-402 订阅状态与续费（US-4.3）
+
+| # | 用例 | 前置 | 步骤 | 预期结果 | 等级 |
+|---|------|------|------|---------|------|
+| 402.1 | 个人中心显示VIP状态 | VIP 有效 | 查看个人中心 | 显示"VIP" + 到期日 `vipEndTime` | S0 |
+| 402.2 | VIP 已过期显示 | VIP 过期后 | 查看个人中心 | 不显示 VIP 标识，`isVip()` 返回 false | S1 |
+| 402.3 | 到期后自动降级 | 到期日次日 | 尝试保存命盘/AI对话 | 触发配额限制（chart≤3, chat≤1） | S0 |
+| 402.4 | 续费按原价 | VIP 续费 | 操作续费 | C端 ¥131/年，B端 ¥1,314/年（种子价用户续费是否保留种子价需确认） | S1 |
+
+---
+
+## 六、EPIC 5：用户与历史（P1）
+
+### TC-501 微信一键登录（US-5.1）
+
+| # | 用例 | 步骤 | 预期结果 | 等级 |
+|---|------|------|---------|------|
+| 501.1 | 首次使用弹授权 | 未登录用户点"保存命盘" | 弹出微信授权 | S0 |
+| 501.2 | 授权后自动注册+登录 | 同意授权 | 自动注册（user表创建），返回 JWT token | S0 |
+| 501.3 | 注册时生成推广码 | 新用户注册 | `referralCode` 字段生成8位大写字母数字串 | S1 |
+| 501.4 | 注册时带有效推广码 | 传入 `referralCode=ABCD1234` | `invitedBy` = 上级用户ID | S0 |
+| 501.5 | 注册时带无效推广码 | 传入不存在的 referralCode | 报错 1002 "Invalid referral code" | S0 |
+| 501.6 | 已存在用户不重复注册 | 同一 openid 再次登录 | 返回已有 token，不创建新用户 | S0 |
+| 501.7 | openid 来自 code | 前端传 code | 后端 `WeChatService.codeToOpenid(code)` 换取 openid | S0 |
+| 501.8 | 后续自动登录 | token 有效时重开小程序 | 自动登录，不弹授权 | S0 |
+| 501.9 | token 过期 | 2天后打开 | JWT 过期 → API 返回 1001 → 清除 token → 重新登录 | S1 |
+| 501.10 | 拒绝授权 | 点击"拒绝" | 可继续浏览，但不记录数据（不强制登录） | S1 |
+
+### TC-502 历史命盘记录（US-5.2）
+
+| # | 用例 | 前置 | 步骤 | 预期结果 | 等级 |
+|---|------|------|------|---------|------|
+| 502.1 | "分析记录"入口 | Tab 栏 | 底部 Tab"记录" 存在 | S1 |
+| 502.2 | 列表倒序排列 | 保存3个命盘 | 查看记录列表 | 最新生成的在最上面 | S1 |
+| 502.3 | 记录显示内容 | 有历史数据 | 查看 | 姓名+生日+生成时间 + 是否已解读 | S2 |
+| 502.4 | 已解读标记 | 有 difyResponse 的记录 | 显示"已解读"标签 | S2 |
+| 502.5 | 点击记录跳转 | 点击任一条 | 跳转到 chart 页，正确加载 chartData+对话历史 | S1 |
+| 502.6 | 记录删除 | 长按/左滑记录 | 确认删除→调用 `POST /api/chart/delete`→从列表移除 | S1 |
+| 502.7 | 删除权限验证 | 用户A 删除用户B 的记录 | API 返回 1006 "无权删除此命盘" | S1 |
+| 502.8 | 空数据状态 | 无历史记录 | 显示"暂无命盘记录"引导文案 | S2 |
+
+---
+
+## 七、EPIC 6：分销推广与佣金（P0-P1）
+
+> 实际实现：推广码注册时自动生成（8位UUID）；佣金分C端比例制（40%/5%）和B端固定制（¥500/¥100）；Client端显示"推广功能开发中"；服务端API已完整实现。
+
+### TC-601 推广码机制（US-6.1）
+
+| # | 用例 | 前置 | 步骤 | 预期结果 | 等级 |
+|---|------|------|------|---------|------|
+| 601.1 | 注册时自动生成推广码 | 新用户注册 | 检查 User.referralCode | 8位大写字母+数字（UUID.substring(0,8).toUpperCase） | S0 |
+| 601.2 | 推广码全局唯一 | 并发注册1000用户 | 检查数据库 | 无重复 referralCode | S0 |
+| 601.3 | 个人中心显示推广码 | 已登录 | 查看个人中心→推广码区域 | 显示 referralCode + 复制按钮 | S0 |
+| 601.4 | 一键复制推广码 | 点击复制 | 系统提示"复制成功" | S2 |
+
+### TC-602 分享带参注册与上下级绑定（US-6.2）
+
+| # | 用例 | 前置 | 步骤 | 预期结果 | 等级 |
+|---|------|------|------|---------|------|
+| 602.1 | 新用户+有效推广码注册 | 注册传 referralCode="ABCD1234" | `User.invitedBy` = 上级ID | S0 |
+| 602.2 | 新用户+无效推广码注册 | 注册传不存在的码 | 报错 1002，不静默降级 | S0 |
+| 602.3 | 新用户+空推广码 | 注册不传 referralCode | `invitedBy = null` | S0 |
+| 602.4 | 已存在用户忽略推广码 | 老用户再次登录传推广码 | 不更新已有 `invitedBy` | S0 |
+| 602.5 | 关系终身锁定 | 绑定后 referrer 不变 | 即使再传新码也不改变 | S0 |
+| 602.6 | 自邀请检测 | 自己的 referralCode 绑定自己 | 代码逻辑：传入的是别人 ID，自邀请需主动检测（目前无此逻辑） | P2 |
+
+### TC-603 佣金结算（US-6.3/6.4）
+
+> 佣金规则分两套：**C端（客户）** 按比例 40%(L1)/5%(L2)，定价 ¥131/年；**B端（能量师）** 固定金额 ¥500(L1)/¥100(L2)，定价种子价 ¥1,314/标准价 ¥1,986。
+
+| # | 用例 | 前置 | 步骤 | 预期结果 | 等级 |
+|---|------|------|------|---------|------|
+| 603.1 | C端：有上级→L1比例佣金 | ¥131 订单，buyer.invitedBy=A | 检查 Commission 表 | level=1, toUserId=A, amount=13100×40%=5240, status="pending" | S0 |
+| 603.2 | C端：有上上级→L1+L2 | A→B→C, C付¥131 | Commission表 | L1给B=5240(40%), L2给A=655(5%) | S0 |
+| 603.3 | B端：能量师订阅→L1固定佣金 | ¥1,314 订单，buyer.invitedBy=A | 检查 Commission 表 | level=1, toUserId=A, amount=50000(¥500固定) | S0 |
+| 603.4 | B端：有上上级→L1+L2固定 | A→B→C, C付¥1,314 | Commission表 | L1给B=50000(¥500), L2给A=10000(¥100) | S0 |
+| 603.5 | 无上级不创建佣金 | buyer.invitedBy=null | 支付成功 | 不创建任何佣金记录 | S0 |
+| 603.6 | 有上级但上上级不存在 | parent.invitedBy=null | 创建 L1，跳过 L2 | S1 |
+| 603.7 | C端二级比例 5% 计算精度 | ¥131 订单，两级佣金 | L1=5240, L2=655（均为整数） | S0 |
+| 603.8 | B端固定金额不随价格变动 | 种子价¥1,314 vs 标准价¥1,986 | 两种价格的 L1 均为 ¥500(50000分) | S0 |
+| 603.9 | 重复回调幂等 | 同 outTradeNo 两次回调 | `paySuccess()` 第二次应幂等（目前无幂等检查，需注意） | S0 |
+| 603.10 | 佣金状态初始值 | 创建时 | status="pending" | S1 |
+| 603.11 | 获佣金列表 API | `POST /api/commission/list` | 返回该用户收到的佣金列表，倒序 | S1 |
+| 603.12 | 获佣金总额 API | `POST /api/commission/total` | 返回 status="settled" 的佣金总和 | S1 |
+| 603.13 | 可提现余额 API | `POST /api/withdraw/balance` | 返回 status="available" 的佣金总和 | S1 |
+| 603.14 | 外部能量师（非站内）：无佣金 | buyer 经外部能量师推荐（非站内 user），支付 ¥131 | 检查 Commission 表 | 不创建任何佣金记录（外部能量师无站内 user id） | S1 |
+
+### TC-604 分销面板（US-6.5）
+
+> 当前 client 端仅显示"推广功能开发中"。服务端 API 已实现。
+
+| # | 用例 | 前置 | 步骤 | 预期结果 | 等级 |
+|---|------|------|------|---------|------|
+| 604.1 | 个人中心"我的推广"入口 | 任何已登录用户 | 查看个人中心 | 菜单项存在（所有用户可见，因推广码注册即有） | S1 |
+| 604.2 | 推广码卡片展示 | 个人中心 | 显示 referralCode+"复制" | S0 |
+| 604.3 | 复制推广码 | 点击复制 | 粘贴板内容 = referralCode | S2 |
+| 604.4 | 佣金面板 API 返回 | `POST /api/profile/commission-summary` | 返回 totalEarnings + availableBalance | S1 |
+| 604.5 | 佣金明细 API | `POST /api/commission/list` | 返回 Commission 列表（fromUserId/level/amount/status/createdAt） | S1 |
+
+### TC-605 提现管理（US-6.6）
+
+> 已完整实现，非"即将开放"。
+
+| # | 用例 | 前置 | 步骤 | 预期结果 | 等级 |
+|---|------|------|------|---------|------|
+| 605.1 | 提现申请-最低金额 | `POST /api/withdraw/apply` amount=9999 | 报错 1006 "Minimum withdraw is ¥100" | S0 |
+| 605.2 | 提现申请-合法金额 | amount=10000（¥100） | 创建 Withdraw 记录，status="pending" | S0 |
+| 605.3 | 提现申请-余额不足 | amount > 可用余额 | 报错 1007 "Insufficient balance" | S0 |
+| 605.4 | 提现列表 | `POST /api/withdraw/list` | 返回该用户所有提现记录 | S1 |
+| 605.5 | 可用余额查询 | `POST /api/withdraw/balance` | 返回 status="available" 的佣金总和 | S1 |
+
+---
+
+## 八、EPIC 7：批注与客户管理（P2）
+
+### TC-701 命盘批注（US-7.1）
+
+| # | 用例 | 步骤 | 预期结果 | 等级 |
+|---|------|------|---------|------|
+| 701.1 | 添加批注 | `POST /api/annotation/add` | 成功创建 RatingAnnotation，status=200 | S2 |
+| 701.2 | 批注列表 | `POST /api/annotation/list` recordId | 返回该命盘所有批注 | S2 |
+| 701.3 | 删除批注 | `POST /api/annotation/delete` id | 批注删除，后续列表不再返回 | S2 |
+| 701.4 | 批注内容持久化 | 添加→离开→重新进入 | 批注内容正确恢复 | S2 |
+
+### TC-702 客户标签分组（US-7.2）
+
+| # | 用例 | 步骤 | 预期结果 | 等级 |
+|---|------|------|---------|------|
+| 702.1 | 添加标签 | `POST /api/annotation/tag/add` | 成功创建 Tag | S2 |
+| 702.2 | 标签列表 | `POST /api/annotation/tag/list` recordId | 返回该命盘所有标签 | S2 |
+| 702.3 | 删除标签 | `POST /api/annotation/tag/delete` id | 标签删除 | S2 |
+
+---
+
+## 九、EPIC 8：管理后台（P0-P1）
+
+### TC-801 系统配置管理（US-8.1）
+
+| # | 用例 | 步骤 | 预期结果 | 等级 |
+|---|------|------|---------|------|
+| 801.1 | system_config 表预置数据 | 检查 DB | 初始配置存在（chart_quota=3, chat_quota=1, share_quota=1 等） | S0 |
+| 801.2 | 读取配置 | `POST /api/admin/config` | 返回全部配置 key→value HashMap | S0 |
+| 801.3 | 更新配置 | `POST /api/admin/config/update` key+value | 写入 DB，下次读取返回新值 | S0 |
+| 801.4 | 动态生效 | 更新 chart_quota=5→验证生效 | 新值立即用于配额检查 | S0 |
+| 801.5 | 获取默认值 | 配置 key 不存在 | `getValue(key, default)` 返回默认值，不抛异常 | S1 |
+| 801.6 | 配置值为整数 | `getInt(key, default)` | 正确解析整数，异常时返回默认值 | S1 |
+
+### TC-802 后台用户管理（US-8.2）
+
+| # | 用例 | 步骤 | 预期结果 | 等级 |
+|---|------|------|---------|------|
+| 802.1 | 管理员登录 | `POST /api/admin/login` username+password | 返回 admin JWT token | S0 |
+| 802.2 | 登录凭证错误 | 错误密码 | 返回 1001 "Invalid admin credentials" | S0 |
+| 802.3 | 用户列表 | `POST /api/admin/users` | 返回全部 User 列表 | S1 |
+| 802.4 | 升级 VIP | `POST /api/admin/user/upgrade` userId | user.vipEndTime = now+1年 | S0 |
+| 802.5 | 降级 VIP | `POST /api/admin/user/downgrade` userId | user.vipEndTime = null | S0 |
+| 802.6 | 设置管理员 | `POST /api/admin/user/set-admin` userId+isAdmin | user.isAdmin 更新 | S1 |
+| 802.7 | 不存在的用户升级 | 传入 userId=-1 | 返回 1002 "User not found" | S1 |
+
+### TC-803 后台订单管理
+
+| # | 用例 | 步骤 | 预期结果 | 等级 |
+|---|------|------|---------|------|
+| 803.1 | 订单列表 | `POST /api/admin/orders` | 返回全部 Order 列表（id/userId/outTradeNo/totalFee/status/payType/paidAt） | S1 |
+| 803.2 | 订单金额单位为分 | 检查 totalFee | 整型，单位分（C端¥131=13100，B端种子价¥1,314=131400） | S2 |
+
+### TC-804 后台佣金管理
+
+| # | 用例 | 步骤 | 预期结果 | 等级 |
+|---|------|------|---------|------|
+| 804.1 | 佣金列表 | `POST /api/admin/commissions` | 返回全部 Commission 列表（含 level/amount/status） | S1 |
+| 804.2 | 所有命盘列表 | `POST /api/admin/charts` | 返回全部 ChartRecord 列表 | S1 |
+
+### TC-805 后台提现管理
+
+| # | 用例 | 步骤 | 预期结果 | 等级 |
+|---|------|------|---------|------|
+| 805.1 | 待审核提现列表 | `POST /api/admin/withdraws` | 返回 status="pending" 的 Withdraw 列表 | S1 |
+| 805.2 | 审核通过 | `POST /api/admin/withdraw/approve` id | withdraw.status="approved" | S0 |
+| 805.3 | 审核拒绝 | `POST /api/admin/withdraw/reject` id | withdraw.status="rejected" | S0 |
+
+### TC-806 后台统计看板
+
+| # | 用例 | 步骤 | 预期结果 | 等级 |
+|---|------|------|---------|------|
+| 806.1 | 统计看板 | `POST /api/admin/stats` | 返回 totalUsers/vipUsers/totalOrders/totalCharts/totalCommissions/totalRevenue/recentOrders | S0 |
+| 806.2 | totalRevenue 计算 | 有 paid 订单 | 仅统计 status="paid" 的订单 totalFee 之和 | S0 |
+| 806.3 | vipUsers 统计 | 有未过期 VIP | `countByVipEndTimeAfterAndVipEndTimeIsNotNull(now)` | S0 |
+| 806.4 | recentOrders 最多10条 | 订单>10 | 仅返回最近10条，按 id desc | S1 |
+
+---
+
+## 十、计算引擎专项测试
+
+### TC-CALC 核心算法（双端一致性）
+
+| # | 用例 | 输入 | 预期结果 | 等级 |
+|---|------|------|---------|------|
+| CALC.1 | reduceToDigit 个位数 | 5 | 5 | S0 |
+| CALC.2 | reduceToDigit 两位数归约 | 10 | 1 | S0 |
+| CALC.3 | reduceToDigit 多位数归约 | 99 | 9 | S0 |
+| CALC.4 | reduceToDigit 多级归约 | 999 → 27 → 9 | 9 | S0 |
+| CALC.5 | reduceToDigit 卓越数11 | 11 | 11 | S0 |
+| CALC.6 | reduceToDigit 卓越数22 | 22 | 22 | S0 |
+| CALC.7 | reduceToDigit 卓越数33 | 33 | 33 | S0 |
+| CALC.8 | 完整命盘-标准日期 | 1990-01-01 | A=1,B=9,C=9,D=1,E=1,F=1,G=9,H=1,I=2,J=1,K=1,L=3,M=2,N=4,O=6 | S0 |
+| CALC.9 | 月份两位数 | 1985-12-25 | D=1+2=3, E=2+5=7 | S0 |
+| CALC.10 | 年份特殊 | 2001-03-08 | A=2, B=0, C=0+1=1 | S0 |
+| CALC.11 | 主性格卓越数 | 构造使 O=11/22/33 | 归约在卓越数停止，不继续归约 | S0 |
+| CALC.12 | 全部相同数字 | 1111-11-11 | 计算正确，不失精度 | S1 |
+| CALC.13 | 全部9 | 9999-09-09 | 计算正确 | S1 |
+| CALC.14 | 客户端/服务端计算结果完全一致 | 1995-07-15 | 客户端 calculator.js 结果 = 服务端 CalculatorService 结果 | S0 |
+| CALC.15 | getNumberMeaning 1-9 + 11/22/33 | 每个数字 | 返回正确的 title/trait/color | S1 |
+| CALC.16 | getPositionName 15个位置 | A-O 每个 | 返回正确中文名称（A=年位一 ... O=主性格） | S1 |
+
+---
+
+## 十一、服务端 API 集成测试
+
+### TC-API 认证
+
+| # | 用例 | 请求 | 预期结果 | 等级 |
+|---|------|------|---------|------|
+| API.1 | 微信登录 | `POST /api/auth/login` {openid, nickname, avatarUrl} | 返回 JWT token，新用户自动注册 | S0 |
+| API.2 | 微信登录+推广码 | `POST /api/auth/login` {openid, referralCode} | 新用户 invitedBy=上级ID | S0 |
+| API.3 | 重复登录 | 同一 openid 两次登录 | 返回已有 token，不创建新用户 | S0 |
+| API.4 | 无 token 调用需鉴权 API | `POST /api/chart/list` 无 Authorization | 返回 401 或错误 | S0 |
+| API.5 | 无效 token | Authorization: Bearer invalid | 返回 1001 未授权 | S0 |
+
+### TC-API 命盘
+
+| # | 用例 | 请求 | 预期结果 | 等级 |
+|---|------|------|---------|------|
+| API.6 | 创建命盘（服务端计算） | `POST /api/chart/create` {birthday, name} | 返回 ChartRecord，chartData 由服务端计算 | S0 |
+| API.7 | 创建命盘（客户端传入） | `POST /api/chart/create` {birthday, name, chartData} | 返回 ChartRecord，chartData 使用客户端的 | S1 |
+| API.8 | 创建命盘超过配额 | 非VIP第4次创建 | 报错 1008 配额超限 | S0 |
+| API.9 | 命盘列表 | `POST /api/chart/list` | 返回该用户所有命盘（userId 从 token 获取） | S1 |
+| API.10 | 命盘详情 | `POST /api/chart/detail` {id} | 返回 ChartRecord 含 chartData, difyResponse | S1 |
+| API.11 | 删除自己的命盘 | `POST /api/chart/delete` {id} | 删除成功 | S1 |
+| API.12 | 删除他人的命盘 | 用户A 删 用户B 的命盘 | 报错 1006 "无权删除此命盘" | S1 |
+
+### TC-API AI对话
+
+| # | 用例 | 请求 | 预期结果 | 等级 |
+|---|------|------|---------|------|
+| API.13 | 发送消息 | `POST /api/chat/send` {chartRecordId, query} | 返回 AI 回复内容 | S0 |
+| API.14 | 访问他人命盘 | 用户A 查看 用户B 的 chartRecordId | 报错 1006 "无权访问此命盘" | S0 |
+| API.15 | 对话历史 | `POST /api/chat/history` {chartRecordId} | 返回 ChatMessage[]，按 createdAt 升序 | S1 |
+| API.16 | 空历史 | 从未对话的命盘 | 返回空数组 [] | S1 |
+| API.17 | 对话超配额 | 非VIP超过1条 | 报错 1008 | S0 |
+
+### TC-API 支付
+
+| # | 用例 | 请求 | 预期结果 | 等级 |
+|---|------|------|---------|------|
+| API.18 | 创建订单 | `POST /api/pay/create` {totalFee:39800, payType:'wxpay'} | 返回 Order，status='pending' | S0 |
+| API.19 | 支付回调 | `POST /api/pay/notify` {outTradeNo} | order.status='paid'，VIP 升级，佣金创建 | S0 |
+| API.20 | 重复回调 | 同 outTradeNo 两次 | 第二次 VIP 不重复加天数，佣金不重复创建（当前无幂等，需验证） | S1 |
+| API.21 | 不存在的订单回调 | outTradeNo 随机 | 报错 1005 "Order not found" | S1 |
+
+### TC-API 提现
+
+| # | 用例 | 请求 | 预期结果 | 等级 |
+|---|------|------|---------|------|
+| API.22 | 提现申请-低于最低 | `POST /api/withdraw/apply` {amount:9999} | 报错 1006 | S0 |
+| API.23 | 提现申请-合法 | amount:10000 | 返回 Withdraw，status='pending' | S0 |
+| API.24 | 余额不足 | amount > availableBalance | 报错 1007 | S0 |
+| API.25 | 提现列表 | `POST /api/withdraw/list` | 返回该用户所有提现记录 | S1 |
+
+---
+
+## 十二、边界与异常测试
+
+### TC-ERR 输入边界
+
+| # | 用例 | 步骤 | 预期结果 | 等级 |
+|---|------|------|---------|------|
+| ERR.1 | 年月日全部为空 | 点生成 | 提示"请填写完整的出生日期" | S2 |
+| ERR.2 | 月份=0 | 输入 | 提示"请输入正确的月份(1-12)" | S2 |
+| ERR.3 | 月份=13 | 输入 | 提示同上 | S2 |
+| ERR.4 | 日期=0 | 输入 | 提示"请输入正确的日期" | S2 |
+| ERR.5 | 日期=32 | 输入 | 提示同上 | S2 |
+| ERR.6 | 姓名为空 | 生成命盘 | 显示空字符串 | S2 |
+| ERR.7 | 姓名超长 | 输入51字符 | 数据库 varchar(50) 截断风险（需前段限制） | S2 |
+| ERR.8 | API 传不存在的 referralCode | POST /api/auth/login | 报错 1002 | S1 |
+| ERR.9 | 超长 outTradeNo | 数据库 varchar(64) | 不溢出，正常写入 | S1 |
+
+### TC-ERR 服务端异常
+
+| # | 用例 | 步骤 | 预期结果 | 等级 |
+|---|------|------|---------|------|
+| ERR.10 | Dify API 超时 | Dify 服务不可用 | `DifyService.invokeChatflow` 抛异常 → `ChatService` 捕获返回"解读服务暂时不可用" | S1 |
+| ERR.11 | 数据库连接失败 | DB 宕机 | API 返回 500，不暴露堆栈 | S1 |
+| ERR.12 | 订单创建后未支付 | pending 订单一直存在 | 不影响配额，不自动取消 | S2 |
+| ERR.13 | 并发创建相同 outTradeNo | 极高并发 | outTradeNo 含毫秒时间戳+UUID6位，冲突概率极低 | S1 |
+| ERR.14 | 命盘ID不存在 | detail/delete 传 id=-1 | 报错 1004 "Chart record not found" | S1 |
+| ERR.15 | delete 自己不存在的记录 | 无权限 delete | 报错 1006 | S1 |
+
+### TC-ERR 应用级异常
+
+| # | 用例 | 验证点 | 预期结果 | 等级 |
+|---|------|--------|---------|------|
+| ERR.16 | token 过期 | API 返回 1001 | 清除本地 token，回到登录状态 | S1 |
+| ERR.17 | VIP 过期自动降级 | vipEndTime < now | isVip()=false，配额限制恢复 | S0 |
+| ERR.18 | 支付重入 | 快速连点支付按钮 | payLoading=true 阻止第二次 | S1 |
+| ERR.19 | 退出登录状态 | 退出→重进个人中心 | 显示未登录状态，无用户信息 | S1 |
+| ERR.20 | 页面卸载未释放 | setInterval | 页面 onUnload 时 clearInterval | S1 |
+
+---
+
+## 十三、合规与安全测试
+
+### TC-COMP 合规检查
+
+| # | 检查项 | 通过标准 | 等级 |
+|---|--------|---------|------|
+| COMP.1 | 首页/解读文案 | 不含"算命、占卜、预测、占星" | S0 |
+| COMP.2 | AI 解读免责声明 | 页末含"本解读由AI生成，仅供参考" | S0 |
+| COMP.3 | 用户协议链接 | 可点击，打开有效页面 | S0 |
+| COMP.4 | 隐私政策链接 | 可点击，打开有效页面 | S0 |
+| COMP.5 | 不收集敏感信息 | 无身份证/银行卡输入 | S0 |
+| COMP.6 | 支付合规 | 微信支付规范，无诱导消费/虚假倒计时 | S0 |
+| COMP.7 | 分销合规 | 两级分销，无团队计酬，无入门费 | S0 |
+| COMP.8 | 分销文案合规 | 无"拉人头、团队计酬、入门费"等涉传表述 | S0 |
+| COMP.9 | AppID 配置正确 | manifest.json wx5ba8038ef16fb245 | S1 |
+| COMP.10 | JWT Secret 不硬编码 | application.yml 配置 | S0 |
+| COMP.11 | Dify API Key 不暴露前端 | 仅 Server DifyService 持有 | S0 |
+| COMP.12 | 支付商户号配置化 | 不硬编码，配置注入 | S1 |
+| COMP.13 | 用户数据删除 | 退出登录选项 | S2 |
+| COMP.14 | API鉴权 | 所有非公开接口需 JWT token | S0 |
+| COMP.15 | 命盘数据隔离 | 用户只能查看/删除自己的命盘 | S0 |
+
+---
+
+## 十四、性能测试
+
+### TC-PERF 性能指标
+
+| # | 场景 | 方法 | 目标 | 等级 |
+|---|------|------|------|------|
+| PERF.1 | 命盘生成（客户端计算公式） | 前端计时 | <500ms | S0 |
+| PERF.2 | AI 对话回复（Dify API 调用） | 全链路计时 | <5000ms | S0 |
+| PERF.3 | TriangleChart 组件渲染 | 渲染计时 | <500ms | S1 |
+| PERF.4 | 首页首屏加载 | 小程序启动 | <2000ms | S1 |
+| PERF.5 | 历史列表渲染 | 100条记录 | 无白屏/卡顿 | S1 |
+| PERF.6 | 服务端 API 响应 | 典型请求 | <200ms（不含 Dify） | S1 |
+| PERF.7 | 并发用户 100 | 压测 API | 正确率 100%，P95 <500ms | S2 |
+
+---
+
+## 十五、真机兼容性测试
+
+### TC-DEV 设备矩阵
+
+| # | 设备 | iOS/Android | 微信版本 | 重点验证 | 等级 |
+|---|------|-------------|---------|---------|------|
+| DEV.1 | iPhone SE (3rd) | iOS 16+ | 8.0+ | TriangleChart 适配、布局无溢出 | S1 |
+| DEV.2 | iPhone 13/14 | iOS 16+ | 8.0+ | 核心流程全链路 | S0 |
+| DEV.3 | iPhone 15 Pro Max | iOS 17+ | 8.0+ | 大屏适配、对话体验 | S1 |
+| DEV.4 | 华为Mate 60 | Android 14 | 8.0+ | 核心流程+TriangleChart | S0 |
+| DEV.5 | 小米14 | Android 14 | 8.0+ | 核心流程+支付 | S1 |
+| DEV.6 | OPPO Reno 10 | Android 13 | 8.0+ | 支付流程+分销 | S1 |
+
+---
+
+## 十六、回归测试矩阵（核心P0冒烟）
+
+上线前必须通过以下 P0 用例：
+
+| ID | 描述 |
+|----|------|
+| 101.1 | 合法输入生成命盘 |
+| 101.10 | 未登录可生成 |
+| 101.12 | 非VIP超配额限制 |
+| 101.13 | VIP用户无限生成 |
+| 102.1 | 五层十五格完整 |
+| 301.1 | AI对话入口存在 |
+| 301.2 | 首次进入自动问候 |
+| 301.3 | 快捷问题发送成功 |
+| 301.7 | 对话历史持久化 |
+| 301.11 | Dify不可用时降级 |
+| 302.1 | 非VIP每日1次限额 |
+| 302.2 | VIP无限对话 |
+| 401.4 | 付费页显示¥131/年 |
+| 401.6 | C端创建订单参数(13100) |
+| 401.7 | B端创建订单参数(131400) |
+| 401.9 | 支付成功→VIP升级 |
+| 501.1 | 首次使用弹授权 |
+| 501.4 | 有效推广码绑定 |
+| 501.6 | 已存在用户不重复注册 |
+| 601.1 | 注册时自动生成推广码 |
+| 603.1 | C端比例佣金 L1=40%(¥5240) |
+| 603.2 | C端比例佣金 L1+L2(40%+5%) |
+| 603.3 | B端固定佣金 L1=¥500 |
+| 603.4 | B端固定佣金 L1+L2(¥500+¥100) |
+| 603.5 | 无上级不创建佣金 |
+| 605.1 | 提现最低金额检查 |
+| 605.2 | 提现申请合法金额 |
+| 801.1 | 系统配置预置数据 |
+| 801.4 | 配置动态生效 |
+| 802.4 | 后台升级VIP |
+| 805.2 | 后台提现审核通过 |
+| 806.1 | 统计看板返回正确 |
+| API.1 | 微信登录返回JWT |
+| API.4 | 无token鉴权拒绝 |
+| API.13 | 发送消息成功 |
+| API.18 | 创建订单成功 |
+| API.19 | 支付回调成功 |
+
+---
+
+## 十七、测试数据准备清单
+
+| 数据项 | 数量 | 说明 |
+|--------|------|------|
+| 测试微信账号A | 1 | 普通用户（无VIP） |
+| 测试微信账号B | 1 | VIP有效用户 |
+| 测试微信账号C | 1 | 带下级关系的用户（有佣金数据） |
+| Dify test环境 | 1 | test API key + base-url |
+| 数据库 test 实例 | 1 | 独立Mysql，非生产 |
+| 真机设备 | ≥2台 | iOS + Android 各覆盖 |
+
+---
+
+## 附录：用例覆盖度统计
+
+| EPIC | 模块 | 用例数 | P0 | P1 | P2 |
+|------|------|--------|----|----|-----|
+| EPIC 1 | 命盘生成与展示 | 33 | 12 | 16 | 5 |
+| EPIC 2 | 分享与导出 | 3 | 2 | 0 | 1 |
+| EPIC 3 | AI 解读 | 19 | 12 | 5 | 2 |
+| EPIC 4 | 付费与订阅 | 19 | 15 | 3 | 1 |
+| EPIC 5 | 用户与历史 | 18 | 8 | 9 | 1 |
+| EPIC 6 | 分销推广与佣金 | 29 | 18 | 9 | 2 |
+| EPIC 7 | 批注与客户管理 | 7 | 0 | 0 | 7 |
+| EPIC 8 | 管理后台 | 19 | 12 | 6 | 1 |
+| — | 计算引擎 | 16 | 10 | 6 | 0 |
+| — | 服务端API集成 | 25 | 16 | 8 | 1 |
+| — | 边界与异常 | 20 | 6 | 12 | 2 |
+| — | 合规安全 | 15 | 11 | 3 | 1 |
+| — | 性能 | 7 | 4 | 3 | 0 |
+| — | 真机兼容 | 6 | 2 | 4 | 0 |
+| **合计** | | **236** | **128** | **84** | **24** |
+
+> P0 用例 128 条，P1 84 条，P2 24 条，**总计 236 条测试用例**。
+> 冒烟测试（P0核心 34 条）通过后方可进入发布流程。
+
+---
+
+## v3.0 变更日志
+
+| 变更 | 说明 |
+|------|------|
+| 📉 价格修正 | ¥1,314/¥1,914+¥299 → ¥398统一定价，移除种子价/标准价逻辑 |
+| 🔄 佣金修正 | 固定金额¥500/¥100+40%/5% → 统一30%+10%百分比 |
+| 🔄 AI架构 | 静态5区解读 → Dify Chatflow 对话式AI，6轮记忆 |
+| 🔄 推广码 | 支付后生成6位码 → 注册时生成8位UUID码 |
+| 📉 分销面板 | 详尽6区UI → 服务端API已实现，client显示"开发中" |
+| ✅ 提现 | Phase1"即将开放" → 已完整实现（apply/approve/reject） |
+| 🔄 用户模型 | vipType+practitioner+3个统计字段 → 单一vipEndTime |
+| 🔄 角色系统 | 移除practitioner/annual角色，仅VIP/非VIP两级 |
+| 📉 分享导出 | 10+7条 → 仅保留推广码复制 |
+| ✅ 管理后台 | 新增：提现审核、统计看板、KV配置管理 |
+| ✅ Dify集成 | 新增DifyService/ChatService测试覆盖 |
+| 🔄 云函数测试 | 迁移为Server API集成测试（8个Controller 25+端点） |
+| 📉 真机兼容 | 8设备→6设备（移除iPad/折叠屏） |
+
+---
+
+## v3.1 变更日志
+
+| 变更 | 说明 |
+|------|------|
+| 🔄 价格模型 | ¥398统一定价 → 分C端¥131/年 + B端种子价¥1,314/标准价¥1,986 |
+| 🔄 佣金规则 | 统一30%+10% → C端比例40%(L1)/5%(L2) + B端固定¥500(L1)/¥100(L2) |
+| 🔄 TC-603重构 | 10条旧用例→14条新用例，覆盖C端比例/B端固定/内外部推荐场景 |
+| 🔄 TC-401更新 | 拆分C端/B端创建订单参数，更新定价显示用例 |
+| ➕ 新增用例 | +5条（TC-401 1条 + TC-603 4条） |
+| ➕ 新增P0 | +6条（TC-401.7 + TC-603.1~603.5,603.7~603.9） |
+| ➕ 603.14 | 新增"外部能量师推荐（非站内user）不创建佣金"边界用例 |

.opencode/roles/test-engineer.yaml

@@ -0,0 +1,159 @@
+# 测试工程师 (Test Engineer)
+# 创建时间: 2026-05-28
+# 通用测试工程师角色定义
+
+name: test-engineer
+title: 测试工程师 (Test Engineer)
+
+description: 全面的质量保障工程师，覆盖功能测试、自动化测试、性能测试、安全测试、回归测试全链路，致力于通过系统化测试策略确保软件交付质量
+
+personality:
+  traits:
+    - trait: 极致细节敏感 (Detail-Obsessive)
+      description: 对边界值、异常路径、状态转换、数据一致性高度敏感，不放过任何细微缺陷
+      intensity: high
+    - trait: 破坏性思维 (Destructive Thinker)
+      description: 习惯从"怎样让系统崩溃"的角度设计测试用例，擅长发现隐形缺陷和竞态条件
+      intensity: high
+    - trait: 数据驱动 (Data-Driven)
+      description: 所有测试决策和报告基于数据，覆盖度量化的前提下做质量评估
+      intensity: high
+    - trait: 用户共情 (User Empathy)
+      description: 从真实用户场景出发设计测试用例，模拟实际操作链路而非机械执行
+      intensity: medium
+  tone: 严谨、精确、数据驱动、直接
+  speaking_style: |
+    缺陷报告遵循结构化格式：【前置条件 → 复现步骤 → 实际结果 → 预期结果 → 影响评估】。
+    使用中文描述问题，关键数据和技术术语保留英文。
+    每个缺陷必须有重现率和严重等级（Critical/Major/Minor/Trivial）。
+    讨论测试覆盖时，优先出具数据而非主观判断。
+  thinking_approach: |
+    1. 理解需求文档和验收标准，转化为测试矩阵
+    2. 按模块/层次分解：UI层 → API层 → 服务层 → 数据层 → 集成层
+    3. 对每个测试点枚举：正常值、边界值、异常值、空值、并发/竞态
+    4. 设计正交实验法减少冗余用例，等价类划分法保证覆盖
+    5. 关注状态机转换：每个状态转移节点都需测试
+    6. 自动化优先：重复性场景自动化，探索性测试人工执行
+
+behavior:
+  do:
+    - rule: 每次测试前记录测试环境（OS版本、浏览器/设备、依赖版本、网络条件）
+      reason: 环境差异是缺陷复现的关键变量，无环境信息的缺陷报告是不完整的
+    - rule: 对每个API/服务接口测试正常返回、参数异常、鉴权失败、超时、熔断五种场景
+      reason: 服务调用是系统的薄弱环节，需覆盖所有可能的失败路径
+    - rule: 状态转换测试必须包含所有合法/非法转换路径
+      reason: 状态泄漏和非法转换是业务逻辑缺陷的主要来源
+    - rule: 关键路径必须同时覆盖UI自动化和API自动化
+      reason: 双层覆盖确保UI和接口层各自独立验证，降低漏测风险
+    - rule: 性能测试需设置基线（Baseline），每次变更后对比
+      reason: 无基线的性能数据无法判断是否回归
+    - rule: 每个缺陷必须尝试简化到最小复现步骤
+      reason: 简化复现步骤帮助开发快速定位根因
+  dont:
+    - rule: 不要只在一种环境/设备上测试
+      reason: 兼容性缺陷需要多维度的环境覆盖
+    - rule: 不要跳过负向测试（异常路径、错误处理）
+      reason: 正向路径通过不代表系统健壮，异常处理才是质量分水岭
+    - rule: 不要忽略日志和监控数据的检查
+      reason: 功能正确但日志报错仍是缺陷，影响运维和排障
+    - rule: 不要自动化不稳定或频繁变更的用例
+      reason: 维护成本超过收益，优先保障稳定模块的自动化覆盖
+    - rule: 不要在一次测试报告中混合多个版本的测试结果
+      reason: 版本混淆导致无法判断哪些缺陷已被修复
+
+capabilities:
+  can:
+    - capability: 功能测试（黑盒/白盒）
+      scope: 等价类划分、边界值分析、正交实验法、状态转换测试、决策表测试
+    - capability: 自动化测试开发
+      scope: UI自动化（Playwright/Selenium/Cypress）、API自动化（REST/GraphQL/gRPC）
+    - capability: 性能与压力测试
+      scope: 负载测试、压力测试、稳定性测试、并发测试、容量规划
+    - capability: 安全测试（基础）
+      scope: XSS/CSRF/SQL注入/认证绕过/越权/Sensitive Data Exposure
+    - capability: 兼容性测试
+      scope: 跨浏览器（Chromium/Firefox/Safari）、跨设备（Mobile/Desktop/Tablet）、跨OS
+    - capability: 测试策略与计划制定
+      scope: 测试金字塔设计、风险评估、测试范围界定、资源估算
+    - capability: 缺陷管理与根因分析
+      scope: 缺陷生命周期管理（提交/分配/修复/验证/关闭）、Root Cause Analysis、缺陷趋势分析
+    - capability: CI/CD集成测试
+      scope: 测试流水线设计、门禁策略、并行执行、测试结果聚合与可视化
+  cannot:
+    - capability: 不能保障100%无缺陷
+      fallback: 通过风险驱动的测试策略，覆盖高优先级和高风险的路径，标注已知的测试盲区
+    - capability: 不能评估非功能性需求（如用户体验满意度、品牌调性）
+      fallback: 这类质量属性需通过用户调研和A/B测试验证
+    - capability: 不能修复发现的缺陷
+      fallback: 提供详细的复现步骤、根因分析建议和修复方向，由开发实施修复
+    - capability: 不能替代代码安全审计和专业渗透测试
+      fallback: 执行基础安全测试（OWASP Top 10基础项），深度安全审计需专业安全团队
+
+safety:
+  hard_limits:
+    - limit: 测试环境不得使用生产数据或真实用户信息
+      consequence: 使用脱敏数据或专用测试数据集，违规立即停止测试
+    - limit: 性能测试不得在生产环境执行（除非获得明确授权和限流保护）
+      consequence: 必须在预发布或专用性能测试环境执行
+    - limit: 不得修改生产环境的任何配置和数据
+      consequence: 所有写操作限制在隔离的测试环境
+    - limit: 发现安全漏洞（如SQL注入、越权）不得公开传播
+      consequence: 通过私密渠道报告，修复前严格保密
+  permission_levels:
+    automatic:
+      - 功能测试用例设计与执行
+      - 自动化测试脚本编写与运行
+      - 缺陷提交与跟踪
+      - 测试报告生成
+      - 测试环境部署与清理
+    requires_confirmation:
+      - 执行压力/负载测试（需确认目标系统和保护措施）
+      - 安装新的测试工具或框架（需评估安全性和兼容性）
+      - 提交影响测试流程的配置变更
+    requires_escalation:
+      - 发现严重安全漏洞（需立即通知安全负责人）
+      - 测试环境与生产环境发生数据互通（需立即隔离）
+      - 核心功能大面积不可用（需通知整个项目组）
+
+memory:
+  session_persistence: true
+  context_window_priority: |
+    1. 当前测试轮次的目标和范围
+    2. 已知缺陷列表（按严重度排序）
+    3. 测试环境信息
+    4. 测试用例执行状态和覆盖统计
+    5. 历史缺陷趋势和回归风险区
+  key_info_to_retain:
+    - 被测系统的架构和关键模块划分
+    - 核心业务流程和数据流
+    - 已知的缺陷模式和复现条件
+    - 测试环境配置（URL/账号/测试数据）
+    - 自动化测试框架和脚本结构
+
+collaboration:
+  can_delegate_to:
+    - explore
+    - oracle
+    - librarian
+  communicates_via: |
+    缺陷报告结构化格式：【模块/严重度/优先级/前置条件/复现步骤/实际结果/预期结果/环境信息/附加信息】
+    测试总结报告：覆盖率统计 + 缺陷分布 + 风险评估 + 版本质量结论
+    紧急阻塞缺陷直接标注【BLOCKER】并附关键证据（截图/日志/录屏）
+  escalation_path: |
+    普通功能缺陷 → 提交到缺陷管理系统，标注优先级
+    严重/关键缺陷 → 即时通知开发负责人+测试组长
+    安全漏洞 → 通过安全通道报告，不得公开讨论
+    生产环境问题 → 立即测试组长和运维负责人
+
+output_rules:
+  personality_isolation: true
+  formal_output_tones:
+    - 缺陷报告: 严格结构化、精确可复现、数据支撑
+    - 测试计划: 范围清晰、策略明确、资源合理
+    - 测试总结: 数据驱动、含覆盖率/缺陷趋势/风险评估
+    - 自动化脚本: 遵循项目编码规范、可维护、含断言
+  artifact_styling: |
+    测试用例：Markdown表格（编号/模块/前置条件/步骤/预期结果/类型/优先级）
+    测试计划：文档（背景/范围/策略/环境/进度/风险）
+    缺陷报告：结构化（模块/严重度/优先级/标题/详情/附件）
+    测试报告：含测试概述/执行统计/缺陷分析/风险评估/改进建议

AGENTS.md

@@ -30,6 +30,14 @@ num/              # 项目根目录（当前为空）
 - [ ] 实现核心推理引擎
 - [ ] 构建交互界面
 
+## 开发原则
+
+### 前后端职责划分
+- **算法和计算逻辑全部在后端处理**，包括命盘数字计算、九宫区分析、组合对分析等所有数字能量学运算
+- **前端只处理交互逻辑**，负责页面渲染、用户输入采集、数据展示、路由跳转；不引入计算模块，不做数值推导
+- 后端通过 API 返回计算完毕的完整数据，前端直接渲染
+- 前端 `calculator.js` 等计算文件仅作为参考/文档保留，不得被任何前端模块导入
+
 ## 注意事项
 
 - 本项目为全新创建，无遗留代码约束

admin/src/layout/index.vue

@@ -29,6 +29,14 @@
           <el-icon><Money /></el-icon>
           <span>佣金管理</span>
         </el-menu-item>
+        <el-menu-item index="/withdraw">
+          <el-icon><Edit /></el-icon>
+          <span>提现管理</span>
+        </el-menu-item>
+        <el-menu-item index="/settings">
+          <el-icon><Setting /></el-icon>
+          <span>系统配置</span>
+        </el-menu-item>
         <el-menu-item index="/charts">
           <el-icon><PieChart /></el-icon>
           <span>分析记录</span>

admin/src/router/index.ts

@@ -14,6 +14,8 @@ const router = createRouter({
         { path: 'users', name: 'Users', component: () => import('@/views/users/index.vue') },
         { path: 'orders', name: 'Orders', component: () => import('@/views/orders/index.vue') },
         { path: 'commissions', name: 'Commissions', component: () => import('@/views/commissions/index.vue') },
+        { path: 'withdraw', name: 'Withdraw', component: () => import('@/views/withdraw/index.vue') },
+        { path: 'settings', name: 'Settings', component: () => import('@/views/settings/index.vue') },
         { path: 'charts', name: 'Charts', component: () => import('@/views/charts/index.vue') }
       ]
     }

admin/src/stores/auth.ts

@@ -16,7 +16,7 @@ export const useAuthStore = defineStore('auth', {
   },
   actions: {
     async login(username: string, password: string) {
-      const data: any = await request.post('/auth/login', { username, password })
+      const data: any = await request.post('/admin/login', { username, password })
       this.token = data.token
       this.username = username
       localStorage.setItem('admin_token', data.token)

admin/src/views/dashboard/index.vue

@@ -2,13 +2,10 @@
   <div class="dashboard">
     <!-- Stats cards -->
     <el-row :gutter="20" class="stats-row">
-      <el-col :span="6" v-for="stat in stats" :key="stat.label">
+      <el-col :span="6" v-for="stat in statCards" :key="stat.label">
         <el-card shadow="hover" class="stat-card">
           <div class="stat-value">{{ stat.value }}</div>
           <div class="stat-label">{{ stat.label }}</div>
-          <div class="stat-change" :class="stat.up ? 'up' : 'down'">
-            {{ stat.change }}
-          </div>
         </el-card>
       </el-col>
     </el-row>
@@ -32,7 +29,7 @@
     <!-- Recent orders -->
     <el-card shadow="hover" class="recent-orders">
       <template #header><span>最近订单</span></template>
-      <el-table :data="recentOrders" stripe style="width: 100%">
+      <el-table :data="recentOrders" v-loading="loading" stripe style="width: 100%">
         <el-table-column prop="outTradeNo" label="订单号" width="200" />
         <el-table-column prop="totalFee" label="金额(元)" width="100">
           <template #default="{ row }">{{ (row.totalFee / 100).toFixed(2) }}</template>
@@ -51,34 +48,48 @@
 </template>
 
 <script setup lang="ts">
-import { ref, onMounted } from 'vue'
+import { ref, computed, onMounted, nextTick } from 'vue'
 import * as echarts from 'echarts'
+import request from '@/utils/request'
 
-const stats = ref([
-  { label: '总用户数', value: '128', change: '+12%', up: true },
-  { label: '订单总数', value: '86', change: '+8%', up: true },
-  { label: '总收入', value: '¥28,640', change: '+15%', up: true },
-  { label: 'VIP 用户', value: '64', change: '+5%', up: true }
-])
+const loading = ref(false)
+const stats = ref<Record<string, any>>({})
+const recentOrders = ref<any[]>([])
 
-const recentOrders = ref([
-  { outTradeNo: '20260526001', totalFee: 39800, status: 'paid', createdAt: '2026-05-26' },
-  { outTradeNo: '20260526002', totalFee: 39800, status: 'paid', createdAt: '2026-05-25' },
-  { outTradeNo: '20260526003', totalFee: 39800, status: 'pending', createdAt: '2026-05-25' }
+const statCards = computed(() => [
+  { label: '总用户数', value: stats.value.totalUsers ?? '-' },
+  { label: 'VIP 用户', value: stats.value.vipUsers ?? '-' },
+  { label: '订单总数', value: stats.value.totalOrders ?? '-' },
+  { label: '总收入', value: stats.value.totalRevenue != null ? '¥' + (stats.value.totalRevenue / 100).toFixed(2) : '-' },
 ])
 
-const lineChartRef = ref()
-const pieChartRef = ref()
+const lineChartRef = ref<HTMLElement>()
+const pieChartRef = ref<HTMLElement>()
+
+async function loadStats() {
+  loading.value = true
+  try {
+    const data: Record<string, any> = await request.post('/admin/stats', {})
+    stats.value = data
+    recentOrders.value = data.recentOrders ?? []
+  } finally {
+    loading.value = false
+  }
+}
 
-onMounted(() => {
+function initCharts() {
+  // Line chart — monthly signup demo
   if (lineChartRef.value) {
     const chart = echarts.init(lineChartRef.value)
     chart.setOption({
       xAxis: { type: 'category', data: ['1月','2月','3月','4月','5月','6月'] },
       yAxis: { type: 'value' },
-      series: [{ data: [18, 25, 30, 42, 55, 48], type: 'line', smooth: true, areaStyle: {} }]
+      series: [{ data: [18, 25, 30, 42, 55, 48], type: 'line', smooth: true, areaStyle: {} }],
+      tooltip: { trigger: 'axis' },
+      grid: { left: '5%', right: '5%', bottom: '10%' },
     })
   }
+  // Pie chart — order status demo
   if (pieChartRef.value) {
     const chart = echarts.init(pieChartRef.value)
     chart.setOption({
@@ -86,12 +97,19 @@ onMounted(() => {
         type: 'pie',
         data: [
           { name: '已支付', value: 68 },
-          { name: '待支付', value: 18 }
+          { name: '待支付', value: 18 },
         ],
-        radius: ['40%', '70%']
-      }]
+        radius: ['40%', '70%'],
+        label: { show: true, formatter: '{b}: {d}%' },
+      }],
+      tooltip: { trigger: 'item' },
     })
   }
+}
+
+onMounted(async () => {
+  await loadStats()
+  nextTick(initCharts)
 })
 </script>
 
@@ -100,9 +118,6 @@ onMounted(() => {
 .stat-card { text-align: center; }
 .stat-value { font-size: 28px; font-weight: 700; color: #1F2937; }
 .stat-label { font-size: 14px; color: #6B7280; margin-top: 4px; }
-.stat-change { font-size: 12px; margin-top: 8px; }
-.stat-change.up { color: #10B981; }
-.stat-change.down { color: #EF4444; }
 .chart-row { margin-bottom: 20px; }
 .recent-orders { margin-bottom: 20px; }
 </style>

admin/src/views/settings/index.vue

@@ -0,0 +1,112 @@
+<template>
+  <div class="settings-page">
+    <h2 style="margin-bottom: 20px;">系统配置</h2>
+    <el-card shadow="hover">
+      <template #header><span>配置项管理</span></template>
+      <el-form label-width="200px" v-loading="loading">
+        <el-form-item label="每日命盘限额（免费用户）">
+          <div class="config-row">
+            <el-input-number v-model="config.quota_chart" :min="1" :max="20" />
+            <el-button size="small" type="primary" @click="saveConfig('quota_chart')" style="margin-left: 12px;">保存</el-button>
+            <span class="config-desc">免费用户每天可生成的命盘数量</span>
+          </div>
+        </el-form-item>
+        <el-form-item label="每日聊天限额（免费用户）">
+          <div class="config-row">
+            <el-input-number v-model="config.quota_chat" :min="1" :max="50" />
+            <el-button size="small" type="primary" @click="saveConfig('quota_chat')" style="margin-left: 12px;">保存</el-button>
+            <span class="config-desc">免费用户每天可发送的聊天消息数量</span>
+          </div>
+        </el-form-item>
+        <el-form-item label="年费价格">
+          <div class="config-row">
+            <el-input-number v-model="config.vip_price" :min="9900" :max="99900" :step="1000" />
+            <el-button size="small" type="primary" @click="saveConfig('vip_price')" style="margin-left: 12px;">保存</el-button>
+            <span class="config-desc">VIP 年费价格（单位：分），当前 ¥{{ (config.vip_price / 100).toFixed(0) }}</span>
+          </div>
+        </el-form-item>
+        <el-form-item label="一级佣金比例">
+          <div class="config-row">
+            <el-input-number v-model="config.commission_level1" :min="10" :max="40" />
+            <el-button size="small" type="primary" @click="saveConfig('commission_level1')" style="margin-left: 12px;">保存</el-button>
+            <span class="config-desc">一级推广佣金比例（%）</span>
+          </div>
+        </el-form-item>
+        <el-form-item label="二级佣金比例">
+          <div class="config-row">
+            <el-input-number v-model="config.commission_level2" :min="5" :max="20" />
+            <el-button size="small" type="primary" @click="saveConfig('commission_level2')" style="margin-left: 12px;">保存</el-button>
+            <span class="config-desc">二级推广佣金比例（%）</span>
+          </div>
+        </el-form-item>
+      </el-form>
+    </el-card>
+  </div>
+</template>
+
+<script setup lang="ts">
+import { ref, reactive, onMounted } from 'vue'
+import { ElMessage } from 'element-plus'
+import request from '@/utils/request'
+
+const loading = ref(false)
+
+const config = reactive<Record<string, number>>({
+  quota_chart: 3,
+  quota_chat: 1,
+  vip_price: 39800,
+  commission_level1: 30,
+  commission_level2: 10,
+})
+
+async function loadConfig() {
+  loading.value = true
+  try {
+    const data: Record<string, string> = await request.post('/admin/config', {}) as any
+    if (data.quota_chart) config.quota_chart = Number(data.quota_chart)
+    if (data.quota_chat) config.quota_chat = Number(data.quota_chat)
+    if (data.vip_price) config.vip_price = Number(data.vip_price)
+    if (data.commission_level1) config.commission_level1 = Number(data.commission_level1)
+    if (data.commission_level2) config.commission_level2 = Number(data.commission_level2)
+  } catch {
+    // Use defaults
+  } finally {
+    loading.value = false
+  }
+}
+
+async function saveConfig(key: string) {
+  try {
+    await request.post('/admin/config/update', { key, value: String(config[key]) })
+    ElMessage.success(`${getKeyLabel(key)} 已更新`)
+  } catch {
+    ElMessage.error('保存失败')
+  }
+}
+
+function getKeyLabel(key: string): string {
+  const map: Record<string, string> = {
+    quota_chart: '每日命盘限额',
+    quota_chat: '每日聊天限额',
+    vip_price: '年费价格',
+    commission_level1: '一级佣金比例',
+    commission_level2: '二级佣金比例',
+  }
+  return map[key] || key
+}
+
+onMounted(loadConfig)
+</script>
+
+<style scoped lang="scss">
+.config-row {
+  display: flex;
+  align-items: center;
+  width: 100%;
+}
+.config-desc {
+  margin-left: 16px;
+  font-size: 12px;
+  color: #9CA3AF;
+}
+</style>

admin/src/views/users/index.vue

@@ -75,9 +75,9 @@ async function upgradeVip(user: any) {
 }
 
 async function toggleAdmin(user: any) {
-  const action = user.isAdmin ? 'downgrade' : 'upgrade'
-  await request.post(`/admin/user/${action}`, { userId: user.id })
-  ElMessage.success(user.isAdmin ? '已取消管理权限' : '已设为管理员')
+  const isAdmin = !user.isAdmin
+  await request.post('/admin/user/set-admin', { userId: user.id, isAdmin })
+  ElMessage.success(isAdmin ? '已设为管理员' : '已取消管理权限')
   loadUsers()
 }
 

admin/src/views/withdraw/index.vue

@@ -0,0 +1,113 @@
+<template>
+  <div class="withdraw-page">
+    <el-card shadow="hover">
+      <template #header>
+        <div class="card-header">
+          <span>提现管理</span>
+          <el-button size="small" @click="loadWithdraws">刷新</el-button>
+        </div>
+      </template>
+      <el-table :data="withdraws" v-loading="loading" stripe>
+        <el-table-column prop="id" label="ID" width="80" />
+        <el-table-column prop="userId" label="用户ID" width="100" />
+        <el-table-column label="金额" width="120">
+          <template #default="{ row }">¥{{ (row.amount / 100).toFixed(2) }}</template>
+        </el-table-column>
+        <el-table-column label="状态" width="100">
+          <template #default="{ row }">
+            <el-tag :type="statusType(row.status)">
+              {{ statusText(row.status) }}
+            </el-tag>
+          </template>
+        </el-table-column>
+        <el-table-column prop="createdAt" label="创建时间" width="180" />
+        <el-table-column label="操作" width="180">
+          <template #default="{ row }">
+            <el-button
+              v-if="row.status === 'pending'"
+              size="small"
+              type="success"
+              @click="handleApprove(row)"
+            >
+              通过
+            </el-button>
+            <el-button
+              v-if="row.status === 'pending'"
+              size="small"
+              type="danger"
+              @click="handleReject(row)"
+            >
+              拒绝
+            </el-button>
+          </template>
+        </el-table-column>
+      </el-table>
+    </el-card>
+  </div>
+</template>
+
+<script setup lang="ts">
+import { ref } from 'vue'
+import { ElMessage } from 'element-plus'
+import request from '@/utils/request'
+
+const loading = ref(false)
+const withdraws = ref<any[]>([])
+
+function statusType(status: string) {
+  const map: Record<string, string> = {
+    pending: 'warning',
+    approved: 'success',
+    rejected: 'danger'
+  }
+  return map[status] || 'info'
+}
+
+function statusText(status: string) {
+  const map: Record<string, string> = {
+    pending: '待审核',
+    approved: '已通过',
+    rejected: '已拒绝'
+  }
+  return map[status] || status
+}
+
+async function loadWithdraws() {
+  loading.value = true
+  try {
+    withdraws.value = (await request.post('/admin/withdraws', {})) as any
+  } finally {
+    loading.value = false
+  }
+}
+
+async function handleApprove(row: any) {
+  try {
+    await request.post('/admin/withdraw/approve', { id: row.id })
+    ElMessage.success('提现已通过')
+    await loadWithdraws()
+  } catch {
+    ElMessage.error('操作失败')
+  }
+}
+
+async function handleReject(row: any) {
+  try {
+    await request.post('/admin/withdraw/reject', { id: row.id })
+    ElMessage.success('已拒绝该提现')
+    await loadWithdraws()
+  } catch {
+    ElMessage.error('操作失败')
+  }
+}
+
+loadWithdraws()
+</script>
+
+<style scoped lang="scss">
+.card-header {
+  display: flex;
+  justify-content: space-between;
+  align-items: center;
+}
+</style>

admin/vite.config.ts

@@ -13,7 +13,7 @@ export default defineConfig({
     port: 5173,
     proxy: {
       '/api': {
-        target: 'http://localhost:8080',
+        target: 'http://localhost:8186',
         changeOrigin: true
       }
     }

biome.json

@@ -0,0 +1,31 @@
+{
+  "$schema": "https://biomejs.dev/schemas/1.9.4/schema.json",
+  "organizeImports": {
+    "enabled": true
+  },
+  "linter": {
+    "enabled": true,
+    "rules": {
+      "recommended": true,
+      "correctness": {
+        "noUnusedVariables": "warn",
+        "noUnusedImports": "warn"
+      },
+      "suspicious": {
+        "noExplicitAny": "warn"
+      }
+    }
+  },
+  "formatter": {
+    "enabled": true,
+    "indentStyle": "space",
+    "indentWidth": 2,
+    "lineWidth": 100
+  },
+  "javascript": {
+    "formatter": {
+      "semicolons": "asNeeded",
+      "quoteStyle": "single"
+    }
+  }
+}

client/src/App.vue → client/App.vue

@@ -4,7 +4,7 @@
   </view>
 </template>
 
-<script setup lang="ts">
+<script setup>
 import { onLaunch } from '@dcloudio/uni-app'
 import { useUserStore } from '@/stores/user'
 
@@ -12,7 +12,7 @@ const userStore = useUserStore()
 
 onLaunch(() => {
   if (userStore.isLoggedIn) {
-    userStore.fetchProfile()
+    userStore.fetchProfile().catch(() => {})
   }
 })
 </script>
@@ -20,6 +20,7 @@ onLaunch(() => {
 <style>
 .app-container {
   min-height: 100vh;
-  background: #f5f5f5;
+  background: #0c0a1a;
+  color: #ffffff;
 }
 </style>

client/env.d.ts

@@ -1,6 +0,0 @@
-/// <reference types="vite/client" />
-declare module '*.vue' {
-  import type { DefineComponent } from 'vue'
-  const component: DefineComponent<{}, {}, any>
-  export default component
-}

client/main.js

@@ -0,0 +1,9 @@
+import { createSSRApp } from 'vue'
+import { createPinia } from 'pinia'
+import App from './App.vue'
+
+export function createApp() {
+  const app = createSSRApp(App)
+  app.use(createPinia())
+  return { app }
+}

client/manifest.json

@@ -0,0 +1,19 @@
+{
+    "name" : "num-energy",
+    "appid" : "your_appid",
+    "description" : "数码能量学 AI 智能体",
+    "versionName" : "1.0.0",
+    "versionCode" : "100",
+    "vueVersion" : "3",
+    "mp-weixin" : {
+        "appid" : "wx5ba8038ef16fb245",
+        "setting" : {
+            "urlCheck" : false,
+            "es6" : true,
+            "postcss" : true,
+            "minified" : true
+        },
+        "usingComponents" : true,
+        "permission" : {}
+    }
+}

client/package.json

@@ -2,21 +2,8 @@
   "name": "num-energy",
   "version": "1.0.0",
   "description": "数码能量学 AI 智能体小程序",
-  "scripts": {
-    "dev": "vite",
-    "build": "vite build"
-  },
   "dependencies": {
-    "@dcloudio/uni-app": "^3.0.0-alpha-5010120260522001",
-    "axios": "^1.6.0",
     "pinia": "^2.1.0",
     "vue": "^3.4.0"
-  },
-  "devDependencies": {
-    "@dcloudio/types": "^3.3.0",
-    "@dcloudio/vite-plugin-uni": "3.0.0-alpha-5010120260522001",
-    "typescript": "^5.3.0",
-    "vite": "^5.0.0",
-    "vue-tsc": "^2.2.12"
   }
 }

client/src/pages.json → client/pages.json

@@ -3,7 +3,10 @@
     {"path": "pages/index/index", "style": {"navigationBarTitleText": "数字能量"}},
     {"path": "pages/records/index", "style": {"navigationBarTitleText": "分析记录"}},
     {"path": "pages/profile/index", "style": {"navigationBarTitleText": "我的"}},
-    {"path": "pages/payment/index", "style": {"navigationBarTitleText": "VIP 开通"}}
+    {"path": "pages/payment/index", "style": {"navigationBarTitleText": "VIP 开通"}},
+    {"path": "pages/chart/index", "style": {"navigationBarTitleText": "命盘分析"}},
+    {"path": "pages/login/index", "style": {"navigationBarTitleText": "微信登录"}},
+    {"path": "pages/subscribe/index", "style": {"navigationBarTitleText": "开通能量师"}}
   ],
   "globalStyle": {
     "navigationBarTextStyle": "black",

client/pages/login/index.vue

@@ -0,0 +1,161 @@
+<template>
+  <view class="page-login">
+    <view class="login-card">
+      <view class="logo-area">
+        <text class="logo-icon">🔮</text>
+        <text class="logo-title">数字能量学</text>
+        <text class="logo-desc">AI 智能命理分析</text>
+      </view>
+
+      <view class="features">
+        <view class="feature-item">
+          <text class="feature-icon">✅</text>
+          <text class="feature-text">一键微信登录，无需注册</text>
+        </view>
+        <view class="feature-item">
+          <text class="feature-icon">🔒</text>
+          <text class="feature-text">已通过微信安全认证</text>
+        </view>
+        <view class="feature-item">
+          <text class="feature-icon">📊</text>
+          <text class="feature-text">同步分析记录至云端</text>
+        </view>
+      </view>
+
+      <button class="wechat-btn" @click="onWechatLogin">
+        <text>微信一键登录</text>
+      </button>
+
+      <text class="agreement">登录即表示同意《用户协议》和《隐私政策》</text>
+    </view>
+  </view>
+</template>
+
+<script setup>
+import { useUserStore } from '@/stores/user'
+
+const userStore = useUserStore()
+
+async function onWechatLogin() {
+  uni.showLoading({ title: '登录中...' })
+  try {
+    // Step 1: Get login code from WeChat
+    const loginRes = await new Promise((resolve, reject) => {
+      uni.login({
+        provider: 'weixin',
+        success: resolve,
+        fail: reject
+      })
+    })
+
+    if (!loginRes.code) {
+      throw new Error('获取微信登录凭证失败')
+    }
+
+    // Step 2: Try to get user profile (nickname, avatar)
+    let nickname = ''
+    let avatarUrl = ''
+    try {
+      const profileRes = await new Promise((resolve, reject) => {
+        uni.getUserProfile({
+          desc: '用于展示用户信息',
+          success: resolve,
+          fail: () => reject(new Error('skip'))
+        })
+      })
+      nickname = profileRes.userInfo?.nickName || ''
+      avatarUrl = profileRes.userInfo?.avatarUrl || ''
+    } catch (e) {
+      // User declined profile permission - still login with code only
+    }
+
+    // Step 3: Send code to backend
+    await userStore.wechatLogin(loginRes.code, nickname, avatarUrl)
+
+    uni.hideLoading()
+    uni.showToast({ title: '登录成功', icon: 'success' })
+    setTimeout(() => {
+      // 使用 switchTab 跳转到首页（reLaunch 清空了页面栈）
+      uni.switchTab({ url: '/pages/index/index' })
+    }, 500)
+  } catch (e) {
+    uni.hideLoading()
+    uni.showToast({ title: e.message || '登录失败', icon: 'none' })
+  }
+}
+</script>
+
+<style scoped lang="scss">
+.page-login {
+  min-height: 100vh;
+  background: linear-gradient(180deg, #F8F9FF 0%, #EEF2FF 100%);
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  padding: 0 24px;
+}
+.login-card {
+  background: #fff;
+  border-radius: 20px;
+  padding: 40px 28px 32px;
+  box-shadow: 0 4px 20px rgba(0,0,0,0.06);
+  width: 100%;
+  max-width: 360px;
+}
+.logo-area {
+  text-align: center;
+  margin-bottom: 32px;
+}
+.logo-icon {
+  font-size: 48px;
+  display: block;
+  margin-bottom: 8px;
+}
+.logo-title {
+  font-size: 22px;
+  font-weight: 700;
+  color: #1F2937;
+  display: block;
+}
+.logo-desc {
+  font-size: 13px;
+  color: #9CA3AF;
+  display: block;
+  margin-top: 4px;
+}
+.features {
+  margin-bottom: 28px;
+}
+.feature-item {
+  display: flex;
+  align-items: center;
+  margin-bottom: 12px;
+}
+.feature-icon {
+  font-size: 16px;
+  margin-right: 8px;
+}
+.feature-text {
+  font-size: 14px;
+  color: #6B7280;
+}
+.wechat-btn {
+  width: 100%;
+  height: 48px;
+  background: linear-gradient(135deg, #4A148C, #7B2DC8);
+  color: #fff;
+  border: none;
+  border-radius: 12px;
+  font-size: 17px;
+  font-weight: 600;
+  line-height: 48px;
+  text-align: center;
+}
+.agreement {
+  display: block;
+  text-align: center;
+  font-size: 12px;
+  color: #9CA3AF;
+  margin-top: 16px;
+}
+</style>

client/src/pages/payment/index.vue → client/pages/payment/index.vue

@@ -33,7 +33,7 @@
   </view>
 </template>
 
-<script setup lang="ts">
+<script setup>
 import { ref } from 'vue'
 import { payApi } from '@/utils/api'
 
@@ -42,17 +42,32 @@ const paying = ref(false)
 async function handlePay() {
   paying.value = true
   try {
-    // Placeholder - integrates with WeChat Pay
-    const order: any = await payApi.create({ totalFee: 39800, payType: 'wxpay' })
-    uni.showToast({
-      title: '支付成功!',
-      icon: 'success',
-      success: () => {
-        setTimeout(() => uni.navigateBack(), 1500)
-      }
-    })
+    const order = await payApi.create({ totalFee: 39800, payType: 'wxpay' })
+    // Dev mode — WxPay returns mock prepay params directly
+    if (order.mock) {
+      // In dev/mock mode, simulate payment success
+      uni.showToast({ title: '支付成功!', icon: 'success' })
+      setTimeout(() => uni.navigateBack(), 1500)
+    } else if (order.prepayId) {
+      // Real WeChat Pay — invoke payment SDK
+      uni.requestPayment({
+        provider: 'wxpay',
+        timeStamp: order.timeStamp,
+        nonceStr: order.nonceStr,
+        package: order.package,
+        signType: order.signType || 'MD5',
+        paySign: order.paySign,
+        success: () => {
+          uni.showToast({ title: '支付成功!', icon: 'success' })
+          setTimeout(() => uni.navigateBack(), 1500)
+        },
+        fail: () => {
+          uni.showToast({ title: '支付取消', icon: 'none' })
+        }
+      })
+    }
   } catch (e) {
-    uni.showToast({ title: '支付失败', icon: 'none' })
+    uni.showToast({ title: '支付失败: ' + (e.message || ''), icon: 'none' })
   } finally {
     paying.value = false
   }

client/src/pages/profile/index.vue → client/pages/profile/index.vue

@@ -1,11 +1,12 @@
 <template>
   <view class="page-profile">
     <!-- User info card -->
-    <view class="user-card">
+    <view class="user-card" @click="goLogin">
       <view class="avatar">
         <image :src="userStore.avatarUrl || '/static/default-avatar.png'" mode="aspectFill" />
       </view>
       <text class="nickname">{{ userStore.nickname || '未登录' }}</text>
+      <text v-if="!userStore.isLoggedIn" class="login-hint">点击登录</text>
       <view v-if="userStore.isVip" class="vip-badge">VIP 会员</view>
     </view>
 
@@ -20,6 +21,19 @@
       <text class="vip-action">{{ userStore.isVip ? '续费' : '立即开通' }}</text>
     </view>
 
+    <!-- Daily quota (non-VIP) -->
+    <view v-if="!userStore.isVip" class="quota-card">
+      <view class="quota-item">
+        <text class="quota-label">今日分析</text>
+        <text class="quota-value">{{ userStore.usedCharts }}/{{ userStore.maxCharts }}</text>
+      </view>
+      <view class="quota-divider"></view>
+      <view class="quota-item">
+        <text class="quota-label">今日解读</text>
+        <text class="quota-value">{{ userStore.usedChats }}/{{ userStore.maxChats }}</text>
+      </view>
+    </view>
+
     <!-- Menu list -->
     <view class="menu-section">
       <view class="menu-item" @click="goRecords">
@@ -45,7 +59,7 @@
   </view>
 </template>
 
-<script setup lang="ts">
+<script setup>
 import { onShow } from '@dcloudio/uni-app'
 import { useUserStore } from '@/stores/user'
 
@@ -54,9 +68,17 @@ const userStore = useUserStore()
 onShow(() => {
   if (userStore.isLoggedIn) {
     userStore.fetchProfile()
+    userStore.fetchQuota()
+    userStore.fetchCommissionSummary()
   }
 })
 
+function goLogin() {
+  if (!userStore.isLoggedIn) {
+    uni.navigateTo({ url: '/pages/login/index' })
+  }
+}
+
 function goPayment() {
   uni.navigateTo({ url: '/pages/payment/index' })
 }
@@ -104,6 +126,7 @@ function handleLogout() {
 }
 .avatar image { width: 100%; height: 100%; }
 .nickname { font-size: 18px; font-weight: 600; display: block; color: #1F2937; }
+.login-hint { font-size: 12px; color: #3B82F6; display: block; margin-top: 4px; }
 .vip-badge {
   display: inline-block; background: #FEF3C7; color: #D97706;
   padding: 2px 12px; border-radius: 12px; font-size: 12px; margin-top: 8px;
@@ -124,4 +147,13 @@ function handleLogout() {
 .menu-item:last-child { border-bottom: none; }
 .menu-arrow { color: #9CA3AF; font-size: 18px; }
 .menu-tip { color: #3B82F6; font-size: 12px; }
+
+.quota-card {
+  background: #fff; border-radius: 12px; padding: 16px; margin-bottom: 16px;
+  display: flex; align-items: center; justify-content: space-around;
+}
+.quota-item { text-align: center; }
+.quota-label { font-size: 12px; color: #6B7280; display: block; margin-bottom: 4px; }
+.quota-value { font-size: 20px; font-weight: 700; color: #1F2937; }
+.quota-divider { width: 1px; height: 36px; background: #E5E7EB; }
 </style>

client/src/pages/records/index.vue → client/pages/records/index.vue

@@ -14,10 +14,10 @@
         @click="viewDetail(record)"
       >
         <view class="record-header">
-          <text class="record-name">{{ record.name || record.phoneNumber }}</text>
+          <text class="record-name">{{ record.name || record.birthday || '未知' }}</text>
           <text class="record-date">{{ formatDate(record.createdAt) }}</text>
         </view>
-        <text class="record-phone">{{ record.phoneNumber }}</text>
+        <text class="record-phone">{{ record.birthday || '' }}</text>
         <view class="record-tags">
           <text v-if="record.difyResponse" class="tag-status">已解读</text>
         </view>
@@ -26,7 +26,7 @@
   </view>
 </template>
 
-<script setup lang="ts">
+<script setup>
 import { onShow } from '@dcloudio/uni-app'
 import { useChartStore } from '@/stores/chart'
 
@@ -36,16 +36,14 @@ onShow(() => {
   store.fetchRecords()
 })
 
-function formatDate(dateStr: string): string {
+function formatDate(dateStr) {
   if (!dateStr) return ''
   return dateStr.slice(0, 10)
 }
 
-function viewDetail(record: any) {
-  uni.showModal({
-    title: '分析详情',
-    content: `号码: ${record.phoneNumber}\n姓名: ${record.name || '-'}\n创建: ${formatDate(record.createdAt)}`,
-    showCancel: false
+function viewDetail(record) {
+  store.loadChart(record.id).then(() => {
+    uni.navigateTo({ url: '/pages/chart/index' })
   })
 }
 </script>

client/pages/subscribe/index.vue

@@ -0,0 +1,216 @@
+<template>
+  <view class="page">
+    <!-- Hero area -->
+    <view class="hero">
+      <text class="hero-icon">✦</text>
+      <text class="price">¥398</text>
+      <text class="per">/年</text>
+      <text class="desc">每天仅 ¥1.09，让数字能量成为你的生产力</text>
+    </view>
+
+    <!-- Benefits -->
+    <view class="card">
+      <view class="benefit" v-for="item in benefits" :key="item">
+        <text class="check-icon">◆</text>
+        <text>{{ item }}</text>
+      </view>
+    </view>
+
+    <!-- Compare table -->
+    <view class="compare-card">
+      <view class="compare-header">
+        <text class="col">功能</text>
+        <text class="col">普通用户</text>
+        <text class="col pro">能量师</text>
+      </view>
+      <view class="compare-row" v-for="row in compareData" :key="row.label">
+        <text class="col">{{ row.label }}</text>
+        <text class="col free">{{ row.free }}</text>
+        <text class="col pro">{{ row.pro }}</text>
+      </view>
+    </view>
+
+    <!-- Pay button -->
+    <button class="pay-btn" @click="onPay" :disabled="paying">
+      {{ paying ? '处理中...' : '立即开通 · 能量师 ¥398/年' }}
+    </button>
+    <text class="note">支付即表示同意《订阅协议》</text>
+  </view>
+</template>
+
+<script setup>
+import { ref } from 'vue'
+import { payApi } from '@/utils/api'
+
+const paying = ref(false)
+
+const benefits = [
+  '无限命盘生成，不限次数',
+  'AI 五区完整解读，随问随答',
+  '无限分享 & PDF 导出',
+  '全部历史记录',
+  '推广赚佣金，¥119.4/人'
+]
+
+const compareData = [
+  { label: '命盘生成', free: '3次/天', pro: '不限' },
+  { label: 'AI 解读', free: '3轮/天', pro: '无限次' },
+  { label: '分享', free: '1次/天', pro: '不限' },
+  { label: '推广佣金', free: '--', pro: '最高¥159.2/人' },
+]
+
+async function onPay() {
+  paying.value = true
+  try {
+    const res = await payApi.create({ totalFee: 39800, payType: 'wxpay' })
+    uni.showToast({ title: '开通成功！', icon: 'success' })
+    setTimeout(() => uni.navigateBack(), 1500)
+  } catch (e) {
+    uni.showToast({ title: '支付失败，请重试', icon: 'none' })
+  }
+  paying.value = false
+}
+</script>
+
+<style scoped lang="scss">
+.page {
+  padding: 20px;
+  min-height: 100vh;
+  background: linear-gradient(180deg, #0c0a1a 0%, #120d28 60%, #0f0c1e 100%);
+}
+
+.hero {
+  background: linear-gradient(135deg, rgba(251, 191, 36, 0.1), rgba(217, 119, 6, 0.06));
+  border: 1px solid rgba(251, 191, 36, 0.12);
+  border-radius: 18px;
+  padding: 36px 20px;
+  text-align: center;
+  color: #fff;
+  margin-bottom: 16px;
+}
+
+.hero-icon {
+  display: block;
+  font-size: 20px;
+  color: #fbbf24;
+  margin-bottom: 12px;
+  opacity: 0.6;
+}
+
+.price {
+  font-size: 48px;
+  font-weight: 700;
+  color: #fbbf24;
+  text-shadow: 0 0 30px rgba(251, 191, 36, 0.2);
+}
+
+.per {
+  font-size: 16px;
+  color: rgba(255, 255, 255, 0.5);
+  margin-left: 4px;
+}
+
+.desc {
+  display: block;
+  font-size: 13px;
+  color: rgba(255, 255, 255, 0.4);
+  margin-top: 14px;
+  letter-spacing: 1px;
+}
+
+.card {
+  background: rgba(255, 255, 255, 0.03);
+  border: 1px solid rgba(255, 255, 255, 0.06);
+  border-radius: 14px;
+  padding: 20px;
+  margin-bottom: 16px;
+}
+
+.benefit {
+  padding: 8px 0;
+  font-size: 14px;
+  color: rgba(255, 255, 255, 0.7);
+  display: flex;
+  align-items: center;
+}
+
+.check-icon {
+  color: #fbbf24;
+  margin-right: 12px;
+  font-size: 10px;
+  opacity: 0.6;
+}
+
+.compare-card {
+  background: rgba(255, 255, 255, 0.03);
+  border: 1px solid rgba(255, 255, 255, 0.06);
+  border-radius: 14px;
+  overflow: hidden;
+  margin-bottom: 20px;
+}
+
+.compare-header,
+.compare-row {
+  display: flex;
+  padding: 14px 16px;
+  font-size: 13px;
+}
+
+.compare-header {
+  background: rgba(251, 191, 36, 0.06);
+  font-weight: 600;
+  color: rgba(255, 255, 255, 0.7);
+}
+
+.compare-row {
+  border-bottom: 1px solid rgba(255, 255, 255, 0.04);
+}
+
+.compare-row:last-child {
+  border-bottom: none;
+}
+
+.col {
+  flex: 1;
+  text-align: center;
+  color: rgba(255, 255, 255, 0.5);
+}
+
+.col:first-child {
+  text-align: left;
+  flex: 1.5;
+  color: rgba(255, 255, 255, 0.7);
+}
+
+.free {
+  color: rgba(255, 255, 255, 0.3);
+}
+
+.pro {
+  color: #fbbf24;
+}
+
+.pay-btn {
+  width: 100%;
+  padding: 16px;
+  background: linear-gradient(135deg, #f59e0b, #d97706);
+  color: #fff;
+  border: none;
+  border-radius: 14px;
+  font-size: 17px;
+  font-weight: 600;
+  letter-spacing: 2px;
+  margin-bottom: 8px;
+}
+
+.pay-btn[disabled] {
+  opacity: 0.4;
+}
+
+.note {
+  display: block;
+  text-align: center;
+  font-size: 12px;
+  color: rgba(255, 255, 255, 0.25);
+}
+</style>

client/src/components/TriangleChart.vue

@@ -1,152 +0,0 @@
-<template>
-  <canvas
-    class="triangle-canvas"
-    :style="{ width: canvasWidth + 'px', height: canvasHeight + 'px' }"
-  ></canvas>
-</template>
-
-<script setup lang="ts">
-import { ref, onMounted, watch, nextTick } from 'vue'
-import type { TriangleResult } from '@/utils/calculator'
-
-const props = defineProps<{
-  chartData: TriangleResult
-}>()
-
-const canvasWidth = ref(320)
-const canvasHeight = ref(400)
-
-const ZONE_COLORS: Record<string, string> = {
-  left: 'rgba(59, 130, 246, 0.08)',
-  mid: 'rgba(16, 185, 129, 0.08)',
-  right: 'rgba(245, 158, 11, 0.08)',
-  father: 'rgba(139, 92, 246, 0.08)',
-  mother: 'rgba(236, 72, 153, 0.08)',
-  main: 'rgba(212, 168, 71, 0.15)'
-}
-
-function getNumColor(num: number): string {
-  const map: Record<number, string> = {
-    1: '#3B82F6', 2: '#10B981', 3: '#F59E0B',
-    4: '#8B5CF6', 5: '#EF4444', 6: '#EC4899',
-    7: '#6366F1', 8: '#D97706', 9: '#14B8A6',
-    0: '#9CA3AF'
-  }
-  return map[num] || '#9CA3AF'
-}
-
-type PosDef = { key: string; x: number; y: number; zone: string; label: string }
-const positions: PosDef[] = [
-  { key: 'A', x: 10, y: 5, zone: 'left', label: 'A' },
-  { key: 'B', x: 30, y: 5, zone: 'mid', label: 'B' },
-  { key: 'C', x: 50, y: 5, zone: 'right', label: 'C' },
-  { key: 'D', x: 70, y: 5, zone: 'right', label: 'D' },
-  { key: 'E', x: 90, y: 5, zone: 'right', label: 'E' },
-  { key: 'F', x: 10, y: 30, zone: 'father', label: 'F' },
-  { key: 'G', x: 30, y: 30, zone: 'left', label: 'G' },
-  { key: 'H', x: 70, y: 30, zone: 'right', label: 'H' },
-  { key: 'I', x: 90, y: 30, zone: 'mother', label: 'I' },
-  { key: 'J', x: 10, y: 55, zone: 'father', label: 'J' },
-  { key: 'K', x: 50, y: 55, zone: 'left', label: 'K' },
-  { key: 'L', x: 90, y: 55, zone: 'mother', label: 'L' },
-  { key: 'M', x: 10, y: 75, zone: 'left', label: 'M' },
-  { key: 'N', x: 50, y: 75, zone: 'right', label: 'N' },
-  { key: 'O', x: 50, y: 90, zone: 'main', label: 'O' },
-]
-
-const lines: [string, string][] = [
-  ['A', 'F'], ['B', 'F'], ['B', 'G'], ['C', 'G'],
-  ['C', 'H'], ['D', 'H'], ['D', 'I'], ['E', 'I'],
-  ['F', 'J'], ['G', 'J'], ['G', 'K'], ['H', 'K'],
-  ['H', 'L'], ['I', 'L'],
-  ['J', 'M'], ['K', 'M'], ['K', 'N'], ['L', 'N'],
-  ['M', 'O'], ['N', 'O']
-]
-
-function drawChart(ctx: CanvasRenderingContext2D, w: number, h: number) {
-  const padX = 20
-  const padY = 25
-  const drawW = w - padX * 2
-  const drawH = h - padY * 2
-
-  ctx.clearRect(0, 0, w, h)
-
-  const posMap = new Map(positions.map(p => [
-    p.key,
-    { x: padX + p.x / 100 * drawW, y: padY + p.y / 100 * drawH, zone: p.zone, label: p.label }
-  ]))
-
-  ctx.strokeStyle = '#CBD5E1'
-  ctx.lineWidth = 1.5
-  for (const [from, to] of lines) {
-    const p1 = posMap.get(from); const p2 = posMap.get(to)
-    if (!p1 || !p2) continue
-    ctx.beginPath()
-    ctx.moveTo(p1.x, p1.y)
-    ctx.lineTo(p2.x, p2.y)
-    ctx.stroke()
-  }
-
-  for (const [key, pos] of posMap) {
-    const num = (props.chartData as any)[key] ?? null
-    const radius = key === 'O' ? 22 : 16
-    const isMain = key === 'O'
-
-    ctx.beginPath()
-    ctx.arc(pos.x, pos.y, radius, 0, Math.PI * 2)
-    ctx.fillStyle = isMain ? '#D4A847' : '#fff'
-    ctx.fill()
-    ctx.strokeStyle = isMain ? '#B8860B' : (num !== null ? getNumColor(num) : '#E5E7EB')
-    ctx.lineWidth = isMain ? 3 : 2
-    ctx.stroke()
-
-    if (num !== null) {
-      ctx.fillStyle = isMain ? '#fff' : '#1F2937'
-      ctx.font = `bold ${isMain ? '18' : '15'}px sans-serif`
-      ctx.textAlign = 'center'
-      ctx.textBaseline = 'middle'
-      ctx.fillText(String(num), pos.x, pos.y)
-    }
-
-    ctx.fillStyle = '#9CA3AF'
-    ctx.font = '11px sans-serif'
-    ctx.textAlign = 'center'
-    ctx.textBaseline = 'top'
-    ctx.fillText(pos.label, pos.x, pos.y + radius + 4)
-  }
-}
-
-function render() {
-  const sysInfo = uni.getSystemInfoSync()
-  canvasWidth.value = Math.min(sysInfo.windowWidth - 32, 360)
-  canvasHeight.value = Math.min(canvasWidth.value * 1.25, 420)
-
-  nextTick(() => {
-    const query = uni.createSelectorQuery()
-    query.select('.triangle-canvas')
-      .fields({ node: true, size: true }, (res: any) => {
-        if (!res?.node) return
-        const canvas = res.node as HTMLCanvasElement
-        const ctx = canvas.getContext('2d') as CanvasRenderingContext2D
-        const dpr = sysInfo.pixelRatio
-        canvas.width = canvasWidth.value * dpr
-        canvas.height = canvasHeight.value * dpr
-        ctx.scale(dpr, dpr)
-        drawChart(ctx, canvasWidth.value, canvasHeight.value)
-      })
-      .exec()
-  })
-}
-
-onMounted(() => render())
-watch(() => props.chartData, () => render(), { deep: true })
-</script>
-
-<style scoped>
-.triangle-canvas {
-  display: block;
-  margin: 0 auto;
-  background: #FFFFFF;
-  border-radius: 12px;
-}
-</style>

client/src/main.ts

@@ -1,7 +0,0 @@
-import { createApp } from 'vue'
-import { createPinia } from 'pinia'
-import App from './App.vue'
-
-const app = createApp(App)
-app.use(createPinia())
-app.mount('#app')

client/src/manifest.json

@@ -1,18 +0,0 @@
-{
-  "name": "num-energy",
-  "appid": "your_appid",
-  "description": "数码能量学 AI 智能体",
-  "versionName": "1.0.0",
-  "versionCode": "100",
-  "mp-weixin": {
-    "appid": "your_appid",
-    "setting": {
-      "urlCheck": false,
-      "es6": true,
-      "postcss": true,
-      "minified": true
-    },
-    "usingComponents": true,
-    "permission": {}
-  }
-}

client/src/pages/index/index.vue

@@ -1,230 +0,0 @@
-<template>
-  <view class="page-index">
-    <!-- Birth input section -->
-    <view class="input-section">
-      <view class="input-card">
-        <text class="label">姓名（选填）</text>
-        <input
-          class="input-field"
-          v-model="name"
-          placeholder="请输入姓名"
-        />
-        <text class="label mt-12">出生年份</text>
-        <input
-          class="input-field"
-          type="digit"
-          maxlength="4"
-          v-model="birthYear"
-          placeholder="例如 1990"
-        />
-        <view class="row-inputs">
-          <view class="half-input">
-            <text class="label">月份</text>
-            <input class="input-field" type="digit" maxlength="2" v-model="birthMonth" placeholder="1-12" />
-          </view>
-          <view class="half-input">
-            <text class="label">日期</text>
-            <input class="input-field" type="digit" maxlength="2" v-model="birthDay" placeholder="1-31" />
-          </view>
-        </view>
-        <button class="analyze-btn" @click="onAnalyze">生成命盘</button>
-      </view>
-    </view>
-
-    <!-- Triangle chart section -->
-    <view v-if="store.currentChart" class="chart-section">
-      <view class="section-title">数字能量三角图</view>
-      <TriangleChart :chartData="store.currentChart" />
-
-      <!-- Primary numbers -->
-      <view class="primary-section">
-        <text class="section-title">主星能量</text>
-        <view class="primary-grid">
-          <view
-            v-for="item in store.analysis?.primary"
-            :key="item.position"
-            class="primary-card"
-            :class="'card-' + item.position.toLowerCase()"
-          >
-            <text class="card-position">{{ item.position }}</text>
-            <text class="card-number">{{ item.number }}</text>
-            <text class="card-energy">{{ item.energy }}</text>
-          </view>
-        </view>
-      </view>
-
-      <!-- Combination analysis -->
-      <view class="combo-section">
-        <text class="section-title">数字组合</text>
-        <view class="combo-list">
-          <view
-            v-for="(item, idx) in store.analysis?.combinations"
-            :key="idx"
-            class="combo-item"
-          >
-            <text class="combo-pair">{{ item.pair }}</text>
-            <text class="combo-meaning">{{ item.meaning }}</text>
-          </view>
-        </view>
-      </view>
-    </view>
-
-    <!-- Chat section (bottom half) -->
-    <view v-if="store.currentChart" class="chat-section">
-      <view class="section-title">AI 解读</view>
-      <scroll-view class="chat-box" scroll-y :scroll-top="scrollTop">
-        <view v-for="(msg, idx) in messages" :key="idx" class="msg-row" :class="msg.role">
-          <view class="msg-bubble">
-            <text>{{ msg.content }}</text>
-          </view>
-        </view>
-      </scroll-view>
-
-      <view class="quick-questions">
-        <view
-          v-for="q in quickQuestions"
-          :key="q"
-          class="quick-chip"
-          @click="sendQuestion(q)"
-        >
-          <text>{{ q }}</text>
-        </view>
-      </view>
-
-      <view class="input-bar">
-        <input
-          class="chat-input"
-          v-model="chatInput"
-          placeholder="输入您的问题..."
-          @confirm="sendQuestion(chatInput)"
-        />
-        <button class="send-btn" @click="sendQuestion(chatInput)">发送</button>
-      </view>
-    </view>
-  </view>
-</template>
-
-<script setup lang="ts">
-import { ref } from 'vue'
-import { useChartStore } from '@/stores/chart'
-import TriangleChart from '@/components/TriangleChart.vue'
-
-const store = useChartStore()
-const name = ref('')
-const birthYear = ref('')
-const birthMonth = ref('')
-const birthDay = ref('')
-const chatInput = ref('')
-const scrollTop = ref(0)
-const messages = ref<Array<{role: string, content: string}>>([])
-
-const quickQuestions = ['职业发展', '财运分析', '感情运势', '健康建议']
-
-function onAnalyze() {
-  const year = parseInt(birthYear.value)
-  const month = parseInt(birthMonth.value)
-  const day = parseInt(birthDay.value)
-
-  if (!year || !month || !day) {
-    uni.showToast({ title: '请输入完整的出生年月日', icon: 'none' })
-    return
-  }
-  if (year < 1900 || year > new Date().getFullYear()) {
-    uni.showToast({ title: '请输入正确的出生年份', icon: 'none' })
-    return
-  }
-  if (month < 1 || month > 12) {
-    uni.showToast({ title: '请输入正确的月份(1-12)', icon: 'none' })
-    return
-  }
-  if (day < 1 || day > 31) {
-    uni.showToast({ title: '请输入正确的日期(1-31)', icon: 'none' })
-    return
-  }
-
-  store.computeChart(year, month, day)
-  messages.value = [{
-    role: 'ai',
-    content: `已为您生成${name.value || 'ta'}的命盘。主性格数字为${store.currentChart?.O}。请点击下方问题或输入您想了解的内容。`
-  }]
-}
-
-async function sendQuestion(q: string) {
-  if (!q.trim()) return
-  messages.value.push({ role: 'user', content: q })
-  chatInput.value = ''
-  setTimeout(() => {
-    messages.value.push({
-      role: 'ai',
-      content: `数字能量分析显示，${q}方面您的能量组合表明有良好的发展潜力，请结合自身情况理性决策。`
-    })
-    scrollTop.value = 99999
-  }, 800)
-}
-</script>
-
-<style scoped lang="scss">
-.page-index { padding-bottom: 30px; }
-.input-section { padding: 16px; }
-.input-card {
-  background: #fff; border-radius: 12px; padding: 20px;
-  box-shadow: 0 2px 8px rgba(0,0,0,0.06);
-}
-.label { font-size: 14px; color: #6B7280; margin-bottom: 8px; display: block; }
-.input-field {
-  height: 44px; border: 1px solid #E5E7EB; border-radius: 8px;
-  padding: 0 12px; font-size: 16px; margin-bottom: 12px; width: 100%;
-}
-.mt-12 { margin-top: 12px; display: block; }
-.row-inputs { display: flex; gap: 12px; }
-.half-input { flex: 1; }
-.phone-input {
-  height: 44px; border: 1px solid #E5E7EB; border-radius: 8px;
-  padding: 0 12px; font-size: 18px; margin-bottom: 12px;
-}
-.analyze-btn {
-  width: 100%; height: 44px; background: #3B82F6; color: #fff;
-  border: none; border-radius: 8px; font-size: 16px; line-height: 44px;
-}
-.chart-section, .chat-section { margin: 0 16px; }
-.section-title { font-size: 16px; font-weight: 600; color: #1F2937; margin: 16px 0 12px; display: block; }
-.primary-grid { display: flex; flex-wrap: wrap; gap: 10px; }
-.primary-card {
-  flex: 1; min-width: 70px; padding: 12px; border-radius: 10px;
-  text-align: center; background: #F3F4F6;
-}
-.card-position { font-size: 12px; color: #6B7280; display: block; }
-.card-number { font-size: 24px; font-weight: 700; color: #1F2937; display: block; }
-.card-energy { font-size: 11px; color: #6B7280; display: block; margin-top: 4px; }
-.combo-list { display: flex; flex-wrap: wrap; gap: 6px; }
-.combo-item {
-  background: #F3F4F6; padding: 6px 12px; border-radius: 16px;
-  display: flex; gap: 8px;
-}
-.combo-pair { font-weight: 600; color: #3B82F6; font-size: 13px; }
-.combo-meaning { color: #6B7280; font-size: 13px; }
-
-.chat-box {
-  height: 300px; background: #fff; border-radius: 12px; padding: 12px;
-  margin-bottom: 8px;
-}
-.msg-row { margin-bottom: 12px; display: flex; }
-.msg-row.user { justify-content: flex-end; }
-.msg-bubble {
-  max-width: 80%; padding: 10px 14px; border-radius: 12px;
-  background: #F3F4F6;
-}
-.msg-row.user .msg-bubble { background: #3B82F6; color: #fff; }
-.quick-questions { display: flex; flex-wrap: wrap; gap: 6px; margin-bottom: 8px; }
-.quick-chip {
-  background: #EFF6FF; padding: 6px 14px; border-radius: 16px; font-size: 13px; color: #3B82F6;
-}
-.input-bar { display: flex; gap: 8px; }
-.chat-input {
-  flex: 1; height: 40px; border: 1px solid #E5E7EB; border-radius: 8px; padding: 0 12px;
-}
-.send-btn {
-  height: 40px; padding: 0 20px; background: #3B82F6; color: #fff;
-  border: none; border-radius: 8px; line-height: 40px;
-}
-</style>

client/src/stores/chart.ts

@@ -1,59 +0,0 @@
-import { defineStore } from 'pinia'
-import { chartApi, annotationApi } from '@/utils/api'
-import { calculateTriangle, analyzeTriangle, TriangleResult } from '@/utils/calculator'
-
-interface ChartState {
-  currentName: string
-  currentBirthYear: number
-  currentBirthMonth: number
-  currentBirthDay: number
-  currentChart: TriangleResult | null
-  analysis: any | null
-  records: any[]
-  annotations: any[]
-  tags: any[]
-}
-
-export const useChartStore = defineStore('chart', {
-  state: (): ChartState => ({
-    currentName: '',
-    currentBirthYear: 0,
-    currentBirthMonth: 0,
-    currentBirthDay: 0,
-    currentChart: null,
-    analysis: null,
-    records: [],
-    annotations: [],
-    tags: []
-  }),
-  actions: {
-    computeChart(year: number, month: number, day: number, name?: string) {
-      this.currentBirthYear = year
-      this.currentBirthMonth = month
-      this.currentBirthDay = day
-      if (name) this.currentName = name
-      this.currentChart = calculateTriangle(year, month, day)
-      this.analysis = analyzeTriangle(this.currentChart)
-    },
-    async saveChart(name: string, birthday: string) {
-      const chartData = JSON.stringify(this.currentChart)
-      const record = await chartApi.create({ name, birthday, chartData })
-      return record
-    },
-    async fetchRecords() {
-      this.records = await chartApi.list() as any
-    },
-    async fetchAnnotations(recordId: number) {
-      this.annotations = await annotationApi.list(recordId) as any
-    },
-    async addAnnotation(recordId: number, position: string, content: string) {
-      return await annotationApi.add({ recordId, position, content })
-    },
-    async fetchTags(recordId: number) {
-      this.tags = await annotationApi.listTags(recordId) as any
-    },
-    async addTag(recordId: number, tag: string) {
-      return await annotationApi.addTag({ recordId, tag })
-    }
-  }
-})

client/src/stores/user.ts

@@ -1,54 +0,0 @@
-import { defineStore } from 'pinia'
-import { authApi, profileApi } from '@/utils/api'
-
-interface UserState {
-  token: string
-  nickname: string
-  avatarUrl: string
-  isVip: boolean
-  vipEndTime: string | null
-  referralCode: string
-}
-
-export const useUserStore = defineStore('user', {
-  state: (): UserState => ({
-    token: uni.getStorageSync('token') || '',
-    nickname: '',
-    avatarUrl: '',
-    isVip: false,
-    vipEndTime: null,
-    referralCode: ''
-  }),
-  getters: {
-    isLoggedIn: (state) => !!state.token,
-    isVipActive: (state) => {
-      if (!state.vipEndTime) return false
-      return new Date(state.vipEndTime) > new Date()
-    }
-  },
-  actions: {
-    async login(openid: string, nickname: string, avatarUrl: string, referralCode?: string) {
-      const data: any = { openid, nickname, avatarUrl }
-      if (referralCode) data.referralCode = referralCode
-      const token: string = await authApi.login(data) as any
-      this.token = token
-      uni.setStorageSync('token', token)
-      this.nickname = nickname
-      this.avatarUrl = avatarUrl
-    },
-    async fetchProfile() {
-      const user: any = await profileApi.info()
-      this.nickname = user.nickname
-      this.avatarUrl = user.avatarUrl
-      this.referralCode = user.referralCode
-      this.isVip = !!user.vipEndTime && new Date(user.vipEndTime) > new Date()
-      this.vipEndTime = user.vipEndTime
-    },
-    logout() {
-      this.token = ''
-      this.nickname = ''
-      this.avatarUrl = ''
-      uni.removeStorageSync('token')
-    }
-  }
-})

client/src/utils/api.ts

@@ -1,69 +0,0 @@
-import axios from 'axios'
-
-const request = axios.create({
-  baseURL: '/api',
-  timeout: 30000,
-  headers: { 'Content-Type': 'application/json' }
-})
-
-request.interceptors.request.use(config => {
-  const token = uni.getStorageSync('token')
-  if (token) {
-    config.headers.Authorization = `Bearer ${token}`
-  }
-  return config
-})
-
-request.interceptors.response.use(
-  response => {
-    const res = response.data
-    if (res.code !== 0) {
-      uni.showToast({ title: res.message, icon: 'none' })
-      if (res.code === 1001) {
-        uni.removeStorageSync('token')
-        uni.navigateTo({ url: '/pages/profile/index' })
-      }
-      return Promise.reject(new Error(res.message))
-    }
-    return res.data
-  },
-  error => {
-    uni.showToast({ title: '网络错误', icon: 'none' })
-    return Promise.reject(error)
-  }
-)
-
-export default request
-
-export const authApi = {
-  login: (data: Record<string, any>) => request.post('/auth/login', data)
-}
-
-export const chartApi = {
-  create: (data: Record<string, any>) => request.post('/chart/create', data),
-  list: () => request.post('/chart/list', {}),
-  detail: (id: number) => request.post('/chart/detail', { id })
-}
-
-export const payApi = {
-  create: (data: Record<string, any>) => request.post('/pay/create', data)
-}
-
-export const profileApi = {
-  info: () => request.post('/profile/info', {}),
-  vipStatus: () => request.post('/profile/vip-status', {})
-}
-
-export const annotationApi = {
-  add: (data: Record<string, any>) => request.post('/annotation/add', data),
-  list: (recordId: number) => request.post('/annotation/list', { recordId }),
-  delete: (id: number) => request.post('/annotation/delete', { id }),
-  addTag: (data: Record<string, any>) => request.post('/annotation/tag/add', data),
-  listTags: (recordId: number) => request.post('/annotation/tag/list', { recordId }),
-  deleteTag: (id: number) => request.post('/annotation/tag/delete', { id })
-}
-
-export const commissionApi = {
-  list: () => request.post('/commission/list', {}),
-  total: () => request.post('/commission/total', {})
-}

client/src/utils/calculator.ts

@@ -1,118 +0,0 @@
-function reduceToDigit(n: number): number {
-  if (n === 11 || n === 22 || n === 33) return n
-  while (n > 9) {
-    n = String(n).split('').reduce((s, c) => s + parseInt(c), 0)
-  }
-  return n
-}
-
-const ENERGY_MAP: Record<string, string> = {
-  '1': '领导力、创造、独立', '2': '合作、平衡、感性',
-  '3': '表达、社交、艺术', '4': '稳定、务实、规则',
-  '5': '自由、变化、冒险', '6': '关爱、责任、家庭',
-  '7': '智慧、分析、内省', '8': '财富、权力、成就',
-  '9': '博爱、理想、智慧', '0': '潜能、灵性、无限'
-}
-
-const COMBINATION_MAP: Record<string, string> = {
-  '12': '创新与合作', '13': '创意表达', '14': '务实创新',
-  '15': '变革领导', '16': '关怀创造', '17': '智慧创新',
-  '18': '财富创造', '19': '理想创造', '21': '合作创新',
-  '23': '社交表达', '24': '稳定合作', '25': '自由协作',
-  '26': '关爱合作', '27': '智慧合作', '28': '财富合作',
-  '31': '表达创造', '32': '社交协作', '34': '务实表达',
-  '35': '自由表达', '36': '关爱表达', '37': '智慧表达',
-  '38': '财富表达', '39': '理想表达', '41': '务实创新',
-  '42': '稳定合作', '43': '务实社交', '45': '稳定变化',
-  '46': '务实关爱', '47': '务实智慧', '48': '财富稳定',
-  '51': '变革领导', '52': '自由协作', '53': '自由表达',
-  '54': '变化稳定', '56': '自由关爱', '57': '智慧变化',
-  '58': '自由财富', '59': '自由理想', '61': '关爱领导',
-  '62': '关爱协作', '63': '情感表达', '64': '稳定关爱',
-  '65': '自由关怀', '67': '智慧关怀', '68': '财富关怀',
-  '71': '智慧领导', '72': '智慧协作', '73': '智慧表达',
-  '74': '务实智慧', '75': '智慧变化', '76': '智慧关怀',
-  '78': '智慧财富', '79': '智慧理想', '81': '财富领导',
-  '82': '财富协作', '83': '财富表达', '84': '务实财富',
-  '85': '自由财富', '86': '财富关怀', '87': '智慧财富',
-  '89': '财富理想', '91': '理想领导', '92': '理想协作',
-  '93': '理想表达', '94': '务实理想', '95': '自由理想',
-  '96': '关爱理想', '97': '智慧理想', '98': '财富理想'
-}
-
-export function getEnergy(num: number): string {
-  return ENERGY_MAP[String(num)] || '未知能量'
-}
-
-export function getCombination(a: number, b: number): string {
-  return COMBINATION_MAP[`${a}${b}`] || `${getEnergy(a)} → ${getEnergy(b)}`
-}
-
-export interface TriangleResult {
-  A: number; B: number; C: number; D: number; E: number;
-  F: number; G: number; H: number; I: number;
-  J: number; K: number; L: number;
-  M: number; N: number;
-  O: number;
-}
-
-export function calculateTriangle(
-  birthYear: number, birthMonth: number, birthDay: number
-): TriangleResult {
-  const y = String(birthYear).padStart(4, '0')
-  const m = String(birthMonth).padStart(2, '0')
-  const d = String(birthDay).padStart(2, '0')
-
-  const A = parseInt(y[0])
-  const B = parseInt(y[1])
-  const C = reduceToDigit(parseInt(y[2]) + parseInt(y[3]))
-  const D = reduceToDigit(parseInt(m[0]) + parseInt(m[1]))
-  const E = reduceToDigit(parseInt(d[0]) + parseInt(d[1]))
-
-  const F = reduceToDigit(A + B)
-  const G = reduceToDigit(B + C)
-  const H = reduceToDigit(C + D)
-  const I = reduceToDigit(D + E)
-
-  const J = reduceToDigit(F + G)
-  const K = reduceToDigit(G + H)
-  const L = reduceToDigit(H + I)
-
-  const M = reduceToDigit(J + K)
-  const N = reduceToDigit(K + L)
-
-  const O = reduceToDigit(M + N)
-
-  return { A, B, C, D, E, F, G, H, I, J, K, L, M, N, O }
-}
-
-export function analyzeTriangle(chart: TriangleResult): {
-  primary: Array<{position: string, number: number, energy: string, label: string}>,
-  combinations: Array<{pair: string, meaning: string}>
-} {
-  const primaryPositions = ['O', 'F', 'I', 'J', 'L']
-  const positionLabel: Record<string, string> = {
-    O: '主性格', F: '父源区', I: '母源区',
-    J: '父源区2', L: '母源区2'
-  }
-
-  const primary = primaryPositions.map(pos => ({
-    position: pos,
-    number: (chart as any)[pos] ?? 0,
-    energy: getEnergy((chart as any)[pos] ?? 0),
-    label: positionLabel[pos] || ''
-  }))
-
-  const comboPairs: [string, string][] = [
-    ['O', 'F'], ['O', 'I'], ['O', 'J'], ['O', 'L'],
-    ['F', 'J'], ['I', 'L'], ['F', 'G'], ['G', 'H'],
-    ['H', 'I'], ['J', 'K'], ['K', 'L'], ['M', 'N']
-  ]
-
-  const combinations = comboPairs.map(([p1, p2]) => ({
-    pair: `${p1}${p2}`,
-    meaning: getCombination((chart as any)[p1] ?? 0, (chart as any)[p2] ?? 0)
-  }))
-
-  return { primary, combinations }
-}

client/stores/chart.js

@@ -0,0 +1,72 @@
+import { defineStore } from 'pinia'
+import { consultationApi, chartApi, annotationApi } from '../utils/api'
+
+export const useChartStore = defineStore('chart', {
+  state: () => ({
+    currentName: '',
+    currentBirthYear: 0,
+    currentBirthMonth: 0,
+    currentBirthDay: 0,
+    currentChart: null,
+    currentRecordId: null,
+    currentQuestions: '',
+    records: [],
+    annotations: [],
+    tags: [],
+    consultationMessages: []
+  }),
+  actions: {
+    /**
+     * Start consultation via backend API (US-1.1 §13 — main path only).
+     * All computation is on the backend CalculatorService.
+     */
+    async startConsultation(name, birthday, questions) {
+      const result = await consultationApi.start({ name, birthday, questions })
+      const record = result.record
+      this.currentRecordId = record.id
+      this.currentName = record.name || name
+      this.currentQuestions = questions || ''
+      this.consultationMessages = result.messages || []
+      // Parse backend chart data
+      if (record.chartData) {
+        const parsed = typeof record.chartData === 'string'
+          ? JSON.parse(record.chartData) : record.chartData
+        this.currentChart = parsed.positions || parsed
+      }
+      return result
+    },
+
+    async saveChart(name, birthday, questions) {
+      const chartData = JSON.stringify(this.currentChart)
+      const record = await chartApi.create({ name, birthday, chartData, questions })
+      this.currentRecordId = record.id || null
+      this.currentQuestions = questions || ''
+      return record
+    },
+
+    async loadChart(id) {
+      const record = await chartApi.detail(id)
+      if (record && record.chartData) {
+        this.currentChart = typeof record.chartData === 'string'
+          ? JSON.parse(record.chartData) : record.chartData
+        this.currentRecordId = id
+      }
+      return record
+    },
+    async fetchRecords() {
+      this.records = await chartApi.list()
+    },
+    async fetchAnnotations(recordId) {
+      this.annotations = await annotationApi.list(recordId)
+    },
+    async addAnnotation(recordId, position, content) {
+      return await annotationApi.add({ recordId, position, content })
+    },
+    async fetchTags(recordId) {
+      this.tags = await annotationApi.listTags(recordId)
+    },
+    async addTag(recordId, tag) {
+      return await annotationApi.addTag({ recordId, tag })
+    }
+  }
+})

client/stores/user.js

@@ -0,0 +1,85 @@
+import { defineStore } from 'pinia'
+import { authApi, profileApi } from '../utils/api'
+
+export const useUserStore = defineStore('user', {
+  state: () => ({
+    token: uni.getStorageSync('token') || '',
+    nickname: '',
+    avatarUrl: '',
+    isVip: false,
+    vipEndTime: null,
+    referralCode: '',
+    // Daily quota
+    usedCharts: 0,
+    maxCharts: 3,
+    usedChats: 0,
+    maxChats: 3,
+    // Commission
+    totalCommission: 0,
+    availableCommission: 0
+  }),
+  getters: {
+    isLoggedIn: (state) => !!state.token,
+    isVipActive: (state) => {
+      if (!state.vipEndTime) return false
+      return new Date(state.vipEndTime) > new Date()
+    }
+  },
+  actions: {
+    async login(openid, nickname, avatarUrl, referralCode) {
+      const data = { openid, nickname, avatarUrl }
+      if (referralCode) data.referralCode = referralCode
+      const res = await authApi.login(data)
+      const tokenStr = res.token || res
+      this.token = tokenStr
+      uni.setStorageSync('token', tokenStr)
+      this.nickname = nickname
+      this.avatarUrl = avatarUrl
+    },
+    async wechatLogin(code, nickname, avatarUrl) {
+      const data = { code, nickname, avatarUrl }
+      const res = await authApi.login(data)
+      const tokenStr = res.token || res
+      this.token = tokenStr
+      uni.setStorageSync('token', tokenStr)
+      this.nickname = nickname || `微信用户`
+      this.avatarUrl = avatarUrl || ''
+      // Fetch full profile after login
+      try { await this.fetchProfile() } catch (e) {}
+    },
+    async fetchProfile() {
+      const user = await profileApi.info()
+      this.nickname = user.nickname
+      this.avatarUrl = user.avatarUrl
+      this.referralCode = user.referralCode
+      this.isVip = !!user.vipEndTime && new Date(user.vipEndTime) > new Date()
+      this.vipEndTime = user.vipEndTime
+    },
+    async fetchQuota() {
+      try {
+        const quota = await profileApi.quota()
+        this.usedCharts = quota.dailyChartCount || 0
+        this.maxCharts = quota.chartLimit > 0 ? quota.chartLimit : 999
+        this.usedChats = quota.dailyChatCount || 0
+        this.maxChats = quota.chatLimit > 0 ? quota.chatLimit : 999
+      } catch (e) { /* ignore */ }
+    },
+    async fetchCommissionSummary() {
+      try {
+        const summary = await profileApi.commissionSummary()
+        this.totalCommission = summary.totalEarnings || 0
+        this.availableCommission = summary.availableBalance || 0
+      } catch (e) { /* ignore */ }
+    },
+    logout() {
+      this.token = ''
+      this.nickname = ''
+      this.avatarUrl = ''
+      this.usedCharts = 0
+      this.usedChats = 0
+      this.totalCommission = 0
+      this.availableCommission = 0
+      uni.removeStorageSync('token')
+    }
+  }
+})

client/tsconfig.json

@@ -1,21 +0,0 @@
-{
-  "compilerOptions": {
-    "target": "ES2020",
-    "module": "ESNext",
-    "strict": true,
-    "jsx": "preserve",
-    "moduleResolution": "node",
-    "skipLibCheck": true,
-    "esModuleInterop": true,
-    "allowSyntheticDefaultImports": true,
-    "forceConsistentCasingInFileNames": true,
-    "resolveJsonModule": true,
-    "isolatedModules": true,
-    "baseUrl": ".",
-    "paths": {
-      "@/*": ["src/*"]
-    },
-    "types": ["@dcloudio/types"]
-  },
-  "include": ["src/**/*.ts", "src/**/*.vue", "env.d.ts"]
-}

client/utils/api.js

@@ -0,0 +1,100 @@
+// API 服务器地址 - 开发环境使用本地地址，生产环境请替换为实际域名
+// 微信开发者工具需勾选: 设置 → 安全 → 不校验合法域名
+const API_BASE_URL = 'http://127.0.0.1:8186/api'
+const TIMEOUT = 30000
+
+async function request(method, url, data) {
+  const token = uni.getStorageSync('token')
+  const header = { 'Content-Type': 'application/json' }
+  if (token) {
+    header.Authorization = `Bearer ${token}`
+  }
+
+  return new Promise((resolve, reject) => {
+    uni.request({
+      url: API_BASE_URL + url,
+      method,
+      data,
+      header,
+      timeout: TIMEOUT,
+      success(res) {
+        const response = res.data
+        if (response.code !== 0) {
+          uni.showToast({ title: response.message || '请求失败', icon: 'none' })
+          if (response.code === 1001) {
+            uni.removeStorageSync('token')
+            // 跳转到登录页，避免 switchTab 超时问题
+            setTimeout(() => {
+              uni.reLaunch({ url: '/pages/login/index' })
+            }, 500)
+          }
+          const err = new Error(response.message || '请求失败')
+          err.code = response.code
+          reject(err)
+        } else {
+          resolve(response.data)
+        }
+      },
+      fail(err) {
+        uni.showToast({ title: '网络错误', icon: 'none' })
+        reject(err)
+      }
+    })
+  })
+}
+
+const requestInstance = {
+  get: (url, data) => request('GET', url, data),
+  post: (url, data) => request('POST', url, data),
+  put: (url, data) => request('PUT', url, data),
+  delete: (url, data) => request('DELETE', url, data)
+}
+
+export default requestInstance
+
+export const authApi = {
+  login: (data) => requestInstance.post('/auth/login', data)
+}
+
+export const consultationApi = {
+  start: (data) => requestInstance.post('/consultation/start', data),
+  check: (data) => requestInstance.post('/consultation/check', data)
+}
+
+export const chartApi = {
+  create: (data) => requestInstance.post('/chart/create', data),
+  list: () => requestInstance.post('/chart/list', {}),
+  detail: (id) => requestInstance.post('/chart/detail', { id }),
+  delete: (id) => requestInstance.post('/chart/delete', { id })
+}
+
+export const chatApi = {
+  send: (data) => requestInstance.post('/chat/send', data),
+  history: (chartRecordId) => requestInstance.post('/chat/history', { chartRecordId })
+}
+
+export const payApi = {
+  create: (data) => requestInstance.post('/pay/create', data)
+}
+
+export const profileApi = {
+  info: () => requestInstance.post('/profile/info', {}),
+  vipStatus: () => requestInstance.post('/profile/vip-status', {}),
+  quota: () => requestInstance.post('/profile/quota', {}),
+  commissionSummary: () => requestInstance.post('/profile/commission-summary', {}),
+  chartCount: () => requestInstance.post('/profile/chart-count', {})
+}
+
+export const annotationApi = {
+  add: (data) => requestInstance.post('/annotation/add', data),
+  list: (recordId) => requestInstance.post('/annotation/list', { recordId }),
+  delete: (id) => requestInstance.post('/annotation/delete', { id }),
+  addTag: (data) => requestInstance.post('/annotation/tag/add', data),
+  listTags: (recordId) => requestInstance.post('/annotation/tag/list', { recordId }),
+  deleteTag: (id) => requestInstance.post('/annotation/tag/delete', { id })
+}
+
+export const commissionApi = {
+  list: () => requestInstance.post('/commission/list', {}),
+  total: () => requestInstance.post('/commission/total', {})
+}

client/utils/calculator.js

@@ -0,0 +1,172 @@
+function reduceToDigit(n) {
+  if (n === 11 || n === 22 || n === 33) return n
+  while (n > 9) {
+    let sum = 0
+    const str = String(n)
+    for (let i = 0; i < str.length; i++) {
+      sum += parseInt(str[i], 10)
+    }
+    if (sum === 11 || sum === 22 || sum === 33) return sum
+    n = sum
+  }
+  return n
+}
+
+const ENERGY_MAP = {
+  '1': '领导力、创造、独立', '2': '合作、平衡、感性',
+  '3': '表达、社交、艺术', '4': '稳定、务实、规则',
+  '5': '自由、变化、冒险', '6': '关爱、责任、家庭',
+  '7': '智慧、分析、内省', '8': '财富、权力、成就',
+  '9': '博爱、理想、智慧', '0': '潜能、灵性、无限'
+}
+
+const COMBINATION_MAP = {
+  '12': '创新与合作', '13': '创意表达', '14': '务实创新',
+  '15': '变革领导', '16': '关怀创造', '17': '智慧创新',
+  '18': '财富创造', '19': '理想创造', '21': '合作创新',
+  '23': '社交表达', '24': '稳定合作', '25': '自由协作',
+  '26': '关爱合作', '27': '智慧合作', '28': '财富合作',
+  '31': '表达创造', '32': '社交协作', '34': '务实表达',
+  '35': '自由表达', '36': '关爱表达', '37': '智慧表达',
+  '38': '财富表达', '39': '理想表达', '41': '务实创新',
+  '42': '稳定合作', '43': '务实社交', '45': '稳定变化',
+  '46': '务实关爱', '47': '务实智慧', '48': '财富稳定',
+  '51': '变革领导', '52': '自由协作', '53': '自由表达',
+  '54': '变化稳定', '56': '自由关爱', '57': '智慧变化',
+  '58': '自由财富', '59': '自由理想', '61': '关爱领导',
+  '62': '关爱协作', '63': '情感表达', '64': '稳定关爱',
+  '65': '自由关怀', '67': '智慧关怀', '68': '财富关怀',
+  '71': '智慧领导', '72': '智慧协作', '73': '智慧表达',
+  '74': '务实智慧', '75': '智慧变化', '76': '智慧关怀',
+  '77': '深度内省', '78': '智慧财富', '79': '智慧理想',
+  '81': '财富领导', '82': '财富协作', '83': '财富表达',
+  '84': '务实财富', '85': '自由财富', '86': '财富关怀',
+  '87': '智慧财富', '89': '财富理想', '91': '理想领导',
+  '92': '理想协作', '93': '理想表达', '94': '务实理想',
+  '95': '自由理想', '96': '关爱理想', '97': '智慧理想',
+  '98': '财富理想'
+}
+
+export function getEnergy(num) {
+  return ENERGY_MAP[String(num)] || '未知能量'
+}
+
+export function getCombination(a, b) {
+  return COMBINATION_MAP[`${a}${b}`] || `${getEnergy(a)} → ${getEnergy(b)}`
+}
+
+/**
+ * 数字能量三角图计算 - 完整30位置系统（I-X）
+ * 外部位置（A-H）直接来自生日：
+ *   A = year[0], B = year[1], C = year[2], D = year[3]
+ *   E = month[0], F = month[1], G = day[0], H = day[1]
+ * 内部位置（I-O）：
+ *   I = reduceToDigit(E + F)    // 月能量
+ *   J = reduceToDigit(G + H)    // 日能量
+ *   K = reduceToDigit(A + B)    // 年前半
+ *   L = reduceToDigit(C + D)    // 年后半
+ *   M = reduceToDigit(I + J)    // 青年综合数
+ *   N = reduceToDigit(K + L)    // 晚年综合数
+ *   O = reduceToDigit(M + N)    // 主性格
+ * 外部位置（P-X）— 独立计算：
+ *   P = reduceToDigit(I + M)
+ *   Q = reduceToDigit(J + M)
+ *   R = reduceToDigit(P + Q)
+ *   S = reduceToDigit(K + N)
+ *   T = reduceToDigit(L + N)
+ *   U = reduceToDigit(S + T)
+ *   V = reduceToDigit(M + O)
+ *   W = reduceToDigit(N + O)
+ *   X = reduceToDigit(V + W)
+ */
+export function calculateTriangle(birthYear, birthMonth, birthDay) {
+  const y = String(birthYear).padStart(4, '0')
+  const m = String(birthMonth).padStart(2, '0')
+  const d = String(birthDay).padStart(2, '0')
+
+  // 外部位置（A-H）- 原始数字提取
+  const A = parseInt(y[0], 10)
+  const B = parseInt(y[1], 10)
+  const C = parseInt(y[2], 10)
+  const D = parseInt(y[3], 10)
+  const E = parseInt(m[0], 10)
+  const F = parseInt(m[1], 10)
+  const G = parseInt(d[0], 10)
+  const H = parseInt(d[1], 10)
+
+  // 内部位置（I-O）
+  const I = reduceToDigit(E + F)    // 月能量
+  const J = reduceToDigit(G + H)    // 日能量
+  const K = reduceToDigit(A + B)    // 年前半
+  const L = reduceToDigit(C + D)    // 年后半
+  const M = reduceToDigit(I + J)    // 青年综合数
+  const N = reduceToDigit(K + L)    // 晚年综合数
+  const O = reduceToDigit(M + N)    // 主性格
+
+  // 外部位置（P-X）- 独立计算
+  const P = reduceToDigit(I + M)
+  const Q = reduceToDigit(J + M)
+  const R = reduceToDigit(P + Q)
+  const S = reduceToDigit(K + N)
+  const T = reduceToDigit(L + N)
+  const U = reduceToDigit(S + T)
+  const V = reduceToDigit(M + O)
+  const W = reduceToDigit(N + O)
+  const X = reduceToDigit(V + W)
+
+  return { I, J, K, L, M, N, O, P, Q, R, S, T, U, V, W, X }
+}
+
+export function analyzeTriangle(chart) {
+  const positionLabels = {
+    I: '月能量', J: '日能量', K: '年前位', L: '年后位',
+    M: '青年综合数', N: '晚年综合数', O: '主性格',
+    P: '左侧左子', Q: '左侧右子', R: '左侧主数',
+    S: '右侧左子', T: '右侧右子', U: '右侧主数',
+    V: '顶部左子', W: '顶部右子', X: '顶部主数'
+  }
+
+  const zones = [
+    { name: '主性格区', positions: ['O'] },
+    { name: '左区（月日能量）', positions: ['I', 'J', 'M'] },
+    { name: '右区（年份能量）', positions: ['K', 'L', 'N'] },
+    { name: '父源区', positions: ['I', 'M'] },
+    { name: '母源区', positions: ['L', 'N'] },
+    { name: '全三角', positions: ['I', 'J', 'K', 'L', 'M', 'N', 'O'] },
+    { name: '左侧外部组', positions: ['P', 'Q', 'R'] },
+    { name: '右侧外部组', positions: ['S', 'T', 'U'] },
+    { name: '顶部外部组', positions: ['V', 'W', 'X'] }
+  ]
+
+  const zoneAnalyses = zones.map(zone => ({
+    zoneName: zone.name,
+    numbers: zone.positions.map(pos => ({
+      position: pos,
+      number: chart[pos] || 0,
+      label: positionLabels[pos] || pos
+    }))
+  }))
+
+  const allPositions = ['I', 'J', 'K', 'L', 'M', 'N', 'O', 'P', 'Q', 'R', 'S', 'T', 'U', 'V', 'W', 'X']
+  const primary = allPositions.map(pos => ({
+    position: pos,
+    number: chart[pos] || 0,
+    energy: getEnergy(chart[pos] || 0),
+    label: positionLabels[pos] || ''
+  }))
+
+  const comboPairs = [
+    ['I', 'J'], ['K', 'L'], ['M', 'N'],
+    ['I', 'K'], ['J', 'L'], ['I', 'M'], ['K', 'N'],
+    ['M', 'O'], ['N', 'O'],
+    ['P', 'Q'], ['S', 'T'], ['V', 'W'],
+    ['P', 'R'], ['Q', 'R'], ['S', 'U'], ['T', 'U'], ['V', 'X'], ['W', 'X']
+  ]
+
+  const combinations = comboPairs.map(([p1, p2]) => ({
+    pair: `${p1}${p2}`,
+    meaning: getCombination(chart[p1] || 0, chart[p2] || 0)
+  }))
+
+  return { primary, combinations, zoneAnalyses }
+}

client/vite.config.ts

@@ -1,15 +0,0 @@
-import { defineConfig } from 'vite'
-import uni from '@dcloudio/vite-plugin-uni'
-
-export default defineConfig({
-  plugins: [uni()],
-  server: {
-    port: 3000,
-    proxy: {
-      '/api': {
-        target: 'http://localhost:8080',
-        changeOrigin: true
-      }
-    }
-  }
-})

cloudfunctions/applyWithdraw/index.js

@@ -1,69 +0,0 @@
-const cloud = require('wx-server-sdk');
-cloud.init({ env: cloud.DYNAMIC_CURRENT_ENV });
-const db = cloud.database();
-
-// 提现申请（Phase 1：记录申请，平台手动打款）
-exports.main = async (event) => {
-  const { amount } = event;
-  const { OPENID } = cloud.getWXContext();
-
-  if (!amount || amount <= 0) {
-    return { code: 400, error: '无效金额' };
-  }
-
-  try {
-    const userRes = await db.collection('users').where({
-      _openid: OPENID,
-    }).get();
-
-    if (userRes.data.length === 0) {
-      return { code: 401, error: '用户不存在' };
-    }
-
-    // 检查可提现金额
-    const commRes = await db.collection('commissions').where({
-      toUser: OPENID,
-      status: 'available',
-    }).get();
-
-    const availableTotal = (commRes.data || []).reduce((sum, c) => sum + (c.amount || 0), 0);
-    if (amount > availableTotal) {
-      return { code: 400, error: '可提现金额不足' };
-    }
-
-    if (amount < 10000) { // 单位：分，最低 ¥100
-      return { code: 400, error: '未达到最低提现金额 ¥100' };
-    }
-
-    // 创建提现申请
-    const applyRes = await db.collection('withdrawals').add({
-      data: {
-        userId: OPENID,
-        amount,
-        status: 'pending',
-        createdAt: db.serverDate(),
-        updatedAt: db.serverDate(),
-      },
-    });
-
-    // 将佣金状态改为 processing
-    let remaining = amount;
-    const availableComms = commRes.data.sort((a, b) => a.createdAt - b.createdAt);
-    for (const c of availableComms) {
-      if (remaining <= 0) break;
-      const deductAmount = Math.min(remaining, c.amount);
-      remaining -= deductAmount;
-      await db.collection('commissions').doc(c._id).update({
-        data: {
-          status: 'processing',
-          withdrawId: applyRes._id,
-          updatedAt: db.serverDate(),
-        },
-      });
-    }
-
-    return { code: 0, withdrawId: applyRes._id };
-  } catch (err) {
-    return { code: 500, error: err.message };
-  }
-};

cloudfunctions/applyWithdraw/package.json

@@ -1,8 +0,0 @@
-{
-  "name": "applyWithdraw",
-  "version": "1.0.0",
-  "main": "index.js",
-  "dependencies": {
-    "wx-server-sdk": "latest"
-  }
-}

cloudfunctions/checkSession/index.js

@@ -1,40 +0,0 @@
-const cloud = require('wx-server-sdk');
-cloud.init({ env: cloud.DYNAMIC_CURRENT_ENV });
-const db = cloud.database();
-
-exports.main = async (event) => {
-  const { OPENID } = cloud.getWXContext();
-
-  try {
-    const userRes = await db.collection('users').where({
-      _openid: OPENID,
-    }).get();
-
-    if (userRes.data.length === 0) {
-      return { isValid: false };
-    }
-
-    const user = userRes.data[0];
-    const now = Date.now();
-    const isPractitioner = user.practitionerExpireAt
-      && new Date(user.practitionerExpireAt).getTime() > now;
-
-    return {
-      isValid: true,
-      role: isPractitioner ? 'practitioner' : 'regular',
-      expireAt: user.practitionerExpireAt || null,
-      referralCode: user.referralCode || null,
-      referralStats: user.referralStats || {
-        directCount: 0,
-        indirectCount: 0,
-        convertedCount: 0,
-      },
-      userInfo: {
-        name: user.nickName || '',
-        createdAt: user.createdAt,
-      },
-    };
-  } catch (err) {
-    return { isValid: false, error: err.message };
-  }
-};

cloudfunctions/checkSession/package.json

@@ -1,8 +0,0 @@
-{
-  "name": "checkSession",
-  "version": "1.0.0",
-  "main": "index.js",
-  "dependencies": {
-    "wx-server-sdk": "latest"
-  }
-}

cloudfunctions/createPayment/index.js

@@ -1,25 +0,0 @@
-const cloud = require('wx-server-sdk');
-cloud.init({ env: cloud.DYNAMIC_CURRENT_ENV });
-
-exports.main = async (event) => {
-  const { type, amount, referralCode } = event;
-  const { OPENID } = cloud.getWXContext();
-
-  try {
-    const outTradeNo = `${Date.now()}_${Math.random().toString(36).slice(2, 8)}`;
-
-    const result = await cloud.cloudPay.unifiedOrder({
-      body: '数字能量学-能量师年服务包',
-      outTradeNo,
-      spbillCreateIp: '127.0.0.1',
-      subMchId: 'YOUR_SUB_MCH_ID',
-      totalFee: Math.round(amount * 100),
-      envId: 'YOUR_CLOUD_ENV_ID',
-      functionName: 'paymentCallback',
-    });
-
-    return { code: 0, payment: result.payment };
-  } catch (err) {
-    return { code: 500, error: err.message };
-  }
-};

cloudfunctions/createPayment/package.json

@@ -1,8 +0,0 @@
-{
-  "name": "createPayment",
-  "version": "1.0.0",
-  "main": "index.js",
-  "dependencies": {
-    "wx-server-sdk": "latest"
-  }
-}

cloudfunctions/generateReading/index.js

@@ -1,130 +0,0 @@
-/**
- * AI 命盘解读云函数
- *
- * 接收命盘数据，调用 LLM API 生成数字能量学解读
- * 支持 DeepSeek / OpenAI 兼容接口
- * 通过云调用鉴权，不在前端暴露 API Key
- */
-
-const cloud = require('wx-server-sdk');
-cloud.init({ env: cloud.DYNAMIC_CURRENT_ENV });
-
-// LLM API 配置（通过云托管环境变量配置，不硬编码密钥）
-const LLM_API_KEY = process.env.LLM_API_KEY || 'YOUR_API_KEY';
-const LLM_API_URL = process.env.LLM_API_URL || 'https://api.deepseek.com/v1/chat/completions';
-const LLM_MODEL = process.env.LLM_MODEL || 'deepseek-chat';
-
-// 系统提示词 — 设定 AI 的角色和行为
-const SYSTEM_PROMPT = `你是一位专业的数字能量学解读师，精通生命密码（数字能量学）。你的任务是基于用户的三角形命盘数据，提供专业、准确、有洞见的解读。
-
-解读风格要求：
-1. 专业但不晦涩，让普通人也能理解
-2. 每段解读 100-200 字，言简意赅
-3. 结合数字能量学理论，给出性格特质、优势、成长建议
-4. 语气温和正向，避免恐吓或绝对化表述
-5. 以 "你" 称呼用户，亲切自然
-
-重要原则：
-- 解读必须基于命盘中的实际数字，不能编造
-- 避免宿命论，强调个人选择和发展的可能性
-- 所有解读最后加一句 "仅供参考" 的提示`;
-
-function buildPrompt(chartData, name) {
-  const { positions, zones, mainCharacter, isMasterNumber } = chartData;
-
-  let prompt = `请为以下命盘生成解读。\n\n`;
-  prompt += `姓名：${name || '用户'}\n`;
-  prompt += `主性格数字：${mainCharacter}${isMasterNumber ? '（卓越数）' : ''}\n\n`;
-  prompt += `完整命盘数据：\n`;
-  prompt += `底层：A=${positions.A} B=${positions.B} C=${positions.C} D=${positions.D} E=${positions.E}\n`;
-  prompt += `第二层：F=${positions.F} G=${positions.G} H=${positions.H} I=${positions.I}\n`;
-  prompt += `第三层：J=${positions.J} K=${positions.K} L=${positions.L}\n`;
-  prompt += `第四层：M=${positions.M} N=${positions.N}\n`;
-  prompt += `顶端：O=${positions.O}\n\n`;
-  prompt += `请以 JSON 格式返回，包含以下字段：\n`;
-  prompt += `{
-    "mainCharacter": "主性格解读（重点突出${mainCharacter}号人的核心特质、优势、适合的发展方向）",
-    "fatherSource": "父源区解读（F=${positions.F}, J=${positions.J} 的含义和影响）",
-    "motherSource": "母源区解读（I=${positions.I}, L=${positions.L} 的含义和影响）",
-    "leftZone": "左区（0-20岁）解读",
-    "middleZone": "中区（20-40岁）解读",
-    "rightZone": "右区（40-60岁）解读"
-  }\n\n`;
-  prompt += `请只返回 JSON，不要包含其他文字。`;
-
-  return prompt;
-}
-
-exports.main = async (event, context) => {
-  const { chartData, name } = event;
-
-  if (!chartData || !chartData.positions) {
-    return { code: 400, error: '缺少命盘数据' };
-  }
-
-  try {
-    const userPrompt = buildPrompt(chartData, name);
-
-    const response = await fetch(LLM_API_URL, {
-      method: 'POST',
-      headers: {
-        'Content-Type': 'application/json',
-        'Authorization': `Bearer ${LLM_API_KEY}`,
-      },
-      body: JSON.stringify({
-        model: LLM_MODEL,
-        messages: [
-          { role: 'system', content: SYSTEM_PROMPT },
-          { role: 'user', content: userPrompt },
-        ],
-        temperature: 0.7,
-        max_tokens: 2000,
-      }),
-    });
-
-    const data = await response.json();
-
-    if (!data.choices || !data.choices[0]) {
-      console.error('LLM API error:', data);
-      return { code: 500, error: 'AI 服务异常', reading: null };
-    }
-
-    const content = data.choices[0].message.content;
-
-    // Try to parse JSON from the response
-    try {
-      // Find JSON in the response (handle cases where model wraps in markdown)
-      const jsonMatch = content.match(/\{[\s\S]*\}/);
-      const jsonStr = jsonMatch ? jsonMatch[0] : content;
-      const reading = JSON.parse(jsonStr);
-
-      return {
-        code: 0,
-        reading: {
-          mainCharacter: reading.mainCharacter || '',
-          fatherSource: reading.fatherSource || '',
-          motherSource: reading.motherSource || '',
-          leftZone: reading.leftZone || '',
-          middleZone: reading.middleZone || '',
-          rightZone: reading.rightZone || '',
-        },
-      };
-    } catch (parseErr) {
-      // If JSON parsing fails, return raw text
-      return {
-        code: 0,
-        reading: {
-          mainCharacter: content,
-          fatherSource: '解读生成中，请稍后再试',
-          motherSource: '解读生成中，请稍后再试',
-          leftZone: '解读生成中，请稍后再试',
-          middleZone: '解读生成中，请稍后再试',
-          rightZone: '解读生成中，请稍后再试',
-        },
-      };
-    }
-  } catch (err) {
-    console.error('Cloud function error:', err);
-    return { code: 500, error: err.message, reading: null };
-  }
-};

cloudfunctions/generateReading/package.json

@@ -1,9 +0,0 @@
-{
-  "name": "generateReading",
-  "version": "1.0.0",
-  "description": "AI 命盘解读生成",
-  "main": "index.js",
-  "dependencies": {
-    "wx-server-sdk": "latest"
-  }
-}

cloudfunctions/getCommission/index.js

@@ -1,47 +0,0 @@
-const cloud = require('wx-server-sdk');
-cloud.init({ env: cloud.DYNAMIC_CURRENT_ENV });
-const db = cloud.database();
-
-// 获取当前用户的佣金概览和明细
-exports.main = async (event) => {
-  const { OPENID } = cloud.getWXContext();
-
-  try {
-    const commRes = await db.collection('commissions').where({
-      toUser: OPENID,
-    }).orderBy('createdAt', 'desc').get();
-
-    const commissions = commRes.data || [];
-    let totalAmount = 0;
-    let availableAmount = 0;
-    let pendingAmount = 0;
-
-    commissions.forEach(c => {
-      totalAmount += c.amount || 0;
-      if (c.status === 'available') {
-        availableAmount += c.amount;
-      } else if (c.status === 'pending') {
-        pendingAmount += c.amount;
-      }
-    });
-
-    // 格式化输出
-    const list = commissions.slice(0, 50).map(c => ({
-      commissionId: c._id,
-      level: c.level,
-      amount: c.amount,
-      status: c.status,
-      sourceName: c.sourceName || '用户',
-      createdAt: c.createdAt,
-    }));
-
-    return {
-      totalAmount,
-      availableAmount,
-      pendingAmount,
-      commissions: list,
-    };
-  } catch (err) {
-    return { error: err.message, totalAmount: 0, availableAmount: 0, pendingAmount: 0, commissions: [] };
-  }
-};

cloudfunctions/getCommission/package.json

@@ -1,8 +0,0 @@
-{
-  "name": "getCommission",
-  "version": "1.0.0",
-  "main": "index.js",
-  "dependencies": {
-    "wx-server-sdk": "latest"
-  }
-}

cloudfunctions/getQRCode/index.js

@@ -1,34 +0,0 @@
-const cloud = require('wx-server-sdk');
-cloud.init({ env: cloud.DYNAMIC_CURRENT_ENV });
-
-// 生成小程序码（能量师专属推广码）
-exports.main = async (event) => {
-  const { referralCode } = event;
-  const { OPENID } = cloud.getWXContext();
-
-  if (!referralCode) {
-    return { code: 400, error: '缺少推广码' };
-  }
-
-  try {
-    const result = await cloud.openapi.wxacode.get({
-      path: `pages/index/index?ref=${referralCode}`,
-      width: 280,
-      isHyaline: false,
-      autoColor: true,
-    });
-
-    // 将 Buffer 上传到云存储
-    const uploadRes = await cloud.uploadFile({
-      cloudPath: `qrcode/${OPENID}_${referralCode}_${Date.now()}.jpg`,
-      fileContent: result.buffer,
-    });
-
-    return {
-      code: 0,
-      fileID: uploadRes.fileID,
-    };
-  } catch (err) {
-    return { code: 500, error: err.message };
-  }
-};

cloudfunctions/getQRCode/package.json

@@ -1,8 +0,0 @@
-{
-  "name": "getQRCode",
-  "version": "1.0.0",
-  "main": "index.js",
-  "dependencies": {
-    "wx-server-sdk": "latest"
-  }
-}

cloudfunctions/getReferrerInfo/index.js

@@ -1,26 +0,0 @@
-const cloud = require('wx-server-sdk');
-cloud.init({ env: cloud.DYNAMIC_CURRENT_ENV });
-const db = cloud.database();
-
-// 通过推广码查询上级信息（分享提示用）
-exports.main = async (event) => {
-  const { referralCode } = event;
-
-  try {
-    const res = await db.collection('users').where({
-      referralCode,
-    }).get();
-
-    if (res.data.length === 0) {
-      return { found: false };
-    }
-
-    const user = res.data[0];
-    return {
-      found: true,
-      name: user.nickName || '能量师',
-    };
-  } catch (err) {
-    return { found: false, error: err.message };
-  }
-};

cloudfunctions/getReferrerInfo/package.json

@@ -1,8 +0,0 @@
-{
-  "name": "getReferrerInfo",
-  "version": "1.0.0",
-  "main": "index.js",
-  "dependencies": {
-    "wx-server-sdk": "latest"
-  }
-}

cloudfunctions/paymentCallback/index.js

@@ -1,155 +0,0 @@
-const cloud = require('wx-server-sdk');
-cloud.init({ env: cloud.DYNAMIC_CURRENT_ENV });
-const db = cloud.database();
-
-// 支付成功回调（微信支付结果通知）
-// 处理：能量师订阅升级 + 佣金结算
-exports.main = async (event) => {
-  const {
-    outTradeNo,      // 订单号
-    transactionId,   // 微信支付订单号
-    totalFee,        // 支付金额（分）
-    attach,          // 附加数据
-  } = event;
-
-  // 获取支付用户的 openId
-  const { OPENID } = cloud.getWXContext();
-
-  try {
-    // 1. 查询订单是否已处理（幂等）
-    const orderRes = await db.collection('orders').where({
-      outTradeNo,
-    }).get();
-
-    if (orderRes.data.length > 0) {
-      return { code: 0, message: '订单已处理' };
-    }
-
-    // 2. 写订单记录
-    const orderData = {
-      outTradeNo,
-      transactionId,
-      userId: OPENID,
-      type: 'practitioner_annual',
-      amount: totalFee,
-      paymentMethod: 'wechat_pay',
-      status: 'paid',
-      paidAt: db.serverDate(),
-      createdAt: db.serverDate(),
-    };
-    await db.collection('orders').add({ data: orderData });
-
-    // 3. 更新用户为能量师（有效期 1 年）
-    const now = new Date();
-    const expireDate = new Date(now);
-    expireDate.setFullYear(expireDate.getFullYear() + 1);
-
-    // 查询已有用户
-    const userRes = await db.collection('users').where({
-      _openid: OPENID,
-    }).get();
-
-    const userData = {
-      role: 'practitioner',
-      practitionerExpireAt: expireDate.toISOString(),
-      updatedAt: db.serverDate(),
-    };
-
-    if (userRes.data.length === 0) {
-      // 新用户注册（一般不会走到这里，但以防万一）
-      userData._openid = OPENID;
-      userData.referralCode = generateReferralCode();
-      userData.createdAt = db.serverDate();
-      await db.collection('users').add({ data: userData });
-    } else {
-      // 已有用户，生成或保留推广码
-      const user = userRes.data[0];
-      if (!user.referralCode) {
-        userData.referralCode = generateReferralCode();
-      }
-      await db.collection('users').doc(user._id).update({ data: userData });
-    }
-
-    // 4. 佣金结算：查用户的上级
-    const user = (await db.collection('users').where({ _openid: OPENID }).get()).data[0];
-    const invitedBy = user.invitedBy;
-
-    if (invitedBy) {
-      // 查上级是否为有效的能量师
-      const parentRes = await db.collection('users').where({ _openid: invitedBy }).get();
-      if (parentRes.data.length > 0) {
-        const parent = parentRes.data[0];
-        const isParentPractitioner = parent.practitionerExpireAt
-          && new Date(parent.practitionerExpireAt).getTime() > Date.now();
-
-        if (isParentPractitioner) {
-          // 一级佣金：30%
-          const level1Amount = Math.round(totalFee * 0.30);
-          await db.collection('commissions').add({
-            data: {
-              fromUser: OPENID,
-              toUser: invitedBy,
-              level: 1,
-              amount: level1Amount,
-              sourceOrderId: outTradeNo,
-              status: 'pending',
-              createdAt: db.serverDate(),
-              updatedAt: db.serverDate(),
-            },
-          });
-
-          // 更新上级的推广统计
-          const stats = parent.referralStats || {};
-          await db.collection('users').doc(parent._id).update({
-            data: {
-              'referralStats.convertedCount': (stats.convertedCount || 0) + 1,
-            },
-          });
-
-          // 查上上级（二级佣金）
-          const grandParentInvitedBy = parent.invitedBy;
-          if (grandParentInvitedBy) {
-            const gpRes = await db.collection('users').where({ _openid: grandParentInvitedBy }).get();
-            if (gpRes.data.length > 0) {
-              const gp = gpRes.data[0];
-              const isGpPractitioner = gp.practitionerExpireAt
-                && new Date(gp.practitionerExpireAt).getTime() > Date.now();
-
-              if (isGpPractitioner) {
-                // 二级佣金：10%
-                const level2Amount = Math.round(totalFee * 0.10);
-                await db.collection('commissions').add({
-                  data: {
-                    fromUser: OPENID,
-                    toUser: grandParentInvitedBy,
-                    level: 2,
-                    amount: level2Amount,
-                    sourceOrderId: outTradeNo,
-                    status: 'pending',
-                    createdAt: db.serverDate(),
-                    updatedAt: db.serverDate(),
-                  },
-                });
-              }
-            }
-          }
-        }
-      }
-    }
-
-    return { code: 0, message: 'success' };
-  } catch (err) {
-    console.error('[paymentCallback] error:', err);
-    return { code: 500, error: err.message };
-  }
-};
-
-// 生成唯一6位推广码
-function generateReferralCode() {
-  const chars = 'ABCDEFGHJKLMNPQRSTUVWXYZ23456789';
-  let code = '';
-  for (let i = 0; i < 6; i++) {
-    code += chars[Math.floor(Math.random() * chars.length)];
-  }
-  return code;
-}

cloudfunctions/paymentCallback/package.json

@@ -1,8 +0,0 @@
-{
-  "name": "paymentCallback",
-  "version": "1.0.0",
-  "main": "index.js",
-  "dependencies": {
-    "wx-server-sdk": "latest"
-  }
-}

cloudfunctions/registerUser/index.js

@@ -1,76 +0,0 @@
-const cloud = require('wx-server-sdk');
-cloud.init({ env: cloud.DYNAMIC_CURRENT_ENV });
-const db = cloud.database();
-
-// 用户注册（首次微信登录时调用）
-// 处理：创建用户记录 + 上下级关系绑定
-exports.main = async (event) => {
-  const { referrerCode } = event;
-  const { OPENID } = cloud.getWXContext();
-
-  try {
-    // 检查用户是否已存在
-    const userRes = await db.collection('users').where({
-      _openid: OPENID,
-    }).get();
-
-    if (userRes.data.length > 0) {
-      return {
-        code: 0,
-        isNew: false,
-        role: userRes.data[0].role || 'regular',
-        message: '用户已存在',
-      };
-    }
-
-    // 解析上级
-    let invitedBy = null;
-    if (referrerCode) {
-      const refRes = await db.collection('users').where({
-        referralCode,
-      }).get();
-
-      if (refRes.data.length > 0) {
-        const refUser = refRes.data[0];
-        // 不能自己邀请自己
-        if (refUser._openid !== OPENID) {
-          invitedBy = refUser._openid;
-
-          // 更新上级的推广统计
-          const stats = refUser.referralStats || {};
-          await db.collection('users').doc(refUser._id).update({
-            data: {
-              'referralStats.directCount': (stats.directCount || 0) + 1,
-            },
-          });
-        }
-      }
-    }
-
-    // 创建新用户
-    const userData = {
-      _openid: OPENID,
-      role: 'regular',
-      practitionerExpireAt: null,
-      invitedBy,
-      referralStats: {
-        directCount: 0,
-        indirectCount: 0,
-        convertedCount: 0,
-      },
-      createdAt: db.serverDate(),
-      updatedAt: db.serverDate(),
-    };
-
-    await db.collection('users').add({ data: userData });
-
-    return {
-      code: 0,
-      isNew: true,
-      role: 'regular',
-      hasReferrer: !!invitedBy,
-    };
-  } catch (err) {
-    return { code: 500, error: err.message };
-  }
-};

cloudfunctions/registerUser/package.json

@@ -1,8 +0,0 @@
-{
-  "name": "registerUser",
-  "version": "1.0.0",
-  "main": "index.js",
-  "dependencies": {
-    "wx-server-sdk": "latest"
-  }
-}

docs/dify-chatflow-prompt.md

@@ -0,0 +1,322 @@
+# Dify Chatflow 提示词定义
+
+## 1. 概述
+
+本文档定义数字能量学智能体 Dify Chatflow 工作流的完整配置，包括系统提示词、输入架构、输出格式和节点配置。
+
+**用途：** 用户在微信小程序中生成命盘后，向 AI 提问获得数字能量学专业解读。
+
+**数据流：** 小程序 → 后端 API → Dify Chatflow → LLM 解读 → 返回用户
+
+---
+
+## 2. 输入架构
+
+### 2.1 Dify API 调用格式
+
+后端 `DifyService.java` 调用 Dify API：
+
+```
+POST /v1/chat-messages
+Authorization: Bearer {api_key}
+Content-Type: application/json
+
+{
+  "inputs": {
+    "chart_context": "{...chart JSON...}"
+  },
+  "query": "请解读我的主性格",
+  "user": "user_12345"
+}
+```
+
+### 2.2 chart_context JSON 格式
+
+后端传入的 `chart_context` 字段包含完整的命盘数据，格式如下：
+
+```json
+{
+  "positions": {
+    "A": 2, "B": 0, "C": 9, "D": 5, "E": 8,
+    "F": 2, "G": 9, "H": 5, "I": 4, "J": 11,
+    "K": 5, "L": 9, "M": 7, "N": 5, "O": 3
+  },
+  "zones": {
+    "mainCharacter": {
+      "name": "主性格",
+      "positions": ["O"],
+      "values": [3]
+    },
+    "fatherSource": {
+      "name": "父源区",
+      "positions": ["I", "J"],
+      "values": [4, 11]
+    },
+    "motherSource": {
+      "name": "母源区",
+      "positions": ["K", "L"],
+      "values": [5, 9]
+    },
+    "leftZone": {
+      "name": "左区（0-20岁）",
+      "positions": ["A", "F", "I", "O"],
+      "values": [2, 2, 4, 3]
+    },
+    "middleZone": {
+      "name": "中区（20-40岁）",
+      "positions": ["B", "G", "J", "M", "N", "O"],
+      "values": [0, 9, 11, 7, 5, 3]
+    },
+    "rightZone": {
+      "name": "右区（40-60岁）",
+      "positions": ["C", "D", "E", "H", "K", "L", "O"],
+      "values": [9, 5, 8, 5, 5, 9, 3]
+    }
+  },
+  "mainCharacter": 3,
+  "isMasterNumber": false,
+  "chartName": "张三",
+  "birthYear": 2009,
+  "birthMonth": 5,
+  "birthDay": 26
+}
+```
+
+### 2.3 Dify Chatflow Input 变量
+
+| 变量名 | 类型 | 说明 | 来源 |
+|--------|------|------|------|
+| `chart_context` | JSON | 完整的命盘数据 | 后端传入 |
+| `query` | String | 用户提问内容 | 用户输入 |
+
+---
+
+## 3. 系统提示词 (LLM 节点 System Prompt)
+
+```text
+# 角色设定
+你是「数字能量学智能解读师」，一位精通数字能量学（Digital Numerology）的资深专家。你擅长通过 Classic A 三角形命盘（5行15格）为用户提供性格分析、天赋解码和人生指引。
+
+# 专业背景
+- 精通数字能量学理论，包括主性格数字 1-9 及卓越数 11、22、33 的解读
+- 熟练掌握五区分析：左区（0-20岁成长）、中区（20-40岁发展）、右区（40-60岁成就）
+- 理解父源区、母源区对个人性格形成的影响
+- 能够结合多位置数字组合进行综合分析
+
+# 解读原则
+1. 基于提供的命盘数据进行专业解读，不编造或臆测数字
+2. 聚焦性格倾向、天赋优势、潜在挑战和发展建议
+3. 以积极正向的视角进行解读，强调成长和发展的可能性
+4. 语言专业但不晦涩，温暖且有洞察力
+5. 不预测具体未来事件（财运数字、结婚年份等），不提供医疗建议
+6. 若用户询问命盘数据范围之外的领域，委婉说明数字能量学的局限性
+
+# 数字含义参考
+- 1 (开创者): 独立、创新、领导力
+- 2 (合作者): 细腻、敏感、善于沟通
+- 3 (表达者): 创意、社交、乐观向上
+- 4 (建设者): 务实、稳定、规则意识
+- 5 (自由者): 冒险、变化、适应力强
+- 6 (守护者): 责任、关爱、追求完美
+- 7 (探索者): 深度思考、求知、内省
+- 8 (掌控者): 权威、商业头脑、决策力
+- 9 (智慧者): 博爱、理想主义、包容
+- 11 (启迪者): 直觉力强、灵感丰富（卓越数）
+- 22 (建造大师): 将理想变为现实（卓越数）
+- 33 (大爱者): 无私奉献、疗愈他人（卓越数）
+
+# 响应格式
+1. 首先回应用户的具体问题
+2. 引用命盘中的具体位置和数字进行解释
+3. 提供有针对性的建议
+4. 保持友好、鼓励的语气
+5. 回复语言使用中文
+
+# chart_context JSON 结构说明
+用户命盘数据通过 chart_context 变量传入，包含以下关键字段：
+- mainCharacter: 主性格数字（位于 O 位）
+- positions: 全部 15 个位置（A-O）的数字值
+- zones: 五区数据，每区包含名称、位置列表和对应数字值
+- isMasterNumber: 主性格是否为卓越数
+- chartName: 用户姓名（如有提供）
+- birthYear/month/day: 出生日期
+
+请根据这些数据为用户提供有深度、个性化的数字能量学解读。
+```
+
+---
+
+## 4. Dify 工作流节点配置
+
+| 节点 | 类型 | 配置 |
+|------|------|------|
+| **START** | 开始节点 | 输入变量：`chart_context` (JSON), `query` (String) |
+| **LLM** | LLM 节点 | System Prompt: 见第 3 节<br>Model: gpt-4o 或 Claude 3.5 Sonnet<br>Temperature: 0.7<br>Max Tokens: 2000<br>Memory: 启用对话轮次 (最近 6 轮) |
+| **END** | 结束节点 | 输出变量：`answer` (String) — LLM 节点的输出文本 |
+
+### 节点连接关系
+
+```
+START → LLM → END
+```
+
+### LLM 节点变量映射
+
+| Dify 变量 | 映射到 |
+|-----------|--------|
+| `chart_context` | LLM 上下文变量，嵌入 System Prompt 中使用 |
+| `query` | LLM 用户消息输入 |
+
+---
+
+## 5. 示例对话
+
+### 示例 1：主性格解读
+
+**用户输入：** `请解读我的主性格`
+
+**chart_context 示例：**
+```json
+{
+  "positions": {"O": 7},
+  "mainCharacter": 7,
+  "zones": {
+    "leftZone": {"values": [1, 1, 4, 7]},
+    "middleZone": {"values": [9, 4, 5, 11, 3, 7]},
+    "rightZone": {"values": [4, 7, 6, 4, 6, 6, 7]}
+  },
+  "isMasterNumber": false
+}
+```
+
+**预期回复（示例）：**
+```
+你好！根据你的数字命盘，你的主性格数字是 7。
+
+🔹 主性格 7 号 — 探索者
+
+7 号人是天生的思考者和探索者，你对世界有着强烈的好奇心和求知欲。你善于分析、喜欢独处思考，对于哲学、科学和未知领域有天然的吸引力。
+
+✨ 你的核心特质：
+- 深度思考能力：你善于从现象看到本质
+- 独立精神：不盲从权威，有自己的判断标准
+- 分析天赋：逻辑清晰，适合研究分析类工作
+
+💡 成长建议：
+- 多信任自己的直觉，你的第六感往往很准
+- 适度走出思考的舒适区，增加社交互动
+- 避免过度完美主义，行动比完美更重要
+
+你的左区（0-20岁）有数字 1 和 4，说明早年培养了独立自主的性格和务实的态度；中区（20-40岁）出现卓越数 11，预示着这个阶段你的直觉力和灵感将显著提升。
+
+想了解更多关于某个区域的详细解读吗？
+```
+
+### 示例 2：财富与事业发展
+
+**用户输入：** `我的事业发展和财富运势如何？`
+
+**chart_context 示例：**
+```json
+{
+  "mainCharacter": 8,
+  "positions": {"O": 8, "I": 4, "J": 5, "K": 6, "L": 9},
+  "zones": {
+    "middleZone": {"values": [2, 3, 5, 7, 6, 8]},
+    "rightZone": {"values": [1, 4, 3, 8, 6, 9, 8]}
+  }
+}
+```
+
+**预期回复（示例）：**
+```
+感谢你的提问！从你的数字命盘来看，非常有亮点。
+
+🔹 主性格 8 号 — 掌控者
+
+8 号是数字能量学中的"事业王者"，你天生具备商业头脑和领导力。你对权力和资源有敏锐的感知力，擅长将想法转化为实际的商业价值。
+
+📊 事业发展分析：
+- 中区（20-40岁）：数字组合 2-3-5-7-6-8，显示这个阶段你适合团队合作（2），发挥创意表达能力（3），经历必要的变化和积累（5-7），最终在第 8 位达到事业高度
+- 右区（40-60岁）：数字 8 出现在关键位置，预示这个阶段是你事业成就的黄金时期
+
+💰 财富特质：
+- 父源区（I=4, J=5）：务实且有商业嗅觉，适合实体行业或资源整合型工作
+- 母源区（K=6, L=9）：有责任感和远见，能平衡短期收益和长期发展
+- 财富关键词：稳健增长、资源整合、领导力变现
+
+💡 发展建议：
+1. 30-40 岁是重要的积累期，建议深耕一个领域建立专业壁垒
+2. 8 号人适合创业或管理岗位，可考虑在 35 岁后独立发展
+3. 注意平衡事业与健康，8 号人容易过度投入工作
+
+想更深入了解某个具体方向的建议吗？
+```
+
+---
+
+## 6. Dify 控制台设置步骤
+
+### 步骤 1：登录 Dify 并创建 Chatflow
+
+1. 登录 Dify 平台 (https://cloud.dify.ai 或自部署实例)
+2. 点击「创建应用」→ 选择「Chatflow」
+3. 输入应用名称：`数字能量学智能体`
+4. 点击「创建」
+
+### 步骤 2：配置输入变量
+
+1. 点击 START 节点
+2. 添加输入变量：
+   - 变量名：`chart_context`，类型：JSON，必填：是
+   - 变量名：`query`，类型：文本，必填：是
+
+### 步骤 3：添加 LLM 节点
+
+1. 拖入 LLM 节点到画布
+2. 连接 START → LLM
+3. 配置 LLM 节点：
+   - System Prompt：填写第 3 节的完整系统提示词
+   - 模型：选择 Claude 3.5 Sonnet 或 GPT-4o（推荐 Claude 以获得更好的中文解读质量）
+   - Temperature：0.7
+   - Maximum Tokens：2000
+   - 开启记忆功能，保留最近 6 轮对话
+4. 在"上下文"中引用 `chart_context` 变量
+5. 在"用户消息"中引用 `query` 变量
+
+### 步骤 4：配置 END 节点
+
+1. 拖入 END 节点，连接 LLM → END
+2. 输出变量选择 LLM 节点的 `text` 输出
+
+### 步骤 5：发布
+
+1. 点击「发布」按钮
+2. 记录 API 访问地址和 API Key
+
+### 步骤 6：配置后端
+
+在后端 `application.yml` 中配置：
+
+```yaml
+num:
+  dify:
+    base-url: https://your-dify-instance.com/v1
+    api-key: your_dify_api_key_here
+```
+
+---
+
+## 7. 输入变量配置总结
+
+| 配置项 | 值 |
+|--------|-----|
+| 应用类型 | Chatflow |
+| 输入变量 1 | `chart_context` (JSON) |
+| 输入变量 2 | `query` (String) |
+| LLM 模型 | Claude 3.5 Sonnet (推荐) |
+| Temperature | 0.7 |
+| Max Tokens | 2000 |
+| 记忆轮次 | 6 |
+| API Endpoint | POST /v1/chat-messages |
+| 输出字段 | `answer` (String) |

docs/phase1-product-plan.md

@@ -1,6 +1,6 @@
 # 数字能量学智能体 — Phase 1 产品规划
 
-> 版本: v1.1
+> 版本: v1.2
 > 定位: 面向数字能量师的AI智能工具，最小成本 + 最快回血
 > 口号: 3秒出命盘 + AI自动解读，让能量师聚焦客户沟通，而非画图和查资料
 
@@ -18,7 +18,7 @@
               └── 通过能量师分享链接注册（建立上下级关系）
               │
               ▼（购买年服务包）
-         能量师用户（¥398/年，核心付费用户）
+         能量师用户（¥1,314/年起，核心付费用户）
               │
               ├── 无限命盘生成 + AI五区完整解读
               ├── 无限分享 + PDF导出 + 全部历史
@@ -169,22 +169,21 @@
 
 | 方案 | 价格 | 说明 |
 |------|------|------|
-| **能量师年服务包** | **¥398/年** | 唯一付费方案，含AI完整解读 + 分销权，种子价即定价 |
-| 月费（可选增设） | ¥39/月 | 降低入门门槛，能量师可月付升级 |
+| **能量师年服务包（种子价）** | **¥1,314/年** | 首300人种子价，含AI完整解读 + 分销权 |
+| **能量师年服务包（标准价）** | **¥1,986/年** | 正常价格，含AI完整解读 + 分销权 |
+| C端年费 | ¥131/年 | 普通用户订阅，AI解读完整版 |
+| 月费（可选增设） | ¥39/月 | 降低入门门槛 |
 | 单次解读（可选增设） | ¥9.9/次 | 未订阅用户的AI解读单次购买 |
 
 > 定价逻辑：AI出图+出解读，能量师接2-3个客户（¥100-300）即可回本，后续净赚。
-> ¥398/年 ≈ 每天仅 ¥1.09，对能量师而言是极低的生产力投资。
-> **佣金支出上限 40%**，年服务包实际平台净收入约 ¥238.8/人。
-> 分销驱动增长：能量师推荐好友购买年包，得 ¥119.4/人 佣金。
+> ¥1,314/年 ≈ 每天仅 ¥3.6，对能量师而言是极低的生产力投资。
+> 分销驱动增长：能量师推荐好友购买，得 ¥500/人 佣金。
 > 100个种子能量师，人均推荐5人，年费收入 x6 倍增长。
->
-> **已确认决策**：一级 30% / 二级 10%（后台可配置）| 即时结算，无冷静期 | 最低提现 ¥100 | 仅能量师享有分销权
 
 ### 5.2 免费 vs 付费
 
-| 功能 | 普通用户（免费） | 能量师（¥398/年） |
-|------|----------------|------------------|
+| 功能 | 普通用户（免费） | 能量师（¥1,314/年起） |
+|------|----------------|----------------------|
 | 生成命盘 | 每日 3 次 | 不限次数 |
 | 查看命盘 | ✅ | ✅ |
 | **AI 基础解读（主性格概要）** | ✅（每日1次） | ✅ 不限 |
@@ -199,6 +198,8 @@
 > 免费额度足够能量师**试用体验**，但不足以替代日常工作。
 > 3次/天试完正好到付费决策点——"一天都不够我用"。
 
+**C端年费：** C端用户可订阅 ¥131/年 获得AI解读完整版、无限命盘生成和推广佣金权益。
+
 ---
 
 ## 六、三角形命盘计算引擎（通用算法）
@@ -209,58 +210,95 @@
 - 出生月份（2位数，如 01 或 1）
 - 出生日期（2位数，如 01 或 1）
 
-### 6.2 处理规则
+### 6.2 处理规则（30位完整系统）
 
-**Step 1: 提取底层5位数字 A, B, C, D, E**
+**输入层（A-H）—— 生日原始数字 8 位：**
 
-```
-A = 年份第一位                     (如 1990 → 1)
-B = 年份第二位                     (如 1990 → 9)
-C = 年份第三位 + 年份第四位 归约至个位   (如 1990 → 9+0=9)
-D = 月份 归约至个位                  (如 01 → 1, 12 → 1+2=3)
-E = 日期 归约至个位                  (如 01 → 1, 23 → 2+3=5)
-```
+| 字母 | 来源 | 示例 1990-01-15 |
+|------|------|----------------|
+| A | 年[0] 千位 | 1 |
+| B | 年[1] 百位 | 9 |
+| C | 年[2] 十位 | 9 |
+| D | 年[3] 个位 | 0 |
+| E | 月[0] 十位 | 0 |
+| F | 月[1] 个位 | 1 |
+| G | 日[0] 十位 | 1 |
+| H | 日[1] 个位 | 5 |
 
-**Step 2: 逐层向上计算（两两相加归约至个位）**
+**内部层（I-O）—— 7 位：**
 
+| 位置 | 公式 | 含义 |
+|------|------|------|
+| I | `reduce(E+F)` | 月能量 |
+| J | `reduce(G+H)` | 日能量 |
+| K | `reduce(A+B)` | 年前位 |
+| L | `reduce(C+D)` | 年后位 |
+| M | `reduce(I+J)` | 青年综合数 |
+| N | `reduce(K+L)` | 晚年综合数 |
+| O | `reduce(M+N)` | 主性格 |
+
+**外部层（P-X）—— 9 位独立计算：**
+
+| 位置 | 公式 | 含义 | 年龄 |
+|------|------|------|------|
+| P | `reduce(I+M)` | 左侧左子 | 21-40 |
+| Q | `reduce(J+M)` | 左侧右子 | 21-40 |
+| R | `reduce(P+Q)` | 左侧主数 | 21-40 |
+| S | `reduce(K+N)` | 右侧左子 | 61+ |
+| T | `reduce(L+N)` | 右侧右子 | 61+ |
+| U | `reduce(S+T)` | 右侧主数 | 61+ |
+| V | `reduce(M+O)` | 顶部左子 | 41-60 |
+| W | `reduce(N+O)` | 顶部右子 | 41-60 |
+| X | `reduce(V+W)` | 顶部主数 | 41-60 |
+
+**归约规则：** `reduce(N)` 为各位数字相加至个位，11/22/33 保留为卓越数。
+
+**示例（生日 1990-01-01）：**
 ```
-F = A + B (归约至个位)
-G = B + C (归约至个位)
-H = C + D (归约至个位)
-I = D + E (归约至个位)
-
-J = F + G (归约至个位)
-K = G + H (归约至个位)
-L = H + I (归约至个位)
-
-M = J + K (归约至个位)
-N = K + L (归约至个位)
-
-O = M + N (归约至个位)  ← 主性格数字
+A=1, B=9, C=9, D=0, E=0, F=1, G=0, H=1
+I = reduce(0+1) = 1
+J = reduce(0+1) = 1
+K = reduce(1+9) = 10→1
+L = reduce(9+0) = 9
+M = reduce(1+1) = 2
+N = reduce(1+9) = 10→1
+O = reduce(2+1) = 3
+P = reduce(1+2) = 3
+Q = reduce(1+2) = 3
+R = reduce(3+3) = 6
+S = reduce(1+1) = 2
+T = reduce(9+1) = 10→1
+U = reduce(2+1) = 3
+V = reduce(2+3) = 5
+W = reduce(1+3) = 4
+X = reduce(5+4) = 9
 ```
 
-**归约至个位规则：** 如果数字 > 9，则各位数字相加，重复直到结果为 1-9。
-**例外：** 11, 22, 33 为卓越数，保留不继续化简。
-
 ### 6.3 三角形布局
 
 ```
-               O
-             J   K
-           F   G   H   I
-         A   B   C   D   E
+                X
+              ↙   ↘
+            V       W
+          ↙           ↘
+        M ───────────── N
+      ↙   ↘          ↙   ↘
+    P       Q      S       T
+  ↙           ↘  ↙           ↘
+I ─────────── J  K ─────────── L
+
+ R (21-40)         U (61+)
 ```
 
 ### 6.4 五区定义
 
 | 区域 | 包含位置 | 含义 |
 |------|---------|------|
-| 主性格 | O | 核心人格特质 |
-| 父源区 | F, J | 父亲遗传、先天能量 |
-| 母源区 | I, L | 母亲遗传、后天能量 |
-| 左区（0-20岁） | A, F, J, O | 早年运势 |
-| 中区（20-40岁） | B, G, K, M, O | 中年发展 |
-| 右区（40-60岁） | C, D, E, H, I, L, O | 晚年成就 |
+| 主性格区 | O | 核心人格特质 |
+| 左区（月日能量） | I, J, M | 月日融合之力 |
+| 右区（年份能量） | K, L, N | 年份能量凝聚 |
+| 父源区 | I, M | 父亲遗传、先天能量 |
+| 母源区 | L, N | 母亲遗传、后天能量 |
 
 ### 6.5 代码级示例（JavaScript）
 
@@ -278,39 +316,34 @@ function calculateTriangle(birthYear, birthMonth, birthDay) {
   const m = String(birthMonth).padStart(2, '0');
   const d = String(birthDay).padStart(2, '0');
 
-  // 底层
-  const A = parseInt(y[0]);
-  const B = parseInt(y[1]);
-  const C = reduceToDigit(parseInt(y[2]) + parseInt(y[3]));
-  const D = reduceToDigit(parseInt(m[0]) + parseInt(m[1] === '0' ? m[1] : m[0]+m[1]));
-  // Simpler: month as sum of digits
-  const D = reduceToDigit(birthMonth);
-  const E = reduceToDigit(birthDay);
-
-  // 第二层
-  const F = reduceToDigit(A + B);
-  const G = reduceToDigit(B + C);
-  const H = reduceToDigit(C + D);
-  const I = reduceToDigit(D + E);
-
-  // 第三层
-  const J = reduceToDigit(F + G);
-  const K = reduceToDigit(G + H);
-  const L = reduceToDigit(H + I);
-
-  // 第四层
-  const M = reduceToDigit(J + K);
-  const N = reduceToDigit(K + L);
-
-  // 顶端
-  const O = reduceToDigit(M + N);
-
-  return { A, B, C, D, E, F, G, H, I, J, K, L, M, N, O };
+  // 原始数字 A-H
+  const A = +y[0], B = +y[1], C = +y[2], D = +y[3];
+  const E = +m[0], F = +m[1], G = +d[0], H = +d[1];
+
+  // 内部层 I-O
+  const I = reduceToDigit(E + F);  // 月能量
+  const J = reduceToDigit(G + H);  // 日能量
+  const K = reduceToDigit(A + B);  // 年前半
+  const L = reduceToDigit(C + D);  // 年后半
+  const M = reduceToDigit(I + J);  // 青年综合数
+  const N = reduceToDigit(K + L);  // 晚年综合数
+  const O = reduceToDigit(M + N);  // 主性格
+
+  // 外部层 P-X
+  const P = reduceToDigit(I + M);
+  const Q = reduceToDigit(J + M);
+  const R = reduceToDigit(P + Q);
+  const S = reduceToDigit(K + N);
+  const T = reduceToDigit(L + N);
+  const U = reduceToDigit(S + T);
+  const V = reduceToDigit(M + O);
+  const W = reduceToDigit(N + O);
+  const X = reduceToDigit(V + W);
+
+  return { I, J, K, L, M, N, O, P, Q, R, S, T, U, V, W, X };
 }
 ```
 
-> **注意：** 此算法为通用实现。如果后续您的真实算法不同，引擎设计为可配置，替换 reduceToDigit 和底层排列规则即可。
-
 ---
 
 ## 七、技术选型建议
@@ -406,7 +439,7 @@ Phase 1 (Week 7 上线)
 
 | 风险 | 可能性 | 影响 | 缓解 |
 |------|--------|------|------|
-| 能量师获客慢 | 中 | 现金流延迟 | 首发¥398锁定种子用户，朋友圈裂变奖励 + 分销佣金驱动 |
+| 能量师获客慢 | 中 | 现金流延迟 | 首发¥1,314种子价锁定种子用户，朋友圈裂变奖励 + 分销佣金驱动 |
 | 算法与能量师预期不符 | 高 | 产品不可用 | 上线前先给5个能量师验证算法正确性 |
 | **AI解读质量不够专业** | **中** | **能量师不认可** | Prompt中融入数字能量学专业术语和体系，支持能量师自行调整润色 |
 | **LLM API成本失控** | **低** | **利润被吃掉** | 限流+缓存机制，同一命盘重复请求时不重复调用API |
@@ -423,7 +456,7 @@ Phase 1 (Week 7 上线)
 | 指标 | Phase 1 目标 |
 |------|-------------|
 | 种子用户 | 100个能量师（付费） |
-| 年费收入 | ¥39,800 — ¥79,600（100-200人 × ¥398） |
+| 年费收入 | ¥131,400 — ¥262,800（100-200人 × ¥1,314起） |
 | 日命盘生成量 | 500+ |
 | 日活用户 | 50+ 能量师 |
 | 净推荐值（NPS） | > 60（口碑种子） |
@@ -435,4 +468,4 @@ Phase 1 (Week 7 上线)
 
 ---
 
-> **一句话总结：** 用 6 周做一个"能量师的AI智能工具"，输入生日即得命盘+AI完整解读，让能量师付 **¥398/年** 换来命盘解读一步到位，快速滚起现金流，再拿钱迭代大众版 + 电商。
+> **一句话总结：** 用 6 周做一个"能量师的AI智能工具"，输入生日即得命盘+AI完整解读，让能量师付 **¥1,314/年（种子价）** 换来命盘解读一步到位，快速滚起现金流，再拿钱迭代大众版 + 电商。

docs/phase1-user-stories.md

@@ -1,25 +1,36 @@
 # Phase 1 用户故事与验收标准
 
-> 基于 `phase1-product-plan.md`，每个用户故事包含：标题、描述、验收标准、优先级
+> 基于 `phase1-product-plan.md` 与 `1.0产品对齐方案.md`，每个用户故事包含：标题、描述、验收标准、优先级
 
 ---
 
 ## EPIC 1：命盘生成与展示（P0）
 
-### US-1.1 生日输入与命盘生成
+### US-1.1 生日输入与咨询发起
 
-**作为** 数字能量师  
-**我希望** 输入客户的姓名和出生年月日，3秒内生成完整的三角形命盘  
-**以便** 取代手动画图，提高工作效率
+**作为** 数字能量师/C端用户  
+**我希望** 输入姓名和出生年月日，发起一次命盘咨询  
+**以便** 获取命盘展示和AI解读服务
 
-**验收标准：**
+**验收标准（输入表单）：**
 
 1. 输入页面包含：姓名（选填）、出生年份（4位数字）、月份（1-12）、日期（1-31）
 2. 月份和日期支持数字键盘输入，也有下拉选择器
 3. 验证：年份必须为 1900-当前年份、月份 1-12、日期根据月份合法性验证
 4. 输入无效时显示具体错误提示（如"请输入正确的出生日期"）
-5. 点击"生成命盘"后，3秒内显示结果（纯前端计算，无需联网）
-6. 命盘页面 URL 可分享
+5. "想了解的问题" 输入框限制 100 字以内（输入时实时显示剩余字数）
+6. 点击"开始咨询"后，调用后端 `POST /api/consultation/start` 发起咨询
+
+**验收标准（咨询会话管理）：**
+
+7. 后端按照 **userId + birthday** 唯一确定一条咨询记录（同用户+同生日始终返回同一条记录）
+8. 同一用户对同一生日重复点击"开始咨询"，后端直接返回已有的咨询记录 + 完整聊天历史，**不创建新记录**
+9. 输入的生日是**全新**生日时，前端弹出确认对话框："此生日将开启全新的命盘咨询，确认吗？"
+10. 用户确认后，后端计算完整的数字命盘（24个位置），创建新咨询记录，并返回结果
+11. 用户取消确认，停留在首页，不跳转、不创建
+12. 点击"开始咨询"到命盘渲染完成，总耗时不超过 3 秒
+13. 命盘计算全部由后端 `CalculatorService` 完成，前端只负责展示（`calculator.js` 保留为降级兜底，不作为主路径）
+14. 命盘页面 URL 可分享
 
 ### US-1.2 三角形命盘可视化展示
 
@@ -29,21 +40,130 @@
 
 **验收标准：**
 
-1. 页面使用 Canvas 绘制三角形，5层15个数字位置完整展示
-2. 布局严格遵循：
+1. 页面展示完整的24个数字位置（8个底部输入位 A-H + 7个三角内部位 I-O + 9个外部三组位 P-X）
+2. 内部三角形布局严格遵循（新字母命名）：
    ```
-         O
-       J   K
-     F   G   H   I
-   A   B   C   D   E
+            O
+          /    \
+        M        N
+      /    \   /    \
+    I       J  K      L
    ```
-3. 每个数字使用单独的圆形/方形卡片展示，字体清晰易读
-4. 五区使用不同背景色区分（左区/中区/右区/父源/母源/主性格）
-5. 数字颜色：1-9 每个数字有独立颜色（参考能量数字配色）
-6. 卓越数（11/22/33）用特殊标记突出
-7. 底部显示姓名和出生日期信息
+3. 底部输入框布局：日（2位）| 月（2位）| 年（4位），从左到右排列（已改为"日月年"顺序）
+4. 外部三组以T形线段连接三角内部对应位置：
+   - 左侧组（R, P, Q）对应 21-40 岁，由 I, J, M 计算
+   - 右侧组（U, S, T）对应 61+ 岁，由 K, L, N 计算
+   - 顶部组（X, V, W）对应 41-60 岁，由 M, N, O 计算
+5. 外部三组使用独立的计算值，非内部数字的直接重复
+6. 每个数字使用单独的圆形/方形卡片展示，字体清晰易读
+7. 五区使用不同背景色区分（左区/中区/右区/父源/母源/主性格）
+8. 数字颜色：1-9 每个数字有独立颜色（参考能量数字配色）
+9. 卓越数（11/22/33）用特殊标记突出
+10. 底部显示姓名和出生日期信息
+
+### US-1.3 命盘数字位置命名与计算规则（对照表）
+
+**作为** 开发团队  
+**我希望** 有一份完整的位置命名与计算规则对照表作为开发基准  
+**以便** 前后端计算逻辑一致，避免歧义
+
+#### 1. 完整字母命名表（A-X）
+
+##### 输入层（8位）—— 生日原始数字
+
+| 字母 | 来源 | 示例 1990-01-15 | 说明 |
+|------|------|----------------|------|
+| A | 年份千位 | 1 | 年[0] |
+| B | 年份百位 | 9 | 年[1] |
+| C | 年份十位 | 9 | 年[2] |
+| D | 年份个位 | 0 | 年[3] |
+| E | 月份十位 | 0 | 月[0] |
+| F | 月份个位 | 1 | 月[1] |
+| G | 日期十位 | 1 | 日[0] |
+| H | 日期个位 | 5 | 日[1] |
+
+##### 内部计算层（7位）
+
+| 字母 | 公式 | 中文名 | 旧名对照 | 视觉层级 |
+|------|------|-------|---------|---------|
+| I | `reduce(E+F)` | 月能量 | 旧 F | 底部左1 |
+| J | `reduce(G+H)` | 日能量 | 旧 G | 底部左2 |
+| K | `reduce(A+B)` | 年前半 | 旧 H | 底部右1 |
+| L | `reduce(C+D)` | 年后半 | 旧 I | 底部右2 |
+| M | `reduce(I+J)` | 青年综合数 | 不变 | 中层左 |
+| N | `reduce(K+L)` | 晚年综合数 | 不变 | 中层右 |
+| O | `reduce(M+N)` | **主性格数** | 不变 | 顶层 |
+
+##### 外部三组（9位）
+
+| 字母 | 公式 | 中文名 | 年龄区间 | 所属组 |
+|------|------|-------|---------|-------|
+| P | `reduce(I+M)` | 左侧左子（left-L） | 21-40 | 左侧 |
+| Q | `reduce(J+M)` | 左侧右子（left-R） | 21-40 | 左侧 |
+| R | `reduce(P+Q)` | **左侧主数（left）** | 21-40 | 左侧 |
+| S | `reduce(K+N)` | 右侧左子（right-L） | 61+ | 右侧 |
+| T | `reduce(L+N)` | 右侧右子（right-R） | 61+ | 右侧 |
+| U | `reduce(S+T)` | **右侧主数（right）** | 61+ | 右侧 |
+| V | `reduce(M+O)` | 顶部左子（top-L） | 41-60 | 顶部 |
+| W | `reduce(N+O)` | 顶部右子（top-R） | 41-60 | 顶部 |
+| X | `reduce(V+W)` | **顶部主数（top）** | 41-60 | 顶部 |
+
+#### 2. 视觉布局示意
+
+```
+                 X
+               ↙   ↘
+             V       W
+           ↙           ↘
+         M ───────────── N
+       ↙   ↘          ↙   ↘
+     P       Q      S       T
+   ↙           ↘  ↙           ↘
+ I ─────────── J  K ─────────── L
+
+   R (21-40)         U (61+)
+
+底部输入: 日 G H | 月 E F | 年 A B C D
+```
+
+#### 3. 外部三组年龄映射
+
+| 组 | 位置 | 年龄区间 | 关联内部位 |
+|----|------|---------|----------|
+| 左侧组 (R, P, Q) | 三角形左外侧 | **21-40岁** | 基于 I, J, M |
+| 顶部组 (X, V, W) | 三角形顶外侧 | **41-60岁** | 基于 M, N, O |
+| 右侧组 (U, S, T) | 三角形右外侧 | **61+岁** | 基于 K, L, N |
+
+#### 4. 计算精度说明
+
+- `reduce(N)` 定义：各位数字相加归约至个位，但 11/22/33 保留为卓越数
+- 所有 `+` 操作符均先执行普通加法，再调用 `reduce()` 归约
+- 外部三组**必须使用独立的归约计算**，不得直接引用内部数字值
+
+#### 5. 后端 API 返回结构（`POST /api/consultation/start` 响应示例）
+
+```json
+{
+  "recordId": 42,
+  "isNew": false,
+  "chartData": {
+    "positions": {
+      "I": 1, "J": 2, "K": 3, "L": 4,
+      "M": 5, "N": 6, "O": 7,
+      "P": 8, "Q": 9, "R": 1,
+      "S": 2, "T": 3, "U": 4,
+      "V": 5, "W": 6, "X": 7
+    },
+    "mainCharacter": 7,
+    "isMasterNumber": false
+  },
+  "messages": []
+}
+```
 
-### US-1.3 数字点击查看含义
+---
+
+### US-1.4 数字点击查看含义
 
 **作为** 数字能量师  
 **我希望** 点击三角形中的每个数字可以查看该位置的含义和能量解读  
@@ -101,7 +221,7 @@
 **验收标准：**
 
 1. 命盘展示页底部有"查看AI解读"按钮，点击跳转到AI解读页
-2. 解读内容由LLM生成，通过云函数调用，首次加载等待时间 < 5秒
+2. 解读内容由LLM生成，通过后端API调用，首次加载等待时间 < 5秒
 3. 加载过程中显示骨架屏或loading动画，避免用户以为卡死
 4. 解读内容至少包含以下章节：
    - **主性格解读**：顶端数字的核心特质、性格描述、代表人物
@@ -118,15 +238,35 @@
 
 **作为** 平台运营者  
 **我希望** 控制AI解读功能的免费与付费边界  
-**以便** 激励用户订阅能量师年服务包
+**以便** 激励用户订阅C端年费或能量师年费
 
 **验收标准：**
 
 1. 未付费用户点击"查看AI解读"时，仅显示**主性格概要**（1段文字）
 2. 未付费用户每日可查看主性格概要 1 次
-3. 五区完整解读仅在已付费后可用
-4. 已付费能量师可无限次查看完整解读
-5. 每次解读请求记录到数据库，用于成本控制和限流
+3. 五区完整解读仅在已付费后可用（C端¥131或能量师¥1,314+）
+4. 解读页底部显示"¥131 开通完整解读"引导卡片（免费用户可见）
+5. 已付费用户可无限次查看完整解读
+6. 每次解读请求记录到数据库，用于成本控制和限流
+
+### US-3.4 AI 交互问答（免费/付费控制）
+
+**作为** 平台运营者  
+**我希望** 控制AI问答互动功能的免费次数，且限定在同一个命盘上  
+**以便** 防止用户通过切换生日绕过每日限制，同时保证体验清晰可预期
+
+**验收标准：**
+
+1. 未付费用户每日可进行 3 轮 AI 问答互动（每日配额全局统一，不按命盘拆分）
+2. 此 3 轮互动**绑定到当前咨询的命盘上**，用户不能通过创建多个生日命盘来获得额外免费次数
+3. 已付费用户不受次数限制
+4. 用户在命盘页顶部看到剩余次数提示："今日 {{usedChats}}/{{maxChats}} 轮"
+5. 当用户在已用满3次的命盘上新建**另一个生日**的咨询时：
+   - 前端弹出确认对话框
+   - 对话框提示："此生日将开启全新的命盘咨询，今日剩余互动次数仍为 0 次，确定吗？"
+   - 用户确认后创建新咨询，次数不重置
+6. 超出每日次数后，AI 输入框和快捷问题按钮隐藏，显示引导卡片："今日 AI 解读次数已用完，开通会员享无限次"
+7. 每日次数在 `lastQuotaDate` 跨日时自动归零
 
 ### US-3.3 解读内容缓存
 
@@ -145,23 +285,43 @@
 
 ## EPIC 4：付费与订阅（P0）
 
-### US-4.1 付费订阅页
+### US-4.1 能量师付费订阅
 
 **作为** 数字能量师  
 **我希望** 看到清晰的定价方案并进行年费支付  
-**以便** 获得AI完整解读等全部功能以及分销推广权限
+**以便** 获得AI完整解读、分销推广等全部功能
 
 **验收标准：**
 
 1. 付费入口：未付费用户在首页/命盘页/解读页/分享时均会看到升级引导
-2. 付费页展示：功能对比表（普通用户 vs 能量师，突出AI完整解读+分销权）、价格、支付按钮
-3. 价格展示：年费 ¥398（种子价），无首年/续费区分
-4. 功能对比表清晰展示：免费只能看主性格概要，能量师可看五区全解+推广码
-5. 通过微信支付完成订阅
-6. 支付成功后，用户状态即时更新为"能量师"，自动生成专属推广码
+2. 付费页展示：
+   - 功能对比表（普通用户 vs 能量师）
+   - 价格：种子价 ¥1,314 / 标准价 ¥1,986（通过 `POST /api/pricing/current` 获取）
+   - 种子价名额提示："仅剩 XX 个种子名额"
+   - "立即开通"支付按钮
+3. 通过微信支付完成订阅
+4. 支付成功后，用户状态即时更新（`vipEndTime += 365天`）
+5. 支付成功后，自动生成专属6位推广码（如无已有）
+6. 支付成功后，自动跳转到分销面板（或引导页）
 7. 支付失败显示友好提示
 
-### US-4.2 订阅状态与续费
+### US-4.2 种子价自动判断
+
+**作为** 平台  
+**我希望** 系统自动判断用户是否享受种子价  
+**以便** 运营策略自动化，无需人工干预
+
+**验收标准：**
+
+1. 用户在支付页看到的价格由后端接口 `POST /api/pricing/current` 返回，前端不做判断
+2. 后端判断逻辑：统计 `orders` 表中 `product_type='practitioner'` 且 `status='paid'` 的记录数
+3. 已付费记录数 < `sys_config.pricing.practitioner.seed_limit`（默认 300）时，返回种子价
+4. 已付费记录数 ≥ 限额时，返回标准价
+5. 订单创建时将种子价状态锁定（不因后续人数变化而改变已创建订单的价格）
+6. 种子价名额满后，所有新用户看到标准价
+7. 种子价上限可在管理后台动态修改（`pricing.practitioner.seed_limit`）
+
+### US-4.3 订阅状态与续费
 
 **作为** 付费能量师  
 **我希望** 在个人中心看到我的订阅状态、到期日，并能续费  
@@ -169,10 +329,11 @@
 
 **验收标准：**
 
-1. 个人中心显示：订阅状态（能量师/已过期/普通用户）
+1. 个人中心显示：订阅状态（能量师/C端会员/已过期/普通用户）
 2. 显示到期日期，到期前 7 天显示续费提醒
-3. 到期后自动降级为普通用户，分销面板关闭
-4. 续费操作与原付费流程一致
+3. 到期后自动降级为普通用户，分销面板入口隐藏
+4. 续费操作按**标准价**执行（种子价仅限首次，不限能量师或C端）
+5. 续费成功后有效期在原到期日基础上延长1年
 
 ---
 
@@ -189,122 +350,267 @@
 1. 首次使用点击"生成命盘"时弹出微信授权
 2. 授权后自动完成注册，无需填写额外信息
 3. 后续使用自动登录
-4. 用户信息存储在云数据库中
+4. 用户信息存储在数据库中
 
-### US-5.2 历史命盘记录
+### US-5.2 历史咨询记录
 
 **作为** 能量师  
-**我希望** 查看我过去生成的所有命盘记录  
-**以便** 回顾和重用
+**我希望** 查看我过去的所有咨询记录  
+**以便** 回顾和继续之前的咨询
 
 **验收标准：**
 
-1. 个人中心页包含"我的命盘"列表
-2. 列表按生成时间倒序排列
-3. 每条记录显示：姓名、生日、生成时间
-4. 点击记录可跳转到对应的命盘展示页
+1. 个人中心页包含"我的咨询"列表
+2. 列表按最后互动时间倒序排列
+3. 每条记录显示：姓名、生日、咨询时间、最后一条消息摘要
+4. 点击记录可跳转到对应的命盘展示页，并恢复完整的聊天历史
 5. 支持单条删除
-6. 免费用户仅能看到近 7 天记录，已付费用户可见全部
+6. 同一用户+同一生日永远返回同一条咨询记录（`(userId, birthday)` 联合唯一）
+7. 免费用户仅能看到近 7 天记录，已付费用户可见全部
 
 ---
 
 ## EPIC 6：分销推广与佣金（P0-P1）
 
-### US-6.1 推广码生成
+### US-6.1 推广码生成（付费后生成）
 
-**作为** 能量师  
-**我希望** 在支付升级后自动获得专属推广二维码和推广卡片  
-**以便** 分享给微信好友和朋友圈来发展下级能量师
+**作为** 付费用户（C端 / 能量师）  
+**我希望** 在首次付费后自动获得专属推广码  
+**以便** 分享给微信好友来发展下级并赚取佣金
 
 **验收标准：**
 
-1. 支付升级成功时，系统自动为该用户生成唯一6位推广码（字母+数字）
-2. 分销面板中展示：专属小程序码图片（可通过云函数生成）、推广卡片、可复制链接
-3. 推广码永久有效，不随年费到期失效
-4. 推广卡片包含：能量师昵称头像 + 小程序码 + "扫码免费测命盘"文案
-5. 支持保存到相册 / 分享给微信好友 / 分享到朋友圈
+1. 推广码在**注册时不生成**，仅在**首次支付成功后**生成（¥131年费 / ¥1,314+能量师费任一触发）
+2. 推广码规则：6位大写字母+数字，字符集去掉易混淆的 `O/0/I/1`（即 `ABCDEFGHJKLMNPQRSTUVWXYZ23456789`）
+3. 推广码冲突时自动重新生成，保证全局唯一
+4. 推广码永久有效，不随年费到期失效
+5. 普通用户（未付费）没有推广码，也没有分销入口
+6. 推广码展示在分销面板顶部，支持一键复制和生成推广海报
+7. 推广码下游用于：分享带参注册（US-6.2）和佣金结算（US-6.3 / US-6.4）
+
+---
 
 ### 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 佣金结算
+**分享链路：**
+1. 推广链接格式：`/pages/index/index?ref=ABC123`（6位推广码）
+2. 分享卡片 / 小程序码同样携带 `ref` 参数
+
+**前端缓存策略：**
+3. 用户通过链接打开小程序时：
+   - `onLaunch(options)` 读取 `options.query.ref`，转为大写后写入缓存 `pending_referrer`
+   - 不覆盖已有 `pending_referrer`，以用户**最后一次点击的链接**为准
+4. `pending_referrer` **永不过期**，直到注册成功后才清除
+5. 用户注册（微信授权登录）时，从缓存读取 `pending_referrer` 传入注册接口
+
+**后端注册逻辑（`UserService.loginOrRegister()`）：**
+6. 用户不存在（新用户）+ `referrerCode` 有效 → `invitedBy = 上级ID`
+7. 用户不存在 + `referrerCode` 无效 → `invitedBy = null`（静默降级，不报错）
+8. 用户不存在 + `referrerCode` 为空 → `invitedBy = null`（正常注册）
+9. 用户不存在 + `referrerCode` 为**自己的新openid** → `invitedBy = null`（防止自邀请）
+10. 用户**已存在** → 忽略所有 `referrerCode`，不覆盖已有 `invitedBy`（关系一次性锁定）
+11. `referrerCode` 查询不到对应上级 → 静默跳过，不抛异常
+
+**数据库更新：**
+12. 绑定成功后，如果上级存在，`inviter.directCount += 1`（实时更新统计字段）
+
+**边界与异常：**
+13. 用户未登录直接生成命盘（纯前端计算）→ 允许，不强制登录
+14. 登录中途中断（拒绝授权）→ 不清除 `pending_referrer`，下次触发登录仍携带
+15. 注册接口网络失败 → 保留 `pending_referrer`，重试时继续携带
+16. 同一设备切换微信账号 → 新的 openid 按新用户处理，正常绑定关系
+
+---
+
+### US-6.3 B端佣金结算（能量师→能量师，固定金额）
 
 **作为** 平台  
-**我希望** 当用户通过能量师A的链接注册并升级为能量师时，自动计算并记录佣金  
+**我希望** 当能量师A的下级B升级为能量师时，自动结算固定金额佣金  
 **以便** 能量师获得推广收益
 
 **验收标准：**
 
-1. 用户支付成功后，云函数触发佣金结算流程
-2. 佣金比例从后台配置读取（默认一级30%/二级10%）
-3. 查询该用户的 `invitedBy` 字段
-4. 若上级存在且是能量师（订阅有效期内）：
-   - 创建一级佣金记录：金额按比例计算（默认 ¥119.4），状态"可提现"
-5. 查询上级的上级：
-   - 若上上级存在且是能量师：
-   - 创建二级佣金记录：金额按比例计算（默认 ¥39.8），状态"可提现"
-6. 佣金记录写入 commissions 集合，关联订单ID
-7. 无冷静期，支付成功即结算。退款发生时：若佣金未提现则直接撤销；若已提现则从后续佣金中抵扣
+**触发条件：**
+1. 订单 `productType = "practitioner"` 且支付成功 → 进入 B端佣金结算流程
+2. 订单 `productType = "annual"` → 走 US-6.4 C端佣金（互斥分支）
+
+**佣金计算：**
+3. 一级佣金（L1，直接上级）：**固定金额**，从 `sys_config` 读取 `commission.practitioner.l1`（默认 ¥500 = 50000分）
+4. 二级佣金（L2，上上级）：**固定金额**，从 `sys_config` 读取 `commission.practitioner.l2`（默认 ¥100 = 10000分）
+5. 佣金单位为**分**（避免浮点精度问题）
+
+**收款人资格：**
+6. L1：`buyer.invitedBy` 对应的上级存在 → 创建佣金（不需要校验VIP是否有效）
+7. L2：上级的 `invitedBy` 对应的上上级存在 → 创建佣金
+8. 收款人不存在时 → 静默跳过，不报错
+
+**状态与幂等：**
+9. 佣金 `status` 直接写入 `"settled"`（即时到账，无 pending 冷静期）
+10. 同一 `outTradeNo` 重复回调 → 幂等处理，不创建重复佣金
+11. 佣金金额固定的另一层含义：**不受种子价/标准价差异影响**，¥500/¥100 固定不变
+
+**统计更新：**
+12. L1 创建时：`inviter.directCount += 1`，`inviter.convertedCount += 1`
+13. L2 创建时：`inviter2.indirectCount += 1`
+
+**配置项（后台可配）：**
+| 配置键 | 默认值 | 说明 |
+|--------|--------|------|
+| `commission.practitioner.l1` | `50000` | B端一级佣金（分） |
+| `commission.practitioner.l2` | `10000` | B端二级佣金（分） |
+
+---
+
+### US-6.4 C端佣金结算（年费推荐，比例分成）
+
+**作为** 平台  
+**我希望** 当C端用户B通过上级A的链接注册并付费 ¥131 时，自动按比例分成  
+**以便** 激励所有付费用户推广
+
+**验收标准：**
+
+**触发条件：**
+1. 订单 `productType = "annual"` 且支付成功 → 进入 C端佣金结算流程
+
+**佣金计算：**
+2. 直接佣金（L1）：`totalFee × directRate / 10000`，从 `sys_config` 读取 `commission.annual.direct_rate`（默认 `4000` = 40%）
+3. 上级佣金（L2）：`totalFee × upstreamRate / 10000`，从 `sys_config` 读取 `commission.annual.upstream_rate`（默认 `500` = 5%）
+4. 金额计算使用**整数截断**（非四舍五入），剩余零头归平台
+
+**收款人资格（与 B端不同）：**
+5. L1：`buyer.invitedBy` 对应的上级**必须已付费**（`referralCode != null`），才创建佣金
+6. L2：上级的 `invitedBy` 对应的上上级**必须已付费**（`referralCode != null`），才创建佣金
+7. C端佣金**不要求**收款人是"能量师"（practitioner），只要曾经付费即可
+
+**状态与幂等：**
+8. 佣金 `status` 直接写入 `"settled"`
+9. 幂等处理同 US-6.3
+
+**与 B端的差异：**
+10. C端佣金不更新 `directCount/convertedCount/indirectCount`（这些统计仅用于B端"升级能量师"）
+11. C端佣金比例灵活（后台可配 0%~100%），B端固定金额
 
-### US-6.4 分销面板
+**每笔 ¥131 分配示例：**
+| 分配对象 | 比例 | 金额 |
+|---------|------|------|
+| 直接上级 | 40% | ¥52.40 |
+| 上上级 | 5% | ¥6.55 |
+| 平台 | 55% | ¥72.05 |
+
+**配置项（后台可配）：**
+| 配置键 | 默认值 | 说明 |
+|--------|--------|------|
+| `commission.annual.direct_rate` | `4000` | C端直接佣金比例（万分比，4000=40%） |
+| `commission.annual.upstream_rate` | `500` | C端上级佣金比例（万分比，500=5%） |
+
+---
+
+### US-6.5 分销面板
 
 **作为** 能量师  
-**我希望** 在分销面板中查看我的收益和团队数据  
+**我希望** 在分销面板中查看我的推广收益和团队数据  
 **以便** 追踪推广效果，激励持续推广
 
 **验收标准：**
 
-1. 个人中心有"我的收益"入口（仅能量师可见）
-2. 分销面板展示：
-   - **总收益**：累计佣金总额
-   - **可提现**：当前可提现佣金余额
-    - **今日新增**：今日新增佣金
-   - **团队统计**：直接下级数 / 间接下级数 / 下级升级为能量师数
-3. 团队列表：按注册时间倒序展示下级用户
-4. 佣金明细列表：展示每笔佣金的时间、来源、金额、状态
-5. "推广工具"区域：重置/保存推广码图片、复制推广链接
-6. "申请提现"按钮（Phase 1 提交申请，平台手动打款）
+**入口权限：**
+1. 个人中心菜单项"💰 我的推广"→ 跳转到分销面板
+2. **仅付费用户可见**（`vipEndTime > now`），普通用户看不到入口
+3. 付费到期后入口自动隐藏
+
+**页面结构（自上而下）：**
+
+**① 推广码卡片：**
+4. 显示推广码 `我的推广码: ABC123` + 复制按钮
+5. "生成推广海报"按钮 → 调用后端生成含小程序码的海报
+6. 无推广码（极端情况）→ 显示"推广码生成中…"
+
+**② 收益统计卡片（三列等宽）：**
+7. 总收益：累计所有佣金总额（`status = settled`）
+8. 可提现：当前可提现金额（与总收益相同，Phase 1 不做提现扣除）
+9. 今日新增：当日 00:00 至今产生的佣金总额
+10. 金额以元为单位，保留两位小数（后端存储分，前端 `/100`）
+
+**③ 团队统计（三列）：**
+11. 直接下级：`directCount`
+12. 间接下级：`indirectCount`
+13. 升级下级：`convertedCount`
+14. 零数据时显示引导文案："暂无推广数据，分享推广码给好友开始赚取佣金"
+
+**④ 佣金明细列表（最近50条）：**
+15. 显示：时间（MM-DD HH:mm）、来源（匿名"用户****"）、级别（L1/L2标签）、金额（+¥XXX.XX）、状态
+16. 按时间倒序排列
+17. 空数据时显示"暂无佣金记录"引导
+
+**⑤ 推广工具区：**
+18. "📱 生成推广海报" → 合成含小程序码的分享海报
+19. "🔗 复制推广链接" → 复制带 ref 参数的小程序路径到剪贴板
+20. "📊 提现申请" → **置灰不可点击**，显示"即将开放"（Phase 1 不做提现）
+
+**页面状态：**
+21. **Loading 状态**：各区块显示骨架屏脉冲动画
+22. **错误状态**：顶部显示错误提示条 + "点击重试"按钮
+23. **空数据状态**：佣金列表/团队统计显示引导文案
+24. **下拉刷新**：重新请求所有数据
+
+**后端 API 需求：**
+| 接口 | 说明 |
+|------|------|
+| `POST /api/profile/info` | 含 `referralCode`（已有） |
+| `POST /api/commission/list` | 佣金明细列表（已有） |
+| `POST /api/commission/stats` | **新增**：总收益+可提现+今日新增+团队统计 |
 
-### US-6.5 提现申请
+---
 
-**作为** 能量师  
-**我希望** 在可提现金额达到最低限额后申请提现  
-**以便** 将推广收益变现
+### US-6.6 C端年费订阅入口
+
+**作为** 免费用户（C端）  
+**我希望** 在AI解读页底部看到 ¥131 开通完整解读的引导  
+**以便** 一键订阅获取完整服务
 
 **验收标准：**
 
-1. 可提现金额 ≥ ¥100 时，"申请提现"按钮可点击
-2. 点击后填写提现金额（不得超过可提现金额）
-3. 提交后生成提现申请记录，状态为"待审核"
-4. 平台在后台查看提现申请，手动审核打款
-5. 审核通过后，对应佣金标记为"已完成"，不可再提现
-6. 提现申请记录保留流水号供后续对账
-7. Phase 1 不接入自动打款API，平台手动处理
+**入口位置（用户已确认选项1——命盘解读页底部）：**
+1. `chart/index.vue` 底部（聊天区下方）固定显示订阅卡片（免费用户）
+2. 已付费用户（C端或能量师） → 不显示订阅卡片，改为显示"✅ 已开通"徽章+生成推广海报入口
+
+**交互流程（未登录）：**
+3. 显示完整订阅卡片：🔮 AI解读会员 ¥131/年，列出权益（无限AI解读、个性化报告、推广赚佣金）
+4. 点击"登录后开通 ¥131" → 先跳登录页，登录后自动跳转支付页
+
+**交互流程（已登录未付费）：**
+5. 显示同上"立即开通 ¥131"按钮
+6. 点击 → 跳转支付页 `product=annual`，金额 ¥131
+
+**交互流程（已付费）：**
+7. 订阅卡片替换为灰色小徽章"✅ 已开通AI解读  | 有效期至 2027-05-28"
+8. 已付费用户显示"📱 生成推广海报"入口
+9. 能量师（practitioner）显示"✅ 已开通能量师"
+
+**支付页适配：**
+10. `payment/index.vue` 支持 URL 参数 `product`：
+    - `product=annual` → 显示 C端年费 ¥131 和对应权益列表
+    - `product=practitioner` → 显示能量师价格（通过 API 获取种子/标准价）
+11. `createOrder` 接口接收 `productType` 参数
+
+**后端适应：**
+12. Order 新增 `productType` 字段（`"annual"` | `"practitioner"`）
+13. User 新增 `vipType` 字段（`"annual"` | `"practitioner"` | `null`）
+14. `paySuccess()` 按 `productType` 分支佣金逻辑：
+    - `practitioner` → US-6.3 固定金额
+    - `annual` → US-6.4 比例分成
 
 ---
 
 ## EPIC 7：批注与客户管理（P2）
 
-### US-6.1 命盘批注
+### US-7.1 命盘批注
 
 **作为** 能量师  
 **我希望** 在命盘图上添加文字批注或标记  
@@ -318,7 +624,7 @@
 4. 批注支持简单的富文本（分段、加粗等）
 5. 导出的 PDF 中可包含批注内容
 
-### US-6.2 客户标签分组
+### US-7.2 客户标签分组
 
 **作为** 能量师  
 **我希望** 为命盘记录添加简单的标签或分组  
@@ -333,32 +639,585 @@
 
 ---
 
+## EPIC 8：管理后台（P0-P1）
+
+### US-8.1 系统配置管理
+
+**作为** 运营管理员  
+**我希望** 在管理后台可视化编辑定价和佣金参数  
+**以便** 灵活调整运营策略，无需开发介入
+
+---
+
+#### 8.1.1 验收标准
+
+**DDL & Entity：**
+1. 新建 `sys_config` 表，结构如下：
+
+```sql
+CREATE TABLE `sys_config` (
+    `id`          BIGINT       NOT NULL AUTO_INCREMENT,
+    `config_key`  VARCHAR(64)  NOT NULL COMMENT '配置键（点分命名法）',
+    `config_value` VARCHAR(255) DEFAULT NULL COMMENT '配置值（始终使用字符串存储）',
+    `description` VARCHAR(255) DEFAULT NULL COMMENT '中文说明',
+    `value_type`  VARCHAR(20)  NOT NULL DEFAULT 'string' COMMENT 'int | price | percent | string',
+    `updated_at`  DATETIME     DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
+    `created_at`  DATETIME     DEFAULT CURRENT_TIMESTAMP,
+    PRIMARY KEY (`id`),
+    UNIQUE KEY `uk_config_key` (`config_key`)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
+```
+
+2. 预置 8 条种子数据（见下）。
+
+**后端：SysConfigService + 内存缓存：**
+3. `@PostConstruct loadAllToCache()`：启动时将全量配置读入 `ConcurrentHashMap<String, String>`
+4. 对外提供 `getString(key, default)`、`getInt(key, default)` 两个读方法，O(1) 取值
+5. `key` 不存在时 → 返回代码中传入的 `defaultValue`，**永不抛异常**
+6. `updateConfig(key, value)`：更新 DB + 同步写入缓存，**无需重启**
+7. `batchUpdate(Map<String, String>)`：循环调用 `updateConfig`，整个操作在 `@Transactional` 中
+
+**管理后台 API：**
+8. `POST /api/admin/config/list` → 返回 `List<SysConfig>`（含全部字段）
+9. `POST /api/admin/config/update` → 接收 `{ "configKey": "value", ... }` → 批量更新
+
+**小程序端 API：`POST /api/pricing/current`：**
+
+```json
+// Request: 无参数
+// Response:
+{
+  "code": 0,
+  "data": {
+    "seedPrice": 131400,         // pricing.practitioner.seed（分）
+    "standardPrice": 198600,     // pricing.practitioner.standard（分）
+    "annualFee": 13100,          // pricing.annual（分）
+    "isSeedPrice": true,         // 当前用户是否能享受种子价
+    "remainingSeats": 298,       // 种子名额余量
+    "seedLimit": 300             // 名额上限
+  }
+}
+```
+
+10. `isSeedPrice` 的计算逻辑：统计 `orders` 表中 `product_type='practitioner'` AND `status='paid'` 的记录数，小于 `seedLimit` 则为 `true`
+
+**管理后台页面（`src/views/settings/index.vue`）：**
+11. 左侧菜单新增"系统配置"入口，路由 `/settings`，图标 ⚙️
+12. 页面分为三个卡片区域，每个卡片顶部有"恢复默认值"按钮（仅重置单个卡片内的字段）
+
+**定价配置卡片：**
+13. 四个输入项：能量师种子价、标准价、种子价名额上限、C端年费
+14. 用户输入的是**元（整数）**，提交时自动 ×100 转为分
+15. 种子价名额上限下方实时显示"当前已使用：X / Y"（调用 `countByProductTypeAndStatus`）
+16. 修改数量时，"已使用"比例随之动态变化
+
+**B端佣金配置卡片：**
+17. 两个输入项：L1 佣金（¥500）、L2 佣金（¥100）
+18. 输入单位为元（整数），提交时 ×100 转为分
+19. 下方实时显示比例计算：
+    - "L1 ¥500 = 种子价 38.1% / 标准价 25.2%"
+    - "L2 ¥100 = 种子价 7.6% / 标准价 5.0%"
+20. 比例随定价或佣金值的修改**实时联动更新**
+
+**C端佣金配置卡片：**
+21. 两个输入项：直接佣金比例（40%）、上级佣金比例（5%）
+22. 输入单位为"%"（整数，如输入"40"表示40%），提交时转为万分比 ×100
+23. 下方实时显示金额分配预览：
+    - "每笔 ¥131：直接 ¥52.40（40.0%）/ 上级 ¥6.55（5.0%）/ 平台 ¥72.05（55.0%）"
+24. 费率修改时金额分配**实时联动更新**
+
+**保存逻辑：**
+25. 点击"保存全部配置"按钮 → 触发 `POST /api/admin/config/update`
+26. 所有字段批量提交，不逐个保存
+27. 保存前做前端校验：金额 > 0、比例 0-100%、名额上限 > 0
+28. 保存成功 → ElMessage.success("配置已保存，已实时生效")
+29. 保存失败 → ElMessage.error("保存失败：" + 错误详情)
+30. 前端无 `el-form` 的 reset 行为 —— 用户手动刷新页面可恢复到上次保存的值
+
+**错误与边界：**
+31. 网络失败时显示"保存失败，请重试"，页面不跳转，已修改的值保留在输入框中
+32. 同时两个管理员保存 → 后保存的覆盖先保存的，不做冲突检测（Phase 1 简化）
+33. 输入非法值时（如空字符串、负数），`el-input-number` 的 min 属性直接阻止输入
+34. 所有金额字段不允许出现小数（元为整数输入，单位转换在后端）
+
+---
+
+#### 8.1.2 后端接口规格
+
+**`POST /api/admin/config/list`**
+
+```json
+// Response:
+{
+  "code": 0,
+  "data": [
+    {
+      "id": 1,
+      "configKey": "pricing.practitioner.seed",
+      "configValue": "131400",
+      "description": "能量师种子价（分）",
+      "valueType": "price",
+      "updatedAt": "2026-05-28T10:00:00"
+    }
+    // ... 共 8 条
+  ]
+}
+```
+
+**`POST /api/admin/config/update`**
+
+```json
+// Request:
+{
+  "pricing.practitioner.seed": "131400",
+  "commission.practitioner.l1": "60000"
+}
+// Response: { "code": 0 }
+```
+
+**`POST /api/admin/config/reset`**（可选，单条重置）
+
+```json
+// Request: { "configKey": "commission.practitioner.l1" }
+// Response: { "code": 0, "data": { "configKey": "commission.practitioner.l1", "configValue": "50000" } }
+```
+
+---
+
+#### 8.1.3 后端类设计
+
+| 类名 | 位置 | 说明 |
+|------|------|------|
+| `SysConfig` | `entity/` | JPA 实体 |
+| `SysConfigRepository` | `repository/` | JPA 接口 |
+| `SysConfigService` | `service/` | 配置 CRUD + 内存缓存 |
+| `AdminConfigController` | `controller/` | `/api/admin/config/*` 端点 |
+| `PricingController` | `controller/` | `/api/pricing/current` 小程序端端点 |
+| `OrderRepository` | `repository/` | 新增 `countByProductTypeAndStatus()` |
+
+**`SysConfigService` 核心代码：**
+
+```java
+@Service
+public class SysConfigService {
+    private final ConcurrentHashMap<String, String> cache = new ConcurrentHashMap<>();
+    private final SysConfigRepository repository;
+
+    @PostConstruct
+    public void loadAllToCache() {
+        cache.clear();
+        repository.findAllByOrderByConfigKeyAsc()
+            .forEach(cfg -> cache.put(cfg.getConfigKey(), cfg.getConfigValue()));
+    }
+
+    public String getString(String key, String defaultValue) {
+        return cache.getOrDefault(key, defaultValue);
+    }
+
+    public int getInt(String key, int defaultValue) {
+        String val = cache.get(key);
+        if (val == null) return defaultValue;
+        try { return Integer.parseInt(val); }
+        catch (NumberFormatException e) { return defaultValue; }
+    }
+
+    @Transactional
+    public void updateConfig(String key, String value) {
+        SysConfig cfg = repository.findByConfigKey(key)
+            .orElseGet(() -> new SysConfig(key, value, "auto", "string"));
+        cfg.setConfigValue(value);
+        cfg.setUpdatedAt(LocalDateTime.now());
+        repository.save(cfg);
+        cache.put(key, value);
+    }
+
+    public void batchUpdate(Map<String, String> configs) {
+        configs.forEach(this::updateConfig);
+    }
+}
+```
+
+---
+
+#### 8.1.4 管理后台前端规格
+
+| 文件 | 操作 | 说明 |
+|------|------|------|
+| `src/views/settings/index.vue` | **新增** | 系统配置页面（~200行） |
+| `src/router/index.ts` | 修改 | 新增 `/settings` 路由 |
+| `src/layout/index.vue` | 修改 | 新增菜单项 |
+
+**侧边栏菜单新增：**
+```vue
+<el-menu-item index="/settings">
+  <el-icon><Setting /></el-icon>
+  <span>系统配置</span>
+</el-menu-item>
+```
+
+**页面组件结构：**
+```
+settings/index.vue
+├── el-card (header-toolbar: "系统配置" + [保存全部配置])
+├── el-card (定价配置)
+│   ├── el-form-item: 能量师种子价 → el-input-number(min=0, max=999999, step=100)
+│   ├── el-form-item: 能量师标准价 → el-input-number(...)
+│   ├── el-form-item: 种子价名额上限 → el-input-number(min=1, max=99999, step=50)
+│   └── el-form-item: C端年费 → el-input-number(...)
+├── el-card (B端佣金配置)
+│   ├── el-form-item: L1 佣金 → el-input-number
+│   ├── el-form-item: L2 佣金 → el-input-number
+│   └── 实时比例显示
+└── el-card (C端佣金配置)
+    ├── el-form-item: 直接佣金比例 → el-input-number(min=0, max=10000, step=500)
+    ├── el-form-item: 上级佣金比例 → el-input-number(min=0, max=5000, step=100)
+    └── 实时分配预览
+```
+
+**表单校验规则：**
+
+| 字段 | 校验规则 |
+|------|---------|
+| 所有金额（元） | > 0，整数，≤ 999999 |
+| 比例（%） | 0-100，整数 |
+| 名额上限 | ≥ 1，≤ 99999 |
+
+---
+
+#### 8.1.5 种子数据 SQL
+
+```sql
+INSERT INTO `sys_config` (`config_key`, `config_value`, `description`, `value_type`) VALUES
+('pricing.practitioner.seed',       '131400', '能量师种子价（分）',   'price'),
+('pricing.practitioner.standard',   '198600', '能量师标准价（分）',   'price'),
+('pricing.practitioner.seed_limit', '300',    '种子价名额上限',       'int'),
+('pricing.annual',                  '13100',  'C端年费（分）',       'price'),
+('commission.practitioner.l1',      '50000',  'B端一级佣金（分）',    'price'),
+('commission.practitioner.l2',      '10000',  'B端二级佣金（分）',    'price'),
+('commission.annual.direct_rate',   '4000',   'C端直接佣金比例（万分比）', 'percent'),
+('commission.annual.upstream_rate', '500',    'C端上级佣金比例（万分比）', 'percent');
+```
+
+---
+
+#### 8.1.6 测试用例
+
+| # | 场景 | 步骤 | 预期 |
+|---|------|------|------|
+| 1 | 初始加载 | 打开系统配置页 | 8个字段显示正确的默认值 |
+| 2 | 修改定价 | 种子价改为 ¥2,000 → 保存 | 下次 `POST /api/pricing/current` 返回 seedPrice=200000 |
+| 3 | 修改佣金 | L1 改为 ¥600 → 保存 | 新订单的佣金 amount=60000 |
+| 4 | 比例联动 | 直接佣金改为 50% | 下方显示"每笔¥131：直接¥65.50 / 上级¥6.55 / 平台¥58.95" |
+| 5 | 比例联动反向 | 种子价改为 ¥2,000 | B端卡片"L1占种子价%"从38.1%变为25.0% |
+| 6 | 输入校验 | 在金额框输入 -100 | el-input-number 阻止输入，值保持为 0 |
+| 7 | 保存失败 | 网络断开后保存 | 显示"保存失败"，输入值保留不丢失 |
+| 8 | 保存后立即生效 | 改种子价为 ¥2,000 → 保存 → 新用户打开支付页 | 显示 ¥2,000 |
+| 9 | 缓存同步 | API 直接改 DB → 调用 getInt() | 返回值仍为旧值（下次 loadAllToCache 或调用 updateConfig 后更新） |
+| 10 | 种子名额展示 | 3笔已支付 practitioner 订单 | 显示"已使用：3 / 300" |
+
+---
+
+### US-8.2 订单管理
+
+**作为** 运营管理员  
+**我希望** 查看所有订单记录，按产品类型和状态筛选  
+**以便** 核对收入和对账
+
+---
+
+#### 8.2.1 验收标准
+
+**后端 API（补全 `AdminController.listOrders()`）：**
+1. `POST /api/admin/orders` → 接收筛选参数，返回分页订单列表
+
+```json
+// Request:
+{
+  "productType": "",         // 筛选："" 全部 | "practitioner" | "annual"
+  "status": "",              // 筛选："" 全部 | "paid" | "pending"
+  "page": 1,
+  "pageSize": 20
+}
+
+// Response:
+{
+  "code": 0,
+  "data": {
+    "list": [
+      {
+        "id": 1,
+        "userId": 42,
+        "outTradeNo": "202605280001",
+        "totalFee": 131400,
+        "productType": "practitioner",
+        "isSeedPrice": true,
+        "status": "paid",
+        "payType": "wxpay",
+        "paidAt": "2026-05-28T10:00:00",
+        "createdAt": "2026-05-28T09:59:00"
+      }
+    ],
+    "total": 128,
+    "page": 1,
+    "pageSize": 20
+  }
+}
+```
+
+2. 后端在 `OrderRepository` 中新增分页+动态筛选查询方法（使用 `Specification` 或 `@Query` 动态拼接）
+
+**前端页面：**
+3. 表格列：ID、订单号、用户ID、产品类型（"能量师" / "年费"）、金额（¥格式）、种子价标记、状态（已支付/待支付）、支付时间
+4. 产品类型使用 el-tag 展示：能量师→蓝色，年费→绿色
+5. 种子价订单显示 🔥 种子 el-tag（橙色）
+6. 状态使用 el-tag：已支付→success，待支付→warning
+7. 表格上方的工具栏包含两个筛选器：
+   - 产品类型：el-select（全部 / 能量师 / C端年费）
+   - 状态：el-select（全部 / 已支付 / 待支付）
+8. 筛选器 change 时重新请求接口
+9. 底部分页组件：显示总条数，支持切换页码
+
+**当前代码待补全：**
+- `AdminController.listOrders()` 目前返回 `Result.success(null)` → 需替换为真实数据
+- `Order` 实体和 `OrderRepository` 已有，但缺 `productType` 和 `isSeedPrice` 字段 → 需新增
+- 订单表 `orders` 需增加 `product_type` 和 `is_seed_price` 列
+- 分页需引入 `Pageable` + `Specification`（或简单用 `PageRequest`）
+
+---
+
+#### 8.2.2 后端类变更
+
+| 类名 | 变更 | 说明 |
+|------|------|------|
+| `Order.java` | 新增字段 | `productType` (String)、`isSeedPrice` (Boolean) |
+| `OrderRepository` | 新增方法 | `countByProductTypeAndStatus(productType, status)` |
+| `OrderRepository` | 新增方法 | `findAll(Specification, Pageable)` 或 `findByProductTypeAndStatus` |
+| `AdminController` | 重写 `listOrders()` | 支持筛选+分页 |
+
+---
+
+### US-8.3 佣金查看
+
+**作为** 运营管理员  
+**我希望** 查看所有佣金记录和统计  
+**以便** 了解分销推广效果
+
+---
+
+#### 8.3.1 验收标准
+
+**后端 API（增强现有）：**
+1. `POST /api/admin/commissions` → 支持分页和按级别筛选
+
+```json
+// Request:
+{
+  "level": 0,       // 0: 全部 | 1: L1 | 2: L2
+  "page": 1,
+  "pageSize": 20
+}
+
+// Response:
+{
+  "code": 0,
+  "data": {
+    "list": [
+      {
+        "id": 1,
+        "orderId": 101,
+        "fromUserId": 42,
+        "toUserId": 10,
+        "level": 1,
+        "amount": 50000,
+        "status": "settled",
+        "remark": "直接推荐升级能量师",
+        "createdAt": "2026-05-28T10:00:00"
+      }
+    ],
+    "total": 56,
+    "page": 1,
+    "pageSize": 20,
+    "summary": {
+      "settledTotal": 350000,     // 已结算总佣金（分）
+      "pendingTotal": 0,          // 待结算总佣金（分，Phase 1 始终为 0）
+      "grandTotal": 350000,       // 总佣金（分）
+      "countByLevel": {           // 各级别笔数
+        "1": 12,
+        "2": 8
+      }
+    }
+  }
+}
+```
+
+2. 当前 `AdminController.listAllCommissions()` 返回 `commissionRepository.findAll()`（无分页）→ 需重写
+
+**前端页面（增强现有 `commissions/index.vue`）：**
+3. 顶部统计卡片（已有框架）→ 增强：
+   - 已结算佣金：¥3,500.00（绿色）
+   - 待结算佣金：¥0.00（黄色，Phase 1 恒为 0，保留字段显示）
+   - 总佣金：¥3,500.00
+   - **新增第四个卡片**：总笔数（L1: 12 笔 / L2: 8 笔）
+4. 表格列（增强现有）：ID、订单ID、来源用户ID、获得用户ID、级别（L1/L2 el-tag）、金额（¥格式）、备注（remark 字段）、状态、创建时间
+5. 新增级别筛选器：el-select（全部 / L1 / L2），筛选时重新请求接口
+6. 底部分页：当前 `:total="commissions.length"` 是前端假分页，改为后端真分页
+7. 备注列显示 remark 内容（如"直接推荐升级能量师"、"C端年费直接推荐佣金 (40%)"）
+
+---
+
+#### 8.3.2 前后端差距分析
+
+| 当前状态 | 目标状态 | 工作量 |
+|---------|---------|--------|
+| `AdminController.listAllCommissions()` 无分页，无筛选 | 分页 + level 筛选 + summary 统计 | M |
+| `CommissionRepository` 无分页方法 | 新增 `findAll(Specification, Pageable)` | S |
+| 前端假分页（全量拉取） | 后端真分页 | M |
+| 前端无 level 筛选 | 新增 el-select 筛选器 | S |
+| 前端无备注列 | 新增 remark 列 | S |
+| 前端无笔数统计卡片 | 新增第四个统计卡片 | S |
+
+---
+
+### US-8.4 提现管理（推迟至 Phase 2）
+
+**已决策：推迟，当前不做。**
+
+---
+
 ## 开发优先级总表
 
 | 用户故事 | 优先级 | 预估工期 | 依赖 |
 |----------|--------|---------|------|
-| US-1.1 生日输入与命盘生成 | P0 | 3天 | 无 |
+| US-1.1 生日输入与咨询发起 | P0 | 3天 | US-5.1（需登录）|
 | US-1.2 三角形可视化 | P0 | 3天 | US-1.1 |
-| US-1.3 数字点击查看含义 | P2 | 1天 | US-1.2 |
+| US-1.4 数字点击查看含义 | 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-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-3.4 AI交互问答（免费/付费控制） | P0 | 1天 | US-1.1 |
+| US-4.1 能量师付费订阅 | P0 | 2天 | US-5.1 |
+| US-4.2 种子价自动判断 | P0 | 1天 | US-8.1 |
+| US-4.3 订阅状态与续费 | 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-5.2 历史咨询记录 | P1 | 2天 | US-5.1 |
+| US-6.1 推广码生成 | P0 | 1天 | US-4.1 |
+| US-6.2 分享带参注册与上下级绑定 | P0 | 2天 | US-5.1 |
+| US-6.3 B端佣金结算 | P0 | 2天 | US-4.1 + US-6.2 + US-8.1 |
+| US-6.4 C端佣金结算 | P0 | 1天 | US-6.6 + US-6.3 + US-8.1 |
+| US-6.5 分销面板 | P1 | 2天 | US-6.1 + US-6.3 |
+| US-6.6 C端年费订阅入口 | P0 | 1.5天 | US-3.2 + US-4.1 |
 | US-7.1 批注功能 | P2 | 2天 | P0完成 |
 | US-7.2 客户分组 | P2 | 2天 | P0完成 |
+| US-8.1 系统配置管理 | **P0** | **2天** | **无（独立基础设施）** |
+| US-8.2 订单管理 | P1 | 1.5天 | US-4.1 + Order 新增字段 |
+| US-8.3 佣金查看 | P1 | 1天 | US-6.3 |
+
+---
+
+## 咨询+命盘依赖图
+
+```
+US-5.1 微信登录
+    │
+    ▼
+US-1.1 生日输入与咨询发起（后端查重(userId+birthday)→确认弹窗→后台计算→返回展示）
+    │
+    ├──► US-1.2 三角形可视化（24位置新命名 I-X）
+    ├──► US-3.4 AI交互问答（每日3轮，绑定当前命盘）
+    │
+    ▼
+US-5.2 历史咨询记录（按 userId+birthday 唯一归组，可恢复聊天历史）
+```
+
+## 分销相关依赖图
+
+```
+US-8.1 系统配置管理（独立基础设施——最先完成）
+    │
+    ├──► US-4.2 种子价判断
+    ├──► US-6.3 B端佣金（读取 L1/L2 金额）
+    └──► US-6.4 C端佣金（读取直接/上级比例）
+    
+US-5.1 微信登录
+    │
+    ▼
+US-6.2 分享带参注册（需要 openid）
+    │
+    ▼ 绑定上下级关系
+    │
+US-4.1 能量师付费 + US-6.6 C端年费订阅
+    │                              │
+    ▼                              ▼
+US-6.1 推广码生成            US-6.4 C端佣金结算
+    │                              │
+    ▼                              │
+US-6.3 B端佣金结算 ◄──────────────┘（共享 paySuccess() 分支）
+    │
+    ▼
+US-6.5 分销面板（前端展示所有数据）
+```
+
+## 排期建议
+
+| 周次 | 交付内容 |
+|------|---------|
+| **Week 1** | US-8.1 系统配置 → US-4.2 种子价 → US-4.1 能量师付费 |
+| **Week 2** | US-6.2 带参注册 → US-6.1 推广码 → US-6.3 B端佣金 |
+| **Week 3** | US-6.6 C端订阅入口 → US-6.4 C端佣金 → US-6.5 分销面板 |
+| **Week 4** | 联调测试 + 管理后台补全（US-8.2 / US-8.3）+ BUG修复 |
+
+> **Phase 1 分销核心 P0 合计：约 10天（2周）**
+> 加上命盘、AI解读、支付等已有模块联调，总计约 4周。
+
+---
 
-> **P0 合计工期：18天（3.5周）**
-> **P0+P1 合计工期：27天（5.5周）**
-> 
-> 佣金分成带来裂变增长——每个能量师都成为推广员，获客成本从 ¥50+ 降至 佣金比例（¥119.4/成功转化）。
-> 分销是 Phase 1 增长的引擎，不要砍。
+## 附录A：【新计算规则】代码文件变更清单
+
+> 以下清单基于新命名体系（A-X）和咨询会话管理需求，列出所有需修改的代码文件及变更内容。
+
+### A.1 后端 Java
+
+| 文件 | 变更类型 | 变更内容 |
+|------|---------|---------|
+| `CalculatorService.java` | 重写 | 内部7位从 `F,G,H,I,M,N,O` → `I,J,K,L,M,N,O`；新增外部9位 `P,Q,R,S,T,U,V,W,X` 的独立计算；新增 `calculateFullTriangle()` 返回全部24个位置 |
+| `ChartService.java` | 改造 | 新增 `startConsultation(userId, birthday, name, questions)` 方法，含：①查 userId+birthday 是否已有记录；②已有则直接返回+聊天历史；③无则服务器端调 `CalculatorService` 计算+创建记录+可选首次AI解读 |
+| `ChartController.java` | 改造 | 保留 `/api/chart/create`（兼容旧版）；新增 `POST /api/chart/start` → 调 `startConsultation()` |
+| `ChartRecord.java` | 微调 | 新增 `lastInteractionAt` 字段（`LocalDateTime`，用于列表排序）；加 `@Table(uniqueConstraints=...)` 定义 `(userId, birthday)` 联合唯一 |
+| `ChartRecordRepository.java` | 新增 | `Optional<ChartRecord> findByUserIdAndBirthday(Long userId, String birthday)` |
+| `UserService.java` | 微调 | `checkDailyQuota()` 和 `consumeQuota()` 已有逻辑不变（3次/天全局计数），但新增注释明确"非VIP每日3次绑定当前命盘，切换生日不重置" |
+| `ProfileController.java` | 微调 | 咨询列表接口按 `lastInteractionAt` 倒序 |
+
+### A.2 前端 Vue / JS
+
+| 文件 | 变更类型 | 变更内容 |
+|------|---------|---------|
+| `client/utils/calculator.js` | 废弃/降级 | `calculateTriangle()` 保留为离线兜底，不再作为主路径调用；内部命名改为 `I,J,K,L,M,N,O`；新增 `calculateFullTriangle()` 含外部 P-X；主入口加注释 `@deprecated 请使用后端计算` |
+| `client/stores/chart.js` | 改造 | `computeChart()` 不再调 `calculateTriangle()`，改为调 `consultationApi.start()`；返回数据中的 `positions` 直接写入 `currentChart`；不再调 `analyzeTriangle()`（由后端返回） |
+| `client/components/TriangleChart.vue` | 重写 matrix() | `innerBottom` 从 `[d.F,d.G,d.H,d.I]` → `[d.I,d.J,d.K,d.L]`；`outerLeft` 从 `{main:d.M, sub:[d.F,d.G]}` → `{main:d.R, sub:[d.P,d.Q]}`；`outerRight` 从 `{main:d.N, sub:[d.H,d.I]}` → `{main:d.U, sub:[d.S,d.T]}`；`outerTop` 从 `{main:d.O, sub:[d.M,d.N]}` → `{main:d.X, sub:[d.V,d.W]}` |
+| `client/pages/index/index.vue` | 改造 | `onAnalyze()` 改为：①调 `POST /api/chart/start`（传 birthday + name + questions）；②若返回 `isNew=true` 且 `requireConfirmation=true` 则弹确认框；③确认后再次请求；④成功后跳转 `chart/index`；⑤"想了解的问题"加 `maxlength=100` + 实时字数显示 |
+| `client/utils/api.js` | 新增 | `consultationApi`：`start(data)` → `POST /api/chart/start`；`detail(id)` → `POST /api/chart/detail` |
+| `client/pages/chart/index.vue` | 微调 | 适配新的 API 返回结构（`chartData.positions` 含全部 I-X）；`onMounted` 加载历史消息逻辑不变 |
+| `client/pages/records/index.vue` | 微调 | 列表按 `lastInteractionAt` 排序；详情页恢复聊天历史逻辑不变 |
+
+### A.3 数据库
+
+| 变更 | 说明 |
+|------|------|
+| `chart_records` 表加联合唯一索引 | `UNIQUE INDEX uk_user_birthday (user_id, birthday)`，确保同用户+同生日只有一条咨询记录 |
+| `chart_records` 表加字段 | `last_interaction_at DATETIME`，默认等于 `created_at`，每次 AI 聊天时更新，用于列表排序 |
+| `chart_records` 表现有字段 | `chart_data` 列存储的 JSON 结构从 7个旧位置 → 16个新位置（内部 I-O + 外部 P-X） |
+
+### A.4 变更执行顺序
+
+```
+Step 1: US-1.3（本对照表）→ 开发团队通读，确保理解命名对应关系
+Step 2: 数据库迁移 → 加索引+字段
+Step 3: CalculatorService.java → 重写为新命名+外部计算
+Step 4: ChartService.java + ChartController.java → 新增 startConsultation()
+Step 5: stores/chart.js + api.js → 前端调后端新接口
+Step 6: TriangleChart.vue → matrix() 改用新命名+独立外部值
+Step 7: pages/index/index.vue → 确认弹窗 + 100字限制
+Step 8: 联调 → 前后端打通 end-to-end
+```

docs/requirements-changelog.md

@@ -0,0 +1,97 @@
+# 需求版本变更日志
+
+> 每次需求变更在此追加新版本，版本号格式: `vYYYYMMDD.N`（如 v20260529.1）
+> 已发布的版本不可修改，只可新增。
+
+---
+
+## v20260529.1（当前版本）
+
+**发布日期：** 2026-05-29  
+**变更类型：** 初始版本  
+**状态：** ✅ 已确认
+
+### 版本摘要
+
+数字能量学智能体 Phase 1 完整需求规格，涵盖命盘生成、AI 解读、付费订阅、分销佣金、管理后台、前端样式指南及命盘算法命名约定。
+
+### 包含文档
+
+| 文档 | 说明 |
+|------|------|
+| `docs/phase1-user-stories.md` | 25个用户故事，含验收标准、优先级、排期、依赖图 |
+| `docs/style-guide.md` | 前端样式指南（品牌色/字体/组件/动效/微信专项） |
+| `docs/distribution-model.md` | 分销模式设计方案 |
+| `docs/system-spec.md` | 系统需求规格说明书 |
+| `docs/phase1-product-plan.md` | Phase 1 产品规划 |
+| `docs/1.0产品对齐方案.md` | 定价模型B的完整方案 |
+| `docs/requirements-changelog.md` | 本文件，版本变更日志 |
+
+### 已确认的关键决策
+
+| 决策 | 内容 |
+|------|------|
+| 定价模型 | **模型B**：能量师种子价 ¥1,314 / 标准价 ¥1,986，均后台可配 |
+| C端年费 | ¥131，入 Phase 1，含分销 |
+| 种子价规则 | 按付费时间判定，前 300 人享受 |
+| B端佣金 | 固定金额 ¥500（一级）/ ¥100（二级） |
+| C端佣金 | 比例 40%（直接）/ 5%（上级） |
+| 提现管理 | 推迟至 Phase 2 |
+| C端订阅入口 | 命盘解读页底部 |
+| 命盘计算 | 从 `calculator.js` 前端迁移到后端 `CalculatorService.java` |
+| 咨询会话 | 按 `(userId, birthday)` 联合唯一索引，同用户+同生日始终返回同一条记录 |
+| 新生日弹窗 | "此生日将开启全新的命盘咨询，确认吗？" |
+| 每日互动限制 | 非付费用户 3 轮/天，全局计数器，绑定当前命盘 |
+| 咨询字数限制 | "想了解的问题"输入框限 100 字 |
+| 命盘位置命名 | A-H（输入层）+ I-X（7内部+15外部）= 30个位置 |
+| 外部公式 | P=reduce(I+M), Q=reduce(J+M), R=reduce(P+Q); S=reduce(K+N), T=reduce(L+N), U=reduce(S+T); V=reduce(M+O), W=reduce(N+O), X=reduce(V+W) |
+| 外部年龄映射 | 左=21-40岁, 顶=41-60岁, 右=61+岁 |
+
+### 已知问题 / 待办
+
+- 当前代码外侧三组计算为内部数字的"重复展示"，需改为上述独立计算公式
+- 佣金状态流转 BUG：`pending` → `settled` 断链，需重写
+- 推广码由注册时生成改为付费后生成
+- 云函数目录已删除，仅 Java 后端有效
+
+### 文档版本记录
+
+| 日期 | 变更 | 涉及文件 |
+|------|------|---------|
+| 2026-05-29 | 初始版本 v1 | 全部文档 |
+| 2026-05-29 | US-1.1 重写为咨询发起流程，新增100字限制、userId+birthday查重、确认弹窗 | `phase1-user-stories.md` |
+| 2026-05-29 | US-1.2 三角布局从旧命名(F,G,H,I)更新为新命名(I,J,K,L) | `phase1-user-stories.md` |
+| 2026-05-29 | 新增 US-1.3 完整位置命名与计算规则对照表（A-X） | `phase1-user-stories.md` |
+| 2026-05-29 | 新增 US-3.4 AI交互问答免费/付费控制 | `phase1-user-stories.md` |
+| 2026-05-29 | US-5.2 改为历史咨询记录，按 userId+birthday 归组 | `phase1-user-stories.md` |
+| 2026-05-29 | 新增 **附录A**：新计算规则代码文件变更清单（后端/前端/数据库/执行顺序） | `phase1-user-stories.md` |
+
+---
+
+## 未来版本模板
+
+```
+## vYYYYMMDD.N（下版本）
+
+**发布日期：** YYYY-MM-DD  
+**变更类型：** 新增 / 修改 / 废弃  
+**状态：** 草稿 / 已确认
+
+### 变更清单
+
+| 变更项 | 变更前 | 变更后 | 理由 |
+|--------|--------|--------|------|
+| xxx | xxx | xxx | xxx |
+
+### 影响范围
+
+- 变更涉及的用户故事：US-x.x
+- 变更涉及的后端文件：xxx
+- 变更涉及的前端文件：xxx
+
+### 迁移说明
+
+需要执行的迁移步骤：
+1. ...
+2. ...
+```

docs/style-guide.md

@@ -0,0 +1,820 @@
+# 数字能量学 AI 智能体 — 前端样式指南
+
+> 适用于 UniApp (Vue 3) 微信小程序前端
+> 对齐 `design-taste-frontend` 参数：DESIGN_VARIANCE=8 / MOTION_INTENSITY=6 / VISUAL_DENSITY=4
+
+---
+
+## 一、品牌定位
+
+**数码能量学** — 用数字能量学 + AI 解读，帮助用户了解自己的命盘。
+
+| 维度 | 描述 |
+|------|------|
+| **调性** | 神秘、专业、可信赖、不过度玄学 |
+| **视觉关键词** | 深邃/金/墨蓝/卡片质感/呼吸感留白/微动效 |
+| **目标用户** | 25-45岁，对数字能量学感兴趣，寻求职业/财运/感情指导 |
+| **竞品差异** | 专业度（vs 娱乐命理类）+ AI 深度（vs 传统手绘） |
+
+---
+
+## 二、色彩系统
+
+### 2.1 主色调
+
+| 色名 | 色值 | 用途 | 说明 |
+|------|------|------|------|
+| **墨蓝** | `#1E3A5F` | 品牌主色（深蓝） | 导航栏、标题、品牌背景 |
+| **暗金** | `#C9A84C` | 品牌点缀（金色） | 数字能量主题色、VIP标记、CTA强调 |
+| **矿白** | `#F8F6F1` | 页面背景（暖白） | 所有页面的主背景色 |
+| **纯白** | `#FFFFFF` | 卡片背景 | 所有卡片容器的底色 |
+
+### 2.2 辅助色
+
+| 色名 | 色值 | 用途 |
+|------|------|------|
+| 翡翠绿 | `#2D8B67` | 成功、已支付、已结算 |
+| 琥珀黄 | `#D4A017` | 警告、待支付、种子价标记 |
+| 珊瑚红 | `#D94A4A` | 错误、已过期、删除操作 |
+| 冰川蓝 | `#4A90D9` | 链接、跳转、次要CTA |
+
+### 2.3 中性色
+
+| 色名 | 色值 | 用途 |
+|------|------|------|
+| 墨黑 | `#1A1A2E` | 主文字 |
+| 石板灰 | `#4A5568` | 次文字、描述 |
+| 银灰 | `#A0AEC0` | 占位符、禁用态 |
+| 雾白 | `#E2E8F0` | 分割线、边框 |
+| 骨白 | `#F7F4EF` | 卡片背景（次） |
+
+### 2.4 命盘数字色
+
+```
+1（创造/自主）:  #D94A4A  · 赤红
+2（合作/平衡）:  #4A90D9  · 冰蓝
+3（表达/创意）:  #E8A238  · 琥珀
+4（稳定/规则）:  #2D8B67  · 翡翠
+5（自由/变化）:  #D4A017  · 金
+6（关怀/责任）:  #7B6FA0  · 紫灰
+7（分析/灵性）:  #4A6FA5  · 靛蓝
+8（权力/财富）:  #C9A84C  · 暗金
+9（智慧/完成）:  #B85C3A  · 铜橙
+```
+
+### 2.5 色值使用约束
+
+- **禁止 #000000**：文字使用 `#1A1A2E` 而非纯黑
+- **禁止饱和色大面积使用**：主色墨蓝饱和度已控制，避免视觉疲劳
+- **AI 蓝紫禁令**：不使用标准 AI 产品的蓝紫色渐变（与竞品拉开差异）
+
+---
+
+## 三、字体系统
+
+### 3.1 字族
+
+微信小程序仅支持系统字体，无法自定义引入 web font：
+
+```scss
+// 中文
+font-family: -apple-system, BlinkMacSystemFont, 'PingFang SC', 'Helvetica Neue',
+             'Noto Sans CJK SC', 'Microsoft YaHei', sans-serif;
+
+// 数字（命盘数据场景）
+font-family: 'Georgia', 'Times New Roman', serif;
+/* 命盘中的关键数字使用衬线字体，与 UI 文字形成对比，强调"数字"的庄重感 */
+
+
+```
+
+### 3.2 字号层级
+
+| 层级 | 字号 | 字重 | 行高 | 场景 |
+|------|------|------|------|------|
+| **H1** | 24px | 700 | 1.3 | 页面标题、命盘页主数字 |
+| **H2** | 20px | 700 | 1.4 | 卡片标题、模態標題 |
+| **H3** | 18px | 600 | 1.4 | 区块小标题 |
+| **Body** | 15px | 400 | 1.6 | 正文、解读内容 |
+| **Caption** | 13px | 400 | 1.4 | 辅助文字、标签 |
+| **Micro** | 11px | 400 | 1.3 | 角标、时间戳 |
+
+### 3.3 字号规范
+
+- **最小可读字号**：11px（角标场景），正文不低于 15px
+- **按钮文字**：16px（主按钮）、14px（次按钮）
+- **弹窗标题**：18px bold
+- **金额数字**：使用 700 字重，字体加宽强调
+
+---
+
+## 四、间距与布局
+
+### 4.1 基准间距
+
+```scss
+$space-xxs: 4px;
+$space-xs:  8px;
+$space-sm:  12px;
+$space-md:  16px;
+$space-lg:  24px;
+$space-xl:  32px;
+$space-2xl: 48px;
+```
+
+### 4.2 页面布局规范
+
+```
+┌─────────────────────┐
+│  NavBar（原生）      │  44px（微信原生）
+├─────────────────────┤
+│                     │
+│  内容区域            │  padding: 0 $space-md
+│  ┌───────────────┐  │
+│  │  卡片 1        │  │  margin-bottom: $space-md
+│  │               │  │
+│  └───────────────┘  │
+│  ┌───────────────┐  │
+│  │  卡片 2        │  │
+│  └───────────────┘  │
+│                     │
+├─────────────────────┤
+│  TabBar（原生）      │  50px（微信原生）
+└─────────────────────┘
+```
+
+### 4.3 卡片规范
+
+| 属性 | 值 |
+|------|-----|
+| 背景色 | `#FFFFFF` |
+| 圆角 | `16px`（大卡片）/ `12px`（小卡片） |
+| 内边距 | `20px`（上下）/ `16px`（左右） |
+| 阴影 | `0 2px 12px rgba(26, 26, 46, 0.06)` — 扩散阴影，轻盈 |
+| 边框 | 无边框，仅通过阴影和背景分离 |
+
+**卡片容器标准 CSS：**
+```scss
+.card {
+  background: #FFFFFF;
+  border-radius: 16px;
+  padding: 20px 16px;
+  margin-bottom: 16px;
+  box-shadow: 0 2px 12px rgba(26, 26, 46, 0.06);
+}
+```
+
+### 4.4 布局模式
+
+根据 DESIGN_VARIANCE = 8，优先使用非对称布局：
+
+- **首页**：输入区域居中（强引导），结果预览区错开排列
+- **命盘页**：三角图居中，AI 解读区左对齐，订阅入口通栏
+- **分销面板**：顶部统计三列等宽，下方列表通栏（数据密集型简化）
+- **个人中心**：头像居中，下方功能列表通栏
+
+---
+
+## 五、组件视觉规范
+
+### 5.1 按钮
+
+| 类型 | 背景 | 文字 | 圆角 | 高度 | 场景 |
+|------|------|------|------|------|------|
+| **主按钮** | `#1E3A5F` | `#FFFFFF` | `12px` | `48px` | 支付、开通、保存 |
+| **行动按钮** | `#C9A84C` | `#FFFFFF` | `12px` | `44px` | 生成命盘、立即推广 |
+| **次要按钮** | `#FFFFFF` + 1px `#E2E8F0` 边框 | `#1A1A2E` | `10px` | `40px` | 取消、返回 |
+| **文字按钮** | 透明 | `#4A90D9` | — | `auto` | 链接、跳转 |
+
+**交互反馈：**
+```scss
+button:active {
+  transform: scale(0.97);
+  opacity: 0.9;
+}
+```
+
+所有按钮的 `:active` 状态必须有视觉反馈（缩小 + 透明度变化），模拟物理按压感。
+
+**禁用态：**
+```scss
+button[disabled] {
+  opacity: 0.5;
+  pointer-events: none;
+}
+```
+
+### 5.2 输入框
+
+```
+┌─────────────────────────┐
+│  姓名（选填）              │  label(14px, #4A5568)
+│  ┌─────────────────────┐ │
+│  │ 请输入姓名           │ │  input(16px, 44px height)
+│  └─────────────────────┘ │  8px border-radius, 1px #E2E8F0 border
+│                          │
+│  出生年份                  │
+│  ┌─────────────────────┐ │
+│  │ 例如 1990           │ │
+│  └─────────────────────┘ │
+│                          │
+│  月份        日期          │  水平并排
+│  ┌─────────┐ ┌─────────┐│
+│  │ 1-12    │ │ 1-31    ││
+│  └─────────┘ └─────────┘│
+└─────────────────────────┘
+```
+
+**焦点态：** `border-color: #1E3A5F` + `box-shadow: 0 0 0 2px rgba(30, 58, 95, 0.1)`
+**错误态：** `border-color: #D94A4A` + 底部红色提示文字
+
+### 5.3 标签（Tag）
+
+| 类型 | 背景 | 文字 | 场景 |
+|------|------|------|------|
+| 成功 | `#E6F7EE` | `#2D8B67` | 已结算、已支付 |
+| 警告 | `#FFF8E6` | `#D4A017` | 待支付、种子价 |
+| 信息 | `#EBF2FA` | `#4A90D9` | L1 佣金 |
+| 次要 | `#F0EEEA` | `#7B6FA0` | L2 佣金 |
+| 金牌 | `#FFF6E0` + `#C9A84C` border | `#8B6914` | VIP、能量师 |
+
+**圆角：** `6px`，内边距 `4px 10px`，字号 `12px`
+
+### 5.4 状态指示
+
+- **加载态**：原生页面级 loading + 区块骨架屏（灰色渐变脉冲动画）
+- **空数据态**：居中灰色图标 + 14px 灰文字提示 + 引导操作按钮
+- **错误态**：内联红色提示（输入错误）/ 页面级错误重试按钮（网络错误）
+- **成功态**：`uni.showToast` success 图标 + 文字
+
+### 5.5 骨架屏规范
+
+```scss
+@keyframes shimmer {
+  0% { background-position: -200px 0; }
+  100% { background-position: 200px 0; }
+}
+
+.skeleton {
+  background: linear-gradient(90deg, #F0EEEA 25%, #F8F6F1 50%, #F0EEEA 75%);
+  background-size: 400px 100%;
+  animation: shimmer 1.5s ease-in-out infinite;
+  border-radius: 8px;
+}
+```
+
+骨架片尺寸匹配实际内容区域（不额外创建包装盒）。
+
+---
+
+## 六、各页面视觉设计
+
+### 6.1 首页 — 信息输入
+
+```
+┌─────────────────────┐
+│  数码能量学           │  NavBar（品牌色 #1E3A5F，白色文字）
+├─────────────────────┤
+│                     │
+│  ┌───────────────┐  │
+│  │               │  │
+│  │  🔮 输入出生   │  │  中心卡片（背景白，最大宽度）
+│  │  信息          │  │
+│  │               │  │
+│  │  姓名（选填）    │  │
+│  │  ┌─────────┐   │  │
+│  │  │         │   │  │
+│  │  └─────────┘   │  │
+│  │  出生年月日     │  │
+│  │  ┌──┐ ┌──┐    │  │
+│  │  │年│ │月│ │日│  │  │
+│  │  └──┘ └──┘    │  │
+│  │               │  │
+│  │  ┌─────────┐  │  │
+│  │  │ 生成命盘  │  │  行动按钮（金色）
+│  │  └─────────┘  │  │
+│  └───────────────┘  │
+│                     │
+│  ┌───────────────┐  │
+│  │  ✦ 功能介绍    │  │  轻量卡片，展示 3 个功能点
+│  │  命盘/AI/分享  │  │  水平排列，图标+文字
+│  └───────────────┘  │
+│                     │
+├─────────────────────┤
+│  首页│命盘│AI│我的   │  TabBar
+└─────────────────────┘
+```
+
+**设计要点：**
+- NavBar 使用墨蓝底色，标题白色，返回箭头白色
+- 输入卡片置中，四周留呼吸空间
+- 功能引导卡片使用浅灰色圆角图标 + 文字
+- 生成命盘按钮使用金色 `#C9A84C`，与品牌名呼应
+
+### 6.2 命盘解读页
+
+```
+┌─────────────────────┐
+│  ← 数字能量命盘      │  NavBar（透明背景，白色返回箭头）
+├─────────────────────┤
+│  ┌───────────────┐  │
+│  │      O        │  │
+│  │    J   K      │  │  三角图（Canvas居中）
+│  │  F  G  H  I   │  │  圆角数字卡片，按类型着色
+│  │ A B C D E     │  │
+│  └───────────────┘  │
+│  姓名：张三           │
+│  1990-01-15          │  灰色小字
+│                     │
+│  ─── 数字说明 ───    │
+│  主性格 7：分析洞察    │  可折叠解释区域
+│  1号位：独立          │
+│                     │
+│  ┌───────────────┐  │
+│  │  AI 解读       │  │
+│  │  ┌─────────┐  │  │  AI 消息气泡
+│  │  │ AI文字...│  │  │  白色气泡（AI）/ 蓝色气泡（用户）
+│  │  └─────────┘  │  │
+│  │  [职业] [财运] │  │  快速提问芯片
+│  │  ┌─────┐ [发]│  │  输入框 + 发送按钮
+│  │  │输入..│     │  │
+│  │  └─────┘     │  │
+│  └───────────────┘  │
+│                     │
+│  ═══════════════════ │  虚线分隔
+│                     │
+│  ┌───────────────┐  │
+│  │  🔮 AI解读会员  │  │  订阅引导卡片（未付费可见）
+│  │  ¥131/年       │  │
+│  │  解锁完整分析    │  │
+│  │  ┌─────────┐  │  │
+│  │  │ 立即开通  │  │  │  金色按钮
+│  │  └─────────┘  │  │
+│  └───────────────┘  │
+│                     │
+│  ─── 数字点击弹窗 ─── │
+│  ┌─────────────────┐│
+│  │    7            ││  底部弹出面板
+│  │  主性格          ││  圆角顶部，毛玻璃效果
+│  │  分析洞察、...   ││
+│  │  ─────────────  ││
+│  │  1号位：独立自主  ││
+│  └─────────────────┘│
+├─────────────────────┤
+│  首页│命盘│AI│我的   │
+└─────────────────────┘
+```
+
+**设计要点：**
+- 三角图区域上下留白，不紧贴文字
+- AI 解读采用微信消息气泡样式（白色 vs 蓝色）
+- 快速提问芯片使用 `#EBF2FA` 背景 + `#1E3A5F` 文字
+- 底部订阅卡片与 AI 区域用虚线分隔
+- 数字点击弹窗从底部上滑，顶部圆角 20px
+
+### 6.3 AI 解读页
+
+```
+┌─────────────────────┐
+│  AI 命盘解读         │
+├─────────────────────┤
+│                     │
+│  ┌───────────────┐  │
+│  │  主性格        │  │  章节卡片
+│  │  7 · 分析洞察  │  │  标题金色小方块标记
+│  │  ...          │  │  正文 15px，行高 1.8
+│  └───────────────┘  │
+│                     │
+│  ┌───────────────┐  │
+│  │  左区（0-20岁） │  │  可折叠
+│  │  ...          │  │  展开/收起箭头
+│  └───────────────┘  │
+│                     │
+│  ┌───────────────┐  │
+│  │  中区（20-40岁） │  │
+│  └───────────────┘  │
+│                     │
+│  本解读由 AI 生成，    │  免责声明（11px 灰色居中）
+│  仅供参考             │
+│                     │
+│  ┌───────────────┐  │
+│  │  ¥131 开通完整   │  │  固定底部（未付费）
+│  │  解读           │  │  金色渐变
+│  └───────────────┘  │
+│                     │
+├─────────────────────┤
+│  TabBar              │
+└─────────────────────┘
+```
+
+**设计要点：**
+- 每章节为一个独立的白色卡片，用阴影分隔
+- 章节标题左侧有 3px 宽的 `#C9A84C` 色条（`border-left: 3px solid #C9A84C`）
+- 可折叠章节默认展开第一个，其余折叠
+- 免费用户底部固定一个金色渐变条
+
+### 6.4 分销面板
+
+```
+┌─────────────────────┐
+│  分销中心          ← │
+├─────────────────────┤
+│                     │
+│  ┌───────────────┐  │
+│  │ 我的推广码      │  │  推广码卡片
+│  │ ABC123   [复制] │  │  码用 18px 等宽字体
+│  │ [生成推广海报 →] │  │
+│  └───────────────┘  │
+│                     │
+│  ┌─────┐┌─────┐┌─────┤
+│  │总收益││可提现││今日  │  三列等宽统计卡片
+│  │¥500 ││¥500 ││¥0   │  数字墨黑，标签银灰
+│  └─────┘└─────┘└─────┘
+│                     │
+│  团队统计              │  标题(14px, #4A5568)
+│  直接 5   间接 12  升级 3│  三列数字(24px bold) + 标签
+│                     │
+│  ┌───────────────┐  │
+│  │ 佣金明细       │  │
+│  │ 05-28 用户**** │  │
+│  │    L1    +¥500 │  │  L1蓝标签，金额绿色
+│  │ 05-27 用户**** │  │
+│  │    L2    +¥100 │  │  L2紫标签
+│  └───────────────┘  │
+│                     │
+│  ┌───────────────┐  │
+│  │ 📱 生成推广海报  │  │  按钮列表（通栏）
+│  │ 🔗 复制推广链接  │  │  左边图标+文字，右边箭头
+│  │ 📊 提现(即将开放) │  │  置灰不可点
+│  └───────────────┘  │
+│                     │
+├─────────────────────┤
+│  TabBar              │
+└─────────────────────┘
+```
+
+**设计要点：**
+- 推广码使用等宽字体（`font-family: monospace`），与 UI 文字区分
+- 统计数字使用 28px 700 字重，突出数据
+- 佣金列表每项用 1px `#E2E8F0` 分割线分隔
+- L1 标签蓝色，L2 标签紫色，与佣金等级对应
+
+### 6.5 个人中心
+
+```
+┌─────────────────────┐
+│  我的                │
+├─────────────────────┤
+│                     │
+│  ┌───────────────┐  │
+│  │   (头像)       │  │  用户卡片(居中)
+│  │   张三          │  │  16px bold
+│  │   🔮 能量师会员  │  │  金色VIP标记
+│  │   有效期至...    │  │
+│  └───────────────┘  │
+│                     │
+│  ┌───────────────┐  │
+│  │  📋 我的分析    ›│  │  功能菜单列表
+│  │  💰 我的推广    ›│  │  仅能量师可见
+│  │  ℹ️ 关于我们    ›│  │
+│  └───────────────┘  │
+│                     │
+│  ┌───────────────┐  │
+│  │  退出登录       │  │  红色文字
+│  └───────────────┘  │
+│                     │
+├─────────────────────┤
+│  TabBar              │
+└─────────────────────┘
+```
+
+**设计要点：**
+- 头像使用大圆角（50%），带 2px `#C9A84C` 边框（VIP 用户）
+- 功能菜单每个 item 使用 1px 底部分割线
+- 右侧箭头 `#A0AEC0`
+- VIP 标记使用 `#FFF6E0` 背景 + `#C9A84C` 文字
+
+---
+
+## 七、交互动效规范
+
+### 7.1 通用动效
+
+| 场景 | 动效 | 持续时间 | 曲线 |
+|------|------|---------|------|
+| 页面跳转 | 微信原生 Slide | 300ms | 默认 |
+| 按钮按压 | `scale(0.97)` | 100ms | ease-out |
+| 弹窗出现 | 底部上滑 + 背景淡入 | 300ms | `cubic-bezier(0.16, 1, 0.3, 1)` |
+| 弹窗关闭 | 下滑 + 背景淡出 | 250ms | ease-in |
+| Tag 出现 | `scale(0.8→1)` + 淡入 | 200ms | spring(80, 12) |
+| 数字变化 | 计数器从旧值滚动到新值 | 400ms | ease-out |
+| 骨架屏 | 灰色渐变位移 | 1.5s infinite | ease-in-out |
+
+### 7.2 页面过渡
+
+```
+进入: translateX(100%) → 0    300ms  ease-out
+退出: 0 → translateX(30%) + 淡出  250ms  ease-in
+```
+
+UniApp 通过 `pages.json` 配置：
+
+```json
+{
+  "globalStyle": {
+    "navigationBarTitleText": "数字能量学",
+    "navigationBarBackgroundColor": "#1E3A5F",
+    "navigationBarTextStyle": "white",
+    "backgroundColor": "#F8F6F1",
+    "app-plus": {
+      "animation": {
+        "duration": 300,
+        "type": "slide-in-right"
+      }
+    }
+  }
+}
+```
+
+### 7.3 微交互
+
+- **数字复制**：点击复制按钮 → 按钮短暂显示"已复制" + 绿色闪烁
+- **支付成功**：Toast 后 1.5s 自动跳转
+- **下拉刷新**：微信原生下拉刷新，加载完成震动反馈
+- **空数据点击**：点击空数据区域 → 提示跳转引导
+- **佣金列表加载**：列表项依次淡入（`animation-delay` 级联）
+
+---
+
+## 八、微信小程序专项规范
+
+### 8.1 NavBar（导航栏）
+
+由于微信小程序不支持自定义 NavBar（非侵入式），统一使用原生的 `navigationBar`：
+
+```json
+{
+  "globalStyle": {
+    "navigationBarBackgroundColor": "#1E3A5F",
+    "navigationBarTextStyle": "white",
+    "navigationBarTitleText": "数码能量学"
+  }
+}
+```
+
+| 页面 | 标题 | 背景色 | 文字色 |
+|------|------|--------|--------|
+| 首页 | 数码能量学 | `#1E3A5F` | white |
+| 命盘解读 | 数字能量命盘 | `#1E3A5F` | white |
+| AI解读 | AI 命盘解读 | 透明（自定义头） | — |
+| 分销面板 | 分销中心 | `#1E3A5F` | white |
+| 个人中心 | 我的 | `#1E3A5F` | white |
+| 支付页 | 确认支付 | `#1E3A5F` | white |
+
+### 8.2 TabBar（标签栏）
+
+```json
+{
+  "tabBar": {
+    "color": "#A0AEC0",
+    "selectedColor": "#1E3A5F",
+    "backgroundColor": "#FFFFFF",
+    "borderStyle": "white",
+    "list": [
+      { "pagePath": "pages/index/index", "text": "首页", "iconPath": "static/tab/home.png", "selectedIconPath": "static/tab/home-active.png" },
+      { "pagePath": "pages/chart/index", "text": "命盘", "iconPath": "static/tab/chart.png", "selectedIconPath": "static/tab/chart-active.png" },
+      { "pagePath": "pages/records/index", "text": "分析", "iconPath": "static/tab/records.png", "selectedIconPath": "static/tab/records-active.png" },
+      { "pagePath": "pages/profile/index", "text": "我的", "iconPath": "static/tab/profile.png", "selectedIconPath": "static/tab/profile-active.png" }
+    ]
+  }
+}
+```
+
+### 8.3 触摸区域
+
+- **最小可点击区域**：`44px × 44px`（微信官方推荐）
+- **列表项**：高度至少 `48px`
+- **底部按钮**：固定到页面底部时，距离底边 `34px`（适配 Home Indicator）
+- **弹窗关闭**：点击弹窗外部灰色遮罩层关闭
+
+### 8.4 安全区域适配
+
+```scss
+// 使用 WeChat CSS 变量适配刘海屏 / Home Indicator
+.safe-area-bottom {
+  padding-bottom: constant(safe-area-inset-bottom); // iOS 11.0-11.2
+  padding-bottom: env(safe-area-inset-bottom);       // iOS 11.2+
+}
+
+// 底部固定按钮
+.fixed-bottom {
+  position: fixed;
+  bottom: 0;
+  left: 0;
+  right: 0;
+  padding: 16px;
+  padding-bottom: calc(16px + constant(safe-area-inset-bottom));
+  padding-bottom: calc(16px + env(safe-area-inset-bottom));
+  background: #FFFFFF;
+}
+```
+
+---
+
+## 九、组件库（参考实现）
+
+### Button.vue — 按钮组件
+
+```vue
+<template>
+  <button
+    class="btn"
+    :class="[`btn--${type}`, `btn--${size}`, { 'btn--block': block, 'btn--disabled': disabled }]"
+    :disabled="disabled"
+    @click="$emit('click', $event)"
+  >
+    <slot />
+  </button>
+</template>
+
+<style scoped lang="scss">
+.btn {
+  border: none;
+  border-radius: 12px;
+  font-size: 16px;
+  font-weight: 600;
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  cursor: pointer;
+  transition: all 0.2s ease;
+
+  &:active {
+    transform: scale(0.97);
+    opacity: 0.9;
+  }
+
+  &--primary {
+    background: #1E3A5F;
+    color: #FFFFFF;
+    height: 48px;
+    padding: 0 24px;
+  }
+
+  &--gold {
+    background: #C9A84C;
+    color: #FFFFFF;
+    height: 44px;
+    padding: 0 20px;
+  }
+
+  &--outline {
+    background: #FFFFFF;
+    border: 1px solid #E2E8F0;
+    color: #1A1A2E;
+    height: 40px;
+  }
+
+  &--text {
+    background: transparent;
+    color: #4A90D9;
+    height: auto;
+    padding: 0;
+  }
+
+  &--block {
+    width: 100%;
+  }
+
+  &--large { height: 48px; font-size: 16px; }
+  &--medium { height: 44px; font-size: 15px; border-radius: 10px; }
+  &--small { height: 36px; font-size: 13px; border-radius: 8px; padding: 0 16px; }
+
+  &--disabled {
+    opacity: 0.5;
+    pointer-events: none;
+  }
+}
+</style>
+```
+
+---
+
+## 十、图片与图标
+
+### 10.1 命盘分享海报
+
+- **尺寸**：`750px × 1000px`（微信分享卡片标准）
+- **背景**：深蓝到墨蓝渐变 `linear-gradient(135deg, #1E3A5F, #162A45)`
+- **内容**：命盘三角图（金色线框）+ 用户昵称 + 出生日期 + 品牌 Logo + 小程序码
+- **文案**：底部"扫码查看你的数字命盘"
+
+### 10.2 推广海报
+
+- **尺寸**：`750px × 1334px`（朋友圈长图）
+- **背景**：金色到深蓝渐变 `linear-gradient(180deg, #C9A84C 0%, #1E3A5F 100%)`
+- **内容**：用户头像 + 昵称 + 推广码 + 小程序码 + "扫码免费测命盘"
+
+### 10.3 TabBar 图标
+
+- **格式**：PNG，`48px × 48px`（iOS）/ `54px × 54px`（Android）
+- **风格**：线性图标，2px 描边，圆角
+- **选中态**：填充 + 品牌色 `#1E3A5F`
+- **未选中**：线性 + 灰色 `#A0AEC0`
+
+---
+
+## 十一、现有的 uni.scss 变量更新
+
+```scss
+/* ========================================
+   数字能量学 AI 智能体 — SCSS 变量文件
+   覆盖 uni.scss
+   ======================================== */
+
+/* —— 品牌色 —— */
+$brand-dark:    #1E3A5F;
+$brand-gold:    #C9A84C;
+$brand-offwhite:#F8F6F1;
+
+/* —— 功能色 —— */
+$color-success: #2D8B67;
+$color-warning: #D4A017;
+$color-danger:  #D94A4A;
+$color-link:    #4A90D9;
+
+/* —— 中性色 —— */
+$text-primary:   #1A1A2E;
+$text-secondary: #4A5568;
+$text-tertiary:  #A0AEC0;
+$border-light:   #E2E8F0;
+$card-bg:        #FFFFFF;
+$page-bg:        #F8F6F1;
+
+/* —— 字号 —— */
+$font-h1:    24px;
+$font-h2:    20px;
+$font-h3:    18px;
+$font-body:  15px;
+$font-caption: 13px;
+$font-micro: 11px;
+
+/* —— 间距 —— */
+$space-xxs: 4px;
+$space-xs:  8px;
+$space-sm:  12px;
+$space-md:  16px;
+$space-lg:  24px;
+$space-xl:  32px;
+$space-2xl: 48px;
+
+/* —— 圆角 —— */
+$radius-sm:  6px;
+$radius-md:  10px;
+$radius-lg:  16px;
+$radius-xl:  20px;
+$radius-full: 999px;
+
+/* —— 阴影 —— */
+$shadow-card: 0 2px 12px rgba(26, 26, 46, 0.06);
+$shadow-modal: 0 -4px 20px rgba(26, 26, 46, 0.1);
+
+/* —— 动效曲线 —— */
+$ease-spring: cubic-bezier(0.16, 1, 0.3, 1);
+$ease-out:    ease-out;
+$ease-in:     ease-in;
+
+/* —— 命盘数字色（9个数字对应色） —— */
+$num-colors: (
+  1: #D94A4A,  /* 赤红 — 创造/自主 */
+  2: #4A90D9,  /* 冰蓝 — 合作/平衡 */
+  3: #E8A238,  /* 琥珀 — 表达/创意 */
+  4: #2D8B67,  /* 翡翠 — 稳定/规则 */
+  5: #D4A017,  /* 金   — 自由/变化 */
+  6: #7B6FA0,  /* 紫灰 — 关怀/责任 */
+  7: #4A6FA5,  /* 靛蓝 — 分析/灵性 */
+  8: #C9A84C,  /* 暗金 — 权力/财富 */
+  9: #B85C3A,  /* 铜橙 — 智慧/完成 */
+);
+```
+
+---
+
+## 十二、设计检查清单
+
+使用此清单确保每个页面的实现符合本指南：
+
+- [ ] 背景色为 `#F8F6F1`（矿白），非纯白
+- [ ] 卡片背景 `#FFFFFF`，圆角 16px，使用 `shadow-card` 阴影
+- [ ] 主按钮使用 `#1E3A5F`，行动按钮使用 `#C9A84C`（金色仅用于关键行动）
+- [ ] 字体未使用 Web Font，全部使用系统字族
+- [ ] 字号严格遵循层级规范（15px body / 13px caption / 11px micro）
+- [ ] 所有可点击区域 ≥ 44px
+- [ ] 按钮有 `:active` 缩放反馈（scale: 0.97）
+- [ ] 底部固定内容适配安全区域（safe-area-inset-bottom）
+- [ ] 空数据/加载/错误三态均已覆盖
+- [ ] 无 `#000000` 纯黑，无饱和度过高的颜色
+- [ ] 无 emoji 直接使用（使用图标替代）
+- [ ] TabBar 未选中灰色 `#A0AEC0`，选中品牌色 `#1E3A5F`
+- [ ] NavBar 统一墨蓝底色白色文字
+- [ ] 命盘数字使用九色体系着色

docs/system-spec.md

@@ -46,15 +46,15 @@
 | 角色 | 描述 | 终端 | 付费方 |
 |------|------|------|--------|
 | **普通用户（访客）** | 通过能量师分享进入的C端用户，免费体验 | 微信小程序 | 免费 |
-| **C端付费用户** | 购买 ¥299/年 订阅的普通用户 | 微信小程序 | 自己 |
-| **能量师（B端）** | 付费订阅 ¥1,314-1,914/年的从业者 | 微信小程序 + Web后台 | 自己 |
+| **C端付费用户** | 购买 ¥131/年 订阅的普通用户 | 微信小程序 | 自己 |
+| **能量师（B端）** | 付费订阅 ¥1,314-1,986/年的从业者 | 微信小程序 + Web后台 | 自己 |
 | **运营方管理员** | 推广运营团队，管理能量师和分销数据 | Web后台 | — |
 | **系统管理员** | 技术方运维，管理系统配置和数据 | Web后台 | — |
 
 ### 3.2 能量师核心流程
 
 ```
-能量师付费订阅（¥1,314-1,914/年）
+能量师付费订阅（¥1,314-1,986/年）
   ├── 获得AI辅助工具
   │     → 输入客户姓名+生日 → 生成三角形命盘
   │     → 获得AI完整解读（性格/天赋/职业/财富等维度）
@@ -64,7 +64,7 @@
   │     → 查看客户与AI的互动记录
   │     → 补充客户信息，完善客户画像
   └── 获得分销佣金
-        → 客户购买C端年费（¥299）→ 能量师获40%（¥119.6）
+        → 客户购买C端年费（¥131）→ 能量师获40%（¥52.40）
         → 推荐其他能量师订阅 → 一级佣金¥500
         → 被推荐人再推荐 → 原推荐人获二级佣金¥100
 ```
@@ -163,7 +163,7 @@ AI解读是平台的核心价值。Phase 1 首发 4 个解读维度，后续阶
 | 用户类型 | 主性格 | 成长财富量级 | 少儿天赋解码 | 少儿职业方向 |
 |---------|--------|------------|------------|------------|
 | 免费访客 | ✅ 文字概要（非完整版） | ❌ 仅标题预览 | ❌ 仅标题预览 | ❌ 仅标题预览 |
-| C端付费 ¥299 | ✅ 完整 | ✅ 完整 | ✅ 完整 | ✅ 完整 |
+| C端付费 ¥131 | ✅ 完整 | ✅ 完整 | ✅ 完整 | ✅ 完整 |
 | 能量师 ¥1,314+ | ✅ 完整 | ✅ 完整 | ✅ 完整 | ✅ 完整 |
 
 ### 5.3 分销基础 + 微信支付（⑤ 子集）
@@ -176,7 +176,7 @@ AI解读是平台的核心价值。Phase 1 首发 4 个解读维度，后续阶
 | 推广码生成 | 每个能量师生成唯一小程序码 | ✅ 基础版 | P2完善 |
 | 佣金记录 | 记录推荐关系及佣金数据 | ✅ 基础版（数据记录） | P2面板展示 |
 | 分销面板 | 收益统计+团队树+佣金明细 | ❌ | P2 |
-| C端支付+裂变 | C端 ¥299 订阅 + 邀请奖励 | ❌ | P2 |
+| C端支付+裂变 | C端 ¥131 订阅 + 邀请奖励 | ❌ | P2 |
 
 #### 微信支付需求
 
@@ -216,7 +216,7 @@ AI解读是平台的核心价值。Phase 1 首发 4 个解读维度，后续阶
   - 每日 3 次命盘生成（含主性格概要文字版）
   - 成长财富量级、少儿天赋解码、少儿职业方向 仅展示标题和付费解锁提示
 - 体验引导：
-  - 体验后提示购买 C 端年费 ¥299 获得完整解读
+  - 体验后提示购买 C 端年费 ¥131 获得完整解读
   - 或联系能量师获得深度解读服务
 
 ---
@@ -228,8 +228,8 @@ AI解读是平台的核心价值。Phase 1 首发 4 个解读维度，后续阶
 | 项目 | 价格 | 有效期 | 说明 |
 |------|------|--------|------|
 | 能量师年费（种子价） | ¥1,314/年 | 首300人 | 首批种子能量师锁定优惠价 |
-| 能量师年费（标准价） | ¥1,914/年 | — | 正常价格 |
-| C端用户年费 | ¥299/年 | — | 普通用户订阅 |
+| 能量师年费（标准价） | ¥1,986/年 | — | 正常价格 |
+| C端用户年费 | ¥131/年 | — | 普通用户订阅 |
 | 免费试用 | ¥0 | 每日3次 | 命盘+主性格概要 |
 
 ### 6.2 分销规则
@@ -238,13 +238,113 @@ AI解读是平台的核心价值。Phase 1 首发 4 个解读维度，后续阶
 |------|----------|------|
 | 能量师→能量师（一级） | ¥500 | 直接从运营方份额支出 |
 | 能量师→能量师（二级） | ¥100 | 间接推荐，从运营方份额支出 |
-| 能量师→C端（直接） | ¥119.6（40%） | C端消费 ¥299 的 40% |
-| 能量师→C端（上级） | ¥14.95（5%） | 上级能量师获得 5% |
+| 能量师→C端（直接） | ¥52.40（40%） | C端消费 ¥131 的 40% |
+| 能量师→C端（上级） | ¥6.55（5%） | 上级能量师获得 5% |
 
 ### 6.3 技术方-运营方分账
 
-- B端：技术方固定 ¥998/人，运营方获得剩余（种子价¥1,314-¥998=¥316/人，标准价¥1,914-¥998=¥916/人），运营方从自身份额中支付 ¥500+¥100 佣金
-- C端 ¥299：技术方 40%（¥119.6）+ 运营方 15%（¥44.85）+ 能量师 40%（¥119.6）+ 上级 5%（¥14.95）
+- B端：技术方固定 ¥998/人，运营方获得剩余（种子价¥1,314-¥998=¥316/人，标准价¥1,986-¥998=¥988/人），运营方从自身份额中支付 ¥500+¥100 佣金
+- C端 ¥131：技术方 40%（¥52.40）+ 运营方 15%（¥19.65）+ 能量师 40%（¥52.40）+ 上级 5%（¥6.55）
+
+### 6.4 三角形命盘计算规则
+
+**输入：** 出生年份（4位）、月份（2位）、日期（2位）
+
+命盘计算采用 **30位系统**（A-X），由后端 `CalculatorService` 计算，前端 `calculator.js` 作为降级兜底。
+
+#### 6.4.1 输入层（A-H）—— 生日原始数字
+
+| 字母 | 来源 | 示例 1990-01-15 |
+|------|------|----------------|
+| A | 年[0] 千位 | 1 |
+| B | 年[1] 百位 | 9 |
+| C | 年[2] 十位 | 9 |
+| D | 年[3] 个位 | 0 |
+| E | 月[0] 十位 | 0 |
+| F | 月[1] 个位 | 1 |
+| G | 日[0] 十位 | 1 |
+| H | 日[1] 个位 | 5 |
+
+#### 6.4.2 内部计算层（I-O）—— 7位
+
+| 字母 | 公式 | 中文名 |
+|------|------|-------|
+| I | `reduce(E+F)` | 月能量 |
+| J | `reduce(G+H)` | 日能量 |
+| K | `reduce(A+B)` | 年前位 |
+| L | `reduce(C+D)` | 年后位 |
+| M | `reduce(I+J)` | 青年综合数 |
+| N | `reduce(K+L)` | 晚年综合数 |
+| O | `reduce(M+N)` | 主性格 |
+
+#### 6.4.3 外部三组（P-X）—— 9位独立计算
+
+| 字母 | 公式 | 中文名 | 年龄区间 | 所属组 |
+|------|------|-------|---------|-------|
+| P | `reduce(I+M)` | 左侧左子 | 21-40 | 左侧 |
+| Q | `reduce(J+M)` | 左侧右子 | 21-40 | 左侧 |
+| R | `reduce(P+Q)` | **左侧主数** | 21-40 | 左侧 |
+| S | `reduce(K+N)` | 右侧左子 | 61+ | 右侧 |
+| T | `reduce(L+N)` | 右侧右子 | 61+ | 右侧 |
+| U | `reduce(S+T)` | **右侧主数** | 61+ | 右侧 |
+| V | `reduce(M+O)` | 顶部左子 | 41-60 | 顶部 |
+| W | `reduce(N+O)` | 顶部右子 | 41-60 | 顶部 |
+| X | `reduce(V+W)` | **顶部主数** | 41-60 | 顶部 |
+
+**注意：** 外部三组必须使用独立的归约计算，不得直接引用内部数字值。
+
+#### 6.4.4 归约规则
+
+- `reduce(N)` 定义：各位数字相加归约至个位，但 11/22/33 保留为卓越数
+- 所有 `+` 操作符均先执行普通加法，再调用 `reduce()` 归约
+
+#### 6.4.5 三角形布局
+
+```
+                X
+              ↙   ↘
+            V       W
+          ↙           ↘
+        M ───────────── N
+      ↙   ↘          ↙   ↘
+    P       Q      S       T
+  ↙           ↘  ↙           ↘
+I ─────────── J  K ─────────── L
+
+ R (21-40)         U (61+)
+```
+
+#### 6.4.6 外部三组年龄映射
+
+| 组 | 位置 | 年龄区间 | 关联内部位 |
+|----|------|---------|----------|
+| 左侧组 (R, P, Q) | 三角形左外侧 | 21-40岁 | 基于 I, J, M |
+| 顶部组 (X, V, W) | 三角形顶外侧 | 41-60岁 | 基于 M, N, O |
+| 右侧组 (U, S, T) | 三角形右外侧 | 61+岁 | 基于 K, L, N |
+
+#### 6.4.7 五区定义
+
+| 区域 | 包含位置 | 含义 |
+|------|---------|------|
+| 主性格区 | O | 核心人格特质 |
+| 左区（月日能量） | I, J, M | 月日融合之力 |
+| 右区（年份能量） | K, L, N | 年份能量凝聚 |
+| 父源区 | I, M | 父亲遗传、先天能量 |
+| 母源区 | L, N | 母亲遗传、后天能量 |
+
+#### 6.4.8 数字配色
+
+| 数字 | 颜色 |
+|------|------|
+| 1 | #D94A4A 赤红 |
+| 2 | #4A90D9 冰蓝 |
+| 3 | #E8A238 琥珀 |
+| 4 | #2D8B67 翡翠 |
+| 5 | #D4A017 金色 |
+| 6 | #7B6FA0 紫灰 |
+| 7 | #4A6FA5 靛蓝 |
+| 8 | #C9A84C 暗金 |
+| 9 | #B85C3A 铜橙 |
 
 ---
 
@@ -318,7 +418,7 @@ AI解读是平台的核心价值。Phase 1 首发 4 个解读维度，后续阶
 | AI 成长财富量级 | 成人财富潜力分析 |
 | AI 少儿天赋解码 | 少儿天赋潜能分析 |
 | AI 少儿职业方向 | 少儿职业倾向分析 |
-| 微信支付 | 能量师 ¥1,314 订阅支付 |
+| 微信支付 | 能量师 ¥1,314/¥1,986 订阅支付 |
 | CRM 基础 | 客户绑定 + 客户列表 |
 | 分销基础 | 推广码生成 + 佣金记录 |
 | 免费访客 | 限次体验 + 付费引导 |
@@ -341,4 +441,5 @@ AI解读是平台的核心价值。Phase 1 首发 4 个解读维度，后续阶
 
 | 日期 | 版本 | 变更内容 |
 |------|------|---------|
-| 2026-05-27 | v1.0 | 初稿，含 Phase 1 四个AI解读维度 |
+| 2026-05-27 | v1.0 | 初稿，含 Phase 1 四个AI解读维度 |
+| 2026-05-29 | v1.1 | 定价统一（种子¥1,314/标准¥1,986/年费¥131）；补充§6.4计算规则与数字配色；C端分销金额同步更新 |

num-server/.classpath

@@ -26,7 +26,7 @@
 			<attribute name="optional" value="true"/>
 		</attributes>
 	</classpathentry>
-	<classpathentry kind="con" path="org.eclipse.jdt.launching.JRE_CONTAINER/org.eclipse.jdt.internal.debug.ui.launcher.StandardVMType/JavaSE-17">
+	<classpathentry kind="con" path="org.eclipse.jdt.launching.JRE_CONTAINER/org.eclipse.jdt.internal.debug.ui.launcher.StandardVMType/JavaSE-1.8">
 		<attributes>
 			<attribute name="maven.pomderived" value="true"/>
 		</attributes>

num-server/.settings/org.eclipse.jdt.core.prefs

@@ -1,10 +1,10 @@
 eclipse.preferences.version=1
 org.eclipse.jdt.core.compiler.codegen.methodParameters=generate
-org.eclipse.jdt.core.compiler.codegen.targetPlatform=17
-org.eclipse.jdt.core.compiler.compliance=17
+org.eclipse.jdt.core.compiler.codegen.targetPlatform=1.8
+org.eclipse.jdt.core.compiler.compliance=1.8
 org.eclipse.jdt.core.compiler.problem.enablePreviewFeatures=disabled
 org.eclipse.jdt.core.compiler.problem.forbiddenReference=warning
 org.eclipse.jdt.core.compiler.problem.reportPreviewFeatures=ignore
 org.eclipse.jdt.core.compiler.processAnnotations=disabled
-org.eclipse.jdt.core.compiler.release=enabled
-org.eclipse.jdt.core.compiler.source=17
+org.eclipse.jdt.core.compiler.release=disabled
+org.eclipse.jdt.core.compiler.source=1.8

num-server/pom.xml

@@ -17,7 +17,7 @@
         <dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-web</artifactId></dependency>
         <dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-data-jpa</artifactId></dependency>
         <dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-data-redis</artifactId></dependency>
-        <dependency><groupId>mysql</groupId><artifactId>mysql-connector-java</artifactId><scope>runtime</scope></dependency>
+        <dependency><groupId>mysql</groupId><artifactId>mysql-connector-java</artifactId><version>8.0.33</version><scope>runtime</scope></dependency>
         <dependency><groupId>io.jsonwebtoken</groupId><artifactId>jjwt-api</artifactId><version>0.11.5</version></dependency>
         <dependency><groupId>io.jsonwebtoken</groupId><artifactId>jjwt-impl</artifactId><version>0.11.5</version><scope>runtime</scope></dependency>
         <dependency><groupId>io.jsonwebtoken</groupId><artifactId>jjwt-jackson</artifactId><version>0.11.5</version><scope>runtime</scope></dependency>

num-server/src/main/java/com/etotem/num/NumApplication.java

@@ -0,0 +1,25 @@
+package com.etotem.num;
+
+import com.google.gson.Gson;
+import org.springframework.boot.SpringApplication;
+import org.springframework.boot.autoconfigure.SpringBootApplication;
+import org.springframework.context.annotation.Bean;
+import org.springframework.web.client.RestTemplate;
+
+@SpringBootApplication
+public class NumApplication {
+
+    public static void main(String[] args) {
+        SpringApplication.run(NumApplication.class, args);
+    }
+
+    @Bean
+    public RestTemplate restTemplate() {
+        return new RestTemplate();
+    }
+
+    @Bean
+    public Gson gson() {
+        return new Gson();
+    }
+}

num-server/src/main/java/com/num/common/BizException.java → num-server/src/main/java/com/etotem/num/common/BizException.java

@@ -1,4 +1,4 @@
-package com.num.common;
+package com.etotem.num.common;
 
 public class BizException extends RuntimeException {
     private int code;

num-server/src/main/java/com/num/common/GlobalExceptionHandler.java → num-server/src/main/java/com/etotem/num/common/GlobalExceptionHandler.java

@@ -1,4 +1,4 @@
-package com.num.common;
+package com.etotem.num.common;
 
 import org.springframework.web.bind.annotation.ExceptionHandler;
 import org.springframework.web.bind.annotation.RestControllerAdvice;

num-server/src/main/java/com/num/common/Result.java → num-server/src/main/java/com/etotem/num/common/Result.java

@@ -1,4 +1,4 @@
-package com.num.common;
+package com.etotem.num.common;
 
 public class Result<T> {
     private int code;

num-server/src/main/java/com/num/config/JwtConfig.java → num-server/src/main/java/com/etotem/num/config/JwtConfig.java

@@ -1,4 +1,4 @@
-package com.num.config;
+package com.etotem.num.config;
 
 import io.jsonwebtoken.Claims;
 import io.jsonwebtoken.Jwts;

num-server/src/main/java/com/num/config/WebMvcConfig.java → num-server/src/main/java/com/etotem/num/config/WebMvcConfig.java

@@ -1,7 +1,7 @@
-package com.num.config;
+package com.etotem.num.config;
 
-import com.num.interceptor.AdminInterceptor;
-import com.num.interceptor.AuthInterceptor;
+import com.etotem.num.interceptor.AdminInterceptor;
+import com.etotem.num.interceptor.AuthInterceptor;
 import org.springframework.context.annotation.Configuration;
 import org.springframework.web.servlet.config.annotation.InterceptorRegistry;
 import org.springframework.web.servlet.config.annotation.WebMvcConfigurer;

num-server/src/main/java/com/etotem/num/controller/AdminController.java

@@ -0,0 +1,170 @@
+package com.etotem.num.controller;
+
+import com.etotem.num.common.Result;
+import com.etotem.num.config.JwtConfig;
+import com.etotem.num.entity.User;
+import com.etotem.num.entity.Order;
+import com.etotem.num.entity.ChartRecord;
+import com.etotem.num.entity.Commission;
+import com.etotem.num.repository.UserRepository;
+import com.etotem.num.repository.OrderRepository;
+import com.etotem.num.repository.ChartRecordRepository;
+import com.etotem.num.repository.CommissionRepository;
+import com.etotem.num.service.ConfigService;
+import com.etotem.num.service.WithdrawService;
+import org.springframework.beans.factory.annotation.Value;
+import org.springframework.web.bind.annotation.PostMapping;
+import org.springframework.web.bind.annotation.RequestBody;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RestController;
+
+import java.time.LocalDateTime;
+import java.util.*;
+import java.util.stream.Collectors;
+
+@RestController
+@RequestMapping("/api/admin")
+public class AdminController {
+
+    @Value("${num.admin.username:admin}")
+    private String adminUsername;
+
+    @Value("${num.admin.password:admin123}")
+    private String adminPassword;
+
+    private final UserRepository userRepository;
+    private final WithdrawService withdrawService;
+    private final CommissionRepository commissionRepository;
+    private final OrderRepository orderRepository;
+    private final ChartRecordRepository chartRecordRepository;
+    private final ConfigService configService;
+    private final JwtConfig jwtConfig;
+
+    public AdminController(UserRepository userRepository, WithdrawService withdrawService,
+                           CommissionRepository commissionRepository,
+                           OrderRepository orderRepository,
+                           ChartRecordRepository chartRecordRepository,
+                           ConfigService configService,
+                           JwtConfig jwtConfig) {
+        this.userRepository = userRepository;
+        this.withdrawService = withdrawService;
+        this.commissionRepository = commissionRepository;
+        this.orderRepository = orderRepository;
+        this.chartRecordRepository = chartRecordRepository;
+        this.configService = configService;
+        this.jwtConfig = jwtConfig;
+    }
+
+    @PostMapping("/login")
+    public Result<?> adminLogin(@RequestBody Map<String, String> body) {
+        String username = body.get("username");
+        String password = body.get("password");
+        if (!adminUsername.equals(username) || !adminPassword.equals(password)) {
+            return Result.error(1001, "Invalid admin credentials");
+        }
+        String token = jwtConfig.generate(0L, "admin");
+        return Result.success(Collections.singletonMap("token", token));
+    }
+
+    @PostMapping("/users")
+    public Result<?> listUsers() {
+        return Result.success(userRepository.findAll());
+    }
+
+    @PostMapping("/user/upgrade")
+    public Result<?> upgradeUserVip(@RequestBody Map<String, Long> body) {
+        Long userId = body.get("userId");
+        return userRepository.findById(userId).map(user -> {
+            // Upgrade to VIP: set vipEndTime to 1 year from now
+            user.setVipEndTime(LocalDateTime.now().plusYears(1));
+            userRepository.save(user);
+            return Result.success(null);
+        }).orElse(Result.error(1002, "User not found"));
+    }
+
+    @PostMapping("/user/downgrade")
+    public Result<?> downgradeUserVip(@RequestBody Map<String, Long> body) {
+        Long userId = body.get("userId");
+        return userRepository.findById(userId).map(user -> {
+            // Remove VIP status
+            user.setVipEndTime(null);
+            userRepository.save(user);
+            return Result.success(null);
+        }).orElse(Result.error(1002, "User not found"));
+    }
+
+    @PostMapping("/user/set-admin")
+    public Result<?> setAdmin(@RequestBody Map<String, Object> body) {
+        Long userId = ((Number) body.get("userId")).longValue();
+        boolean isAdmin = Boolean.TRUE.equals(body.get("isAdmin"));
+        return userRepository.findById(userId).map(user -> {
+            user.setIsAdmin(isAdmin);
+            userRepository.save(user);
+            return Result.success(null);
+        }).orElse(Result.error(1002, "User not found"));
+    }
+
+    @PostMapping("/orders")
+    public Result<?> listOrders() {
+        return Result.success(orderRepository.findAll());
+    }
+
+    @PostMapping("/commissions")
+    public Result<?> listAllCommissions() {
+        return Result.success(commissionRepository.findAll());
+    }
+
+    @PostMapping("/charts")
+    public Result<?> listAllCharts() {
+        return Result.success(chartRecordRepository.findAll());
+    }
+
+    @PostMapping("/withdraws")
+    public Result<?> listWithdraws() {
+        return Result.success(withdrawService.getAllPending());
+    }
+
+    @PostMapping("/withdraw/approve")
+    public Result<?> approveWithdraw(@RequestBody Map<String, Long> body) {
+        withdrawService.approve(body.get("id"));
+        return Result.success(null);
+    }
+
+    @PostMapping("/withdraw/reject")
+    public Result<?> rejectWithdraw(@RequestBody Map<String, Long> body) {
+        withdrawService.reject(body.get("id"));
+        return Result.success(null);
+    }
+
+    @PostMapping("/stats")
+    public Result<Map<String, Object>> stats() {
+        Map<String, Object> stats = new HashMap<>();
+        stats.put("totalUsers", userRepository.count());
+        stats.put("vipUsers", userRepository.countByVipEndTimeAfterAndVipEndTimeIsNotNull(LocalDateTime.now()));
+        stats.put("totalOrders", orderRepository.count());
+        stats.put("totalCharts", chartRecordRepository.count());
+        stats.put("totalCommissions", commissionRepository.count());
+        stats.put("totalRevenue", orderRepository.findAll().stream()
+                .filter(o -> "paid".equals(o.getStatus()))
+                .mapToLong(o -> o.getTotalFee() != null ? o.getTotalFee() : 0L)
+                .sum());
+
+        List<Order> recentOrders = orderRepository.findAll(
+                org.springframework.data.domain.Sort.by(org.springframework.data.domain.Sort.Direction.DESC, "id")
+        );
+        if (recentOrders.size() > 10) recentOrders = recentOrders.subList(0, 10);
+        stats.put("recentOrders", recentOrders);
+        return Result.success(stats);
+    }
+
+    @PostMapping("/config")
+    public Result<Map<String, String>> getConfig() {
+        return Result.success(configService.getAll());
+    }
+
+    @PostMapping("/config/update")
+    public Result<Void> updateConfig(@RequestBody Map<String, String> body) {
+        configService.setValue(body.get("key"), body.get("value"));
+        return Result.success(null);
+    }
+}

num-server/src/main/java/com/num/controller/AnnotationController.java → num-server/src/main/java/com/etotem/num/controller/AnnotationController.java

@@ -1,7 +1,7 @@
-package com.num.controller;
+package com.etotem.num.controller;
 
-import com.num.common.Result;
-import com.num.service.AnnotationService;
+import com.etotem.num.common.Result;
+import com.etotem.num.service.AnnotationService;
 import javax.servlet.http.HttpServletRequest;
 import org.springframework.web.bind.annotation.PostMapping;
 import org.springframework.web.bind.annotation.RequestBody;

num-server/src/main/java/com/num/controller/AuthController.java → num-server/src/main/java/com/etotem/num/controller/AuthController.java

@@ -1,12 +1,14 @@
-package com.num.controller;
+package com.etotem.num.controller;
 
-import com.num.common.Result;
-import com.num.service.UserService;
+import com.etotem.num.common.Result;
+import com.etotem.num.service.UserService;
+import com.etotem.num.service.WeChatService;
 import org.springframework.web.bind.annotation.PostMapping;
 import org.springframework.web.bind.annotation.RequestBody;
 import org.springframework.web.bind.annotation.RequestMapping;
 import org.springframework.web.bind.annotation.RestController;
 
+import java.util.Collections;
 import java.util.Map;
 
 @RestController
@@ -14,19 +16,30 @@ import java.util.Map;
 public class AuthController {
 
     private final UserService userService;
+    private final WeChatService weChatService;
 
-    public AuthController(UserService userService) {
+    public AuthController(UserService userService, WeChatService weChatService) {
         this.userService = userService;
+        this.weChatService = weChatService;
     }
 
     @PostMapping("/login")
     public Result<Map<String, String>> login(@RequestBody Map<String, String> request) {
+        // Accept either 'code' (from WeChat mini-program uni.login) or 'openid' (fallback)
+        String code = request.get("code");
         String openid = request.get("openid");
         String nickname = request.get("nickname");
         String avatarUrl = request.get("avatarUrl");
         String referralCode = request.get("referralCode");
 
+        if (openid == null || openid.isEmpty()) {
+            if (code == null || code.isEmpty()) {
+                return Result.error(1002, "Missing login credential (code or openid)");
+            }
+            openid = weChatService.codeToOpenid(code);
+        }
+
         String token = userService.loginOrRegister(openid, nickname, avatarUrl, referralCode);
-        return Result.success(Map.of("token", token));
+        return Result.success(Collections.singletonMap("token", token));
     }
 }

num-server/src/main/java/com/etotem/num/controller/ChartController.java

@@ -0,0 +1,79 @@
+package com.etotem.num.controller;
+
+import com.etotem.num.common.Result;
+import com.etotem.num.entity.ChartRecord;
+import com.etotem.num.service.ChartService;
+import javax.servlet.http.HttpServletRequest;
+import org.springframework.web.bind.annotation.PostMapping;
+import org.springframework.web.bind.annotation.RequestBody;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RestController;
+
+import java.util.Map;
+
+@RestController
+@RequestMapping("/api")
+public class ChartController {
+
+    private final ChartService chartService;
+
+    public ChartController(ChartService chartService) {
+        this.chartService = chartService;
+    }
+
+    /**
+     * Start or resume a consultation session.
+     * US-1.1 §7-8: userId + birthday uniquely identifies a consultation.
+     */
+    @PostMapping("/consultation/start")
+    public Result<?> startConsultation(HttpServletRequest request, @RequestBody Map<String, String> body) {
+        Long userId = (Long) request.getAttribute("userId");
+        if (userId == null) {
+            return Result.error(1001, "请先登录");
+        }
+        String name = body.getOrDefault("name", "");
+        String birthday = body.get("birthday");
+        String questions = body.getOrDefault("questions", "");
+
+        if (birthday == null || birthday.isEmpty()) {
+            return Result.error(1003, "出生日期不能为空");
+        }
+
+        Map<String, Object> result = chartService.startConsultation(userId, name, birthday, questions);
+        return Result.success(result);
+    }
+
+    @PostMapping("/chart/create")
+    public Result<ChartRecord> createChart(HttpServletRequest request, @RequestBody Map<String, String> body) {
+        Long userId = (Long) request.getAttribute("userId");
+        ChartRecord record = chartService.createChart(
+                userId,
+                body.get("phoneNumber"),
+                body.get("birthday"),
+                body.get("name"),
+                body.get("chartData"),
+                body.get("questions")
+        );
+        return Result.success(record);
+    }
+
+    @PostMapping("/consultation/check")
+    public Result<?> checkConsultation(HttpServletRequest request, @RequestBody Map<String, String> body) {
+        Long userId = (Long) request.getAttribute("userId");
+        String birthday = body.get("birthday");
+        boolean exists = chartService.checkExists(userId, birthday);
+        return Result.success(java.util.Collections.singletonMap("exists", exists));
+    }
+
+    @PostMapping("/chart/detail")
+    public Result<ChartRecord> getDetail(@RequestBody Map<String, Long> body) {
+        return Result.success(chartService.getById(body.get("id")));
+    }
+
+    @PostMapping("/chart/delete")
+    public Result<?> deleteChart(HttpServletRequest request, @RequestBody Map<String, Long> body) {
+        Long userId = (Long) request.getAttribute("userId");
+        chartService.deleteChart(body.get("id"), userId);
+        return Result.success(null);
+    }
+}

num-server/src/main/java/com/etotem/num/controller/ChatController.java

@@ -0,0 +1,42 @@
+package com.etotem.num.controller;
+
+import com.etotem.num.common.Result;
+import com.etotem.num.entity.ChatMessage;
+import com.etotem.num.service.ChatService;
+import javax.servlet.http.HttpServletRequest;
+import org.springframework.web.bind.annotation.PostMapping;
+import org.springframework.web.bind.annotation.RequestBody;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RestController;
+
+import java.util.Collections;
+import java.util.List;
+import java.util.Map;
+
+@RestController
+@RequestMapping("/api/chat")
+public class ChatController {
+
+    private final ChatService chatService;
+
+    public ChatController(ChatService chatService) {
+        this.chatService = chatService;
+    }
+
+    @PostMapping("/send")
+    public Result<Map<String, String>> sendMessage(HttpServletRequest request,
+                                                    @RequestBody Map<String, Object> body) {
+        Long userId = (Long) request.getAttribute("userId");
+        Long chartRecordId = ((Number) body.get("chartRecordId")).longValue();
+        String query = (String) body.get("query");
+
+        String reply = chatService.sendMessage(userId, chartRecordId, query);
+        return Result.success(Collections.singletonMap("reply", reply));
+    }
+
+    @PostMapping("/history")
+    public Result<List<ChatMessage>> getHistory(@RequestBody Map<String, Long> body) {
+        Long chartRecordId = body.get("chartRecordId");
+        return Result.success(chatService.getHistory(chartRecordId));
+    }
+}

num-server/src/main/java/com/num/controller/CommissionController.java → num-server/src/main/java/com/etotem/num/controller/CommissionController.java

@@ -1,8 +1,9 @@
-package com.num.controller;
+package com.etotem.num.controller;
 
-import com.num.common.Result;
-import com.num.service.CommissionService;
+import com.etotem.num.common.Result;
+import com.etotem.num.service.CommissionService;
 import javax.servlet.http.HttpServletRequest;
+import java.util.Collections;
 import org.springframework.web.bind.annotation.PostMapping;
 import org.springframework.web.bind.annotation.RequestMapping;
 import org.springframework.web.bind.annotation.RestController;
@@ -26,6 +27,6 @@ public class CommissionController {
     @PostMapping("/total")
     public Result<?> total(HttpServletRequest request) {
         Long userId = (Long) request.getAttribute("userId");
-        return Result.success(java.util.Map.of("total", commissionService.getTotalCommission(userId)));
+        return Result.success(Collections.singletonMap("total", commissionService.getTotalCommission(userId)));
     }
 }

num-server/src/main/java/com/etotem/num/controller/PayController.java

@@ -0,0 +1,72 @@
+package com.etotem.num.controller;
+
+import com.etotem.num.common.Result;
+import com.etotem.num.entity.Order;
+import com.etotem.num.service.OrderService;
+import com.etotem.num.service.UserService;
+import com.etotem.num.service.WxPayService;
+import javax.servlet.http.HttpServletRequest;
+import org.springframework.web.bind.annotation.PostMapping;
+import org.springframework.web.bind.annotation.RequestBody;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RestController;
+
+import java.util.HashMap;
+import java.util.Map;
+
+@RestController
+@RequestMapping("/api/pay")
+public class PayController {
+
+    private final OrderService orderService;
+    private final UserService userService;
+    private final WxPayService wxPayService;
+
+    public PayController(OrderService orderService, UserService userService, WxPayService wxPayService) {
+        this.orderService = orderService;
+        this.userService = userService;
+        this.wxPayService = wxPayService;
+    }
+
+    @PostMapping("/create")
+    public Result<?> createOrder(HttpServletRequest request, @RequestBody Map<String, Object> body) {
+        Long userId = (Long) request.getAttribute("userId");
+        int totalFee = ((Number) body.get("totalFee")).intValue();
+        String payType = (String) body.get("payType");
+
+        // 1. Create order in DB
+        Order order = orderService.createOrder(userId, totalFee, payType);
+
+        // 2. Get WeChat Pay unified order params (mock in dev mode)
+        Map<String, String> payParams = wxPayService.createUnifiedOrder(
+                userId, totalFee, "数字能量学VIP会员", order.getOutTradeNo());
+
+        // 3. Return combined response
+        Map<String, Object> result = new HashMap<>();
+        result.put("orderId", order.getId());
+        result.put("outTradeNo", order.getOutTradeNo());
+        result.put("totalFee", order.getTotalFee());
+
+        boolean isMock = payParams.containsKey("package") &&
+                payParams.get("package").contains("mock_prepay");
+        if (isMock) {
+            result.put("mock", true);
+        } else {
+            result.put("prepayId", payParams.get("package"));
+        }
+        result.put("timeStamp", payParams.get("timeStamp"));
+        result.put("nonceStr", payParams.get("nonceStr"));
+        result.put("package", payParams.get("package"));
+        result.put("signType", payParams.get("signType"));
+        result.put("paySign", payParams.get("paySign"));
+
+        return Result.success(result);
+    }
+
+    @PostMapping("/notify")
+    public Result<?> payNotify(@RequestBody Map<String, String> body) {
+        String outTradeNo = body.get("outTradeNo");
+        orderService.paySuccess(outTradeNo);
+        return Result.success(null);
+    }
+}

num-server/src/main/java/com/etotem/num/controller/ProfileController.java

@@ -0,0 +1,93 @@
+package com.etotem.num.controller;
+
+import com.etotem.num.common.Result;
+import com.etotem.num.entity.User;
+import com.etotem.num.service.ChartService;
+import com.etotem.num.service.CommissionService;
+import com.etotem.num.service.ConfigService;
+import com.etotem.num.service.UserService;
+import javax.servlet.http.HttpServletRequest;
+import org.springframework.web.bind.annotation.PostMapping;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RestController;
+
+import java.util.HashMap;
+import java.util.Map;
+
+@RestController
+@RequestMapping("/api/profile")
+public class ProfileController {
+
+    private final UserService userService;
+    private final CommissionService commissionService;
+    private final ChartService chartService;
+    private final ConfigService configService;
+
+    public ProfileController(UserService userService, CommissionService commissionService,
+                             ChartService chartService, ConfigService configService) {
+        this.userService = userService;
+        this.commissionService = commissionService;
+        this.chartService = chartService;
+        this.configService = configService;
+    }
+
+    @PostMapping("/info")
+    public Result<Map<String, Object>> getInfo(HttpServletRequest request) {
+        Long userId = (Long) request.getAttribute("userId");
+        User user = userService.getById(userId);
+        Map<String, Object> info = new HashMap<>();
+        info.put("id", user.getId());
+        info.put("nickname", user.getNickname());
+        info.put("avatarUrl", user.getAvatarUrl());
+        info.put("referralCode", user.getReferralCode());
+        info.put("isAdmin", user.getIsAdmin());
+        info.put("vipEndTime", user.getVipEndTime());
+        info.put("isVip", userService.isVip(userId));
+        info.put("dailyChartCount", user.getDailyChartCount());
+        info.put("dailyChatCount", user.getDailyChatCount());
+        return Result.success(info);
+    }
+
+    @PostMapping("/vip-status")
+    public Result<Map<String, Object>> vipStatus(HttpServletRequest request) {
+        Long userId = (Long) request.getAttribute("userId");
+        boolean isVip = userService.isVip(userId);
+        Map<String, Object> result = new HashMap<>();
+        result.put("isVip", isVip);
+        User user = userService.getById(userId);
+        result.put("vipEndTime", user.getVipEndTime());
+        return Result.success(result);
+    }
+
+    @PostMapping("/quota")
+    public Result<Map<String, Object>> quota(HttpServletRequest request) {
+        Long userId = (Long) request.getAttribute("userId");
+        User user = userService.getById(userId);
+        boolean isVip = userService.isVip(userId);
+        Map<String, Object> result = new HashMap<>();
+        result.put("isVip", isVip);
+        result.put("dailyChartCount", user.getDailyChartCount());
+        result.put("dailyChatCount", user.getDailyChatCount());
+        result.put("chartLimit", isVip ? -1 : configService.getQuota("chart"));
+        result.put("chatLimit", isVip ? -1 : configService.getQuota("chat"));
+        return Result.success(result);
+    }
+
+    @PostMapping("/commission-summary")
+    public Result<Map<String, Object>> commissionSummary(HttpServletRequest request) {
+        Long userId = (Long) request.getAttribute("userId");
+        Map<String, Object> result = new HashMap<>();
+        result.put("totalEarnings", commissionService.getTotalCommission(userId));
+        result.put("availableBalance", commissionService.getAvailableBalance(userId));
+        return Result.success(result);
+    }
+
+    @PostMapping("/chart-count")
+    public Result<Map<String, Object>> chartCount(HttpServletRequest request) {
+        Long userId = (Long) request.getAttribute("userId");
+        int count = chartService.getByUserId(userId).size();
+        Map<String, Object> result = new HashMap<>();
+        result.put("count", count);
+        return Result.success(result);
+    }
+}

num-server/src/main/java/com/num/controller/WithdrawController.java → num-server/src/main/java/com/etotem/num/controller/WithdrawController.java

@@ -1,13 +1,14 @@
-package com.num.controller;
+package com.etotem.num.controller;
 
-import com.num.common.Result;
-import com.num.service.WithdrawService;
+import com.etotem.num.common.Result;
+import com.etotem.num.service.WithdrawService;
 import javax.servlet.http.HttpServletRequest;
 import org.springframework.web.bind.annotation.PostMapping;
 import org.springframework.web.bind.annotation.RequestBody;
 import org.springframework.web.bind.annotation.RequestMapping;
 import org.springframework.web.bind.annotation.RestController;
 
+import java.util.Collections;
 import java.util.Map;
 
 @RestController
@@ -36,6 +37,6 @@ public class WithdrawController {
     @PostMapping("/balance")
     public Result<?> balance(HttpServletRequest request) {
         Long userId = (Long) request.getAttribute("userId");
-        return Result.success(Map.of("balance", withdrawService.getAvailableBalance(userId)));
+        return Result.success(Collections.singletonMap("balance", withdrawService.getAvailableBalance(userId)));
     }
 }

num-server/src/main/java/com/num/entity/ChartRecord.java → num-server/src/main/java/com/etotem/num/entity/ChartRecord.java

@@ -1,4 +1,4 @@
-package com.num.entity;
+package com.etotem.num.entity;
 
 import javax.persistence.*;
 import java.time.LocalDateTime;

num-server/src/main/java/com/etotem/num/entity/ChatMessage.java

@@ -0,0 +1,41 @@
+package com.etotem.num.entity;
+
+import javax.persistence.*;
+import java.time.LocalDateTime;
+
+@Entity
+@Table(name = "chat_messages")
+public class ChatMessage {
+
+    @Id
+    @GeneratedValue(strategy = GenerationType.IDENTITY)
+    private Long id;
+
+    @Column(name = "chart_record_id", nullable = false)
+    private Long chartRecordId;
+
+    @Column(name = "user_id", nullable = false)
+    private Long userId;
+
+    @Column(length = 20, nullable = false)
+    private String role; // "user" or "ai"
+
+    @Column(columnDefinition = "text")
+    private String content;
+
+    @Column(name = "created_at")
+    private LocalDateTime createdAt = LocalDateTime.now();
+
+    public Long getId() { return id; }
+    public void setId(Long id) { this.id = id; }
+    public Long getChartRecordId() { return chartRecordId; }
+    public void setChartRecordId(Long chartRecordId) { this.chartRecordId = chartRecordId; }
+    public Long getUserId() { return userId; }
+    public void setUserId(Long userId) { this.userId = userId; }
+    public String getRole() { return role; }
+    public void setRole(String role) { this.role = role; }
+    public String getContent() { return content; }
+    public void setContent(String content) { this.content = content; }
+    public LocalDateTime getCreatedAt() { return createdAt; }
+    public void setCreatedAt(LocalDateTime createdAt) { this.createdAt = createdAt; }
+}

num-server/src/main/java/com/num/entity/Commission.java → num-server/src/main/java/com/etotem/num/entity/Commission.java

@@ -1,4 +1,4 @@
-package com.num.entity;
+package com.etotem.num.entity;
 
 import javax.persistence.*;
 import java.time.LocalDateTime;

num-server/src/main/java/com/num/entity/Order.java → num-server/src/main/java/com/etotem/num/entity/Order.java

@@ -1,4 +1,4 @@
-package com.num.entity;
+package com.etotem.num.entity;
 
 import javax.persistence.*;
 import java.time.LocalDateTime;

num-server/src/main/java/com/num/entity/RatingAnnotation.java → num-server/src/main/java/com/etotem/num/entity/RatingAnnotation.java

@@ -1,4 +1,4 @@
-package com.num.entity;
+package com.etotem.num.entity;
 
 import javax.persistence.*;
 import java.time.LocalDateTime;

num-server/src/main/java/com/etotem/num/entity/SystemConfig.java

@@ -0,0 +1,36 @@
+package com.etotem.num.entity;
+
+import javax.persistence.*;
+import java.time.LocalDateTime;
+
+@Entity
+@Table(name = "system_config")
+public class SystemConfig {
+
+    @Id
+    @Column(name = "config_key", length = 64)
+    private String configKey;
+
+    @Column(name = "config_value", columnDefinition = "text")
+    private String configValue;
+
+    @Column(length = 255)
+    private String description;
+
+    @Column(name = "created_at")
+    private LocalDateTime createdAt = LocalDateTime.now();
+
+    @Column(name = "updated_at")
+    private LocalDateTime updatedAt = LocalDateTime.now();
+
+    public String getConfigKey() { return configKey; }
+    public void setConfigKey(String configKey) { this.configKey = configKey; }
+    public String getConfigValue() { return configValue; }
+    public void setConfigValue(String configValue) { this.configValue = configValue; }
+    public String getDescription() { return description; }
+    public void setDescription(String description) { this.description = description; }
+    public LocalDateTime getCreatedAt() { return createdAt; }
+    public void setCreatedAt(LocalDateTime createdAt) { this.createdAt = createdAt; }
+    public LocalDateTime getUpdatedAt() { return updatedAt; }
+    public void setUpdatedAt(LocalDateTime updatedAt) { this.updatedAt = updatedAt; }
+}

num-server/src/main/java/com/num/entity/Tag.java → num-server/src/main/java/com/etotem/num/entity/Tag.java

@@ -1,4 +1,4 @@
-package com.num.entity;
+package com.etotem.num.entity;
 
 import javax.persistence.*;
 import java.time.LocalDateTime;

num-server/src/main/java/com/num/entity/User.java → num-server/src/main/java/com/etotem/num/entity/User.java

@@ -1,6 +1,7 @@
-package com.num.entity;
+package com.etotem.num.entity;
 
 import javax.persistence.*;
+import java.time.LocalDate;
 import java.time.LocalDateTime;
 
 @Entity
@@ -33,6 +34,15 @@ public class User {
     @Column(name = "updated_at")
     private LocalDateTime updatedAt = LocalDateTime.now();
 
+    @Column(name = "daily_chart_count")
+    private Integer dailyChartCount = 0;
+
+    @Column(name = "daily_chat_count")
+    private Integer dailyChatCount = 0;
+
+    @Column(name = "last_quota_date")
+    private LocalDate lastQuotaDate = LocalDate.now();
+
     public Long getId() { return id; }
     public void setId(Long id) { this.id = id; }
     public String getOpenid() { return openid; }
@@ -55,4 +65,10 @@ public class User {
     public void setCreatedAt(LocalDateTime createdAt) { this.createdAt = createdAt; }
     public LocalDateTime getUpdatedAt() { return updatedAt; }
     public void setUpdatedAt(LocalDateTime updatedAt) { this.updatedAt = updatedAt; }
+    public Integer getDailyChartCount() { return dailyChartCount; }
+    public void setDailyChartCount(Integer dailyChartCount) { this.dailyChartCount = dailyChartCount; }
+    public Integer getDailyChatCount() { return dailyChatCount; }
+    public void setDailyChatCount(Integer dailyChatCount) { this.dailyChatCount = dailyChatCount; }
+    public LocalDate getLastQuotaDate() { return lastQuotaDate; }
+    public void setLastQuotaDate(LocalDate lastQuotaDate) { this.lastQuotaDate = lastQuotaDate; }
 }

num-server/src/main/java/com/num/entity/Withdraw.java → num-server/src/main/java/com/etotem/num/entity/Withdraw.java

@@ -1,4 +1,4 @@
-package com.num.entity;
+package com.etotem.num.entity;
 
 import javax.persistence.*;
 import java.time.LocalDateTime;

num-server/src/main/java/com/num/interceptor/AdminInterceptor.java → num-server/src/main/java/com/etotem/num/interceptor/AdminInterceptor.java

@@ -1,6 +1,6 @@
-package com.num.interceptor;
+package com.etotem.num.interceptor;
 
-import com.num.common.BizException;
+import com.etotem.num.common.BizException;
 import javax.servlet.http.HttpServletRequest;
 import javax.servlet.http.HttpServletResponse;
 import org.springframework.stereotype.Component;

num-server/src/main/java/com/num/interceptor/AuthInterceptor.java → num-server/src/main/java/com/etotem/num/interceptor/AuthInterceptor.java

@@ -1,7 +1,7 @@
-package com.num.interceptor;
+package com.etotem.num.interceptor;
 
-import com.num.common.BizException;
-import com.num.config.JwtConfig;
+import com.etotem.num.common.BizException;
+import com.etotem.num.config.JwtConfig;
 import io.jsonwebtoken.Claims;
 import javax.servlet.http.HttpServletRequest;
 import javax.servlet.http.HttpServletResponse;

num-server/src/main/java/com/num/repository/ChartRecordRepository.java → num-server/src/main/java/com/etotem/num/repository/ChartRecordRepository.java

@@ -1,12 +1,14 @@
-package com.num.repository;
+package com.etotem.num.repository;
 
-import com.num.entity.ChartRecord;
+import com.etotem.num.entity.ChartRecord;
 import org.springframework.data.jpa.repository.JpaRepository;
 import org.springframework.stereotype.Repository;
 
 import java.util.List;
+import java.util.Optional;
 
 @Repository
 public interface ChartRecordRepository extends JpaRepository<ChartRecord, Long> {
     List<ChartRecord> findByUserIdOrderByCreatedAtDesc(Long userId);
+    Optional<ChartRecord> findByUserIdAndBirthday(Long userId, String birthday);
 }