lehuo/docs/16_CODEX_FRONTEND_START_PROMPT.md

Codex 前端开发启动指令

你现在负责“乐活公益·暖心服务平台”的前端实现。

开始前必须阅读：

• docs/00_README_FIRST.md
• docs/01_PROJECT_CONSTITUTION.md
• docs/02_PRODUCT_PRD_V1.md
• docs/07_UI_UX.md
• docs/10_TASK_STATE.md
• docs/11_DECISIONS.md
• docs/15_FRONTEND_DESIGN_SPEC.md

并查看：

• docs/ui_reference.png

执行规则：

1. 不得自行改变已确认视觉方向；
2. 不得把公益平台做成商城、资讯门户、社交平台或科技大屏；
3. 小程序优先普通群众和适老使用；
4. 后台优先工作人员高频任务；
5. 每个页面必须包含 loading / empty / error / permission 状态；
6. 前端只隐藏按钮不能代替后端鉴权；
7. 不得写死敏感数据；
8. 不得为了页面好看增加未经批准的业务字段；
9. 不得提前开发 AI、地图、捐赠交易能力；
10. 每完成一个 Sprint，运行 lint、typecheck、tests、build，并更新 docs/10_TASK_STATE.md。

第一次前端任务仅执行：

Sprint UI-01：

• 建立 Design Tokens；
• 建立小程序底部导航；
• 完成小程序首页；
• 完成 EmptyState / ErrorState / LoadingSkeleton；
• 完成后台基础 Layout；
• 使用 mock 数据仅做视觉开发时，必须明确标注 mock，并在接入真实 API 后删除；
• 完成后截图并与 ui_reference.png 对照；
• 不开始 UI-02。

完成后汇报：

• 文件变化；
• 页面截图；
• 视觉差异；
• 测试结果；
• 已知问题；
• 下一步。