Feature Spec: 首页(发现与入口)
Status: Active · Map: §1 首页 [P1] · Phase: P1
规范:../feature-design.md
1. 功能定义
| 字段 |
内容 |
| Name |
首页 |
| Purpose |
品牌露出 + 建档/性格探索主 CTA + 功能入口分发 |
| Business Goal |
新用户进入 Step 1–3;品牌第一屏可识别 |
| In |
Out |
| 建档生日表单 → 画像;九宫格/入口 |
运势 Feed 主路径 |
| 推荐区静态/轻运营即可 |
Dashboard 式状态墙(如「API 已连接」勿对用户展示) |
2. 用户价值
- 为何需要: 知道从哪开始认识自己。
- 完成后获得: 一键进入画像主路径或其它 Tab。
- 付费: N/A。
3. 用户角色
| Actor |
能力 |
| 新 Visitor |
见品牌 + 建档 CTA |
| 老用户 |
同样入口;可去「我的」看资产 |
4. 用户流程
设计约束(前端):品牌英雄级信号;移动优先;文案 lexicon。
5. 页面设计
| 路由 |
页面 |
/ |
HomePage |
| 全局 |
AppHeader · TabBar |
6. 页面状态规范
| 状态 |
UI |
| Normal |
主路径可见 |
| Error |
建档/跳转失败可感知 |
| Loading |
提交建档时按钮态 |
Empty:首页本身是入口,不因无档案空白死页。
7. Business Rules
| ID |
Rule |
| R1 |
主 CTA 必须通向建档或画像,而非死链 |
| R2 |
不展示内部运维信息(API 连接状态等) |
| R3 |
入口文案符合 lexicon(个人画像/关系理解/成长会员…) |
| R4 |
Tab 五名冻结:首页·探索·问答·陪伴·我的 |
8. 数据模型影响
经首页建档时写 profiles(见 profile Spec)。
9. API 需求
复用 POST /profiles、POST /reports/portrait;无专用 home API。
10. 权限设计
| 能力 |
Visitor |
| 浏览首页 |
✓ |
| 建档并生成画像 |
✓ |
11. 埋点
| Event |
触发 |
home_viewed |
打开 |
home_cta_portrait |
主 CTA |
home_entry_click |
九宫格项(带 name) |
12. 测试验收标准
Given 新用户
When 打开首页
Then 可见品牌与建档/探索入口
Given 合法生日
When 提交主 CTA
Then 进入画像基础结果路径
13. AI 开发前检查
14. Implementation Notes
| 项 |
内容 |
| Packages |
HomePage · App.vue shell |
| Gaps |
推荐 Feed 运营位可静态;埋点未接 |
| Process Review |
2026-08-02 P1-PROCESS-REVIEW · 设计闭合 · 实现 PASS · 测试 PARTIAL |