仓管小精灵 (Warehouse Elf)
> 多仓库进销存 + 库位追踪 + FIFO批次 + 安全库存预警。
> 与采购-elf/销售-elf天然打通，形成"采→仓→销"闭环。
核心能力
多仓库库位体系
- 三级定位
总仓 → 分仓 → 货架货位 - 虚拟仓（在途、待检、不良品、客户寄存）
- 库位容量管理（最大/当前体积重量）
入出库管理
| 类型 | 触发来源 | 说明 |
|---|---|---|
| 采购入库 | procurement-elf po 收货 |
自动关联采购单 |
| 退货入库 | procurement-elf return |
退货回流 |
| 调拨入库 | warehouse-elf transfer |
跨仓移库 |
| 销售出库 | crm-tracker/sales-master 订单 | 自动扣减库存 |
| 领料出库 | 内部申领 | 部门领用 |
| 调拨出库 | warehouse-elf transfer |
跨仓移库 |
批次与序列号
- 批次追踪：FIFO（先进先出）/ FEFO（先到期先出）
- 序列号：单品级追踪（高值物品/合规要求）
库内管理
- 移库调拨：跨仓调拨 / 同仓移库
- 循环盘点：ABC分类差异化盘点策略（A类高频、C类低频）
- 差异调整：盘盈/盘亏自动调整库存
预警中心
| 预警类型 | 触发条件 | 动作 |
|---|---|---|
| 安全库存预警 | qty < safety_stock | 自动通知采购-elf补货 |
| 效期预警 | 距到期 < N天 | 提醒出库/清仓 |
| 积压预警 | 库龄 > N天 | 降价/促销建议 |
| 零库存预警 | 有需求但库存=0 | 紧急采购触发 |
分析报表
- 实时库存：按仓库/物料/批次多维度查询
- 库存周转率 = 出库成本 / 平均库存
- ABC分类：按周转率+价值自动分级
- 库龄分析：0-30天 / 30-90天 / 90-180天 / 180天+
- 收发存汇总：月/季/年 收入-发出-结存
快速启动
Web面板（推荐）
pip install flask
python scripts/web_server.py --port 8771
浏览器打开 http://localhost:8771 — 15页面浅蓝主题
CLI命令行
# 初始化数据库
python scripts/db.py --force
# 查看所有命令
python scripts/warehouse_cli.py --help
# 数据看板
python scripts/warehouse_cli.py dashboard
20+ CLI命令速查
仓库模块
| 命令 | 别名 | 功能 |
|---|---|---|
warehouse |
wh |
仓库管理（列表/新增/编辑） |
location |
loc |
库位管理（货架定位） |
库存操作
| 命令 | 别名 | 功能 |
|---|---|---|
inventory |
inv/stock |
实时库存查询 |
inbound |
in |
入库操作（创建/确认入库） |
outbound |
out |
出库操作（创建/确认出库） |
transfer |
move |
调拨移库（跨仓/同仓） |
adjust |
adj |
库存调整（报损/盘盈盘亏） |
库内管理
| 命令 | 别名 | 功能 |
|---|---|---|
count |
check |
盘点管理（创建/执行/确认） |
batch |
bat |
批次管理（FIFO/FEFO出库） |
serial |
sn |
序列号追踪 |
查询与分析
| 命令 | 别名 | 功能 |
|---|---|---|
history |
his |
出入库历史记录 |
alert |
— | 库存预警（安全库存/效期/积压） |
age |
— | 库龄分析 |
abc |
— | ABC分类分析 |
dashboard |
dash |
数据看板 |
report |
rpt |
收发存汇总表 |
文件结构
warehouse-elf/
├── SKILL.md ← 本文件
├── warehouse.db ← SQLite数据库(22张表，运行时生成)
├── scripts/
│ ├── db.py ← 数据库(22张表 + 4行业种子数据)
│ ├── warehouse_cli.py ← CLI主入口(注册所有模块)
│ ├── warehouse_cmds.py ← 仓库/库位/库存/预警/看板命令
│ ├── io_cmds.py ← 入库/出库/调拨/调整命令
│ ├── internal_cmds.py ← 盘点/批次/序列号命令
│ ├── query_cmds.py ← 历史/库龄/ABC/报表/收发存命令
│ ├── web_server.py ← Flask Web面板
│ └── test_warehouse.py ← 集成测试
└── references/
└── docs.md ← 业务逻辑说明文档
数据库设计（22张核心表）
仓库体系
| 表 | 用途 |
|---|---|
warehouses |
仓库（名称/类型/容量/负责人） |
locations |
库位（货架/货位/分区） |
库存核心
| 表 | 用途 |
|---|---|
materials |
物料基础信息（复用procurement-elf） |
material_configs |
物料-仓库配置（安全库存/最大库存/补货点） |
inventory_items |
库存项（仓库×物料×批次的实时库存） |
batches |
批次信息（生产日期/到期日期/数量） |
serial_numbers |
序列号追踪（单品级） |
出入库单据
| 表 | 用途 |
|---|---|
inbound_orders |
入库单主表（来源/类型/状态） |
inbound_items |
入库单明细（物料/库位/批次/Qty） |
outbound_orders |
出库单主表（来源/类型/状态） |
outbound_items |
出库单明细（物料/库位/批次/Qty） |
库内管理
| 表 | 用途 |
|---|---|
stock_transfers |
调拨单（源仓库→目标仓库） |
transfer_items |
调拨明细 |
inventory_counts |
盘点单（全盘/抽盘） |
count_items |
盘点明细（账面值/实盘值/差异） |
stock_adjustments |
调整单（报损/盘盈盘亏） |
adjustment_items |
调整明细 |
审计与分析
| 表 | 用途 |
|---|---|
stock_movements |
库存变动审计（所有入出调整的完整流水） |
alerts |
预警记录（安全库存/效期/积压） |
sap_configs |
系统配置（FIFO/FEFO策略等） |
15页面 Web面板
| 页面 | 功能 |
|---|---|
| 数据看板 | 总库存价值/本月入出库趋势/预警概览 |
| 实时库存 | 多维度库存查询（仓库/物料/批次） |
| 入库管理 | 入库单列表/创建/确认入库 |
| 出库管理 | 出库单列表/创建/FIFO推荐出库 |
| 仓库库位 | 仓库架构/库位容量/空满状态 |
| 调拨移库 | 跨仓调拨/同仓移库 |
| 盘点管理 | 创建盘点/执行盘点/差异调整 |
| 批次管理 | 批次库存/到期提醒/FEFO出库 |
| 序列号 | 单品追踪/序列号查询 |
| 库存预警 | 安全库存/效期/积压/零库存 |
| 库龄分析 | 库龄分布/库龄明细 |
| ABC分类 | 物料ABC分级/分析图表 |
| 历史收发存 | 出入月汇总表 |
| 采购关联 | 与procurement-elf联动（在途/待入库） |
| 销售关联 | 与crm-tracker联动（待出库/已出库） |
4大行业种子数据
| 行业 | 仓库类型 | 特色功能 |
|---|---|---|
| 🏭 制造业 | 原料仓/半成品仓/成品仓 | 批次追踪/FIFO/序列号 |
| 🥬 零售/电商 | 总仓(华南)+分仓(华北) | 多仓协同/爆品库位/效期管理 |
| 💊 医药流通 | 合规GSP/阴凉库/冷库 | 序列号全程/近效期预警 |
| 🚗 汽车4S店 | 配件仓/精品仓 | 序列号/批次/数量共存 |
数据完整性
种子数据覆盖全部22张表（150+条），核心数据量：
| 类别 | 条数 | 说明 |
|---|---|---|
| 仓/库位 | 4+20 | 4大行业仓库+20个库位配置 |
| 物料/配置 | 20+80 | 4种行业物料+仓库配置 |
| 库存 | 40+ | 多仓库多批次库存是 |
| 入出库单据 | 30+ | 采购入库/销售出库/调拨 |
| 批次/序列号 | 15批次+15序列号 | 批次追踪+序列号 |
| 盘点/调整 | 2+2 | 盘点单 |
| 变动历史 | 80+ | 完整审计追踪 |
核心业务流程
采购到货 ──→ 质检通过 ──→ 确认入库 ──→ 库存增加 ──→ 自动更新库存
│
销售订单 ──→ 库存检查 ──→ 确认出库 ──→ 库存扣减 ──→ 生成出库单
│
库存不足 ──→ 安全库存预警 ──→ 触发采购-elf补货
│
月底 ──→ 循环盘点 ──→ 差异处理 ──→ 盘盈/盘亏调整
│
月底 ──→ 收发存汇总 ──→ ABC分析 ──→ 库存周转率 ──→ 持续优化
与采购-elf/销售-elf闭环
采购-elf 仓管小精灵 销售-elf/crm-tracker
──────── ────────── ─────────────────
po收货 ──────────────────→ 库存入库
库存数据 ──────────────→ 订单出库
安全库存预警 ──────────→ 触发新PO
在途库存 ──────────────→ 客户告知
收货异常 ──────────────→ 退货处理
技术栈
- Python 3.11+ / Flask / SQLite
- 纯HTML/CSS/JS前端（无框架依赖）
- 浅蓝清爽主题（与procurement-elf统一）
版本历史
- v1.0.0 (2026-07-13) — 首版：22表/20+命令/15页面/4行业种子数据
