docs/Admin全模块样式核对记录.md

# Admin 全模块样式核对记录

范围为 `apps/admin-web/src/core/navigation/adminNavigation.ts` 当前可见的 48 个菜单、顶部消息中心的 3 个正式页面，以及它们通过实际路由和组件可达的新增、编辑、详情、审核、文件、删除确认等操作。隐藏原型不恢复；某操作没有正式入口时记录现状，不凭原型补建业务能力。目标不缩减为已改模块。

统一依据为本轮用户确认、国内订单/客户详情样板及 [高密度界面规范](Admin高密度界面规范.md)。操作不超过 3 个时全部显示，超过 3 个才折叠；折叠按钮只显示省略号图标，保留提示和可访问名称。

| 导航组 | 可见菜单数 | 当前记录及下一步 |
|---|---:|---|
| 顶部消息中心（侧栏外） | 3 个页面 | 已补入三个列表、两处详情抽屉、两处编辑弹框及状态确认，见 [消息中心记录](Admin消息中心样式核对记录.md)；1981 项全量测试、类型与构建通过，待人工截图 |
| 首页数据看板 | 1 | 四项真实指标、刷新与全屏已接入；代码检查通过，待人工截图，见 [首页与系统记录](Admin首页与系统管理样式核对记录.md) |
| 客户管理 | 2 | 已有 [客户管理记录](Admin客户管理样式核对记录.md)，最终按截图复核 |
| 国内仓 | 7 | 已有 [国内仓记录](Admin国内仓样式核对记录.md)，最终按截图复核 |
| 货柜管理 | 4 | 已有 [货柜管理记录](Admin货柜管理样式核对记录.md)，最终按截图复核 |
| 海外业务 | 3 | 代码已修正，代码门禁通过，待人工截图，见 [海外业务记录](Admin海外业务样式核对记录.md) |
| 海外仓 | 10 | 已有 [海外仓记录](Admin海外仓样式核对记录.md)，尾程截图差异及省略号按钮已修正，仍需修正后截图 |
| 客户服务 | 2 | 代码已修正，覆盖异常新增/详情、回访/再次回访及资料，见 [客户服务记录](Admin客户服务样式核对记录.md)；代码门禁通过，待人工截图 |
| 财务管理 | 6 | 代码已修正，覆盖 11 路由、7 个页面文件及 11 处弹框声明；1950 项全量测试、类型与构建通过，待人工截图，见 [财务管理记录](Admin财务管理样式核对记录.md) |
| 通用 | 10 | 10 菜单、14 页面代码样式已核对，1957 项全量测试、类型与构建通过，待人工截图，见 [通用资料记录](Admin通用资料样式核对记录.md) |
| 系统管理 | 3 | 三页及新增/编辑/配置/启停/删除已核对；菜单权限恢复 720px 居中框，1961 项全量测试、类型与构建通过，待人工截图，见 [首页与系统记录](Admin首页与系统管理样式核对记录.md) |

“已有记录”不是视觉验收通过。每组必须保留逐操作矩阵、受影响测试/类型/构建证据，以及人工在 1920×1080、100% 缩放下提供的截图结论；缺少截图标记待确认。

## 共享子弹框复核

2026-09-14，已补齐订单费用新增/编辑/调整、费用驳回、订单申报编辑和货品申报编辑四处弹框的显式密度入口。保留原尺寸、表单、权限和提交行为，费用行操作按实际权限计数，不超过三个直接显示，超过三个使用纯省略号图标。

从密度合同声明的 93 个页面/组件入口沿实际 Vue import 检查到 118 个组件，未再发现缺少显式密度入口的弹框；引用检查已纳入维护合同，覆盖静态导入及字面量动态导入。当前左侧生产导航 48 个菜单均对应已登记的页面或组件入口。后续复核发现顶部消息中心未被侧栏清单覆盖，已另行补入三个正式页面及两个组件；原 93 / 118 计数仅为该次补查范围。此项为代码覆盖检查，不代表全部页面的视觉验收。

四处弹框相关 61 项定向测试、1971 项全量测试、类型检查、构建及 git diff --check 通过。本地 Vite 返回的排车列表、尾程订单列表均已采用纯省略号操作按钮。仍待人工在 1920×1080、100% 缩放下核对修正后的页面及弹框截图。

## 应用外层确认框

沿正式路由检查后，顶部消息中心已补齐。登录、首页入口重定向与 403 属于应用外层；不机械套用业务表格密度。应用外层的退出登录、权限变化、关闭页签、离开未保存页面和新版本恢复五处确认均已显式接入公共样式，51 项定向检查通过；取消、权限和草稿保护逻辑未改变。

| 应用外层操作 | 当前承载与依据 | 调整结论 |
|---|---|---|
| 退出登录 | AppLayout 现有消息确认框；原型无具体确认容器 | 保留原提示、取消与登出流程，只接入公共确认框样式 |
| 权限变化 | AppLayout 现有警告框 | 保留未保存条目说明与关闭失权页签逻辑 |
| 关闭页签 | WorkspaceTabs 现有未保存确认框 | 保留继续编辑、放弃并关闭以及后续焦点行为 |
| 离开未保存页面 | router/index.ts 的现有路由守卫确认框 | 保留守卫与版本缓存失效逻辑 |
| 新版本资源恢复 | main.ts 的现有刷新确认框 | 保留确认后刷新与放弃草稿边界，不触发真实刷新 |

以上五处仅统一消息框密度，不改变承载方式或内容。原型未定义的保护行为沿用当前实现，人工截图待确认。

## 人工证据待补

代码与离线测试不能证明最终 CSS 优先级、溢出、遮挡、缩放或长内容效果。人工按 1920×1080、100% 缩放逐项截图：

1. 国内订单与尾程订单详情（同一页签）、排车列表（少于/等于三个与超过三个可用操作的记录），复核此前反馈。
2. 顶部消息中心的三个列表、消息和模板新增/编辑、任务/消息详情抽屉，确认字段换行、滚动及底部按钮。
3. 各模块记录中尚未取得的新增、编辑、审核/确认、文件预览、删除/停用、未保存保护等状态截图，逐操作闭环，不以一张列表图代替详情或弹框。

在上述证据补齐前，全模块视觉目标保持未完成。不得把已登记组件检查与全量测试通过写成已完成所有页面视觉验收。

## 本轮最终代码门禁

最终 253 个文件 / 1982 项全量测试、类型检查、构建和 git diff --check 通过。消息中心 42 项、应用外层 51 项、国内仓确认框 184 项定向检查通过（这些集合存在共享合同重叠，不将其简单相加）。实际引用链覆盖 123 个 Vue 组件的 56 处业务消息框调用，以及应用外层五处确认。原有业务脚本在排除样式导入、customClass 与此前已确认的费用按钮计数函数后保持一致。

未部署，未向真实账号发送消息，未操作数据库或业务记录。不将代码门禁视为全模块视觉验收通过。

## 2026-09-15 浏览器截图验收

用户已明确授权内置浏览器在测试环境截图，后续不再以缺少人工截图授权作为阻塞原因。本批按 1920×1080、100% 缩放取得 10 张截图，见 [测试环境截图验收记录](Admin测试环境截图验收记录-20260915.md)。国内与尾程订单详情基本信息、排车按钮和编辑弹框已取得实际页面证据。

测试首页和消息模板仍未呈现本地最新样式；需获得单独的 Admin 测试部署授权并确认版本，再继续完整验收。其余页面和状态仍待逐项核对，本批不代表全模块通过。