jackyu66gitandCursor
bd22d9dddd
落地 synastry/star/ask API 与 H5 页面，补齐 cece-frontend-re complete-design 证据文档，并加入 Android 模拟器截图抓取脚本。 Co-authored-by: Cursor <cursoragent@cursor.com>
4.9 KiB
4.9 KiB
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 全局导航栈
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）
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 定稿）
- 所有深度解读默认绑定 当前 Profile。
- 「问」必须支持切换到 关系档案 TA。
- 首页持续引导「了解 TA」建档。
- 合盘/匹配最少需要 2 份档案（可快速创建）。
- 无出生时：上升/宫位降级提示，不阻断太阳解读。
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 | 游客可点范围 |