How kareemmas3ud/smart-oasis-cop31 works
Smart Oasis is a single-file Streamlit dashboard for simulating groundwater management in New Valley. The principal workflow is: a user adjusts environmental inputs, the app evaluates pump operation and impact metrics, updates simulated telemetry history and forecasts, then presents well status, a map, and system analytics. The README describes live telemetry, but the sampled source shows seeded and generated simulation data; no external telemetry service or persistent store is evidenced. Unsampled implementation details are represented only where the README documents a capability.
Main entry points: app.py Streamlit dashboard
Components 12
Controls and decisions
- Environmental controls
app.py - Pump decision
app.py
Simulation and metrics
- Impact metrics
app.py - Well nodes
app.py - Well status
app.py - Telemetry history
app.py - Forecast generation
app.py
Dashboard views
- Streamlit dashboard
app.py - Interactive GIS map
app.py - Charts and gauges
app.py - Impact metrics view
app.py
Other components
- Dashboard user
Connections 18
- Dashboard user → Environmental controls: sets inputs
- Environmental controls → Pump decision: provides thresholds
- Environmental controls → Impact metrics: provides inputs
- Pump decision → Impact metrics: informs calculations
- Well nodes → Well status: provides well data
- Pump decision → Well status: determines activity
- Environmental controls → Telemetry history: updates simulation
- Telemetry history → Forecast generation: supplies latest values
- Streamlit dashboard → Pump decision: evaluates operation
- Streamlit dashboard → Impact metrics: calculates impact
- Streamlit dashboard → Telemetry history: updates history
- Streamlit dashboard → Interactive GIS map: renders well map
- Streamlit dashboard → Charts and gauges: renders analytics
- Streamlit dashboard → Impact metrics view: renders impact
- Well status → Interactive GIS map: provides well status
- Telemetry history → Charts and gauges: provides time series
- Forecast generation → Charts and gauges: provides projections
- Impact metrics → Impact metrics view: provides calculated metrics