MiniProgram/DailyFortuneGuide/Spec.md

每日运势指南产品规格（DailyFortuneGuide）

1. 目标

• 依据用户的出生日期、时间、城市生成基础命盘，结合当日天干地支与天象输出六维度运势、吉祥元素、最佳行动时机。
• 指南内容在小程序内结构化展示，并保留最多 20 条本地历史记录。
• 每日最多计算 10 次，观看激励广告后才允许触发计算。

2. 页面与职责

页面	路径	职责
首页	pages/home/index	输入表单、校验、广告流程、触发生成、提示每日一次更准
结果页	pages/result/index	展示六维度评分、吉祥元素、命盘摘要与 AI 解读，可跳转历史
历史列表	pages/history/index	展示本地最多 20 条记录、支持查看详情
历史详情	pages/history-detail/index	还原指定记录的运势内容

3. 数据模型

• FortuneForm: { birthDate, birthTime, birthCity }
• FortuneResult: 后端 DailyFortuneResponse
• HistoryItem: { id, createdAt, formSnapshot, fortune }
• 本地存储键：
  • fortune:quota:YYYYMMDD
  • fortune:history

4. 交互规则

• 必填项缺失或城市长度 < 2 时阻止提交。
• 每次生成前必须成功播放激励视频广告；未完整观看给出提示。
• 每日调用次数达到 config.maxDailyQuota（默认 10）后禁止继续生成。
• 成功生成后强制写入历史，超出 20 条旧记录被淘汰。
• 历史记录详情可脱网查看，上一次生成的结果缓存在 store.currentFortune 供结果页使用。

5. 接口

• POST /api/daily-fortune/analyze
  • 请求：{ birthDate, birthTime?, birthCity, birthProvince? }
  • 响应：DailyFortuneResponse（命盘、六维运势、吉祥元素、AI narrative）
  • 错误码：CONTENT_RISK、BIRTHDATE_INVALID、GENERATION_FAILED

6. 技术实现

• 统一在 store/fortuneStore.js 管理表单、当前结果、配额和历史列表，遵循单一职责。
• services/fortuneService.js 封装请求；utils/adService.js 复用激励广告逻辑；utils/storage.js 包装 tt 存储 API。
• 所有提示文案集中在 constants/messages.js。
• 页面样式遵循示例图的卡片化布局，移动端友好、对比度清晰。