# 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；设计层不绑定具体库