Files
zyt/artifacts/iam-extraction/function-first-navigation.md
T
2026-11-11 13:53:14 +08:00

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;根代理负责待所有代理终态后的统一测试及界面验证。