compagnonsdudev/autoroutes repository overview

⁠Autoroutes — supervision des gares de péage

Carte de supervision avec flux Kafka, historique PostgreSQL, API/SSE, simulation de trafic et tableaux de bord. Le simulateur fourni produit des données simulées ; leur provenance est affichée dans l’interface.

Ce dépôt Docker Hub contient six familles d’images. Pour démarrer l’application complète avec Kafka et PostgreSQL, utiliser Docker Compose depuis le dépôt GitHub⁠.

⁠Fonctionnalités

• Carte de France avec gares, recherche, sélection d’axe et mise en évidence des concessions autoroutières identifiées.
• Compteurs nationaux et mini-courbes sur la dernière heure, fiches de gares et classement d’activité.
• Historique persistant, relecture temporelle, flux origine/destination et itinéraires estimés sur le graphe routier.
• Déclaration et consultation d’anomalies par serveur MCP ; authentification OIDC facultative avec Keycloak.
• Prometheus, Alertmanager et tableaux de bord Grafana pour superviser la chaîne.

Les flux suivent des itinéraires estimés, pas des positions GPS mesurées. Les tirets représentent le volume de trafic ; leur vitesse à l’écran n’est pas la vitesse réelle des véhicules. Une section sans concession identifiée reste neutre.

⁠Courbes du bandeau : quelle donnée ?

Les courbes des entrées, sorties et passages représentent le volume par minute sur la dernière heure (/min). Les valeurs des compteurs gardent leur propre période : une heure glissante ou la journée. Les passages additionnent les événements d’entrée et de sortie, sans décompter des véhicules uniques. Les anomalies et les gares actives sont suivies localement depuis l’ouverture, pendant au plus une heure ; Suivi indique une période partielle. Les données absentes ne sont pas remplacées par des zéros.

En démonstration ou sans historique disponible, la description de la courbe précise qu’il s’agit de l’évolution locale du compteur. En relecture, les courbes de trafic suivent l’horloge virtuelle ; aucun historique d’anomalies n’est inventé. Voir le guide utilisateur⁠.

⁠Démarrage rapide avec les images publiées

Prérequis : Docker Engine ou Docker Desktop démarré, Docker Compose 2.24.4 ou supérieur, Git et les ports locaux disponibles. Conserver le dépôt entier : compose.hub.yaml réutilise compose.yaml et monte des configurations de observability/ et auth/.

⁠Windows — PowerShell

git clone https://github.com/SteelDevAndroid/autoroutes.git
cd autoroutes
Copy-Item .env.example .env
# Adapter les mots de passe dans .env avant le lancement.
docker compose -f compose.hub.yaml --profile full --profile monitoring pull
docker compose -f compose.hub.yaml --profile full --profile monitoring up -d --wait

⁠Linux / macOS

git clone https://github.com/SteelDevAndroid/autoroutes.git
cd autoroutes
cp .env.example .env
# Adapter les mots de passe dans .env avant le lancement.
docker compose -f compose.hub.yaml --profile full --profile monitoring pull
docker compose -f compose.hub.yaml --profile full --profile monitoring up -d --wait

Aucune compilation locale n’est nécessaire. Le profil full démarre le frontend nginx, le backend, le simulateur, Kafka, l’initialisation des topics et PostgreSQL. Les sondes de santé et les dépendances ordonnent le démarrage. monitoring ajoute Prometheus, Alertmanager et Grafana.

⁠Accès locaux

Les ports sont liés à 127.0.0.1 par défaut. Les mots de passe fournis sont des valeurs de développement à changer. Les données Kafka, PostgreSQL et de supervision persistent dans des volumes nommés. Modifier .env ne change pas un mot de passe déjà enregistré dans un volume.

⁠Profils facultatifs

Pour inclure MCP :

docker compose -f compose.hub.yaml --profile full --profile monitoring --profile mcp up -d --wait

L’authentification du serveur MCP se configure séparément avec MCP_SECURITY_ENABLED=true et le profil auth : voir la documentation MCP⁠.

⁠Comptes et authentification

Le profil full seul sert l’application locale sans écran de connexion. Pour activer OIDC, définir SUPERVISION_PROFILE=auth dans .env puis ajouter --profile auth aux commandes de lancement.

Les valeurs initiales de développement sont changez-moi. Les adapter avant l’initialisation. Les comptes Keycloak déjà persistés conservent leurs mots de passe après modification de .env : voir les secrets persistés⁠. L’ajout de auth ne sécurise pas automatiquement MCP : son paramétrage est séparé.

⁠Cartographie

Les images de production récentes embarquent une carte générée et vérifiée par la CI avant leur construction. L'image frontend de production inclut le fond France z12, les autoroutes, les polices et les sprites. Le backend inclut le graphe routier du même jeu, activé par défaut sur /app/bundled-graph/graph.json. compose.hub.yaml utilise ces fichiers sans montage local : aucun téléchargement séparé n'est nécessaire. Le manifeste de provenance est accessible sur /cartography-manifest.json dans le frontend. Les anciennes versions publiées restent sans données embarquées. La démonstration garde son fond neutre hors ligne. Le jeu embarqué représente environ 1,2 Go pour le fond France ; prévoir le téléchargement des images et de l’espace pour les volumes persistants. Ce volume cartographique n’est pas une mesure de RAM requise.

Pour produire un autre jeu local (réseau et espace disque nécessaires) :

docker compose -f compose.hub.yaml --profile tiles run --rm tiles

L’image cartographique embarque ses scripts et référentiels. Elle écrit dans cartographie/out et utilise cartographie/work pour les fichiers intermédiaires. Ces sorties locales s'utilisent avec compose.yaml, qui conserve les montages de données. Le fichier Hub utilise toujours les données embarquées ; changer son jeu nécessite une surcharge explicite des volumes. ASSIGNMENT_GRAPH_FILE= désactive le graphe embarqué si nécessaire.

⁠Fond absent ou génération arrêtée

tiles est une tâche ponctuelle, pas un serveur permanent. up -d --build démarre la génération en arrière-plan sans attendre sa fin. Préférer run --rm tiles pour voir la progression et les erreurs ; une sortie 0 signifie que la production est terminée.

docker compose -f compose.hub.yaml --profile tiles ps -a
docker compose -f compose.hub.yaml --profile tiles logs --tail=100 tiles

Sous Windows, si les journaux indiquent mkdir ... File exists alors que les dossiers sont absents dans l’Explorateur, les créer depuis PowerShell avant de relancer la tâche :

New-Item -ItemType Directory -Force -Path cartographie/out/tiles,cartographie/out/basemaps-assets,cartographie/out/graph,cartographie/work
docker compose -f compose.hub.yaml --profile tiles run --rm tiles

Pour construire le générateur depuis les sources, utiliser docker compose --profile tiles build tiles, puis docker compose --profile tiles run --rm tiles.

⁠Installer les données publiées sans les régénérer

La release tuiles-20261023⁠ contient le fond France (environ 1,2 Go), les autoroutes, le graphe et les polices/sprites. Sous Linux ou Git Bash, scripts/fetch_tiles.sh installe le dernier jeu publié et vérifie ses empreintes SHA-256.

Sous Windows avec GitHub CLI (gh) et tar disponibles, depuis la racine du dépôt :

$tilesRelease = 'tuiles-20261023'
$tilesDownload = "build/$tilesRelease"
New-Item -ItemType Directory -Force -Path $tilesDownload,cartographie/out/tiles,cartographie/out/basemaps-assets,cartographie/out/graph | Out-Null
gh release download $tilesRelease --repo SteelDevAndroid/autoroutes --dir $tilesDownload --skip-existing
if ($LASTEXITCODE -ne 0) { throw 'Téléchargement incomplet' }
Get-Content "$tilesDownload/SHA256SUMS" | ForEach-Object {
    $expected, $name = $_ -split '\s+', 2
    $actual = (Get-FileHash -Algorithm SHA256 -LiteralPath "$tilesDownload/$name").Hash
    if ($actual -ne $expected) { throw "Empreinte invalide : $name" }
}
Copy-Item "$tilesDownload/france.pmtiles","$tilesDownload/motorways.pmtiles" cartographie/out/tiles/
Copy-Item "$tilesDownload/graph-*.json" cartographie/out/graph/
Copy-Item "$tilesDownload/manifest.json" cartographie/out/
tar -xzf "$tilesDownload/basemaps-assets.tar.gz" -C cartographie/out
if ($LASTEXITCODE -ne 0) { throw 'Extraction incomplète' }

Un téléchargement incomplet déjà présent sera détecté par SHA-256 : retirer ce fichier du dossier de téléchargement avant de réessayer. Les fichiers du fond sont servis par nginx dès leur installation dans les dossiers montés. Recharger la page du navigateur.

Pour contrôler le service HTTP sous PowerShell :

(Invoke-WebRequest http://localhost:8080/tiles/france.pmtiles -Headers @{ Range = 'bytes=0-126' }).StatusCode

Le résultat attendu est 206 (contenu partiel), pas 404. Les sprites et polices sous /basemaps-assets/ doivent aussi être disponibles. Si le frontend local a été construit avec les quatre VITE_* vides, retirer ces valeurs puis reconstruire frontend-live avec le profil full pour activer le fond.

Les paramètres VITE_* sont intégrés au frontend à la construction : les modifier dans .env ne reconfigure pas une image publiée. Pour personnaliser ces paramètres, construire avec compose.yaml ; voir le guide Docker⁠.

⁠Images et versions

latest suit les versions stables ; edge suit les publications de main après validation CI. Pour utiliser les dernières évolutions validées de main, définir AUTOROUTES_TAG=edge dans .env, puis exécuter pull et up. Pour figer la pile, utiliser dans AUTOROUTES_TAG une version effectivement publiée pour les six familles, vérifiée dans les tags du dépôt. Ne pas mélanger manuellement les versions du frontend et du backend. Les versions des images d’infrastructure sont définies dans compose.yaml.

⁠Mise à jour et diagnostic

docker compose -f compose.hub.yaml --profile full --profile monitoring pull
docker compose -f compose.hub.yaml --profile full --profile monitoring up -d --wait
docker compose -f compose.hub.yaml --profile full --profile monitoring ps -a
docker compose -f compose.hub.yaml --profile full --profile monitoring logs --tail=100 backend kafka postgres

Répéter les profils facultatifs utilisés, par exemple --profile mcp. docker compose ... down arrête la pile et conserve les volumes ; down -v supprime les volumes et leurs données.

Sous Windows, start.ps1 diagnostique aussi les secrets persistés, mais lance actuellement les images locales de compose.yaml : utiliser les commandes ci-dessus pour Docker Hub.

Code source⁠ · Guide Docker complet⁠ · Releases⁠

⁠Documentation et assistance

• Guide utilisateur⁠ : lecture des indicateurs, carte et relecture.
• Concessions⁠ : source et couverture des attributions.
• Performances⁠ : bornes de concurrence, SSE et protocole de mesure ; aucune capacité matérielle universelle n’est annoncée.
• CI⁠ : validations et publication des images.
• Signaler un problème⁠ : préciser le tag ou digest, les profils, l’architecture et les journaux utiles, sans secrets.

Cette présentation est versionnée dans docs/dockerhub.md. Le workflow dockerhub-description.yml la synchronise après une modification sur main et peut être relancé manuellement sur main. Les images et la description ont des publications distinctes : consulter leurs tags et dates respectives.