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
parent 15a9db374a
commit bd22d9dddd
248 changed files with 26309 additions and 842 deletions
@@ -0,0 +1,126 @@
+# 20 · 星座工具完整设计（星盘 / 合盘 / 运势）
+
+> Design Complete · 愈心谷落地时命名走 STRATEGY / 词表
+
+---
+
+## 1. 信息架构
+
+```
+工具入口（首页/广场）
+├── 星盘（本命）
+│   ├── 档案选择 / 新建
+│   ├── 概览（太阳/月亮/上升 + 象限）
+│   ├── 行星列表
+│   ├── 宫位列表
+│   ├── 相位表
+│   ├── 深度解读（付费锁）
+│   └── 分享卡片
+├── 合盘
+│   ├── 双档案选择
+│   ├── 关系类型（恋爱/友情/亲子…）
+│   ├── 五图 + 推运（as_of）
+│   ├── 维度评分
+│   ├── 深度报告（付费）
+│   ├── 邀请合盘（token）
+│   └── 附近的人（geo）
+└── 今日运势
+    ├── 日运卡片
+    ├── 周/月切换
+    └── 推送订阅
+```
+
+---
+
+## 2. 星盘页 `NatalChartPage`
+
+### 2.1 Route
+
+`/tools/natal` · query: `profile_id?`
+
+### 2.2 UI
+
+| 区块 | 说明 |
+|---|---|
+| `ProfilePicker` | Self 默认；可切 Other |
+| `ChartWheel` | 外圈宫位 + 行星 glyph；可缩放旋转（定稿：双指缩放） |
+| `BigThree` | 日/月/升 三卡 |
+| `Tabs` | 概览 / 行星 / 宫位 / 相位 / 解读 |
+| `PaywallBanner` | 深度解读锁态 |
+
+### 2.3 状态
+
+`NeedProfile` → `Computing` → `Ready` → `Paywalled` / `Unlocked` · `Error`
+
+### 2.4 API
+
+- `GET /v1/profiles` · `POST /v1/profiles`
+- `POST /v1/reports/natal` body: `{ "profile_id": "" }`
+- 响应：`summary`（免费）+ `detail`（锁字段）+ `charts.natal`
+
+### 2.5 校验
+
+`V-N01` 轮盘交互 · `V-N02` 深度锁点 · `V-N03` 分享卡片字段
+
+---
+
+## 3. 合盘页 `SynastryPage`（对齐已实现能力）
+
+### 3.1 Route
+
+`/tools/synastry` · `/synastry/invite/:token`
+
+### 3.2 UI 定稿
+
+| 区块 | 说明 |
+|---|---|
+| 双人档案条 | A/B 头像昵称 + 换人 |
+| 关系类型 Chip | 恋爱默认 |
+| 五图 Tab | 比较盘/组合盘/组合中点/时空中点/组合星座 — 与 API `charts` 对齐 |
+| 推运 | `as_of` 日期选择；Progressed 说明文案 |
+| 维度雷达/条 | 吸引/沟通/信任/长期… |
+| 深度报告 CTA | 会员或单次解锁 |
+| 社交 | 「邀请合盘」「附近的人」 |
+
+### 3.3 附近的人
+
+- 需用户显式打开 `geo_visible`
+- 列表：距离档位 + 合盘入口
+- 隐私：不暴露精确坐标给对方客户端
+
+### 3.4 API（已有契约优先）
+
+- `POST /v1/reports/synastry` `{ profile_id_a, profile_id_b, as_of? }`
+- `GET /v1/synastry/nearby`
+- `POST /v1/synastry/invites` · `GET /v1/synastry/invites/:token` · `POST .../accept`
+
+### 3.5 校验
+
+`V-S01` 五图 Tab 文案与顺序 · `V-S02` 邀请链路 · `V-S03` 附近隐私开关默认
+
+---
+
+## 4. 今日运势 `DailyFortunePage`
+
+### 4.1 UI
+
+日期头 · 综合分 · 爱情/事业/财运/健康四格 · 短建议 ·「查看完整」（会员）
+
+### 4.2 API
+
+`GET /v1/fortune/daily?profile_id=&date=`
+
+### 4.3 校验
+
+`V-F01` 分数字段 · `V-F02` 完整内容锁点
+
+---
+
+## 5. 埋点统一
+
+`tool_open{tool}` · `chart_tab{name}` · `synastry_generate` · `synastry_unlock` · `fortune_expose` · `invite_share` · `nearby_open`
+
+## 6. 愈心谷落地备注
+
+- UI 禁用「占卜/算命」；可用运势/合盘/匹配/解读
+- 星历计算依赖与 AGPL 风险见 API README；设计层不绑定具体库