Vue d'ensemble du projet
Phileas est une application communautaire, installable sur téléphone et ordinateur, dédiée aux transports en commun de Nantes Métropole, avec un site web : cette vitrine et l'IA de trajets pour ordinateur. Elle couvre l'ensemble du réseau Naolib : 3 lignes de tramway, 2 lignes de Busway, 9 Chronobus, 4 Express et 38 lignes de bus, soit 56 lignes et 1 119 arrêts.
Le projet se compose de cinq modules :
- Une carte interactive dans l'app (tuiles et tracés OpenStreetMap) affichant les arrêts, les lignes, les prochains passages (horaires théoriques du GTFS, en attendant le temps réel) et la grille horaire de chaque arrêt
- Un système de signalements communautaires (incidents, retards, véhicules bondés…), visibles sur la carte, dans la fiche des arrêts et pendant le guidage, confirmés ou démentis par les voyageurs
- IA — un assistant itinéraire : un modèle local (Qwen 3.5 4B via Ollama) comprend la demande, OpenTripPlanner calcule l'itinéraire, avec mémoire de la conversation. Sur ordinateur, on y prépare ses trajets pour les enregistrer en favoris ; dans l'app, il donne aussi les prochains passages et l'info trafic. Chaque itinéraire indique la météo et les événements proches à l'heure d'arrivée (« attendez-vous à du monde ») ; « je viens en voiture de… » propose les parkings-relais les plus proches avec leurs places libres, puis le trajet en transport en commun ; la fiche d'un lieu montre des faits tirés de Wikidata
- Mon bilan — trajets enregistrés par le mode trajet de l'app, CO₂ évité, économies, streaks et badges
Deux domaines : naolibre.fr (cette vitrine, publique) et naolibre-app.fr (connexion obligatoire), qui sert /m, l'application installable (PWA : iPhone, Android et ordinateur), et /ai, l'IA de trajets pour ordinateur. L'ancienne carte PC (/app) est retirée et renvoie vers /m. Les trajets enregistrés se retrouvent sur chaque appareil, onglet Favoris › Trajets.
Sources de données transport
Phileas s'appuie sur des sources de données ouvertes et complémentaires pour afficher les informations transport, situer les lieux et donner le contexte d'un trajet (météo, événements, parkings-relais). Le réseau complet est couvert : tram, busway, chronobus, express et bus réguliers.
Passages : l'API TAN (open.tan.fr), la source temps réel utilisée jusqu'ici, ne répond plus (son nom de domaine n'a plus d'enregistrement DNS, constaté fin septembre 2026), et SIRI ne renvoie rien. En attendant le flux GTFS-RT de Naolib (ressource 84184 sur transport.data.gouv.fr, pas encore branché), les passages affichés sont les horaires théoriques du GTFS.
Pour le contexte d'un trajet et la fiche des lieux : places libres en temps réel dans les 21 parkings-relais Naolib (mises à jour toutes les 2 minutes) et agenda des événements de la Ville de Nantes et de Nantes Métropole, sur le portail open data data.nantesmetropole.fr (API Opendatasoft, sans clé) ; prévisions d'Open-Meteo sur 3 jours (sans clé) ; faits structurés de Wikidata sur les lieux ; lieux d'une catégorie autour d'un point par l'API Overpass d'OpenStreetMap, avec repli sur Nominatim quand l'instance publique est saturée. Toutes ces requêtes partent du serveur, par les serveurs MCP de la VM de l'IA (voir IA locale).
API TAN (open.tan.fr)
L'API ouverte de la TAN (Transports de l'Agglomération Nantaise), sans clé d'API, était la source de données temps réel de Phileas. Elle ne répond plus depuis fin septembre 2026 : cette section est gardée pour mémoire, et pour le jour où elle reviendrait.
https://open.tan.fr/ewp — Aucune authentification requise. Hors service : ce nom ne résout plus.Temps d'attente à un arrêt
codeArret — Code GTFS de l'arrêt (4 caractères majuscules)// GET https://open.tan.fr/ewp/tempsattente.json/COMM
[
{
"sens": 1,
"terminus": "Beaujoire",
"infotrafic": false,
"temps": "2 min",
"ligne": { "numLigne": "1" },
"tempsReel": true
}
]
Arrêts proches d'une position
latitude et longitude — ex: 47,2178 / -1,5535# Arrêts proches du centre de Nantes
curl "https://open.tan.fr/ewp/arrets.json/47,2178/-1,5535"
Horaires planifiés
codeArret · numLigne · sens (1 ou 2)Protocole SIRI
SIRI (Service Interface for Real-time Information) est le standard européen pour l'échange de données transport en temps réel. Phileas l'interroge en repli via le point d'accès national transport.data.gouv.fr, mais le service de Nantes ne renvoie rien pour l'instant.
StopMonitoring
Le service StopMonitoring permet d'interroger les prochains passages à un arrêt. La requête se fait en POST avec un corps XML :
<?xml version="1.0" encoding="UTF-8"?>
<Siri xmlns="http://www.siri.org.uk/siri" version="2.0">
<ServiceRequest>
<RequestorRef>opendata</RequestorRef>
<StopMonitoringRequest version="2.0">
<RequestTimestamp>2026-04-16T10:00:00Z</RequestTimestamp>
<MonitoringRef>COMM</MonitoringRef>
<MaximumStopVisits>30</MaximumStopVisits>
</StopMonitoringRequest>
</ServiceRequest>
</Siri>
Données retournées
Chaque MonitoredStopVisit contient :
LineRef— Identifiant de la ligneDestinationName— Terminus de la courseAimedDepartureTime— Horaire planifiéExpectedDepartureTime— Horaire estimé (temps réel)
Données GTFS
GTFS (General Transit Feed Specification) est le format standard pour les données statiques de transport : arrêts, lignes, tracés, horaires planifiés.
Source officielle
Les données GTFS du réseau Naolib sont publiées sur le portail national :
# Portail national
https://transport.data.gouv.fr
# Dataset : Nantes Métropole — réseau Naolib (ressource GTFS 84101)
https://transport.data.gouv.fr/resources/84101/download
# Contient : stops.txt, routes.txt, trips.txt, stop_times.txt, shapes.txt
Fichiers clés
stops.txt— Liste des arrêts avec coordonnées GPS et codes GTFSroutes.txt— Définition des lignes (numéro, nom, type, couleur)shapes.txt— Censé porter les tracés des lignes ; celui de la TAN ne contient que les positions des arrêts (voir plus bas)stop_times.txt— Horaires planifiés par course
Tracés : OpenStreetMap plutôt que shapes.txt
Le shapes.txt du GTFS TAN relie les arrêts en ligne droite (écart médian de 352 m avec la voie réelle), et le NeTEx n'a que des segments à deux points. Les tracés de Phileas sont donc tirés des relations OpenStreetMap (écart médian de 12 m) et rangés dans data/shapes.json : une liste de tronçons par ligne et par branche, pour ne jamais tracer de droite au-dessus d'une discontinuité.
Mise à jour automatique
Naolib publie deux à trois mises à jour du GTFS par semaine : c'est ce qui fait entrer les coupures prévues avant qu'elles aient lieu. Chaque nuit, vers 4 h 15, une tâche planifiée vérifie si le fichier a changé, et ne reconstruit le graphe d'OpenTripPlanner que dans ce cas.
Codes arrêts
COMM → Commerce BJOI → Beaujoire
FMIT → François Mitterrand PIRM → Pirmil
OGVA → Orvault Grand Val NETR → Neustrie
FOCH → Foch - Cathédrale PVTO → Porte de Vertou
HBAN → Hangar à Bananes GSSU → Gare Sud
data/lignes.js du projet décrit les 56 lignes du réseau et les coordonnées de leurs arrêts, prêtes à l'emploi côté JavaScript ; data/shapes.json porte leur géométrie réelle.IA locale
assets/naobot.js sépare comprendre et répondre. Comprendre revient à l'IA ; répondre, aux données du réseau. L'assistant ne produit aucune donnée lui-même : ses réponses sont structurées (itinéraire, passages, trafic…) et l'app les met en forme.
Comprendre : une IA qui tourne chez nous
/api/ai.php confie la phrase à Qwen 3.5 4B, servi par Ollama sur la VM de l'IA. Le modèle ne rend qu'un JSON au schéma imposé : intention, lieux, heure (time_mode arriver / partir), préférences (fewer_transfers, less_walking, wheelchair). Il n'écrit jamais de ligne ni d'horaire : même la phrase « Vous voulez aller de… » est composée côté client. Aucune API d'IA externe, aucun coût.
- Temps de réponse : 1,5 à 5 s, grâce à un préchauffage qui fait lire au modèle la partie fixe du prompt dès l'ouverture de l'IA.
- IA absente, lente ou perdue : l'assistant se replie sur ses règles (mots-clés et motifs de phrase).
- Ollama n'écoute qu'en local. Seule une passerelle est exposée, et elle exige une clé que seul le serveur web détient ; elle impose le modèle et borne les options. Un pare-feu n'ouvre son port qu'au serveur web.
Situer les lieux
Un lieu est cherché d'abord parmi les arrêts, puis par /api/place.php (OpenStreetMap Nominatim pour la position, les horaires d'ouverture et le site ; Wikipédia, branchée à l'IA par un serveur MCP (Model Context Protocol) sur la VM de l'IA, pour la présentation), enfin dans la Base Adresse Nationale pour les adresses. Les requêtes vers OpenStreetMap et Wikipédia partent du serveur, pas du téléphone, et sont gardées en cache sept jours. Pour une demande générique (« une pharmacie », « un lycée »), les plus proches du départ viennent d'OpenStreetMap par Overpass ; la fiche d'un lieu ajoute des faits tirés de Wikidata (voir plus bas).
Répondre : rien que des données du réseau
L'itinéraire vient d'OpenTripPlanner 2.8.1 via /api/otp.php (arrivée ou départ à une heure donnée, accessibilité, moins de correspondances, moins de marche), les passages des horaires théoriques du GTFS (l'API TAN ne répond plus ; le temps réel viendra du flux GTFS-RT), les perturbations de l'info trafic. Quand un itinéraire fait marcher entre deux arrêts d'une même ligne, l'assistant explique la coupure. Si OTP n'a plus d'horaires valides, il calcule un « itinéraire estimé » sur le graphe de data/lignes.js, et le signale.
Serveurs MCP : des données ouvertes, lues par le serveur
Cinq serveurs MCP (Model Context Protocol), écrits avec la seule bibliothèque standard de Python, tournent sur la VM de l'IA. Ils n'écoutent qu'en local (127.0.0.1) : la passerelle à clé reste la seule porte d'entrée. Leurs outils sont en lecture seule, et leurs réponses gardées en cache.
- Wikipédia — recherche des lieux autour de Nantes et lecture de leur article, pour la présentation d'un lieu.
- Wikidata — faits structurés sur un lieu, à partir du titre de son article Wikipédia : date de création, architecte, commanditaire, protection au titre des monuments historiques, propriétaire…
- OpenStreetMap (Overpass) — les lieux d'une catégorie les plus proches d'un point (« une pharmacie », « un lycée »), avec horaires et accès fauteuil ; la position part arrondie à ≈ 10 m. L'instance publique est souvent saturée : repli automatique sur Nominatim.
- Météo (Open-Meteo) — le temps prévu à l'arrivée d'un itinéraire, jusqu'à 3 jours ; la position part arrondie au centième de degré (≈ 1 km).
- Open data Nantes Métropole (API Opendatasoft) —
parcs_relais: places libres en temps réel dans les 21 parkings-relais Naolib, mises à jour toutes les 2 minutes ;evenements: agenda des événements de la Ville de Nantes et de Nantes Métropole.
Le serveur web les appelle lui-même, par la passerelle, au lieu de laisser le modèle choisir ses outils : un modèle de 4 milliards de paramètres choisit mal les siens. /api/place.php y prend les lieux et leurs faits ; /api/nantes.php (session obligatoire), la météo et les événements à un point et une heure (action=contexte) et les parkings-relais (action=parcs). Chaque source est facultative : si un serveur ne répond pas, le trajet s'affiche sans elle. L'IA s'appuie sur les faits Wikidata pour répondre (« construit à partir de 1207 à l'initiative de Guy de Thouars, monument historique classé ») et cite Wikidata dans ses sources. Aucune de ces requêtes n'est rattachée au compte ni ne contient d'identifiant de l'utilisateur.
Architecture & Infrastructure
Phileas repose sur cinq machines virtuelles Proxmox, sur une infrastructure interne au projet.
Machines virtuelles
- Serveur web — Apache + PHP 8 : les deux domaines, les API, les fronts
- Base de données — PostgreSQL 17 + pgAdmin
- Reverse proxy — Nginx, terminaison TLS
- Itinéraires — OpenTripPlanner 2.8.1 (Java)
- IA — Ollama + Qwen 3.5 4B, passerelle authentifiée, serveurs MCP Wikipédia, Wikidata, OpenStreetMap, météo, open data Nantes
Stack technique
Flux de données
- L'app charge la carte : Leaflet + tuiles OpenStreetMap, tracés réels depuis
data/shapes.json, arrêts depuisdata/lignes.js - Clic sur un arrêt →
/api/proxy.php→ cache fichier (25s) → API TAN, SIRI en fallback ; aucune de ces deux sources ne répond pour l'instant, les passages affichés viennent donc des horaires théoriques (GTFS) - Question posée à l'IA →
/api/ai.php→ passerelle → IA locale : la phrase devient intention, lieux, heure et préférences (règles en repli). Sur ordinateur, le trajet trouvé s'enregistre sur le compte (départ, arrivée, préférences, aperçu des lignes et de la durée) par/api/auth/favorites.php(session obligatoire, tableuser_favorite_trips, 30 trajets au plus) ; l'app le retrouve dans Favoris › Trajets et le recalcule aux horaires du moment - Lieux : arrêts d'abord, puis
/api/place.php(OpenStreetMap Nominatim + Wikipédia via MCP, Overpass pour une demande générique, faits Wikidata), puis la BAN pour les adresses /api/otp.php→ OpenTripPlanner (GraphQL) pour le calcul d'itinéraire, sur les horaires GTFS Naolib- Itinéraire affiché →
/api/nantes.php(session obligatoire) → passerelle → serveurs MCP :action=contextepour la météo et les événements à l'arrivée,action=parcspour les parkings-relais et leurs places libres - Les signalements sont stockés en PostgreSQL avec expiration automatique (1h) ; deux « c’est terminé » les retirent plus tôt, et l’auteur peut retirer le sien
- Connexion par code à 6 chiffres :
/api/auth/magic.php→ Brevo (email : code + lien) →/api/auth/verify.php(5 essais) ou/api/auth/callback.php(lien) → session cookie HttpOnly ;/api/auth/handoff.phptransporte la session entre naolibre.fr et naolibre-app.fr - Le mode trajet envoie ligne, montée et descente à
/api/auth/trip.php, qui calcule distance, CO₂ et économies côté serveur et attribue les badges
API internes
Contribuer
Phileas est un projet communautaire. Voici comment vous pouvez aider :
Idées de contributions
- Améliorer l'accessibilité (ARIA, navigation clavier, contrastes)
- Brancher le temps réel GTFS-RT dans OpenTripPlanner : alertes et trip updates sont publiés sur transport.data.gouv.fr
- Activer les isochrones d'OpenTripPlanner : « où puis-je aller en 20 min ? »
- Mesurer la ponctualité réelle, en comparant horaires théoriques et passages en temps réel
- Afficher les retards et suppressions du flux GTFS-RT dans les passages de l’app, à la place des horaires théoriques
- Produire le justificatif PDF mensuel du forfait mobilités durables : les trajets sont déjà enregistrés
Démarrage rapide
# 1. Cloner le projet
git clone https://github.com/Teiqko-01/naolibre
# 2. Lancer un serveur local
php -S localhost:8080 -t nao/
# 3. Base de données (comptes, signalements)
psql -U naolibre -d naolibre -f nao/sql/init.sql
psql -U naolibre -d naolibre -f nao/sql/migration_001_expiration_1h.sql
psql -U naolibre -d naolibre -f nao/sql/migration_002_horaires_theoriques.sql
psql -U naolibre -d naolibre -f nao/sql/migration_003_accounts.sql
# 4. Config (copier et adapter)
cp nao/api/lib/config.example.php nao/api/lib/config.local.php
# 5. OTP (optionnel, VM séparée)
# Voir la doc OTP dans le README
# 6. IA locale (optionnelle, VM séparée)
# Sans elle, l'assistant garde ses règles