优化

测试环境单机部署与配置契约.md

@@ -1,13 +1,22 @@
 # 测试环境单机部署与配置契约
 
+## 2026-10-21 到港事实来源 review 修复与验收
+
+- 已关闭下文清关提柜日期一致性修复的后续 review 边界：Firstleg 柜级 `arrivedDestinationPortAt` 与预约日历统一按 `observedAt`、事实记录顺序降序取最新非空实际到港事实，后续观测修正为更早日期时不再被历史最大时间覆盖；其他船节点推进规则保持。业务规则唯一入口为[船节点时间语义](海外仓业务/船节点标准化契约.md#3-时间语义与状态推进)。
+- 新增真实 Mapper 的 H2 回归先在旧实现失败，再于修复后通过；覆盖向前修正、相同观测时间的记录顺序，以及只有预计时间的新观测不覆盖实际到港。Firstleg 5 类37项定向测试、Admin 3文件63项定向测试及生产/受影响测试类型检查通过，未执行全仓回归。
+- 后端修复已提交并推送 `test`：`55436e3a0a0690fdb58293b3829c21a1864d705c`，仅3文件。Admin 最后模板类型修复已进入并推送 `release/test` 的 `e2f99b4f4b26c32ced254f2f232e3e96a56eb1eb`，远程文件 blob 与已验证工作区及线上文件一致；已关闭“只在工作区未提交”的发布风险。
+- 用户授权的 TEST 发布 **Firstleg #508 SUCCESS**，精确提交同上。因期间其他发布已把 Firstleg 推进到 #507 / `c962f614e64b`，本轮基于该新基线追加3文件，未使用较旧镜像覆盖。CI复用本地定向测试结果，跳过执行但保留测试源码编译；运行镜像 `55436e3a0a06` healthy，Jenkins 原 `*/test` SCM 已恢复，保留流水线参数属性。本轮未发布 Admin、Lastleg、SQL、Gateway 或 Nacos；同期 Lastleg 由其他任务接续为 `c962f614e64b`，与线上 Admin `e2f99b4f4b26` 一同检查 healthy。
+- 发布后真实 HTTP **53项断言、7只柜**通过，核对列表、详情与日历的实际/预计到港来源、默认日期、人工时间、已有计划冻结及实际到仓字段。原柜 `MSCU7264022` 前后读取一致：已保存 `2026-10-24T00:00:00`、version 1、1票计划，实际到仓 `2026-10-21T16:12:26.49`；本轮只读核查，没有改写业务资料，自有登录会话均退出。发布期间的基线预检曾遇容器重启窗口 HTTP 500，原日志保留；健康后完整验收通过，不将中间失败计为通过。
+- 证据唯一入口：`baiyue-firstleg/reports/arrival-source-review-fix-508-20261021/summary.json`。代码、分支收尾、发布与本次自动/HTTP范围通过；无新增布局，不新增浏览器视觉通过结论。
+
 ## 2026-10-21 清关提柜与预约日历到仓日期一致性修复
 
 - 用户已授权修改后部署 TEST 并执行 HTTP 联调。Admin **#677 SUCCESS**，提交 `536308f3ec987a4bbe6e814a83f3b55f4a1bab71`，以测试环境 #676 / `e6c864a2a64e` 为基线，仅包含本轮 11 文件；Lastleg **#400 SUCCESS**，提交 `1ad357d259010bcf3c005a358c58e118a0cfd303`，以 #399 / `6fe632f28ead` 为基线，仅包含本轮 5 文件。未混入在途排车异常/照片修改，两个容器均 running/healthy；两项 Jenkins 临时 SCM 标签均已恢复原配置，同时保留流水线更新的参数属性。
 - 预约日历与清关提柜列表、详情共用日期投影：实际到港优先，其次预计到港；未人工维护、未建计划时展示到港当地日期加两个自然日的默认值，不制造零点、不自动保存。柜级查询补充 `planCount` 并与日历对齐人工/冻结时间语义，已有计划时列表禁改；无数据库结构、SQL、Gateway 或 Nacos 变更。
 - 本地定向前端 112 项、后端 33 项通过；模板行类型修正后，列表 49 项复测、生产和受影响测试类型检查、生产构建通过。Lastleg CI 复用本地定向测试结果，跳过测试执行但保留生产与测试源码编译。未声称全仓回归通过。
 - 真实 HTTP 与线上资源 21 项断言通过。`MSCU7264022` 首次只读查询为 version 0、无计划，实际到港 `2026-10-21T14:49:15`，默认日期应为 `2026-10-23`；调查期间该柜变为已保存 `2026-10-24T00:00:00`、version 1、1 票入库计划，验收核对三处均优先采用该冻结时间。本轮业务核查只有读取/查询请求，没有修改该柜时间或创建计划。另以既有 `TSTU4808232` 验证未维护场景：实际到港 9 月 29 日，默认到仓 10 月 1 日，列表、详情与日历一致且无具体时刻；自有登录会话均已退出。
-- 后续 review 发现未关闭边界：Firstleg 日历到港读取按 `observed_at/id` 取最新实际节点，清关提柜 `actualFacts.arrivedDestinationPortAt` 仍按历史 `actual_at` 最大值聚合。同一节点后续观测修正为更早时间时，未人工维护柜的默认到仓仍可能不一致；两条实际 SELECT 已用合成数据在内存中复现（23日后修正为21日，清关提柜默认25日、日历默认23日），没有访问共享数据库或写业务数据。运行中的 Firstleg `b4ff441a7030` 两份查询源码与复核代码一致。原柜已冻结的24日时间不受该边界影响；此前21项只证明已测场景，不代表该边界已通过。
-- 证据：`baiyue-firstleg/reports/warehouse-arrival-677-20261021/summary.json`。发布、自动检查及原 HTTP 场景通过；上述日期来源一致性边界待修复。未执行浏览器视觉验收，不能据此声称已通过人工页面截图确认。
+- 后续 review 曾发现日期来源边界（已由本页同日“到港事实来源 review 修复与验收”关闭）：Firstleg 日历按最新观测取实际节点，清关提柜按历史实际时间最大值聚合，后续观测修正为更早时间时默认到仓可能不同。两条实际 SELECT 用合成数据在内存中复现了23日后修正为21日时，清关提柜默认25日、日历默认23日；当时运行的 `b4ff441a7030` 两份查询源码与复核代码一致。原柜冻结的24日不受该边界影响，原21项只证明当时已测场景。
+- 原发布证据：`baiyue-firstleg/reports/warehouse-arrival-677-20261021/summary.json`。后续边界修复及分支收尾见本页同日 review 修复与验收记录；未执行浏览器视觉验收，不能据此声称已通过人工页面截图确认。
 
 
 ## 2026-10-21 FBA 正式确认缺项提示发布与 HTTP 验收