jackyu66gitandCursor
2fb1dfee14
Archive the differentiated YuXinGu product docs, AI engineering system, design contract, and Go/Vue scaffold. Next execution prioritizes Cece-parity over early innovation (see .ai/product/STRATEGY.md). Co-authored-by: Cursor <cursoragent@cursor.com>
129 lines
4.4 KiB
Markdown
129 lines
4.4 KiB
Markdown
# 愈心谷 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`。
|