jackyu66gitandCursor
13860bf1ef
每账号仅一条 self（migration 40902）；合盘只选 TA；账号昵称可改；首页穿衣/颜色/养生贴士。 Co-authored-by: Cursor <cursoragent@cursor.com>
2.7 KiB
2.7 KiB
BD-2026-011 — Identity · Home tips · Profile integrity
Status: Approved
ECR: ECR-011
Date: 2026-08-12
Approved: 2026-08-12（随 ECR-011 Human Approve）
Change Level: L2
Risk: Medium
Context
- 问题：重复 self；合盘/档案展示不一致；缺昵称与首页贴士契约门禁
- 非目标：社交关系链、真推送、医疗建议
- Spec：profile · star-profile · account-auth · home
Backend Change Boundary
In
| Area | Change |
|---|---|
| Migration | 000017：软删 rn>1 的 self；UNIQUE (user_id) WHERE relation='self' AND deleted_at IS NULL |
| nickname | internal/nickname：100×100 词库 · Random · Normalize |
| auth | 注册/回填空昵称；UpdateNickname；PATCH /auth/me → 40902 语义外的校验错误用既有码 |
| profile | CountActiveSelf；Create self 已存在 → ErrSelfExists → HTTP 409 / code 40902 |
| report | CreateSynastry：同 id 拒绝；本账号 B 须 other；附近仍允许他人 geo-visible self |
| home | GET /home/daily-tips：生日+本地时 → yijing seed → DeepSeek JSON；失败回退 |
| OpenAPI | /auth/me PATCH · /home/daily-tips |
Out
- Handler 直连 DB · 新外部依赖（除既有 DeepSeek）· 硬删 profiles
Ownership
| Layer | Owner |
|---|---|
| Repository | AuthRepo · ProfileRepo |
| Service | auth · profile · home · report |
| Handler | AuthHandler · ProfileHandler · HomeHandler |
| UI | user-h5 Profile / Home / Synastry / Portrait·Star·Rhythm·Cards |
Architecture Change
- 分层边界：No（无需新 ADR）
- 受影响层：API · Application · Infrastructure(migration) · H5
Data Flow
Register/Login → nick empty? → nickname.Random → users.nickname
PATCH /auth/me → Normalize → UpdateNickname
POST /profiles self → CountActiveSelf>0? 409 : Insert
GET /profiles → List（H5 用 ensure* / pickable 过滤）
POST /reports/synastry → A owned · B other|nearby self
GET /home/daily-tips → Self birth? → seed → LLM|fallback → tips JSON
Failure / Rollback
- down：
DROP INDEX idx_profiles_one_self_per_user（不自动恢复已软删行） - LLM 失败：返回
source=fallback，HTTP 仍 200 - 40902：前端 ensureSelf 捕获后改走 update
Test Strategy
- go：
internal/nickname· profile Create 冲突（integration 或 service） - H5：Synastry 隐藏重复 self · ImageCard/Portrait 经 ensureSelf · Profile 昵称卡
- 手工：档案仅 1 个我；合盘 TA 无多个我；改昵称首页同步；贴士有/无生日
Rollback plan
- 回滚应用版本；保留 migration 索引（安全）或执行 down（仅删索引）
- 关闭 DeepSeek 配置 → 贴士自动 fallback