baiyue-firstleg/docs/phase1-business-maturity-regression.md

一期业务成熟度真实 API 回归脚本

脚本位置：scripts/phase1-business-maturity-regression.ps1。

脚本覆盖登录、刷新、退出、个人资料、修改密码、企业成员新增/编辑/查询/角色回显/启停/重置密码、角色新增/编辑/启停/删除保护/权限回显、本人和企业所有者保护、按钮权限、应用端隔离和跨租户越权。

运行前应完成数据库迁移并启动网关、认证服务、IAM 服务、MySQL、Redis 和 Nacos。建议使用专用测试环境，不要在生产环境执行。脚本会修改并恢复商户管理员密码，创建带 p1m_时间戳 前缀的成员、角色和第二租户。由于当前没有删除成员和租户接口，脚本会停用新成员、清空其角色并保留成员和租户记录，以便审计和人工清理；临时自定义角色会自动删除。

powershell -ExecutionPolicy Bypass -File .\scripts\phase1-business-maturity-regression.ps1 `
  -RepositoryRoot "D:\baiyue-firstleg" `
  -GatewayBaseUrl "http://127.0.0.1:9000" `
  -MerchantAdminPassword "实际商户管理员密码" `
  -PlatformAdminPassword "实际平台管理员密码"

可通过 -TemporaryAdminPassword、-MemberInitialPassword 和 -MemberResetPassword 传入符合策略的测试密码。密码及令牌只保存在进程内存中，不会写入控制台或 JSON 报告。

默认报告输出到仓库的 reports 目录。报告包含每个检查项的分类、通过状态、HTTP 状态、业务码、脱敏测试数据标识和汇总结果。任一关键检查失败时脚本返回退出码 1，便于接入流水线。

无论主流程成功或失败，脚本都会在 finally 阶段再次登录商户管理员并执行最佳努力清理。历史成员只有同时满足成员编号为 P1-* 且显示名为 一期验收成员* 才会被停用和清空角色；历史角色只有编码为 P1_SELF_* 且类型为 CUSTOM 才会被删除。脚本不会按单一模糊条件处理正常业务数据。无法通过现有 API 删除的测试成员和第二测试租户会记录在报告的 residualData 中。