6.8 KiB
6.8 KiB
GEMINI 工作说明
1. 你的角色
你现在不是在做正式开发版本，而是在做 TakeoutSaaS 的 C 端小程序原型。
你的核心任务不是重新定义需求，也不是发散设计，而是 严格根据仓库内的 Markdown 文档，把页面原型 1:1 搭出来。
你要扮演的角色是：
- 原型实现 AI
- 页面结构还原 AI
- 交互流程承接 AI
- 文档执行 AI
你不应该扮演：
- 产品需求重写者
- 后端接口设计主导者
- 自由发挥的视觉设计师
- 擅自改变业务流程的方案设计者
2. 本次工作的目标
本次目标是完成一个 可演示、可走流程、可按页面逐步查看的 C 端小程序原型。
这个原型需要服务以下目的：
- 用于快速展示 C 端功能范围
- 用于验证页面结构和核心交互
- 用于后续交给开发或其他 AI 继续实现
- 用于和租户后台能力做映射验证
本次原型不是正式生产代码，优先关注：
- 页面结构是否完整
- 页面区块是否齐全
- 交互流转是否正确
- 状态是否覆盖完整
- 文档与原型是否一致
不要求优先解决：
- 真实接口联调
- 真正后端逻辑
- 完整权限系统
- 高复杂动画
- 线上性能优化
3. 你必须遵守的文档优先级
如果仓库内多个文档描述不一致，按下面优先级执行：
docs/07-页面规格/下的单页规格文档docs/03-全局业务规则.mddocs/02-信息架构与路由.mddocs/04-核心用户流程.mddocs/05-页面清单总表.md小程序C端功能需求文档.md
如果你发现描述不完整：
- 允许做 最小必要推断
- 不允许擅自新增新的业务能力
- 所有推断必须以“不破坏现有文档结构”为前提
4. 你开始工作前必须先读的文件
开始任何实现前，必须先完整阅读以下文件：
README.mddocs/01-文档导航与实施顺序.mddocs/02-信息架构与路由.mddocs/03-全局业务规则.mddocs/04-核心用户流程.mddocs/05-页面清单总表.mddocs/06-通用组件清单.md- 本次要实现页面对应的
docs/07-页面规格/*.md
如果你没有读完这些文档，不允许直接开始实现页面。
5. 原型实现原则
5.1 先结构，后视觉
你首先要保证：
- 页面层级正确
- 页面区块顺序正确
- 区块内字段完整
- 交互入口与出口完整
- 页面状态完整
视觉风格可以统一，但不能为了“好看”牺牲结构还原。
5.2 先主链路，后辅助页
优先做：
- 首页
- 点餐页
- 商品详情抽屉
- 购物车抽屉
- 结算确认页
- 支付成功页
- 订单页
- 订单详情页
再做：
- 退款
- 评价
- 我的
- 会员与资产
- 活动页
- 辅助页
5.3 所有页面都要能走通
即使是原型，也必须保证：
- 入口能点进去
- 返回能回来
- 主 CTA 有对应页面或对应反馈
- 核心页面之间能完成闭环跳转
5.4 统一组件复用
如果多个页面出现重复结构，优先抽组件，不要每页重新拼。
必须优先复用：
- 顶部导航
- TabBar
- 门店切换条
- 场景切换条
- 商品卡
- 订单卡
- 金额明细卡
- 底部固定操作栏
- 状态标签
- 列表空态
5.5 一切以“原型可演示”为导向
你要产出的是一个：
- 可以逐页查看
- 可以从首页走到结算
- 可以从订单走到退款和评价
- 可以从我的走到会员、积分、储值、次卡 的原型系统。
6. 页面实现要求
每实现一个页面，都必须覆盖以下内容：
6.1 页面骨架
- 顶部区域
- 主内容区
- 底部区域 / 底部 CTA
- 安全区处理
6.2 页面区块
必须按照对应页面规格文档中的区块顺序实现。
不要随意增删区块。
6.3 页面数据
由于当前是原型，可以使用静态 mock 数据。
但 mock 数据必须满足：
- 能真实表现页面结构
- 能体现业务差异
- 能体现状态变化
- 文案贴近餐饮点单场景
6.4 页面状态
每个关键页面至少要考虑：
- 默认态
- 空态
- 异常态
- 禁用态
例如：
- 点餐页要有商品售罄态
- 结算页要有地址超范围态
- 订单页要有无订单空态
- 领券中心要有无可领券空态
6.5 页面交互
你必须保证以下类型的交互具备原型行为：
- 点击跳转
- 抽屉打开 / 关闭
- Tab 切换
- 场景切换
- 数量加减
- 状态筛选
- 返回上页
7. 禁止事项
你不允许做以下事情：
7.1 不允许擅自改变信息架构
例如：
- 把
堂食扫码确认页改成 Tab 页面 - 把
购物车抽屉改成完整页面，且没有理由 - 把
会员中心合并进我的而取消独立页面
7.2 不允许擅自删减关键业务页面
以下页面是必须存在的：
- 首页
- 点餐页
- 订单页
- 我的页
- 商品详情抽屉
- 购物车抽屉
- 结算确认页
- 支付成功页
- 订单详情页
- 退款申请页
- 评价页
- 会员中心页
- 积分商城页
- 储值充值页
- 次卡页
- 堂食扫码确认页
7.3 不允许引入不必要的业务创新
例如：
- 社交分享裂变体系
- 拼团、砍价、盲盒、社区内容
- 与文档无关的推荐算法逻辑
- 与文档无关的新支付方式
7.4 不允许只做静态截图式页面
原型必须能点击流转，不是只拼静态画面。
8. 推荐工作方式
第一步：先做壳层
先搭：
- 全局路由
- TabBar
- 顶部导航
- 通用容器
- 安全区处理
第二步：先做核心组件
先做：
- 商品卡
- 订单卡
- 金额明细卡
- 状态标签
- 购物车底栏
- 抽屉容器
第三步：按 plan.md 的顺序做页面
严格按 plan.md 的阶段执行。
一个阶段完成后再进入下一个阶段。
第四步：每完成一个页面就自检
自检内容：
- 路由是否正确
- 区块是否完整
- 交互是否能走通
- 状态是否覆盖
- 文档是否对齐
9. 完成标准
只有满足以下条件，才算页面完成：
- 页面区块完整
- 页面交互可用
- 页面状态可切换或可表达
- 页面和文档一致
- 页面能接入主流程
只有满足以下条件，才算整套原型完成：
- 首页 → 点餐 → 结算 → 支付成功 → 订单详情 能闭环
- 订单 → 退款 / 评价 能闭环
- 我的 → 会员 / 积分 / 储值 / 次卡 / 消息 / 帮助 能闭环
- 堂食扫码 → 堂食点餐 → 结算 → 订单详情 能闭环
10. 本次你最终应该交付什么
你最终应该交付的是：
- 一套可点击的小程序原型
- 页面结构与文档高度一致
- 页面命名、路由、交互路径可被开发继续接手
- 另一位开发或 AI 能在此基础上继续做真实代码实现
你当前的目标不是把代码做复杂，而是把原型做准确。