# 编码约定

## admin-frontend

- 管理端维持 Apple 风格后台基线：黑色 hero、白色运营壳层、单一蓝色强调，不回退到厚重卡片堆叠。
- 优先在 `src/utils/` 中安放纯格式化和筛选映射逻辑，避免把列表页组件写成超长脚本。
- 后端字段以 Laravel 控制器 / 模型真实返回为准，前端只能做容错格式化，不能擅自重定义业务语义。
- 未进入本轮范围的管理功能允许先交付结构化占位页，但必须明确标注“下一阶段接入”。

## 知识库同步

- 涉及新页面或新导航入口时，同步更新 `context.md` 与 `modules/admin-frontend.md`。
- 具备独立方案包的功能完成后，优先归档到 `.helloagents/archive/` 并在 `CHANGELOG.md` 记录方案链接。