5.6 KiB
5.6 KiB
原项目实时数据互通约定
在保留独立模式的同时增加 IAM_DATA_MODE=shared;共享模式通过 IAM_SOURCE_API_URL 实时调用原项目 API,不复制账号表、不迁移演示 root、不使用演示会话访问原库。浏览器仅拿独立桥接 token;原 token 留在服务端的私有会话文件中,每次请求向原 mySelf 复核身份与权限。
后端共同契约
/adminapi/health返回{project:'identity-admin',data_mode:'shared'|'standalone',source_login_url:string}。source_login_url来自可选配置IAM_SOURCE_LOGIN_URL,不暴露数据库或私密配置。mySelf保持现有字段,并加data_mode,source_login_url,requires_password_change:boolean,requires_wecom_binding:boolean;共享模式导航只投影用户有权限的用户/角色/菜单/部门页,使用本项目路径及组件。不把投影路径写回原数据库。- 浏览器登录路径保持
/login/account;桥接调用原端新增/identity.session/login,terminal=1。该接口复用原 LoginValidate 与 LoginLogic,但在账号行锁内重新验证当前密码并完成签发,避免在途旧密码校验跨过改密事务。账号字符串不强制转小写,源 token 仅服务端保存,随机独立 token 使用哈希文件名、锁与0600权限,固定TTL,源拒绝登录/会话时立刻拒绝;不允许演示 token 或未识别 token。 - 所有写操作先明确校验原权限,再访问原 API;新
auth.dept/*对应原dept.dept/*。不得利用原未登记接口默认放行的行为授权。 - 源首次改密
is_paw=0时允许 mySelf/logout/password,其余管理拒绝。需要绑定企微时管理操作拒绝,前端提示到原后台完成绑定;不关闭原门禁。 - 个人改密统一通过原端新增 POST
/identity.session/password,请求{old_password,password,password_confirm}。该端点在事务内验证当前真实会话、账号状态和原密码(首次改密可不填旧密码),沿用原项目6–32字节规则与密码算法,然后一次事务更新密码/is_paw并过期该用户全部原会话,再清原token缓存。桥接成功后撤销该用户全部桥接会话。避免分两次调用在原首次改密已撤销token后无法撤销其它会话。源端返回code1/data[]或原code-1/10/0,不额外传name/avatar。 - 退出调用原新增 POST
/identity.session/logout{all:0},始终撤销当前桥接会话;all:1仅用于需要全端退出的管理内部流程。源新端点均由主流程实现,只允许操作当前已认证用户自己。 - 登录失败返回401,原code=-1映射401;code10或账号门禁返回403并清晰报错,普通原验证错误422,源网络/非JSON/协议错误502,敏感报错不外显。不得跟随重定向或关闭TLS验证。
列表与编辑字段
- 用户:root→is_root;关系数组转数字,role_name/dept_name或其数组归一为新字段。account/name/disable/password/role_id/dept_id 是新界面可编辑字段。编辑必须先源 detail,合并保留 avatar、multipoint_login、jobs_id 及全部医生/咨询资料字段,不能向浏览器返回密码/hash/token。password 空值表示不改,非空补 password_confirm。源账号编辑可能撤销自己的会话,新前端应正常回登录。
- 角色:原无 disable 字段,返回 disable=0 仅兼容类型,前端共享模式隐藏状态筛选/状态列/启停开关,保存不传 disable。不得静默接受 disable=1。保留并可编辑
data_scope(1全部/2本部门及下级/3本部门/4本人);省略时保留源值。源 RoleLogic 的 menu_id=[] 替换缺陷由主流程修复。 - 菜单管理:返回原原始 paths/component/perms 与 is_disable→disable;保留 selected/params/is_cache 等隐藏字段。共享模式组件改为原组件路径文本输入,路径允许原项目相对路径,编辑时不采用本项目组件白名单。新增目录/页面/按钮写原数据;它们是否作为本项目业务页面入口仍遵循本项目四模块投影。不得用新页面 paths 覆盖原路径。
- 部门:status=1→disable=0;保存反向映射,编辑先 detail 保留 leader/mobile。沿用原根部门不可迁移等约束。
- 所有新写入需字段白名单、合理长度/数组/引用校验和防自删/根停用/树环检查。分页保留现约定、封顶100;源不支持的 keyword/disable 筛选应服务端适配,不能看似支持却忽略。
- options 含 roles/depts/menus;角色授权需要保留被停用菜单的已有授权,若只能读原 menu/all,不得在保存角色时隐式清除不可见授权。
配置与实施边界
- 新
server/.env本地仅包含共享模式、原 API 地址、可选原后台登录地址;不写原数据库密码。原配置仍只由原项目加载。 - 主流程提供
identity-admin/server/scripts/project-api-router.php本地启动辅助器,读取IAM_SOURCE_PROJECT_ROOT指向原 server,绑定127.0.0.1:8082;加载原依赖/配置后明确关闭 APP_DEBUG 和本地免密调试,保持真实密码验证。仅允许桥接所需的 API 路径,不开放支付/回调/原调试接口。 - 不运行独立 init 脚本初始化原库;shared 模式下 init 应拒绝。
- 实库仅做只读连通/计数与未认证接口验证。所有写入与字段保留测试使用隔离 fixtures,不新增、改密或重置真实 root。
前端文件只由前端代理负责;新后端桥接目录及 ApiController/初始化模式保护由后端代理负责;主流程负责原项目 RoleLogic 修复、原 IdentitySessionController、本地源启动器、配置/启动/文档及集成。