How oliverevans96/blueberries-voi works
Blueberries-VOI models a perishable blueberry store, estimates hidden inventory freshness, evaluates ordering and value of information, and exposes the same Rust simulation through Python and a browser studio. The primary interactive workflow is operator input → studio → WebAssembly engine → daily simulation results; notebooks and batch studies use the Python package and native Rust engine. The graph includes the major documented capabilities and indexed core modules. Some subsystem links are supported by imports listed in the source index rather than sampled call bodies; browser-to-engine wiring is documented in the README.
Main entry points: session.rs Engine session · physics.rs Daily physics · belief.py Particle filter · voi_profit.py Batch studies
Components 19
Interactive studio
- Studio UI
web/src/App.tsx - WASM worker
web/src/engine/wasmWorker.ts - WASM interface
crates/voi_wasm/src/lib.rs
Simulation engine
- Engine session
crates/voi_core/src/session.rs - Daily physics
crates/voi_core/src/physics.rs - Model parameters
crates/voi_core/src/params.rs - Demand calendar
crates/voi_core/src/demand_profile.rs - Arrival freshness
crates/voi_core/src/arrival.rs - Shipment lifecycle
crates/voi_core/src/shipments.rs - Random streams
crates/voi_core/src/spawn_rng.rs - Episode simulation
src/blueberries_voi/sim/order_schedule.py
Belief and control
- Particle filter
src/blueberries_voi/filter/belief.py - Observation contract
src/blueberries_voi/filter/types.py - Ordering policies
src/blueberries_voi/controller/session_loop.py
Analysis and interfaces
- Profit metrics
src/blueberries_voi/sim/profit.py - VOI analysis
src/blueberries_voi/voi/sweep.py - Python engine API
crates/voi_py/src/lib.rs - Batch studies
src/blueberries_voi/experiments/voi_profit.py
Other components
- Store operator
Connections 23
- Store operator → Studio UI: operates
README.md - Studio UI → WASM worker: uses worker
README.md - WASM worker → WASM interface: runs kernel
README.md - WASM interface → Engine session: exposes engine
- Engine session → Arrival freshness: uses model
crates/voi_core/src/session.rs - Engine session → Daily physics: advances days
crates/voi_core/src/session.rs - Engine session → Shipment lifecycle: uses shipments
crates/voi_core/src/session.rs - Engine session → Model parameters: configures
crates/voi_core/src/session.rs - Engine session → Demand calendar: uses profile
crates/voi_core/src/session.rs - Daily physics → Model parameters: reads parameters
crates/voi_core/src/physics.rs - Daily physics → Demand calendar: reads profile
crates/voi_core/src/physics.rs - Daily physics → Random streams: draws randomness
crates/voi_core/src/physics.rs - Model parameters → Arrival freshness: selects corridor
crates/voi_core/src/params.rs - Engine session → Particle filter: maintains beliefs
crates/voi_core/src/session.rs - Engine session → Ordering policies: dispatches actions
- Ordering policies → Particle filter: reads beliefs
src/blueberries_voi/controller/session_loop.py - Ordering policies → Episode simulation: steps engine
src/blueberries_voi/controller/session_loop.py - Episode simulation → Profit metrics: scores days
src/blueberries_voi/controller/session_loop.py - Batch studies → Episode simulation: evaluates episodes
src/blueberries_voi/experiments/voi_profit.py - Batch studies → Particle filter: evaluates beliefs
src/blueberries_voi/experiments/voi_profit.py - Batch studies → VOI analysis: measures value
- Python engine API → Engine session: provides native access
README.md - Observation contract → Particle filter: defines observations