Documentation technique

À propos du projet

Phileas est un projet communautaire ouvert. Cette page explique comment fonctionne le projet, comment utiliser les données transport de Nantes Métropole, et comment contribuer.

Info trafic TAN Données GTFS Temps réel GTFS-RT · à venir OpenStreetMap IA locale · Ollama 100% gratuit · sans pub
01 · Intro

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.

Le projet est 100% gratuit, sans publicité, et non affilié à la Semitan. Les données proviennent de sources publiques ouvertes.
02 · Data

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.

API TAN
Temps réel · ne répond plus
SIRI
Standard européen
GTFS
Horaires planifiés · passages
API BAN
Géocodage gouv.fr
OpenStreetMap
Tuiles · tracés · lieux (Nominatim)
Wikipédia
Présentation des lieux · via MCP
Nantes Métropole
Open data · parkings-relais, événements · via MCP
Open-Meteo
Météo à l'arrivée · via MCP
Wikidata
Faits sur les lieux · via MCP
Overpass
Lieux OpenStreetMap par catégorie · via MCP

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).

03 · API

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.

Base URL : https://open.tan.fr/ewp — Aucune authentification requise. Hors service : ce nom ne résout plus.

Temps d'attente à un arrêt

GET /ewp/tempsattente.json/{codeArret}
Retourne les prochains passages pour un arrêt donné. Les codes arrêts sont les codes GTFS (ex: COMM pour Commerce, BJOI pour Beaujoire).
Paramètre : 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

GET /ewp/arrets.json/{latitude}/{longitude}
Retourne les arrêts les plus proches d'une coordonnée GPS. Les coordonnées utilisent la virgule comme séparateur décimal (format français).
Paramètres : 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

GET /ewp/horairesarret.json/{codeArret}/{numLigne}/{sens}
Retourne les horaires planifiés pour un arrêt, une ligne et un sens donnés.
codeArret · numLigne · sens (1 ou 2)
Les codes arrêts utilisent désormais les codes GTFS (COMM, BJOI, FMIT…). Les anciens codes TAN sont obsolètes.
04 · Protocol

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>
Le service SIRI pour Nantes renvoie des réponses vides. Pour le temps réel, la piste retenue est le flux GTFS-RT de Naolib (trip updates, ressource 84184), pas encore branché.

Données retournées

Chaque MonitoredStopVisit contient :

  • LineRef — Identifiant de la ligne
  • DestinationName — Terminus de la course
  • AimedDepartureTime — Horaire planifié
  • ExpectedDepartureTime — Horaire estimé (temps réel)
05 · Dataset

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 GTFS
  • routes.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
Le fichier 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.
06 · IA

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.

Les deux briques se branchent indépendamment : sans IA configurée, l'assistant fonctionne avec ses seules règles ; sans OpenTripPlanner, avec l'itinéraire estimé.
07 · Infra

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

HTML / JS / CSS
Frontend sans framework
Leaflet
Carte interactive (app)
PHP
API, proxy, auth
PostgreSQL
Comptes, trajets, trajets favoris, signalements
OpenTripPlanner
Itinéraires multimodaux (VM dédiée)
OpenStreetMap
Tuiles, tracés des lignes, Nominatim
Ollama · Qwen 3.5 4B
IA locale (VM dédiée)
MCP
Wikipédia, Wikidata, OpenStreetMap, météo, open data Nantes
Brevo
Emails de connexion : code + lien (SMTP)
Apache
Serveur web
Nginx
Reverse proxy, TLS
Proxmox
Virtualisation des 5 VM

Flux de données

  1. L'app charge la carte : Leaflet + tuiles OpenStreetMap, tracés réels depuis data/shapes.json, arrêts depuis data/lignes.js
  2. 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)
  3. 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, table user_favorite_trips, 30 trajets au plus) ; l'app le retrouve dans Favoris › Trajets et le recalcule aux horaires du moment
  4. 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
  5. /api/otp.php → OpenTripPlanner (GraphQL) pour le calcul d'itinéraire, sur les horaires GTFS Naolib
  6. Itinéraire affiché → /api/nantes.php (session obligatoire) → passerelle → serveurs MCP : action=contexte pour la météo et les événements à l'arrivée, action=parcs pour les parkings-relais et leurs places libres
  7. 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
  8. 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.php transporte la session entre naolibre.fr et naolibre-app.fr
  9. 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

proxy.php
Passages (horaires théoriques pour l'instant)
otp.php
Proxy → OpenTripPlanner
ai.php
Compréhension des demandes (IA locale)
place.php
Lieux : OpenStreetMap, Wikipédia, Wikidata
nantes.php
Météo, événements, parkings-relais
infotrafic.php
Perturbations réseau
horaires.php
Horaires théoriques
auth/*
Code, lien magique, sessions, profil, trajets, favoris
signalements.php
Signalements : carte, votes, retrait
L'infrastructure reste simple : cinq VM, pas de Node.js, pas de Docker, plus de service worker (il cassait les navigations redirigées depuis la mise sous connexion). Ollama et les serveurs MCP n'écoutent qu'en local sur la VM de l'IA ; seule la passerelle est exposée, et elle exige une clé que seul le serveur web détient. OTP est alimenté par les données GTFS Naolib + OpenStreetMap.
08 · Community

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
Les pages de l'application exigent une session, donc PostgreSQL. L'assistant fonctionne sans IA (règles de repli) et sans OTP (itinéraire estimé sur le graphe local), mais c'est avec les deux qu'il donne le meilleur.