# Feature Spec: 成长报告

> Status: `Active` · Map: `2.1.2 · 5.2 我的成长报告 [P1]` · Phase: `P1`  
> 规范：[../feature-design.md](../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. 用户流程

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

- [x] Spec 齐全  

---

## 14. Implementation Notes

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