How nikita07arya-cloud/blue-trace works
This is an oil-spill response coordination platform. The documented workflow is agency task assignment, worker progress updates, and dashboard status monitoring; the sampled backend also exposes spill reporting and task proof/payment lifecycle operations. The graph shows the FastAPI routing, ORM models, and SQLite persistence layer. README capabilities such as JWT/OAuth2 are not represented as implemented components because no supporting source was shown; detection integration is explicitly future scope. Frontend-to-API wiring was not established by the excerpts.
Main entry points: app.py FastAPI App · connection.py ORM Base · stats.py Response Statistics · spill.py Spill Records
Components 13
Web Interface
- Dashboard
frontend/frontend/css/js/dashboard.js - Spill Map
frontend/frontend/css/js/map.js - Task Listing
frontend/frontend/css/js/tasks.js
API Workflows
- FastAPI App
frontend/app.py - Spill Reporting
frontend/routes/spills.py - Task Operations
frontend/routes/tasks.py - Response Statistics
frontend/routes/stats.py
Response Domain
- Spill Records
frontend/models/spill.py - Task Lifecycle
frontend/models/task.py
Persistence
- ORM Base
frontend/database/connection.py - SQLite Database
frontend/database/connection.py
Other components
- Agency & Workers
- Detection APIs
Connections 19
- Agency & Workers → FastAPI App: use platform
README.md - FastAPI App → Spill Reporting: registers router
frontend/app.py - FastAPI App → Task Operations: registers router
frontend/app.py - FastAPI App → Response Statistics: registers router
frontend/app.py - FastAPI App → Dashboard: serves frontend
frontend/app.py - Spill Reporting → ORM Base: gets sessions
frontend/routes/spills.py - Spill Reporting → Spill Records: queries and updates
frontend/routes/spills.py - Task Operations → ORM Base: gets sessions
frontend/routes/tasks.py - Task Operations → Task Lifecycle: manages lifecycle
frontend/routes/tasks.py - Response Statistics → ORM Base: gets sessions
frontend/routes/stats.py - Response Statistics → Spill Records: aggregates spill data
frontend/routes/stats.py - Response Statistics → Task Lifecycle: aggregates task data
frontend/routes/stats.py - Spill Records → ORM Base: uses declarative base
frontend/models/spill.py - Task Lifecycle → ORM Base: uses declarative base
frontend/models/task.py - Spill Records → Task Lifecycle: relates spill tasks
frontend/models/spill.py - Task Lifecycle → Spill Records: references spill
frontend/models/task.py - ORM Base → SQLite Database: configures connection
frontend/database/connection.py - Dashboard → Response Statistics: reflects status
README.md - Detection APIs → FastAPI App: future integration
README.md