独立管理前端
Vue 3 + TypeScript + Vite + Element Plus + Pinia + Vue Router。包含登录、工作台、个人改密、用户多角色多部门、角色树授权、菜单/按钮与部门管理;启用集团模式后增加集团主 GID、公司架构、成员资格与互联网医院入口。所有资源本地打包,无外部 CDN。
本地开发
在 identity-admin/web 中安装依赖并运行:
npm install
npm run dev
浏览器访问 http://127.0.0.1:5173;Vite 将 /adminapi 代理到 http://127.0.0.1:8081。账号和密码由独立后端初始化命令创建,没有固定默认密码。
npm run type-check
npm run build
build 先检查 TypeScript,再只生成本目录 dist/。不覆盖原项目后台。依赖版本由 package-lock.json 固定;完整验证记录见 ../docs/validation.md。npm test 验证交错到达的会话响应。
部署
静态站点根目录指向 dist/;使用 Web History,所有非 /adminapi 的前端页面地址应回退到 index.html。/adminapi 反向代理到独立 PHP 服务,生产应启用 HTTPS。不在前端保存数据库信息、初始化密码或应用密钥。
前端通过 Authorization: Bearer <token> 调用 API,支持 {code:1,msg,data} envelope 和 HTTP 错误码。localStorage 独立 key 为 identity_admin_session_v1;401 清理会话及动态路由并回登录。403 提示无权操作;后端始终是授权依据。
菜单与权限
- 工作台、个人账号对所有登录用户可访问。其他路由来自当前用户的服务端菜单,且校验页面权限。无角色、无菜单的用户也可以登录工作台。
- 组件显式白名单位于
src/router/index.ts。内置system/users、system/roles、system/menus、system/depts,工作台固定为/dashboard。common/custom为自定义菜单的占位说明,实际业务页面需要开发组件后在白名单注册,不能填写任意文件地址来加载代码。 - 菜单类型 M=目录、C=页面、A=按钮。隐藏只控制导航;停用节点及其后代不注册。每次用户/角色/菜单/部门保存后刷新当前账号与动态路由;当前页面被撤权时回到工作台。顶部刷新按钮可主动同步授权变更。
- 按钮使用当前权限数组显式控制展示,支持
*。角色授权树独立选择各节点,清空后明确提交menu_id: []。 - 后台列表中超级管理员账号受保护,使用个人账号页面改密。不能删除或停用自身。修改个人密码成功后清理会话并重新登录,服务端同时撤销该用户其他旧会话。
集成验收建议
登录与错误密码、401、403、重新登录;无角色用户可进工作台但管理页被拒;用户多角色/多部门保存回显;角色空授权清除;菜单隐藏/停用/删除后的导航刷新;部门父子关系与删除冲突;保存失败表单保留;窄屏导航、表格横向滚动与弹窗;任意深链刷新;所有写操作均由后端校验权限。
集团工作空间
/health 返回 group_enabled: true 时,登录并完成改密/企微门禁后加载 /group/context。集团管理员身份只使用上下文的 is_group_admin,不从医院超级管理员推导。公司管理位于 /group/companies,支持真实新增、修改层级和启停;公司成员位于 /group/members,分别明确保存成员资格与应用登录资格。
侧栏公司选择器决定当前公司工作空间。仅已接入医院且资格有效的公司注册医院管理路由;未接入公司显示空状态。医院目录请求携带 X-Company-Id,切换公司后迟到响应不会覆盖新工作空间。集团菜单的公司与应用分组、权限命名空间仅用于展示,不更改医院原菜单 ID、父级、路径、权限标识或角色授权载荷。
首页使用服务端注册的 entry_url 同页进入医院;/sso/authorize 只接受已注册医院的 S256 请求,在原账号门禁之后授权,并再次校验返回地址的 origin、路径、唯一 code 与原 state。医院接入协议见 ../docs/group-contract.md。关闭集团模式时继续使用原有独立/共享后台行为,不请求集团接口。
npm test 同时覆盖公司切换、成员载荷、集团路由隔离、SSO 参数和回调校验,以及原共享菜单/角色/用户载荷兼容。生产构建仍只写入当前前端的 dist/。