How dekoithub/warehouse-sorter works
warehouse-sorter is a warehouse parcel-sorting simulation. In the principal workflow, src/main.py drives item creation and sensor detection; the controller scans and requests a route from the WMS, dispatches parcels to conveyors or buffers, and handles sorter events to place parcels in output bins or manual processing. Statistics collect processing and load metrics for a final report. The README names no further capabilities; architecture reflects the sampled source, so unsampled runtime details are not inferred.
Main entry points: controller.py Workflow controller · item.py Parcel state · main.py Simulation runner · sensor.py Sensors
Components 13
Simulation flow
- Simulation runner
src/main.py - Workflow controller
src/models/controller.py
Scan and routing
- Sensors
src/models/sensor.py - Barcode scanner
src/models/scanner.py - Route lookup
src/models/wms.py
Material handling
- Conveyors
src/models/conveyor.py - Buffer storage
src/models/buffer.py - Parcel sorter
src/models/sorter.py - Output bins
src/models/output_bin.py - Manual processing
src/models/controller.py
Items and reporting
- Parcel state
src/models/item.py - Metrics and report
src/models/statistics.py
Other components
- Simulation operator
Connections 20
- Simulation operator → Simulation runner: runs simulation
- Simulation runner → Parcel state: creates parcels
src/main.py - Simulation runner → Workflow controller: drives workflow
src/main.py - Simulation runner → Sensors: detects and signals
src/main.py - Workflow controller → Sensors: processes events
src/main.py - Workflow controller → Barcode scanner: scans parcels
src/models/controller.py - Workflow controller → Route lookup: requests destination
src/models/controller.py - Workflow controller → Conveyors: dispatches parcels
src/models/controller.py - Workflow controller → Buffer storage: stores or releases
src/models/controller.py - Workflow controller → Parcel sorter: sorts parcels
src/models/controller.py - Workflow controller → Output bins: places sorted parcels
src/models/controller.py - Workflow controller → Manual processing: sends exceptions
src/models/controller.py - Workflow controller → Metrics and report: updates metrics
src/models/controller.py - Simulation runner → Metrics and report: reports results
src/main.py - Workflow controller → Parcel state: updates parcel state
src/models/controller.py - Sensors → Parcel state: identifies parcel
src/models/sensor.py - Conveyors → Parcel state: holds parcels
src/models/conveyor.py - Buffer storage → Parcel state: holds parcels
src/models/buffer.py - Parcel sorter → Parcel state: changes direction
src/models/sorter.py - Output bins → Parcel state: stores parcels
src/models/output_bin.py