7. Inventory, Spares & Procurement
Purpose — Stock across HQ, regional warehouses, dealer stock, and technician van stock; spare parts tied to service jobs; and procurement from upstream suppliers (the true "vendor" in the procurement sense — see Glossary).
Personas served
Finance admin, Service head, Technician (van stock), Dealer (own stock), Super admin.
Key capabilities
- Multi-location stock — HQ, regional warehouses, dealer stock, technician van stock (v2).
- Reservations & oversell prevention — concurrency-safe via Medusa inventory.
- Spare-parts inventory tied to jobs — consume on job close, auto-reorder (FSM).
- Batch / serial / lot tracking — feeds serial lifecycle (Warranty).
- Min-max & reorder automation.
- Procurement — supplier management, purchase orders, GRN (goods receipt).
Data owned
Medusa (PG): inventory items, stock locations, reservations. Mongo / Finance (PG): Supplier, PurchaseOrder, GRN (procurement); van-stock ledgers. Spares mapping shared with Catalog.
Events
- Emits:
inventory.changed,stock.low,po.received,supplier.part.updated. - Consumes:
job.close(consume parts),order.placed(reserve),return.created(restock).
APIs
- Medusa inventory APIs via BFF.
POST /procurement/suppliers,POST /procurement/pos,POST /procurement/pos/:id/grnGET /inventory/locations/:id/stock,POST /inventory/transfer(van stock)
Tenant-config knobs
Warehouse/location list; reorder policy defaults; van-stock enabled flag; supplier categories.
Dependencies
Orders, FSM, Catalog, Finance.
Open questions
- Depth of procurement (light PO/GRN vs full purchasing) per tenant — or defer to ERP integration?
- Van-stock reconciliation cadence.