EcoWare Stock Management (v1) — Simple, Solid, Ledger-First

Visual overview for customer discussion. The core principle: every quantity change becomes a Stock History entry (who/when/why + before/after). For v1: batch is chosen at dispatch, and location is a simple text field.

Interactive Demo

Try the examples
Tip: Click the example buttons below to see how the ledger updates. The right panel shows live stock balances derived from the history.
Quick Examples
v1 Screens (what the customer sees)
  • Current Stocks — List stocks + filters, shows Available + key details
  • Stock Detail — All fields for a batch + link to history
  • Enter New Stock — Manual entry (mobile scanning later)
  • Actions — Record damage / missing / waste / sample
  • Restock Returns — Add returned quantity back into Available
  • Finished Stocks — Available = 0 (still searchable + history)
  • Stock History — View-only audit trail/ledger
The v1 Rule (what makes it "solid")

We don't "edit quantities" directly. Instead, quantities change only through actions, and each action creates a Stock History entry. Balances shown are live snapshots derived from the ledger.

Dispatch 20kg from batch X → History: "Dispatch" (Available −20, Sold +20)
Sales/Dispatch (kept simple for v1)

No complicated "reservation engines" in v1. At dispatch time, the warehouse user chooses the batch(es) shipped, and the system records the sold-by-batch truth for traceability.

Manual Actions (for discussion)

These forms demonstrate how the ledger behaves. Not final UI.

📥 Receive Stock
📤 Dispatch
⚠️ Adjust (waste/damage/missing/sample)
Always reduces Available
↩️ Restock Return
📋 Stock Take Reconcile
🏭 Finish Production
What we do NOT build in v1
  • Bin-level "move stock" / multi-location balances
  • Complex reservations / allocation optimizer at order time
  • Automatic COA matching (manual link or lookup)
  • Full QC quarantine workflow (add Hold/Release later if needed)
  • Accounting valuation and batch cost layers

Live View

Derived from Stock History
Rule Balances are derived from the ledger
v1 Batch is chosen at dispatch time
0 Stock Batches
0 History Entries
Current Stocks
SKU Batch Unit Location Available Status
Stock History (Ledger) All
# Action Stock Change Notes / Ref