jackyu66gitandCursor
dd94e57277
Establish product language contract, user journey with dual growth engines, ERD/OpenAPI/Go boundaries, and H5 routes (/profile, /portrait, /relation, /membership) before P1 implementation. Co-authored-by: Cursor <cursoragent@cursor.com>
119 lines
3.8 KiB
Markdown
119 lines
3.8 KiB
Markdown
# 愈心谷 P1 PRD（首版）
|
||
|
||
关联：[Feature Map](../../.ai/product/feature-map.md) · [语言契约](../../.ai/product/lexicon.md) · [商业模式](business-model.md) · [路线图](product-roadmap.md)
|
||
域：[`.ai/domain.md`](../../.ai/domain.md) · [domain-map](../../.ai/domain/domain-map.md)
|
||
|
||
---
|
||
|
||
## 1. 定位
|
||
|
||
通过数字性格、身心特征、关系理解与 AI 陪伴，帮助用户认识自己、理解他人的个人成长平台。
|
||
|
||
飞轮：探索自己 → 个人档案 → 个性化分析 → AI 陪伴 → 会员深入 → 成长记录。
|
||
|
||
---
|
||
|
||
## 2. P1 目标 / 非目标
|
||
|
||
### 目标
|
||
|
||
在 **user-h5 + api** 跑通：
|
||
|
||
1. 创建 **Self Profile**（生日等）→ 生成 **Portrait** 基础画像（可见）
|
||
2. 付费墙：购买 **DeepAccess** 完整分析 **或** 开通 **Subscription**（可 mock）
|
||
3. ≥1 个热门 **Scale** → **ScaleResult（探索结果）** → 分享卡
|
||
4. 创建 **Other Profile** → **RelationInsight**（差异可见，深度建议需 DeepAccess/VIP）
|
||
5. 五 Tab：首页 / 探索 / **问答** / 陪伴 / 我的；问答挂档案；陪伴可占位
|
||
6. 成长报告字段由服务端按权益裁剪
|
||
|
||
### 非目标（P1）
|
||
|
||
- 真人顾问履约、达人双边
|
||
- 小程序业务页
|
||
- UGC 玩法广场
|
||
- 真微信支付（`PAYMENT_MODE=mock`）
|
||
- 长期记忆、运势/塔罗入口、疗效承诺文案
|
||
|
||
---
|
||
|
||
## 3. 信息架构
|
||
|
||
| Tab | 路由 | 内容 |
|
||
|---|---|---|
|
||
| 首页 | `/` | 档案入口 + 九宫格 + 推荐 |
|
||
| 探索 | `/explore` | 人格测评、性格探索、关系理解入口 |
|
||
| 问答 | `/ask` | AI 成长助手；顾问预约占位 |
|
||
| 陪伴 | `/companion` | 节气/心情占位或静态 |
|
||
| 我的 | `/mine` | 档案、成长报告、会员 |
|
||
|
||
二级：`/portrait` `/scales/:slug` `/relation` `/reports/:id`
|
||
|
||
文案禁止词见 lexicon（无「解码/运势/解锁」等主文案）。
|
||
|
||
---
|
||
|
||
## 4. 用户故事
|
||
|
||
### US1 性格探索 / 个人画像
|
||
|
||
- 输入生日 → Profile + GrowthReport(Portrait)
|
||
- 免费：基础画像 + 1 条生活建议
|
||
- 深度版：完整分析 + 行为模式 + 成长方向
|
||
- 页脚免责声明（非医疗、非占卜）
|
||
|
||
### US2 人格测评
|
||
|
||
- 列表 API → 作答 → 服务端计分 → 探索结果 + 分享 + 引导问答/画像
|
||
|
||
### US3 关系理解
|
||
|
||
- 添加 TA → 双人差异概览 → 相处建议深度版锁定
|
||
|
||
### US4 会员
|
||
|
||
- 套餐 → mock 支付 → Membership；问答次数与深度版权益服务端扣减
|
||
|
||
---
|
||
|
||
## 5. 付费原则
|
||
|
||
免费给基础结论；付费给完整分析与方案（称「深度版」）。VIP 与单次 DeepAccess 二选一可达。
|
||
|
||
---
|
||
|
||
## 6. API 切片（P1）
|
||
|
||
| Method | Path | 说明 |
|
||
|---|---|---|
|
||
| POST/GET | `/api/v1/profiles` | 档案 |
|
||
| POST | `/api/v1/reports/portrait` | 生成个人画像（简/全按权益） |
|
||
| GET | `/api/v1/reports/:id` | 成长报告详情 |
|
||
| GET | `/api/v1/scales` | 测评列表 |
|
||
| GET/POST | `/api/v1/scales/:slug` … `/result` | 题目与提交 |
|
||
| POST | `/api/v1/relation/insight` | 关系理解 |
|
||
| 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` | 心情（可 P2） |
|
||
|
||
兼容：旧路径 `/reports/decode` 若存在应重定向/别名到 `portrait`，勿在新客户端写 decode。
|
||
|
||
---
|
||
|
||
## 7. 验收
|
||
|
||
- [ ] 未付费看不到完整分析段（改本地无效）
|
||
- [ ] mock 支付后同一报告可看深度版
|
||
- [ ] 关系理解：概览可见、深度建议锁定
|
||
- [ ] Scale 计分稳定
|
||
- [ ] UI 无禁用词；有免责声明
|
||
- [ ] `go test` / `npm run build:h5` 通过
|
||
|
||
---
|
||
|
||
## 8. 实现顺序
|
||
|
||
P1 竖切：Profile → Portrait → Commerce mock → Scale → RelationInsight → Ask 壳 → Companion 壳。
|
||
Playbook：`add-api` / `new-page` / `payment`。语言先读 `lexicon.md`。
|