Sorti·Ka

Toutes les sorties, dans les 17 régions

Sorti·Ka est un agrégateur indépendant de sorties et d'événements couvrant les 17 régions administratives du Québec : 26 559 événements actifs (au 2026-08-28) dans 517 villes, avec dates, lieux, gratuité (5 050 événements gratuits à venir), fiche par événement et lien direct vers la billetterie ou la source originale. Mise à jour horaire, automatiquement.

Trouver quoi faire au Québec, c'est normalement ouvrir dix sites : les billetteries ne montrent que leurs propres spectacles, les calendriers municipaux que leur ville, les sites touristiques que leurs membres. Sorti·Ka retourne le problème : un connecteur dédié par source (61 sources actives, 68 au registre — les 7 restantes sont documentées comme abandonnées ou mortes à la source, avec preuves) visite chaque calendrier, normalise chaque événement vers un schéma unique, déduplique les doublons inter-sources et détecte les changements en continu. Sorti·Ka n'est pas une billetterie : c'est un index fidèle — aucun prix inventé, aucune date devinée, chaque fiche est attribuée à sa source. Pour qui ? Quiconque cherche quoi faire, ce soir ou cet été, n'importe où au Québec.

# Chiffres clés (live sur /api/stats, vérifiés au 2026-08-28)

# Visite guidée — le site en 10 captures

Captures du 2026-08-28 — frontend v2 « guide culturel » en production sur www.sorti-ka.com.

1 · Accueil — sorti-ka.com Hero éditorial avec mosaïque d'images réelles et compteurs live en phrase, recherche centrale, accès rapides (Ce soir · Fin de semaine · Gratuit · Près de moi), timeline de jours et sections « À la une » dédoublonnées.	2 · Répertoire des régions — /regions Les 17 régions administratives du Québec, chacune avec son compteur d'événements actifs — porte d'entrée géographique de tout le catalogue.
3 · Répertoire des catégories — /categories Les 14 catégories canoniques (musique, arts-scène, festival, sport, famille, plein-air, exposition-musée…) vers lesquelles chaque source est normalisée.	4 · Statistiques — /stats Tableau de bord analytique du catalogue (kit stats v3 Groupe KA) : répartitions par région, catégorie, gratuité, sources — et rapports PDF téléchargeables.
5 · Contact — /contact Page contact standardisée Groupe KA : coordonnées du fondateur, mission du site et liens vers l'écosystème.	6 · Page région — Montréal — /region/montreal Résultats filtrés par région (8 919 événements à Montréal) : cartes image-first, bascule Liste|Carte (Leaflet à la demande), pilules de filtres actifs, page SEO rendue en HTML.
7 · Page catégorie — Arts & scène — /categorie/arts-scene Vue par catégorie (4 225 événements arts-scène) combinable avec les filtres région, ville, période et gratuité — indexable par les moteurs.	8 · Fiche événement — /evenement/{uid} La fiche complète (ici un événement d'Abitibi-Témiscamingue) : dates et heure locale, lieu géocodé sur carte, prix original (`price_label`), événements similaires, CTA sticky vers la billetterie ou la source — SSR + JSON-LD Event.
9 · Favoris « Mon univers Ka » — /favoris Les événements sauvegardés via KA ID (SSO du hub groupe-ka.com) — le même compte et les mêmes favoris sur les 12 sites du Groupe KA.	10 · Documentation — /docs Le guide utilisateur en ligne : à quoi sert Sorti·Ka, utilisation pas à pas, provenance des données, FAQ — aussi disponible en PDF téléchargeable.

# Galerie mobile & desktop (frontend v2, 2026-08-25)

Mobile (390×844) — 6 captures WebP

Accueil — hero mosaïque, accès rapides, timeline de jours	Résultats par région — cartes image-first	Fiche événement — CTA billetterie sticky
Catégorie — musique	Tableau de bord /stats	Nav v2 — panneau plein écran

Desktop (1440×900) — 6 captures WebP

Accueil — sections « À la une », carrousels, ticker	Fiche événement — date, lieu, prix, lien billetterie
Page région — Montréal	Page catégorie — pages SEO indexables
Répertoire des 17 régions	Statistiques — 22 900+ événements, 61 sources

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

# Guide pas à pas (« Utiliser le site en 4 étapes », depuis /doc)

Étape 1 — Arriver sur l'accueil	Étape 2 — Filtrer la liste
Étape 3 — Ouvrir la fiche d'un événement	Étape 4 — Consulter les statistiques

# Fonctionnalités

• Recherche filtrée — région, ville, catégorie (14 catégories canoniques), période, gratuité, texte libre, proximité (near=lat,lng + tri par distance), tri et pagination (GET /api/events).
• Fiche par événement — dates, heure locale, artistes, lieu, prix (avec price_label original), carte, événements similaires ; SSR + JSON-LD Event (/evenement/{uid}) pour le SEO, sitemaps et robots.txt.
• 61 sources actives via 62 connecteurs (sortika/connectors/) couvrant billetteries, données ouvertes, diffuseurs, ATR (associations touristiques régionales), calendriers municipaux et portails régionaux (tableau ci-dessous).
• Déduplication inter-sources — empreinte titre + ville + date : un même concert publié par 3 sources = une seule carte, la fiche la plus riche gagne.
• Répertoire des municipalités MAMH — 1 250 villes + arrondissements + alias, homonymes résolus par population ; rattachement automatique aux 17 régions.
• Persistance robuste — upsert par hash de contenu, délai de grâce de 2 syncs avant retrait, alerte de dérive quand une source casse, quarantaine qualité, historique des synchronisations.
• SEO programmatique — SSR de l'accueil (title avec stats live, JSON-LD WebSite/Organization), pages régions + catégories rendues en HTML, hreflang/BreadcrumbList sur les fiches.
• Page /stats — tableau de bord analytique + rapports PDF Groupe-KA (kit kacharts/kapdf v3, rapports personnalisés par catalogue de blocs).
• Personnalisation KA ID v2 (sortika/kaid.py + /api/kaid) — journal serveur (recherches, fiches vues, favoris), recommandations « Recommandé pour vous » en mode annotation (ordre chronologique préservé), filtrage collaboratif (modèle ALS partagé Groupe KA), pilules « Sauvegarder cette recherche » / « Pas pour moi ».
• Frontend v2 « guide culturel » — mobile-first : bascule Liste|Carte (Leaflet à la demande), bottom sheet de filtres, CTA sticky, KA Tabbar v1 (barre de navigation mobile commune Groupe KA : Découvrir · Recherche · Carte · Favoris).
• Widget KA Agent (v4, cartes d'événements cliquables + choix en boutons) + favoris « Mon univers Ka » (KA ID, hub groupe-ka.com).
• Tests sur fixtures réelles, zéro réseau — 131 tests pytest (connecteurs, normalisation, DB, auth, expansion, phases 4+).

# Connecteurs & sources

61 sources actives / 68 au registre (data/sources.json : 61 actives, 6 abandonnées avec preuves, 1 morte à la source) — 62 modules connecteurs dans sortika/connectors/ et 70 fiches de conformité générées dans docs/connecteurs/.

Cadence de resync : horaire — le watcher PM2 sorti-ka-sync (run.py watch --interval 3600) visite les sources en continu ; chaque événement passe par la normalisation (schema.py + normalize.py), l'upsert par hash, le délai de grâce (2 syncs) et l'alerte de dérive. Les connecteurs fragiles passent par une chaîne de fetch anti-bot résiliente (Oxylabs → Scrapfly → Bright Data).

# Architecture

connecteurs (1 module / source)    normalisation (Event)       SQLite (diff + grâce)
sortika/connectors/*.py        →   schema.py + normalize.py →  db.py
      ▲ auto-découverts             + regions.py (MAMH)            │
      │                                                            ▼
watcher horaire (PM2)           frontend SPA + fiches   ←   API FastAPI + SSR SEO
run.py watch                    frontend/index.html          web.py + seo.py

• Backend : Python 3.14 + FastAPI (uvicorn) — API JSON, SSR SEO des fiches, stats, PDF (fpdf2), SSO/favoris KA ID (auth.py, hubfav.py), personnalisation (kaid.py).
• Base de données : SQLite — événements, diff par hash, délai de grâce, quarantaine, historique de syncs, géocodage (geocode.py, venues.py — annuaire de salles appris/OSM/Nominatim).
• Frontend : SPA sans build (HTML/JS, routeur History API), design system Groupe KA « éditorial sharp » (ka-ui), KA Tabbar mobile, widget KA Agent.
• Anti-bot : chaîne résiliente Oxylabs → Scrapfly → Bright Data (Atuvu via SCRAPFLY_API_KEY).

# API — endpoints principaux

# Données & conformité

• Provenance : uniquement des sources publiques — API de billetteries, données ouvertes officielles (SIT Québec CC 4.0, Montréal CC BY 4.0…), pages publiques structurées (JSON-LD). Chaque fiche cite et lie sa source originale.
• Cadence : resync horaire (watcher run.py watch --interval 3600) ; retrait doux après 2 syncs d'absence, alerte de dérive par source.
• Index fidèle, pas une billetterie : aucun prix inventé, aucune date devinée ; price_label original conservé ; la billetterie encaisse, Sorti·Ka référence.
• Registre auditable : data/sources.json — 68 sources dont 61 actives ; chaque abandon est documenté avec preuves (Zeffy, Showpass, Weezevent…).
• Fiches de conformité : docs/CONFORMITE.md + 70 fiches générées dans docs/connecteurs/ (base d'accès légale, extraction, cadence par source).

# Structure du repo

# Démarrage rapide

ssh M3U96a && cd ~/apps/sorti-ka
python3 -m venv .venv && .venv/bin/pip install -r requirements.txt   # au besoin
.venv/bin/python -m pytest tests/ -q          # 131 tests — fixtures réelles, zéro réseau
.venv/bin/python run.py sync                  # ingestion des sources
.venv/bin/python run.py web --port 8120       # API + frontend + SSR
.venv/bin/python run.py watch --interval 3600 # watcher horaire (en prod : PM2)

# Développement (remote-first)

⚠️ La source de vérité est le repo git sur le nœud M3U96a (~/apps/sorti-ka) — on n'édite jamais les copies laptop. Toute modification se fait sur le nœud via SSH : édition, tests, redémarrage PM2, puis commit + push depuis le nœud.

• Remote origin = spbgit (git perso, https://git.spboucher.ai) — sur M3U96a, l'origin est le chemin local /Users/simon-pierreboucher/srv/git/sorti-ka.git (bare repo).

cd ~/apps/sorti-ka
.venv/bin/python -m pytest tests/ -q          # avant de pousser
pm2 restart sorti-ka-web                      # après changement
git add <fichiers> && git commit -m "…" && git push origin main

# Variables d'environnement

Noms seulement — aucun secret n'est versionné (gabarit : .env.example).

# Déploiement

# Documentation

• Guide utilisateur en ligne : www.sorti-ka.com/doc/ — à quoi sert le site, utilisation en 4 étapes, provenance des données, FAQ.
• Guide PDF téléchargeable : sorti-ka-documentation.pdf.
• Conformité & connecteurs : docs/CONFORMITE.md + une fiche par connecteur dans docs/connecteurs/ (70 fiches).

# Historique

# Écosystème Groupe KA

# Contact

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

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

Ce dépôt vit sur spbgit (git perso — https://git.spboucher.ai).