3.0 KiB
3.0 KiB
功能优先导航与公司路由契约
本次仅调整集团导航、公司页面范围和路由守卫。未改动登录 token、会话实现、权限数据及原业务记录,也未执行真实登录。
文件
identity-admin/web/src/router/index.ts:集团功能模块导航、动态路由注册、公司 query 校验及请求范围切换。identity-admin/web/src/layout/Shell.vue:移除全局公司选择器与切换逻辑,调整面包屑、导航高亮与模块空壳渲染。identity-admin/web/src/components/NavigationMenu.vue:公司子项用完整含 query 的路径作为菜单索引和路由目标。
页面与权限契约
- 集团模式的一级菜单为部门管理、菜单管理;各模块下直接列出当前账号可见的公司,目标分别为
/system/depts?company_id=ID和/system/menus?company_id=ID。首页和集团管理保留;用户、角色及其他已授权功能展平为一级功能叶。独立模式保留原菜单层级。 - 集团模块使用原始有效菜单、受支持组件、组件读取权限和菜单自身权限注册,保留原
meta.menuId和meta.permission。禁用祖先会阻断后代;隐藏菜单可有授权路由但不出现在导航中。 - 部门、菜单模块的集团路由使用规范路径,分别带
meta.companyModule = 'departments'/'menus'。空公司、停用公司、未获应用资格的公司只保留已经授权的这两个模块壳,其他动态目录功能不注册。 - 模块页面负责在
group.directoryAvailable === false时显示空态并阻断读取和写入目录 API;本文件不扩展该公司的业务目录能力。 resolveCompanyId(value, companies, currentCompanyId, defaultCompanyId)是导出的纯函数:显式值必须为单字符串正整数字面量、安全整数且包含在可见公司列表中。数组、空值、未知 ID 等返回null,不能回退。缺少参数时依次使用仍可见的当前公司、默认公司、首个可见公司。- 模块守卫先验证授权与公司,再调用
selectCompany设置请求头范围,随后同步动态路由。缺少company_id的旧书签会补全 query;显式无效公司返回 403。没有目录资格时其他/system/*仍返回 403。 - 页面级公司选择器应以同路径、更新
company_id的router.push切换模块;守卫负责切换 store 和 HTTP 公司范围。Shell 用路径与公司 ID 作为组件 key,切换后重新挂载页面;当前高亮使用path?company_id=ID,面包屑先显示功能再显示公司。
验证
- 已读取项目根
AGENTS.md和CLAUDE.md;当前工作区不存在.trellis/,未执行缺失的 Trellis 流程。 - 已执行
node node_modules/vue-tsc/bin/vue-tsc.js --noEmit(工作目录identity-admin/web,使用 bundled Node 绝对路径),退出码为 0。 - 独立验证 agent 正在编写并执行
function-first-navigation.test.mjs;根代理负责待所有代理终态后的统一测试及界面验证。