Auto·Ka

Les voitures usagées du Québec

Les pastilles de la deuxième rangée sont dynamiques : elles interrogent /api/stats en direct.

Auto-Ka est un agrégateur indépendant de véhicules usagés couvrant la province de Québec. Chercher une auto usagée, c'est normalement ouvrir des dizaines de sites de concessionnaires — chacun avec sa navigation, ses filtres, son format. Auto-Ka retourne le problème : un connecteur dédié par commerce visite chaque site à la source (aucune plateforme d'annonces revendue), normalise chaque véhicule vers un schéma unique et détecte les changements en continu.

Les sites de concessionnaires n'offrent pas de webhooks ; Auto-Ka en reproduit l'équivalent : synchronisation périodique + hash de contenu → arrivages, baisses de prix et ventes détectés automatiquement. Un véhicule qui disparaît du site source est marqué vendu — et sa page renvoie alors un vrai 410 Gone aux moteurs de recherche. Au 2026-08-28, le parc compte 46 687 véhicules (dont 624 motos et 28 scooters) provenant de 138 concessionnaires (129 sources livrant actuellement, sur un registre de 143 sources) répartis dans les 18 régions du Québec — prix moyen ≈ 30 001 $, ≈ 89 626 km, année moyenne ≈ 2020 — avec 16 969 rappels de sécurité croisés et 12 445 doublons VIN masqués.

# Visite guidée

Le tour du site en production en 10 captures — 2026-08-28, www.auto-ka.com (desktop, DA v3 « magazine automobile »).

1 · Accueil — masthead encre, hero éditorial, recherche unifiée sur tout le parc (46 687 véhicules) et filtres pupitre	2 · Motos — verticale dédiée (kind=moto, 624 motos) : mêmes filtres, mêmes fiches, onglet propre
3 · Scooters — troisième verticale du moteur (kind=scooter), alimentée par les 13 concessionnaires moto	4 · Statistiques — tableau de bord du marché de l'occasion : gros chiffres tabulaires, distributions de prix, répartitions par région/marque/carrosserie, rapports PDF
5 · Sources — le registre en toute transparence : 143 sources, fraîcheur de synchronisation et volume par concessionnaire/portail	6 · Contact — page contact commune Groupe KA (retraits de sources, signalements, partenariats)
7 · Page marque (/usagees/acura) — SEO programmatique : une page SSR par marque, title/meta uniques, JSON-LD, inventaire filtré	8 · Page région (/region/abitibi-temiscamingue) — l'inventaire d'une des 18 régions administratives du Québec
9 · Page ville (/ville/acton-vale) — maillage local : chaque ville desservie a sa page (géolocalisation data/villes_gps.json)	10 · Page carrosserie (/carrosserie/berline) — navigation par type de carrosserie normalisé (berline, VUS, camionnette…)

# Parcours mobile & desktop (DA v3, 2026-08-25)

Mobile 390×844 · desktop 1440×900.

# Mobile

Accueil — masthead encre, KA Tabbar

Résultats — barre compacte + bottom sheet de filtres

Fiche véhicule v2 — badge marché

# Desktop

Accueil — hero éditorial, filtres pupitre sans boîte	Résultats — cartes sans cadre, spec-line mono
Fiche v2 — prix vs marché, caractéristiques, KA Score	Fiche v2 — analyse marché, fiche VIN (NHTSA), historique de prix
Statistiques — 46 600+ véhicules, gros chiffres tabulaires

# Nouveautés front-end (2026-08-25)

• DA v3 « magazine automobile » — masthead encre, hero éditorial, filtres pupitre sans boîte, cartes véhicules sans cadre (spec-line mono), fiche à filets.
• Fiche véhicule v2 — analyse marché (nuage de points prix/km), KA Score composite, fiche VIN décodée (NHTSA), rappels, lightbox photos.
• Refonte UX des filtres — barre compacte (« N véhicules · Trier · Filtres »), bottom sheet mobile / tiroir desktop, sliders min-max prix/année/km, chips actifs supprimables, CTA sticky avec compteur en direct.
• KA Tabbar v1 — barre de navigation mobile commune Groupe KA.
• Widget ka-agent v4 — cartes de véhicules cliquables et choix en boutons.

🗄️ Les captures d'époque sont conservées dans docs/archive/.

# Fonctionnalités

• Recherche unifiée — filtres marque / modèle / année / prix / km / carburant / motricité / carrosserie / région / ville / concessionnaire, facettes dynamiques et tris multiples.
• Fiches véhicule complètes — galerie photos, caractéristiques standardisées, VIN, équipements, historique de prix, véhicules similaires toutes sources confondues, et lien direct vers l'annonce originale du concessionnaire, toujours.
• Trois verticales, un moteur — le champ kind (auto / moto / scooter) traverse tout le pipeline ; motos et scooters ont leurs onglets dédiés.
• Suivi des baisses de prix — le diff engine (upsert par hash de contenu) détecte nouveau / modifié / vendu, avec délai de grâce et détection de dérive.
• Rappels de sécurité — croisement avec les rappels constructeurs (autoka/recalls.py), 16 969 rappels référencés (au 2026-08-28).
• Déduplication par VIN — les annonces multi-sites d'un même véhicule sont détectées et masquées (autoka/dedup.py).
• Statistiques du marché en direct — tuiles de synthèse, distributions de prix, répartitions par région / marque / carrosserie, et rapports PDF personnalisés (stats v3 : catalogue, rendu au choix, ReportBuilder — autoka/pdfgen.py, kapdf.py).
• SEO programmatique massif — rendu serveur complet (autoka/seo.py) : title/meta uniques, canonical, Open Graph, hreflang fr-CA, JSON-LD Car/Motorcycle + Offer + BreadcrumbList, pages programmatiques (/usagees/{marque}, /region/…, /ville/…, /carrosserie/…, /motos/…), sitemaps dynamiques avec lastmod réels, vendu → 410, inconnu → 404.
• Compte KA ID — SSO « Se connecter avec KA ID » via le hub groupe-ka.com : même compte partout, page profil, favoris « Mon univers Ka » centralisés.
• Connecteurs auto-découvrants — ajouter un concessionnaire = une sous-classe de BaseConnector (~6 lignes) déposée dans autoka/connectors/ (familles D2C Media, SM360, AMVOQ/AutoUsagee, EvalAuto, Convertus, PowerGo, HGrégoire…).
• Fidélité — aucun prix inventé : si la source n'affiche pas de prix, price = null (« Prix sur demande ») ; politesse de crawl (délai entre requêtes, backoff, User-Agent identifié).

# Démarrage rapide

ssh M4M64b && cd ~/auto-ka                      # source de vérité : le nœud (aucune copie laptop)

# Backend
python3 -m venv .venv
.venv/bin/pip install -r requirements.txt
.venv/bin/python run.py sync                     # synchroniser toutes les sources
.venv/bin/python run.py sync desmeules kijiji    # ...ou seulement certaines (id du registre data/sources.json)
.venv/bin/python run.py serve 8080               # API + frontend + SSR en local

# Frontend (build servi ensuite par FastAPI)
cd frontend && npm install && npm run build && cd ..
cd frontend && npm run dev                       # ...ou serveur de dev Vite

# Boucle de synchronisation continue (ce que fait PM2 en prod)
.venv/bin/python run.py watch 120                # re-parcourt les sources, cycle ≈ 2 h

run.py est le seul point d'entrée : sync [source ...] · watch [minutes] (défaut 120) · serve [port] (défaut 8080).

# Variables d'environnement

Noms seulement — les valeurs vivent dans .env sur le nœud (jamais versionnées).

# Architecture

# Processus PM2

# API principale

S'y ajoutent les routes SSR SEO (/vehicule/{uid}/{slug}, /usagees/{marque}[/{modèle}], /region/…, /ville/…, /carrosserie/…, /motos/…, /scooters/…, sitemaps, robots.txt) et les pages /stats, /sources, /doc, /contact, /profil.

# Connecteurs et sources

31 modules dans autoka/connectors/ (+ socle base.py / _resilient.py) couvrent le registre data/sources.json : 143 sources au 2026-08-28 — 142 actives, 1 en pause (albioccasion, rate-limit 429, connecteur prêt) — soit 138 concessionnaires géolocalisés et 129 sources livrant actuellement des véhicules. Un module = soit un commerce, soit une famille de plateforme dont chaque concessionnaire est une sous-classe (~6 lignes).

Infrastructure commune : base.py (classe BaseConnector, normalisation, politesse de crawl) et _resilient.py (retries/backoff, escalade anti-bot Oxylabs → Scrapfly → Bright Data). La documentation générée des connecteurs vit dans docs/ (scripts/gen_connector_docs.py).

# Diff engine & déduplication VIN

1. Chaque annonce normalisée reçoit un hash de contenu ; l'upsert dans SQLite classe le véhicule nouveau / modifié / inchangé.
2. Tout changement de prix est journalisé → l'historique de prix affiché sur la fiche.
3. Une annonce absente du site source est marquée vendue après un délai de grâce (tolère les ratés de crawl), avec détection de dérive pour éviter les faux positifs quand une source change de structure ; sa page publique renvoie alors 410 Gone.
4. La déduplication par VIN (autoka/dedup.py) détecte le même véhicule annoncé sur plusieurs sites et masque les doublons (12 445 masqués au 2026-08-28) — le VIN sert aussi au croisement des rappels (autoka/recalls.py).

# Données & conformité

• Provenance — chaque véhicule est lu directement sur le site du concessionnaire (ou du portail), jamais via une plateforme d'annonces revendue ; le lien vers l'annonce originale est toujours affiché sur la fiche.
• Cadence — le watcher auto-ka-sync reparcourt les sources actives en continu, cycle complet ≈ 2 heures ; chaque passage est horodaté (fraîcheur visible sur /sources et via ?syncs_since_h).
• Fidélité — aucun prix inventé (price = null → « Prix sur demande »), aucun champ deviné ; un véhicule disparu de la source est marqué vendu, jamais falsifié.
• Politesse de crawl — délai entre requêtes, retries avec backoff, User-Agent identifié ; l'escalade anti-bot (_resilient.py) n'est utilisée que là où le site le rend nécessaire.
• Avertissement — Auto-Ka est un index indépendant, sans affiliation avec les concessionnaires référencés ; les prix et disponibilités sont indicatifs et font foi chez le commerçant. Les rappels proviennent des données publiques de Transports Canada.

# Structure du repo

# Documentation

• Guide d'utilisation en ligne : www.auto-ka.com/doc — visite guidée pas à pas (accueil, recherche, fiche, historique de prix) avec captures d'écran.
• Guide PDF téléchargeable : auto-ka-documentation.pdf.
• Le guide est aussi lié depuis le pied de page du site ; ses captures vivent dans frontend/public/doc/img/.

# Historique

# Développement (remote-first)

La source de vérité est le repo git sur le nœud M4M64b (~/auto-ka) — il n'existe aucune copie laptop. Toute modification se fait sur le nœud via SSH ; le remote origin = spbgit (git perso https://git.spboucher.ai), via l'alias SSH gitsrv configuré sur le nœud → gitsrv:srv/git/auto-ka.git (bare repos hébergés sur M3U96a). Pas GitHub.

ssh M4M64b
cd ~/auto-ka

# Backend
python3 -m venv .venv && .venv/bin/pip install -r requirements.txt
.venv/bin/python run.py sync            # synchroniser toutes les sources (ou : run.py sync <source_id>)
.venv/bin/python run.py serve 8080      # servir en local

# Frontend
cd frontend && npm install && npm run build && cd ..

# Après un changement en production
pm2 restart auto-ka-web                 # (ou auto-ka-sync selon le changement)

# Versionner depuis le nœud (agent forwarding actif)
git add <fichiers> && git commit -m "..." && git push origin main

# Déploiement

• Nœud : M4M64b (Mac Studio, cluster MacLustr) — répertoire ~/auto-ka
• Port local : 8095
• Processus PM2 : auto-ka-web (API + frontend + SSR), auto-ka-sync (watcher de synchronisation, cycle ≈ 2 h), auto-ka-ngrok (tunnel)
• Exposition publique : tunnel ngrok → https://www.auto-ka.com

Philosophie d'exploitation : on ne pousse que le code — le serveur maintient ses données lui-même.

# Écosystème Groupe KA

# Contact

Simon-Pierre Boucher — fondateur, Groupe KA 📧 contact@spboucher.ai

© Groupe KA — Simon-Pierre Boucher · contact@spboucher.ai

Ce repo vit sur spbgit (git.spboucher.ai) — la source de vérité est le clone sur le nœud M4M64b.