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

26 lines
3.0 KiB
Markdown

# 功能优先导航与公司路由契约
本次仅调整集团导航、公司页面范围和路由守卫。未改动登录 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`;根代理负责待所有代理终态后的统一测试及界面验证。