From fc711c5471835e777ec421a9ef12be996a3b5559 Mon Sep 17 00:00:00 2001 From: ouyangxq <775153912@qq.com> Date: Wed, 21 Oct 2026 15:10:48 +0800 Subject: [PATCH] =?UTF-8?q?=E4=BC=98=E5=8C=96?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- Admin-Client前端原型还原验收规则.md | 2 ++ Admin国内仓样式核对记录.md | 12 +++++++++- Admin高密度界面规范.md | 30 +++++++++++------------ 测试环境单机部署与配置契约.md | 33 ++++++++++++++++++++++++++ 海外仓业务/排车列表统一作业改造契约.md | 1 + 5 files changed, 62 insertions(+), 16 deletions(-) diff --git a/Admin-Client前端原型还原验收规则.md b/Admin-Client前端原型还原验收规则.md index 7130f2c..a285ad6 100644 --- a/Admin-Client前端原型还原验收规则.md +++ b/Admin-Client前端原型还原验收规则.md @@ -45,6 +45,8 @@ 4. 按应用指引完成受影响测试、类型检查及必要的全量测试和构建，重型检查统一经过 `local-check.ps1`；共享组件变更核对全部直接消费者。公共浮层选择器变更覆盖真实 Element 挂载下的嵌套、Teleport、工具栏内浮层及全屏重开。 5. 不触发 Jenkins、不部署、不提交，除非当前对话另有明确授权。 +已改造弹框回看时，复用原固定编号清单，从本轮确定的当前项逐个处理，不另建全量清单、不重排编号。单项流程为“原改造记录与当前代码核对 → 实际截图核对 → 明确保留项和必要局部修正 → 有修改时完成相应代码检查 → 本项人工确认 → 下一项”。缺少截图时只记录源码事实与待核对项，不声称视觉通过；本项未确认前不并行修改后续弹框。复杂窗口的分栏、步骤、树表、预览与已确认尺寸分别核对，不按普通表单模板统一重排。 + ## 证据记录 逐操作矩阵记录：页面／路由、具体操作及承载方式、原型或用户确认依据、采用的主规范章节／业务例外、自动检查结果和人工截图结论。各模块复用现有记录，不另建一份全端进度副本。示例原型的尺寸不覆盖当前已确认的业务尺寸。 diff --git a/Admin国内仓样式核对记录.md b/Admin国内仓样式核对记录.md index 243cebd..2e42fd8 100644 --- a/Admin国内仓样式核对记录.md +++ b/Admin国内仓样式核对记录.md @@ -2,6 +2,16 @@ > 文档职责：仅维护模块范围、业务例外与检查／截图记录。通用样式统一以 [Admin 界面规范](Admin高密度界面规范.md) 为准；下文日期批次中的旧外观不再作为新改造要求。普通样式任务只在涉及本模块范围、例外或验收证据时查阅本文。 +## 弹框逐项复核（2026-10-21） + +用户要求收紧测量样板推广范围，并按既有改造记录逐个回看。继续使用本文[固定编号清单](#当前修改的截图核对清单)，编号不变；该清单兼作此前跨模块弹窗改造的复核入口。旧记录中的三色分区、连续编辑表和历史自动检查是当时的实现事实，不作为本轮必须保留的目标。当前规则以[弹框与表单](Admin高密度界面规范.md#弹框与表单)为准，逐项方法以[执行与验收](Admin-Client前端原型还原验收规则.md#执行与验收)为准。 + +用户本轮明确跳过 **第 1–20 项**，记录为“按用户要求跳过”，不记为视觉通过。当前项为 **第 21 项：编辑库位**；本轮尚无人工确认完成项。第 21 项确认后再看第 22 项，不批量修改后续窗口。历史截图与修正记录保留，不直接记为本轮通过。 + +| 当前编号／入口 | 已核对的源码事实 | 本项待截图核对与处理 | 本轮状态 | +|---|---|---|---| +| 21：国内头程 → 库位管理 `/master-data/locations` → 库位行的「编辑」 | `apps/admin-web/src/modules/warehouse-resources/locations/pages/LocationsView.vue` 的 `editorOpen` 弹框；宽度 `min(1000px, calc(100vw - 28px))`，双列表单、标签在上；标题含库位编码，编辑时所属仓库与状态禁用；模板未使用彩色分区 `data-tone` | 核对实际底色、1000px 双列布局是否合适、只读与可编辑字段辨识、长库位编码与校验错误、底栏及字段间距；保留原字段、保存、取消与编辑锁定，不按测量样板重排 | 源码已核对；页面代码未修改，待本轮人工截图 | + ## 弹框可用性回归排查（2026-10-21） 本轮仅修展示，保留已隐藏的长汇总、订单数量连续性与旧请求防覆盖、既有权限/API/状态/金额。依据本轮用户“弹框布局混乱”反馈及下表实际组件结构排查；没有新增真实页面截图，不把自动检查当成视觉验收。 @@ -87,7 +97,7 @@ ## 当前修改的截图核对清单 -按用户最新要求持续维护固定编号：先完成模块代码，再按本清单逐条提供截图。1—13 沿用对话中既有编号，14—17 对应此前“测量 1—4”。新增条目只向后追加，不因插入模块重排已提供编号。下表记录已落地的本次弹窗样式、共享变化及保留编号的关联核对；代码检查与人工截图结论分别记录在后文，列入清单不代表所有状态已视觉通过。 +本清单保留既有改造编号与历史截图重点，当前逐项复核进度见[弹框逐项复核](#弹框逐项复核2026-10-21)。下表中的浅色分区、连续编辑表等文字只描述此前改造，不是本轮必须保留或推广的目标。1—13 沿用对话中既有编号，14—17 对应此前“测量 1—4”；新增条目只向后追加，不因插入模块重排编号。代码检查与人工截图结论分别记录，列入清单不代表本轮视觉通过。 | 编号 | 菜单 → 操作 | 本次改动及截图重点 | |---|---|---| diff --git a/Admin高密度界面规范.md b/Admin高密度界面规范.md index 92bc2a1..96f7a04 100644 --- a/Admin高密度界面规范.md +++ b/Admin高密度界面规范.md @@ -18,7 +18,7 @@ ## 适用范围与文档职责 -- 本规范是后续 Admin 改版基线：订单与客户管理样板确立业务密度，测量样板确立统一弹窗，蓝白自营样板确立配色、工作台和少提示文字风格。已确认的样式优先于历史原型中的对应外观；业务字段、分组、权限、状态、API、计算口径及页面／弹窗／抽屉承载方式仍按当前业务契约和逐操作确认保留。 +- 本规范是后续 Admin 改版基线：订单与客户管理样板确立业务密度，测量样板仅供参考弹窗基础框架，其三色分区与作业布局属于局部例外；蓝白自营样板确立配色、工作台和少提示文字风格。已确认的样式优先于历史原型中的对应外观；业务字段、分组、权限、状态、API、计算口径及页面／弹窗／抽屉承载方式仍按当前业务契约和逐操作确认保留。 - 规范适用于 Admin；Client、PDA 不自动套用。按用户确定的模块和操作范围逐批实施，规范统一不代表全端已改造或验收，也不授权批量替换公共默认值或发布。 - 本文只维护当前有效规则，不并列保留已被替代的通用样式。新增确认直接修改对应条款，不在文末继续追加另一套规则。代码令牌是数值的唯一实现入口，变更须同步本文对应条款。 - [蓝白样板目录](界面参考/蓝白卡片式工作台风格参考.md)只保存页面参考和原图；[排车列表试点](Admin排车列表样式试点.md)只保存历史依据。二者不再定义通用样式。 @@ -133,9 +133,9 @@ Admin 仍使用 Element Plus。普通 `el-select` 由构建组件解析器统一 ### 弹框与表单 -本节是 **Admin 统一弹窗规范** 的唯一维护入口。2026-10-19 用户确认以测量作业弹窗为视觉样板，统一白底框架、紧凑标题栏、正文分区和固定底部操作。适用于 Admin 各大模块的新增、编辑、审核、只读查看、上传、预览及确认弹窗；按实际用途选择尺寸和内容结构。 +本节是 **Admin 弹窗基础规范** 的唯一维护入口。通用统一范围限于白底框架、基础字号与控件、标题与操作区的可用性、间距和滚动边界；不统一业务正文结构、分区数量、字段排列、固定尺寸或装饰底色。普通表单与复杂作业弹框默认白底，按各自业务组织内容。测量样板的三色分区仅适用于已明确确认的具体窗口，不自动推广到其他新增、编辑、审核、上传、预览或确认弹窗。 -参考图：[测量弹窗原始截图](界面参考/Admin弹窗样板-测量.png)（原附件 `codex-clipboard-3eeb665f-6eee-437e-886b-75d3cc0dc78e.png`）。截图只用于风格依据，尺寸沿用已确认规范；验收仍为 1920×1080、浏览器 100%，不按图片像素反推控件尺寸。 +参考图：[测量弹窗原始截图](界面参考/Admin弹窗样板-测量.png)（原附件 `codex-clipboard-3eeb665f-6eee-437e-886b-75d3cc0dc78e.png`）。仅参考基础框架及该测量场景，不据此复制其他窗口的配色、分区、表格结构或尺寸；验收仍为 1920×1080、浏览器 100%，不按图片像素反推控件尺寸。 ![Admin 弹窗样板：测量作业](界面参考/Admin弹窗样板-测量.png) @@ -157,20 +157,20 @@ Admin 仍使用 Element Plus。普通 `el-select` 由构建组件解析器统一 | 批量预览、对照与选择 | 约 1100px，随实际列宽调整 | 表格为主，保留数量、逐条明细和不可操作原因 | | 测量等大型作业 | 样板 1560px、92vh | 业务分区、作业表格和固定操作底栏 | -以上为类型参考，不覆盖已有逐操作确认的业务尺寸，例如客户重置密码 520px、客户新增/编辑 1120px。宽度同时受视口边距约束；不得靠缩小字号、隐藏字段或截断关键编号来容纳内容。 +以上只用于没有已确认尺寸的新窗口，不作为重排现有弹框的模板，也不覆盖已有逐操作确认的业务尺寸，例如客户重置密码 520px、客户新增/编辑 1120px。复杂工作台按真实信息量保留宽高、分栏与独立工作区；宽度受视口边距约束，不靠缩小字号、隐藏字段或截断关键编号容纳内容。 #### 正文分区、配色与密度 -- 短字段使用紧凑表单或连续键值表，明细使用表格；按业务分组保持阅读顺序。分区标题可与客户、渠道、来源单号、状态或当前操作同行，长内容自然换行。 -- 同一组含只读与可编辑数据时，优先放在一张连续信息表中：只读值直接展示，可编辑值在对应单元格中录入，保留标签、单位和焦点反馈。标签和值横排，不把只读字段做成禁用输入框；少量预估值并入同组末行，不为套用配色额外拆出大汇总卡片。配色统一不能增加层级、重复标题或挤压业务明细。 -- 多分区作业采用浅色背景和细边框，取消左侧强调色条；分区圆角 8px，作为普通容器圆角规则的明确例外。分区同级排列，不层层套卡片。简单确认、短表单及普通说明保持连续白底，按需采用彩色分区。 -- 同类信息复用同一配色，保留文字标题；颜色不代替业务状态或校验提示。 +- 默认使用白底，通过原有业务标题、间距与必要分隔线组织内容；不得因存在录入、只读、汇总或多分区就套黄、蓝、绿背景，也不为套样板新增标题、卡片或分区。 +- 保留已有表单、左右分栏、主从表、步骤、树表、筛选候选、图文对照及预览区域。字段多或交互复杂不构成改成连续信息表、三列表单或同级彩色区块的理由；确有布局问题时先记录具体问题，再单独调整该窗口。 +- 只读值清楚展示，可编辑控件保留可辨识的边框、焦点、标签和校验；不为了连续表外观隐藏输入特征。仅在该窗口的信息关系适合且逐项确认后使用连续编辑表，不把只读与录入强制合并、不机械横排或并入汇总末行。 +- 下表只记录测量作业的已确认配色例外，不是按信息用途自动映射颜色的通用规则。其他具体窗口需要彩色分区时，在本窗口核对记录中说明业务用途与确认依据；旧批次记录中的“黄色录入区”不等于本轮已确认保留。 -| 信息用途 | 样板对应分区 | 浅底色 | +| 适用窗口 | 已确认分区 | 浅底色 | |---|---|---| -| 汇总、实测对比与结论 | 申报与实测对比 | `#f4fbf8` | -| 来源资料、只读申报与明细 | 客户申报明细 | `#f7f9ff` | -| 当前录入、编辑与作业明细 | 平台实测箱规 | `#fffbf4` | +| 测量作业主弹框 | 申报与实测对比 | `#f4fbf8` | +| 测量作业主弹框 | 客户申报明细 | `#f7f9ff` | +| 测量作业主弹框 | 平台实测箱规 | `#fffbf4` | - 表格单元格以白底为主，表头采用“尺寸与颜色”的统一浅蓝底、深蓝文字；普通字号、控件高度、行高、间距沿用公共令牌。单位、必填标识、校验错误、表单标签及原因说明完整保留。 - 汇总尽量只出现一次；表格已完整表达的字段不再另做统计卡片。错误、警告、成功及禁用状态继续使用现有语义，彩色分区不掩盖真实风险。 @@ -196,14 +196,14 @@ Admin 仍使用 Element Plus。普通 `el-select` 由构建组件解析器统一 #### 公共维护与分模块落地 -- 框架能力维护在 `AppDialog.vue`，默认尺寸、字号和间距维护在 `adminDensityTokens.css`，通用外观维护在 `adminDensity.css`。彩色分区推广时提取到公共令牌与显式接入的样式原语；模块只维护字段顺序、列数、业务分组和已确认的尺寸例外，不复制通用 CSS。 -- 已提供的分区原语为 `density-dialog-section`，通过 `data-tone="summary/source/work"` 分别选择汇总绿、来源蓝、录入黄；分区标题使用 `density-dialog-section__title`，连续分区容器使用 `density-dialog-sections`。弹窗通过 `admin-density-dialog` 接入；保留抽屉并显式采用相同详情密度时使用 `admin-density-drawer admin-density-drawer--detail`；实际侧滑编辑使用 `admin-density admin-density-drawer admin-density-drawer--editor`，复用相同分区、连续编辑表和底栏，不改变其他抽屉。公共选择器保持原弹窗的优先级。测量样板与订单弹窗共同消费 `--admin-dialog-*` 令牌，后续模块沿用同一入口。 +- 框架能力维护在 `AppDialog.vue`，基础尺寸、字号和间距维护在 `adminDensityTokens.css`，通用外观维护在 `adminDensity.css`。模块保留业务结构及已确认尺寸；不得通过修改公共默认值，批量去色、重排或重置所有弹框。 +- `density-dialog-section` 及其 `data-tone="summary/source/work"` 是既有彩色分区实现能力，不是所有弹框的必选结构；仅在明确确认保留的场景使用。分区标题类为 `density-dialog-section__title`，容器类为 `density-dialog-sections`，存在公共类不构成采用理由。普通弹窗通过 `admin-density-dialog` 接入基础外观；抽屉按实际查看／编辑用途保留 `admin-density-drawer--detail`／`admin-density-drawer--editor` 等边界，不因此改成连续编辑表或复制测量分区。共用 `--admin-dialog-*` 令牌只统一基础能力。 - 确有必要且已确认的弹窗说明使用 `density-dialog-note`，由公共样式维护外观；是否展示遵循“提示文字与加载布局”，不因存在说明类就新增小字。 - JSON及原文快照显式使用 `density-code-block`，由公共样式维护代码字号、底色和边框；长内容完整换行，沿用外框正文滚动，不另设固定高度、内容截断或纵向滚动。快照属于诊断证据，不据此将数据库ID展示为业务编号。 - 连续信息表需要单元格编辑时，在 `density-table` 上显式添加 `density-table--editable`；数值与单位使用 `density-table-editor` 横排。输入的普通边框融入表格，保留悬停、键盘焦点及禁用反馈；页面只配置标签列宽和字段排列，不复制输入框外观。 - 小表单继续使用 `density-form`；末项已有明确紧凑尾距约定时显式添加 `density-form--flush-end`，不改变其他表单末项为校验错误保留的空间。 - Teleport 弹框自身显式使用 `admin-density-dialog`，原有 `ElMessageBox` 使用 `admin-density-confirm`；原生 `el-dialog` 的外观按同一规范接入，是否收敛到 `AppDialog` 按实际能力和消费者核对，避免一次替换全部弹窗。抽屉继续使用既有 `admin-density-drawer` 边界。 -- 按“盘点当前大模块 → 填写逐操作矩阵 → 完成样板组 → 人工截图确认 → 推广本模块其余弹窗 → 模块整体核对”的流程推进。先从“国内头程”的订单列表相关弹窗开始，以测量弹窗为样板，再依次整理订单测量、测量数据审核、库位管理、托盘管理、整柜业务、船期管理。实际入口以 `adminNavigation.ts` 和模块路由为准，共享弹窗记录全部直接调用方。 +- 已改造弹框按原固定编号清单逐项复核，方法见 [前端验收规则](Admin-Client前端原型还原验收规则.md#执行与验收)。每项先核对改造记录、当前实现及实际截图，再决定保留或局部修正；一个样板通过不授权批量推广其业务布局和配色。共享弹框记录全部直接调用方，已有代码检查与历史截图不能替代本次视觉确认。 - 后续每个大模块按同一流程开展，进度和截图结论写入对应模块核对记录；本规范只维护稳定规则。页面字段、状态、权限、接口、计算口径、校验和提交逻辑继续按当前业务契约执行。 - 代码检查与人工视觉结论分别报告，逐项核对普通/全屏/关闭重开、长内容、空态、错误和权限状态；缺少截图时标记“待人工截图确认”。按模块汇总发布范围，部署继续沿用对应环境授权规则。 diff --git a/测试环境单机部署与配置契约.md b/测试环境单机部署与配置契约.md index 0772a4c..359a107 100644 --- a/测试环境单机部署与配置契约.md +++ b/测试环境单机部署与配置契约.md @@ -1,5 +1,30 @@ # 测试环境单机部署与配置契约 + +## 2026-10-21 FBA 正式确认缺项提示发布与 HTTP 验收 + +- 用户本轮明确授权部署 TEST 与 HTTP 联调验收。Admin Jenkins **#674 SUCCESS**，精确提交 `8b02f1d8700a5c60328e5d2d5b3937f83451d250`，以 #673 / `39534530903c81a35bab24f6cfa531216e9ee9e4` 为基线，仅包含本轮预约相关 13 文件；未混入其他排车改动。Jenkins 临时标签固定配置已恢复 `release/test`。后端未由本轮部署，未执行 SQL、Nacos 发布或原业务单写入。 +- 首次运行独立核对 Admin 对应镜像及 Lastleg 均 running/healthy。期间后续 Admin 发布接续到 `97277b031d3f6a696b21c87f6ae82f1203ab44a7`（直接父提交为本次发布提交），逐文件核对本轮 13 文件 blob 完全一致，修复仍在线；Lastleg 前后镜像 ID 一致且 healthy。 +- 原预约 `YY202610210002` 只读核实：入仓码 `EXXHK2610200266` 的有效箱数为 20，缺 FBA 货件号/追踪号，仍 PENDING / version 0；地区时区仍为 `UTC-5`。该原预约在验收前后完整响应一致，本轮未代填业务资料或修改原 FBA 仓主档。 +- 使用新建独立 TEST 客户及转运单 `ZY202610210006` / `ZY202610210007`，复用既有地区时区测试 FBA 主档；未新建仓主档、未执行 PDA 实收/出库。59 项联调断言通过，覆盖缺资料拒绝且状态/版本不变、核实资料保存/读回/同键重放、补资料不冒充确认成功、正式确认与同键重放不重复推进、陈旧版本拒绝及原资料齐全无需新核实记录。测试预约 `YY202610210003` 最终 SUCCESS / version 1 / `America/Los_Angeles`。货件号与确认号明确为 TEST 合成资料，不表示取得外部真实约仓确认；自有登录会话均已退出，测试样本保留。 +- 公网资源图只读补证 2 项通过：逐票缺项/弹窗补充入口/用途说明及已有预约编辑指引均已发布，并保存资源 SHA256。初次前置主档不足及资源定位失败原报告完整保留，未重放已完成业务写入；后续补证只读取静态资源。证据唯一入口：`baiyue-firstleg/reports/fba-confirmation-674-20261021/summary.json`。 +- 当前结论为发布、HTTP 和静态资源验收通过；真实页面仍按 1920×1080、100% 缩放待人工操作截图确认，不据此宣称视觉或真实第三方预约验收完成。 + +## 2026-10-21 Admin/Client 全量 HTTP 实跑 r1：未通过 + +- 用户明确要求全量测试，本轮串行执行Admin默认全量、Client全量和Client测量计费专项。报告统一保存在`baiyue-firstleg/reports/full-acceptance-20261021-r1/`，总览为`summary.json`；原始失败不改写，不代表页面、弹框或样式验收。 +- Admin：11753项断言，11542通过、211失败；169次模块执行、95个独立模块、6631个独立请求。211项中86项关联请求、125项无请求，包含前置失败的连锁阻断，不等于211个独立接口缺陷。覆盖缺口28项，其中17项阻断。 +- 首要前置为固定称重托盘`TP-001`未找到，测量至装柜及海外收货链因此无法完整执行；OCR本机默认图片不存在。费用目录实际122条/112条ACTIVE，与总数112的断言不同；卡车负例缺必填参数、散板直接状态推进与现行需求池流程不符。预约工作日历/汇总/列表返回A0409协调中；船期日历结构及操作员权限断言还需定向核对。 +- Client：406通过、0失败、2跳过；跳过本轮客户无数据的入仓计划详情、派送单详情。测量计费专项只完成5项前置后中止，配置客户没有`WAIT_SPLIT + APPROVED + SENT`入仓样本；不能按零失败认定专项通过。 +- 执行前13个在用业务服务healthy，Jenkins无在建任务。Lastleg镜像`0af977bdefc1`、Firstleg/Finance镜像`b4ff441a7030`、其余在用服务`f00d0e16cfca`；本地`40a03978c`含更新的排车/派送协议，但本轮下游受前置阻断，版本差异只作后续匹配风险，不能代替实际根因。旧双网关验收配置已收敛，PDA/只读取证配置补齐，实际Jenkins节点名为`java-test-agent`。 + +## 2026-10-21 全量验收脚本离线收敛 + +- 本批优化验收范围与报告口径，修复固定称重托盘缺失时借其他托盘兜底、重派脚本仍调用手工派送/发车、初始化基线及迁移/OpenAPI断言滞后、PowerShell子进程版本和文案误触静态断言等问题。当前默认Admin范围为71个模块，可选模块单列，不将本地合同、HTTP和页面验收混为一个结果。 +- 根级85个、Admin模块137个测试文件共2290项：完整离线批次2289通过、1条静态断言失败；最后修改的船司合同及直接相关异常合同复测14项全部通过。按受影响文件替换复测结果后，2290项均有通过证据、零跳过；这是批次加定向复测的汇总，不改写原失败报告，也不宣称单次全量零失败。 +- 证据：`baiyue-firstleg/reports/acceptance-offline-consolidated-20261021.json`，关联原批次`acceptance-batch-final-green-20261021.xml`及复测`acceptance-carrier-final-20261021.xml`。报告文件名不作为通过依据，以实际断言结果为准。 +- 本批未执行真实HTTP、数据库SQL或部署，未进行页面点击/弹框/样式验收；当前部署是否具备新的装车完成自动派送/发车协议，须在下一次真实验收前核对，不能从本地通过推定。 + ## 2026-10-21 排车日历柜号检索修复已发布 TEST - 用户本轮明确授权发布 TEST。本批仅修复排车日历柜号检索、起运仓当地计划时间说明及缺资料提示，不包含其他任务正在修改的智能排车三栏页面，不执行 SQL、不推进排车业务状态。 @@ -2849,3 +2874,11 @@ Client #382（`a0736239e4ee4cd58b620dab912ffc0641360d9f`）正式页面在1920× - 最终 53 项去重业务检查通过；拼车样本 PDA 扫码及版本检查另有 13 项通过。183 条请求记录中无未知结果，两个真实 S0500 失败请求及修复后结果均保留。首轮运营登记验收的序列化文本一致性断言失败已保留，最终采用结构比较核验原键结果通过，不将历史失败覆盖为通过。临时 PDA 账号已停用，本轮登录会话已退出，合成业务单及附件保留，未删除。 - Admin 已部署容器的页面、健康入口、页面 JS 与路由标题共 20 项 HTTP 检查通过，确认“自有业务 / 外配任务”及实际拼车分类文案。首次将 API origin 当作网页入口的脚本检查失败不作为页面故障；最终证据明确为容器 HTTP，不代替公网浏览器交互或 1920×1080、100% 缩放人工视觉验收。 - 本机私有环境目录证据：`pool-classification-final-report.json`、`pool-classification-release-state.json`、`pool-classification-http-state.json`、`pool-classification-frontend-report.json`、`pool-classification-collation-error.txt` 及对应 Jenkins 日志。凭据和业务响应正文不写入本契约。 + +### 分类页面读取失败修复（2026-10-21 14:59） + +- 用户反馈两个页面均“读取失败”。真实接口已按拼车事实正确分类，但 Admin 两个 API 适配器仍分别只接受 OWNED、DISPATCHED 车辆，导致合法响应被前端拒绝。上一轮业务 HTTP 与静态文案检查未覆盖这层运行时解析，不应据此推定页面可用。此次仅将两处校验改为接受合法的两种车辆归属，并补充列表、详情、保存响应及非法值测试；分类仍由服务端保证。 +- 当前分支修复提交 `fc4c14e420820adbaaafe5af5cfa0b1a12e438ab`。为保留其他任务已发布的预约确认改动且不夹带工作区其他排车修改，以当时实际部署的 `8b02f1d8700a5c60328e5d2d5b3937f83451d250` 为父提交，仅叠加上述四个文件，形成发布提交 `97277b031d3f6a696b21c87f6ae82f1203ab44a7`（tag `test-pool-ui-ownership-20261021`）；未切换或新建工作分支、工作树。`admin-web-test #675` 精确检出、类型检查、构建和部署 SUCCESS，耗时 61.373 秒，运行镜像 `admin-web-test:97277b031d3f` healthy，临时 SCM pin 已恢复。 +- 40 项受影响测试、生产构建及 5 项 Gateway 路由合同通过。当前共享工作区全量回归为 468 文件通过、2 文件失败，4,343 项通过、3 项失败：DispatchesView 两项审核操作按钮断言、DispatchDetailView 一项附件 A0404 诊断断言，均位于其他正在修改的排车代码；不标记全量通过，也未将这些工作区改动加入本次发布。 +- 发布后直接读取运行容器实际引用的两个页面及 API JS，确认旧的单一 ownership 拒绝条件已替换。另通过实际 Admin API 适配器读取正式 Gateway 响应，两个默认列表及 `PC202610210012`、`PC202610210013` 详情共 4 项通过，覆盖无拼车 DISPATCHED 车辆与有拼车 OWNED 车辆；仅替换 HTTP 传输为真实 fetch，保留生产响应解析，未伪造业务数据。验收会话已退出。没有浏览器实际点击或新增人工视觉验收证据。 +- 本次只发布 Admin；Lastleg 镜像仍为 `0af977bdefc1` 且 healthy，无数据库、Gateway、Nacos 或业务数据修改。证据保存在本机私有环境目录 `pool-ui-fix-commit.json`、`pool-ui-fix-release-state.json`、`pool-ui-fix-admin.log`、`pool-ui-fix-assets-before.json`、`pool-ui-fix-assets-report.json` 与 `pool-ui-api-live-report.json`。 diff --git a/海外仓业务/排车列表统一作业改造契约.md b/海外仓业务/排车列表统一作业改造契约.md index a9002ae..250b2a2 100644 --- a/海外仓业务/排车列表统一作业改造契约.md +++ b/海外仓业务/排车列表统一作业改造契约.md @@ -9,6 +9,7 @@ 1. 2026-10-21 用户确认：排车列表显示装车前、装车中、派送中、派送完成四个作业阶段；装车完成代表车辆已开走，不再设装车后人工等待区。 2. 一张排车单就是一趟车，允许同车多个客户、多个目的仓；各票货物、库存、单据和费用必须保留真实客户归属。 3. 装车前包含车辆信息、调度审核、理货员审核；维护车辆信息后提交调度审核，再经理货员审核进入装车中。2026-10-21 用户确认审核链：客服在最初的车辆信息入口维护并提交，不新增独立客服审批级别；调度或理货员任一环节驳回均须填写原因，并统一回车辆信息／客服处理分区，离开待审队列。客服处理期间保留驳回环节、原因和原审核记录，编辑不抹除原因；重新提交开启新轮次，必须重新经过调度及理货审核，不复用旧批准。理货审核允许 Admin 或绑定仓 PDA 操作，两端共用版本、幂等和审核依据；通过前不得真实拣货，通过后才进入装车中。 + 2026-10-21 用户进一步确认：调度审核、理货员审核两个列表分区只提供“审核、详情”，不展示维护车辆信息或其他操作菜单。Admin审核弹框可补充车辆图片、司机照片、驾驶证照片，已有证据只读预览；新增附件随本次通过或驳回保存，不借维护车辆信息重写车辆/司机资料或改变审核依据。上传及提交均按当前待审环节的审核权限校验，并逐文件核验本车及分类归属；附件读取沿列表查看权限。理货驳回、客服修改保留已提供证据，新一轮提交清当前审核附件并保留历史。PDA继续使用既有审核入口，本次不新增PDA上传界面。 4. 2026-10-21 用户确认：装车完成即实际发车，PDA仅提交一次装车完成，直接进入派送中；后台同一装车完成入口遵循相同规则。保留真实拣货核平、实载校验、版本及防重复约束。 5. 装车完成在同一事务内自动按客户和目的地生成出库／派送单、记录实际发车并进入派送中，撤销人工安排派送及确认发车入口。真实外接报价沿原费用路径发布，未知派送补充资料与费用保持未确认，不猜测金额或原费用覆盖、不填写零费；后续由既有后台资料／费用管理维护。失败整体回滚，原请求键恢复最终派送中结果，不能停留半车或重复扣库存。 6. 实际发车进入派送中；全部正常派送签收完成后自动汇总派送完成。拒收、退回等作为异常，先线下人工处理，不自动视为正常签收完成，不在本批新建线上异常闭环或伪造库存恢复、签收、账务结果。