How therealmoronto/nimbo-wms works
Nimbo is a warehouse-management system whose current product surface centers on API-driven warehouse operations: users manage master data and warehouse topology, then create and query receiving, shipping, relocation, adjustment, and cycle-count documents. Posting those documents updates stock through the documented double-entry ledger; stock-lot availability can be queried for picking. The graph shows the API, contracts, domain, use cases, persistence, and outbox as distinct layers. Some command-dispatch and posting wiring is not shown in the excerpts, so those links are marked unverified or omitted.
Main entry points: Controllers HTTP API · Nimbo.Wms.Contracts Request contracts · GetAvailableStockLotsQueryHandler.cs Available lots · Documents WMS documents
Components 21
API surface
- HTTP API
Nimbo.Wms/Controllers - Request contracts
Nimbo.Wms.Contracts - Result handling
Nimbo.Wms.Contracts/Result.cs
Use cases
- Master data
Nimbo.Wms.Application - Warehouse topology
Nimbo.Wms.Infrastructure/UseCases/Topology - WMS documents
Nimbo.Wms.Application/Services/Documents - Available lots
Nimbo.Wms.Infrastructure/UseCases/Stock/Handlers/GetAvailableStockLotsQueryHandler.cs - DTO mapping
Nimbo.Wms.Application/Mappings - Document posting
Nimbo.Wms.Application/Services/Documents
Warehouse domain
- Master entities
Nimbo.Wms.Domain/Entities/MasterData - Topology entities
Nimbo.Wms.Domain/Entities/Topology - Document aggregates
Nimbo.Wms.Domain/Entities/Documents - Inventory lots
Nimbo.Wms.Domain/Entities/Stock - Quantity rules
Nimbo.Wms.Domain/ValueObject/Quantity.cs - Typed identifiers
Nimbo.Wms.Domain/Identification - Stock ledger
Nimbo.Wms.Domain/Entities/Ledger/StockLedgerEntry.cs
Persistence and events
- EF data context
Nimbo.Wms.Infrastructure/Persistence/NimboWmsDbContext.cs - PostgreSQL
- Outbox processor
Nimbo.Wms.OutboxProcessor/OutboxBackgroundService.cs - Service defaults
Nimbo.Wms.ServiceDefaults/Extensions.cs
Other components
- WMS user
Connections 23
- WMS user → HTTP API: uses
README.md - HTTP API → Request contracts: accepts requests
Nimbo.Wms/Controllers/MasterData/ItemsController.cs - HTTP API → Request contracts: routes topology
Nimbo.Wms/Controllers/Topology/WarehousesController.cs - HTTP API → WMS documents: dispatches commands
- Request contracts → Master data: dispatches queries
- Request contracts → Warehouse topology: dispatches queries
Nimbo.Wms.Infrastructure/UseCases/Topology/Handlers/GetWarehouseTopologyQueryHandler.cs - Request contracts → WMS documents: dispatches documents
- Master data → Master entities: manages
Nimbo.Wms.Application/Services/Documents/ReceivingDocumentPostingService.cs - Warehouse topology → EF data context: reads topology
Nimbo.Wms.Infrastructure/UseCases/Topology/Handlers/GetWarehouseTopologyQueryHandler.cs - WMS documents → Document aggregates: handles documents
Nimbo.Wms.Application/Services/Documents/ReceivingDocumentPostingService.cs - Available lots → EF data context: queries lots
Nimbo.Wms.Infrastructure/UseCases/Stock/Handlers/GetAvailableStockLotsQueryHandler.cs - Available lots → Inventory lots: selects stock
Nimbo.Wms.Infrastructure/UseCases/Stock/Handlers/GetAvailableStockLotsQueryHandler.cs - Available lots → Quantity rules: maps quantities
Nimbo.Wms.Infrastructure/UseCases/Stock/Handlers/GetAvailableStockLotsQueryHandler.cs - Available lots → Typed identifiers: parses IDs
Nimbo.Wms.Infrastructure/UseCases/Stock/Handlers/GetAvailableStockLotsQueryHandler.cs - Warehouse topology → DTO mapping: maps results
Nimbo.Wms.Infrastructure/UseCases/Topology/Handlers/GetWarehouseTopologyQueryHandler.cs - WMS documents → DTO mapping: maps results
- HTTP API → Result handling: returns results
- Document posting → Stock ledger: records movements
README.md - Document posting → Inventory lots: updates stock
README.md - Document aggregates → Stock ledger: posts stock changes
README.md - EF data context → PostgreSQL: persists data
README.md - EF data context → Outbox processor: supplies event data
Nimbo.Wms.OutboxProcessor/Program.cs - HTTP API → Service defaults: configures defaults
Nimbo.Wms/Controllers/MasterData/ItemsController.cs