How ronny-dev01/deepsight works
SIH 2026 Marine Sonar MVP processes real side-scan sonar through ingestion, frame analysis, evidence fusion and tracking, then exposes findings for human review and reporting. The API and database anchor job intake and persistent results; a worker runs the analysis pipeline. The README documents geolocation when metadata exists and provenance requirements. Several UI and backend subsystems are represented from the tree and index, but their unsampled implementations and some runtime wiring cannot be verified, so those connections are omitted or marked unverified.
Main entry points: job_runner.py Job runner · pipeline.py Frame pipeline · client.ts API client · ingestion.py Ingestion routes
Components 22
Operator interface
- Workspace UI
frontend/src/App.tsx - Job detail
frontend/src/components/JobDetail.tsx - Operational map
frontend/src/components/OperationalMap.tsx - Upload panel
frontend/src/components/UploadPanel.tsx - API client
frontend/src/api/client.ts
API and ingestion
- HTTP API
services/api/main.py - Ingestion routes
services/api/routes/ingestion.py - Upload validation
services/api/services/ingestion.py
Sonar processing
- Job worker
services/worker/worker.py - Job runner
services/worker/job_runner.py - Frame pipeline
services/worker/pipeline.py - Image quality
ml/quality/assessor.py - Object detector
ml/inference/detector.py - Acoustic evidence
ml/evidence/extractor.py - Evidence fusion
ml/evidence/fusion.py - Frame tracking
ml/tracking/tracker.py
Jobs and records
- Authoritative database
services/api/db.py - Domain records
services/api/models/domain.py
Review and reporting
- Review routes
services/api/routes/review.py - Report routes
services/api/routes/report.py - Reports
services/api/schemas/report.py
Other components
- Operator
Connections 28
- Operator → Workspace UI: uses
frontend/src/App.tsx - Workspace UI → Upload panel: presents
- Job detail → API client: requests data
frontend/src/components/JobDetail.tsx - Job detail → Operational map: renders
frontend/src/components/JobDetail.tsx - Upload panel → API client: submits job
- API client → Ingestion routes: HTTP requests
frontend/src/api/client.ts - API client → Review routes: HTTP requests
frontend/src/api/client.ts - API client → Report routes: HTTP requests
frontend/src/api/client.ts - HTTP API → Ingestion routes: registers
services/api/main.py - HTTP API → Review routes: registers
services/api/main.py - HTTP API → Report routes: registers
services/api/main.py - Ingestion routes → Upload validation: validates uploads
services/api/routes/ingestion.py - Ingestion routes → Authoritative database: writes job data
services/api/routes/ingestion.py - Ingestion routes → Domain records: creates records
services/api/routes/ingestion.py - Job worker → Job runner: runs jobs
services/worker/worker.py - Job runner → Frame pipeline: processes frames
services/worker/job_runner.py - Frame pipeline → Image quality: assesses image
services/worker/pipeline.py - Frame pipeline → Object detector: predicts objects
services/worker/pipeline.py - Frame pipeline → Acoustic evidence: extracts evidence
services/worker/pipeline.py - Frame pipeline → Evidence fusion: fuses scores
services/worker/pipeline.py - Job runner → Frame tracking: tracks frames
- Job runner → Authoritative database: persists results
services/worker/job_runner.py - Job runner → Domain records: uses records
services/worker/job_runner.py - Review routes → Authoritative database: reads and updates
services/api/routes/review.py - Review routes → Domain records: queries findings
services/api/routes/review.py - Report routes → Authoritative database: reads results
services/api/routes/report.py - Report routes → Domain records: queries records
services/api/routes/report.py - Report routes → Reports: formats response
services/api/routes/report.py