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/,含前后端依赖清单与裁剪依据。