How defiaudit0x/wildfire-observatory works
This repository is a community-driven wildfire and disaster early-warning platform, with a React web client, Express API, and a native Android application. The main workflow is citizens viewing reports and satellite hotspots, submitting geolocated reports or SOS alerts, then operators reviewing reports and coordinating teams. The graph preserves documented AI, satellite, consensus, mapping, risk, history/export, proximity, and mesh capabilities. Edge evidence is limited to README statements and shown source/index references; unsampled implementation links are omitted or marked unverified.
Main entry points: reports.ts Report and SOS API · useObservatoryPoll.ts Data Polling · server.ts HTTP Server · satellite.ts Satellite Feed
Components 22
Citizen Web
- Web App
src/App.tsx - Live Map
src/components/InteractiveMap.tsx - Report Form
src/components/ReportForm.tsx - SOS Alerts
src/components/TrappedSOSModal.tsx - Data Polling
src/hooks/observatory/useObservatoryPoll.ts - Report Submission
src/hooks/observatory/useReportSubmission.ts - Threat Proximity
src/utils/threats.ts
API and Data
- Report and SOS API
server/routes/reports.ts - Satellite Feed
server/routes/satellite.ts - AI Verification
server/routes/ai.ts - Fire Risk
server/routes/wilayas.ts - Persistence
server/fs.ts - HTTP Server
server/server.ts
Response Operations
- Admin Moderation
src/components/AdminPanel.tsx - Staff Management
src/components/admin/StaffManager.tsx - Command Center
src/components/CentralCommand.tsx - Teams and Roster
server/routes/teams.ts - History and Export
server/routes/history.ts
Android Mesh
- Android Client
android/app/src/main/java/com/observatory/wildfire/NativeMainActivity.kt - Peer Mesh
android/app/src/main/java/com/observatory/wildfire/MeshService.kt - Mesh Cryptography
android/app/src/main/java/com/observatory/wildfire/CryptoEngine.kt
Other components
- Citizen
Connections 25
- Citizen → Web App: uses
README.md - Web App → Data Polling: polls data
src/App.tsx - Web App → Threat Proximity: finds threats
src/App.tsx - Data Polling → Report and SOS API: fetches reports
src/hooks/observatory/useObservatoryPoll.ts - Data Polling → Satellite Feed: fetches hotspots
src/hooks/observatory/useObservatoryPoll.ts - Data Polling → Fire Risk: fetches regions
src/hooks/observatory/useObservatoryPoll.ts - Report Form → Report Submission: submits reports
- Report Submission → Report and SOS API: posts reports
src/hooks/observatory/useReportSubmission.ts - SOS Alerts → Report and SOS API: sends SOS
- HTTP Server → Report and SOS API: routes requests
server/server.ts - HTTP Server → Satellite Feed: routes requests
server/server.ts - HTTP Server → AI Verification: routes requests
server/server.ts - Report and SOS API → Persistence: persists data
- Satellite Feed → Persistence: reads data
- AI Verification → Citizen: verifies images
README.md - Live Map → Satellite Feed: shows hotspots
README.md - Live Map → Report and SOS API: shows reports
README.md - Threat Proximity → Citizen: alerts nearby
README.md - Admin Moderation → Report and SOS API: moderates reports
README.md - Staff Management → HTTP Server: requests units
src/components/admin/StaffManager.tsx - Command Center → Teams and Roster: coordinates response
README.md - Report and SOS API → History and Export: provides records
README.md - Citizen → Android Client: uses
- Android Client → Peer Mesh: broadcasts offline
- Peer Mesh → Mesh Cryptography: uses keys
android/app/src/main/java/com/observatory/wildfire/MeshService.kt