# 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。

完成后汇报：

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