WarehouseFlow OS

Lightweight warehouse operating system starter for inventory receiving, stock movement, pick-pack tasks, and operator analytics.

Why This Exists

Many small teams outgrow spreadsheets before they are ready for a full ERP. WarehouseFlow OS is a clear open-source base for building warehouse tools around the workflows that matter first: receive stock, move it, reserve it, ship it, and understand what changed.

Core Features

• SKU inventory ledger.
• Receiving workflow with location tracking.
• Stock movement between bins.
• Pick workflow with reservation and shipment.
• Event history for operational audit.
• Dependency-light Node.js API with built-in tests.

Quick Start

npm install
npm test
npm start

API:

curl http://localhost:8090/health
curl http://localhost:8090/inventory

Receive stock:

curl -X POST http://localhost:8090/receive \
  -H "content-type: application/json" \
  -d "{\"sku\":\"SKU-100\",\"name\":\"Sensor Kit\",\"quantity\":20,\"location\":\"A1\"}"

Architecture

operator task -> workflow command -> inventory ledger -> event history -> analytics/dashboard

Roadmap

• Barcode scanner UI.
• PostgreSQL persistence.
• Role-based operator accounts.
• CSV import/export.
• Pick route optimization.
• Reorder point alerts.

License

MIT