jackyu66gitandCursor
bd22d9dddd
落地 synastry/star/ask API 与 H5 页面，补齐 cece-frontend-re complete-design 证据文档，并加入 Android 模拟器截图抓取脚本。 Co-authored-by: Cursor <cursoragent@cursor.com>
251 lines
8.0 KiB
Markdown
251 lines
8.0 KiB
Markdown
# 00 · 测测前端总览（L0 IA · 全功能清单）
|
||
|
||
> Evidence: 以 E1 实测为主 · E2/E3 补充 · E6/E7 标明推断
|
||
|
||
---
|
||
|
||
## STEP 1 — 全局页面组成（App Shell）
|
||
|
||
### 1.1 底部导航（五 Tab）✅ E1
|
||
|
||
| Tab | 视觉权重 | 入口职责 |
|
||
|---|---|---|
|
||
| 首页 | 标准 | 发现 · 工具宫格 · 信息流 · 建档引导 |
|
||
| 消息 | 标准 | AI/达人/社区/系统/商业通知 |
|
||
| **问** | **中央突出 + AI 标识** | 战略入口 → 测测 AI（内含真人 1v1 Tab） |
|
||
| 在线 | 标准 | 达人 Marketplace |
|
||
| 我的 | 标准 | 账号 · 档案资产 · 会员订单 |
|
||
|
||
```text
|
||
┌─────────────────────────────┐
|
||
│ 页面内容区 │
|
||
├──────┬──────┬──────┬────┬───┤
|
||
│ 首页 │ 消息 │ 问* │在线│我的│
|
||
└──────┴──────┴──▲───┴────┴───┘
|
||
│ *中央悬浮突出 + AI 标识
|
||
```
|
||
|
||
### 1.2 全局浮层 / 横切 UI（推导）
|
||
|
||
| 元素 | 来源 | 说明 |
|
||
|---|---|---|
|
||
| 登录/绑定弹层 | 🟡 E6 | 游客触达付费/发帖时 |
|
||
| 会员购买半屏 | ✅ E1 商业描述 | 首月/包月/季/年 |
|
||
| 网络错误 Toast | 🔵 E7 | 全 App |
|
||
| 权限（相册/麦克风）系统弹窗 | 🔵 E7 | 沙盘/连麦/OCR |
|
||
| 青少年/合规提示 | 🟡 E6 | 泛心理合规 |
|
||
| 分享面板（微信/海报） | ✅ E2 裂变叙事 | 测评结果卡 |
|
||
| 角标（消息未读） | 🟡 E6 | 消息 Tab |
|
||
|
||
---
|
||
|
||
## STEP 2 — 前端功能全清单（Feature Inventory）
|
||
|
||
### A. 导航与账号
|
||
|
||
| ID | 功能 | 证据 |
|
||
|---|---|---|
|
||
| NAV-01 | 五 Tab 切换 | ✅ E1 |
|
||
| NAV-02 | 「问」战略权重突出 | ✅ E1 |
|
||
| ACC-01 | 手机/微信/Apple 登录 | ✅ E1 基础信息 |
|
||
| ACC-02 | 游客 → 注册升级 | 🟡 E6 |
|
||
| ACC-03 | 账号设置/注销 | 🔵 E7 |
|
||
|
||
### B. 生命档案（前端核心资产）
|
||
|
||
| ID | 功能 | 证据 |
|
||
|---|---|---|
|
||
| PROF-01 | 创建本人档案（生日/时/地/性别） | ✅ E1 |
|
||
| PROF-02 | 创建关系档案（伴侣/朋友等） | ✅ E1 |
|
||
| PROF-03 | 多档案切换 | ✅ E1（AI 视角选择器） |
|
||
| PROF-04 | 首页「输入生日，更加了解 TA」引导 | ✅ E1 |
|
||
| PROF-05 | 档案编辑/删除 | 🟡 E6 |
|
||
| PROF-06 | 兴趣/状态标签 | 🟡 E4 |
|
||
|
||
### C. 首页工具宫格（快捷入口）✅ E1
|
||
|
||
| ID | 入口文案 | 域 |
|
||
|---|---|---|
|
||
| GRID-01 | I人E人（MBTI） | 测评 |
|
||
| GRID-02 | 星座 | 星座内容 |
|
||
| GRID-03 | 星盘 | 本命/多盘型 |
|
||
| GRID-04 | 缘分合盘 | 合盘+指数 |
|
||
| GRID-05 | 沙盘 | 3D 心理沙盘 |
|
||
| GRID-06 | 陪伴小星 | AI 陪伴子入口 |
|
||
| GRID-07 | 商城 | 电商 |
|
||
| GRID-08 | 倾诉 | 咨询/AI |
|
||
| GRID-09 | AI 玩法广场 | UGC AI 小应用 |
|
||
| GRID-10 | 更多 | 收纳扩展 |
|
||
|
||
「更多」内公开提到（✅ E2）：爱情树（依恋类型）、幸运地图、pick 卡等趣味测。
|
||
|
||
### D. 「问」AI 与双轨
|
||
|
||
| ID | 功能 | 证据 |
|
||
|---|---|---|
|
||
| ASK-01 | 测测 AI 对话 | ✅ E1 |
|
||
| ASK-02 | 顶栏「测测AI ‖ 真人1v1」 | ✅ E1 |
|
||
| ASK-03 | 视角：星盘维度 | ✅ E1 |
|
||
| ASK-04 | 对象：自己 / 已建档 TA | ✅ E1 |
|
||
| ASK-05 | 深度思考模式开关 | ✅ E1 |
|
||
| ASK-06 | 灵魂伴侣子入口（横向滑动） | ✅ E1 |
|
||
| ASK-07 | 预置引导问题（星盘向） | ✅ E1 |
|
||
| ASK-08 | 下拉历史消息 | ✅ E1 |
|
||
| ASK-09 | AI 心情小镇（多虚拟倾诉师） | ✅ E1/E2 |
|
||
| ASK-10 | 灵犀/小智（子场景/模式，非并列 Tab） | ✅ E1 纠正 |
|
||
|
||
### E. 星座 / 星盘 / 合盘 / 运势
|
||
|
||
| ID | 功能 | 证据 |
|
||
|---|---|---|
|
||
| AST-01 | 本命星盘展示与档案切换 | ✅ E3 |
|
||
| AST-02 | 多盘型（报道称可达约 20 种工具盘） | ✅ E3 |
|
||
| AST-03 | 合盘：比较盘/组合盘/时空盘/马克斯盘等 | ✅ E3 |
|
||
| AST-04 | 组合推运等推运变体 | ✅ E3 |
|
||
| AST-05 | 缘分指数（恋爱等） | ✅ E2 |
|
||
| AST-06 | 日/周/月/年运势 | ✅ E3/E4 |
|
||
| AST-07 | 附近的人 / 微信好友连线合盘 | 🟡 E3/行业 + 产品常见；【待真机补证】 |
|
||
|
||
### F. 测评与神秘学工具
|
||
|
||
| ID | 功能 | 证据 |
|
||
|---|---|---|
|
||
| TEST-01 | MBTI（修订量表+分享） | ✅ E1/E2 |
|
||
| TEST-02 | 双人 MBTI/性格关系 | ✅ E2 |
|
||
| TEST-03 | 塔罗抽牌/提问 | ✅ E3 |
|
||
| TEST-04 | 八字/紫微/生命数字等 | ✅ E3 |
|
||
| TEST-05 | 爱情树/幸运地图/pick 卡 | ✅ E2 |
|
||
| TEST-06 | 50+ 心理测试矩阵 | 🟡 E3 口径 |
|
||
|
||
### G. 沉浸体验
|
||
|
||
| ID | 功能 | 证据 |
|
||
|---|---|---|
|
||
| IMM-01 | 3D 心理沙盘 | ✅ E1/E2 |
|
||
| IMM-02 | AI 心情小镇（约 6 人设，含「明朗」） | ✅ E1 |
|
||
|
||
### H. 社区与内容
|
||
|
||
| ID | 功能 | 证据 |
|
||
|---|---|---|
|
||
| SOC-01 | 首页信息流（文章/视频/故事/达人） | ✅ E1 |
|
||
| SOC-02 | 今日运势/热门测试/专家推荐 | ✅ E4 |
|
||
| SOC-03 | AI 玩法广场 UGC 列表（热度/创作者） | ✅ E1 |
|
||
| SOC-04 | 赞评关私信 | 🟡 E4 |
|
||
|
||
### I. 在线达人
|
||
|
||
| ID | 功能 | 证据 |
|
||
|---|---|---|
|
||
| EXP-01 | 达人列表/筛选 | ✅ E1 |
|
||
| EXP-02 | 文字/语音/连麦咨询 | ✅ E1 |
|
||
| EXP-03 | 评价/复购 | 🟡 E6 |
|
||
| EXP-04 | 达人约 2.6 万签约口径 | ✅ E1 官方口径 |
|
||
|
||
### J. 商业化前端
|
||
|
||
| ID | 功能 | 证据 |
|
||
|---|---|---|
|
||
| PAY-01 | 会员：首月 9.9 / 续订 25/月；季 58；年 178 | ✅ E1 |
|
||
| PAY-02 | 报告解锁 / AI 次数 | ✅ E1 |
|
||
| PAY-03 | 咨询下单支付 | ✅ E1 |
|
||
| PAY-04 | 商城 | ✅ E1 宫格 |
|
||
| PAY-05 | 主动压缩干扰广告 | ✅ E1 |
|
||
|
||
### K. 增长
|
||
|
||
| ID | 功能 | 证据 |
|
||
|---|---|---|
|
||
| GRW-01 | 测评结果分享卡 | ✅ E1/E2 |
|
||
| GRW-02 | 邀请好友测 MBTI | ✅ E2 |
|
||
| GRW-03 | 签到/积分/勋章 | 🟡 E4 |
|
||
|
||
---
|
||
|
||
## STEP 3 — 全局用户流程
|
||
|
||
### 3.1 新用户冷启动 ✅ E1 场景
|
||
|
||
```text
|
||
打开 App
|
||
→（可选登录）首页
|
||
→ 点宫格 MBTI / 或看信息流
|
||
→ 完成测评 → 结果页 → 分享/付费墙
|
||
→ 引导建档（生日）
|
||
→ 可进入「问」或合盘
|
||
```
|
||
|
||
### 3.2 关系资产飞轮 ✅ E1
|
||
|
||
```text
|
||
首页「了解 TA」/ AI 对象切换
|
||
→ 录入对方生日建关系档案
|
||
→ AI 基于 TA 星盘回答 / 合盘
|
||
→ 分享结果 → 拉新
|
||
```
|
||
|
||
### 3.3 全局失败路径（必须实现）🔵 E7
|
||
|
||
| 场景 | 前端表现 |
|
||
|---|---|
|
||
| 断网/弱网 | 空态 + 重试；消息/AI 发送失败可重发 |
|
||
| Token 失效 | 跳登录；草稿保留 |
|
||
| 接口超时 | Toast + 重试 |
|
||
| 会员限制 | VIPLocked 半屏 |
|
||
| 余额不足（咨询） | 充值/支付 |
|
||
| 审核失败（UGC） | 说明原因 |
|
||
| 数据为空 | Empty 插画 + CTA |
|
||
|
||
---
|
||
|
||
## STEP 4 — 全局状态机（App Shell）
|
||
|
||
```mermaid
|
||
stateDiagram-v2
|
||
[*] --> Init
|
||
Init --> Loading: 启动
|
||
Loading --> GuestHome: 无登录
|
||
Loading --> AuthedHome: 已登录
|
||
GuestHome --> LoginRequired: 触达 gated
|
||
LoginRequired --> AuthedHome: 登录成功
|
||
AuthedHome --> Offline: 断网
|
||
Offline --> AuthedHome: 恢复
|
||
AuthedHome --> VIPLocked: 点深度权益
|
||
VIPLocked --> AuthedHome: 购买或关闭
|
||
AuthedHome --> Error: 致命错误
|
||
Error --> AuthedHome: 重试
|
||
```
|
||
|
||
页面级状态见各 Tab 文档。
|
||
|
||
---
|
||
|
||
## 页面路由树（前端逻辑路由 · 推导）
|
||
|
||
```text
|
||
/ 首页
|
||
/message 消息
|
||
/ask 问（默认 AI）
|
||
/ask?mode=human 真人1v1
|
||
/online 在线达人列表
|
||
/online/:expertId 达人详情
|
||
/consult/:sessionId 咨询会话
|
||
/mine 我的
|
||
/profile/list 档案列表
|
||
/profile/edit/:id 档案编辑
|
||
/tools/mbti MBTI
|
||
/tools/chart 星盘
|
||
/tools/synastry 缘分合盘
|
||
/tools/sandbox 沙盘
|
||
/tools/plaza AI玩法广场
|
||
/tools/plaza/:appId 玩法详情
|
||
/tools/tarot 塔罗
|
||
/tools/bazi 八字…
|
||
/membership 会员
|
||
/orders 订单
|
||
/shop 商城
|
||
/mood-town AI心情小镇
|
||
```
|
||
|
||
路径名为 🔵 工程命名；测测真实 Deep Link 【待真机补证】。
|