docs/Admin通用资料样式核对记录.md

# Admin 通用资料样式核对记录

范围为 `adminNavigation.ts` 的通用组 10 个可见菜单，沿正式路由定位到 14 个页面。10 个菜单的 14 个页面已完成代码样式核对；全部修改后页面尚待人工截图确认。隐藏产品信息、税率和旧库位页面不恢复。

原型目录为 `docs/悦/货代SAAS平台后台/prototype-src/`。列表操作依据当前用户确认：不超过 3 个全部显示，超过 3 个才折叠，折叠入口只显示省略号。新增、编辑、详情、文件和确认逐项检查，不能从某一弹框推断其他操作。

| 菜单 | 正式页面入口（`apps/admin-web/src/modules/` 下） | 原型入口 | 已定位操作 / 下一步 |
|---|---|---|---|
| 供应商列表 | `suppliers/pages/SuppliersView.vue`、`SupplierDetailView.vue`、`SupplierFormView.vue` | `05-suppliers.html`：列表 34 行、编辑 108 行 | 独立新增/编辑/详情；实际引用 `components/SupplierLicenseDialog.vue` 560px；核对返回、资质信息与操作权限 |
| 快递公司 | `master-data/express-companies/pages/ExpressCompaniesView.vue` | `05-suppliers.html`：2 行 | 批量导入、580px 编辑抽屉；原型静态列表仅列出新增/导入/导出，具体表单原型未定义，保留当前承载 |
| 往来单位 | `master-data/counterparties/pages/PartnersView.vue` | `05-suppliers.html`：8 行 | 680px 编辑/详情抽屉、批量导入；详情、编辑、启停均已显式接入，保留真实权限 |
| 费用项目 | `fee-items/pages/FeeItemsView.vue` | `10-general.html`：8 行 | 620px 编辑抽屉；启停与删除分别使用确认框；核对表单分组和危险操作 |
| 汇率管理 | `overseas-master-data/pages/ExchangeRatesView.vue` | `10-general.html`：21 行 | 560px 月度汇率新增/编辑框，保留月份和汇率校验 |
| 仓库管理 | `warehouses/pages/WarehousesView.vue` | `10-general.html`：44、51、58、65 行 | 多类仓库列表；650px 新增/编辑框、760px 导入框，无独立详情入口；保留仓库类型、版本、导入文件和状态操作 |
| 海外仓报价 | `overseas-master-data/pages/OverseasQuotesView.vue` | `10-general.html`：167 行 | 980px 详情、1180px 新增/编辑框；保留报价与计费字段 |
| 船期价格表 | `fba-pricing/carrier-rates/pages/CarrierRatesView.vue`、`CarrierRateDetailView.vue` | `10-general.html`：273 行；当前价格簿接口与应用指引优先 | 560px 上传框、独立版本详情、仓库映射/确认；价格行只读，不恢复旧原型手工计价能力 |
| 车辆列表 | `overseas-master-data/pages/VehiclesView.vue`、`VehicleDetailView.vue` | `10-general.html`：314、442 行 | 760px 新增/编辑、480px 状态变更、独立详情；核对关联派送及更换记录 |
| 下载中心 | `downloads/pages/DownloadCenterView.vue` | `10-general.html`：228 行 | 720px 任务详情框、下载与重试；保留任务状态/退避/文件权限 |

共享批量导入组件与供应商资质组件须沿实际调用逐项检查是否能显式接入密度样式。不能仅在父页面增加类名就声称 Teleport 弹框已覆盖。

本轮先实施供应商、汇率、海外仓报价、车辆四个菜单（7 个页面及供应商资质组件）。供应商新增/编辑/详情继续独立路由；资质 560px、汇率 560px、报价详情 980px/编辑 1180px、车辆编辑 760px/状态 480px 保留承载和宽度，车辆详情继续独立页面。海外资料操作证据补充见应用内 `overseas-master-data/PROTOTYPE_MATRIX.md`：`modal-gen-overseas-quote-detail`、`modal-gen-overseas-quote`、`modal-exchange-rate-edit`、`modal-vehicle-edit`。供应商资质来自 `overlays.html:660`，保留其证照版式。供应商分类数量合并到同一组彩色页签，保留四类数量与筛选事件；连续详情使用公共页头与字段网格，列表行内操作均不超过三个，全部直显。状态和停用确认只接入外观，保留原权限、版本与请求。

所有修改后页面仍需人工在 1920×1080、100% 缩放下提供截图核对。

## 其余六菜单逐操作核对

- 快递公司：编辑、启停最多两项直显；580px 编辑抽屉和共享批量导入 720px。原型未定义的具体编辑承载按当前实现保留，不擅自改为独立页。
- 往来单位：详情、编辑、启停最多三项直显；680px 详情/编辑抽屉和共享批量导入 720px。
- 费用项目：编辑、启停、删除最多三项直显；620px 编辑抽屉，启停和删除各有确认框。
- 仓库管理：编辑、启停最多两项直显；650px 编辑和 760px 导入框。不要把 `AppDialog` 内表单误认为独立页面。
- 船期价格表：列表详情、原文件、待确认版本作废最多三项直显；560px 上传框；独立详情页头保留下载与确认生效操作，不按列表行内按钮压缩。
- 下载中心：详情、成功后下载、符合条件时重试；详情 720px 弹框，按状态保留后端重试资格。

共享 `BatchImportDialog.vue` 保持单一 `el-dialog` 为根；挂载测试已验证父传 class 实际到达 Teleport 根。组件直接引用密度变量并保留未接入时的默认值，无需新增参数。

## 已实施四菜单的检查结果

2026-09-14：7 个页面和供应商资质组件显式接入公共密度。供应商分类数量并入彩色页签；汇率四项摘要保留为紧凑一行；三个独立详情/表单页使用公共 `density-detail-layout`、同行返回与业务标题，供应商路由关闭重复页头。报价详情采用两组连续键值表，供应商及车辆长字段跨列；车辆标题不再回退内部 ID，筛选、列表、表单与详情统一使用原中文状态名称。

- 原字段及作业入口保留：供应商表单 14 项、报价表单 8 项及两组 10 个表格列、车辆表单 10 项、汇率表单 3 项；供应商详情 12 项、车辆详情 11 项。已有资质版式和六个弹框的宽度、关闭与提交逻辑保留。
- 定向测试 60 项通过，包含长供应商名称/地址、返回目标、车辆详情失败不展示内部 ID、最多三个操作直接显示；原有版本冲突、长 ID、汇率精度和失败保留表单测试继续通过。
- 全量测试 251 个文件、1956 项通过。随后仅统一车辆状态中文名称，再次运行上述 60 项定向检查和 `pnpm build`（含类型检查），均通过；`git diff --check` 通过。
- 本地 5173 开发服务返回这 7 个页面的已编译密度代码，HTTP 均为 200。该检查证明正在提供新代码，不代替真实页面视觉验收。

四菜单均待人工在 1920×1080、100% 缩放下核对修改后截图。

## 其余六菜单的检查结果

2026-09-14：七个页面和共享批量导入组件完成显式密度接入。列表操作使用白底描边纯文字，最多三项全部直显；抽屉根同时接入页面密度和抽屉密度，弹框根显式接入对话框密度。公共 FormSection 样式覆盖独立浮层，修正只依赖父页面造成的样式遗漏。仓库新增菜单的浮层间距限定在自身，不再覆盖其他菜单。

- 维持前表逐操作承载与尺寸。往来单位详情和下载详情采用两组连续键值网格，长地址、备注与文件跨列；船期价格详情使用同行返回、版本号、状态及主要操作，摘要保留报价范围和上传时间，正文为连续白底。渠道页签使用公共彩色图标，预览表保留在页签正文外，价格行继续只读。
- 七页脚本语法树比对（排除样式导入、已移除装饰图标与确认框外观参数）及所有表单绑定比对均一致，原业务处理、权限、版本、仓库映射、导入预检与下载重试逻辑保留。
- 定向检查 94 项通过，包含排车六组权限下的操作数量、往来单位详情浮层、下载详情 11 个字段、批量导入普通/密度模式及成功提交；类型检查通过。
- 全量测试 251 个文件、1957 项通过；构建（含类型检查）和差异空白检查通过。
- 本地 5173 返回这七页及排车列表的新密度代码，HTTP 均为 200。排车列表已是纯省略号入口；代码与开发服务验证不能代替页面截图。

通用 10 菜单代码检查完成，全部待人工在 1920×1080、100% 缩放下核对修改后截图。首页、系统管理另行继续。