jackyu66gitandCursor
bd22d9dddd
落地 synastry/star/ask API 与 H5 页面，补齐 cece-frontend-re complete-design 证据文档，并加入 Android 模拟器截图抓取脚本。 Co-authored-by: Cursor <cursoragent@cursor.com>
152 lines
3.0 KiB
Markdown
152 lines
3.0 KiB
Markdown
# Feature Spec: 首页（发现与入口）
|
||
|
||
> Status: `Active` · Map: `§1 首页 [P1]` · Phase: `P1`
|
||
> 规范：[../feature-design.md](../feature-design.md)
|
||
|
||
---
|
||
|
||
## 1. 功能定义
|
||
|
||
| 字段 | 内容 |
|
||
|---|---|
|
||
| Name | 首页 |
|
||
| Purpose | 品牌露出 + 建档/性格探索主 CTA + 功能入口分发 |
|
||
| Business Goal | 新用户进入 Step 1–3；品牌第一屏可识别 |
|
||
|
||
| In | Out |
|
||
|---|---|
|
||
| 建档生日表单 → 画像；九宫格/入口 | 运势 Feed 主路径 |
|
||
| 推荐区静态/轻运营即可 | Dashboard 式状态墙（如「API 已连接」勿对用户展示） |
|
||
|
||
---
|
||
|
||
## 2. 用户价值
|
||
|
||
1. **为何需要：** 知道从哪开始认识自己。
|
||
2. **完成后获得：** 一键进入画像主路径或其它 Tab。
|
||
3. **付费：** N/A。
|
||
|
||
---
|
||
|
||
## 3. 用户角色
|
||
|
||
| Actor | 能力 |
|
||
|---|---|
|
||
| 新 Visitor | 见品牌 + 建档 CTA |
|
||
| 老用户 | 同样入口；可去「我的」看资产 |
|
||
|
||
---
|
||
|
||
## 4. 用户流程
|
||
|
||
```text
|
||
打开 /
|
||
↓
|
||
看到品牌 + 主 CTA（生日/探索）
|
||
↓
|
||
提交生日 → 创建档案 → /portrait
|
||
或
|
||
点入口 → /explore /relation /ask /membership …
|
||
```
|
||
|
||
设计约束（前端）：品牌英雄级信号；移动优先；文案 lexicon。
|
||
|
||
---
|
||
|
||
## 5. 页面设计
|
||
|
||
| 路由 | 页面 |
|
||
|---|---|
|
||
| `/` | HomePage |
|
||
| 全局 | AppHeader · TabBar |
|
||
|
||
```text
|
||
/
|
||
├── Hero / 品牌
|
||
├── 建档 CTA
|
||
├── 功能入口
|
||
└── （可选）推荐内容
|
||
```
|
||
|
||
---
|
||
|
||
## 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 开发前检查
|
||
|
||
- [x] Spec 齐全
|
||
|
||
---
|
||
|
||
## 14. Implementation Notes
|
||
|
||
| 项 | 内容 |
|
||
|---|---|
|
||
| Packages | `HomePage` · `App.vue` shell |
|
||
| Gaps | 推荐 Feed 运营位可静态；埋点未接 |
|
||
| Process Review | 2026-08-02 [P1-PROCESS-REVIEW](P1-PROCESS-REVIEW.md) · 设计闭合 · 实现 PASS · 测试 PARTIAL |
|