优化

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

@@ -1,5 +1,35 @@
 # 测试环境单机部署与配置契约
 
+## 2026-10-22 排车取消、驳回与失败后继续操作专项
+
+- 用户授权 TEST 发布与真实 HTTP 验收。Admin 提交 `090431b40927b8f4f7770d4564dd23a463c0cf48` 已通过 `admin-web-test #692` 发布，镜像 `090431b40927`、镜像 ID `bc3825ed3ae3ee7593be6c8b0b2519b912e80ee3f3a2835d8e13e36e65925232`，running/healthy，健康端点返回 ok。复用已发布的 Lastleg `#411` / `e60890e63e36fd48ea601ecc1e9f95b1aa49d2b9`，再次核对镜像一致且 healthy。前端失败请求仅保留执行中的忙碌状态，结束后释放，清除旧会话缓存；部署资源已无“原请求结果尚待核对”提示。
+- Admin `#691` 因浮动 Node 基础镜像更新后下载停滞而主动中止，未替换容器；`#692` 固定上一成功构建使用的 Node 镜像摘要后完成类型检查、生产构建及部署。临时构建参数已移除，Job 配置与操作前原文逐字核对一致。
+- 本轮使用固定验收客户及现有海外 PDA、空闲合成测试车辆司机，通过正式接口实收入库两票各一托一箱；排车 `PC202610220004` 覆盖缺运输计划拒绝、过期版本拒绝后新请求成功、调度驳回、PDA 理货驳回。两类驳回均真实命中 BEFORE_LOADING / VEHICLE_INFO 列表，修改车辆资料后可重新提交并完成两级审核；零扫码显式退回后正常取消，关联车次取消，库存余额、库位明细及来货单完整快照不变，原两托重新成为可排候选。
+- 使用上述同一批货物及原预约逐批分配重新建立 `PC202610220006`，原车辆司机分配成功，再次取消且货物快照不变；空单 `PC202610220007` 取消成功。首次重新建单请求漏带预约批次分配，被 A0409 正常拒绝；保留失败请求证据，回查原预约当前版本后补齐正式分配，未重做入库或通过 SQL 绕过校验。所有本轮排车最终取消，登录会话退出；未修改用户重下的 `PC202610210022`，无 SQL、删除、重置或新增主档。
+- 本地前端 11 个受影响文件共 247 项测试通过，取消后端两类 40 项定向测试通过；未运行全量回归。真实 HTTP 证据为 `baiyue-firstleg/reports/dispatch-loading-exception-20261022-1030/report.json` 和 `dispatch-loading-exception-20261022-1030-resume2/{report,summary}.json`，原失败事实保留。无实托 PLAN 取消复用本文件下节已发布版本的 `PC202610220003` HTTP 证据；本轮新样本为实收货及空单。HTTP 与组件测试不替代页面截图或 Android 真机验收，本轮未宣称全部排车异常分支通过。
+- 用户追加要求真实页面验收并指定 1920×1080、100% 缩放后，Admin 已发布页面通过智能排车重新选择本轮 `ZY202610220001/0002` 的两托两箱，生成 `PC202610220008`。实际触发维护保存缺车辆的 A0400 后，原弹框可继续选车辆司机、填写运输时间并提交；调度实际驳回后自动返回车辆信息，显示退回原因，可修改资料重提并审核通过。
+- PDA 使用本机既有 H5、既有绑定洛杉矶仓的测试账号连接 TEST Gateway，实际打开同一排车并驳回理货审核；后台重新查询车辆信息显示同单与理货退回原因，实际维护修改、重提、调度通过后，PDA 再次审核通过，进入装车中且真实已拣仍为0。随后 Admin 页面执行零扫码退回装车前及取消 `PC202610220008`，原两托重新可选。
+- 在原两托新草稿中仅对验收标签页模拟断网，生成失败后显示“本次排车操作失败，请重试”，货物选择保留、生成及取消等按钮可用；页面控制曾超时，恢复连接后明确执行在线网络设置，再核对原失败状态。在原弹框直接再次点击生成成功得到 `PC202610220009`，未退出、清缓存或重放旧请求；新单通过页面复用原车辆和司机并保存成功。未将控制连接延迟当作产品接口耗时。
+- 最终通过正式 HTTP 核对原单已取消、新单为同两托且车辆司机保存正确；以当前版本正常取消新单释放测试资源，再从真实页面详情确认“已取消”。两单均无真实拣货、出库或派送，库存余额、库位明细及来货单与最初验收前完整快照相同，两托再次可排，车辆司机无占用，PDA 验收会话已从页面退出。本轮无源码修改、SQL、删除、重置、新账号或主档；未操作用户原排车单。
+- 页面截图、失败后 DOM、最终 HTTP 回执及汇总保存在本机指定凭据目录下 `dispatch-ui-20261022/`；最终验收截图均为1920×1080，浏览器 scale=1。范围是上述取消、驳回重提、维护及网络失败恢复，PDA 为 H5 真实页面，不替代 Android 真机及未执行的其他异常分支。
+
+## 2026-10-22 本批32项修复发布与验收（已暂停，转人工验收）
+
+- 本批固定源码：Backend `2c3435adafe48c8e97ef145fa301eaa11ea230be`，Admin `2e26477db523cebf23db8c28f8a4dc39cb0df1bd`，Client `7adb97d145e28e61eb391ff7609aecdb2fda7e62`，国内PDA `5fcc51d73c2ba48f109ca513831f4a5f816dbb92`，海外PDA `9c2f0a54ec1e9147db7cd434455e963e8c4cb22a`。在先取消专项与验收脚本工作树差异均保留，未夹入本批提交；远端新增尾程列表需求保留于合并后的开发分支，本次未发布该需求或Order。
+- Firstleg `#510`、Finance `#136`、Lastleg `#409` 均SUCCESS，运行镜像标签均为 `2c3435adafe4`；复用本地定向测试，CI仍编译生产/测试源码并打包，未宣称全量测试。Admin最终 `#690` SUCCESS、镜像 `2e26477db523`；Client最终 `#440` SUCCESS、镜像 `7adb97d145e2`。已核运行镜像与目标提交一致，五个服务均running/healthy；前端任务SCM及lightweight配置已恢复原值。
+- Client `#439` 在lightweight检出阶段失败，未替换容器；改用完整检出后完成 `#440`。Admin `#689` 曾因过早恢复SCM使agent工作区取到合并提交，随后保持精确pin至构建结束，`#690`已替换为本批目标镜像。保留上述事实，不把读取Jenkinsfile的SHA当作实际构建SHA。基础Node镜像下载较慢不构成代码检查通过或失败依据。
+- 国内/海外PDA H5分别使用 `5fcc51d73c2b`、`9c2f0a54ec1e`，均running/healthy。普通文件归档、传输SHA及远端首页SHA已核对一致；国内首页 `34e9fc9fcef86d1fd7d375b0613df4babab720a9eb2c186ab59901f119625c17`，海外首页 `080d396928d6ccf1f92dd7d124c6bd0e605b776db24722de4045eb0abab39223`。仅发布H5，appResource/app编译不等于APK/WGT发布或真机验证。
+- 真实HTTP已验证本批空排车 `PC202610220002`：MASTER车辆照片保存后引用及文件内容保留、8项维护资料往返保存和空值清空、原键重放不增版本、错误附件分类被明确拒绝、实际发车时间未被改写；空排车最终取消且登录会话退出。此前选到已被其他车次占用的车辆时接口正常拒绝，未生成排车；确认结果已知后改用只读核对为空闲的主档。未代替此空单提交调度审核，不据此声称审核页面已验收。
+- 国内装柜完成真实HTTP通过：本批订单 `FL202610220001` 的1箱作业请求约88ms受理，约492ms观察到任务及完成命令最终COMPLETED；250ms串行观察，原operationId重放保持命令身份、任务版本、明细、操作历史和库存结算不变。首次测量审核因验收脚本使用旧主单版本而A0409明确拒绝，按权威measurement.inboundVersion接续同单，未重建订单或重做称重。证据为同目录 `loading-http.json`。
+- 费用调整真实HTTP通过：应收、应付均使用同一费用项目创建两条独立来源100/100，只调整首条为120并审核；业务与Finance当前各2条合计220，历史3条，原100/调整120/另一100及对应版本操作日志一致。验收脚本曾仅按nullable sourceFeeId过滤而漏掉原v1，修正取稳定来源身份后只读接续原应收，不重发已成功写入；应付随后一次完成。未覆盖无公开新增来源入口的Finance手工费用调整，未机械重放无幂等合同的Firstleg调整。证据 `fees-http.json`。
+- 尾程编号与默认日期真实HTTP通过：本批生成 `WC202610220001`，符合WC＋yyyyMMdd＋四位流水；原柜默认权威plannedDate为2026-10-28，未执行人工覆盖，直接转换唯一入库计划后plannedArrivalDate同为2026-10-28；权威查询planCount=1、isDefault=false、冻结日期不变。证据 `overseas-http.json`。预约来源正确阻断未开船货物，正按同一自有TEST柜补齐正式模拟前置，不借用其他单据或改数据库状态。
+- 预约登记发现并修复未排车客户被空排车锁范围拒绝的真实缺陷：仅FbaAppointmentExecutionAdapter及直接测试29增1删，8项定向测试和独立审查通过；原发布基线2c3435ada叠加该修复的精确候选 `74f510a49b8a378b377f94c92f007a2b937f6744` 经Lastleg `#410` SUCCESS，运行镜像 `74f510a49b8a`、镜像ID `ae277a635af099220ec373ddbb4202491eb2fa184886d9677180927edcb1ea51` healthy。其余六个运行镜像不变；开发分支合入候选祖先并保留远端新需求与本地在途差异，不发布无关HEAD。
+- 同一原TEST柜通过正式报关/自动离仓/人工模拟节点仅推进到DEPARTED_ORIGIN_PORT，原因明确SYNTHETIC_TEST，不代表真实报关或开船。登记下一步正确拒绝LGB8测试主档旧UTC-8；按现行WarehouseSaveNormalizer及已接受公共CSV，通过正常Warehouse PUT仅修正该既有主档为America/Los_Angeles，其他语义字段核对一致，未新增仓库、未SQL。保留所有明确拒绝回执后，用原预约批次、原key/body完成SUCCESS登记，确认号与时间窗读回一致；不代表第三方真实预约，客户原预约号自动带入按用户要求排除。证据 `appointment-fix-deployment.json`、`appointment-timezone-data.json`、`appointment-http.json`。
+- 后继实际维护/调度审核通过：自有PLAN排车 `PC202610220003` 使用原 `IP202610220001` 和SUCCESS预约，完整8项维护字段、关联订单、白底上传卡片均已页面核对；由维护弹框正常提交审核，权威状态DISPATCH_PENDING/version4。实际审核弹框加载同一自有VEHICLE图片及MASTER驾驶证图片，均核到非零naturalWidth，未审核通过或推进实际仓库作业。准备取消时发现已发布版本错误复验未实收PLAN装车资格；将既有取消专项四文件88增1删精确叠加74f510，独立审查及两类40项定向测试全部通过，Lastleg `#411` SUCCESS，最终提交 `e60890e63e36fd48ea601ecc1e9f95b1aa49d2b9`、镜像ID `fbd61a6577b72ea9e837b12bb5538268976f0e7d34aa5fa0e8be39734bc68605` healthy，其余六镜像保持不变。随后原PC3及 `CT202610220003` 正常取消，车辆/司机occupiedTripNo均为空，0实际拣货/出库/派送；证据 `dispatch-cancel-fix-deployment.json`、`dispatch-ui-cleanup-http.json`。
+- 内置浏览器已恢复；Admin/Client均实际1920×1080、100%。已核订单节点、其他页签顺序、新增费用白底与文字操作、测量申报底色/无更多、审核总览与称重表格、完整车辆维护及审核照片、柜次号副文案移除、柜详情指标/提示删减、人工补录白底、订舱草稿创建时间/放舱白底、关联白底/输入边界、智能装柜加入白底/提示删减、预装备注白底/输入边界、预装独立事件名称、日历柜次号、入库单查看预约白底、既有预约直接确认字段，以及客户端头程标签/按钮分行。货柜/订舱/日历一个明确诊断窗口58个数据请求，最大342ms；有会话过期刷新，未将401算作业务成功或将工具延迟算作产品延迟。更早请求计时缓冲区已满的记录只作局部证据，不据此宣称后续零请求。
+- 用户现明确要求停止自动操作，改由人工验收；本批不标全量验收完成，不再自动修复、部署或推进业务。待人工重点核对客户端退税资料弹框、PDA双端390×848页面/上传/完成交互、推送PDA弹框及其余未完整覆盖场景。当前自有测试柜 `D1818` / `TSTU3723017`，订舱 `OB202610220002` 已在页面正常放舱并关联；预装 `LP202610220002` 已在页面加入退税测试单 `FL202610220003` / `ZBYHK2610220003` 的1箱，尚未选择PDA操作员、未确认推送、未领取/拣货/装柜完成、未报关。页面停在该预装详情的操作员下拉框，Admin/Client页保留供人工接手。前一张买单UI种子 `FL202610220002` / `ZBYHK2610220002` 仍待分柜。退税种子审核曾明确A0409拒绝版本4；原拒绝及INTENT保留，独立后缀双读一致的新版本后正常审核并完成费用/客户确认，未重建或重复测量，不把原拒绝回执改写为成功。
+- 本地海外PDA仍为原5176服务、国内仍为原5175；未停止服务、未启动准备好的5176回环代理，未切换端口或改manifest。本轮未执行SQL、重置或新建公共主档；仅前述既有LGB8主档经正常API修正时区。部署/HTTP报告入口为 `baiyue-firstleg/reports/repair32-20261021/`；截图及详细浏览器请求记录保存在本机指定凭据目录的 `repair32-ui/`，不将客户与环境敏感信息入库。人工结果仍在本节接续。
+
 ## 2026-10-21 TEST 客户保留名单清理与恢复
 
 - 用户明确要求删除其他客户，最终保留 `TEN2097708157074210818`、`TEN2097867276078874626`、`TEN2097882345072295938` 三个客户。核对 TEST 入口、数据库身份和编号映射后，20:17（Asia/Shanghai）单事务删除 738 个客户、761 个专属客户账号及相关资料、配置、资金账户、客户销售报价和安全关联，共 30 张表 59,278 行；904 个平台账号及平台主体保留。公共仓库、车辆、自营数据、独立审计、物理文件和编号序列继续保留。