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

4.3 KiB

验证记录

日期:2026-10-30。全部运行数据位于独立临时目录和数据库,未连接原业务数据库。原仓库已有业务文件未修改。

共享数据模式追加验证

后续按用户要求增加实时互通模式。此阶段读取了原项目数据库的连接、表结构和数量(212 个有效后台账号、10 个角色、410 条菜单、30 个部门),实际业务库未执行测试写入。原源码新增专用身份会话接口,并修复角色提交空授权不清除的问题;这补充了上面初始独立模式的范围。

共享模式检查 结果
独立共享 API(纯内存原 API 夹具) 19/19 通过
原 API 辅助器兼容路由边界 2/2 通过
原端登录/改密/退出/角色(真实隔离 SQLite) 37 项检查通过
现有 AdminMultiRoleRegressionTest 通过
前端会话交错及共享模式回归 7/7 通过
独立模式全量 HTTP 回归 40/40 通过
前端类型检查及生产构建 通过
当前共享模式健康接口 已返回 shared
实际未认证管理接口、原诊断及兼容路由覆盖 分别401、404、404

真实账号登录需由使用者输入原项目密码,未借用真实会话、重置真实密码或创建真实管理员。所有自动写入测试仅在隔离夹具中进行。互通入口保持本机服务运行,原业务数据的最终操作以原账号授权为准。

已执行

检查 结果
独立 Composer 安装及严格配置校验 通过,锁定 ThinkPHP 8.1.4
Composer audit 未发现已知依赖漏洞
新后端 PHP 文件语法检查 通过
SQLite 全量 HTTP 集成 40/40 通过
重复初始化非空数据库 返回失败,数据库 SHA-256 保持不变
MySQL 兼容模式(隔离 MariaDB 实例)全量 HTTP 集成 40/40 通过
旧认证快照/过期会话改密回归 15 项断言通过
账号/IP 失败限流与成功登录预算回归 3 个场景通过
前端迟到 401/成功响应与当前会话回归 4/4 通过
vue-tsc 类型检查 通过
Vite 生产构建 通过,产物只在 web/dist
npm audit(包含开发依赖) 0 已知漏洞
开发源、带端口同源、非信任源检查 分别 200、200、403
浏览器页面检查 登录、动态导航、用户列表、角色授权树、部门树正常;新增测试部门成功;未发现浏览器 error 日志

HTTP 检查覆盖账号/角色/菜单/部门创建与读取,多角色多部门,实际写接口拒绝,空授权、停用角色及父菜单立即收权,循环与删除约束,根账号保护,退出/改密/停用会话失效,菜单路径边界及授权后的自定义菜单。

使用 PHP 8.2.34、Node.js 24.22.1。前端锁定 Vue 3.5.44、Vite 6.4.5、Element Plus 2.14.7;其他准确依赖见锁文件。MySQL 兼容验证使用单独启动的 MariaDB,不代表已经在每个 MySQL 版本上执行。

验证限制

  • 当前环境没有 Docker,镜像构建与 compose 启动尚未实测。模板供独立本地启动使用。
  • 生产构建有主包大小提示(Element Plus 完整样式与组件注册);它不是构建错误,尚未执行性能压测。
  • 浏览器使用隔离测试账号和数据库;正式管理员需按 README 明确设置自己的初始化密码。未迁移任何真实账号。
  • 不包含跨应用单点登录、原患者体系、岗位或部门数据范围策略。

复现入口:scripts/verify.ps1、tests/http.test.mjs、tests/password-race.php、tests/login-limiter.php、tests/session-race.test.mjs。更改独立数据库配置时,应始终使用新建专用空库。

集团生产 SQLite 兼容性

集团服务器 PHP 8.2.35 的 PDO SQLite 实际为3.7.17。公司成员、客服目录状态和刷新时间写入使用事务内 INSERT OR IGNORE 后 UPDATE,不依赖 ON CONFLICT ... DO UPDATE,也不使用会删除旧行的 REPLACE。自动目录同步失败时保留已存菜单可读。

发布需在实际服务运行时执行 SQLite兼容回归,三个CLI参数依次为项目根、待发布代码根和不存在的合成scratch路径;该回归不加载真实环境或访问业务数据。还需检查真实菜单加载、显式同步、再次加载和授权指纹,首页HTTP200或只读元数据成功不能替代写库链路验收。