radarsargasses/docs/roadmap.md

ROADMAP — Sargasse-Sentry

Checklist permanente d'avancement projet. Mettre à jour au fil des implémentations.

---

Légende

• À faire
• [~] En cours
• Terminé

---

Phase 0 — Fondations

Infrastructure & environnement

• Initialisation dépôt Git (bare repo VPS + hook post-receive)
• Configuration Docker (FrankenPHP + PostgreSQL/PostGIS + Redis)
• Configuration Traefik (domaine radarsargasses971.com, SSL Let's Encrypt)
• Variables d'environnement (.env.example)
• Initialisation projet Symfony (symfony new backend)
• Installation API Platform
• Initialisation projet React (npm create vite@latest frontend)
• Configuration MapLibre GL JS + react-map-gl

Base de données

• Extension PostGIS activée (dans la migration)
• Migration : SargassumObservation
• Migration : SargassumForecast
• Migration : DataIngestionJob
• Migration : CoastalPoint
• Migration : ImpactScore
• Migration : UserFeedback
• Index spatiaux (GIST) + index BTREE définis

---

Phase 1 — MVP (Antilles, observations uniquement)

Pipeline d'ingestion

• Cron VPS (docker exec toutes les 3h) → app:ingest-sentinel
• Appel API Sentinel Hub (bandes B04, B08, B11 via evalscript)
• Création DataIngestionJob (pending → success/failed)
• Retry automatique + logging erreurs
• Filtrage nuages via Catalog API (seuil 60%, configurable)
• Calcul AFAI dans evalscript Sentinel Hub (formule complète)
• Rasterisation → raster UINT8 binaire (evalscript cloud-side)
• Vectorisation GDAL (gdal_polygonize.py) + simplification PostGIS
• Persistance SargassumObservation
• Génération vector tiles (Tippecanoe → .pbf)

API Backend

• GET /api/spots — liste CoastalPoints (API Platform)
• GET /api/spots/{id} — détail (API Platform)
• GET /api/spots/{id}/score — score + niveau + trend
• GET /api/observations?bbox=&date=&source= — PostGIS ST_Intersects
• GET /api/observations/{id} — détail avec geometry GeoJSON
• GET /api/forecasts — API Platform
• POST /api/feedback — feedback anonyme (IP hachée)

Frontend React

• Carte de base (MapLibre GL JS)
• Affichage vector tiles observations
• Sélection d'un CoastalPoint (Spot Mode)
• Affichage polygones observés

Données initiales

• Seed CoastalPoint zone Antilles (plages, ports, spots surf, zones pêche)

---

Phase 2 — Dérive & Score

Pipeline — simulation de dérive

• Accès NOAA GRIB (vent + courant)
• Échantillonnage polygone (centroids + random sampling)
• Application vecteur dérive par point
• Reconstruction polygone (convex hull / alpha shape)
• Génération horizons H+6, H+12, H+24, H+48
• Persistance SargassumForecast
• Génération vector tiles prédictions (Tippecanoe)

Calcul ImpactScore

• Calcul score par CoastalPoint (distance, densité, vitesse d'approche, tendance)
• Persistance ImpactScore
• Mise en cache Redis (TTL 3h)

API Backend

• GET /api/spots/{id}/score — score courant + horizons
• GET /api/spots/{id}/score?at={datetime} — score à un instant
• GET /api/forecasts?observationId= — prédictions par observation
• GET /api/forecasts?bbox=&horizon= — prédictions par zone + horizon

Frontend React

• Spot Mode complet (OK / Risque / Impact par horizon)
• Slider temporel (Now → +6h → +12h → +24h → +48h)
• Mise à jour dynamique polygones + score sur slider
• Gradients radiaux densité
• Animation légère sur polygones de prédiction
• Vue mobile optimisée

---

Phase 3 — Feedback & Alertes

Boucle d'apprentissage

• Bouton "Je confirme présence de sargasses"
• POST /api/feedback — persistance UserFeedback anonyme
• Intégration feedback dans calcul score (pondération)

Alertes push

• Définir modalité d'inscription légère (push token navigateur ou email)
• Système d'abonnement par CoastalPoint
• Worker Symfony — envoi alertes si score dépasse seuil
• Interface d'inscription (friction minimale)

---

Transversal (continu)

• Rate limiting endpoints publics
• Monitoring pipeline (alertes si ingestion échoue > N fois)
• Logs structurés
• Fallback Sentinel-2 → Sentinel-3
• Configuration Cloudflare free tier (cache tiles statiques)
• Tests fonctionnels pipeline (ingestion → score)