154 lines
20 KiB
Markdown
154 lines
20 KiB
Markdown
# Admin 国内仓样式核对记录
|
||
|
||
## 与客户管理共用样式的维护收敛
|
||
|
||
本次按用户确认，仅整理国内仓与客户管理已接入范围的样式归属；不新增页面、业务操作或环境写入。此前界面验收截图不作为本次收敛后的截图证据，本次仍待人工截图确认。
|
||
|
||
| 国内仓入口/消费者 | 公共层收敛 | 业务例外与边界 |
|
||
|---|---|---|
|
||
| 订单列表及详情 | 公共描边按钮、详情页签、连续信息表、表格基础密度 | 操作资格、详情字段跨列与业务数据排列保留 |
|
||
| 订单测量与审核、称重图片 | 字号、间距、行高使用公共变量，弹框标题/正文/底部由公共层管理 | 1560px / 92vh 作业宽高、图片/画布尺寸、测量对照列保留 |
|
||
| 预装列表与详情、模拟柜与托盘码弹框 | 字号、间距、表格及弹框使用公共规则 | `isPreload` / `dense` 继续显式控制，共用组件未接入入口使用原布局；PDF 标签尺寸不变 |
|
||
| 库位、托盘 | 删除重复弹框框架，统一控件/字号/间距变量 | 560px 编辑宽度、双列表单和业务字段保留 |
|
||
| 整柜业务与库存详情 | 摘要引用公共变量，库存详情使用公共信息表 | 出入库分组、库存事实和交易表结构保留 |
|
||
|
||
默认值唯一入口为 `src/styles/adminDensityTokens.css`，公共外观唯一入口为 `src/styles/adminDensity.css`；业务 CSS 不重新定义按钮配色或密度默认值。维护合同与后续接入规则见《Admin 高密度界面规范》的“国内仓、客户管理的样式维护边界”。
|
||
|
||
## 订单共享子弹框补查矩阵（2026-09-14）
|
||
|
||
从订单页实际 import 追踪到以下两个组件，当前仅由 `UnifiedOrdersView.vue` 调用。原有订单页密度根不能覆盖其 Teleport 弹框。依据本轮统一要求补齐显式入口，保持当前业务合同和以下承载，不恢复原型旧字段。矩阵对应实际组件模板及页面调用，而非仅凭原型推断。
|
||
|
||
| 组件与操作 | 当前承载 / 尺寸 | 核对结论 |
|
||
|---|---|---|
|
||
| `InboundFeeDetailManager.vue` 新增、编辑、已审核费用调整 | 680px 居中框、两列表单 | 保留应收/应付、结算方式、已付字段、凭证、金额及版本；显式接入弹框和表单密度，长备注/凭证整行。 |
|
||
| 同组件审核、驳回、删除、作废 | 审核为原行内动作；驳回为 AppDialog 默认 560px；删除/作废独立确认框 | 保留权限和状态。待审核最多四个可用操作，超过三个才将删除收起；三项以内全部直显；已审核的调整/作废两项直显。 |
|
||
| `OrderDeclarationEditorDialog.vue` 订单申报、渠道修改 | 1180px 居中框；渠道变更另有确认框 | 保留四项只读信息、订单级五项表单、原货品表及渠道确认内容；只让弹框正文滚动，去掉内部重复滚动容器。 |
|
||
| 同组件货品申报编辑 | 980px 居中框、四列 22 项字段 | 保留“应用本项”、字段顺序、长备注跨列及原校验，行内编辑使用共享描边按钮。 |
|
||
|
||
上述四处弹框已补齐公共密度入口，61 项定向测试、1971 项全量测试、类型检查、构建和 git diff --check 通过；仍待人工截图确认。保留计费、凭证上传、审核资格、货品项序号、仓库实测和订单版本请求。
|
||
|
||
## 2026-09-14 接手复核：订单列表与详情样式失效
|
||
|
||
用户在本地订单列表发现按钮回退，并提供详情截图：页签呈浏览器默认按钮，基本信息退回逐项竖排。复核发现 `UnifiedOrdersView.vue` 的列表与详情共用外层缺少 `admin-density`；子项虽已改为公共类，公共选择器和变量却无法生效。已在两种路由共用的页面外层补回入口。
|
||
|
||
维护合同新增模板祖先检查，覆盖订单与客户页面中的公共操作按钮、页签、信息表；避免仅凭 CSS 导入和子项类名存在就判为通过。用户截图确认的是修复前问题，修复后仍待 1920×1080、100% 缩放人工截图确认。
|
||
|
||
本次验证：订单页面与公共密度定向测试 48/48、`pnpm typecheck`、`pnpm build` 和差异空白检查通过；AGENTS 索引合同 1050 项通过。当前工作区全量测试 1910/1911 通过，唯一失败为费用项目页面的 5000ms 超时，该文件单独复跑 5/5 通过；不将这次全量运行记录为全部通过。验证覆盖工作区现有在途代码，未提交或部署。
|
||
|
||
## 国内仓 7 个菜单统一复核与返回入口调整（2026-09-14）
|
||
|
||
用户要求按全部 7 个菜单继续收敛，并提供整柜库存详情返回按钮独立于信息区的截图。本次取消“只有订单列表采用描边行内按钮”的旧范围例外；列表权限、操作资格、加载/禁用状态、确认与保存事件不变。
|
||
|
||
| 菜单 | 本次核对和调整 | 详情与弹框范围 |
|
||
|---|---|---|
|
||
| 订单列表 | 保留修复后的页面密度根与公共描边按钮 | 详情七个页签、测量/审核及页面内弹框；返回接入公共轻量导航 |
|
||
| 订单测量 | 行内测量为紫色、查看为灰色，移除装饰图标 | 共用测量作业、手动录入、图片预览和称重确认 |
|
||
| 测量数据审核 | 行内审核为橙色、查看为灰色，移除装饰图标 | 共用审核工作区、测量图片和确认窗口 |
|
||
| 预装清单 | 查看接入灰色描边；通过 `isPreload` 隔离共用组件 | 详情行内备注、返回、运输信息/备注/确认弹框、模拟柜和托盘打印；已确认清单模式不变 |
|
||
| 库位管理 | 编辑灰色、启用绿色、停用/删除红色；按钮组间距使用公共规则 | 560px 编辑弹框、确认消息保持显式密度入口 |
|
||
| 托盘管理 | 编辑灰色、删除红色；按钮组间距使用公共规则 | 560px 编辑弹框及删除确认 |
|
||
| 整柜业务 | 查看库存接入灰色描边 | 新建入库/出库弹框；库存详情返回、编号、状态与基本信息合并为一个白底区，交易记录保留独立分区 |
|
||
|
||
维护检查覆盖导航中的精确 7 个入口、测量/审核/预装入口的实际共享组件模式、独立打开页面所需的 CSS 导入、公共样式的模板祖先，以及弹框自身的接入类。不能把进入过订单页后其他页面“看起来正常”当作独立入口通过。用户截图属于调整前证据，全部修改后的视觉状态仍待 1920×1080、100% 缩放人工截图确认。
|
||
|
||
本次同时消除公共按钮组 6px 间距与 `DataTable` 默认 8px 左边距叠加的问题；未接入按钮仍使用原默认值。验证结果：7 页及详情定向测试 142/142、全量测试 249 个文件与 1913 项测试通过；最终表格间距合同及 DataTable 回归 28/28 通过，类型检查、构建与 AGENTS 索引合同 1050 项通过。未执行部署或业务数据写入。
|
||
|
||
## 向后续模块复用前的规则核对（2026-09-14）
|
||
|
||
复核发现“父子订单关联”抽屉遗漏 `admin-density-drawer`，已补回并增加抽屉独立入口检查。公共斑马纹、描述表标签背景和按钮悬停色现统一由变量消费。完整发现、验证结果和后续接入结论见 [客户管理核对记录](Admin客户管理样式核对记录.md) 的“向后续模块复用前的规则核对”；货柜管理入口与共享边界见 [货柜管理核对记录](Admin货柜管理样式核对记录.md)。这次复核不将历史截图视为新效果验收证据。
|
||
|
||
## 首轮国内仓验收依据（历史记录）
|
||
|
||
依据：已确认订单样板与 [Admin 高密度界面规范](Admin高密度界面规范.md)。首轮覆盖第 1、2、3 组。当时用户明确要求由 AI 在 1920×1080、100% 缩放下进行界面验收；该授权只用于当轮界面检查。
|
||
|
||
## 改造前逐操作矩阵
|
||
|
||
原型路径前缀为 `docs/悦/货代SAAS平台后台/prototype-src/`。保留实际业务入口、权限、提交与关闭语义，仅收敛密度。
|
||
|
||
| 页面 | 操作及当前承载 | 原型/代码依据 | 实施结论 |
|
||
|---|---|---|---|
|
||
| 订单测量 | 列表、详情跳转订单页 | `modules/02-domestic-warehouse.html:1465`；InboundTaskList | 紧凑表格，复用已确认订单详情 |
|
||
| 订单测量 | 测量作业居中弹框、全屏 | `overlays.html:720`；InboundMeasurementDialog | 1560px、92vh，固定标题和底部操作 |
|
||
| 订单测量 | 手动录入、测量原图、称重确认居中弹框 | InboundMeasurementPanel、WeightOcrPanel | 原有宽度与字段，统一边距及正文滚动；原图保留可读尺寸 |
|
||
| 测量审核 | 列表、审核居中弹框 | `overlays.html:811`；InboundTaskList、MeasurementReviewPanel | 1560px 审核工作区，操作栏可见，紧凑对比与明细 |
|
||
| 测量审核 | 审核通过二次确认、称重修正与原图 | MeasurementReviewPanel.confirmApprove、WeightOcrPanel | 保留确认、原因及权限；当前没有驳回按钮，不恢复历史操作 |
|
||
| 预装清单 | 列表、详情独立路由 | `modules/06-containers.html:1105,1118`；PreloadPlanDetailView | 使用可用页面宽度，摘要与历史表格 |
|
||
| 预装清单 | 新增模拟柜居中弹框 | ContainerSimulationCreate | 仅预装入口显式接入密度，保留当前业务流程 |
|
||
| 预装详情 | 补录/纠正运输信息、编辑仓库备注、确认预装居中弹框 | PreloadPlanDetailView 的三个 AppDialog | 统一标题、正文、操作区；尺寸随内容保留 |
|
||
| 预装详情 | 打印托盘码居中弹框与 PDF 输出 | PalletLabelPrintDialog；`overlays.html:1902` 为历史标签预览 | 保留当前 PDF 下载流程和标签尺寸，只调整选项容器 |
|
||
| 库位管理 | 列表、新增/编辑居中弹框 | `modules/02-domestic-warehouse.html:1807,1827` | 紧凑列表与双列表单，保留 560px 宽度 |
|
||
| 库位管理 | 启用/停用、删除二次确认 | LocationsView.toggleStatus/removeLocation | 保留业务文案、禁用、危险语义 |
|
||
| 托盘管理 | 列表、新增/编辑居中弹框、删除确认 | `modules/02-domestic-warehouse.html` 的 modal-pallet；PalletsView | 大统计卡改摘要行；当前路由没有托盘独立详情，不新增历史页面 |
|
||
| 整柜业务 | 入库/出库/库存页签与列表 | `modules/02-domestic-warehouse.html:1897` | 38px 彩色图标页签，库存统计改摘要行 |
|
||
| 整柜业务 | 新增入库、新增出库居中弹框 | `modules/02-domestic-warehouse.html:1931` 及相邻出库弹框 | 720px 双列表单，固定操作区 |
|
||
| 整柜库存 | 库存详情独立路由、交易记录 | `modules/02-domestic-warehouse.html:1923` | 四列连续描述表，长文本换行，紧凑流水表 |
|
||
|
||
预装完成后的跳转进入货柜管理既有详情，不扩大到全部货柜菜单。共享组件须显式接入，其他入口默认不受影响。
|
||
|
||
## 验收结果
|
||
|
||
2026-09-14 完成第 1、2、3 组实现和首轮浏览器界面验收。视口为 **1920×1080，缩放 100%**，使用当前本地 Admin 页面与现有测试数据。下表只表示实际检查到的界面，不代表写入流程或全部权限状态通过。
|
||
|
||
| 范围 | 实际检查 | 结论与本轮修正 | 截图证据 |
|
||
|---|---|---|---|
|
||
| 订单测量 | 列表、测量作业、手动录入、全屏/退出全屏、取消与重开；另从订单列表进入共用测量工作区 | 1560px 作业框及固定底部可用；修正样式优先级，使五项实测摘要保持一行；缩小表单组间距 | [测量工作区](../.codex-temp/admin-density-acceptance/order-measurement.png) |
|
||
| 测量审核 | 9 条待办；单票审核、测量原图、含托盘毛重修改、审核通过二次确认；勾选后批量审核确认并取消 | 审核框按内容自然收高；修正箱规、时间列宽，避免尺寸和时间截断；称重图与数据紧凑并列，原图窗口保留查看面积 | [审核工作区](../.codex-temp/admin-density-acceptance/measurement-review.png)、[称重修正](../.codex-temp/admin-density-acceptance/review-weight.png)、[批量确认](../.codex-temp/admin-density-acceptance/review-batch-confirm.png) |
|
||
| 预装清单 | 列表、新增模拟柜、两票明细详情、长船名、仓库备注、补录运输信息、打印托盘码选项 | 摘要四列、客户跨列、历史改紧凑表格；修正长表头单位换行及订单/SKU/客户列宽；缺少订舱或 PDA 已开始时，原禁用与只读提示保持可见 | [列表](../.codex-temp/admin-density-acceptance/preload-list.png)、[详情](../.codex-temp/admin-density-acceptance/preload-detail.png)、[备注](../.codex-temp/admin-density-acceptance/preload-remark.png)、[运输信息](../.codex-temp/admin-density-acceptance/preload-transport.png)、[打印选项](../.codex-temp/admin-density-acceptance/preload-print.png) |
|
||
| 库位管理 | 96 条记录列表、新增双列表单、状态筛选空态、查询重置、加载失败后重试 | 560px 表单完整显示；系统库位/占用库位操作限制保留；仓库名称与编码为两行，允许行高自然增长 | [列表](../.codex-temp/admin-density-acceptance/locations-list.png)、[表单](../.codex-temp/admin-density-acceptance/location-editor.png)、[空态](../.codex-temp/admin-density-acceptance/locations-empty.png) |
|
||
| 托盘管理 | 7 条记录列表、新增、已有托盘编辑后取消 | 统计改摘要行；560px 双列表单完整显示，容积、重量、颜色和备注保持原字段 | [列表](../.codex-temp/admin-density-acceptance/pallets-list.png)、[新增](../.codex-temp/admin-density-acceptance/pallet-create.png)、[编辑](../.codex-temp/admin-density-acceptance/pallet-edit.png) |
|
||
| 整柜业务 | 入库、出库、库存三个页签；新建入库/出库弹框；部分出库库存详情及 3 条交易记录 | 彩色页签、摘要行、720px 双列表单、四列描述表正常；长单号列表省略，详情交易表显示完整编号；底部操作可见 | [入库](../.codex-temp/admin-density-acceptance/container-inbound.png)、[出库](../.codex-temp/admin-density-acceptance/container-outbound.png)、[库存](../.codex-temp/admin-density-acceptance/container-inventory.png)、[入库表单](../.codex-temp/admin-density-acceptance/container-inbound-editor.png)、[出库表单](../.codex-temp/admin-density-acceptance/container-outbound-editor.png)、[库存详情](../.codex-temp/admin-density-acceptance/container-detail.png) |
|
||
| 已确认订单样板回归 | 订单列表测量入口、详情基本信息、状态历史 | 共用样式提取后测量正常；补齐订单页通用弹框样式导入；彩色页签、连续描述表与历史表保持 | [基本信息](../.codex-temp/admin-density-acceptance/order-detail.png)、[状态历史](../.codex-temp/admin-density-acceptance/order-history.png) |
|
||
|
||
截图位于当前工作区临时验收目录，不作为应用资源或构建产物提交；需要长期归档时应另行保存这些证据。
|
||
|
||
### 自动检查
|
||
|
||
- `pnpm typecheck`：通过。
|
||
- `pnpm test`：247 个测试文件、1899 项测试通过。此前一次并行负载下费用项目页面测试超时，单独复跑 5/5 通过，随后完整重跑也全部通过。
|
||
- `pnpm build`：通过。
|
||
- `git diff --check`：通过。
|
||
- 后端根 `./scripts/agents-index-contract.ps1`：1050 项离线索引检查通过，不访问业务服务或数据库。
|
||
|
||
### 覆盖边界与发现
|
||
|
||
1. 所有新增、保存、提交审核、确认预装和删除等业务写入均未执行；打印只检查选项窗口，未生成 PDF。本轮检查的是样式与可达交互，提交成功、服务端校验失败、处理中关闭等业务结果不列为实页通过。
|
||
2. 已访问的预装记录处于未关联订舱、PDA 作业中或已确认状态，未进入可提交的“确认整份预装计划”窗口。该窗口已接入统一样式并通过代码测试，实际可确认状态仍待补充截图。库位现有可用记录为系统 A0，其余样本为占用状态，编辑、启停及删除确认未取得实页证据；保留原权限与限制，不为截图改动测试数据。
|
||
3. 未切换账号验证全部无权限状态，也未穷举大批量照片、多页长表、所有业务状态。本轮称重原图样本为红色测试占位图片，只能验证图片承载与窗口布局，不能代表真实照片清晰度验收。
|
||
4. 测量草稿的客户名称显示“客户未命名”，而相同订单的列表/详情有客户名称，作为既有数据展示问题记录；本轮未修改客户映射与业务接口。
|
||
5. 库位首次加载曾失败，重试后正常。后续审核页客户筛选出现“服务暂时不可用”，待办数据仍显示；错误提示没有遮挡列表，见 [筛选加载失败](../.codex-temp/admin-density-acceptance/review-filter-error.png)。不将环境服务可用性计入视觉通过。
|
||
6. `LoadingListDetailDrawer` 同时供预装和已确认清单使用：历史记录的表格结构会影响这两个消费者，既有筛选和排序保持不变；其余紧凑间距仅预装入口启用。模拟柜创建、托盘码打印通过可选 `dense` 参数接入，其他入口未改变默认密度。
|
||
|
||
本轮未部署、未修改数据库或测试业务数据。规则与实现可以作为国内仓后续样式维护基线；上列未覆盖状态补齐后再作完整业务验收结论。
|
||
|
||
## 人工验收调整：订单列表行内按钮
|
||
|
||
用户提供参考图 `codex-clipboard-3cab512c-3b1a-412c-9a6d-1cbf796bf020.png`，要求订单列表采用该按钮风格。
|
||
|
||
| 页面/操作 | 参考依据 | 当前承载与调整 | 验收状态 |
|
||
|---|---|---|---|
|
||
| 订单列表：详情 | 参考图深灰纯文字、白底细边框 | 保留独立详情页跳转；移除按钮前图标，采用深灰文字 | 待人工截图确认 |
|
||
| 订单列表：通过 | 参考图橙色审核按钮 | 保留订单审核弹框与确认流程；改橙色文字及浅橙边框 | 待人工截图确认 |
|
||
| 订单列表：测量 | 参考图紫色业务操作按钮 | 保留测量作业弹框；改紫色文字及浅紫边框 | 待人工截图确认 |
|
||
| 订单列表：备注、更多 | 参考图普通描边按钮 | 备注用深灰纯文字；更多保留省略号及原下拉操作，不改变权限和排列顺序 | 待人工截图确认 |
|
||
|
||
所有行内按钮保持 28px 高度，按钮间距 6px；白底无阴影、细边框、6px 圆角。悬停、键盘焦点、处理中和禁用反馈保留。未调整顶部工具栏及弹框操作，未增加参考图中的客户管理功能。通用说明同步到《Admin 高密度界面规范》的“订单列表行内按钮”。
|
||
|
||
本次 `pnpm typecheck`、`pnpm test`（247 个文件、1899 项测试）、`pnpm build` 和 `git diff --check` 均通过。未部署；待用户在 1920×1080、100% 缩放下提供本次按钮截图。之前首轮验收截图不作为本次按钮效果通过的证据。
|
||
|
||
## 脚本确认框补查（2026-09-14）
|
||
|
||
沿已登记组件的实际引用检查发现八处 ElMessageBox 确认未显式接入密度。以下均保留当前确认框承载、原提示和操作逻辑；本次仅补充 customClass。
|
||
|
||
| 页面 / 操作 | 当前承载与结论 |
|
||
|---|---|
|
||
| 国内托盘删除 | 原有删除确认框；保留危险按钮和占用门禁提示 |
|
||
| 国内库位启用/停用 | 原有状态确认框；保留不同状态的标题、提示与版本 |
|
||
| 删除称重图片 | 原有确认框；保留本票库位不会释放说明 |
|
||
| 测量加载最新版本 | 原有放弃草稿确认框；保留继续编辑 |
|
||
| 提交测量数据 | 原有提交确认框；不改变校验及提交顺序 |
|
||
| 关闭未保存测量窗口 | 原有放弃修改确认框；保留取消后停留 |
|
||
| 订单解除同柜组 | 原有解除确认框；保留原有资格、提示和接口 |
|
||
| 入库费用作废 | 原有作废确认框；保留费用版本与原因校验 |
|
||
|
||
184 项定向检查通过；最终 253 个文件 / 1982 项全量测试、类型检查、构建和 git diff --check 通过。八处确认框均仅补充显式密度入口，提示、权限、版本和提交逻辑未变。人工截图待确认。
|