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

Feature Spec: 成长报告

Status: Active · Map: 2.1.2 · 5.2 我的成长报告 [P1] · Phase: P1
规范：../feature-design.md

---

1. 功能定义

字段	内容
Name	成长报告
Purpose	沉淀用户已生成的画像/关系等报告资产，支持回看与深度解锁
Business Goal	「我的」资产感；复访与付费

In	Out
列表 + 详情；按权益展示 detail	收藏夹完整产品（可后置）
portrait / relation 类型	第三方导出 PDF（Gap）

---

2. 用户价值

1. 为何需要： 不想每次重新生成才能回看。
2. 完成后获得： 历史报告列表与详情。
3. 付费： 详情内深度版墙同 membership Spec。

---

3. 用户角色

Actor	能力
Visitor	仅己方报告
DeepAccess/VIP	详情 detail

---

4. 用户流程

/mine → 成长报告列表 /reports
  ↓
点一项 → /reports/:id
  ↓
展示 summary；无权益则 Locked → 支付 → detail

---

5. 页面设计

路由	页面
/reports	ReportsPage（入口也在 /mine）
/reports/:id	ReportPage

---

6. 页面状态规范

状态	UI
Loading	列表/详情加载
Empty	无报告 → 引导画像/探索
Error	重试
Normal	列表项 / ReportRich
Locked	深度版 CTA

---

7. Business Rules

ID	Rule
R1	仅返回当前用户报告
R2	summary 可读；detail 按 Membership/DeepAccess
R3	type 区分 portrait / relation 等渲染
R4	删除报告策略：未要求则可不做；若做须鉴权

---

8. 数据模型影响

表	备注
growth_reports	主数据

---

9. API 需求

Method	Path	意图
GET	/api/v1/reports	列表
GET	/api/v1/reports/{id}	详情（权益剥离）

---

10. 权限设计

能力	所有者	非所有者
列表/详情	✓	✗
detail 字段	视权益	✗

---

11. 埋点

Event	触发
reports_list_viewed	打开列表
report_opened	打开详情
deep_access_clicked	详情内 CTA

---

12. 测试验收标准

Given 用户有报告
When GET 列表
Then 仅己方项

Given 无权益
When 打开详情
Then summary 可见 detail 不可见

---

13. AI 开发前检查

• Spec 齐全

---

14. Implementation Notes

项	内容
Packages	handler/report · ReportsPage · ReportPage · Mine 入口
Gaps	收藏；PDF
Process Review	2026-08-02 P1-PROCESS-REVIEW · 设计闭合 · page-tree 已含 /reports · 实现 PASS · 测试 PARTIAL