前端

适用对象

给 Vben/Vue 页面开发、生成页面修复、路由权限排查和 AI 前端协作使用。

入口

• 应用目录：oars-web/apps/web-antd
• 前端 FAQ：oars-web/docs/frontend-faq.md
• 路由目录：oars-web/apps/web-antd/src/router
• 请求封装：oars-web/apps/web-antd/src/api/request.ts

关键约定

• 页面优先使用现有 Ant Design Vue、Iconify 和项目组件；后台管理页保持高信息密度。
• 自定义页面要兼容亮色/暗色主题，局部 CSS 变量放根节点，暗色用全局 .dark 覆盖。
• 请求层统一加 Authorization: Bearer <token> 和 Accept-Language；GET 会加 _t 避免菜单等缓存。
• 后端返回 code: 200 视为成功，数据取 data。
• 权限来自用户 permissions，路由 meta.authority 任一命中即可访问。
• Windows Vite 8 native binding 问题优先看 oars-web/docs/frontend-faq.md，不要只盯 pnpm dev 外层报错。

实现位置

• 请求客户端：oars-web/apps/web-antd/src/api/request.ts
• 动态菜单权限：oars-web/apps/web-antd/src/router/access.ts
• 后端菜单转换：oars-web/apps/web-antd/src/router/menu-transform.ts
• 开发态生成器路由：oars-web/apps/web-antd/src/router/routes/external/dev.ts
• 生成器页面：oars-web/apps/web-antd/src/views/dev/module-generator

待确认事项

• 生成页面的长期样式问题应改生成器模板还是改单页，需要按影响范围判断。
• 移动端页面和后台页面的组件复用边界还需要补文档。