待验证清单

管管理员11 次阅读

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

登录与通用操作

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

管理端

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

服务端

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

售后工作台(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管理;财务 → 财务管理;任务单 → 任务单管理;自定义表单 → 自定义表单组列表;客户端产品 → 产品列表(章节文件、功能目录、侧边栏、资产目录均已重命名)

三端菜单复核(2026-09-16)

已重新访问三个测试环境(管理端 8000、服务端 8001、客户端 8002)逐端核对侧边栏菜单,并按菜单更新章节文件、功能目录与侧边栏。

  • 管理端菜单:账号权限(2)、客户列表、工厂列表、产品管理(9)、RMA管理(2)、物流管理(3)、运费设置(4)、报价设置(5)、仓储服务(4)、库存(6)、维修服务(5)、退件服务(3)、财务管理(5)、工具模块(7)、任务单管理
  • 服务端菜单:入库(3)、库存(5)、出库(8)、售后工作台(7)、维修服务(4)、退件服务(6)、基础数据(4)、工具模块(2)、任务单管理
  • 客户端菜单:账号权限(2)、产品列表、仓储服务(4)、库存(4)、维修服务(6)、退件服务(4)、RMA管理(3)、财务管理(4)、任务单管理、开发者中心(2)
  • 自定义表单组列表已由一级菜单移入「工具模块」,章节文件与素材目录同步迁移
  • 任务中心为隐藏页面(不在菜单中,可从导出提示进入),章节保留,并在功能目录中标注“隐藏页面”

以下为本次新增菜单对应的占位章节,内容待补充(需在测试环境实测后编写):

  • 管理端-库存:产品库存、库位库存、库存流水、领料管理、SU 库存、序列号管理
  • 管理端-维修服务:汇总订单、检测订单、DOA 订单、换货订单、维修订单
  • 管理端-退件服务:退货订单、翻新任务、翻新数据
  • 服务端-库存:序列号管理(已按 2026-09-16 培训视频补全:序列号查询、维护操作、收货/上架/出库售后追溯与作业要求)
  • 服务端-退件服务:退货订单、开箱检测
  • 客户端-库存:序列号管理(已按 2026-09-16「客户端功能培训-仓储功能」视频补全,含列表字段、维护操作与应用场景)

客户端仓储功能培训(2026-09-16)

依据 客户端功能培训-仓储功能.mp4(约 62 分钟)补充了客户端仓储相关章节,视频中属业务背景与规则的内容已写入文档:

  • 入库管理:新增入库单三种入库类型(海外备货物料 / 本地仓库转运 / 销售渠道移除)、按箱录入明细、预报→审核→发货(贴箱唛标签)→收货→上架流程
  • 一件代发:海外仓履约背景、订单自动同步、仅发新品与翻新良品、待处理/待拣货/待复核/待出库内部状态、拦截申请处理规则
  • 批量转运:与“本地仓库转运”的方向差异、可转运全部库存类型(含不良品)
  • 报废出库:报废货品来源(维修/翻新换下的部件、报废机)、报废原因(仓租与知识产权)、打托后交当地报废商处理
  • 产品库存:库存增减来源、四个关键字段(SKU/工厂/库存类型/库存属性)、客户所有权口径、建单锁定库存
  • SU 库存:SU 即托盘、退货按托管理的计费背景(库龄阶梯单价)
  • 库存流水:定位库存差异的核心数据
  • 产品列表:产品条码/验条码/FNSKU/其他条码在同一客户下的唯一性

服务端作业细节补充(2026-09-16)

同一视频后半段的服务端作业内容已写入对应章节:

  • 入库管理:仓租自签收起算、必须及时签收、分批收货、每批收货生成上架单、三种收货方式(按箱/组托/整单收货,整单收货不清点)
  • 上架管理:新增“按托”上架方式、托盘与库位一对一、按产品分类存放的原因(便于领料拣货)
  • 新品维护:客户尺寸与 BMS 尺寸的区别、首次到仓需实测维护、目的是保证物流计费尺寸准确
  • 波次管理:订单来源与待处理→加入波次→待拣货流程、汇总拣货与分拣拣货的适用场景、拣货车每个框子代表一个订单、库位拣货优先级
  • 复核验货:扫描产品条码/SKU 条码逐件复核、自动完成开关、复核后自动打印物流标签(依赖本地打印代理)
  • 异常订单:拣货时库位无货是最常见异常来源、先标异常不影响同波次其他订单、确认异常(退回客户端取消)与解除异常(调整库位库存后重拣)
  • 拦截订单:客户端提交拦截申请、仓库核实是否已出库、未出库确认拦截/已交承运商拒绝拦截
  • 批量转运:审核确认快速/复杂转运(是否提供每托明细、计费不同)、汇总拣货、打托录入明细、打印箱唛/托盘标签
  • 报废出库:不良品来源、审核确认计费方式、汇总拣货、实际拣货数量可与申请数量不同
  • 库位库存:新建出库单按库位优先级锁定库存、可用库存与锁定库存口径
  • 领料管理:工程师到岗先领料的场景、按单领料与常用料预领的做法

尚未逐项实测的页面入口与按钮文案(如复核“确认复核/自动完成”开关、报废拣货页字段)以服务端页面实际显示为准,如有差异请在测试环境核对后更新本章节。

客户端售后功能培训(2026-09-16)

依据 客户端功能培训-售后功能.mp4(约 38 分钟)补充客户端售后相关章节:

  • 维修服务/新增订单:四种业务类型(检测 / DOA / 换货 / 维修)定义、基础信息与售后明细字段、序列号用途、一单多件与“退货+维修需分单”、收货/发货/取件地址、平台物流与自有物流
  • 退件服务/新增订单:与维修单的字段差异(无保修类型、无需收件地址)、退货必须整单退回、提交后的状态流转
  • 维修服务/汇总订单:主订单与子订单号规则、混合订单、维修全流程状态与子状态
  • 维修服务/维修订单:保外报价与在线支付流程、待发货 / 待退回、等待合单、驳回
  • 检测订单 / DOA 订单 / 换货订单:业务定义与判定口径(DOA 按 15 天口径,满足后由客户在自身销售平台退款)
  • 退件服务/退货订单、翻新任务、翻新数据:状态流转与翻新后续用途
  • 新增截图:维修服务新增订单表单、退件服务新增退件单、汇总订单主子订单展开

视频后半段的服务端内容已同步写入对应章节:

  • 快速收货:明确“只做收货、不拆包、不清点、不核验”,核验放到开箱检测/故障检测环节;说明仓租自收货起算、按物流单号(或 SN)收货、入库标签的作用与补打、货品明细合并与“混合订单”规则
  • 组托收货:定位为“快速收货 + 散件组托”合并工位;货量不大边收边打托,大批量到货先快速收货
  • 散件组托:补充打托的业务背景(退货包装不规则、按尺寸计仓租不准、按托管理更清晰)
  • SU 列表:补充 SU 即库存单元(托盘/纸箱等)、闲置→占用→已满的状态流转、启用时间用于仓租计算、标记已满/未满与总重量录入

服务端功能培训 01(2026-09-16)

依据 服务端功能培训01.mp4(约 48 分钟)补充服务端章节:

  • 售后工作台/售后出库:待发货(仅维修良品)与待退回(原机退回,需客户与消费者沟通后确认)的区别与原因;拣货出库作为交接节点用于丢包追溯
  • 售后工作台/上架管理:上架单来源、散件与托盘的转移关系、一个上架单可含多托盘与库位分配、按产品/订单维度的上架意义、散件出现非退货类型的原因(检测/换货/维修不良品换新后物权转移)
  • 维修服务/维修订单:开箱检测→故障检测→判保→保外报价(仅保外部件)→维修换件(操作类型/库存类型/数量)→良品自动创建物流运单、不良品由客户介入
  • 维修服务/检测订单:检测只需一步记录、入库节点由快速收货自动生成、检测表单按客户在管理端配置
  • 退件服务/翻新任务:是否分步骤/是否审核/工程师分配、典型 4 步流程、串行流转与步骤权限、SN 记录内容(故障/换件/评级/耗材)、托盘在最后一步记录、翻新前需拣货下架到翻新区、翻新完成需上架
  • 基础数据/分区管理:分区类型与业务用途(存储区含地堆、暂存区、维修区、翻新区、废品区)与按客户分区建议
  • 基础数据/拣货车管理:一件代发多订单拣货场景、一格一单、大件/小件车型差异
  • 工具模块/云打印管理:云打印(第三方盒子)与本地打印代理的原理、延迟对比、一台 PC 作为打印服务的部署方式、各环节打印的标签类型
  • 任务单管理/任务单列表:非标业务(找货、采购)通过任务单下发服务端现场执行的场景

新客户维修业务全流程配置培训(2026-09-16)

依据 新客户维修业务全流程配置上线培训01.mp4(52 分钟)与 …02.mp4(22 分钟)补充三端章节:

管理端(配置链路)

  • 功能总览:新增「新客户上线配置顺序」八步流程(开通客户 → 维护工厂 → 产品维护与审核 → 维修计费基础 → 作业流程 → 物流与费用 → 报价方案 → 联调验证)
  • 客户管理/客户列表:客户开通流程(建客户并设置客户端管理员 → 邀请邮件设密码 → 分配工厂 → 账号绑定工厂)与业务类型
  • 工厂管理/工厂列表:工厂=仓库=服务中心,按地区建服务中心并按区域绑定产品(欧规/美规分别建 SKU)
  • 账号权限/账号列表:账号需绑定工厂,否则部分页面看不到对应工厂数据
  • 产品管理 9 篇:产品审核(审核后才可用)、产品 BOM(可用子件、标配用量、实际可能超量、评估时长决定等级与费用)、产品报价(保外部件报价)、产品类别(客户维度品类 vs BMS 平台品类)、产品故障信息(按品类维护)、产品等级模板(按评估时长分级与报价、自动算费、财务出账依据)、产品分区模板(基站/机器人等物理模块分别计费的叠加规则)、产品策略列表(产品+故障+等级+分区绑定)、服务流程规则(固定节点与可选节点、条件匹配、优先级)
  • 工具模块/自定义表单组列表:流程规则决定节点、自定义表单决定每个节点记录的信息;维修不分步骤、翻新可分步骤
  • 物流管理 3 篇:物流账号(承运商/第三方打单平台)、物流服务(商业/住宅地址差异、平台多渠道)、自动化规则(回邮逆向物流与发货正向物流的条件匹配与优先级)
  • 运费设置 4 篇:分区规则(按邮编、常规 8 区/偏远 12 区)、物流费模板(分区+重量段基础费与续重)、附加费规则(偏远分级、超限制判定条件)、燃油规则(按时间段比例)
  • 报价设置/报价方案设置:结算币种决定可选费用设置、关联物流服务与费用设置、按有效期执行

客户端 / 服务端(联动)

  • 客户端新增订单(维修/退件):可选物流服务范围由管理端报价方案关联决定
  • 维修全流程串联(客户端建单 → 回邮标签 → 收货 → 各业务节点 → 良品自动创建运单 → 售后出库快速拣货)已在客户端与服务端对应章节体现

视频中提到的待优化项(保外费用与客户分开结算的细化、C 端自助报修流程演示、等级 ID 可读性优化)未写入操作手册。

文档结构

  • 新增与三端并列的专题文档板块:docs/专题/ + 专题总览,首篇为《新客户维修业务全流程配置上线指引》(导航、侧边栏、首页、功能目录、README、编写规范均已同步)
  • 新增与三端并列的 APP(PDA / 移动端) 板块:docs/APP/功能总览.md 已按 app2026 代码中的首页菜单分区与二级操作入口整理出完整菜单结构(导航、侧边栏、首页、功能目录、README、编写规范均已同步);各功能页面的操作手册待逐页编写

APP 功能培训(2026-09-18)

依据 PDA-APP-01/02/03.mp4(共约 7.5 分钟)编写 APP 基础章节:

  • 登录与仓库选择:账号密码登录、忘记密码找回、切换测试/正式服务器环境(设置服务器 → 快速使用测试环境 / 恢复默认)、首次登录或绑定多仓库时选择作业仓库
  • 我的与个人设置:账号管理(个人信息查看与编辑,用户名不可修改)、修改密码、语言设置(简中 / English / Deutsch)、退出登录
  • 打印设置:自研打印代理装在作业区 PC 上、APP 通过局域网连接并打印入库标签/翻新标签;延迟优于云打印(公网约 2~3 秒);打印服务地址可从 PC 端打印代理的系统托盘 Local Network Info 获取;支持一台 PC 连接多台打印机
  • 新增截图:APP 首页、登录页、设置服务器地址、选择仓库、我的页面、个人信息、打印设置(均已从视频抽帧裁掉黑边)
  • APP 各业务功能页面(快速收货、组托收货、散件组托、上架、拣货、复核验货、扫描发货、异常/拦截订单、开箱检测、售后出库、快速拣货、维修/翻新、库存与分区等)的操作手册待按菜单逐页编写

APP 基础章节补充(2026-09-18,BMS-APP 目录录屏)

依据 BMS-APP/登录-首页-我的基本功能介绍.mp4(10 分 24 秒)重新核对了 APP 基础章节,并用完整窗口的抽帧替换了原先信息不全的截图:

  • 登录与仓库选择:补充“同一台手机可在正式/测试环境间切换”(老版本不支持)、人脸/指纹快捷登录、忘记密码会发送重置密码邮件;设置服务器步骤按视频重写
  • 我的与个人设置:补充邮箱唯一性(同一邮箱只能创建一个账号,更换需确认未被占用)、时区作用(控制该账号看到的所有订单时间,按所在工厂/工作地选择)、页面底部显示 App 版本号
  • 打印设置:补充打印代理的两项能力(云打印 + 局域网打印机共享,PC 端与 APP 均可用)、云打印延迟量化(2~3 秒,100+ 单/天时等待接近半小时)、APP 需使用 ws:// 开头的地址、连接成功后的打印机列表
  • 功能总览:补充新版本“仓管与工程师进入同一个首页、可见模块由管理端权限控制”的说明
  • 替换截图:登录页、设置服务器地址、我的页面、个人信息、打印设置、首页(均取自新录屏的完整窗口并裁掉左右黑边)
  • 选择仓库界面截图已补齐:依据新增录屏《选择仓库功能介绍.mp4》重新截取,标题与三个仓库选项均完整(原截图左侧被裁的问题已修复)

APP 业务章节(2026-09-18,任务单与开箱检测录屏)

依据 BMS-APP/任务单管理与开箱检测功能介绍.mp4(11 分 08 秒)新增两篇 APP 业务章节:

  • APP/任务单管理:状态页签(全部/待分配/待处理/进行中)、按标题或订单号搜索、回复状态/状态/客户筛选、卡片字段,以及回复、派单、完成/取消等操作(与 PC 端功能一致)
  • APP/退件服务/开箱检测:扫描物流单号/主单号/子单号定位退货主单;三步流程(开箱前 → 产品检测 → 封箱);产品清单差异处理(多收新增、少收删除、型号不符修改,均需上传照片/视频证明);检测结果(正常/空包/非品牌型号/未收到,异常需上传图片);提交并完成检测后不可再修改的提醒
  • 新增截图:任务单列表、开箱检测初始页、扫描订单与产品、产品检测表单
  • APP 其余业务模块(快速收货、组托收货、散件组托、上架、拣货、复核验货、扫描发货、异常/拦截订单、售后出库、快速拣货、翻新任务、翻新机上架、库存与分区管理)待后续录制后补充

APP 业务章节(2026-09-18,第二批录屏)

依据 BMS-APP 目录第二批 6 个录屏(共约 54 分钟,已重命名为「翻新任务功能介绍」「翻新机上架功能介绍」「售后工作台收货与组托功能介绍」「售后上架出库与快速拣货功能介绍」「库存管理功能介绍」「出库管理功能介绍」)新增 8 篇 APP 章节:

  • 退件服务/翻新任务:任务单信息核对、先确认产品再录 SN、翻新表单字段(故障/部件/来源/数量/操作类型/翻新结果)、托盘字段与上架后才产生可用库存、四个提交按钮语义、分步骤流程(外观检测→换件→质检→清洁打包)与步骤权限(无权限只能查看、必须按顺序、已记录可修改、重置/重新选择 SU)
  • 退件服务/翻新机上架:散件/托盘两个维度、先建上架单再上架、散件可整单上架、托盘一对一库位只能单选
  • 售后工作台/快速收货:快速模式(扫码自动入库)与自动打印开关、无单包裹收货(先确认客户→扫无单专用 SKU 或产品 SKU 绑定客户→增减数量→完成)
  • 售后工作台/组托收货与散件组托:组托收货适用场景与打托规则(不同客户、有单/无单不混装)、自动推荐托盘开关、散件组托绑定/释放订单、标记装满需填实测重量、创建上架单
  • 售后工作台/售后上架、售后出库与快速拣货:售后上架散件/托盘流程;“待退回”(维修不良品、检测/换货/DOA 不满足政策原机退回)与“待发货”(维修良品自动创建运单失败)的成因与处理;快速拣货作为交给承运商的确认节点
  • 库存管理/物料申请:申请用途(维修/翻新)、客户与物料 SKU、仓管拣货可微调数量并指定维修区/翻新区目标库位
  • 库存管理/产品库存:移库(按库位批量移库 / 按 SKU 单件移库)、库存调整(客户+库存类型+库存属性、减少不能超可用库存)、库存查询(流水、锁定明细、库存详情)
  • 出库管理/一件代发与出库作业:代发订单生成波次→拣货→复核验货→扫描发货,注明与 PC 端一一对应并链接服务端章节
  • 产品列表(SKU 标签蓝牙打印)与分区管理(分区/库位/库位标签,删除限制)章节待补充
  • APP 业务章节截图待补充(本轮先完成文字内容,截图可按需从对应录屏抽取)

客户端(PC)功能补充(2026-09-23,BMS-PC 目录录屏)

依据 BMS-PC 目录 8 个录屏(共约 35 分钟,已重命名)补充客户端章节内容与截图:

  • 仓储服务/一件代发:补充业务场景(发配件、换货/维修不良品发新机或翻新机)、状态说明(草稿/处理中/已出库/异常/已取消,导入默认草稿)、新建出库单要点(工厂、BSR 智选物流与自有物流、收件地址、库存类型、智能包裹包装、可改推荐物流服务并重算费用、运单创建失败重试)、处理中订单的出库拦截
  • 仓储服务/入库管理:「销售渠道移除」除退件外也支持新机移除(线下网点撤店、型号停售)
  • 退件服务/退货订单:需要开箱检测的订单收货后进入开箱检测,检测完成后订单转为已完成;详情页处理历史可查看开箱检测明细;列表支持「需要开箱检测」筛选
  • 退件服务/翻新任务:任务列表与状态筛选
  • 退件服务/翻新数据:翻新结果(良品/不良品)与等级 A/B/C/R(R 类为不分等级统称),翻新结果 SKU 由管理端按固定后缀统一创建
  • RMA管理/RMA页面:RMA 自助报修平台的申请流程(申请→审核→部署→新增国家),国家与工厂对应、可按州/省精确指定工厂
  • RMA管理/RMA商超列表:商超自助报修与 C 端报修的差异(商超无需客户审核,修好寄回商超由商超通知消费者取件)
  • RMA管理/RMA邮件配置:发件邮箱配置、多语言模板、节点模板(保外约 5 个、保内约 6 个节点,收单通知共用)、变量替换、所有语言配齐才能提交、测试与关闭节点
  • 财务管理/充值管理:新客户预充值流程(银行转账多币种或在线支付 → 填写支付信息 → 财务审核入账)
  • 财务管理/账单:财务按月汇总流水出账,客户付款后核销并产生支付记录
  • 任务单管理/任务单列表:任务单类型(物流相关、特殊订单处理、采购申请)与报价确认
  • 新增章节:客户端/个人中心/电商店铺授权(亚马逊店铺授权、FBA 移除订单自动建单、其他 ERP 出库订单同步)
  • 新增截图 12 张:一件代发 3 张、入库管理、退货订单、翻新任务、RMA 页面、RMA 邮件配置、充值管理、账单、任务单、电商店铺授权

专题文档:技术支持部门系统培训指引(2026-09-28)

根据技术支持部门的职责(产品数据审核与评估、业务流程 SOP 维护、售后服务数据抽检、工程师功能带教)新增专题文档《技术支持部门系统培训指引》:

  • 适用对象与培训目标、职责与系统模块对照表
  • 建议培训顺序(7 个阶段,含建议时长与检查点)
  • 产品审核与评估:审核流程、评估内容表、8 项审核检查清单
  • 业务流程 SOP 维护:服务流程规则与自定义表单两个层次、流程节点规则、表单配置要点、变更 SOP 的影响面与变更建议
  • 售后数据抽检:抽检对象与判据表、抽检方法 5 步、常见异常与处理对照表
  • 工程师功能带教:APP 工程师模块清单(含文档链接)、7 条培训要点、四步带教法
  • 培训考核检查清单 12 项、相关文档索引
  • 说明:文档中的培训时长、带教方法与检查清单为建议性安排,可按团队实际情况调整