# Feature Spec: 陪伴（节气壳）

> Status: `Active` · Map: `§4 陪伴 [P2]` · Phase: `P2 Complete`  
> 规范：[../feature-design.md](../feature-design.md)

---

## 1. 功能定义

| 字段 | 内容 |
|---|---|
| Name | 陪伴 |
| Purpose | 日常留存：节气生活建议与心情记录 |
| Business Goal | Tab 占位完整；P2 做深留存 |

| In（P1 壳） | Out（P1） |
|---|---|
| 今日节气展示（本地/轻 API） | 完整心情 OS |
| 生活建议（非运势） | 疗效承诺 |
| 路由与 Tab 可达 | 强制日记社交 |

| In（P2） | |
|---|---|
| 心情记录落库、成长记录 | |

---

## 2. 用户价值

1. **为何需要：** 需要轻量每日触达，不只是一次性测试。  
2. **P1 获得：** 今日节气与建议壳。  
3. **付费：** N/A（P1）。

---

## 3. 用户角色

| Actor | P1 |
|---|---|
| Visitor | 可打开陪伴页看节气壳 |

---

## 4. 用户流程

```text
Tab 陪伴 → /companion
  ↓
展示今日节气 + 生活建议文案
  ↓
（P2）记录心情 → POST /moods
```

---

## 5. 页面设计

| 路由 | 页面 |
|---|---|
| `/companion` | CompanionPage |

---

## 6. 页面状态规范

| 状态 | UI |
|---|---|
| Loading | 拉节气 |
| Normal | 节气 + 建议 |
| Error | 降级本地文案或重试 |

---

## 7. Business Rules

| ID | Rule |
|---|---|
| R1 | 文案为「生活建议 / 节气」，禁止「今日运势」 |
| R2 | P1 不宣称完整陪伴 OS 已交付 |
| R3 | 心情 API 若暴露须鉴权；P1 可不接 UI |
| R4 | 扩行为前必须把本 Spec Phase 与 In Scope 升为 P2 并补验收 |

---

## 8. 数据模型影响

| 表 | P1 | P2 |
|---|---|---|
| solar term | 只读 API/本地 | |
| `moods` | 可有 API | UI 写入 |

---

## 9. API 需求

| Method | Path | 意图 |
|---|---|---|
| GET | `/api/v1/solar-terms/today` | 今日节气 |
| POST | `/api/v1/moods` | P2 心情 |

---

## 10. 权限设计

| 能力 | Visitor |
|---|---|
| 看节气壳 | ✓ |
| 写心情 | P2 |

---

## 11. 埋点

| Event | 触发 | 可选 params |
|---|---|---|
| `companion_viewed` | 打开 `/companion` | — |
| `mood_saved` | 心情保存成功 | `score`（整数分，非正文） |
| `growth_plan_viewed` | 打开 `/growth-plan` 且列表加载结束 | — |
| `growth_plan_created` | 创建计划成功 | — |
| `growth_plan_checkin` | 今日打卡成功 | — |

禁止参数含计划 title/focus/note 明文。

---

## 12. 测试验收标准

**Given** P1  
**When** 打开陪伴  
**Then** 页面可达且无运势禁用词；不因未做心情而崩溃  

**Given** 要将心情做进 P1  
**When** —  
**Then** **禁止**在未改 Spec/map 分期前实现  

---

## 13. AI 开发前检查

- [x] 壳范围已标明 · 禁止超 scope  

---

## 14. Implementation Notes

| 项 | 内容 |
|---|---|
| Packages | `CompanionPage` · `internal/companion` · moods 表 |
| 实现 | GET `/solar-terms/today` · POST `/moods` · GET `/moods/today` · H5 心情 UI |
| Gaps | 推送（后置 / Ops-E） |
| Label | Feature Complete（P2：节气 + 心情 + 近七日轨迹；成长计划见 `/growth-plan`） |
| Process Review | 2026-08-02 [P1-PROCESS-REVIEW](P1-PROCESS-REVIEW.md) · 心情已按产品「其他先做」落地 |