How unrealone1-sys/project-oceansentinel works
OceanSentinel turns live maritime sensor feeds into fused vessel tracks, alerts, and a map/API; Project Icarus adds a separate aircraft-tracking domain. The documented maritime path runs from feed ingestion through fusion and live state to the UI, with optional Global Fishing Watch enrichment. The source index and excerpts support the principal module relationships; several routes and startup details are unsampled, so those links are omitted where not documented.
Main entry points: ingest.rs Ingest router · server.rs HTTP and WebSocket server · fusion.rs Track fusion and alerts · mod.rs Feed manager
Components 26
Sensor inputs
- Feed manager
src/sources/mod.rs - TCP and UDP feeds
src/sources/nmea_tcp.rs - AISStream client
src/sources/aisstream.rs - Traffic simulator
src/sources/simulator.rs
Maritime tracking
- Ingest router
src/sources/ingest.rs - NMEA parsing
src/nmea.rs - AIS decoding
src/ais.rs - Track fusion and alerts
src/fusion.rs - Geospatial helpers
src/geo.rs - Land boundaries
src/land.rs
State and enrichment
- Live track store
src/store.rs - File persistence
src/persist.rs - Fishing enrichment
src/gfw.rs - Alert delivery
src/notify.rs - Runtime configuration
src/config.rs
Project Icarus
- ADS-B polling
src/adsb.rs - Aircraft tracking and alerts
src/icarus.rs
API and map
- HTTP and WebSocket server
src/server.rs - Maritime map
ui/app.js - Icarus map
ui/icarus.js
Other components
- AIS radio
- Sonar and LiDAR
- AISStream
- ADS-B network
- Global Fishing Watch
- Operators
Connections 30
- Operators → HTTP and WebSocket server: uses API and map
README.md - AIS radio → TCP and UDP feeds: sends NMEA
README.md - Sonar and LiDAR → TCP and UDP feeds: sends NMEA or JSON
README.md - AISStream → AISStream client: streams AIS
README.md - ADS-B network → ADS-B polling: provides aircraft data
src/adsb.rs - Feed manager → TCP and UDP feeds: starts feeds
src/sources/mod.rs - Feed manager → AISStream client: starts feed
src/sources/mod.rs - Feed manager → Traffic simulator: starts simulator
src/sources/mod.rs - TCP and UDP feeds → Ingest router: routes feed data
src/sources/nmea_tcp.rs - AISStream client → Ingest router: emits feed events
src/sources/aisstream.rs - Traffic simulator → Ingest router: uses shared ingest path
src/sources/simulator.rs - Ingest router → NMEA parsing: parses sentences
src/sources/ingest.rs - Ingest router → AIS decoding: assembles and decodes AIS
src/sources/ingest.rs - Ingest router → Track fusion and alerts: emits sensor events
src/sources/ingest.rs - Track fusion and alerts → Live track store: updates tracks
src/fusion.rs - Track fusion and alerts → Geospatial helpers: uses distance calculations
src/fusion.rs - Live track store → File persistence: loads saved zones and lists
src/store.rs - Live track store → HTTP and WebSocket server: provides live state
src/server.rs - HTTP and WebSocket server → Fishing enrichment: requests enrichment
src/server.rs - Fishing enrichment → Global Fishing Watch: fetches registry data
README.md - HTTP and WebSocket server → Maritime map: serves embedded UI and live feed
src/server.rs - HTTP and WebSocket server → Icarus map: serves Icarus UI
README.md - ADS-B polling → Aircraft tracking and alerts: supplies aircraft updates
src/icarus.rs - Aircraft tracking and alerts → HTTP and WebSocket server: serves aircraft state
src/server.rs - Runtime configuration → Feed manager: configures feeds
src/sources/mod.rs - Runtime configuration → Fishing enrichment: configures service
src/gfw.rs - Runtime configuration → ADS-B polling: configures polling
src/adsb.rs - Alert delivery → File persistence: records alerts
src/notify.rs - Track fusion and alerts → Alert delivery: dispatches alerts
- Land boundaries → Geospatial helpers: uses polygon checks
src/land.rs