How shruthiofficial29-creator/polarisai works
POLARIS is an offline-first Antarctic navigation decision-support prototype using deterministic demo models. Its main workflow is mission analysis: the navigator selects a destination and priority, mission state requests candidate routes, and the console presents risk, forecast, and route comparisons. During simulation, changing conditions can trigger a reroute proposal for operator adoption. The map, iceberg intelligence, sea-ice forecast, assistant, and analytics are distinct product capabilities. Source excerpts show the core orchestration and model calls; some page wiring is supported only by the SOURCE INDEX or README. The optional backend is documented as a future integration, not a required runtime dependency.
Main entry points: useMission.tsx Mission state · riskService.ts Risk assessment · App.tsx App shell · AntarcticMap.tsx Antarctic map
Components 30
Navigation console
- App shell
src/App.tsx - Dashboard
src/pages/Dashboard.tsx - Antarctic map
src/components/map/AntarcticMap.tsx - Mission planner
src/components/panels/MissionPlanner.tsx
Mission workflow
- Mission state
src/state/useMission.tsx - Route planner
src/pages/RoutePlanner.tsx - Route optimizer
src/services/routeOptimizationService.ts - Route comparison
src/components/panels/RouteComparison.tsx - Route rationale
src/components/panels/WhyThisRoute.tsx - Simulation
src/pages/Simulation.tsx - Simulation controls
src/components/panels/SimulationControls.tsx - Reroute review
src/components/panels/RouteUpdateModal.tsx
Demo models
- Risk assessment
src/services/riskService.ts - Environment snapshot
src/services/environment.ts - Sea-ice forecast
src/services/seaIceForecastService.ts - Weather model
src/services/weatherService.ts - Iceberg trajectories
src/services/icebergTrajectoryService.ts - Geospatial utilities
src/services/geo.ts - Alert generation
src/services/alertService.ts - Scenario data
src/data/scenario.ts - Iceberg data
src/data/icebergs.ts
Intelligence tools
- Iceberg intelligence
src/pages/IcebergIntelligence.tsx - Iceberg details
src/components/panels/IcebergPanel.tsx - Sea-ice forecast page
src/pages/SeaIceForecast.tsx - Analytics
src/pages/Analytics.tsx - POLARIS assistant
src/components/assistant/PolarisAssistant.tsx - Assistant responses
src/services/assistantService.ts
Optional backend
- Optional FastAPI backend
backend/main.py - Backend schemas
backend/schemas.py
Other components
- Vessel navigator
Connections 48
- Vessel navigator → App shell: opens console
README.md - App shell → Mission state: provides state
src/App.tsx - App shell → Dashboard: routes to
src/App.tsx - App shell → Route planner: routes to
src/App.tsx - App shell → Simulation: routes to
src/App.tsx - App shell → Sea-ice forecast page: routes to
src/App.tsx - App shell → Iceberg intelligence: routes to
src/App.tsx - App shell → Analytics: routes to
src/App.tsx - Dashboard → Antarctic map: renders
src/pages/Dashboard.tsx - Dashboard → Mission planner: renders
src/pages/Dashboard.tsx - Dashboard → POLARIS assistant: renders
src/pages/Dashboard.tsx - Mission planner → Mission state: uses mission state
- Mission state → Route optimizer: requests routes
src/state/useMission.tsx - Mission state → Risk assessment: checks risk
src/state/useMission.tsx - Mission state → Alert generation: generates alerts
src/state/useMission.tsx - Mission state → Sea-ice forecast: requests forecast
src/state/useMission.tsx - Mission state → Simulation: drives mission state
src/pages/Simulation.tsx - Simulation → Simulation controls: renders
src/pages/Simulation.tsx - Simulation → Reroute review: renders
src/pages/Simulation.tsx - Simulation controls → Mission state: controls simulation
src/components/panels/SimulationControls.tsx - Route optimizer → Risk assessment: scores routes
src/services/routeOptimizationService.ts - Route optimizer → Sea-ice forecast: samples ice
src/services/routeOptimizationService.ts - Route optimizer → Iceberg trajectories: samples tracks
src/services/routeOptimizationService.ts - Route optimizer → Weather model: samples weather
src/services/routeOptimizationService.ts - Route optimizer → Geospatial utilities: measures distance
src/services/routeOptimizationService.ts - Risk assessment → Sea-ice forecast: reads concentration
src/services/riskService.ts - Risk assessment → Iceberg trajectories: reads positions
src/services/riskService.ts - Risk assessment → Weather model: reads conditions
src/services/riskService.ts - Risk assessment → Geospatial utilities: measures proximity
src/services/riskService.ts - Risk assessment → Iceberg data: assesses hazards
src/services/riskService.ts - Iceberg trajectories → Geospatial utilities: projects positions
src/services/icebergTrajectoryService.ts - Sea-ice forecast page → Antarctic map: renders map
src/pages/SeaIceForecast.tsx - Sea-ice forecast page → Mission state: reads mission state
src/pages/SeaIceForecast.tsx - Iceberg intelligence → Iceberg details: renders details
src/pages/IcebergIntelligence.tsx - Iceberg intelligence → Antarctic map: renders map
src/pages/IcebergIntelligence.tsx - Iceberg intelligence → Iceberg trajectories: shows trajectories
src/pages/IcebergIntelligence.tsx - Iceberg details → Iceberg data: reads iceberg data
src/components/panels/IcebergPanel.tsx - Iceberg details → Iceberg trajectories: shows trajectory
src/components/panels/IcebergPanel.tsx - POLARIS assistant → Assistant responses: requests answers
src/components/assistant/PolarisAssistant.tsx - Assistant responses → Risk assessment: uses risk results
src/services/assistantService.ts - Assistant responses → Iceberg trajectories: uses trajectories
src/services/assistantService.ts - Antarctic map → Sea-ice forecast: draws ice layers
src/components/map/AntarcticMap.tsx - Antarctic map → Weather model: draws conditions
src/components/map/AntarcticMap.tsx - Antarctic map → Risk assessment: draws risk
src/components/map/AntarcticMap.tsx - Antarctic map → Iceberg trajectories: draws tracks
src/components/map/AntarcticMap.tsx - Sea-ice forecast → Scenario data: reads time steps
src/services/seaIceForecastService.ts - Vessel navigator → Optional FastAPI backend: may connect
README.md - Optional FastAPI backend → Backend schemas: uses schemas
backend/main.py