html/docs
4
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

记录履约界面和船节点署名测试环境发布

Browse Source
This commit is contained in:
ouyangxq
2026-10-28 17:03:46 +08:00
parent e33825c161
commit b17f4592bc
2 changed files with 9 additions and 1 deletions
Download Patch File Download Diff File Expand all files Collapse all files
测试环境单机部署与配置契约.md
+8
View File
@@ -1,5 +1,13 @@
# 测试环境单机部署与配置契约 # 测试环境单机部署与配置契约
## 2026-10-28 履约状态与船节点署名：TEST 已生效
- 用户授权发布本批已 review 的修改及 PDA 状态修复。发布前已快进合入远端提交并保留全部工作区编辑；Client 同步包含已提交的统一换标明细模板与运输字段文案。Admin 整理装柜详情重复内容、照片类型、尾程筛选偏好及排车资料入口，订单详情补齐 `UNASSIGNED/PROCESSING/COMPLETION_FAILED` 中文状态；船节点日志使用操作时保存的用户名快照。
- Admin 提交 `d990637b387291a6b692fcb1514355f5aa10cfe6`，`admin-web-test #730` SUCCESS，运行标签 `d990637b3872`；Client 提交 `fdf646227eed741b1867d9cfe5c73d51c0e8c0e0`，`client-web-test #448` SUCCESS，运行标签 `fdf646227eed`；Firstleg 提交 `353c86f4cfbdb7526d6b231c3155b5c32e3448f3`，`baiyue-firstleg-firstleg #527` SUCCESS，运行标签 `353c86f4cfbd`。其他服务及两个 PDA 未重复发布，Lastleg 保持本轮开始时已部署的 `71a1026e21c2`。
- 用户单独授权后，以一次原子 ALTER 为 `baiyue_firstleg.fl_carrier_schedule_node_fact` 新增可空 `operator_id BIGINT UNSIGNED`、`operator_name VARCHAR(128)`；SQL SHA-256 为 `239bc75241aa4f61de782c52e7591cbf3ecc18e4d0876dee7b99245a70fac08c`。执行前后原有节点字段的逐行摘要、记录数及索引摘要一致，未回填历史节点。结构定义与 Firstleg 模块基线、国内统一空库基线一致。
- 定向自动检查通过：Admin 354 项（本次状态及详情 48 项，输入未变的其他 306 项复用 review 结果）、Client 91 项、Firstleg 54 项及部署静态合同 20 项。后端流水线复用已通过的定向测试并编译测试源码，前端流水线类型检查及构建通过；这些结果不代表完整模块或真实业务写入回归。
- 最终 15 个在用应用容器全部 healthy，仅上述三个应用镜像变化，环境变量、挂载及既有暂停容器状态保持一致。177 个 Admin/Client 公网首页及相关静态资源摘要与运行容器一致，PDA 状态和节点署名代码已进入产物；11 项只读 HTTP 检查通过，覆盖货柜列表/详情、节点事实、船期任务、排车、尾程订单及装柜/PDA 关联，并完成独立登录与退出。复用原 API 路由，节点事实响应新增 `operatorName`，本批未修改 Gateway 或 Nacos。页面视觉及真实补录、确认出仓的写入效果待人工验收；执行证据位于本机私有临时目录 `codex-test-release-20261028-review-5ae0ec39`。
## 2026-10-28 采购出库费用提示与费用重试列：TEST 已生效 ## 2026-10-28 采购出库费用提示与费用重试列：TEST 已生效
- 用户要求继续更新新提交，本批按已提交版本核对。检查开始时，Admin 业务提交 `4581130b62058880554f310ecb30d9f8d7042ed1`（`admin-web-test #727`）和 Lastleg `f3d57869f2f80b52912ff355218c000be57becb4`（`baiyue-firstleg-lastleg-service #441`）已部署成功并 healthy，直接复用既有发布结果。采购创建出库不再以费用缺失或未审核作为门禁；费用查询只提供提示，原采购状态、数量、跟踪号、客户隔离、权限及幂等校验继续执行。 - 用户要求继续更新新提交，本批按已提交版本核对。检查开始时，Admin 业务提交 `4581130b62058880554f310ecb30d9f8d7042ed1`（`admin-web-test #727`）和 Lastleg `f3d57869f2f80b52912ff355218c000be57becb4`（`baiyue-firstleg-lastleg-service #441`）已部署成功并 healthy，直接复用既有发布结果。采购创建出库不再以费用缺失或未审核作为门禁；费用查询只提供提示，原采购状态、数量、跟踪号、客户隔离、权限及幂等校验继续执行。
海外仓业务/排车列表统一作业改造契约.md
+1 -1
View File
@@ -29,7 +29,7 @@
5. 装车已完成时，第五张装车照片绑定与按客户和目的地生成出库／派送单、记录实际发车并进入派送中在同一事务完成；照片先齐时，这些动作随装车确认在同一事务完成，仍无人工安排派送及确认发车入口。上传和绑定各保留稳定原请求键；第五张绑定或派送失败时保留装车后、前四张及原上传文件，原请求可恢复，不能留下半车或重复派送。PDA每次按Token绑定仓校验，Admin沿排车list只读、edit上传保存。照片使用原整车附加记录及文件归属，不新增存储表；五个既有技术槽位按顺序映射上述五类资料，不替代司机审核或真实签收。真实外接报价沿原费用路径发布，未知派送补充资料与费用保持未确认，不猜测金额或原费用覆盖、不填写零费；后续由既有后台资料／费用管理维护。装车中上传齐资料不会提前发车；照片先齐时派送失败回滚本次装车确认、保留已保存照片，原请求可重试。装车完成原键恢复本次事务原最终阶段（AFTER_LOADING或DELIVERING），资料保存原键恢复原保存结果，当前阶段须另读；不重复扣库存。 5. 装车已完成时，第五张装车照片绑定与按客户和目的地生成出库／派送单、记录实际发车并进入派送中在同一事务完成；照片先齐时，这些动作随装车确认在同一事务完成，仍无人工安排派送及确认发车入口。上传和绑定各保留稳定原请求键；第五张绑定或派送失败时保留装车后、前四张及原上传文件，原请求可恢复，不能留下半车或重复派送。PDA每次按Token绑定仓校验，Admin沿排车list只读、edit上传保存。照片使用原整车附加记录及文件归属，不新增存储表；五个既有技术槽位按顺序映射上述五类资料，不替代司机审核或真实签收。真实外接报价沿原费用路径发布，未知派送补充资料与费用保持未确认，不猜测金额或原费用覆盖、不填写零费；后续由既有后台资料／费用管理维护。装车中上传齐资料不会提前发车；照片先齐时派送失败回滚本次装车确认、保留已保存照片，原请求可重试。装车完成原键恢复本次事务原最终阶段（AFTER_LOADING或DELIVERING），资料保存原键恢复原保存结果，当前阶段须另读；不重复扣库存。
6. 实际发车后为派送中；全部正常签收完成后自动进入配送完成。派送中可以“标记异常”：类型必填（拒收、部分签收、车辆异常），退货去向选填（退回海外仓、其他），说明和图片选填。登记沿排车维护权限，按本车版本及原请求键防重，异常记录和图片保存在主单并于现有“排车信息”详情回看；阶段仍为派送中，不自动创建退货、恢复库存或确认签收。异常后续处置由人工处理，本轮不新增线上异常闭环。 6. 实际发车后为派送中；全部正常签收完成后自动进入配送完成。派送中可以“标记异常”：类型必填（拒收、部分签收、车辆异常），退货去向选填（退回海外仓、其他），说明和图片选填。登记沿排车维护权限，按本车版本及原请求键防重，异常记录和图片保存在主单并于现有“排车信息”详情回看；阶段仍为派送中，不自动创建退货、恢复库存或确认签收。异常后续处置由人工处理，本轮不新增线上异常闭环。
2026-10-21 资料入口确认：装车中、装车后从“管理资料”打开整车五类资料；有效排车在派送中、配送完成统一从“管理资料”居中弹框进入，签收文件、装车资料两个页签；2026-10-22 暂隐藏油耗图片上传和展示入口，原图片、版本及历史保留；按本车真实关联派送单及客户范围切换。签收文件与 BOL 复用派送单原附件记录；排车装车资料只维护整车共用的五类资料，不再同时显示另一套派送单装车照片上传框。派送单既有附件仍可从派送单资料入口查看，当前页签的上传类别统计只包含该页签内容。签收文件保存即沿现行逻辑完成对应派送单，全车全部正常签收才汇总配送完成；其他资料后补，不作为完成门禁。车辆与司机审核附件只读回看，油耗图片按车复用车队附加照片、版本及历史；保留原油耗接口的dispatch:list读取、dispatch:edit上传权限，当前排车页面不挂载油耗框，不改变车队原独立权限。外配任务原入口仍只输出五个装车框，但共享记录允许排车入口补充油耗图片；不复制派送签收文件为车队照片，不新增状态或数据库表。 资料入口（2026-10-28 最新确认）：装车中、装车后从“管理资料”打开整车五类资料；有效排车在派送中从“管理资料”居中弹框进入，签收文件、装车资料两个页签，配送完成列表不再提供“管理资料”入口；2026-10-22 暂隐藏油耗图片上传和展示入口，原图片、版本及历史保留；按本车真实关联派送单及客户范围切换。签收文件与 BOL 复用派送单原附件记录；排车装车资料只维护整车共用的五类资料，不再同时显示另一套派送单装车照片上传框。派送单既有附件仍可从派送单资料入口查看，当前页签的上传类别统计只包含该页签内容。签收文件保存即沿现行逻辑完成对应派送单，全车全部正常签收才汇总配送完成；其他资料后补，不作为完成门禁。车辆与司机审核附件只读回看，油耗图片按车复用车队附加照片、版本及历史；保留原油耗接口的dispatch:list读取、dispatch:edit上传权限，当前排车页面不挂载油耗框，不改变车队原独立权限。外配任务原入口仍只输出五个装车框，但共享记录允许排车入口补充油耗图片；不复制派送签收文件为车队照片，不新增状态或数据库表。
2026-10-21 本轮登记契约：`POST /api/platform/v1/last-leg/dispatches/{dispatchNo}/exceptions`，动作`MARK_EXCEPTION`，`recordVersion/idempotencyKey/exceptionType`必填；`returnDirection/description/imageFileIds`选填。说明最多1000字、图片最多20张；异常图片类型`OVERSEAS_DISPATCH_EXCEPTION_EVIDENCE`，平台0、本车ID归属，非空JPG/PNG、单文件10MiB。主表新增可空`exceptions_json`，与原版本、历史、命令账本同事务保存；代码及基线已准备，未执行SQL或部署。 2026-10-21 本轮登记契约：`POST /api/platform/v1/last-leg/dispatches/{dispatchNo}/exceptions`，动作`MARK_EXCEPTION`，`recordVersion/idempotencyKey/exceptionType`必填；`returnDirection/description/imageFileIds`选填。说明最多1000字、图片最多20张；异常图片类型`OVERSEAS_DISPATCH_EXCEPTION_EVIDENCE`，平台0、本车ID归属，非空JPG/PNG、单文件10MiB。主表新增可空`exceptions_json`，与原版本、历史、命令账本同事务保存；代码及基线已准备，未执行SQL或部署。