本文件只记录 B 端管理后台的项目级约束;完整规则(目录、命名、路由、HTTP、认证、状态、TypeScript、验证、静态值治理)见 前端开发规范。
- 实践顺序、解锁条件和完成状态只以 实践计划与进度 为准。
- 后端接口文档:
http://localhost:8080/api/swagger-ui/index.html。 - API 基础地址只从
VITE_API_BASE_URL读取。 - 不创建 Mock 业务数据替代后端契约;未经实践计划明确解锁,不创建新的业务页面、接口调用或前端业务依赖。
- 管理后台面向桌面浏览器,不做移动端适配,不要求移动端布局验证。
- 管理页面优先紧凑、稳定、可扫描;表格、筛选、分页、操作反馈是管理页默认能力。
- 禁止营销式 hero、装饰性大卡片、卡片嵌套卡片。
前端通用验证命令与浏览器验证要求见规范第 12 节。涉及路由、登录、权限、布局时,必须浏览器验证对应路径。