docs/Admin海外业务样式核对记录.md

# Admin 海外业务样式核对记录

## 范围与修改前逐操作核对

当前三菜单映射到 `apps/admin-web/src/modules/overseas-business/routes.ts` 的 9 个路由、5 个页面文件。原型入口为 `悦/货代SAAS平台后台/prototype-src/modules/07-overseas-business.html`。通用样式按本轮国内订单样板，字段/权限/业务承载以已实现契约和当前用户要求为准。

| 页面/操作 | 原型证据 | 当前实现 | 本轮修正 |
|---|---|---|---|
| 采购列表查询、详情、编辑 | `page-overseas-purchase` 第 2 行 | `PurchaseOrdersView`，详情/编辑两个操作 | 公共密度、纯文字描边按钮、左侧操作列，保留查询和分页 |
| 采购新增 | 第 14 行明确历史新增模板不可达 | 后台无新增路由/API | 不补建新增能力 |
| 采购详情 | `page-overseas-purchase-detail` 第 204 行，商品/库存/订单/快递/操作记录 | `PurchaseOrderDetailView` 独立页面，四组信息与四组业务表 | 返回、编号和状态合并；实际事实摘要；按原顺序连续键值表；取消独立字段卡片式排版 |
| 采购审核通过/拒绝 | 原型详情为动态内容；当前已接入服务端审核 | 520px 居中 `reviewDialogOpen`，备注、版本和幂等键 | 保留承载与请求，显式接入弹框密度并展示审核业务对象 |
| 签收文件、凭证上传、登记费用 | 当前详情实际上传入口，原型未完整定义 | 系统文件选择、560px 费用弹框 | 保留现有文件生命周期与冻结说明，统一弹框和表单；无预览/删除入口不虚构操作 |
| 采购编辑、出库明细添加/删除、保存/取消 | `page-overseas-purchase-edit` 第 143 行，独立页面 | `PurchaseOrderEditView` 三列表单、出库明细行、未保存保护 | 同行返回、业务编号；紧凑分组及表单；保留入库资格、全部字段、三态 PATCH 与未保存保护 |
| 本土卡车列表、新增、编辑 | 第 58/83/332 行 | `TransportOrdersView domain=truck`、`TransportOrderFormView` 独立页面；原型 760px，现实现 900px 表单 | 保留新增/编辑承载；同一白底表单区域、统一控件和行内编辑按钮，按字段组保留两/四/五列布局 |
| 本土散板列表、新增、编辑 | 第 222/247/390 行 | 上述共享页的 `domain=looseboard` 模式 | 同上，同时保留散板方式、是否打盘与权限状态差异 |
| 卡车/散板详情、资料、删除 | 卡车原型第 313 行存在详情，当前正式路由与列表只开放新增/编辑 | 无对应只读详情/资料上传/删除入口 | 记录当前可达范围，不恢复历史功能，不将其标记为已验收 |

共同问题：5 页均未显式接入公共密度样式；详情/表单头部返回靠右、重复标题/编号标签，编号缺失时回退路由参数；旧局部字号/大间距与公共规则冲突。本轮按实际字段重排，业务请求与权限不改。

## 验证

代码修正已完成；所有页面及弹框的修正后视觉效果待人工截图确认。

## 本轮检查结果

- 全量 251 个测试文件、1,942 项通过；类型检查、生产构建及差异空白检查通过。
- 密度合同已纳入本组全部页面和真实 Teleport 弹框，覆盖公共样式独立导入、实际祖先、行内按钮、标签与字号规则。
- 本组视觉仍待人工截图确认；代码和组件测试不代表页面视觉验收。

- 采购/卡车/散板编辑区域均限制在 1120px 连续白底区域，标题和表单同宽；采购出库明细保留独立行、完整输入和删除操作。该宽度属于本组业务布局，不改变全局页面宽度。
- 组件回归覆盖采购 23 个信息字段/4 个业务分组/4 个长字段跨列，以及凭证选择、上传、登记费用、审核后按钮隐藏；原有分页、409 输入保留、幂等重试和卡车/散板状态限制全部通过。