# 愈心谷 MVP PRD

关联：[测测拆解映射](analysis/cece-teardown.md) · [商业模式](business-model.md) · [产品路线图](product-roadmap.md)  
Feature Map：[`.ai/product/feature-map.md`](../../.ai/product/feature-map.md) · 竞品树：[`.ai/product/cece-feature-map.md`](../../.ai/product/cece-feature-map.md)  
域词汇：[`.ai/domain.md`](../../.ai/domain.md) · 领域图：[`.ai/domain/domain-map.md`](../../.ai/domain/domain-map.md)  
实现约束：[`.ai/architecture.md`](../../.ai/architecture.md) · playbooks: `add-api` / `new-page` / `payment`

---

## 1. 目标 / 非目标

### 目标（MVP Done）

在 **user-h5 + api** 上跑通：

1. Visitor 输入生日 → 创建 **Self Profile** → 生成 **Decode** 简版（结论可见）
2. 付费墙：Unlock 完整 Decode **或** 开通 **Subscription**（可模拟支付）
3. 至少一个热门 **Scale**（如 MBTI）作答 → **ScaleResult** → 分享卡
4. 可创建 **Other Profile**，生成 **Match** 预览（分数可见，解读锁定）
5. 底栏 5 Tab 可用；Ask / Companion 允许规则模板占位，但入口与文案就位
6. 服务端可复算报告；客户端不信任本地解锁

### 非目标

- Consult 履约 / 达人双边
- mini-program 业务页
- UGC「玩法广场」
- 真实微信支付（用 `PAYMENT_MODE=mock`）
- 长记忆多智能体 / 心情小镇级沉浸

---

## 2. 用户与场景

| 画像 | 场景 | 成功指标 |
|---|---|---|
| P2 泛测评年轻女性 | 社交看到分享 → 测自己 | 完成 Decode 简版或 Scale |
| P1 养生决策者 | 要「适合自己的调理参考」 | 查看完整 Decode 体质方案段 |
| 关系困扰 | 帮 TA 测 / 看契合 | 创建 Other Profile + Match 预览 |

---

## 3. 信息架构（5 Tab）

| Tab | 路由建议 | 内容 |
|---|---|---|
| 首页 | `/` | 品牌 + Decode 输入 + 热门 Feed + 宫格 |
| 探索 | `/explore` | Scale 列表、Decode 入口；星镜/数字心理轻入口 |
| 问 | `/ask` | Ask：基于当前 Profile；Tab 旁路「顾问预约」占位 |
| 陪伴 | `/companion` | 今日 SolarTerm + Mood 打卡（可静态内容） |
| 我的 | `/mine` | Profiles、Membership、Orders、设置 |

二级：`/decode` `/scales/:slug` `/match` `/report/:id`

---

## 4. 关键用户故事

### US1 Decode

- 输入 year/month/day → API 校验 → 落 Profile + Report(Decode)
- 简版：性格一句话 + 体质倾向一句话 + 1 条生活建议
- 完整：原因拆解 + 方案列表；需 Unlock 或 VIP
- 文案禁疗效 / 吉凶；页脚免责声明

### US2 Scale

- 列表来自 API；作答进度可本地缓存；提交服务端计分
- 结果页：类型/分数 + 分享 + 引导 Decode/Ask

### US3 Other + Match

- 「帮 TA 测」创建 Other Profile
- Match：展示契合分；解读段落锁定至 Unlock

### US4 Membership（mock）

- 套餐展示；下单 → mock 支付成功 → Membership active
- Ask/完整报告次数按权益扣减（服务端）

---

## 5. 付费墙原则

**免费给结论，付费给原因 + 方案。**  
VIP 与单次 Unlock 二选一可达完整内容。

---

## 6. API 切片（MVP）

统一信封见 `.ai/api.md`。最小集合：

| Method | Path | 说明 |
|---|---|---|
| POST | `/api/v1/profiles` | 创建 Self/Other Profile |
| GET | `/api/v1/profiles` | 列表 |
| POST | `/api/v1/reports/decode` | 生成 Decode（简/全由权益决定） |
| GET | `/api/v1/reports/:id` | 报告详情 |
| GET | `/api/v1/scales` | 量表列表 |
| GET | `/api/v1/scales/:slug` | 题目 |
| POST | `/api/v1/scales/:slug/result` | 提交作答 |
| POST | `/api/v1/match` | 契合度预览/完整 |
| POST | `/api/v1/orders` | 创建订单 |
| POST | `/api/v1/orders/:id/pay-mock` | 模拟支付 |
| GET | `/api/v1/membership/me` | 当前权益 |
| GET | `/api/v1/solar-terms/today` | 今日节气 |
| POST | `/api/v1/moods` | 心情打卡（可后置） |

Auth：Visitor 可用 device token；注册后升级 User（见 ADR-0004）。

---

## 7. 验收（QA）

- [ ] 未付费看不到完整 Decode 原因段（抓包改本地也不生效）
- [ ] 模拟支付后同一 Report 可完整查看
- [ ] Other Profile + Match 预览分数、解读锁定
- [ ] Scale 提交返回稳定计分
- [ ] 文案无疗效/吉凶；有免责声明
- [ ] `go test ./...` 与 `npm run build:h5` 通过
- [ ] `/api/v1/healthz` OK

---

## 8. 实现顺序（竖切）

按 [product-roadmap.md](product-roadmap.md) Phase A→B→C；每刀走 `.ai/playbooks/add-api.md` + `new-page.md`。