Files
zyt/identity-admin/docs/project-analysis.md
T
2026-11-11 13:53:14 +08:00

3.9 KiB

原项目分析与独立边界

本项目从 C:\zyt 的账号权限模块整理而来,沿用 PHP / ThinkPHP 和 Vue 3 技术栈,以及账号—角色—菜单、账号—部门的核心关系。此处“用户”指后台员工/管理员;原患者/会员账号是另一套身份体系。

补充:在初始独立模式之外,现增加原项目 API 实时互通模式,当前数据边界及配置见 shared-data.md;以下的裁剪分析仍是独立模式的设计依据。

原项目模块

能力 后端主要入口(原 server/ 内) 前端主要入口(原 admin/src/ 内)
登录与会话 app/adminapi/controller/LoginController.php、logic/LoginLogic.php、service/AdminTokenService.php views/account/login.vue、stores/modules/user.ts、permission.ts
后台账号 controller/auth/AdminController.php、logic/auth/AdminLogic.php views/permission/admin/
角色与授权 controller/auth/RoleController.php、logic/auth/RoleLogic.php、logic/auth/AuthLogic.php views/permission/role/、install/directives/perms.ts
菜单及动态路由 controller/auth/MenuController.php、logic/auth/MenuLogic.php views/permission/menu/、router/index.ts
部门组织 controller/dept/DeptController.php、logic/dept/DeptLogic.php views/organization/department/

账号可以关联多个角色、多个部门。角色关联菜单及按钮记录;登录后据此计算菜单和权限。菜单类型使用 M(目录)、C(页面)、A(按钮)。部门是组织树,与原医生档案中的“科室”字段不同。

为什么重新组装

原账号新增/编辑会调用腾讯 IM,个人信息混入医生策略及诊单统计,登录守卫还有企微强制绑定。原权限与菜单逻辑接入企微共享池,部门逻辑同时计算医疗业绩。原前端 App 会启动聊天和复诊轮询,构建脚本还会发布到上级业务目录。只隐藏业务菜单不足以移除这些依赖。

本项目采用干净的框架骨架,将相同的账号、组织与权限概念重新组装。业务目录、生产数据、私密配置和已登录会话不迁入。独立目录整体复制到其他位置后,可以独立安装、初始化和构建。

独立版的权限约定

  • 每个管理接口绑定固定权限键,未知接口不通过自动控制器解析开放。服务端权限检查决定能否执行,前端按钮权限改善操作体验。
  • 多个有效角色的授权取并集。停用角色或菜单不参与计算;停用父菜单同时关闭后代权限。隐藏菜单只影响导航。
  • 角色提交空的授权列表表示撤销全部授权。用户停用、退出及改密按独立版规则使会话失效。
  • 密码使用 PHP 标准密码哈希;随机 token 的摘要存入独立数据库。初始化时明确提供新管理员密码。
  • 部门/菜单禁止循环父子关系,有子节点或仍被用户引用时禁止直接删除。

原实现有“接口不在菜单权限集合内便放行”、多点登录下退出未撤销 token、角色空授权未清除等行为。上述独立版约定针对这些情况重新实现,详见 HTTP 集成验证。

当前范围

提供本地账号登录/退出、个人改密、用户管理、角色授权、菜单管理和部门管理。采用独立数据库,可添加自定义菜单;新的业务功能仍需实现页面组件和对应后端接口,再登记权限。

原岗位、患者账号、医疗数据范围、首次登录改密门禁、企微、腾讯 IM/TRTC、支付及外部 OIDC 适配不属于当前范围。所有管理权限目前按功能 RBAC 计算,不提供部门数据隔离策略。原 IAM 接口是已有业务应用连接外部身份提供商的客户端;本项目也不是跨应用 OIDC/OAuth 身份提供商。

更详细的原项目逐文件分析保存在原仓库 artifacts/iam-extraction/research/,含前后端依赖清单与裁剪依据。