How mithilesh-24/oceanproject works
BlueSphere is an oceanographic digital-twin and intelligence platform. Scientists and operators use its web workspaces to explore ocean observations and model fields, run time-aware visualization and scientific comparisons, and access derived analysis; results can also be saved or exported. The React client routes users to specialized views and calls a FastAPI scientific backend, while a separate Express service handles authentication. The README documents broader capabilities than the sampled code establishes; those branches are retained with documented relationships, and unsampled implementation details are not inferred.
Main entry points: main.py FastAPI router · App.tsx Workspace router · apiClient.ts REST API client · OceanExplorerView.tsx 3D Ocean Explorer
Components 23
Web Workstation
- Workspace router
frontend/src/App.tsx - 3D Ocean Explorer
frontend/src/views/OceanExplorerView.tsx - Model comparison
frontend/src/views/ComparisonView.tsx - 4D time machine
frontend/src/views/FourDView.tsx - Model validation
frontend/src/views/AccuracyView.tsx - REST API client
frontend/src/services/apiClient.ts - Globe controller
frontend/src/controllers/cesiumController.ts
Scientific API
- FastAPI router
backend/app/main.py
Data and Ingestion
- Observation services
backend/app/services/observation_providers/unified_service.py - Glider provider
backend/app/services/observation_providers/glider_provider.py - Observation records
backend/app/models/observation.py - Database sessions
backend/app/db/session.py - Ingestion pipelines
backend/app/api/v1/endpoints/pipelines.py
Analysis and Copilot
- Comparison engine
backend/app/services/comparison_engine.py - Ocean metrics
backend/app/services/ocean_math.py - Research analysis
backend/app/services/research_engine.py - Spatiotemporal analysis
backend/app/services/spatiotemporal_engine.py - Agentic copilot
backend/app/services/copilot_engine.py
Identity Service
- Authentication routes
backend/app/api/v1/endpoints/auth.py - Express auth service
databasecon/server.js
Other components
- Scientist or operator
- Neon PostgreSQL
- Satellite and Copernicus feeds
Connections 28
- Scientist or operator → Workspace router: opens workspace
README.md - Workspace router → 3D Ocean Explorer: routes to
frontend/src/App.tsx - Workspace router → Model comparison: routes to
frontend/src/App.tsx - Workspace router → 4D time machine: routes to
frontend/src/App.tsx - Workspace router → Model validation: routes to
frontend/src/App.tsx - 3D Ocean Explorer → REST API client: requests data
- Model comparison → REST API client: requests analysis
- 4D time machine → REST API client: requests snapshots
- REST API client → FastAPI router: calls REST API
frontend/src/services/apiClient.ts - FastAPI router → Observation services: serves observations
- Observation services → Glider provider: uses provider
backend/app/services/observation_providers/unified_service.py - Observation services → Observation records: reads records
backend/app/services/observation_providers/unified_service.py - Comparison engine → Observation records: reads records
backend/app/services/comparison_engine.py - Comparison engine → Ocean metrics: computes metrics
backend/app/services/comparison_engine.py - FastAPI router → Comparison engine: serves comparison
- FastAPI router → Spatiotemporal analysis: serves time analysis
- FastAPI router → Research analysis: serves research
- FastAPI router → Agentic copilot: serves copilot
- FastAPI router → Ingestion pipelines: registers routes
backend/app/main.py - Ingestion pipelines → Database sessions: queries session
backend/app/api/v1/endpoints/pipelines.py - Ingestion pipelines → Observation records: updates pipeline rows
- Database sessions → Neon PostgreSQL: connects or falls back
backend/app/db/session.py - FastAPI router → Satellite and Copernicus feeds: integrates feeds
README.md - FastAPI router → Authentication routes: registers routes
backend/app/main.py - Authentication routes → Database sessions: uses session
backend/app/api/v1/endpoints/auth.py - Scientist or operator → Express auth service: authenticates
databasecon/server.js - Express auth service → Neon PostgreSQL: queries users
- 3D Ocean Explorer → Globe controller: controls globe