待验证清单

以下内容不能仅凭源码确认，需要在测试环境逐项实测后补充截图和准确描述。

登录与通用操作

三个入口的登录页名称、登录后首页和菜单名称
登录失败、密码修改、退出登录提示
列表页查询、重置、分页、导出按钮
统一的成功、失败和权限不足提示

管理端

账号新增、编辑、禁用和角色分配
角色权限保存和生效方式
客户、仓库、产品各字段必填规则
物流和费用规则的生效范围
财务记录的查询条件和导出方式

服务端

快速收货、无单收货、一码多单（现有文档已按源码与新版手册整理，按钮文字和提示需逐项实测）
散件组托、标记装满、创建上架单（现有文档已整理，实测补充截图）
入库、出库、拣货、复核、发货各状态
扫码枪、打印机和异常提示

售后工作台（P0 首轮）

已核对内容（2026-08-04，服务端测试环境，无头浏览器实测）：

售后上架任务单列表字段与快捷筛选：任务单号、服务类型、维度（散件/SU）、状态（待上架/上架中/已上架）、订单数量、操作人、创建人、创建时间
售后出库列表字段与快捷筛选：产品图片、SKU、产品型号、客户编码、订单号、状态（待发货/待退回/已发货）、入库/出库物流单号、旧 SN、工程师、入库/出库时间；页面操作：批量创建发货标签、导出
上架管理两页签：散件（已收货散件）、托盘（已收货托盘）的查询字段与列表列
组托收货、散件组托、快速收货工作台的主要按钮、提示和拦截文案（对照前端 i18n 与源码）
快速收货：扫描已收货物流单号 314937897324 后仅展示订单与货品明细，不可修改或重复过账（截图 06）
组托收货：初始页面三步进度与工位活动托盘队列（截图 01）
上架管理：散件/托盘两页签真实数据展示（截图 01/02）
售后上架：任务列表（全部/待上架 13/上架中 2/已上架）与任务详情（扫码选择库位 → 确认上架）（截图 01/02）
售后出库：列表与快捷筛选（待发货 8/待退回/已发货）（截图 01）
快速拣货：页面加载、输入框与“开启快速拣货”开关（截图 01）
售后出库 → 快速拣货完整流程（2026-08-05 操作视频）：维修良品自动生成出库订单、待发货订单批量/逐条创建发货标签、快速拣货扫描物流单号回车自动拣货出库；文档已按视频完善并引用视频

仍需在页面逐项实测：

组托收货：托盘推荐规则、自动推荐过账倒计时秒数、首次入库时空闲托盘绑定流程（需要可收货的退件测试数据）
组托收货：一码多单、多客户 SKU 弹窗的实际显示和选择后行为
组托收货：标记装满的尺寸单位切换（公制/英制）与校验提示
上架管理：勾选创建上架单的可选范围、创建后的跳转
售后上架：散件任务的详情操作与校验（当前仅核验了托盘任务）
售后出库：批量创建发货标签（视频已验证，批量提交与逐条提交均可）
快速拣货：扫描物流单号回车自动拣货出库（视频已验证）；“开启快速拣货”关闭时需手动点击“拣货”
组托收货、售后上架、售后出库、快速拣货的完整业务流程截图（需对应业务测试数据）
视频抽帧截图（售后出库 02-05、快速拣货 03-05）为按讲解时间轴抽取，需人工核对画面内容与步骤对应

快速拣货接口异常（已发现）

已修复并验证：扫描 RMA2604260171-01 等原失败关键字接口返回 200；当前测试数据无“待拣货”明细，扫描结果为未找到匹配产品（正常空结果），页面截图已更新（02-扫描订单号.png）。
无单收货“通用包裹条码”（2026-08-05）：UNPLANNED-PKG-{客户编码} 为正常维护在系统产品表中的 SKU，走现有扫码反查客户与数量累加逻辑，无需新增开发；已在快速收货文档补充“基础数据 → 产品列表”搜索打印条码并摆放工作台的提醒

入库/库存/出库（P1）

已核对内容（2026-08-04，服务端测试环境列表配置与样例数据）：

入库管理：列表字段（入库单号、产品数量、客户编码、工厂、参考编号、货柜号/跟踪号、状态、送达方式、入库类型、预计到达时间、收货/上架/创建/取消时间）与状态快捷筛选（草稿/待审核/已预报/运输中/待收货/收货中/已收货/已上架/已取消/已驳回）
入库上架：列表字段（上架单号、入库单号、入库类型、收货方式、客户、工厂、产品数量、SKU×数量、创建/上架时间、状态）与快捷筛选（待上架/上架中/已上架）
产品库存：列字段与库存类型/属性样例（NEW 新品、REFURBISHED 翻新；GOOD 良品、BAD 不良品），快捷筛选（成品/备件/耗材）
库位库存：列字段（含库区、库位）与页面操作（库存调整、移库、导出、刷新）
库存流水：列字段与查询条件（含变化量、关联单据类型/单号、操作人）
领料管理：列字段与快捷筛选（待审核/拣货中/已完成/已取消）
一件代发：列字段与状态快捷筛选（草稿/处理中/待处理/待拣货/待复核/待出库/已出库/异常/已取消），页面操作（新建订单、创建运单标签、提交、生成波次、批量取消、批量出库、出库拦截、导出）
波次管理：列字段（含拣货单/标签打印状态、复核/出库状态）与快捷筛选（待拣货/拣货中/已拣货）
异常订单：列字段与操作（确认异常、解除异常、导出）
拦截订单：列字段与快捷筛选（处理中/已拦截/拦截失败）
批量转运（移除订单）：列字段（含转运类型）与快捷筛选（待审核/待确认/待处理/拣货中/待出库/已出库/已取消）
报废出库：列字段（含计费方式）与快捷筛选（新订单/处理中/已完成/已取消）

仍需在页面逐项实测：

入库管理：新建入库单表单字段与必填校验、按箱收货/组托收货完整流程
入库上架：按产品/按箱两种方式的实际操作差异、批量填充库位
新品维护：页面入口与维护弹窗的实际字段（当前依据收货页代码与接口说明）
库位库存：库存调整、移库弹窗的字段与审批要求
领料管理：新建领料单流程与领料拣货页面
一件代发：新建订单字段、创建运单标签、提交/生成波次/批量操作的实际按钮可见性
波次管理：波次详情拣货操作与打印
复核验货、扫描发货：查询、核对、确认与打印的实际按钮文字
异常订单、拦截订单：确认/解除异常、发起拦截与结果确认的实际交互
批量转运、报废出库：新增单据、拣货、出库的完整流程
上述页面截图（待浏览器控制恢复后逐页补拍）

维修服务/退件服务（P1）

已核对内容（2026-08-04，服务端测试环境列表配置与样例数据）：

检测/DOA/换货订单：相同列表结构（产品图片、SKU、产品型号、客户编码、订单号、状态、物流单号、故障描述、故障附件、审核备注、旧 SN、中断原因、检测结果、工程师、入库/完成时间），状态快捷筛选（已收货/已分配/进行中/暂停中/已完成）
维修订单：额外列（保修类型、入库/出库物流单号、维修结果）与状态快捷筛选（保外待支付/已支付/未支付、等待合单、待发货、待退回、已发货）
翻新任务：列（翻新任务单号、计划翻新 SKU、计划/完成数量、客户、工厂、状态、需要分步骤、需要审核、创建人、备注、创建/完成时间）与操作（创建翻新任务、打印）
翻新数据：列（订单号、客户、工厂、状态、SN、原 SKU、翻新结果 SKU、最终评级、托盘编码、审核人、创建/完成/审核时间）与操作（批量审核、批量确认、导出）
退件服务上架管理：散件页签（实例订单号、状态、SN、原 SKU、翻新结果 SKU、最终评级、审核人）与托盘页签（托盘编码、客户、工厂、库存类型、实例数量、关联单号），操作“创建翻新上架任务”
翻新上架：列（上架单号、状态、移交维度、上架数量、审核人、创建人、操作人）与快捷筛选（待上架/上架中/已上架）
翻新业务流程（对照后端设计文档）：创建任务 → 工程师扫码作业与评级 → 批量审核/确认 → 按评级映射库存入库 → 上架

仍需在页面逐项实测：

检测/DOA/换货订单详情页字段与工程师分配操作
维修订单“添加维修进度”表单（动作类型、部件分类、BOM 选择）与保外支付流转
翻新任务创建表单（分步骤、审核标识、工程师分配）与任务工作台扫码作业
翻新数据批量审核/批量确认的弹窗与评级入库结果
退件服务上架管理创建上架任务的勾选范围
翻新上架详情页扫码选库位与确认上架操作
上述页面截图（待浏览器控制恢复后逐页补拍）

管理端基础配置（P1）

已核对内容（2026-08-04，管理端测试环境列表配置与样例数据）：

角色管理：列（名称、描述、关联系统、分配账号数量、最后更新人/时间）与操作（新建角色）
账号管理：列（账户 ID、状态、用户名、角色、电子邮件、名称、电话、时区、最后登录时间、创建时间）与快捷筛选（活跃/非活跃/已禁用），操作（新建、导入、分配角色、导出、批量禁用/启用）
客户管理：列（客户 ID、编码、状态、管理员账号、联系人、关联工厂数量、企业名称、账户余额、信用额度、可用余额、预扣金额、总充值、创建时间）与操作（新增）；客户含售后类型配置（RT/RP/RPQ/RF/INS/CHA/DOA）
工厂管理：列（名称、状态、联系人、公司、电话、国家代码、地址、计量单位、时区、创建/更新时间）与操作（新建）
产品审核：状态快捷筛选（草稿/待审核/审核中/可用/审核不通过/待确认/已作废）、BMS 与客户双套尺寸/重量字段，操作（新建、导入、批量提交审核、打印条码、导出、批量作废/启用、批量审核、批量创建翻新产品）
产品 BOM：列（父件/子件 SKU、标配用量、维修/翻新拆装评估总时长）与操作（创建、批量导入/更新、批量删除、导出）
产品报价：列（成本费用、销售单价、最后更新人）与操作（创建、批量导入/更新、导出）
产品类别：快捷筛选（客户/BMS），列含危险品编码，操作（创建、批量删除、导出）
产品故障信息：中/英/德文名称与产品种类（BMS）
产品等级模板、产品分区模板、产品策略列表：名称/状态/备注结构与创建操作
服务流程规则：列（名称、状态、客户编码、工厂、服务类型、优先级、条件表达式、描述、创建人/更新人）与操作（新建）

仍需在页面逐项实测：

角色新建/编辑表单的权限树与保存生效方式
账号新建/导入模板字段、分配角色与批量启用的实际交互
客户新增表单字段与售后类型配置
工厂新建表单字段与计量单位切换
产品新建/编辑表单（SKU、序列号管理、尺寸重量、电池等字段）与审核弹窗
产品 BOM/报价/类别/故障/等级/分区/策略/流程规则的新建表单与校验
上述页面截图（待浏览器控制恢复后逐页补拍）

管理端计费与财务（P2）

已核对内容（2026-08-04，管理端测试环境列表配置）：

物流账号：列（账户名称、状态、物流渠道、国家、服务数量）与操作（新建物流账号）
物流服务：列（类型、服务代码、名称、物流账号、渠道、承运商、国家、状态）与操作（新建物流服务）
自动化规则：快捷筛选（回邮单/发货）、列与操作（新建自动化规则）
物流费模板、物流分区规则（含“测试分区规则”操作）、物流燃油规则（生效日期范围、当前燃油费率）
附加费规则：超长/超重与偏远地区两个页签及各自列字段
物流/售后/操作/仓租费用设置与报价方案设置：列字段与新建操作，报价方案关联各费用设置与回邮/发货物流费
交易流水：快捷筛选（入库/出库/售后/仓储/任务单/物流/其他）、列与操作（新增、批量导入、重算仓租费用、导出）
账单：列（账单金额、待付金额、税额、折扣、付款截止日期、清账时间）与操作（生成账单、批量打印、生成应收单、导出）
充值管理：快捷筛选（待审核/已通过/已拒绝）、列（申请/充值金额、汇率、付款凭证、审核人）与操作（新增、充值、导出）
收款设置：列（付款方式、账户名称/号码、银行信息、电汇代码）与操作（新增）
RMA 门户：列（标题、客户用户名、状态、国家数量、URL）与操作（新建）；RMA 商超用户：邮箱/渠道/状态

发现的问题与待实测项：

支付记录页面配置异常已修复并验证：fee_payment_history_logs 列已恢复正常（创建时间、客户、工厂、关联单号、金额、币种、类型、支付类型、交易前/后可用余额、备注），页面操作含“费用调整、导出”；章节字段表已按真实列更新，管理端与客户端截图已重拍
物流账号/服务新建表单字段与承运商凭据配置
自动化规则的条件配置与生效验证
各费用模板/规则/设置的新建表单（分区明细、阈值、费率、计费项）与试算结果
交易流水调整、账单生成/打印/应收单、充值审核的实际交互
RMA 门户新建与 URL 访问
上述页面截图（待浏览器控制恢复后逐页补拍）

管理端工具/表单/仓储/任务（P2）

已核对内容（2026-08-04，管理端测试环境列表配置）：

任务中心：列（ID、文件名称、类型、任务名称、状态、创建人、备注、开始/完成/创建时间、操作）与类型/状态/时间筛选
版本管理：列（APP ID、应用名称、平台、渠道、更新内容、强制更新、发行、版本号、下载链接）与操作（新建）
审计日志：列（操作人、IP、设备、跟踪 ID、请求方法、URI、状态码、目标表/数据 ID、操作类型、描述、操作时间）与筛选
自定义表单分组：列（中英文名称、状态、客户、工厂、适用场景、优先级、是否分步、条件表达式、描述）与操作（新建模板）
任务单管理：列（标题、任务单号、回复/状态、类型、优先级、报价/审核状态、公司、创建人、工厂、执行人、抄送/跟进人、备注）与快捷筛选（待分配/待处理/进行中/完成），操作（新增/新增(服务端)/新增(客户端)/预览/导出）
运费试算表单要素（发货仓、到货国家/邮编、报价方案、物流渠道、单位系统、货物尺寸重量、保险/签名/住宅地址）与结果构成（基础运费、燃油附加费、附加费、计费重、体积重、分区编码）
测试物流分区（分区规则、国家/州/城市/邮编、通配符 * 匹配）
售后/操作费用试算表单要素（客户、工厂、产品 SKU、材料/包裹明细）

仍需在页面逐项实测：

运费试算/测试分区/售后费用试算/操作费用试算的实际交互与结果展示
自定义表单设计器配置流程与条件表达式
任务单新增表单字段与预览效果
上述页面截图（待浏览器控制恢复后逐页补拍）

服务端工具/任务（P2）

已核对内容（2026-08-04，服务端测试环境配置）：

云打印管理：打印机账号页签（名称、状态、云平台、API 密钥、云盒信息、打印机名称、分配的账号）与打印日志页签（订单号、物流单号、云打印机 ID、任务状态、打印机型号、设备端口、打印账号）
打印代理（EyPrint，go-print-client v1.5.3）：新增章节《打印代理安装与配置》，内容依据项目 README/USER_MANUAL/旧版云打印配置说明整理（本地 wss://127.0.0.1:<端口>/ws 直连 + 云打印双模式、托盘菜单、/settings 纸张参数、配置与日志目录、常见问题）
任务中心、自定义表单组列表、任务单管理：与服务端同源配置，章节按服务端视角编写

仍需在页面逐项实测：

云打印机账号新建表单与工位选打印机流程
云打印机日志任务状态与打印失败排查
上述页面截图（待浏览器控制恢复后逐页补拍）

打印代理配置手册（新增章节）

已核对：

安装/托盘/云打印配置截图沿用旧版配置说明（14 张，安装流程通用，已在章节中标注来源）
本地端口与端点：/api/printers、/settings、/ws（WSS），端口以托盘 “Running on port” 为准
云打印地址 wss://print.renowtrade.com/api/v1/print-agent/ws 与 BMS 云打印管理配置流程
配置/日志目录：macOS ~/Library/Application Support/EyPrint、Windows %APPDATA%\EyPrint

待实测/待补：

系统托盘菜单结构与功能已按最新版说明更新（Version/Running on port、Download Latest Version、Open Debug Panel、Local Network Info（WebSocket/Trust Cert/Open Printer Settings Page）、Cloud Connect Info（Device ID/Token）、Update Templates、Quit）
新版托盘菜单与设置页 /settings 的真实截图（当前沿用旧版安装截图）
下载地址与当前版本号确认（旧文档为 https://print.renowtrade.com/download，v1.5.3）
实际工位安装、信任证书、打印测试的完整走查

客户端

客户账号可见菜单和数据范围
售后订单各类型的创建、编辑和提交
库存查询字段和库存状态含义
财务记录的展示口径

已核对内容（2026-08-04，客户端测试环境列表配置）：

汇总订单（售后订单）：状态快捷筛选（已提交/待支付/待寄出/运输中/待收货/已收货/处理中/已发货/已完成/已取消/异常/已驳回）与操作（新建订单、导入、批量创建回邮标签、批量删除、导出、批量取消）
退货订单：待收货/已收货状态与列（产品图片、SKU、型号、客户编码、订单号、物流单号、故障信息、旧 SN、入库时间）
SU 库存（仓库单元管理）：列（编码、使用状态、业务类型、归属客户、模式、工厂、重量、尺寸、SU 类型、库位、库存类型、绑定库存×数量、启用/更新时间）与操作（创建、批量打印、导出）
OpenAPI 密钥：列（名称、App Key、秘钥、状态、IP 白名单）与操作（创建秘钥）
Webhook 端点：列（名称、端点链接、秘钥、状态、最后更新人、描述）与操作（创建端点）
新增订单（维修/退件）表单要素：寄件/收件/取件信息、商品明细（SKU、服务类型、保修类型、SN、购买凭证）、包裹重量、承运商与自有物流
检测/DOA/换货/维修订单、翻新任务/翻新数据、产品/库存/仓储/财务/RMA：与服务端/管理端同源配置，章节按客户视角编写

仍需在客户端页面逐项实测：

新增订单表单的实际字段、校验与提交结果（含回邮标签生成）
汇总订单批量操作（导入、批量取消、批量删除）的实际交互
客户账号实际可见菜单与数据范围（以 Jalen2025 账号为准）
支付记录配置异常在客户端同样已修复（截图已更新）；财务记录展示口径待继续复核
客户端页面截图（待浏览器控制恢复后逐页补拍）

复核原则

源码中出现的路由不等于当前账号一定可见；菜单由权限动态生成。最终版手册应以测试账号实际看到的页面、按钮和提示为准。

三端页面实测（2026-08-04，Playwright 无头浏览器）

已按 docs/assets/<端>/<一级菜单>/<功能模块>/01-初始页面.png 规范路径为三端主要列表页生成初始页面截图，并通过页面文本逐页核验。

服务端（admin@8001）

入库：入库管理（已预报 1/待收货 1/收货中 1/已收货 5）、上架管理（待上架 6/上架中 1/已上架 14）、新品维护
库存：产品库存（成品/备件/耗材）、库位库存、库存流水、领料管理
出库：一件代发、波次管理、复核验货、扫描发货、异常订单、拦截订单、批量转运、报废出库
维修服务：检测订单、DOA 订单、换货订单、维修订单
退件服务：翻新任务、翻新数据、上架管理（散件/托盘页签）、翻新上架
基础数据：拣货车管理、SU 列表、产品列表
工具模块：云打印管理、任务中心、自定义表单组列表；任务单管理：任务单列表

管理端（admin@8000）

账号权限（角色管理、账号列表）、客户管理（客户列表，活跃 3/非活跃）、工厂管理、产品管理 9 页
RMA管理（RMA页面、RMA商超列表）、物流管理 3 页、运费设置 4 页、报价设置 5 页
工具模块 7 页、自定义表单组列表、仓储服务 4 页、财务管理 5 页、任务单管理

客户端（Jalen2025@8002）

账号权限、产品列表、仓储服务 4 页、库存 3 页、维修服务 6 页、退件服务 4 页
RMA管理 3 页、财务管理 4 页、任务单管理、开发者中心（OpenAPI、Webhook）

实测发现的问题

智能助手四页（异常中心/通知中心/智能提醒/经营分析）已从文档移除：三端测试环境该功能均返回 404 且菜单未显示，按业务决定不再编写对应章节（章节文件、功能目录、侧边栏已同步清理）
支付记录页面配置异常已修复（见“管理端计费与财务”小节）
打印服务使用前提：需先在浏览器访问 https://192.168.2.129:18999/api/printers 并信任证书，页面才能连接打印机；已验证该端点返回 200 与打印机列表（含 Xprinter XP-460B），后续在真实浏览器信任证书后复核复核验货/扫描发货的打印连接

目录与菜单名对齐（已同步完成）

账号管理 → 账号列表；RMA 配置 → RMA管理；财务 → 财务管理；任务单 → 任务单管理；自定义表单 → 自定义表单组列表；客户端产品 → 产品列表（章节文件、功能目录、侧边栏、资产目录均已重命名）