docs(api): 固化团号迁移发布门禁 (#5374)

changelogs-v2/2026-08/02_5374_保险任务与派单候选补齐团号契约-修改接口-管理后台.md

@@ -162,6 +162,14 @@ GET /admin/fleet/insurance/tasks?teamNo=2607&page=1&pageSize=20
 - 历史数据仅按 `assignment_id` 从 `fleet_assignment.team_no` 回填。
 - 无匹配派单、来源团号为空或任务已有非空团号时保持原值；不跨服务查询、不按订单号猜测。
 
+### 生产两阶段迁移门禁（本单未授权、未执行生产）
+
+1. 第一阶段必须设置 `SPRING_FLYWAY_TARGET=20260802.001`，只允许 nullable DDL 落库；禁止携带默认 `latest` 直接滚动发布。
+2. 完成 Fleet Java 全量滚动并确认所有旧实例退出；此时新写入已冻结 `teamNo`，不会再产生旧代码造成的新增空快照。
+3. 重新只读统计待回填数、可匹配数并执行普通 `EXPLAIN`；影响行数 ≤ 50k、扫描行数 ≤ 200k、staging 单事务 ≤ 5s、锁等待 ≤ 1s、复制延迟增量 ≤ 2s 才可继续。
+4. 第二阶段才移除 target 或设置 `SPRING_FLYWAY_TARGET=20260802.002`，由受控单实例执行幂等 DML，再核验 Flyway history 与剩余空值。
+5. 任一阈值超限或证据缺失即停止第二阶段，改用 1k–5k 行受控分批；生产禁止 `EXPLAIN ANALYZE UPDATE`。
+
 ---
 
 ## 六、边界行为
@@ -190,7 +198,7 @@ GET /admin/fleet/insurance/tasks?teamNo=2607&page=1&pageSize=20
 - 独立 Reviewer(max)：无 P0–P2。
 - oasdiff：项目缺少可复现 Swagger 2 → OAS3 转换链，标记 `not_configured`；已完成源码级手工契约对比。
 - MySQL 8.0.33 隔离实例：`FleetInsuranceTaskTeamNoMysqlTest` 3/3 通过，0 skipped；H2 全迁移回归 `FleetInsuranceTaskMigrationTest` 8/8 通过。
-- Fleet 全模块 `verify` 已执行 2764 项；本工单迁移兼容缺陷修复后，仅余 6 项既有环境/并发测试失败（Redis 不可达 4 项、Release E 时序 1 项、保险并发夹具 1 项），未将该次命令记为通过。
+- Fleet 全模块 `verify` 已执行 2764 项；接入本单隔离 Redis 后相关 4 项通过且无 key 残留，当前仅余 3 项基线失败（Release E Windows 时序 2 项、保险并发夹具 1 项，后者已在未含本单改动的 `dev-v3@a999a3df7` 同样复现），未将该次命令记为通过。
 - 测试部署及网关真实 round-trip 结果将在后端完成后更新本文件元数据与本节。
 
 ---