需求分析
1.1 业务背景
1.1.1 行业现状
传统仓库管理面临以下痛点：
- 手工记账：出入库依赖纸质单据或 Excel，数据易丢失、难追溯
- 库存不准：账实不符是常态，盘点耗时费力
- 效率低下：拣货路径不合理，人员利用率低
- 缺乏预警：无法及时感知库存不足或积压
- 信息孤岛：与 ERP、OMS 等上下游系统脱节
WMS 的目标就是通过信息化手段解决上述问题，实现仓库作业的标准化、数字化和智能化。
1.1.2 目标用户
| 角色 | 描述 | 核心需求 |
|---|---|---|
| 仓库管理员 | 负责仓库日常运营 | 入库/出库操作、库存查询、盘点 |
| 拣货员 | 负责订单拣货 | 拣货任务接收、路径导航 |
| 复核员 | 负责出库复核 | 订单核对、差异处理 |
| 仓库主管 | 负责仓库管理决策 | 报表查看、人员调度、KPI 监控 |
| 系统管理员 | 负责系统运维 | 用户权限、基础数据维护 |
1.2 功能需求
1.2.1 基础数据管理
基础数据管理
├── 货主管理：维护供应商/客户信息
├── 商品管理：SKU 编码、名称、规格、条码、单位
├── 仓库管理：多仓库支持、库区划分
└── 库位管理：库位编码、类型（存储/拣货/暂存）、容量、状态1.2.2 入库管理
入库管理
├── ASN（预到货通知）：上游系统推送预计到货信息
├── 收货：扫码收货、数量校验、质量检验
├── 上架：系统推荐库位 / 人工指定库位
├── 入库单：生成入库单据，记录操作日志
└── 异常处理：数量不符、货损、无单收货1.2.3 出库管理
出库管理
├── 订单接收：对接 OMS 系统获取出库订单
├── 波次策略：按区域/按订单/按线路生成波次
├── 拣货：RF/PDA 拣货、播种式/摘果式
├── 复核：扫描复核、重量校验
├── 打包发货：包裹称重、面单打印、交接承运商
└── 出库单：生成出库单据1.2.4 库存管理
库存管理
├── 库存查询：按 SKU/库位/批次/状态查询实时库存
├── 库存移动：库位间转移
├── 库存调整：盘点差异调整、报损报溢
├── 库存冻结/解冻：质检锁定、退货冻结
├── 批次管理：生产日期、过期日期、批次号追溯
├── 安全库存预警：低库存 / 高库存预警
└── 库存快照：每日库存快照用于对账1.2.5 盘点管理
盘点管理
├── 盘点计划：明盘/盲盘、全盘/抽盘、动态盘点
├── 盘点任务：按库区/库位分配盘点任务
├── 盘点执行：RF 扫码盘点、差异记录
├── 盘点差异：差异分析、复盘
└── 盘点调整：审核后调整库存1.2.6 报表与看板
报表与看板
├── 库存报表：库存汇总、库龄分析、周转率
├── 作业报表：入库/出库效率、人员绩效
├── 异常报表：差异率、货损率
└── 实时看板：今日收发货量、任务完成率1.3 非功能需求
1.3.1 性能
| 指标 | 要求 |
|---|---|
| 接口响应时间 | P99 < 500ms（查询类），P99 < 2s（写入类） |
| 并发支持 | 支持 200+ 用户同时在线操作 |
| 吞吐量 | 出库订单处理 > 1000 单/小时 |
| 数据库 | 单表千万级数据量下查询 < 1s |
1.3.2 可用性与可靠性
- 系统可用性 ≥ 99.9%（年停机时间 < 8.76 小时）
- 数据库主从复制 + 定时备份
- 关键接口熔断降级机制
- 操作日志完整记录，支持审计追溯
1.3.3 安全性
- 基于 RBAC 的权限控制
- 登录认证：JWT + 刷新令牌
- 敏感数据脱敏（手机号、身份证号）
- SQL 注入 / XSS / CSRF 防护
- 接口限流防刷
1.3.4 可扩展性
- 支持多仓库、多货主扩展
- 业务规则可配置（上架策略、波次策略）
- 预留与 ERP / OMS / TMS 对接接口
1.4 用例分析
1.4.1 顶层用例图
1.4.2 入库用例详述
| 字段 | 描述 |
|---|---|
| 用例名称 | 商品入库 |
| 参与者 | 仓库管理员 |
| 前置条件 | 已收到 ASN 预到货通知，货物已到达收货区 |
| 基本流程 | 1. 管理员扫描 ASN 单号；2. 系统展示预计到货明细；3. 逐项扫描条码收货；4. 系统推荐上架库位；5. 管理员上架并确认；6. 系统更新库存 |
| 异常流程 | 数量不符 → 记录差异并标记异常；货损 → 移至残次区并拍照留存 |
| 后置条件 | 库存数量增加，入库单生成，操作日志记录 |
1.4.3 出库用例详述
| 字段 | 描述 |
|---|
|------|--------------------------------------------------------------------------------|
| 用例名称 | 订单出库 |
| 参与者 | 拣货员、复核员 |
| 前置条件 | OMS 已推送出库订单，库存充足 |
| 基本流程 | 1. 系统生成波次并分配拣货任务；2. 拣货员接收任务，按路径拣货；3. 拣货完成送至复核区；4. 复核员扫描核对；5. 打包称重打印面单；6. 交接承运商 |
| 异常流程 | 拣货缺货 → 标记缺货并触发补货；复核差异 → 退回差异处理 |
| 后置条件 | 库存扣减，出库单生成 |
1.5 需求优先级
| 优先级 | 模块 | 说明 |
|---|---|---|
| P0 | 基础数据管理 | 商品、库位等主数据是一切的基础 |
| P0 | 入库管理 | 核心业务流程 |
| P0 | 出库管理 | 核心业务流程 |
| P0 | 库存查询 | 最常用的查询功能 |
| P1 | 盘点管理 | 保障库存准确性的关键 |
| P1 | 批次管理 | 食品/医药等行业必需 |
| P1 | 报表看板 | 管理决策依赖 |
| P2 | 波次策略 | 效率优化，非必需起步就做 |
| P2 | 安全库存预警 | 锦上添花 |
1.6 项目里程碑
Week 1-2: 需求调研与确认
Week 3-4: 系统设计（架构、数据库、接口）
Week 5-10: 核心功能开发（P0）
Week 11-12: P1 功能开发
Week 13-14: 联调测试
Week 15: 用户验收测试（UAT）
Week 16: 上线部署 + 试运行