得牛 WMS 仓储管理系统 — 多仓库架构部署说明

文档版本：v1.2（2026-09-01） 适用对象：系统管理员、实施工程师、IT 运维 适用系统：新架构 WMS 仓储管理系统（集团 / 多物流中心 / 多仓库场景） 文档定位：本手册为《用户操作手册》新增分册，介绍集团下「多仓库」的整体部署思路、人员权限的跨库配置、仓库发现功能，以及多仓库与 ERP 的对接关系。技术实现细节（端口、库名、表结构、代码）请参见《系统架构设计指南》。

1. 文档说明

当贵司以集团形态运营、在全国/区域设有多个物流中心，每个中心下又有多个子仓库时，WMS 采用分布式部署模式。

本说明帮助管理员与实施人员理解：

集团下多仓库的总体部署思路（§2）
人员、权限系统如何跨仓库配置（§3）
「仓库发现」功能如何使用（§4）
多仓库如何与 ERP 对接（§5）

⚠️ 本分册偏「架构与运维视角」。具体的菜单操作（用户/角色/权限维护）仍见《04_系统管理域操作手册》。

2. 集团多仓库部署思路

2.1 总体结构

集团按物流中心划分，每个中心部署一套门户服务（PortalApi），其下挂多个子仓库，每个子仓库有独立的业务服务与独立数据库：

物流中心层：每中心部署 1 套门户服务，负责该中心下子仓库的发现、登录、权限。
仓库层：每仓库部署 1 套业务服务 + 1 个独立业务数据库，数据物理隔离，互不影响。
数据库：每个仓库业务库内通常包含「业务库 / ERP 对接库 / 平台库」三类数据，分别存放主体业务、ERP 同步数据与人员权限。

2.2 三层访问入口

前端（Web / 电脑客户端 / PDA）
    │
    ├── 登录 / 权限 ──→ 门户服务（发现仓库 → 返回业务服务地址）
    │
    └── 业务网关 ──→ 业务服务（按所选仓库路由到对应数据库）

门户服务：登录、仓库列表、权限查询入口，按物流中心部署多套。
业务网关：多仓库统一路由层，根据所选仓库自动转发到正确的业务服务。
业务服务：具体仓储业务接口，亦为 PDA 登录入口。

📌 端口分配、连接串、库名注入等细节参见《系统架构设计指南》。

3. 人员与权限系统的跨库配置

3.1 权限数据集中管理

角色、权限、员工、部门关系统一存放于平台库（各中心可独立，也可集团共用，按管理粒度由实施决定）。

统一约定数据"有效/删除"状态，查询仅看有效数据，系统不物理删除。

3.2 组织架构中的「中心 / 子仓库」两级

部门体系中区分两级：

层级	含义	说明
母部门（物流中心）	集团下的区域中心	记录该中心的门户服务地址
子仓库	具体仓库	记录该仓库的业务服务地址

同一地址字段在两级中有不同含义，分别支撑「仓库发现」与「业务路由」两个场景。

3.3 跨库权限配置原则

人员集中管理：员工、角色、权限集中维护，由门户服务统一认证与鉴权，不随仓库分散。
仓库数据隔离：库存/单据等业务数据在各仓库独立库，员工通过"所属部门/仓库"限定可操作范围。
集团共用权限模型：多中心可各自隔离，也可共用同一套权限数据，由实施时按管理粒度决定。
超级权限：拥有「超级权限」的角色自动拥有全部页面权限，跨仓库统一生效，仅授予极少数系统管理员。

3.4 跨库赋权（多仓协同能力）

「跨库赋权」是一项特殊权限，用于集团 / 中心下的多仓协同：拥有该权限的管理员，登录某仓库后，在「角色分配」等管理页，可见范围从「当前仓库」扩大到「该仓库所在账套（同一管理节点）下的全部仓库」（部门/员工信息另需超级权限，见下方「组合约束」）。

协同场景：集团 / 中心下多仓的人员与权限，可由管理员在一次登录内统一查看、集中维护（无需逐仓登录）；底层既可部署为共享一套平台权限库（集团级统一权限），也可各仓独立库经跨库赋权在视图层合并。任一仓库的访问授权仍由其本仓管理员掌握（见下方「权限分配可控」）。
可见范围（角色分配）：在角色分配页（/system/role-emp），可看到账套内其他仓库的人员与角色，并可把本仓角色赋予外仓用户——单认证，仅需「跨库赋权」。
组合约束（部门/员工）：部门信息（组织架构）与员工信息（用户管理）需同时拥有「超级权限」与「跨库赋权」，才可见同账套全部仓库数据；仅「跨库赋权」仍只看到本仓库（角色分配不受此约束）。
敏感角色：角色「跨库赋权」为敏感角色，仅拥有「超级权限」的账号可见与分配。
权限分配可控：只有本仓管理员可以为外仓人员赋予/撤销对本仓的访问；被访问仓库自主掌握授权，外仓人员无法反向为他人授权进入本仓，权责清晰、可审计。
数据隔离：此能力仅扩大「可见与管理」范围，不改变数据归属；各仓业务数据（库存/单据）仍物理隔离，普通用户（无跨库赋权权限）仍只看到本仓库数据。

4. 仓库发现功能（门户服务 / PortalApi）

4.1 什么是仓库发现

「仓库发现」指用户登录后，系统按账号所授予的权限自动确定其可访问的仓库集合，无需用户记忆或逐个输入各仓库的独立地址。仓库清单由后端在登录时（以及顶部「切换仓库」时）按权限返回，用户只需在有权限的仓库中选择即可。

4.2 使用流程（用户视角）

打开登录页（默认无需填写门户服务地址）
  │
  ├── ① 输入账号、密码，点击登录
  │       （登录请求不预选仓库，由系统按权限自动定仓）
  │
  ├── ② 后端校验密码 → 按权限确定可访问仓库：
  │       ├─ 0 个有权限仓库 → 登录失败（拒绝）
  │       ├─ 1 个           → 自动定仓，直接进入系统
  │       └─ 多个           → 返回 NeedChooseWarehouse + AvailableWarehouses
  │                           → 前端列出"有权限的仓库"下拉，用户选择目标仓库后再次登录
  │
  └── ③ 登录成功 → 后端返回该仓库的业务服务地址
        → 后续业务请求自动路由到对应仓库的业务服务

登录后如需切换到其它有权限的仓库：点击顶部「切换仓库」，系统按权限列出可访问仓库，选择后重新登录即可。

4.3 管理员操作要点

步骤	操作	说明
1	在中心母部门下维护子仓库部门	子仓库记录其业务服务地址
2	将用户通过部门/角色关联到目标仓库	用户拥有的权限决定其 `AvailableWarehouses` 范围
3	确保子仓库业务服务已启动可访问	业务地址由后端登录响应回传，需与维护的一致
4	业务请求经网关自动路由	按登录/切换后选定的仓库转发到正确仓库

仓库增删：在中心下新增/停用子仓库部门、并调整用户部门/角色权限即可，有权限的仓库会自动出现在用户的「切换仓库」列表中，无需改前端。

5. 多仓库与 ERP 对接

5.1 ERP 对接库（中间库）的定位

WMS 与 ERP 系统之间通过独立的 ERP 对接库解耦：

ERP 系统将采购单、销售单、商品/客户主数据写入 ERP 对接库。
WMS 经对接视图只读消费 ERP 对接库数据，再同步到本仓库业务库。
库内作业完成后，WMS 将结果写回 ERP 对接库，由 ERP 系统读取。

5.2 多仓库如何共用

同属一个 ERP 主体的多个子仓库，共用同一套 ERP 对接接口服务：

WMS 对 ERP 提供统一的对接接口服务，以接口密钥认证，提供 ERP 单据增删改查。
多个子仓库的业务服务指向同一 ERP 对接库，实现单据共享。
ERP 回传地址与密钥在系统配置中维护。

5.3 跨库访问原则

ERP 数据经对接视图在仓库业务库暴露，不在业务库直接建立 ERP 物理表。
WMS 不物理删除跨库数据，仅对本地业务数据做状态标记。
ERP 对接库数据的生命周期由 ERP 系统负责。

📌 库名、视图、接口地址、密钥等技术细节参见《系统架构设计指南》与《ERP 对接技术文档》。

6. 实施检查清单

[ ] 每个物流中心部署一套门户服务，中心母部门地址指向该服务
[ ] 每个子仓库部署一套业务服务 + 独立业务库，子部门地址指向其业务服务
[ ] 三类数据（业务 / ERP 对接 / 平台）配置正确
[ ] 员工/角色/权限集中维护，按部门/仓库限定数据范围
[ ] 登录后验证「仓库发现」能按权限列出可访问的子仓库
[ ] 多仓库 ERP 对接库指向同一库，ERP 对接接口服务可达、密钥已配置
[ ] 业务网关按所选仓库正确路由

7. 相关文档

《04_系统管理域操作手册》— 用户/角色/权限的具体维护操作
《07_ERP 系统对接》— ERP 单据对接、批量导入、回传配置
《00_系统使用入门》— 登录与基本操作
《系统架构设计指南》— 端口、库名、表结构、代码等技术细节

（本文档由项目组编制，如有疑问请联系系统管理员。）