How zaheerk19n/floatchat-aquaminds works
FloatChat presents oceanographic data through a React interface and a FastAPI backend: users explore dashboards, ask questions, and view reports, while backend endpoints query profiles, authenticate users, search profile context, and serve analytics and alerts. The README also describes forecasting, explainable AI, voice, and export formats; these are represented as product capabilities, not asserted implementation details where source evidence is unavailable. The excerpts establish router registration, selected database operations, NetCDF ingestion, and RAG behavior; other links are limited to explicit README statements.
Main entry points: main.py FastAPI router · App.tsx Web app routes · models.py Ocean records · database.py Database sessions
Components 22
User interface
- Web app routes
oceanai-frontend/src/App.tsx - Home exploration
oceanai-frontend/src/pages/Home.tsx - Ocean dashboard
oceanai-frontend/src/pages/Dashboard.tsx - Chat interface
oceanai-frontend/src/pages/Chat.tsx - Analytics views
oceanai-frontend/src/pages/Analytics.tsx - Report interface
oceanai-frontend/src/pages/Reports.tsx
API and identity
- FastAPI router
backend/app/main.py - Account access
backend/app/routers/auth.py - Token security
backend/app/security.py - Profile queries
backend/app/routers/profiles.py - Analytics endpoint
backend/app/routers/analytics.py - Anomaly alerts
backend/app/routers/alerts.py - Chat endpoint
backend/app/routers/chat.py - Report endpoint
backend/app/routers/reports.py
Ocean data
- Ocean records
backend/app/models.py - Database sessions
backend/app/database.py - NetCDF ingestion
backend/app/services/ingestion.py
AI and outputs
- Semantic retrieval
backend/app/services/rag_service.py - Anomaly detection
backend/app/services/anomaly.py - PDF generation
backend/app/services/pdf_service.py
Other components
- Ocean data user
- Gemini model
Connections 34
- Ocean data user → Web app routes: uses
- Web app routes → Home exploration: routes to
oceanai-frontend/src/App.tsx - Web app routes → Ocean dashboard: routes to
oceanai-frontend/src/App.tsx - Web app routes → Chat interface: routes to
oceanai-frontend/src/App.tsx - Web app routes → Analytics views: routes to
oceanai-frontend/src/App.tsx - Web app routes → Report interface: routes to
oceanai-frontend/src/App.tsx - Web app routes → FastAPI router: requests data
- FastAPI router → Account access: registers
backend/app/main.py - FastAPI router → Chat endpoint: registers
backend/app/main.py - FastAPI router → Profile queries: registers
backend/app/main.py - FastAPI router → Analytics endpoint: registers
backend/app/main.py - FastAPI router → Report endpoint: registers
backend/app/main.py - FastAPI router → Anomaly alerts: registers
backend/app/main.py - FastAPI router → Ocean records: creates tables
backend/app/main.py - Account access → Database sessions: opens sessions
backend/app/routers/auth.py - Account access → Ocean records: reads and writes
backend/app/routers/auth.py - Account access → Token security: hashes credentials
backend/app/routers/auth.py - Profile queries → Database sessions: opens sessions
backend/app/routers/profiles.py - Profile queries → Ocean records: queries profiles
backend/app/routers/profiles.py - Analytics endpoint → Database sessions: uses sessions
backend/app/routers/analytics.py - Analytics endpoint → Ocean records: queries records
backend/app/routers/analytics.py - Anomaly alerts → Database sessions: uses sessions
backend/app/routers/alerts.py - Anomaly alerts → Ocean records: queries records
backend/app/routers/alerts.py - Anomaly alerts → Anomaly detection: checks anomalies
backend/app/routers/alerts.py - Chat endpoint → Semantic retrieval: answers queries
backend/app/routers/chat.py - Semantic retrieval → Database sessions: embeds queries
backend/app/services/rag_service.py - Semantic retrieval → Gemini model: generates answer
backend/app/services/rag_service.py - NetCDF ingestion → Database sessions: uses sessions
backend/app/services/ingestion.py - NetCDF ingestion → Ocean records: stores profiles
backend/app/services/ingestion.py - Report interface → PDF generation: exports PDF
- Report endpoint → PDF generation: generates report
backend/app/routers/reports.py - Ocean dashboard → Analytics views: explores trends
- Analytics views → Anomaly detection: shows anomalies
- Analytics views → Ocean records: visualizes ocean data