jackyu66gitandCursor
bd22d9dddd
落地 synastry/star/ask API 与 H5 页面，补齐 cece-frontend-re complete-design 证据文档，并加入 Android 模拟器截图抓取脚本。 Co-authored-by: Cursor <cursoragent@cursor.com>
177 lines
4.3 KiB
Markdown
177 lines
4.3 KiB
Markdown
# Feature Spec: 关系理解
|
||
|
||
> Status: `Active` · Map: `2.4 关系理解 [P1 · 双引擎]` · Phase: `P1`
|
||
> 规范：[../feature-design.md](../feature-design.md)
|
||
|
||
---
|
||
|
||
## 1. 功能定义
|
||
|
||
| 字段 | 内容 |
|
||
|---|---|
|
||
| Name | 关系理解 |
|
||
| Purpose | 帮助用户了解自己与 TA 在沟通、节奏、亲密与冲突上的差异，并获得相处建议 |
|
||
| Business Goal | 双引擎增长（分享裂变）；深度相处建议付费；不可弱化 |
|
||
|
||
| In | Out |
|
||
|---|---|
|
||
| 双 Profile 对比 + 关系报告 | 「合盘 / 合婚 / 缘分」叙事 |
|
||
| 多维对比、互补、冲突修复建议 | 宿命/恐吓文案 |
|
||
| DeepAccess / 会员解锁完整建议 | 无档案空算 |
|
||
|
||
---
|
||
|
||
## 2. 用户价值
|
||
|
||
1. **为何需要：** 想理解「为什么和 TA 总卡住」。
|
||
2. **完成后获得：** 双方风格标签、差异一句话、维度对比；付费后沟通/冲突/亲密/共同成长与本周练习。
|
||
3. **为何付费：** 完整相处说明书与话术，可立即用于对话。
|
||
|
||
---
|
||
|
||
## 3. 用户角色
|
||
|
||
| Actor | 本功能能力 |
|
||
|---|---|
|
||
| Visitor | 需已有 Self；可建 Other；生成 insight + 基础 summary |
|
||
| DeepAccess / VIP | 可见完整 detail |
|
||
|
||
---
|
||
|
||
## 4. 用户流程
|
||
|
||
```text
|
||
进入 /relation
|
||
↓
|
||
无 Self 档案？ → 引导首页创建画像/档案
|
||
↓
|
||
填写 TA 称呼 + 生日 → 创建 Other Profile
|
||
↓
|
||
POST relation/insight
|
||
↓
|
||
展示双方风格 + 差异 + 维度对比（summary）
|
||
↓
|
||
深度建议？ → order deep_access → pay-mock → 完整 sections
|
||
↓
|
||
分享卡（我的方式 vs TA）
|
||
```
|
||
|
||
---
|
||
|
||
## 5. 页面设计
|
||
|
||
| 路由 | 页面 |
|
||
|---|---|
|
||
| `/relation` | RelationPage |
|
||
| `/reports/:id` | 关系类报告详情 |
|
||
| `/share` | 分享落地 |
|
||
|
||
```text
|
||
/relation
|
||
├── Form（输入 TA）
|
||
├── Empty（无 Self）
|
||
├── Loading / Error
|
||
├── Normal（基础对比）
|
||
└── Locked（完整建议墙）
|
||
```
|
||
|
||
---
|
||
|
||
## 6. 页面状态规范
|
||
|
||
| 状态 | UI |
|
||
|---|---|
|
||
| Empty | 无 Self → 链到首页 |
|
||
| Loading | 「生成中…」 |
|
||
| Error | 文案 + 可去建档 |
|
||
| Normal | me/other style、diff、dimension_compare |
|
||
| Locked | 深度版 CTA |
|
||
|
||
---
|
||
|
||
## 7. Business Rules
|
||
|
||
| ID | Rule |
|
||
|---|---|
|
||
| R1 | 必须引用两个 Profile（通常 self + other）；禁止无档案生成 |
|
||
| R2 | summary 含对比与维度；detail 含 sections / scripts / weekly_practice |
|
||
| R3 | detail 权益同画像：Membership **或** 该报告 DeepAccess |
|
||
| R4 | Server 鉴权；禁用词：合盘、合婚、运势、吉凶 |
|
||
| R5 | 差异叙事为「说明书」非评分/宿命 |
|
||
| R6 | 增长价值不得弱于个人画像（分享路径必须存在） |
|
||
|
||
---
|
||
|
||
## 8. 数据模型影响
|
||
|
||
| 表 | 备注 |
|
||
|---|---|
|
||
| `profiles` | other + relation_type |
|
||
| `relation_insights` | profile_a/b + report_id |
|
||
| `growth_reports` | type=`relation` |
|
||
|
||
---
|
||
|
||
## 9. API 需求
|
||
|
||
| Method | Path | 意图 |
|
||
|---|---|---|
|
||
| POST | `/api/v1/profiles` | 创建 TA |
|
||
| POST | `/api/v1/relation/insight` | self_id + other_id → insight + report |
|
||
| GET | `/api/v1/reports/{id}` | 按权益返回 |
|
||
| POST | `/api/v1/orders` + pay-mock | 深度版 |
|
||
|
||
---
|
||
|
||
## 10. 权限设计
|
||
|
||
| 能力 | Visitor | DeepAccess/VIP |
|
||
|---|---|---|
|
||
| 生成基础关系理解 | ✓ | ✓ |
|
||
| 完整相处建议 | ✗ | ✓ |
|
||
|
||
---
|
||
|
||
## 11. 埋点
|
||
|
||
| Event | 触发 |
|
||
|---|---|
|
||
| `relation_started` | 点生成 |
|
||
| `relation_completed` | 基础结果展示 |
|
||
| `deep_access_clicked` | 深度 CTA |
|
||
| `relation_share_clicked` | 分享 |
|
||
| `purchase_completed` | 支付成功 |
|
||
|
||
---
|
||
|
||
## 12. 测试验收标准
|
||
|
||
**Given** 已有 Self
|
||
**When** 填写 TA 并生成
|
||
**Then** 显示双方风格与 diff_one_liner；无权益时无完整 sections
|
||
|
||
**Given** 无 Self
|
||
**When** 点生成
|
||
**Then** 提示去首页建档，不调用成功 insight
|
||
|
||
**Given** 支付深度版
|
||
**When** 刷新报告
|
||
**Then** 沟通/冲突等建议可见
|
||
|
||
---
|
||
|
||
## 13. AI 开发前检查
|
||
|
||
- [x] Spec 齐全 · map 已挂 · lexicon · OpenAPI · 可测
|
||
|
||
---
|
||
|
||
## 14. Implementation Notes
|
||
|
||
| 项 | 内容 |
|
||
|---|---|
|
||
| Packages | `internal/relation` · `service/relation` · `RelationPage` · `ReportRich` |
|
||
| Gaps | 埋点未接；真实支付后置 |
|
||
| Tests | relation engine L1；集成；RelationPage.spec |
|
||
| Process Review | 2026-08-02 [P1-PROCESS-REVIEW](P1-PROCESS-REVIEW.md) · 设计闭合 · 实现 PASS · 测试 PASS |
|