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,150 @@
+# 00 · 设计圣经（全局）
+
+> Design ID: `CECE-FE-BIBLE-V1` · 定稿 · 待模拟器校验项见文末
+
+---
+
+## 1. 产品一句话
+
+以趣味测评与星盘档案为入口，以「问」Tab 级 AI（挂档案）为战略核心，以达人咨询为高客单转化，以会员订阅为主营收的泛心理情感陪伴 App。
+
+---
+
+## 2. 信息架构（冻结）
+
+### 2.1 底部五 Tab（D 定稿）
+
+| 序 | Tab | 路由 key | 视觉（✅ E8 10.50.0） | 战略 |
+|---|---|---|---|---|
+| 1 | 首页 | `home` | 标准 | 发现与工具分发 |
+| 2 | 消息 | `message` | 标准 + 未读数字角标 | 触达与会话入口 |
+| 3 | **问** | `ask` | **中央大圆突出 + AI 角标** | 唯一 Tab 级官方 AI |
+| 4 | 在线 | `online` | 标准 + 运营角标「限免」（可配） | 达人 Marketplace |
+| 5 | 我的 | `mine` | 标准；游客文案「未登录」 | 资产与商业 |
+
+规则：
+- 禁止再增加第 6 个主 Tab。  
+- 灵犀/小智/灵魂伴侣/心情小镇 **不得**升为底部 Tab；一律挂「问」或首页宫格。  
+- 「问」内顶栏固定双轨：`测测AI` | `真人1v1`。
+
+### 2.2 全局导航栈
+
+```text
+RootTabNavigator
+├── HomeStack
+├── MessageStack
+├── AskStack          ← 中央按钮切到此栈
+├── OnlineStack
+└── MineStack
+
+Modal 层：Login · MembershipPaywall · ShareSheet · SystemPermission · ForceUpdate
+```
+
+---
+
+## 3. 全局组件目录（前端必须实现）
+
+| 组件 | 职责 | 出现位置 |
+|---|---|---|
+| `AppTabBar` | 五 Tab；问中间凸起 | 全局 |
+| `ProfileSwitcher` | 自己/TA 档案切换 | 问、星盘、合盘 |
+| `BirthArchiveForm` | 生日/时/地/关系类型 | 建档、了解TA |
+| `PaywallSheet` | 会员/单次解锁 | 报告、AI 额度 |
+| `SharePosterSheet` | 结果卡分享 | 测评、合盘、星盘 |
+| `NetworkBanner` | 离线/弱网 | 全局 |
+| `EmptyState` | 空列表 CTA | 消息、订单、档案 |
+| `ErrorRetry` | 失败重试 | 全局 |
+| `StreamingBubble` | AI 流式回复 | 问 |
+| `ExpertCard` | 达人列表项 | 在线 |
+| `ChartWheel` | 圆形星盘 | 星盘/合盘 |
+| `IndexScoreRow` | 恋爱/友情/婚姻指数 | 合盘 |
+| `GridIcon` | 首页宫格 | 首页 |
+| `FeedCard` | 信息流卡片 | 首页 |
+| `PlazaAppCard` | 玩法广场项 | 广场 |
+| `UnreadBadge` | 角标 | 消息 Tab |
+
+---
+
+## 4. 全局状态机（App）
+
+```mermaid
+stateDiagram-v2
+  [*] --> ColdStart
+  ColdStart --> Bootstrap
+  Bootstrap --> GuestSession
+  Bootstrap --> AuthedSession
+  GuestSession --> AuthModal: gated action
+  AuthModal --> AuthedSession: success
+  AuthedSession --> Offline
+  Offline --> AuthedSession
+  AuthedSession --> ForceUpdate: version low
+  AuthedSession --> Paywall: vip gate
+  Paywall --> AuthedSession
+```
+
+全局枚举：`ColdStart` · `Bootstrap` · `GuestSession` · `AuthedSession` · `AuthModal` · `Offline` · `ForceUpdate` · `Paywall` · `FatalError`。
+
+---
+
+## 5. 设计令牌（结构约定 · 非抄视觉品牌）
+
+> 模拟器采集后可替换为实测色值；此处只定 **语义角色**。
+
+| Token | 角色 |
+|---|---|
+| `--color-brand` | 主操作/问 Tab 强调 |
+| `--color-ai` | AI 标识色 |
+| `--color-vip` | 会员金色系 |
+| `--color-danger` | 错误/删除 |
+| `--color-surface` | 卡片底 |
+| `--color-feed-bg` | 信息流底 |
+| `--radius-card` | 12–16 |
+| `--tab-ask-size` | 中央按钮直径 > 其它 Tab |
+
+动效：Tab 切换 200ms；AI 流式打字；宫格按下缩放 0.96。
+
+---
+
+## 6. 档案为中心的产品定律（D 定稿）
+
+1. 所有深度解读默认绑定 **当前 Profile**。  
+2. 「问」必须支持切换到 **关系档案 TA**。  
+3. 首页持续引导「了解 TA」建档。  
+4. 合盘/匹配最少需要 2 份档案（可快速创建）。  
+5. 无出生时：上升/宫位降级提示，不阻断太阳解读。
+
+---
+
+## 7. 商业门禁（前端表现）
+
+| 能力 | 游客 | 登录免费 | 会员/深购 |
+|---|---|---|---|
+| 浏览首页/部分测评 | ✓ | ✓ | ✓ |
+| 完整测评报告 | teaser | teaser | ✓ |
+| AI 对话 | 登录后有限次 | 有限次 | 扩容 |
+| 合盘指数 | — | ✓ | ✓ |
+| 合盘完整相位/推运文案 | — | teaser | ✓ |
+| 达人咨询 | — | 可下单 | 可下单 |
+| 玩法广场基础 | ✓ | ✓ | 视应用 |
+
+价格文案（展示用，采集后校验）：首月 ¥9.9 · 月 ¥25 · 季 ¥58 · 年 ¥178。
+
+---
+
+## 8. 文案与合规（前端）
+
+- 危机内容：拒答模板 + 热线/转真人。  
+- 免责：探索/娱乐向声明（具体措辞模拟器采集竞品后对齐，愈心谷落地另走 lexicon）。  
+- 未成年人：系统账号年龄门 + 功能裁剪（D：咨询与付费加强校验）。
+
+---
+
+## 9. 待模拟器校验清单（圣经级）
+
+| ID | 校验项 |
+|---|---|
+| V-B01 | 五 Tab 文案与「问」视觉权重 |
+| V-B02 | 全局弹层种类（登录/会员/分享） |
+| V-B03 | 会员价与权益文案 |
+| V-B04 | 主色/AI 色实测 |
+| V-B05 | 游客可点范围 |