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

3.9 KiB

Raw Blame History

Feature Spec: <Name>

复制本文件为 <id>.md。规范：../feature-design.md
语言：../lexicon.md · 能力树：../feature-map.md
Status: Draft | Active | Deprecated
Map node: （如 2.3 个人画像 [P1]）
Phase: P1 | P2 | P3

1. 功能定义

字段	内容
Name
Purpose
Business Goal

In Scope / Out of Scope（防止偷偷扩 scope）

In	Out

2. 用户价值

必须回答：

用户为什么需要它？
用户完成后获得什么？
为什么愿意付费？（若无付费面，写 N/A）

3. 用户角色

对齐当前 Identity（Visitor 设备身份 + 可选升级）。写清实际能做什么，勿照搬竞品。

Actor	说明	本功能能力
Guest / Visitor	未登录设备身份
User	已有持久用户/档案
VIP	成长会员 active
DeepAccess	单份报告深度版已购

4. 用户流程

进入
 ↓
…

或 mermaid。必须含：无数据分支、权益分支、失败分支（可简写并在 §6 展开）。

5. 页面设计

对照 ../page-tree.md。

路由	页面	说明

页面结构示例：

/path
├── Empty State
├── Loading State
├── Result / Normal State
└── Locked State

6. 页面状态规范

状态	说明	UI 行为
Loading	请求中
Empty	无数据	引导去哪
Error	失败	重试/返回
Normal	成功
Locked	付费/权益限制	CTA

7. Business Rules

编号规则；权益与归属必须在 Server 判定。

ID	Rule
R1
R2

8. 数据模型影响

指向 ../../domain/erd.md。新增/变更表字段列表；无则写「无 schema 变更」。

表	变更	备注

9. API 需求

路径级意图即可；字段细节以 proto/openapi.yaml 为准，实现时必须同步 OpenAPI。

Method	Path	意图

Response 权益意图示例：summary 始终按规则返回；detail 无权益时剥离或 null。

10. 权限设计

能力	Visitor	User	DeepAccess	VIP
查看基础
查看完整
写入/生成

11. 埋点

未接分析 SDK 也先定义事件名。

Event	触发
`<feature>_started`
`<feature>_completed`
`deep_access_clicked`
`purchase_completed`

12. 测试验收标准

主路径

Given …
When …
Then …

权益 / 异常