gwadaking/radarsargasses
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
0c1deb93cb91947431edf1c37484e034b8d8caa7
radarsargasses/docs/roadmap.md
Gwadaking 0c1deb93cb Phase 1 : seed CoastalPoints + frontend React complet 
Backend :
- SeedCoastalPointsCommand : 29 points Antilles (idempotent)
  Martinique, Guadeloupe, Sainte-Lucie, Barbade, Saint-Martin

Frontend :
- api/client.js : wrapper fetch pour spots, observations, feedback
- SargassesMap : MapLibre GL JS, marqueurs spots, couche observations
  GeoJSON avec rechargement bbox dynamique à chaque mouvement carte
- SpotPanel : Spot Mode (score/niveau/distance/trend), bouton feedback
  terrain anonyme, gestion état loading/error/null
- App.jsx : composition map + panel, état selectedSpot
- vite.config.js : proxy /api → Symfony dev, build → backend/public/spa

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-04-01 03:17:43 -04:00

4.7 KiB
Raw Blame History

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) — différé Phase 2

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 + fond CARTO dark)
  • Affichage observations GeoJSON (bbox dynamique au mouvement)
  • Marqueurs CoastalPoints avec sélection
  • SpotPanel : Spot Mode complet (score, niveau, distance, trend)
  • Bouton feedback terrain (confirmation/infirmation anonyme)
  • Build Vite → backend/public/spa/ (SPA statique servie par Caddy)

Données initiales

  • Seed CoastalPoint zone Antilles — 29 points (plages, ports, surf, 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)
Reference in New Issue View Git Blame Copy Permalink