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

66 lines
5.7 KiB
Markdown

# 与原项目实时互通
医院公司的共享模式通过原项目 API 管理同一批账号、角色、菜单与部门。两边修改后,下次查询读取同一份数据;没有定时同步任务,也不维护第二套账号副本。新建公司的部门、菜单在集团按公司独立保存并可直接维护,不会读取或修改医院配置,也无需先接入子系统。
本地入口仍是 `http://127.0.0.1:5173`。共享模式下使用**原项目后台账号和密码**登录,之前的 `preview_admin` 属于独立演示数据库,不会被提升为原系统管理员。账号的多端登录限制、首次改密、企微绑定与操作权限仍按原项目执行。
当前共享后台已增加集团主 GID、公司/成员管理、公司分组菜单和互联网医院入口。启用集团功能时 API 需启用 pdo_sqlite,配置及新增医院 SSO 配套文件见 [集团身份说明](group-identity.md)。
启用集团时,客户端使用专用身份源终端 11,与医院网页终端 1 和医院 SSO 终端 10 分离;原服务需同时部署对应枚举、身份会话控制器和服务。未启用集团时继续发送终端 1,兼容既有 shared 服务。升级后请重新登录集团以建立新终端会话,现有账号和 GID 不变。
用户与角色全局管理,用户权限来自分配角色的菜单和按钮并集,同一角色可以勾选不同公司的菜单。公司选择和成员归属不参与授权。部门、菜单继续按公司维护;医院菜单权限兼容原系统,原生公司菜单授权独立保存并在每次请求重新解析。
## 本地运行
在独立 `server/` 中复制 `.env.shared.example` 为私有 `.env`,将 `IAM_SOURCE_API_URL` 指向原服务的 `/adminapi`。这些配置不包含原数据库凭据。
如果原 API 尚未在本机运行,可用本项目的回环地址辅助器加载原项目自身配置:
```powershell
cd identity-admin/server
$env:IAM_SOURCE_PROJECT_ROOT = 'C:\zyt\server'
php -S 127.0.0.1:8082 -t C:\zyt\server\public scripts/project-api-router.php
```
该辅助器只允许互通所需的 API,并强制关闭原本地免密调试,不开放原安装器、诊断和其他业务接口。
另外两个终端启动独立 API 与前端:
```powershell
cd identity-admin/server
php -S 127.0.0.1:8081 -t public public/router.php
```
```powershell
cd identity-admin/web
npm ci
npm run dev
```
原项目需要同时安装本次新增的 `app/adminapi/controller/identity/SessionController.php`、`app/adminapi/service/IdentitySessionService.php`,以及完整配套修改。`RoleLogic.php` 和 `RoleController.php` 的新增角色接口必须返回本次已提交角色的精确 `{id}`,用于关联集团原生授权。配套代码保存在 `integration/original-server/` 中供独立交付。远程原服务地址必须为 HTTPS,不能把数据库或应用私钥放进浏览器配置。
集团医院跳转还需要配套 `HospitalSsoController`、`IdentityHospitalSsoService`、`IdentityHospitalSsoTicketStore` 和独立终端 10;医院前端接入 `/admin/group-login`。这些文件与部署清单同样随仓库提供。启用集团时,启动 API 使用 `php -d extension=pdo_sqlite -S 127.0.0.1:8081 -t public public/router.php`。
## 写入语义
- 账号编辑仅修改界面提供的基础字段、角色和部门;服务端先读取原详情,保留医生资料、岗位、头像、咨询开关、多点登录和原未展示字段。账号新增仍经过原业务逻辑。
- 菜单管理保留原 `paths/component/perms` 和缓存、参数等字段。独立壳仅将四个管理页面投影为本地导航,投影结果不会写回原菜单。
- 原角色没有停用字段,共享界面不提供该开关;授权和数据范围仍写入原角色。清空可见授权会实际撤回,无法查看的已有授权保留并提示。
- 部门状态在两种字段命名间转换,负责人、电话和根部门限制保留。
- 所有写接口先核对原账号权限,再交原 API 处理。前端按钮隐藏不能代替后端授权。
- 浏览器只保存独立随机会话句柄,原 token 保存在服务端私有目录;每次请求重新核验原账号和授权。互通登录调用原新增 `identity.session/login`,在账号行锁内重验密码后签发原会话。个人改密在原端一次事务内验证当前会话、更新原密码并使该账号此前已签发的所有原会话失效,桥接会话也随之撤销。
- 集团管理员编辑用户时,非空新密码直接更新同一医院凭据;空密码省略。改密、角色或部门变化会在原事务内撤销该账号旧会话;角色授权、数据范围和菜单变更按关联账号撤销。医院后续请求返回登录失效,重新登录后读取最新菜单和权限,无需定时同步。
- 原会话每次读取检查数据库有效性,权限读取当前原关联,防止旧缓存或续期恢复被撤销的访问。菜单停用覆盖完整祖先链;普通账号使用明确有效权限,root 保留原通配符语义。原操作日志同时屏蔽确认密码、旧密码及响应中的登录凭据。
共享模式禁止运行独立数据库初始化。实际业务写入会影响原系统,应在核对表单后保存;本次自动验证的所有写操作均使用隔离测试数据。
## 验证
```powershell
$env:IAM_TEST_PHP = 'php'
node --test identity-admin/tests/shared-api.test.mjs
php -d extension=pdo_sqlite server/tests/IdentitySharedSessionTest.php
```
共享 API 套件自启纯内存原 API 夹具和临时 PHP 服务,不连接原数据库。原端会话/角色测试明确跳过真实 `.env`,只使用隔离 SQLite。真实连接用于只读数据核对与用户授权的浏览器 SSO 验收;SSO 会建立正常登录会话,没有对真实用户、角色、菜单或部门执行验收增删改。