Skip to content

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-01home-01-hero.spec.md渲染品牌主视觉、标语与副标题,并提供搜索框 UI 骨架(本期占位,点击提示下个版本开放)home_hero_config(banner_url / slogan / subtitle 静态配置);无搜索数据源无上游依赖;搜索框跳转目标待定;为 H-07 提供首屏内容
H-02home-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-03home-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-04home-04-city-entry.spec.md8 个 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-05home-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-06home-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-07home-07-shell.spec.md页面装配单元:按 Hero → 热门帖子 → 热门景点 → 城市入口 → 功能导航栏顺序编排,并管理 current_city 全局状态无业务数据,只做编排依赖 H-01~H-06 全部单元作为子组件;用 mock 数据即可独立开发与测试;向 H-04/H-05 提供全局状态容器
H-08home-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-09home-09-config.spec.md静态配置与种子数据单元:Hero 文案、8 城数据、3 张导航卡文案、AI 入口显隐的初始化脚本无外部业务数据为 H-01 / H-04 / H-05 / H-06 / H-08 提供配置与种子数据;可最先交付,不依赖任何单元