jackyu66gitandCursor
89756f65b4
落地输入合规、探索题库、报告日/时辰刷新、账号头像、OEJTS 量表，并补齐 H5 埋点与 Admin 漏斗；同步 ESS 工件、切至自建 Git、清理 GitHub Actions。 Co-authored-by: Cursor <cursoragent@cursor.com>
130 lines
3.5 KiB
Markdown
130 lines
3.5 KiB
Markdown
# Feature Spec: 生日包生成（档案引导）
|
||
|
||
> Status: `Active` · Map: `1.1 个人档案` · Phase: `P1`
|
||
> 关联：[account-auth.md](account-auth.md) · [profile.md](profile.md) · [portrait.md](portrait.md) · [star-profile.md](star-profile.md)
|
||
|
||
---
|
||
|
||
## 1. 功能定义
|
||
|
||
| 字段 | 内容 |
|
||
|---|---|
|
||
| Name | 生日衍生数据一次生成与覆盖 |
|
||
| Purpose | 输入/修改生日后服务端一次性生成并落库；结果页优先读缓存 |
|
||
| Business Goal | 降低重复输入；保证本人与 TA 数据归属同一账号 |
|
||
|
||
| In | Out |
|
||
|---|---|
|
||
| Self / Other 档案创建与生日变更触发 | 无档案凭空出合盘 |
|
||
| 单人：portrait · star · rhythm（star/rhythm 运势与今日建议按自然日在 GET 时原地刷新，见各 Spec） | 意象卡片抽牌（配额玩法，不预生成） |
|
||
| 有 Self+Other：relation + synastry 成对覆盖 | 附近的人合盘（进页再算） |
|
||
|
||
---
|
||
|
||
## 2. 用户价值
|
||
|
||
1. 填一次生日，解码/星座/节律可直接看。
|
||
2. 添加的 TA 挂在账号下；与本人关系/合盘一并备好。
|
||
3. 改生日自动覆盖旧结果。
|
||
|
||
---
|
||
|
||
## 3. 用户角色
|
||
|
||
仅 **已登录 User**。Visitor 被鉴权拦截。
|
||
|
||
---
|
||
|
||
## 4. 用户流程
|
||
|
||
```text
|
||
登录 → 创建/编辑档案（含生日）
|
||
↓
|
||
Server GenerateBundle(profile)
|
||
├─ 单人报告：portrait / star / rhythm（同 type 软删旧 → 新建）
|
||
└─ 若存在配对：self×each other → relation + synastry 覆盖
|
||
↓
|
||
结果页：GET latest by profile+type（无则引导档案，不强制再填生日）
|
||
```
|
||
|
||
---
|
||
|
||
## 5. 页面设计
|
||
|
||
| 路由 | 行为变更 |
|
||
|---|---|
|
||
| `/portrait` `/star` `/rhythm` | 有 Self → 读 latest；无 → 引导 `/profile` 或登录 |
|
||
| `/relation` `/synastry` | 选已有 Self+TA → 读 latest pair；缺则引导加档案 |
|
||
| `/profile` | 创建/改生日后展示「已生成」提示 |
|
||
|
||
---
|
||
|
||
## 6. 页面状态规范
|
||
|
||
| 状态 | UI |
|
||
|---|---|
|
||
| Loading | 生成中/拉取中 |
|
||
| Empty | 无档案 → 去建档；未登录 → 去登录 |
|
||
| Normal | 展示缓存报告 |
|
||
| Error | 重试 |
|
||
|
||
---
|
||
|
||
## 7. Business Rules
|
||
|
||
| ID | Rule |
|
||
|---|---|
|
||
| R1 | 仅登录用户可写档案 |
|
||
| R2 | Create/Update 若 birth_date（或 time/place）相对旧值变化 → GenerateBundle |
|
||
| R3 | 覆盖=同 user + profile + type（+ peer）软删旧报告再插入 |
|
||
| R4 | Other 档案 `user_id` 必须=当前账号；删除 Other 时软删其单人报告及含其 peer 的配对报告 |
|
||
| R5 | 结果页不得再要求重复输入已知生日，除非用户主动改档案 |
|
||
|
||
---
|
||
|
||
## 8. 数据模型影响
|
||
|
||
- `growth_reports.peer_profile_id` nullable（配对报告）
|
||
- 索引便于 latest 查询
|
||
|
||
---
|
||
|
||
## 9. API 需求
|
||
|
||
| Method | Path | 说明 |
|
||
|---|---|---|
|
||
| POST/PATCH | `/profiles` | 成功后服务端同步 GenerateBundle |
|
||
| GET | `/reports/latest` | `profile_id` · `type` · 可选 `peer_profile_id` |
|
||
|
||
现有 POST `/reports/*` 保留（幂等覆盖），供重算；主路径以 latest 为准。
|
||
|
||
---
|
||
|
||
## 10. 权限设计
|
||
|
||
同 account-auth：必须 User。
|
||
|
||
---
|
||
|
||
## 11. 埋点
|
||
|
||
`profile_bootstrap_done` · `report_cache_hit`
|
||
|
||
---
|
||
|
||
## 12. 测试验收标准
|
||
|
||
| Given | When | Then |
|
||
|---|---|---|
|
||
| 登录用户建 Self | POST profile | DB 有 portrait/star/rhythm |
|
||
| 再加 Other | POST other | 有 relation+synastry 相对 Self |
|
||
| 改 Self 生日 | PATCH | 旧报告 soft-deleted，新报告可读 |
|
||
| 登录用户开 /portrait | GET latest | 无需再填生日 |
|
||
|
||
---
|
||
|
||
## 13. AI 开发前检查
|
||
|
||
- [x] 合盘不造假 TA
|
||
- [x] lexicon：愈心解码 / 星座 / 合盘 / 个人档案
|