Files

T

jackyu66gitandCursor bd22d9dddd feat: P1 合盘/星座/问答与测测完整设计包及模拟器取证工具

落地 synastry/star/ask API 与 H5 页面，补齐 cece-frontend-re complete-design 证据文档，并加入 Android 模拟器截图抓取脚本。

Co-authored-by: Cursor <cursoragent@cursor.com>

2026-08-03 11:37:53 +08:00

5.8 KiB

Raw Blame History

Feature Spec: 个人画像

Status: Active · Map: 2.1 / 2.3 个人画像 [P1] · Phase: P1
规范：../feature-design.md

1. 功能定义

字段	内容
Name	个人画像（成长画像）
Purpose	帮助用户了解自己的性格特点、沟通/关系/事业/情绪/生活节奏与成长方向
Business Goal	首次体验转化；驱动深度版购买与成长会员；为问答提供档案语境

In	Out
基于生日确定性生成基础 + 深度内容	运势/吉凶/算命叙事
多维报告结构（性格·沟通·关系·事业·情绪·生活）	星盘/塔罗主路径
DeepAccess / 会员解锁 detail	医疗诊断或疗效承诺

2. 用户价值

为何需要： 完成建档后希望快速得到「我是什么样的人」的结构化总结。
完成后获得： 免费基础画像（标题、概述、关键词、六维速览、生活建议）；付费后完整分维分析、优势盲区、成长路径、对话示例、FAQ。
为何付费： 深度内容可执行、可分享前更完整，降低「只有一句话标签」的空洞感。

3. 用户角色

Actor	说明	本功能能力
Visitor	设备身份自动签发 JWT	可建 Self Profile、生成画像、看 summary
User	同上（P1 以 Visitor 为主）	同左
DeepAccess	该 `growth_report` 已购深度版	可见 `detail`
VIP	`memberships` active	可见 `detail`（与 DeepAccess 或关系）

4. 用户流程

首页填写生日 / 已有 Self 档案
  ↓
POST 创建画像报告
  ↓
展示基础结果（summary：overview、dimensions、keywords…）
  ↓
点击深度版？
  ├─ 否 → 分享 / 去关系理解 / 去问答
  └─ 是 → 创建 order(deep_access) → pay-mock
        ↓
      Server 写入 DeepAccess
        ↓
      GET report → detail 完整展示

无档案：引导首页/档案创建（Empty）。

5. 页面设计

路由	页面	说明
`/portrait`	PortraitPage	query: `y,m,d` 或 `report_id`
`/reports/:id`	ReportPage	同报告详情渲染

/portrait
├── Loading
├── Empty（缺生日/档案）
├── Error
├── Normal（基础结果 + 多维速览）
└── Locked（无权益时的深度墙）

6. 页面状态规范

状态	UI
Loading	「正在生成…」
Empty	「请从首页填写生日」+ 链到 `/`
Error	文案 + 重试
Normal	标题、one_liner、ReportRich 基础层
Locked	深度版说明 + 「查看深度版（模拟支付）」

7. Business Rules

ID	Rule
R1	必须有归属用户的 Profile（通常 `relation=self`）才能生成
R2	`summary` 对报告所有者始终可返回；含多维 teaser，不含完整 depth 长文
R3	`detail` 仅当 Membership active 或该报告 DeepAccess 存在时返回
R4	权益仅 Server 判断；客户端 `has_deep_access` 为只读投影
R5	内容确定性：同生日同名 → 同 pattern；禁用词：运势/吉凶/算命/合盘等
R6	深度内容须含分维 sections、strengths、blind_spots、growth_plan、scripts（结构要求）
R7	免责：自我探索与生活方式参考，非医疗/占卜

8. 数据模型影响

表	变更	备注
`profiles`	读	birth_date 必填
`growth_reports`	写 type=`portrait`	summary/detail jsonb
`deep_access` / `orders`	解锁时	见 membership Spec

详见 ../../domain/erd.md。

9. API 需求

Method	Path	意图
POST	`/api/v1/reports/portrait`	body: `profile_id` → 创建/返回报告
GET	`/api/v1/reports/{id}`	按权益剥离 detail
POST	`/api/v1/orders`	`kind=deep_access`, `report_id`
POST	`/api/v1/orders/{id}/pay-mock`	mock 支付生效

OpenAPI：proto/openapi.yaml。

10. 权限设计

能力	Visitor	DeepAccess	VIP
生成画像	✓（己方档案）	✓	✓
看 summary	✓	✓	✓
看 detail	✗	✓	✓

11. 埋点

Event	触发
`portrait_started`	进入生成
`portrait_completed`	基础结果展示
`deep_access_clicked`	点深度版 CTA
`purchase_completed`	pay-mock 成功且 detail 可见
`portrait_share_clicked`	打开分享

12. 测试验收标准

Given 用户已填生日
When 进入画像并生成
Then 显示 headline、overview/多维速览、生活建议；无 detail 长文墙内完整 sections

Given 无会员且无 DeepAccess
When 点击深度版并 mock 支付
Then has_deep_access=true 且分维分析/成长路径可见

Given 篡改前端假装已解锁
When GET report
Then 无权益时 detail 仍不可得

13. AI 开发前检查

Spec 齐全
feature-map 已挂树
lexicon 已核对
OpenAPI 已有 portrait/reports
§12 可测

14. Implementation Notes

项	内容
Packages	`internal/portrait` · `service/report` · `PortraitPage` · `ReportRich`
Migrations	`growth_reports` 等已有
Gaps	埋点 SDK 未接（事件名已定义）；真实支付 P 后
Tests	`portrait` L1；集成 deep_access；H5 PortraitPage.spec
Process Review	2026-08-02 P1-PROCESS-REVIEW · 设计闭合 · 实现 PASS · 测试 PASS

附录：报告结构

免费：title, style_label, headline, keywords, one_liner, overview, life_tip, dimensions[6], strengths_preview
深度：sections[6+], strengths, blind_spots, growth_plan, conversation_scripts, daily_suggestions, faq

5.8 KiB Raw Blame History Unescape Escape