Spec文档拆分单元
拆分文档提示词
- 提示词
bash
我正在开发WanderChina首页。首页包含以下功能区域:
1. **Hero区** — 品牌主视觉背景图 + 品牌标语(结合上下文背景生成一条) + 副标题(结合上下文背景生成一条) + 搜索框
2. **热门帖子** — 按过去7天Upvote数排序的社区帖子Top 10
3. **热门景点** — 按浏览量排序的景点推荐,展示6-8个城市卡片
4. **城市快速入口** — 8个MVP城市的图标网格,点击进入对应城市攻略页
5. **AI助手入口** — 悬浮按钮或顶部入口,随时唤起AI对话
6. **功能导航栏** — 三大平台入口卡片--旅游社区(图标+标题+一句话描述)、景点攻略(图标+标题+一句话描述)、AI助手(图标+标题+一句话描述)
请将这个页面拆分为独立的Spec开发单元。
拆分标准:每个单元可独立开发、独立测试、独立交付。
输出:文件名 / 一句话描述 / 数据依赖 / 与其他单元依赖
注意 我要求产出的是每个模块的.md文件最后生成的结果
- 它会生成几个md文件,每个文件对应一个开发单元
- 截取部分内容如下
一、开发单元清单(9 个)
| # | 文件名 | 一句话描述 | 数据依赖 | 与其他单元依赖 |
|---|---|---|---|---|
| H-01 | home-01-hero.spec.md | 渲染品牌主视觉、标语与副标题,并提供搜索框 UI 骨架(本期占位,点击提示下个版本开放) | home_hero_config(banner_url / slogan / subtitle 静态配置);无搜索数据源 | 无上游依赖;搜索框跳转目标待定;为 H-07 提供首屏内容 |
| H-02 | home-02-hot-posts.spec.md | 按过去 7 天 Upvote 数倒序展示社区 Top 10 帖子卡片 | post、app_user、post_upvote(本期新增实体);聚合口径 = created_at >= NOW()-7d 的 upvote 计数 DESC LIMIT 10 | 依赖 H-08 聚合接口;依赖 M3 社区提供 upvote 写入(阻塞项,见冲突 C1);与 H-06「旅游社区」卡片共享跳转目标 |
| H-03 | home-03-hot-scenic.spec.md | 按浏览量倒序展示 6–8 个景点卡片(中英名称、封面、城市标签) | scenic_spot + 新增 view_count 字段与浏览埋点;排序 = view_count DESC LIMIT 6~8 | 依赖 H-08 接口;点击跳 M2 景点详情(与 H-04 跳城市列表是不同契约);与 H-04 共用城市维度数据但粒度不同 |
| H-04 | home-04-city-entry.spec.md | 8 个 MVP 城市的图标网格,点击进入对应城市攻略页 | city_entry(8 行种子数据:city / name_en / name_zh / icon_url / sort_order / status) | 依赖 H-09 种子数据;跳 M2 城市攻略页(契约 ?city=<code>);向 H-05 输出 current_city(localStorage) |
| H-05 | home-05-ai-entry.spec.md | 顶部图标 + 右下悬浮按钮,随时唤起 AI 对话并带入当前城市上下文 | ai_entry_config(entry_type / enabled / route) | 依赖 H-04 输出的 current_city(可空);跳 M4 并写 chat_session.context_city;与 H-06「AI助手」卡片共用同一路由常量 |
| H-06 | home-06-nav-cards.spec.md | 三张平台入口卡片(旅游社区 / 景点攻略 / AI助手),每张含图标 + 标题 + 一句话描述 | nav_card_config(3 行:code / icon / title_en/zh / desc_en/zh / route) | 依赖 H-09 配置;分别跳 M3 / M2 / M4;替代 V1.1 的底部 4 Tab 方案(见冲突 C4);与 H-05 共享 AI 助手路由 |
| H-07 | home-07-shell.spec.md | 页面装配单元:按 Hero → 热门帖子 → 热门景点 → 城市入口 → 功能导航栏顺序编排,并管理 current_city 全局状态 | 无业务数据,只做编排 | 依赖 H-01~H-06 全部单元作为子组件;用 mock 数据即可独立开发与测试;向 H-04/H-05 提供全局状态容器 |
| H-08 | home-08-api.spec.md | 后端只读聚合接口:/api/home/feed、/api/home/cities、/api/home/ai-entry,集中定义排序规则 | MySQL 多表:post / post_upvote / scenic_spot / city_entry / ai_entry_config / nav_card_config / home_hero_config | 被 H-01~H-06 调用;是全部前端单元的数据契约来源;建议最先开发(契约先行,前端可并行 mock) |
| H-09 | home-09-config.spec.md | 静态配置与种子数据单元:Hero 文案、8 城数据、3 张导航卡文案、AI 入口显隐的初始化脚本 | 无外部业务数据 | 为 H-01 / H-04 / H-05 / H-06 / H-08 提供配置与种子数据;可最先交付,不依赖任何单元 |