docs: freeze YuXinGu lexicon, journey, and P1 engineering sources
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>
This commit is contained in:
+82
-92
@@ -1,128 +1,118 @@
|
||||
# 愈心谷 MVP PRD
|
||||
# 愈心谷 P1 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`
|
||||
关联:[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. 目标 / 非目标
|
||||
## 1. 定位
|
||||
|
||||
### 目标(MVP Done)
|
||||
通过数字性格、身心特征、关系理解与 AI 陪伴,帮助用户认识自己、理解他人的个人成长平台。
|
||||
|
||||
在 **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`)
|
||||
- 长记忆多智能体 / 心情小镇级沉浸
|
||||
飞轮:探索自己 → 个人档案 → 个性化分析 → AI 陪伴 → 会员深入 → 成长记录。
|
||||
|
||||
---
|
||||
|
||||
## 2. 用户与场景
|
||||
## 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 | 路由 | 内容 |
|
||||
|---|---|---|
|
||||
| P2 泛测评年轻女性 | 社交看到分享 → 测自己 | 完成 Decode 简版或 Scale |
|
||||
| P1 养生决策者 | 要「适合自己的调理参考」 | 查看完整 Decode 体质方案段 |
|
||||
| 关系困扰 | 帮 TA 测 / 看契合 | 创建 Other Profile + Match 预览 |
|
||||
| 首页 | `/` | 档案入口 + 九宫格 + 推荐 |
|
||||
| 探索 | `/explore` | 人格测评、性格探索、关系理解入口 |
|
||||
| 问答 | `/ask` | AI 成长助手;顾问预约占位 |
|
||||
| 陪伴 | `/companion` | 节气/心情占位或静态 |
|
||||
| 我的 | `/mine` | 档案、成长报告、会员 |
|
||||
|
||||
二级:`/portrait` `/scales/:slug` `/relation` `/reports/:id`
|
||||
|
||||
文案禁止词见 lexicon(无「解码/运势/解锁」等主文案)。
|
||||
|
||||
---
|
||||
|
||||
## 3. 信息架构(5 Tab)
|
||||
## 4. 用户故事
|
||||
|
||||
| Tab | 路由建议 | 内容 |
|
||||
|---|---|---|
|
||||
| 首页 | `/` | 品牌 + Decode 输入 + 热门 Feed + 宫格 |
|
||||
| 探索 | `/explore` | Scale 列表、Decode 入口;星镜/数字心理轻入口 |
|
||||
| 问 | `/ask` | Ask:基于当前 Profile;Tab 旁路「顾问预约」占位 |
|
||||
| 陪伴 | `/companion` | 今日 SolarTerm + Mood 打卡(可静态内容) |
|
||||
| 我的 | `/mine` | Profiles、Membership、Orders、设置 |
|
||||
### US1 性格探索 / 个人画像
|
||||
|
||||
二级:`/decode` `/scales/:slug` `/match` `/report/:id`
|
||||
- 输入生日 → Profile + GrowthReport(Portrait)
|
||||
- 免费:基础画像 + 1 条生活建议
|
||||
- 深度版:完整分析 + 行为模式 + 成长方向
|
||||
- 页脚免责声明(非医疗、非占卜)
|
||||
|
||||
### US2 人格测评
|
||||
|
||||
- 列表 API → 作答 → 服务端计分 → 探索结果 + 分享 + 引导问答/画像
|
||||
|
||||
### US3 关系理解
|
||||
|
||||
- 添加 TA → 双人差异概览 → 相处建议深度版锁定
|
||||
|
||||
### US4 会员
|
||||
|
||||
- 套餐 → mock 支付 → Membership;问答次数与深度版权益服务端扣减
|
||||
|
||||
---
|
||||
|
||||
## 4. 关键用户故事
|
||||
## 5. 付费原则
|
||||
|
||||
### 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/完整报告次数按权益扣减(服务端)
|
||||
免费给基础结论;付费给完整分析与方案(称「深度版」)。VIP 与单次 DeepAccess 二选一可达。
|
||||
|
||||
---
|
||||
|
||||
## 5. 付费墙原则
|
||||
|
||||
**免费给结论,付费给原因 + 方案。**
|
||||
VIP 与单次 Unlock 二选一可达完整内容。
|
||||
|
||||
---
|
||||
|
||||
## 6. API 切片(MVP)
|
||||
|
||||
统一信封见 `.ai/api.md`。最小集合:
|
||||
## 6. API 切片(P1)
|
||||
|
||||
| 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/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` | 心情打卡(可后置) |
|
||||
| GET | `/api/v1/membership/me` | 权益 |
|
||||
| GET | `/api/v1/solar-terms/today` | 今日节气(可静态) |
|
||||
| POST | `/api/v1/moods` | 心情(可 P2) |
|
||||
|
||||
Auth:Visitor 可用 device token;注册后升级 User(见 ADR-0004)。
|
||||
兼容:旧路径 `/reports/decode` 若存在应重定向/别名到 `portrait`,勿在新客户端写 decode。
|
||||
|
||||
---
|
||||
|
||||
## 7. 验收(QA)
|
||||
## 7. 验收
|
||||
|
||||
- [ ] 未付费看不到完整 Decode 原因段(抓包改本地也不生效)
|
||||
- [ ] 模拟支付后同一 Report 可完整查看
|
||||
- [ ] Other Profile + Match 预览分数、解读锁定
|
||||
- [ ] Scale 提交返回稳定计分
|
||||
- [ ] 文案无疗效/吉凶;有免责声明
|
||||
- [ ] `go test ./...` 与 `npm run build:h5` 通过
|
||||
- [ ] `/api/v1/healthz` OK
|
||||
- [ ] 未付费看不到完整分析段(改本地无效)
|
||||
- [ ] mock 支付后同一报告可看深度版
|
||||
- [ ] 关系理解:概览可见、深度建议锁定
|
||||
- [ ] Scale 计分稳定
|
||||
- [ ] UI 无禁用词;有免责声明
|
||||
- [ ] `go test` / `npm run build:h5` 通过
|
||||
|
||||
---
|
||||
|
||||
## 8. 实现顺序(竖切)
|
||||
## 8. 实现顺序
|
||||
|
||||
按 [product-roadmap.md](product-roadmap.md) Phase A→B→C;每刀走 `.ai/playbooks/add-api.md` + `new-page.md`。
|
||||
P1 竖切:Profile → Portrait → Commerce mock → Scale → RelationInsight → Ask 壳 → Companion 壳。
|
||||
Playbook:`add-api` / `new-page` / `payment`。语言先读 `lexicon.md`。
|
||||
|
||||
Reference in New Issue
Block a user