digital-psychology/.ai/product/feature-spec/companion.md

Feature Spec: 陪伴（节气壳）

Status: Active · Map: §4 陪伴 [P2] · Phase: P2 Complete
规范：../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. 用户流程

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 开发前检查

• 壳范围已标明 · 禁止超 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 · 心情已按产品「其他先做」落地