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:
jackyu66git
2026-08-02 16:12:10 +08:00
co-authored by Cursor
parent 2fb1dfee14
commit dd94e57277
40 changed files with 1283 additions and 800 deletions
+82 -92
View File
@@ -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 Membershipmock
- 套餐展示;下单 → 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 |
AuthVisitor 可用 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`