得牛 WMS 仓储管理系统 — 用户操作手册（通用版）

交付版本：v1.3（2026-08-07） 访问地址：由贵司部署环境提供 登录账号：由系统管理员分配 适用浏览器：Chrome / Edge（建议）

一、手册使用说明

本手册集面向仓库一线用户与管理人员，指导使用新架构 WMS 系统。手册按业务域分册，每册相互独立，可单独分发。

首次使用请先阅读《00_系统使用入门》，了解登录、导航与通用操作，再按业务查阅对应分册。

二、手册清单与阅读顺序

序号	手册	适用对象	核心内容
00	系统使用入门	所有用户	访问地址、登录、导航、通用操作
01	入库域操作手册	收货/验收/上架员	到货打印、到货订单管理、RF验收入库上架、封板完验、直通/无单入库、验收撤销
02	出库域操作手册	拣货/复核/分拣/发货员	分拣单、波次、PDA下架、亮灯拣货、称重分拣、复核、二次分播、集货、装车发车
03	库存域操作手册	库管员/盘点员	库存查询、库位下架/移库上架、盘点、调拨、补货、养护、货品主档
04	系统管理域操作手册	系统管理员	组织、用户、角色、权限、字典（仅管理员）
05	报表查询域操作手册	管理人员	入库/出库/库存/分拣/绩效报表查询（含绩效按人员/日期、各作业环节）
06	Plate容器与封箱打印专题	出库/复核/装车员	分播位容器注册、封箱打印一箱一码、出库配送能力提升
07	ERP系统对接	集成/维护/库管员	ERP 对接方式、无对接时批量导入出入库需求
08	多仓库架构部署	管理员/实施/运维	多仓库部署思路、跨库人员权限、仓库发现、与 ERP 对接关系

📌 说明：本手册业务细节参考了原系统用户操作文档，并结合新系统操作界面编写，覆盖 Web 端与 RF/PDA 手持端作业流程。技术实现细节（端口、库名、接口）参见《系统架构设计指南》。

三、推荐阅读路径

新用户 / 首次使用
  → 00 系统使用入门
  → 按岗位阅读对应业务分册

一线作业人员
  → 00 + 01 入库 / 02 出库 / 03 库存（按需）

管理人员
  → 00 + 05 报表查询

系统管理员
  → 00 + 04 系统管理 + 08 多仓库架构部署

四、环境信息

项目	值
系统地址	由贵司部署环境提供
登录账号	由系统管理员分配
支持浏览器	Chrome、Edge

五、系统部署方式与服务器要求概览

📌 本章为部署概览，具体操作步骤、端口、命令与排查请参见《系统部署指南》与《系统架构设计指南》。

5.1 两种部署方式

WMS 新架构采用全栈 Linux 技术栈：前端 Vue 3（Nginx 托管）+ 后端 .NET 8 服务 + MySQL 8.4 数据库。按仓库规模提供两种典型部署形态。

方式一：单仓库典型部署（全栈 Linux + MySQL 8.4）

适用于单个仓库 / 单物流中心，所有组件部署在一台（或少量）Linux 服务器上：

浏览器 ──→ Nginx (80/443) ──→ web-wms 静态文件 (SPA)
                │
                └── /api/* ──→ WebRest 网关 (:5257)
                                  │
                    ┌─────────────┴─────────────┐
                    ▼                           ▼
              PortalApi (:5259)          WmsBusinessApi (:<端口>)
              （认证/仓库发现）            （仓储业务）
                    │                           │
                    ▼                           ▼
              平台库（人员/权限）        业务库 / ERP 对接库
                    └──────── 同属 1 套 MySQL 8.4 实例 ────────┘

组件：1 套前端（Nginx）+ 1 套 WebRest 网关 + 1 套门户服务（PortalApi）+ 1 套业务服务（WmsBusinessApi）+ 1 套 MySQL 8.4（含业务、ERP 接口、权限平台三类数据）。
特点：部署简单、运维成本低；数据库与业务服务可同机（小规模）或数据库独立（推荐生产）。
适用：单一仓库日常运营。

方式二：多仓库 Linux 集群部署

适用于集团多物流中心 / 多子仓库，按物流中心横向扩展，组件以集群方式分布：

                    ┌── 华东物流中心（PortalApi 集群）──────────────┐
                    │   门户服务 :5259（中心级，负责仓库发现/认证）   │
                    │                                              │
                    │   ┌── 中心共享 MySQL 实例 ─────────────────┐ │
                    │   │ platform（权限平台库，中心内共用）       │ │
                    │   │ erp（ERP 对接库，中心内共用）           │ │
                    │   │ ├─ 上海仓 业务库（独立）                │ │
                    │   │ ├─ 宁波仓 业务库（独立）                │ │
                    │   │ └─ 苏州仓 业务库（独立）                │ │
                    │   └────────────────────────────────────────┘ │
                    │   ├─ 上海仓 WmsBusinessApi :<端口>              │
                    │   ├─ 宁波仓 WmsBusinessApi :<端口>              │
                    │   └─ 苏州仓 WmsBusinessApi :5262              │
                    │      ↑ 各仓业务服务端口不同，均由 WebRest 网关按仓库路由 │
                    └───────────────────────────────────────────────┘
                    ┌── 西南物流中心（PortalApi 集群）──────────────┐
                    │   门户服务 :5261 + 中心共享 MySQL（平台库/ERP库）│
                    │   ├─ 成都仓 WmsBusinessApi :<端口> + 独立业务库  │
                    │   └─ 昆明仓 WmsBusinessApi :5264 + 独立业务库  │
                    └───────────────────────────────────────────────┘
       统一前端（Nginx ×多节点 + 负载均衡）──→ WebRest 网关集群（:5257）

门户服务按物流中心部署多实例：每个中心 1 套 PortalApi，负责该中心下子仓库的发现与统一认证。
业务库每仓库独立、平台库与 ERP 对接库中心内共用：同一物流中心下，各子仓库的业务库物理隔离（互不影响），但共享同一套平台库（人员/权限）与 ERP 对接库——即一个中心共用 1 个 MySQL 实例，内含共享的平台库、ERP 对接库，以及各仓库各自的业务库。
前端与网关可集群 + 负载均衡：多节点部署 Nginx / WebRest，前端经负载均衡访问，提升可用性与并发能力。
跨中心隔离：不同物流中心使用各自独立的 MySQL 实例与门户服务，中心间数据隔离。
适用：集团化、跨地域、高可用的多仓库运营。

5.2 两种部署对比

维度	单仓库（方式一）	多仓库集群（方式二）
门户服务	1 套	每物流中心 1 套（多实例）
业务服务	1 套	每仓库 1 套
数据库	1 套 MySQL 8.4（三类数据）	每物流中心 1 套 MySQL（平台库/ERP 库中心内共用，业务库每仓独立）
前端 / 网关	单节点	多节点 + 负载均衡
数据隔离	单库	中心内业务库按仓隔离；平台库/ERP 库中心内共用
可用性	单机依赖	集群容错、横向扩展
适用规模	单仓库	集团 / 多中心 / 多仓

5.3 服务器要求概览（建议配置）

服务器角色	CPU	内存	磁盘	操作系统	说明
前端 / 网关（Web 服务器）	2 核+	4 GB+	50 GB+	Linux（推荐）	静态文件 + 反向代理，压力低
应用服务器（业务服务）	4 核+	8 GB+	100 GB+	Linux	每仓库业务处理，按并发上浮
数据库服务器（MySQL 8.4）	4 核+	8 GB+	200 GB+（含增长）	Linux	独立部署，定期备份

以上为最小建议配置，实际按仓库数量、并发用户、数据量上浮；生产环境建议数据库独立部署并配置定期备份与监控。多仓库集群中每个节点按上表线性扩展。

5.4 网络与安全要求

对外仅暴露 Web 端口（80 / 443）：用户浏览器经公网访问前端（集群场景经负载均衡）。
后端与数据库走内网：网关、业务服务、数据库端口不暴露到公网，仅限前端服务器或白名单内网访问。
推荐 HTTPS：生产环境为前端启用 TLS 加密，保障登录凭证与业务数据传输安全。

5.5 部署顺序（概要）

单仓库：
1. 准备 MySQL 8.4（业务 / ERP 接口 / 权限平台 三类数据）
2. 部署门户服务（PortalApi）
3. 部署业务服务（WmsBusinessApi）
4. 部署 WebRest 网关
5. 部署前端静态文件 + Nginx
6. 端到端验证（登录 → 各页面）

多仓库：
1. 各物流中心准备共享 MySQL 实例（中心内共用平台库与 ERP 对接库），各仓库建立独立业务库
2. 各物流中心部署门户服务（多实例）
3. 各仓库部署业务服务（可并行）
4. 部署 WebRest 网关集群 + 前端负载均衡
5. 配置仓库发现（中心母部门下挂子仓库）
6. 端到端验证（登录 → 选仓 → 各页面）

详细部署顺序、端口、命令与排错见《系统部署指南》与《系统架构设计指南》。

六、反馈与支持

测试过程中如发现问题，请记录：操作步骤、页面、提示信息、截图。
统一反馈给项目对接人，便于及时处理。
本手册为交付测试版，后续将根据系统迭代持续更新。

（本文档由项目组编制。）