jackyu66gitandCursor
89756f65b4
落地输入合规、探索题库、报告日/时辰刷新、账号头像、OEJTS 量表，并补齐 H5 埋点与 Admin 漏斗；同步 ESS 工件、切至自建 Git、清理 GitHub Actions。 Co-authored-by: Cursor <cursoragent@cursor.com>
153 lines
3.2 KiB
Markdown
153 lines
3.2 KiB
Markdown
# 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) · 心情已按产品「其他先做」落地 |
|