How rishu07368/basinwatch works
BasinWatch is an offline desktop floodplain operations simulation. Operators advance or observe a scenario, review zone risk and resources, dispatch response missions, follow progress, and save or report on the session. The documented runtime separates sensor production, intake, buffered event processing, and model updates; immutable snapshots return to the Swing interface. File-based session, archive, journal, and report capabilities remain independent of optional SQLite history. The graph preserves README capabilities, but some subsystem links are documented rather than confirmed in sampled implementation excerpts.
Main entry points: BasinEngine.java Engine lifecycle · MainFrame.java Swing console · BasinModel.java Basin model · domain Domain snapshots and events
Components 22
Operator interface
- Swing console
src/main/java/com/basinwatch/app/MainFrame.java - Basin map
src/main/java/com/basinwatch/app/BasinMapPanel.java - History viewer
src/main/java/com/basinwatch/app/DatabaseHistoryPanel.java - Architecture inspector
src/main/java/com/basinwatch/learning/LearningCatalog.java
Simulation runtime
- Engine lifecycle
src/main/java/com/basinwatch/engine/BasinEngine.java - Sensor feed
src/main/java/com/basinwatch/engine/SensorFeed.java - Sensor intake
src/main/java/com/basinwatch/engine/SensorIntake.java - Event buffer
src/main/java/com/basinwatch/engine/EventBuffer.java - Response workers
src/main/java/com/basinwatch/engine/BasinEngine.java - Archive worker
src/main/java/com/basinwatch/engine/ArchiveWorker.java
Basin operations
- Basin model
src/main/java/com/basinwatch/domain/BasinModel.java - Domain snapshots and events
src/main/java/com/basinwatch/domain - Resource allocator
src/main/java/com/basinwatch/domain/ResourceAllocator.java
Persistence and history
- Session saves
src/main/java/com/basinwatch/io/SnapshotStore.java - Save catalog
src/main/java/com/basinwatch/io/SaveCatalog.java - Sensor archive
src/main/java/com/basinwatch/io/SensorArchive.java - Operational journal
src/main/java/com/basinwatch/io/OperationalJournal.java - Operational reports
src/main/java/com/basinwatch/io/ReportWriter.java - SQLite history service
src/main/java/com/basinwatch/db/DatabaseService.java - SQLite connection manager
src/main/java/com/basinwatch/db/DatabaseManager.java - History repositories
src/main/java/com/basinwatch/db
Other components
- Operator
Connections 23
- Operator → Swing console: operates
README.md - Swing console → Engine lifecycle: controls
src/main/java/com/basinwatch/app/MainFrame.java - Swing console → Basin map: updates view
src/main/java/com/basinwatch/app/MainFrame.java - Engine lifecycle → Sensor feed: starts feed
README.md - Sensor feed → Sensor intake: pipes observations
README.md - Sensor intake → Event buffer: queues events
README.md - Event buffer → Response workers: supplies work
README.md - Response workers → Basin model: processes events
src/main/java/com/basinwatch/engine/BasinEngine.java - Basin model → Resource allocator: reserves resources
src/main/java/com/basinwatch/domain/BasinModel.java - Basin model → Domain snapshots and events: produces snapshots
src/main/java/com/basinwatch/domain/BasinModel.java - Engine lifecycle → Domain snapshots and events: publishes snapshots
README.md - Domain snapshots and events → Basin map: renders basin state
README.md - Engine lifecycle → Archive worker: archives readings
src/main/java/com/basinwatch/engine/BasinEngine.java - Archive worker → Sensor archive: writes measurements
src/main/java/com/basinwatch/engine/ArchiveWorker.java - Engine lifecycle → Operational journal: records events
src/main/java/com/basinwatch/engine/BasinEngine.java - Swing console → Session saves: saves sessions
README.md - Swing console → Save catalog: lists saves
src/main/java/com/basinwatch/app/MainFrame.java - Engine lifecycle → Operational reports: generates reports
README.md - Engine lifecycle → SQLite history service: records history
src/main/java/com/basinwatch/engine/BasinEngine.java - History viewer → Engine lifecycle: requests history
src/main/java/com/basinwatch/app/DatabaseHistoryPanel.java - SQLite history service → History repositories: dispatches queries
src/main/java/com/basinwatch/db/DatabaseService.java - History repositories → SQLite connection manager: opens connections
src/main/java/com/basinwatch/db/SensorReadingRepository.java - Swing console → Architecture inspector: shows inspector
src/main/java/com/basinwatch/app/MainFrame.java