docs/订单与客户/客户端简化与易用性优化建议.md

# 企业客户端简化与易用性优化建议

日期：2026-09-18  
适用范围：企业客户工作台 `apps/client-web/`  
文档状态：方案 A 第一版已实现并通过本地检查；菜单最终位置及 `1920×1080`、浏览器缩放 `100%` 的视觉效果待人工截图评审确认。

## 0. 2026-09-18 最新原型评估结论

本轮核对的最新文件来自微信缓存目录，修改时间为 `2026-09-18 11:37:20`，SHA-256 为 `9FA64EB74381DFB11506799E1EF33593EE11C0300F362AF875902984CE5D2E20`。仓库中的 `docs/悦/官网头程下单/workbench.html` 仍是 2026-09-08 的另一版本，二者不能混用为同一份验收依据；若后续确认最新版为正式原型，应先将正式副本归档到仓库再进入逐页还原。

最新原型的首页方向可以采用，但应采用其**信息架构与视觉减负原则**，不应原样复制技术实现或直接按原型侧栏删除菜单：

- 首页收敛为业务入口、订单筛选、待办分类和订单列表，符合当前“登录后直接办事”的方向。
- 原型仍保留彩色业务图标、渐变、阴影和悬浮效果，不是完全无色的极简风；正式实现宜进一步减轻阴影和装饰，同时保留业务辨识色、状态色和待办红点。
- 原型使用 Tailwind CDN 和 Font Awesome，正式项目继续使用 Vue、Element Plus 与 Lucide，只迁移视觉规则，不新增第二套组件和图标体系。
- 原型在 `1200px` 以下把 6 张业务卡片切成 `3 × 2`，会重新占满首屏；正式项目继续按内容区宽度响应，桌面窄屏保持单行横向浏览。订单区始终使用高密度表格，不再按内容宽度切换为订单卡片；列宽不足时由表格内部横向滚动承载。
- 原型侧栏只有 6 个业务叶子，而当前代码在拥有全部相关权限时有 22 个正式菜单叶子。直接照抄会让 16 个已实现入口失去稳定主入口，因此首页视觉改造与菜单信息架构必须分开评审。
- 本轮只形成产品与信息架构文档，不修改共享导航、路由、权限资源或页面实现。

## 1. 建议先做什么

建议围绕客户的四个问题重新组织体验：**我要发货、我的货到哪了、有什么需要我处理、我要付多少钱。**

第一轮以“首页 → 头程订单 → 下单 → 计费与费用确认”为样板，同时修正充值、退货等容易误解的文案。先减少找入口、找字段和判断下一步的成本，再推广到海外仓、财务和企业设置。

本方案的重点是：

| 方向 | 具体变化 | 客户获得的帮助 |
| --- | --- | --- |
| 入口更集中 | 主导航收敛为首页、我的订单、海外仓、费用与账单、企业设置；个人和消息放入固定工具区 | 知道一件事应该去哪里做 |
| 首页能办事 | 首屏突出待处理事项、常用操作和最近订单 | 登录后知道先做什么 |
| 列表更好读 | 默认只显示关键列，筛选分常用与展开项 | 快速找到订单、状态和下一步 |
| 表单分层 | 按场景显示必填项，系统已有信息自动带入，补充字段分组 | 少填重复内容，少在长表格里找错误 |
| 操作结果更明确 | 区分草稿与已提交、费用确认与付款、充值申请与到账、签收与换标完成 | 不因名称简短而误判业务结果 |
| 失败可以继续 | 保留输入、定位错误、恢复查询条件，重要操作仍明确确认 | 出错后能继续，不必重新开始 |

**证据范围：**本文基于当前源码、路由清单、应用指引及指定原型的静态审查。没有用户行为统计、访谈或真实页面操作记录，因此下文“现状”指代码事实，“问题”是待验证的体验判断，“建议”是拟议目标。视觉与实际操作效果均为**待人工截图确认**，不以本文件宣布页面改造完成。

## 2. 当前主要负担在哪里

| 已核实的实现现状 | 对客户可能造成的负担 | 优化判断 |
| --- | --- | --- |
| 在拥有全部相关权限时，导航定义包含 9 个顶层节点、22 个正式菜单叶子；实际显示受成员权限过滤 | 业务创建、履约查询、企业设置分散，需要记住系统分类 | 调整信息架构，完整保留已有业务入口与权限 |
| 首页已调整为 6 个权限化业务创建入口，并嵌入头程筛选、待办 Tab 和真实订单列表 | 高频创建与查单已经集中，但历史列表仍分散在多个业务菜单 | 保留当前首页样板，菜单负责稳定的历史查询与业务管理入口 |
| 6 个首页业务入口均跳转独立创建页；首页订单列表不再重复显示“创建订单” | 入口职责已经更清楚，但快速建草稿、批量导入等次级创建方式的位置尚未统一 | 后续在首页卡片次级动作与订单中心页内操作之间二选一 |
| 头程列表默认打开过多可选列，客户侧同时暴露订单号与入仓码 | 找货、看进度时需要理解多套编号，且大量次要信息挤占首屏 | 客户侧统一以入仓码为主业务编号，重做默认列与常用筛选，继续复用已有列设置能力 |
| 创建页货物明细集中展示 30 余个字段；明细区还有创建多张订单草稿的 Excel 导入入口 | 填一张订单和批量建多张订单容易混淆 | 单单货物录入与批量建单明确分开 |
| 快速下单每行生成独立草稿，成功后回普通订单列表 | 容易误以为已提交，还要重新寻找刚生成的草稿 | 成功结果明确草稿状态，并引导继续完善 |
| “确认计费重”实际涉及计费依据、费用金额及确认后锁定 | 按钮没有完整表达操作后果 | 改为“核对计费与费用”，保留正式确认门槛 |
| “退货换标”路由实际承载退货预报、签收；退货库存和箱号管理共用组件但粒度不同 | 退货签收完成可能被理解为换标或出库完成；库存入口难区分 | 用准确阶段名称，统一库存入口并保留不同查看粒度 |
| 充值提交后进入人工审核，按钮叫“确认充值”；账单使用“已收、未收”等平台视角 | 可能把提交申请当作到账，或把确认账单当作付款 | 以客户视角说明动作、结果和剩余步骤 |
| 企业管理分成员、角色、菜单权限；权限配置展示权限码、“全量替换”等技术表达 | 企业管理员需要先理解内部权限结构 | 将配置流程串联，默认展示业务能力与修改影响 |

其中，跨业务“我的订单”页面当前标记为 `prototype`，没有作为正式路由开放。不能把它当成已经可用的订单聚合中心。

## 3. 导航与首页怎么简化

### 3.1 建议的入口归属

建议将顶层导航收敛为以下五项。这里的“我的订单”首先是导航分组，首轮可以直接承接现有分类列表；建设跨业务统一列表另行评估。

| 建议一级入口 | 收纳的当前入口 | 入口内的组织方式 |
| --- | --- | --- |
| 首页 | 业务总览 | 待处理事项、常用操作、最近订单、少量关键指标 |
| 我的订单 | 头程订单列表、快速下单、海外采购、美国本土卡、美本土散板、派送订单列表 | 按业务类型进入现有列表；创建操作集中在清晰的创建入口 |
| 海外仓 | 入库订单列表、贴标申请、仓储转运、货物废弃、退货换标、退货库存、退货箱号管理 | 入库记录、仓内服务、退货管理；退货库存保留按 SKU 和按箱查看 |
| 费用与账单 | 资金账户、客户账单 | 先看可用资金和待处理账单，再看流水、充值申请和记录 |
| 企业设置 | 企业资料、企业成员、角色管理、菜单权限 | 企业资料、成员与权限；角色和权限配置在同一流程内衔接 |

固定工具区提供“消息”和“个人资料与账号安全”；退出登录放在个人菜单中。消息继续复用已存在的顶部入口，无须在两个位置保持同等视觉权重。

导航设计遵循以下约束：

- 一个业务能力保留一个清楚的主归属；首页快捷操作只是通往它的入口。
- 按当前成员的真实权限展示；财务、企业管理和创建操作不能因菜单合并而扩大权限。拥有查询权限不等于拥有创建、提交或确认权限。
- “贴标申请”是否改名为“贴标与换标”，以及“美国本土卡／美本土散板”的完整客户名称，需要业务人员确认含义后统一菜单、页面标题与帮助文案。
- “退货换标”当前入口建议改为“退货预报与签收”；退货签收、换标、出库分别呈现各自状态。
- 合并退货库存入口时保留 SKU 明细、箱内明细和箱级汇总的差异，不把不同粒度的数据直接合计。
- 同一批调整同步修改面包屑、页签、快捷入口和相关测试；新原型确认后收敛为一套导航，不并行保留两套新旧模式。

### 3.2 当前菜单盘点：为什么看起来少了很多

当前正式导航由模块路由自动汇总，并按当前成员权限过滤。拥有全部相关权限时，共有 **9 个顶层节点、22 个正式菜单叶子**：

| 当前顶层节点 | 正式菜单叶子 | 数量 | 最新极简原型是否保留 |
| --- | --- | ---: | --- |
| 业务总览 | 业务总览 | 1 | 保留 |
| 头程物流 | 订单列表、快速下单 | 2 | 未放入侧栏，仅首页保留头程快捷入口 |
| 出海下单 | 海外采购、美国本土卡、美本土散板 | 3 | 未放入侧栏，仅首页保留快捷入口 |
| 海外仓 | 贴标申请、仓储转运、货物废弃、退货换标、退货库存、退货箱号管理 | 6 | 全部未放入侧栏，只有首页两个快捷入口覆盖部分能力 |
| 订单管理 | 入库订单列表、派送订单列表 | 2 | 保留 |
| 财务结算 | 资金账户、客户账单 | 2 | 只保留账单类入口，资金账户改由顶部充值和个人区域间接进入 |
| 企业管理 | 企业资料、企业成员、角色管理、菜单权限 | 4 | 只保留公司信息，成员和权限管理未体现 |
| 我的信息 | 我的信息 | 1 | 保留 |
| 消息中心 | 我的消息 | 1 | 未放入侧栏，适合移到顶部固定工具区 |

最新版极简原型侧栏实际只有：业务总览、入库订单列表、派送订单列表、应付账单、公司信息、我的信息，共 **6 个业务叶子**，另有退出登录。它适合作为“极简壳层”的视觉参考，但不能作为当前完整菜单清单。

菜单“缺失”需要分为四种情况，不能用一次补菜单操作混在一起处理：

1. **权限过滤。**当前成员没有叶子权限时，该菜单及空父分组会隐藏。这是预期行为，应先核对账号权限，不应通过前端强制显示。
2. **已有正式页面但原型未画。**头程、出海下单、海外仓服务、资金账户、企业成员与权限、消息都属于此类，必须在新信息架构中找到稳定归属。
3. **隐藏流程页。**新增、编辑、详情页面有正式路由，但不应独立占用侧栏；从首页快捷入口、列表操作或详情下钻进入。
4. **尚未正式开放。**跨业务“我的订单”仍标记为 `prototype`，不能因为菜单需要聚合入口就提前开放；统一订单查询需要单独确认数据与接口契约。

此外，现有“快速下单”实际生成订单草稿，“批量导入订单”位于头程订单列表工具栏。它们是创建方式，不宜为了补齐数量继续平铺为多个同级业务栏目。

### 3.3 菜单是否随极简风优化

建议同步优化，但不和首页视觉改造一次性强绑定。原因如下：

- 只改首页、不改菜单，页面会更轻，但侧栏仍按系统模块分类，客户仍需记住“头程物流、出海下单、订单管理”的内部边界。
- 直接照极简原型删侧栏，已实现业务会失去可发现性；只有创建权限、没有部分列表权限的成员还可能无法从首页之外找到入口。
- 导航叶子同时参与权限过滤、首个可访问页面、面包屑、父分组展开和工作区页签。菜单调整不是单纯 CSS 工作，必须联查路由与权限测试。
- 首页快捷卡片是高频创建入口，不应成为某项业务唯一入口；用户仍需要稳定的列表入口查看历史订单、错误状态和后续进度。

因此建议把首页和菜单拆成两个决策：

1. **首页视觉可以先确认。**采用轻量极简、真实筛选、待办 Tab、订单列表和 6 个权限化创建入口。
2. **菜单先完成归属表，再决定放置形态。**在最终位置确认前保留现有正式入口，不删除、不复制第二套导航。

### 3.4 后续评审的两套菜单放置方案

#### 方案 A：五个主入口的任务型侧栏（推荐）

**2026-09-18 实现记录：**客户端已按本方案形成第一版。侧栏使用“首页、订单中心、海外仓、费用与账单、企业设置”五个任务入口；“快速下单”在菜单中按真实结果显示为“快速建草稿”；消息和个人信息移动到顶部固定工具区。现有路由和权限编码未删除或合并，侧栏按当前成员权限继续过滤。根据 2026-09-18 人工截图反馈，壳层进一步向当前原型收敛：侧栏使用浅蓝底、深蓝品牌区和蓝色渐变激活态，顶栏取消重复的页面标题和说明并改为简洁问候。首页不生成或显示工作页签，正文直接从紧凑顶栏下方开始；其他页面继续保留多任务工作页签。新建、编辑和详情类页签支持独立的短标题，例如“退货换标 · 新建”，避免与正文大标题完全重复；海外仓服务页删除页面内部第二套面包屑，只保留应用壳层路径。桌面侧栏保持 `224px`，为首页订单区释放宽度。订单区保留“全部、确认计费重、上传资料”筛选，取消双列卡片模式，统一恢复为带分页和列设置的表格列表；默认仅显示入仓码、状态、渠道、运输方式、交货方式、收货仓和创建时间等核心列，其余字段由“显示字段筛选”打开。头程详情已从大弹框改为受权限保护的独立工作页签，点击列表详情或入仓码直接进入；详情内容改用紧凑的分区标题、字段表格和明细表格，取消收发货方、柜次和货物摘要的卡片式堆叠。订单主进度与柜次进度合并为客户唯一的“履约进度”，柜次仅作为该进度下的明细；柜次、快递和入库费用尚无数据时使用紧凑提示行，不再展示占据大面积首屏的空态。海外采购、美国本土卡和美本土散板的共用订单页也已改为共享查询栏、数据表和四列紧凑详情网格，统一操作列、状态标签、分页、容器边距和业务编号入口。该记录表示实现状态，不替代最终人工视觉验收。

| 建议位置 | 收纳入口 | 说明 |
| --- | --- | --- |
| 首页 | 业务总览 | 6 个创建入口、待处理筛选、最近订单；不重复承载所有历史列表 |
| 订单中心 | 头程订单、海外采购、美国本土卡、美本土散板、入库订单、派送订单 | 按订单类型进入现有正式列表；跨业务统一列表在接口契约确认前不开放 |
| 海外仓 | 贴标申请、仓储转运、货物废弃、退货预报与签收、退货库存 | 按“服务申请、退货、库存”二级分组；退货箱号作为库存页内查看方式或保留子入口，不能直接删除 |
| 费用与账单 | 资金账户、客户账单 | 充值作为资金账户内操作；顶部可保留余额或充值快捷入口 |
| 企业设置 | 企业资料、企业成员、角色管理、菜单权限 | 普通成员只显示有权限的页面；企业管理员保留完整管理入口 |

顶部或侧栏底部固定工具区放置：我的消息、个人资料与账号安全、退出登录。这样既保持极简主导航，又不牺牲已实现能力。

“快速下单／快速建草稿”和“Excel 批量建草稿”有两个候选位置，需后续确认：

- 作为首页“头程下单”卡片的次级创建方式；优点是创建入口集中。
- 作为订单中心中“头程订单”的页内操作；优点是避免首页卡片出现多个按钮。

#### 方案 B：保留当前业务域侧栏，仅做视觉减负

保持头程物流、出海下单、海外仓、订单管理、财务结算、企业管理等现有分组，只统一图标、行高、展开方式和工具区。该方案改动风险较低、权限映射最直接，但顶层入口仍多，不能完全解决客户需要记忆系统分类的问题。

不建议当前直接采用“无侧栏、全部放顶部菜单或九宫格”的方案。22 个权限化入口在顶部会形成拥挤的多级菜单，在窄屏上也更难访问；如果未来采用应用启动器，仍需保留订单和设置的稳定导航路径。

### 3.5 菜单位置确认前的临时原则

- 保留当前正式导航，不按最新版原型删减 16 个已实现入口。
- 首页 6 个卡片只负责创建；订单历史和业务进度仍从对应列表进入。
- 创建、编辑、详情继续作为隐藏流程页，不新增侧栏叶子。
- 消息和个人资料可以先作为顶部固定工具候选，但在位置确认前不删除现有入口。
- 所有菜单继续按真实权限过滤；菜单合并只改变归属和展示，不合并权限编码、不扩大访问范围。
- 最终选定方案后，一次性同步路由导航、面包屑、父分组展开、工作区页签、权限配置文案和自动化测试。

### 3.6 首页优先展示“现在要处理什么”

首页建议按以下顺序安排内容：

1. **阻断事项。**企业资料待完善或被驳回、资金限制等，显示原因和下一步。待审核与审核驳回分别说明，不把所有情况统一写成“请完善资料”。
2. **待我处理。**候选事项包括待完善草稿、待确认计费与费用、待提交报关资料、待确认账单、待确认换标结果。每条包含业务编号、待办原因、更新时间和明确动作。
3. **常用操作。**头程发货、批量建草稿、海外仓服务、查看账单等，按权限显示。首轮使用固定、经确认的排序，不增加个性化推荐系统。
4. **最近业务。**显示少量最近订单及进度，帮助客户接着上次操作；可进入对应分类列表。
5. **帮助与概览。**提供真实可用的操作说明及联系方式，统计明确业务和时间范围。

首页待办属于需要核对数据契约的能力，不能直接把“未读消息数”当成待办数。已读消息不等于业务已处理，旧通知也不能覆盖最新业务状态。

实施前逐项核对是否已有客户范围内的查询和状态字段。缺少聚合能力时，首轮只提供有依据的快捷入口，不伪造数字；不得遍历全部订单后拼凑跨业务总数。每个数据区独立表达加载、无数据、失败和无权限，失败显示“暂无法获取”而非零。

## 4. 高频流程怎么改

### 4.1 头程下单：先选创建方式，再完成当前任务

统一入口中清楚区分三种方式：

| 方式 | 适用场景 | 操作结果必须写清楚 |
| --- | --- | --- |
| 填写订单 | 本次准备好一票货物资料 | 可保存草稿；满足审核、权限和字段要求后另行提交 |
| 快速建草稿 | 先按渠道、目的仓和 SKU 建立多张草稿 | 每行形成一张草稿，尚未提交 |
| Excel 批量建草稿 | 已在表格中整理多票资料 | 最多按现有 50 行上限导入，结果为草稿，尚未提交 |

单张订单建议重新设计为三个信息阶段：**运输与目的地 → 货物信息 → 核对并提交**。这是新交互建议，先用原型验证是否减少填写负担；不强制将所有简单业务表单改成多步流程。

字段按用途分层：

| 字段类型 | 展示原则 | 示例与边界 |
| --- | --- | --- |
| 当前任务必填 | 默认展开，标明单位与填写示例 | 运输渠道、目的地、当前场景所需货物信息 |
| 场景触发必填 | 选定场景后出现；提交前完整校验 | FBA 相关标识、木制品关联资料、报关资料；不能隐藏后跳过校验 |
| 已有可信信息 | 从当前企业或选定业务带入并允许核对 | 企业名称、已保存联系信息、仓库选项；前端不能自行决定企业归属 |
| 可计算信息 | 按已确认公式展示结果和单位 | 箱数与件数的合计；费用仍以服务端正式结果为准 |
| 补充信息 | 按业务分组展开，提示尚缺项 | 备注、产品补充信息；是否选填以真实契约为准 |

长货物表格默认突出本场景关键字段，详细申报或产品属性按组编辑；若使用弹框、展开行等承载方式，必须逐项纳入新原型确认。错误同时出现在字段附近和顶部摘要，点击摘要能定位字段及货物行，保留已填写内容。

危险品、木制品、报关方式等声明必须由客户明确选择，不能为减少点击替客户作出业务承诺。运费含税方式与报关方式分别解释，不合并成一个模糊开关。

快速建草稿或批量导入后，结果页显示本次成功记录、失败行、待完善内容和“继续完善”；不要只弹成功提示后丢回无筛选的全部订单。

批量导入采用“下载模板 → 上传并校验 → 查看结果”的说明结构。“部分成功／原子导入”改为“只导入正确的行／全部正确后再导入”。结果明确 Excel 行号、失败原因和修正方法；仅重试失败行的具体方式需核对幂等契约，避免再次导入已成功行。

### 4.2 查订单：默认看得懂，需要时查得全

建议头程列表默认展示约 8–10 个关键业务列，最终由真实长编号和人工截图确定宽度。可优先考虑：**操作、入仓码、状态、目的地、货物摘要、创建或更新时间**。客户从提交后开始统一使用入仓码查询、查看详情和导出；草稿尚未生成入仓码时明确显示“提交后生成”，不向客户暴露平台订单号或内部 ID。只有确有数据来源时才增加“待处理事项”，不由前端猜测。

- 操作列放在第一列，需要固定时固定左侧；勾选控件放在其后，不照搬当前选择列在前的顺序。
- 常用筛选保留业务编号、状态、时间；目的仓、渠道等进入展开筛选，并提示已启用的筛选条件。
- 继续复用现有列显隐和排序能力，提供“恢复默认列”；完整业务信息在详情和可选列中保留。
- 查看详情返回后保留筛选、页码和滚动位置。现有页签与缓存能力应先复用，不能为了简洁丢失编辑内容。
- 列表只突出当前可执行的关键操作，其他动作是否折叠由新原型逐页确认；批量操作仅保留已有契约支持的能力。
- 状态展示同时回答“当前到哪一步、下一步由谁处理”。客户主状态用于概览，测量、报关、运输等子流程在详情中单独解释。

不将所有业务强行映射成一套扁平状态；派送完成、退货签收完成和换标完成不是同一事实。订单详情建议采用“业务编号与当前状态 → 待处理事项 → 履约进度 → 货物/费用/资料”的信息顺序，具体独立页或弹框沿逐操作原型确定。

### 4.3 费用、账单和充值：客户知道自己确认了什么

| 场景 | 建议文案和展示 | 必须保留的业务边界 |
| --- | --- | --- |
| 入库计费 | 列表“核对计费与费用”；首屏展示业务编号、计费依据、单价、附加费、合计；正式按钮“确认计费与费用” | 只确认服务端当前已推送版本；保留二次确认、版本与幂等校验、确认后锁定 |
| 客户账单 | 提供“待我确认”等入口；经财务核对后用“已入账付款／待支付”等客户视角词语 | 账单确认与付款分开；付款认定以平台核实入账结果为准，不能把客户上传凭证等同到账 |
| 资金账户 | 主区突出可用资金和限制下单的原因；授信、冻结及流水保留清晰展开入口 | 总可用金额不能遮蔽实际余额为负、授信有效期等限制；以服务端判断为准 |
| 充值申请 | “填写金额 → 使用已启用渠道付款 → 上传凭证 → 提交充值申请”；结果“已提交，待审核，尚未到账” | 无有效收款码不能提交；不模拟支付成功，不把申请金额计入实际余额 |

账单快捷分类及精确数量需核对接口查询能力，不能只筛当前分页数据却称为“全部待确认”。资金账户初始加载、真实零余额和加载失败保持区分。

### 4.4 海外仓与退货：按客户目的组织，保留阶段差异

海外仓入口先让客户区分“查看入库记录、申请仓内服务、处理退货”。进入具体服务后再选择仓库、业务来源和货物；不把仓库内部托盘、库位或内部库存 ID 暴露成客户必须理解的概念。

贴标与换标申请建议按“选择仓库和库存 → 选择服务内容 → 整理本次明细 → 核对费用与提交”分区：

- 三套现有模板“SKU 关联、箱号关联、SKU 混箱换标”始终可用，增加适用说明和推荐提示，不随换标类型隐藏。
- 区分“上传待导入关系”和“加入本次申请明细”，分别显示数量；只有加入本次明细的库存才随申请提交和冻结。
- 涉及箱唛换标时，整单一个 FBA 目的仓；一行代表一箱，箱数固定为 1；不得为了压缩表格合并箱级关系。
- 费用按已确认契约校验并明确币种；应用指引要求换标申请提交正数 CNY 费用，但本次页面审查尚未证实这一点已完整实现，实施前须联查页面与实际接口。不得自行填充金额或模拟冻结；配送方式及相应附件要求也需保留。
- “确认测量数据”“确认换标完成”前先展示相关实测数据、差异或完工照片，再进行明确确认；不能用一个通用“确定”按钮代替对结果的核对。

退货链路分别呈现“退货预报、仓库签收、库存、后续换标/出库”，只有已有正式业务关联时才提供继续办理入口。签收结果使用“签收完成”等限定文案；换标确认前不得继续出库。货物废弃申请保留业务编号、货物与数量核对，说明实际执行废弃后的不可逆后果；申请能否取消按服务端当前状态判断，不将“提交申请”描述为立即废弃或一律不可取消。

### 4.5 海外采购与美国运输：减少猜选项和填重复信息

当前海外采购、本土卡车和散板列表的状态筛选是自由输入框。建议按各业务的服务端有效枚举提供中文选项，避免客户猜测应输入中文还是状态码。

卡车和散板表单先明确运输场景，再按“路线与地址、货物、联系人”分组。柜型等字段是否按场景出现需核对接口要求，不能直接删去；预算单价、预算总价和币种保持区分。带入已有联系人或地址时让客户核对，避免默认提交过期信息。

海外入库查询可先精简常用筛选，将预约、排车等细分状态放到展开筛选及详情。如果改成一个“业务编号”搜索框，需要接口支持，或明确让客户选择编号类型；不能在前端猜测编号后同时拼接多个精确查询条件。入库页面保持现有只读边界。

### 4.6 企业资料、成员与消息：降低日常管理成本

新客户登录后，用一个明确的状态区连接“完善资质 → 提交审核 → 审核结果 → 可以提交订单”。营业执照和统一社会信用代码突出显示，法人身份证等选填资料收进补充区域；审核驳回直接显示原因及修改入口。

当前资质上传弹框已经支持一键保存并提交审核，应复用这一能力；本轮重点改善入口和引导，不重复开发同一流程。待审核期间是否能保存某类草稿，按对应业务已有规则说明。

成员与权限建议采用“选择成员 → 选择职责角色 → 核对可以做的事”的表达。新增角色后直接衔接权限配置，隐藏普通用户无需理解的权限码，保存前提示新增与移除的能力。切换角色或离开配置页时，保护尚未保存的修改。职责模板属于后续建议，不假设现有系统已经支持。

个人信息与企业资料保持分开：“登录标识”可改为“登录账号与手机号”，公司联系电话仍由企业资料维护；修改登录信息会使现有会话失效时，提前用结果语言说明。

消息分类由自由输入改为与服务端正式类型对应的可选项。未来增加“去处理”入口时，先补齐受控的业务类型和关联信息，校验当前企业、权限与最新状态，再跳转现有正式页面。当前消息契约只有正文等信息，不能从消息文字猜测业务链接或执行动作。

## 5. 统一交互与文案规则

| 项目 | 建议规则 |
| --- | --- |
| 页面重点 | 每个当前任务有一个清楚的主动作；标题、描述、页签与面包屑避免重复占据首屏 |
| 表单 | 字段有标签、单位、示例；必填随场景解释；高级信息可以分组但不遗漏校验 |
| 保存与提交 | “保存草稿”“提交订单”“提交申请”“确认费用”分别命名，成功提示写明真实结果 |
| 二次确认 | 费用锁定、账单确认、换标确认、废弃等保留；不在普通查阅和无副作用跳转上增加确认 |
| 空态 | 说明没有记录还是没有符合筛选的记录，并给出创建或清除筛选入口；受权限约束 |
| 错误态 | 说明哪里失败、输入是否保留、如何继续；诊断编号放在可复制的故障详情内 |
| 权限态 | 不可访问的业务不展示可点击假入口；有查看权限但不能办理时说明原因及联系对象 |
| 文件 | 显示用途、格式、大小限制、上传结果、预览/下载入口；失败可以重试，替换影响明确 |
| 时间与金额 | 标明币种、单位和必要时区；预计与实际、参考报价与正式费用明确区分 |
| 业务标识 | 客户侧头程全流程以入仓码为主编号，后续履约展示计划号、箱号等必要业务编号；草稿显示“提交后生成”，其他缺失显示“—”或未关联，不展示平台订单号，不回退内部 ID |
| 可访问性 | 保留键盘操作、可见焦点和完整标签；状态不只靠颜色，精简不依靠缩小字号和点击区域 |

可优先统一的文案示例：

| 当前表达 | 建议表达 | 使用条件 |
| --- | --- | --- |
| 快速下单 | 快速建草稿 | 当前动作仅生成草稿时 |
| 原子导入 | 全部正确后再导入 | 保持原有整批成功/失败语义 |
| 确认计费重 | 核对计费与费用 | 入口文案；正式确认仍提示锁定后果 |
| 确认充值 | 提交充值申请 | 客户提交付款截图等待审核时 |
| 退货换标 | 退货预报与签收 | 当前独立退货入口的职责范围 |
| 改关联／覆盖 | 修改适用入仓码／替换文件 | 报关开始前允许修改时 |
| 服务端版本、不可变历史 | 上传记录、历史版本 | 保留版本记录及审计事实 |

## 6. 建议实施顺序与依赖

P0 表示容易误解业务后果或与当前明确契约冲突，应最先核对；P1 表示首轮主要体验收益；P2 表示在样板验证后继续改善。这里不承诺人天或上线日期，需在原型和接口差距明确后估算。

| 优先级 | 工作包 | 实施范围与依赖 | 完成判断 |
| --- | --- | --- | --- |
| P0 | 修正操作结果文案 | 费用确认、充值申请、退货阶段、快速草稿；核对相关弹框与成功态 | 客户能准确说出结果及下一步，没有付款/到账/完成状态误解 |
| P0 | 清理既有旧模式分支 | 头程源码仍有 `LEGACY_MANUAL`、旧系统入仓码条件分支；需沿真实 API 核对生产者、消费者、测试后按最新契约收敛 | 不保留新旧并跑；当前环境是否命中尚未验证，不宣称已经出现于页面 |
| P1 | 列表减负 | 头程默认列、筛选、上下文恢复；海外采购与运输状态改中文选项 | 首屏可读核心信息，完整字段可查，返回不丢条件，筛选无需输入状态码 |
| P1 | 首页和导航样板 | 路由导航、首页、权限过滤、新原型；真实待办数字另核对查询能力 | 每项现有业务有归属，主页可找到头程入口，不开放 prototype 占位页 |
| P1 | 单单及批量创建优化 | 创建页、快速草稿、导入结果；核对必填规则、错误定位和幂等 | 区分建单方式，生成后能继续完善，失败重试不重复建单 |
| P1 | 费用与海外确认优化 | 费用依据、完工证据、确认后果；保留独立写权限与版本控制 | 确认前看到相关证据，过期状态不能继续提交 |
| P2 | 海外仓与退货入口收敛 | 库存不同粒度、服务申请与阶段命名、新原型 | SKU/箱关系不丢失，签收与后续处理明确 |
| P2 | 财务、企业设置与消息 | 任务筛选、成员角色衔接、未保存保护；消息关联可能需要后端契约 | 不依赖技术术语完成常见任务，权限边界保持正确 |

建议先交付一套可评审样板：**首页、头程列表、创建订单、计费与费用确认**。对四页逐项明确详情、新增、编辑、确认和文件预览的承载方式、字段顺序、按钮位置与状态，再进入实现。

需要后端配合的能力单独列清：跨业务待办统计、跨业务统一订单查询、账单任务筛选、消息到业务的受控关联，以及已有接口尚不支持的结果集定位。它们都不能仅靠换菜单名称完成；新增接口须同步正确区域 Gateway、Controller、OpenAPI、权限和调用端。

不在首轮新增多语言、移动端适配、在线报价引擎、即时聊天、复杂推荐或新的统计平台。暂不建设“简易版/专业版”两套业务协议；通过一套页面的默认展示与按需展开降低复杂度。

## 7. 怎样验证确实更好用

### 7.1 先测基线，再对照样板

邀请 5–8 名具有代表性的客户使用者，覆盖新客户、日常下单人员、财务人员和企业管理员；人数是首轮建议，不能据此推断所有客户偏好。用同样的业务场景和数据分别操作当前页面与新原型，记录任务完成率、耗时、走错入口、字段报错和求助次数。

| 测试任务 | 建议验收目标 |
| --- | --- |
| 新客户找到企业审核入口 | 无口头指引，在 30 秒内找到，知道当前缺什么与下一步是谁处理 |
| 从首页找到头程发货或指定业务 | 30 秒内定位；常用任务目标入口建议不超过 2 次点击，不含表单填写和必要业务确认 |
| 填写一张准备好资料的订单 | 必填项可定位；保存、提交结果不混淆；无协助完成率建议达到 90% |
| 批量导入含错误行的资料 | 能区分成功与失败行，找到修正位置，明确成功记录仍是草稿 |
| 查询指定订单并返回列表 | 找到进度与下一步；返回后保留筛选和页码 |
| 核对费用、确认账单、提交充值申请 | 所有参与者都能区分费用确认、付款及到账；误判实际后果视为未通过 |
| 查看退货签收及换标结果 | 所有参与者都能区分签收完成、换标完成和出库完成 |
| 修改角色后切换对象 | 未保存内容不会无提示丢失；权限变化可被核对 |

上述数值是建议目标，当前没有实测基线，不写成已取得的改善比例。若样板增加步骤却没有降低错误或完成时间，应调整流程，不能只以按钮数更少判定成功。

### 7.2 实现验收

- 使用 `1920×1080`、浏览器缩放 `100%`，由人工完成操作并提供截图，核对默认态、长编号、多行数据、加载、空态、错误态、无权限与过期状态。
- 涉及页面改造时，先形成逐页逐操作的原型核对矩阵；本文不是已批准的视觉替代规范，不能据此直接批量换成抽屉、弹框或“更多”菜单。
- 前端实现后运行客户端声明的直接受影响测试、`pnpm typecheck` 和 `pnpm build`；共享导航、组件及状态修改需覆盖消费者。纯文档交付不代表这些实现检查已经执行。
- 新增、改名或删除对外 API 时，完成调用端到 Gateway、服务、OpenAPI 与权限的联查，并运行仓库要求的网关合同检查。
- 部署、真实 HTTP 与环境数据变更按仓库授权规则另行执行；本次文档编写没有开展这些操作。

## 8. 评审时建议确认的四项决定

1. **首轮主场景：**建议先做头程客户“发货—查询—费用确认”闭环；如实际客户以海外仓为主，应调整样板顺序。
2. **导航结构与位置：**在“方案 A：五个任务型主入口”和“方案 B：保留业务域侧栏”之间确认；同时决定个人信息、消息放顶部还是侧栏底部，以及快速建草稿放首页卡片还是订单中心页内。确认前不删除任何正式菜单。
3. **创建流程：**是否接受“填写订单、快速建草稿、Excel 批量建草稿”的命名，以及分阶段填写的原型方向。
4. **首页待办范围：**优先哪些真实待办、由哪些接口提供；没有数据支持的项先只提供入口。

以上为进入页面设计前需要对齐的产品选择，不影响先使用本文讨论方向。

## 附录：主要核对依据

以下行号为本次审查时的位置，后续修改可能变化；定位时以文件及符号共同核对。

| 依据 | 核对位置或内容 |
| --- | --- |
| [客户端应用指引](../../apps/client-web/AGENTS.md) | 模块入口、正式发布边界、头程草稿、财务、海外仓、人工验收要求 |
| [模块注册](../../apps/client-web/src/modules/registry.ts)、[导航组装](../../apps/client-web/src/navigation/clientNavigation.ts) | 正式菜单汇总；`buildModuleNavigation` 与 `filterNavigationByPermissions` |
| [订单模块路由](../../apps/client-web/src/modules/order-management/routes.ts) | 第 9–14 行：统一“我的订单”仍为 prototype；海外入库、派送为 active |
| [首页](../../apps/client-web/src/modules/dashboard/views/DashboardView.vue) | 6 个权限化创建入口、独立新建路由、头程订单列表嵌入与内容区响应式规则 |
| [应用壳层](../../apps/client-web/src/layouts/AppLayout.vue) | 第 206、253、263 行附近：顶部消息、工作页签、面包屑；已有 KeepAlive |
| [头程订单页](../../apps/client-web/src/modules/first-leg/views/FirstLegOrdersView.vue) | 第 83、117、150、1215、2093、2141、2151 行附近：筛选、默认列、费用入口、旧模式分支、导入及货物字段 |
| [快速建单页](../../apps/client-web/src/modules/first-leg/views/QuickOrderView.vue) | 第 398–431 行附近：创建成功跳转、草稿说明及旧模式条件提示 |
| [计费确认组件](../../apps/client-web/src/modules/first-leg/components/InboundBillingPanel.vue) | 第 58、258 行附近：二次确认、费用锁定与面板内容 |
| [报关资料组件](../../apps/client-web/src/modules/first-leg/components/CustomsDocumentsDialog.vue) | 第 240–293 行附近：资料覆盖、版本记录、修改与下载动作 |
| [海外仓路由](../../apps/client-web/src/modules/overseas-warehouse/routes.ts) | 第 27–42 行：退货入口及共用库存组件的两种配置 |
| [海外仓服务页](../../apps/client-web/src/modules/overseas-warehouse/views/WarehouseServiceView.vue) | 第 827、873、1014、1079 行附近：客户确认、模板入口和待导入关系 |
| [海外采购与运输共用页](../../apps/client-web/src/modules/cross-border/components/BusinessOrdersView.vue)、[海外入库页](../../apps/client-web/src/modules/order-management/views/InboundOrdersView.vue) | 共用页第 298、332 行附近的状态筛选与表单；入库页第 91–114 行附近的筛选和多类状态 |
| [资金账户](../../apps/client-web/src/modules/finance/views/FinanceAccountView.vue) | 第 224、252、296 行附近：资金信息、充值流程与提交文案 |
| [客户账单](../../apps/client-web/src/modules/finance/views/FinanceBillsView.vue) | 第 30、178、189、208 行附近：收款视角、筛选、客户确认 |
| [企业资料](../../apps/client-web/src/modules/tenant-management/views/CompanyProfileView.vue) | 第 192、444、544、692 行附近：资质定位、提交审核、默认页签及现有提交能力 |
| [权限配置](../../apps/client-web/src/modules/tenant-management/views/PermissionsView.vue) | 第 30、36、102、114、124 行附近：切换加载、技术表达与权限树 |
| [消息页](../../apps/client-web/src/modules/notifications/views/NotificationsView.vue)、[消息契约](../../apps/client-web/src/modules/notifications/contracts.ts) | 分类为自由输入；详情契约当前无业务动作关联信息 |
| [客户栏目架构原型](../悦/柏悦物流客户端/柏悦物流客户端-栏目架构图.html)、[仓库工作台原型](../悦/官网头程下单/workbench.html) | 现有栏目及流程参考；仓库工作台仍为 2026-09-08 版本，不能将其中业务能力直接视为当前已开放 |
| 2026-09-18 最新工作台原型 | 微信缓存文件修改时间 `2026-09-18 11:37:20`，SHA-256 `9FA64EB74381DFB11506799E1EF33593EE11C0300F362AF875902984CE5D2E20`；正式实施前需归档到仓库并取得稳定路径 |
| [平台客户层级与权限契约](../平台客户层级与权限契约.md)、[前端原型验收规则](../Admin-Client前端原型还原验收规则.md)、[工程执行约束](../AI工程执行与协作约束.md) | 客户可见语义、逐页原型确认、人工验收与实现边界 |