docs/Admin国内仓样式核对记录.md

# Admin 国内仓样式核对记录

依据：已确认订单样板与 [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% 缩放下提供本次按钮截图。之前首轮验收截图不作为本次按钮效果通过的证据。