# Feature Spec: 身心节律

> Status: `Active` · Map: `2.7 身心节律 [P2]`（= `2.5 身心探索` 产品化主入口）· Phase: `P2 Complete`  
> 规范：[../feature-design.md](../feature-design.md) · 队列：[P2-BACKLOG.md](P2-BACKLOG.md)  
> 竞品对照：命理体系之生活向（能力同构，禁止算命/流年吉凶叙事）

---

## 1. 功能定义

| 字段 | 内容 |
|---|---|
| Name | 身心节律 |
| Purpose | 基于出生信息给出五行/体质倾向隐喻与作息·饮食·运动等生活建议 |
| Business Goal | 差异化护城河（数字性格 × 身心）；导流节气陪伴与会员 |

| In | Out |
|---|---|
| 元素平衡、体质倾向、本周生活建议 | 流年吉凶、改命、疗效/治病承诺 |
| 与节气生活联动 | 八字/紫微作恐吓主标题 |
| GrowthReport 或 Constitution 聚合 | 医疗诊断 |

**与 2.5：** 本 Spec 为身心探索的**唯一产品化主入口**；map 上 2.5 保留能力描述，入口文案统一「身心节律」。

---

## 2. 用户价值

1. **为何需要：** 想知道如何按自己的节奏安排生活，而不只是性格标签。  
2. **完成后获得：** 节律概览、元素倾向、今日/本周生活建议；深度版含分维习惯方案。  
3. **为何付费：** 完整习惯方案与长期节律计划。

---

## 3. 用户角色

| Actor | 能力 |
|---|---|
| Visitor+档案 | 基础节律报告 |
| DeepAccess/VIP | detail |
| 无档案 | 引导建档 |

---

## 4. 用户流程

```text
/rhythm 或探索入口
  ↓
确认 Profile
  ↓
生成节律报告（元素 · 倾向 · 生活建议）
  ↓
基础 summary → 深度 detail（会员/深度版）
  ↓
CTA：节气陪伴 / 问答「生活节奏」/ 分享
```

---

## 5. 页面设计

| 路由 | 页面 |
|---|---|
| `/rhythm` | LifeRhythmPage（P2 draft） |
| `/companion` | 节气联动出口 |
| `/reports/:id` | type=rhythm 详情 |

```text
/rhythm
├── Empty / Loading / Error
├── Normal（基础节律 + 生活建议）
└── Locked
```

---

## 6. 页面状态规范

| 状态 | UI |
|---|---|
| Loading | 分析中 |
| Empty | 无档案引导 |
| Error | 重试 |
| Normal | 维度 + 本周建议 |
| Locked | 深度版 CTA |

---

## 7. Business Rules

| ID | Rule |
|---|---|
| R1 | 绑定 Profile；birth_date 必填 |
| R2 | 确定性引擎（可参考遗留 yangsheng 思路，**新代码进 monorepo**） |
| R3 | summary/detail 权益同画像（Membership ∨ DeepAccess） |
| R4 | **禁止**：疗效、改善疾病、流年吉凶、改命、算命 |
| R5 | 推荐用语：体质倾向、生活建议、节律、平衡 |
| R6 | 可展示五行隐喻，须标注探索/非医疗 |
| R7 | 与星象性格、个人画像内容可互相链，不互相覆盖主路径 |
| R8 | **体质/五行倾向**随生日确定；**今日/本周生活建议**按**自然日（CST）**刷新（本周焦点随星期变） |
| R9 | GET `/reports/latest` 与 GET `/reports/{id}`（type=rhythm）：`as_of` ≠ 当日则**原 id 原地更新**时效段并落库；同日即时返回 |
| R10 | `summary` 含 `as_of` · `valid_until`（次日 00:00 CST）；前端到点静默刷新；**不按十二时辰** |
| R11 | `summary.wuxing` 必含五行分布 `bars`（与愈心解码同源算法）及主/辅倾向；缺字段时 GET 原地补全 |

---

## 8. 数据模型影响

| 项 | 说明 |
|---|---|
| `growth_reports.type` | `rhythm` / `life_rhythm` |
| 或 Constitution 专用表 | 若需独立聚合，实现时 ADR |
| 禁止 | `luck_score`、病名诊断字段 |
| 报告 JSON | `as_of` · `valid_until` · `today_tip` · `week_focus` |

---

## 9. API 需求（草案）

| Method | Path | 意图 |
|---|---|---|
| POST | `/api/v1/reports/rhythm` | profile_id → 报告 |
| GET | `/api/v1/reports/{id}` | 复用 |
| GET | `/api/v1/solar-terms/today` | 页内联动展示（已有） |

---

## 10. 权限设计

| 能力 | 有档案 | 深度权益 |
|---|---|---|
| summary | ✓ | ✓ |
| detail | ✗ | ✓ |

---

## 11. 埋点

| Event | 触发 |
|---|---|
| `rhythm_started` | 开始生成 |
| `rhythm_completed` | 基础结果 |
| `deep_access_clicked` | surface=rhythm |
| `rhythm_to_companion` | 去节气 |

---

## 12. 测试验收标准

**Given** 有生日档案  
**When** 生成身心节律  
**Then** 含生活建议；无「吉凶」「疗效」「算命」  

**Given** 无权益  
**When** GET detail  
**Then** 剥离  

**Given** 文案审查  
**When** 扫 summary+detail  
**Then** 符合 lexicon  

**Given** 已有 rhythm 报告且 `as_of` 为昨日  
**When** GET latest  
**Then** `today_tip` / `week_focus` 按今日更新；报告 `id` 不变  

**Given** 用户停留在 `/rhythm` 跨自然日  
**When** 到达 `valid_until`  
**Then** 前端静默刷新建议文案  

---

## 13. AI 开发前检查

- [x] Spec 齐全 · 与 2.5 关系已写清  
- [x] lexicon LifeRhythm  
- [x] OpenAPI/erd（编码时）  

---

## 14. Implementation Notes

| 项 | 内容 |
|---|---|
| 复用 | ReportRich · membership · companion 节气 · 立项中医体质方向 |
| 参考勿迁 | 根目录 `yangsheng.html` 仅思路参考 |
| Packages | `internal/rhythm` · `LifeRhythmPage` `/rhythm` |
| 实现 | `POST /reports/rhythm` · OpenAPI 已登记 |
| 编码顺序 | P2-BACKLOG 切片 2 Done |