前端约定

主应用在 oars-web 的 Ant Design Vue 工程中。

请求

• 统一附加 Authorization: Bearer <token>。
• 后端 code: 200 视为成功，页面使用返回体里的 data。
• 401 会尝试刷新令牌；刷新失败回到登录。

菜单与页面

运行时使用 backend 模式：侧栏和可访问页面来自后端菜单，而不是在 routes/modules/ 下继续加静态业务路由（该目录已废弃）。

客户二开页面优先放在插件目录，随插件一起升级：

oars-web/apps/web-antd/src/plugins/<插件标识>/

需要进侧栏时，由生成结果或菜单管理写入菜单，并在角色中授权。不要只加 Vue 文件却不挂菜单。

全屏工具页（设计器、移动端壳、开发环境生成器）走外部路由，启动即注册。

组件

优先使用平台已有字段组件（上传、人员、部门、富文本等），不要在生成页里再写一套。自定义页面需同时能在亮色/暗色主题下使用。

生成器界面

路径 /dev/module-generator，仅开发或实施环境注入。操作说明见 生成业务应用。