How codeplus076-max/sss-image works
SIH26057 is a side-scan sonar marine-intelligence workstation: analysts submit sonar imagery, review quality and anomaly results, anchor surveys geographically, and produce operational reports. The documented backend flow validates acoustic imagery, runs registered detectors, normalizes and prioritizes detections, then persists analysis records and evidence. The frontend also supports batch triage, survey history, GIS review, model and health information, and report export. Edges reflect README workflow statements or SOURCE INDEX references; analysis-route internals and several frontend view behaviors were not sampled, so those links are documented or omitted rather than inferred.
Main entry points: App.jsx Application Shell · analysis.py Analysis API · analysis_service.py Survey Analysis · api.js API Client
Components 27
Analyst Workstation
- Application Shell
frontend/src/App.jsx - Image Ingest
frontend/src/components/views/SonarIngestView.jsx - Quality Review
frontend/src/components/views/SonarQualityView.jsx - Batch Triage
frontend/src/components/views/BatchTriageView.jsx - Detection Review
frontend/src/components/views/DetectionsView.jsx - Survey Workspace
frontend/src/components/views/WorkspaceView.jsx - Marine GIS Map
frontend/src/components/gis/MarineGisMap.jsx - Survey Reports
frontend/src/components/views/ReportView.jsx - Report Builders
frontend/src/data/reportData.js - API Client
frontend/src/services/api.js
Analysis Pipeline
- Survey Analysis
backend/app/services/analysis_service.py - Sonar Quality Gate
backend/app/services/sonar_image_validator.py - Image Preprocessing
backend/app/services/preprocessing_service.py - Detection Normalizer
backend/app/services/detection_normalizer.py
Model Execution
- Model Registry
backend/app/core/model_registry.py - Multi-Model Inference
backend/app/services/inference.py - Model Loader
backend/app/services/model_loader.py
Evidence & Records
- Analysis Persistence
backend/app/services/analysis_persistence_service.py - Evidence Storage
backend/app/services/storage_service.py - Analysis Repository
backend/app/repositories/analysis_repository.py - SQL Database
backend/app/db/session.py
API Platform
- Analysis API
backend/app/api/v1/routes/analysis.py - Health Endpoint
backend/app/api/v1/routes/health.py - Models Endpoint
backend/app/api/v1/routes/models.py - FastAPI Application
backend/app/main.py
Other components
- Sonar Analyst
- Supabase Storage
Connections 32
- Sonar Analyst → Application Shell: uses
- Application Shell → Image Ingest: renders
frontend/src/App.jsx - Application Shell → Quality Review: renders
frontend/src/App.jsx - Application Shell → Batch Triage: renders
frontend/src/App.jsx - Application Shell → Detection Review: renders
frontend/src/App.jsx - Application Shell → Survey Workspace: renders
frontend/src/App.jsx - Application Shell → Survey Reports: renders
frontend/src/App.jsx - Survey Workspace → Marine GIS Map: renders
frontend/src/components/views/WorkspaceView.jsx - Survey Reports → Report Builders: uses
frontend/src/components/views/ReportView.jsx - Application Shell → API Client: calls
frontend/src/App.jsx - Image Ingest → API Client: submits imagery
- API Client → Analysis API: requests analysis
README.md - Analysis API → Sonar Quality Gate: validates imagery
README.md - Analysis API → Survey Analysis: runs analysis
- Survey Analysis → Image Preprocessing: preprocesses
backend/app/services/analysis_service.py - Survey Analysis → Multi-Model Inference: executes models
backend/app/services/analysis_service.py - Survey Analysis → Detection Normalizer: normalizes detections
README.md - Survey Analysis → Model Registry: resolves models
backend/app/services/analysis_service.py - Multi-Model Inference → Model Loader: loads models
backend/app/services/inference.py - Model Loader → Model Registry: reads definitions
backend/app/services/model_loader.py - Analysis API → Analysis Persistence: persists results
- Analysis Persistence → Evidence Storage: stores evidence
backend/app/services/analysis_persistence_service.py - Analysis Persistence → Analysis Repository: saves records
backend/app/services/analysis_persistence_service.py - Analysis Repository → SQL Database: writes records
backend/app/repositories/analysis_repository.py - Evidence Storage → Supabase Storage: uploads optionally
backend/app/services/storage_service.py - FastAPI Application → Analysis API: registers routes
backend/app/main.py - FastAPI Application → Health Endpoint: registers routes
- FastAPI Application → Models Endpoint: registers routes
- API Client → Health Endpoint: checks health
- API Client → Models Endpoint: lists models
- Analysis API → Detection Review: returns results
- Analysis API → Survey Workspace: serves survey history