docs: documentation standardisée des connecteurs (générateur rejouable)

- scripts/gen_connector_docs.py : générateur rejouable qui croise
  data/sources.json, l introspection des connecteurs (endpoints, pagination,
  backend, plafonds env, en-têtes) et la BD live (volumétrie, complétude
  GPS/prix/heure/artistes/image/salle, exemples réels, sync_log)
- docs/connecteurs/ : INDEX.md + 18 fiches (sections fixes : Description,
  Accès, Champs récupérés → schéma, Fréquence & budgets, Volumétrie &
  complétude live, Erreurs & dépannage, Licence/attribution avec mentions
  requises CC BY Montréal / CC 4.0 SITQ & Laval, Historique incl. vagues
  d enrichissement 2026-08-18 7d9d1b0 et 65d2d33)

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

Simon-Pierre Boucher committed 2 mo ago (Aug 18, 2026) parent 65d2d33 Browse files

20 changed files +2,093 −0

added docs/connecteurs/INDEX.md +41 −0

++# Sorti-Ka — Connecteurs de sources d'événements
++
++> Index généré le 2026-08-18 03:22 EDT par `scripts/gen_connector_docs.py` (rejouable : `python3 scripts/gen_connector_docs.py`). Croise `data/sources.json`, l'introspection de `sortika/connectors/*.py` et la base live `data/sortika.db`.
++
++**18 sources au registre** — 11 actives/prêtes, 7 abandonnées · **18292 événements en base** (dont 15820 actifs).
++
++⚠️ **Attributions requises** : Ville de Montréal (CC BY 4.0) ; SIT Québec / Ministère du Tourisme et Ville de Laval (CC 4.0 — Données Québec). Détails dans chaque fiche, section « Licence / attribution ».
++
++## Sources actives / prêtes
++
++| Source | Type | Statut | Actifs | GPS | Prix | Heure | Artistes | Image | Salle | Dernier sync |
++|---|---|---|---|---|---|---|---|---|---|---|
++| [SIT Québec — Ministère du Tourisme](sitq.md) | donnees-ouvertes | actif | 1598 | 97 % | 0 % | 0 % | 0 % | 35 % | 66 % | 2026-08-18 02:41 |
++| [Ville de Montréal — Événements publics](montreal.md) | donnees-ouvertes | actif | 5679 | 97 % | 100 % | 10 % | 0 % | 58 % | 4 % | 2026-08-18 02:41 |
++| [Le point de vente — billetterie québécoise](lepointdevente.md) | billetterie | actif | 1787 | 27 % | 31 % | 94 % | 1 % | 100 % | 99 % | 2026-08-18 02:41 |
++| [Ville de Laval — Calendrier des activités](laval.md) | donnees-ouvertes | actif | 277 | 51 % | 0 % | 95 % | 0 % | 98 % | 90 % | 2026-08-18 02:35 |
++| [Ville de Sherbrooke — Calendrier des événements](sherbrooke.md) | municipal | actif | 271 | 0 % | 100 % | 88 % | 0 % | 100 % | 0 % | 2026-08-18 02:41 |
++| [evenko — grands concerts et festivals](evenko.md) | promoteur | actif | 423 | 77 % | 0 % | 99 % | 99 % | 100 % | 100 % | 2026-08-18 02:35 |
++| [Atuvu.ca — calendrier culturel](atuvu.md) | agregateur | actif | 145 | 62 % | 35 % | 0 % | 0 % | 100 % | 100 % | 2026-08-18 02:31 |
++| [La Vitrine culturelle](lavitrine.md) | billetterie | actif | 5127 | 52 % | 0 % | 0 % | 0 % | 100 % | 100 % | 2026-08-18 02:35 |
++| [Ville de Brossard — Calendrier des événements](brossard.md) | municipal | actif | 262 | 0 % | 0 % | 54 % | 0 % | 55 % | 53 % | 2026-08-18 02:35 |
++| [Ticketmaster — Discovery API (Québec)](ticketmaster.md) | billetterie | prêt — clé requise | 0 | — | — | — | — | — | — | 2026-08-18 02:41 |
++| [Bandsintown — dates de concerts par artiste](bandsintown.md) | agregateur | actif | 251 | 100 % | 1 % | 100 % | 100 % | 10 % | 100 % | 2026-08-18 02:32 |
++
++## Sources abandonnées
++
++| Source | Type | Raison |
++|---|---|---|
++| [Ville de Longueuil — Événements](longueuil.md) | donnees-ouvertes | Jeu de données périmé — dernière date d'événement : 2017-03 (vérifié 2026-08-17) |
++| [Ville de Saguenay — Événements culturels](saguenay.md) | donnees-ouvertes | Jeu de données périmé — dernière date d'événement : 2022-06 (vérifié 2026-08-17) |
++| [Ville de Repentigny — Événements](repentigny.md) | donnees-ouvertes | Jeu de données périmé — dernière date d'événement : 2021-09 (vérifié 2026-08-17) |
++| [Ville de Gatineau — Événements](gatineau.md) | municipal | Aucun jeu de données « événements » sur Données Québec (portail Gatineau : géomatique seulement)… |
++| [Ville de Trois-Rivières — Événements](trois-rivieres.md) | municipal | API REST WordPress verrouillée (401 rest_not_logged_in) et aucun jeu « événements » sur Données … |
++| [Ville de Lévis — Calendrier](levis.md) | municipal | Site derrière un WAF (403 sur GET identifiés) et aucun jeu « événements » sur Données Québec (vé… |
++| [Ville de Terrebonne — Calendrier](terrebonne.md) | municipal | Cloudflare bloque tout GET non navigateur (403) et aucun jeu « événements » sur Données Québec (… |
++
++## Régénérer cette documentation
++
++```bash
++cd ~/apps/sorti-ka && python3 scripts/gen_connector_docs.py
++```

added docs/connecteurs/atuvu.md +108 −0

++# Atuvu.ca — calendrier culturel (`atuvu`)
++
++> Fiche générée le 2026-08-18 03:22 EDT par `scripts/gen_connector_docs.py` — ne pas éditer à la main, relancer le script.
++
++**Statut : actif** · Type : `agregateur` · Connecteur : `sortika/connectors/atuvu.py`
++
++## Description
++
++- **Source** : [Atuvu.ca — calendrier culturel](https://atuvu.ca/)
++- **Couverture** : Sorties culturelles, Grand Montréal
++- **Extraction** : Scrapfly (Cloudflare) — sitemaps lastmod + fiches .event-play (date FR + heure « 20h00 » → start_time), cache incrémental data/atuvu_cache.json, plafond 120 fiches/sync
++
++## Accès
++
++- **Type** : agregateur
++- **Endpoint** (`SITEMAP_INDEX`) : `https://atuvu.ca/atuvu_sitemap_index.xml`
++- **Auth** : Aucune côté source ; `SCRAPFLY_API_KEY` requis pour le backend Scrapfly
++- **Pagination** : parcours de sitemap XML
++- **Backend** : Scrapfly (anti-bot / rendu JS) via `base.get_scrapfly()`
++- **Throttle** : 1.0 s entre requêtes
++- **Accès légal** : robots.txt : Allow / + sitemap public
++
++<details><summary>En-tête documentaire du connecteur</summary>
++
++> connectors/atuvu.py : connecteur Atuvu.ca — calendrier culturel (Grand Montréal +)
++> Source    : atuvu.ca (théâtre, musique, humour, danse, expositions…)
++> Extraction: SCRAPFLY obligatoire (Cloudflare) — sitemaps XML publics
++> (evenements_N_2000.xml, lastmod par fiche) puis pages fiche
++> (h1, blocs .event-play : date FR, salle, ville, prix).
++> INCRÉMENTAL avec cache disque (data/atuvu_cache.json) : seules
++> les fiches nouvelles ou modifiées sont re-scrapées, plafonné à
++> ATUVU_MAX_FETCH pages/sync pour contenir le coût en crédits.
++> Accès     : robots.txt « User-Agent: * / Allow: / » + sitemap public.
++> Prix      : bloc .price-reg de la fiche (prix régulier) → price_min ;
++> « Invitation gratuite » = offre membre, PAS gratuité → ignorée.
++
++</details>
++
++## Champs récupérés → schéma
++
++Complétude mesurée sur les **145 événements actifs** de la source ; exemples tirés d'un événement réel (`atuvu:requiem-de-mozart-2026-11-07`).
++
++| Champ (`events.*`) | Description | Complétude | Exemple réel |
++|---|---|---|---|
++| `title` — Titre | titre de l'événement | 100 % | Requiem de Mozart |
++| `description` — Description | texte descriptif (source ou fiche détail) | 0 % | ∅ |
++| `url` — URL | lien vers la fiche originale / billetterie | 100 % | https://atuvu.ca/billets-spectacle/requiem-de-mozart |
++| `categories` — Catégories | taxonomie canonique Sorti-Ka (JSON) | 100 % | ["musique"] |
++| `venue` — Salle (venue) | nom du lieu | 100 % | Basilique Notre-Dame de Montréal |
++| `address` — Adresse | adresse civique | 0 % | ∅ |
++| `city` — Ville | municipalité | 97 % | Montréal |
++| `region` — Région | région administrative | 93 % | Montréal |
++| `lat` — GPS (lat/lng) | coordonnées géographiques | 62 % | 45.5044365, -73.5559901 |
++| `start_date` — Date début | date locale AAAA-MM-JJ | 100 % | 2026-11-07 |
++| `end_date` — Date fin | date locale AAAA-MM-JJ | 100 % | 2026-11-07 |
++| `start_time` — Heure (start_time) | heure locale HH:MM (Québec) | 0 % | ∅ |
++| `is_free` — Gratuité (is_free) | 1 gratuit / 0 payant / NULL inconnu | 29 % | 0 |
++| `price_min` — Prix min | tarif minimal réel ($) | 35 % | 54.58 |
++| `price_label` — Libellé prix | étiquette tarifaire affichable | 29 % | 54.58 $ (prix régulier atuvu.ca) |
++| `artists` — Artistes | têtes d'affiche / lineup (JSON) | 0 % | [] |
++| `organizer` — Organisateur | promoteur / organisme | 0 % | ∅ |
++| `image` — Image | visuel (og:image ou média source) | 100 % | https://atuvu.ca/uploads/images/2026/08/requiem-mozart.jpg |
++| `website` — Site web | site officiel de l'événement | 0 % | ∅ |
++
++## Fréquence & budgets
++
++- **Cadence** : horaire (watcher PM2, incrémental)
++- **Budgets / plafonds (variables d'environnement)** :
++
++| Variable | Défaut | Rôle |
++|---|---|---|
++| `ATUVU_MAX_FETCH` | `120` | fiches/sync (coût Scrapfly) |
++- **Budget global** : géocodage Nominatim plafonné à `SORTIKA_GEOCODE_MAX` (défaut 120) requêtes réseau/cycle, toutes sources confondues (`sortika/geocode.py`, cache disque).
++
++## Volumétrie & complétude live
++
++*(mesuré le 2026-08-18 03:22 EDT dans `data/sortika.db`)*
++
++- **Événements en base** : 145 (dont **145 actifs**)
++- **GPS** : 90/145 actifs (62 %)
++- **Prix** : 51/145 actifs (35 %)
++- **Heure (start_time)** : 0/145 actifs (0 %)
++- **Artistes** : 0/145 actifs (0 %)
++- **Image** : 145/145 actifs (100 %)
++- **Salle (venue)** : 145/145 actifs (100 %)
++- **Dernier sync** : 2026-08-18 02:31 — fetched 156, +0 ajoutés, ~146 mis à jour, -0 retirés
++- **Syncs enregistrés** (sync_log) : 16
++
++## Erreurs & dépannage
++
++Aucune erreur dans `sync_log` pour cette source. ✅
++
++- Source derrière anti-bot/JS lourd → backend **Scrapfly** requis : vérifier `SCRAPFLY_API_KEY` dans `.env` et le solde de crédits Scrapfly si le connecteur ne rapporte plus rien.
++- Rejouer un sync isolé : `python3 run.py sync --source atuvu` (ou via le watcher PM2) ; inspecter ensuite `sync_log` : `sqlite3 data/sortika.db "SELECT * FROM sync_log WHERE source='atuvu' ORDER BY ts DESC LIMIT 5;"`
++
++## Licence / attribution
++
++- robots.txt : Allow / + sitemap public
++
++## Historique
++
++- **2026-08-18 — Vague 1 d'enrichissement** (commit `7d9d1b0`) : géocodage Nominatim des salles (`sortika/geocode.py`, cache disque, plafond `SORTIKA_GEOCODE_MAX`), fiches détail lepointdevente (description, heure, tarifs réels `/plugins/rates/<id>`), contacts Tourinsoft (SITQ), heure locale Montréal via JSON-LD.
++- **2026-08-18 — Vague 2 d'enrichissement** (commit `65d2d33`) : colonnes additives `events.start_time` (HH:MM locale QC) et `events.artists` (JSON) + migration auto ; heure captée partout où la source la publie (lepointdevente, evenko, Laval, Sherbrooke, Montréal, atuvu) ; artistes (headliners evenko, lineup Bandsintown, attractions Ticketmaster, patrons sûrs sur les titres) ; 3 nouveaux connecteurs (brossard, ticketmaster, bandsintown).
++
++Commits touchant `sortika/connectors/atuvu.py` :
++
++- `65d2d33` 2026-08-18 Vague 2 d'enrichissement : heure précise, artistes, 3 nouveaux connecteurs
++- `9164456` 2026-08-17 Sorti·Ka v1 — agrégateur de sorties & événements du Québec

added docs/connecteurs/bandsintown.md +113 −0

++# Bandsintown — dates de concerts par artiste (`bandsintown`)
++
++> Fiche générée le 2026-08-18 03:22 EDT par `scripts/gen_connector_docs.py` — ne pas éditer à la main, relancer le script.
++
++**Statut : actif** · Type : `agregateur` · Connecteur : `sortika/connectors/bandsintown.py`
++
++## Description
++
++- **Source** : [Bandsintown — dates de concerts par artiste](https://rest.bandsintown.com/)
++- **Couverture** : Concerts au Québec des artistes en tournée connus de la base
++- **Extraction** : API publique /artists/{artiste}/events (app_id format widget « js_www.sorti-ka.com », testé accepté 2026-08 ; un app_id arbitraire simple est refusé) — pas de recherche géographique : on interroge les artistes déjà extraits de la base (evenko/lepointdevente/ticketmaster, événements à venir), plafond 100 artistes/sync avec rotation et cache data/bandsintown_cache.json (re-visite 3 j) ; on ne garde que les dates au Québec (venue.region=QC) : datetime local (date+heure), salle géolocalisée, lineup → artistes, free → gratuité, lien billets
++
++## Accès
++
++- **Type** : agregateur
++- **Endpoint** (`API`) : `https://rest.bandsintown.com/artists/{artist}/events`
++- **Auth** : `app_id` d'identification (`BANDSINTOWN_APP_ID`, format widget accepté)
++- **Pagination** : aucune (flux unique)
++- **Backend** : GET direct `requests` (throttlé, UA `SortiKa/1.0` identifié)
++- **Throttle** : 0.5 s entre requêtes
++- **Accès légal** : API publique Bandsintown (app_id d'identification) — usage index + lien vers la fiche originale
++
++<details><summary>En-tête documentaire du connecteur</summary>
++
++> connectors/bandsintown.py : connecteur Bandsintown (API publique par artiste)
++> Source    : rest.bandsintown.com/artists/{artiste}/events — API publique
++> (app_id d'identification ; le format « js_<domaine> » des
++> widgets officiels est accepté, testé 2026-08 — un app_id
++> arbitraire simple est refusé « not authorized »).
++> Approche  : l'API ne permet pas de recherche géographique → on interroge
++> les artistes déjà connus de la base (colonne `artists` extraite
++> d'evenko / lepointdevente / ticketmaster, événements à venir)
++> et on ne garde que leurs dates au QUÉBEC (venue.region = QC).
++> Volume    : plafond BIT_ARTIST_MAX artistes/sync (défaut 100), rotation par
++> ancienneté via cache disque (data/bandsintown_cache.json) ; les
++> événements des artistes déjà sondés sont ré-émis depuis le
++> cache entre deux visites (re-visite après 3 jours).
++> Champs    : datetime local (date + heure), salle géolocalisée (lat/lng),
++> lineup → artistes, `free` → is_free, offres/billets → url,
++> image de l'artiste.
++
++</details>
++
++## Champs récupérés → schéma
++
++Complétude mesurée sur les **251 événements actifs** de la source ; exemples tirés d'un événement réel (`bandsintown:108747079`).
++
++| Champ (`events.*`) | Description | Complétude | Exemple réel |
++|---|---|---|---|
++| `title` — Titre | titre de l'événement | 100 % | Doug St-Louis & Dj Chuck / Ptit Gros Bison à Grenville en Fête |
++| `description` — Description | texte descriptif (source ou fiche détail) | 18 % | Au Parc Normand-Woodbury à Grenville. Spectacle Gratuit Ils seront en duo pour vous faire danser… |
++| `url` — URL | lien vers la fiche originale / billetterie | 100 % | https://www.bandsintown.com/e/108747079?app_id=js_www.sorti-ka.com&came_from=267&utm_medium=api&… |
++| `categories` — Catégories | taxonomie canonique Sorti-Ka (JSON) | 100 % | ["musique"] |
++| `venue` — Salle (venue) | nom du lieu | 100 % | Doug St-Louis & Dj Chuck / Ptit Gros Bison à Grenville en Fête |
++| `address` — Adresse | adresse civique | 98 % | 21 Rue Tri Jean |
++| `city` — Ville | municipalité | 100 % | Grenville |
++| `region` — Région | région administrative | 98 % | Laurentides |
++| `lat` — GPS (lat/lng) | coordonnées géographiques | 100 % | 45.630063, -74.600568 |
++| `start_date` — Date début | date locale AAAA-MM-JJ | 100 % | 2026-08-22 |
++| `end_date` — Date fin | date locale AAAA-MM-JJ | 100 % | 2026-08-22 |
++| `start_time` — Heure (start_time) | heure locale HH:MM (Québec) | 100 % | 20:30 |
++| `is_free` — Gratuité (is_free) | 1 gratuit / 0 payant / NULL inconnu | 1 % | 1 |
++| `price_min` — Prix min | tarif minimal réel ($) | 0 % | ∅ |
++| `price_label` — Libellé prix | étiquette tarifaire affichable | 0 % | ∅ |
++| `artists` — Artistes | têtes d'affiche / lineup (JSON) | 100 % | ["Doug St-Louis", "P'tit Gros Bison"] |
++| `organizer` — Organisateur | promoteur / organisme | 0 % | ∅ |
++| `image` — Image | visuel (og:image ou média source) | 10 % | https://photos.bandsintown.com/large/25853181.jpeg |
++| `website` — Site web | site officiel de l'événement | 0 % | ∅ |
++
++## Fréquence & budgets
++
++- **Cadence** : horaire (watcher PM2, rotation d'artistes)
++- **Budgets / plafonds (variables d'environnement)** :
++
++| Variable | Défaut | Rôle |
++|---|---|---|
++| `BANDSINTOWN_APP_ID` | `js_www.sorti-ka.com` | — |
++| `BIT_ARTIST_MAX` | `100` | artistes/sync |
++- **Budget global** : géocodage Nominatim plafonné à `SORTIKA_GEOCODE_MAX` (défaut 120) requêtes réseau/cycle, toutes sources confondues (`sortika/geocode.py`, cache disque).
++
++## Volumétrie & complétude live
++
++*(mesuré le 2026-08-18 03:22 EDT dans `data/sortika.db`)*
++
++- **Événements en base** : 251 (dont **251 actifs**)
++- **GPS** : 251/251 actifs (100 %)
++- **Prix** : 2/251 actifs (1 %)
++- **Heure (start_time)** : 250/251 actifs (100 %)
++- **Artistes** : 251/251 actifs (100 %)
++- **Image** : 24/251 actifs (10 %)
++- **Salle (venue)** : 251/251 actifs (100 %)
++- **Dernier sync** : 2026-08-18 02:32 — fetched 251, +143 ajoutés, ~0 mis à jour, -0 retirés
++- **Syncs enregistrés** (sync_log) : 2
++
++## Erreurs & dépannage
++
++Aucune erreur dans `sync_log` pour cette source. ✅
++
++- L'API n'accepte que certains formats d'`app_id` : le format widget `js_www.sorti-ka.com` est testé accepté (2026-08) ; un app_id arbitraire simple est refusé.
++- Rejouer un sync isolé : `python3 run.py sync --source bandsintown` (ou via le watcher PM2) ; inspecter ensuite `sync_log` : `sqlite3 data/sortika.db "SELECT * FROM sync_log WHERE source='bandsintown' ORDER BY ts DESC LIMIT 5;"`
++
++## Licence / attribution
++
++- API publique Bandsintown (app_id d'identification) — usage index + lien vers la fiche originale
++
++## Historique
++
++- **2026-08-18 — Vague 1 d'enrichissement** (commit `7d9d1b0`) : géocodage Nominatim des salles (`sortika/geocode.py`, cache disque, plafond `SORTIKA_GEOCODE_MAX`), fiches détail lepointdevente (description, heure, tarifs réels `/plugins/rates/<id>`), contacts Tourinsoft (SITQ), heure locale Montréal via JSON-LD.
++- **2026-08-18 — Vague 2 d'enrichissement** (commit `65d2d33`) : colonnes additives `events.start_time` (HH:MM locale QC) et `events.artists` (JSON) + migration auto ; heure captée partout où la source la publie (lepointdevente, evenko, Laval, Sherbrooke, Montréal, atuvu) ; artistes (headliners evenko, lineup Bandsintown, attractions Ticketmaster, patrons sûrs sur les titres) ; 3 nouveaux connecteurs (brossard, ticketmaster, bandsintown).
++
++Commits touchant `sortika/connectors/bandsintown.py` :
++
++- `65d2d33` 2026-08-18 Vague 2 d'enrichissement : heure précise, artistes, 3 nouveaux connecteurs

added docs/connecteurs/brossard.md +111 −0

++# Ville de Brossard — Calendrier des événements (`brossard`)
++
++> Fiche générée le 2026-08-18 03:22 EDT par `scripts/gen_connector_docs.py` — ne pas éditer à la main, relancer le script.
++
++**Statut : actif** · Type : `municipal` · Connecteur : `sortika/connectors/brossard.py`
++
++## Description
++
++- **Source** : [Ville de Brossard — Calendrier des événements](https://brossard.ca/calendrier-des-evenements/)
++- **Couverture** : Événements municipaux et de bibliothèque, Brossard (Montérégie)
++- **Extraction** : API REST WordPress publique /wp-json/wp/v2/city-event (JSON paginé, ~400 fiches) + dates/heures par fiche : bannière « Cet événement aura lieu le … » (fiches ville) ou JSON-LD Event (fiches biblio.brossard.ca) — cache incrémental data/brossard_cache.json, 80 fiches/sync, re-visite 7 j ; repli : date entre parenthèses dans le titre
++
++## Accès
++
++- **Type** : municipal
++- **Endpoint** (`API`) : `https://brossard.ca/wp-json/wp/v2/city-event`
++- **Auth** : Aucune (accès public, identification honnête par User-Agent)
++- **Pagination** : par numéro de page, per_page
++- **Backend** : GET direct `requests` (throttlé, UA `SortiKa/1.0` identifié)
++- **Throttle** : 0.8 s entre requêtes
++- **Accès légal** : API REST WordPress publique (aucune authentification) — GET throttlés 0,8 s, identification honnête
++
++<details><summary>En-tête documentaire du connecteur</summary>
++
++> connectors/brossard.py : connecteur Ville de Brossard — calendrier des
++> événements municipaux (brossard.ca, Montérégie)
++> Source    : API REST WordPress publique — type de contenu `city-event`
++> (~400 événements : bibliothèque, conférences, ateliers,
++> spectacles familiaux). Fraîcheur vérifiée 2026-08 (fiches
++> publiées en août 2026 pour des dates jusqu'en décembre 2026).
++> Extraction: 1) liste JSON /wp-json/wp/v2/city-event (paginée, champs
++> title/link/content/modified) ; 2) dates + heures par fiche :
++> bannière « Cet événement aura lieu le 6 décembre 2026, de
++> 15 h 00 à 16 h 00 » (fiches ville) ou JSON-LD Event
++> (fiches biblio.brossard.ca, redirection suivie) — cache disque
++> incrémental data/brossard_cache.json, plafond
++> BROSSARD_DETAIL_MAX fiches/sync, re-visite 7 jours.
++> Accès     : API REST WordPress publique (aucune authentification), GET
++> throttlés, identification honnête. robots.txt : Allow.
++> Prix      : non publié par la source → jamais inventé.
++
++</details>
++
++## Champs récupérés → schéma
++
++Complétude mesurée sur les **262 événements actifs** de la source ; exemples tirés d'un événement réel (`brossard:37979`).
++
++| Champ (`events.*`) | Description | Complétude | Exemple réel |
++|---|---|---|---|
++| `title` — Titre | titre de l'événement | 100 % | Atelier libre : crée ton bracelet d’amitié (26 septembre 2026) |
++| `description` — Description | texte descriptif (source ou fiche détail) | 100 % | Dans le cadre des Journées de la culture, viens créer ton propre bracelet d’amitié ! Choisis par… |
++| `url` — URL | lien vers la fiche originale / billetterie | 100 % | https://brossard.ca/calendrier-evenements/atelier-libre-cree-ton-bracelet-damitie-26-septembre-2… |
++| `categories` — Catégories | taxonomie canonique Sorti-Ka (JSON) | 100 % | ["conference"] |
++| `venue` — Salle (venue) | nom du lieu | 53 % | Bibliothèque de Brossard Georgette-Lepage |
++| `address` — Adresse | adresse civique | 53 % | 7855, av San Francisco |
++| `city` — Ville | municipalité | 100 % | Brossard |
++| `region` — Région | région administrative | 100 % | Montérégie |
++| `lat` — GPS (lat/lng) | coordonnées géographiques | 0 % | 45.4551469, -73.4682277 |
++| `start_date` — Date début | date locale AAAA-MM-JJ | 100 % | 2026-09-26 |
++| `end_date` — Date fin | date locale AAAA-MM-JJ | 100 % | 2026-09-26 |
++| `start_time` — Heure (start_time) | heure locale HH:MM (Québec) | 54 % | 13:00 |
++| `is_free` — Gratuité (is_free) | 1 gratuit / 0 payant / NULL inconnu | 0 % | ∅ |
++| `price_min` — Prix min | tarif minimal réel ($) | 0 % | ∅ |
++| `price_label` — Libellé prix | étiquette tarifaire affichable | 0 % | ∅ |
++| `artists` — Artistes | têtes d'affiche / lineup (JSON) | 0 % | [] |
++| `organizer` — Organisateur | promoteur / organisme | 100 % | Ville de Brossard |
++| `image` — Image | visuel (og:image ou média source) | 55 % | https://biblio.brossard.ca/wp-content/uploads/2026/07/bracelets_amitie.jpg |
++| `website` — Site web | site officiel de l'événement | 0 % | ∅ |
++
++## Fréquence & budgets
++
++- **Cadence** : horaire (watcher PM2, incrémental)
++- **Budgets / plafonds (variables d'environnement)** :
++
++| Variable | Défaut | Rôle |
++|---|---|---|
++| `BROSSARD_DETAIL_MAX` | `80` | fiches/sync |
++- **Budget global** : géocodage Nominatim plafonné à `SORTIKA_GEOCODE_MAX` (défaut 120) requêtes réseau/cycle, toutes sources confondues (`sortika/geocode.py`, cache disque).
++
++## Volumétrie & complétude live
++
++*(mesuré le 2026-08-18 03:22 EDT dans `data/sortika.db`)*
++
++- **Événements en base** : 262 (dont **262 actifs**)
++- **GPS** : 1/262 actifs (0 %)
++- **Prix** : 0/262 actifs (0 %)
++- **Heure (start_time)** : 141/262 actifs (54 %)
++- **Artistes** : 0/262 actifs (0 %)
++- **Image** : 145/262 actifs (55 %)
++- **Salle (venue)** : 138/262 actifs (53 %)
++- **Dernier sync** : 2026-08-18 02:35 — fetched 262, +11 ajoutés, ~56 mis à jour, -0 retirés
++- **Syncs enregistrés** (sync_log) : 2
++
++## Erreurs & dépannage
++
++Aucune erreur dans `sync_log` pour cette source. ✅
++
++- Rejouer un sync isolé : `python3 run.py sync --source brossard` (ou via le watcher PM2) ; inspecter ensuite `sync_log` : `sqlite3 data/sortika.db "SELECT * FROM sync_log WHERE source='brossard' ORDER BY ts DESC LIMIT 5;"`
++
++## Licence / attribution
++
++- API REST WordPress publique (aucune authentification) — GET throttlés 0,8 s, identification honnête
++
++## Historique
++
++- **2026-08-18 — Vague 1 d'enrichissement** (commit `7d9d1b0`) : géocodage Nominatim des salles (`sortika/geocode.py`, cache disque, plafond `SORTIKA_GEOCODE_MAX`), fiches détail lepointdevente (description, heure, tarifs réels `/plugins/rates/<id>`), contacts Tourinsoft (SITQ), heure locale Montréal via JSON-LD.
++- **2026-08-18 — Vague 2 d'enrichissement** (commit `65d2d33`) : colonnes additives `events.start_time` (HH:MM locale QC) et `events.artists` (JSON) + migration auto ; heure captée partout où la source la publie (lepointdevente, evenko, Laval, Sherbrooke, Montréal, atuvu) ; artistes (headliners evenko, lineup Bandsintown, attractions Ticketmaster, patrons sûrs sur les titres) ; 3 nouveaux connecteurs (brossard, ticketmaster, bandsintown).
++
++Commits touchant `sortika/connectors/brossard.py` :
++
++- `65d2d33` 2026-08-18 Vague 2 d'enrichissement : heure précise, artistes, 3 nouveaux connecteurs

added docs/connecteurs/evenko.md +105 −0

++# evenko — grands concerts et festivals (`evenko`)
++
++> Fiche générée le 2026-08-18 03:22 EDT par `scripts/gen_connector_docs.py` — ne pas éditer à la main, relancer le script.
++
++**Statut : actif** · Type : `promoteur` · Connecteur : `sortika/connectors/evenko.py`
++
++## Description
++
++- **Source** : [evenko — grands concerts et festivals](https://evenko.ca/fr/evenements)
++- **Couverture** : Grands concerts (Centre Bell, Place Bell, MTELUS…), festivals (Osheaga, ÎleSoniq…)
++- **Extraction** : API /api/search (proxy Algolia) — format percé : GET ?body=base64({params:[query,options],lang:'fr-CA'}), filters entity_type:evenko_show, ~5 requêtes/sync ; heure locale du spectacle via show_time (epoch → America/Montreal, respect de hide_show_time) ; artistes = champ headliners explicite ; gratuité : champ free (sondé null sur 100 % des hits, 2026-08) + étiquettes « gratuit » (event_tag/promotional_tag) ; aucun montant exposé par l'index
++
++## Accès
++
++- **Type** : promoteur
++- **Endpoint** (`API`) : `https://evenko.ca/api/search`
++- **Auth** : Aucune (accès public, identification honnête par User-Agent)
++- **Pagination** : par numéro de page
++- **Backend** : GET direct `requests` (throttlé, UA `SortiKa/1.0` identifié)
++- **Accès légal** : robots.txt : Allow /api/search* (explicite) — lien billets = URL Ticketmaster officielle
++
++<details><summary>En-tête documentaire du connecteur</summary>
++
++> connectors/evenko.py : connecteur evenko — grands concerts & festivals
++> Source    : evenko.ca (promoteur : Centre Bell, Place Bell, MTELUS, Osheaga…)
++> Extraction: endpoint /api/search (proxy Algolia interne) — EXPLICITEMENT
++> permis par robots.txt (« Allow: /api/search* »). Format percé
++> dans leur bundle JS : GET ?body=base64(JSON{params:[query,
++> options], lang:"fr-CA"}). ~14 requêtes/sync (100 hits/page).
++> Accès     : robots.txt Allow /api/search* ; GET throttlés, identification
++> honnête ; lien billets = URL Ticketmaster officielle du hit.
++> Prix      : champ `free` de la source → is_free, MAIS sondé null sur
++> 100 % des hits (462/462, vérifié 2026-08) et l'index ne porte
++> aucun montant (additional_information.regular_ticket = libellés
++> + URLs Ticketmaster seulement, filtre free:true → 0 hit).
++> Complément honnête : étiquettes explicites « gratuit » dans
++> event_tag / promotional_tag → is_free=True. On n'invente rien.
++
++</details>
++
++## Champs récupérés → schéma
++
++Complétude mesurée sur les **423 événements actifs** de la source ; exemples tirés d'un événement réel (`evenko:e008791`).
++
++| Champ (`events.*`) | Description | Complétude | Exemple réel |
++|---|---|---|---|
++| `title` — Titre | titre de l'événement | 100 % | Disney Sur Glace présente La Magie en Famille |
++| `description` — Description | texte descriptif (source ou fiche détail) | 18 % | ∅ |
++| `url` — URL | lien vers la fiche originale / billetterie | 100 % | https://www.ticketmaster.ca/event/310064E3C5686712?lang=fr-ca&brand=placebell |
++| `categories` — Catégories | taxonomie canonique Sorti-Ka (JSON) | 100 % | ["autre"] |
++| `venue` — Salle (venue) | nom du lieu | 100 % | Place Bell |
++| `address` — Adresse | adresse civique | 0 % | ∅ |
++| `city` — Ville | municipalité | 100 % | Laval |
++| `region` — Région | région administrative | 100 % | Laval |
++| `lat` — GPS (lat/lng) | coordonnées géographiques | 77 % | 45.5558423, -73.7216633 |
++| `start_date` — Date début | date locale AAAA-MM-JJ | 100 % | 2026-12-17 |
++| `end_date` — Date fin | date locale AAAA-MM-JJ | 100 % | 2026-12-17 |
++| `start_time` — Heure (start_time) | heure locale HH:MM (Québec) | 99 % | 19:00 |
++| `is_free` — Gratuité (is_free) | 1 gratuit / 0 payant / NULL inconnu | 0 % | ∅ |
++| `price_min` — Prix min | tarif minimal réel ($) | 0 % | ∅ |
++| `price_label` — Libellé prix | étiquette tarifaire affichable | 0 % | ∅ |
++| `artists` — Artistes | têtes d'affiche / lineup (JSON) | 99 % | ["Disney Sur Glace présente La Magie en Famille"] |
++| `organizer` — Organisateur | promoteur / organisme | 100 % | evenko |
++| `image` — Image | visuel (og:image ou média source) | 100 % | https://images.ctfassets.net/3yxl57nu0yl4/3sI9AuDa7Ju1B2dtmFzVtY/a977ac5c95df131068a94762069db2f… |
++| `website` — Site web | site officiel de l'événement | 0 % | ∅ |
++
++## Fréquence & budgets
++
++- **Cadence** : horaire (watcher PM2)
++- **Budget global** : géocodage Nominatim plafonné à `SORTIKA_GEOCODE_MAX` (défaut 120) requêtes réseau/cycle, toutes sources confondues (`sortika/geocode.py`, cache disque).
++
++## Volumétrie & complétude live
++
++*(mesuré le 2026-08-18 03:22 EDT dans `data/sortika.db`)*
++
++- **Événements en base** : 423 (dont **423 actifs**)
++- **GPS** : 327/423 actifs (77 %)
++- **Prix** : 0/423 actifs (0 %)
++- **Heure (start_time)** : 420/423 actifs (99 %)
++- **Artistes** : 420/423 actifs (99 %)
++- **Image** : 423/423 actifs (100 %)
++- **Salle (venue)** : 423/423 actifs (100 %)
++- **Dernier sync** : 2026-08-18 02:35 — fetched 423, +0 ajoutés, ~9 mis à jour, -0 retirés
++- **Syncs enregistrés** (sync_log) : 18
++
++## Erreurs & dépannage
++
++Aucune erreur dans `sync_log` pour cette source. ✅
++
++- Rejouer un sync isolé : `python3 run.py sync --source evenko` (ou via le watcher PM2) ; inspecter ensuite `sync_log` : `sqlite3 data/sortika.db "SELECT * FROM sync_log WHERE source='evenko' ORDER BY ts DESC LIMIT 5;"`
++
++## Licence / attribution
++
++- robots.txt : Allow /api/search* (explicite) — lien billets = URL Ticketmaster officielle
++
++## Historique
++
++- **2026-08-18 — Vague 1 d'enrichissement** (commit `7d9d1b0`) : géocodage Nominatim des salles (`sortika/geocode.py`, cache disque, plafond `SORTIKA_GEOCODE_MAX`), fiches détail lepointdevente (description, heure, tarifs réels `/plugins/rates/<id>`), contacts Tourinsoft (SITQ), heure locale Montréal via JSON-LD.
++- **2026-08-18 — Vague 2 d'enrichissement** (commit `65d2d33`) : colonnes additives `events.start_time` (HH:MM locale QC) et `events.artists` (JSON) + migration auto ; heure captée partout où la source la publie (lepointdevente, evenko, Laval, Sherbrooke, Montréal, atuvu) ; artistes (headliners evenko, lineup Bandsintown, attractions Ticketmaster, patrons sûrs sur les titres) ; 3 nouveaux connecteurs (brossard, ticketmaster, bandsintown).
++
++Commits touchant `sortika/connectors/evenko.py` :
++
++- `65d2d33` 2026-08-18 Vague 2 d'enrichissement : heure précise, artistes, 3 nouveaux connecteurs
++- `7d9d1b0` 2026-08-18 Enrichissement des connecteurs + géocodage des salles
++- `9164456` 2026-08-17 Sorti·Ka v1 — agrégateur de sorties & événements du Québec

added docs/connecteurs/gatineau.md +45 −0

++# Ville de Gatineau — Événements (`gatineau`)
++
++> Fiche générée le 2026-08-18 03:22 EDT par `scripts/gen_connector_docs.py` — ne pas éditer à la main, relancer le script.
++
++**Statut : abandonnee** · Type : `municipal` · Connecteur : *aucun (source sans connecteur runtime)*
++
++## Description
++
++- **Source** : [Ville de Gatineau — Événements](https://www.gatineau.ca/)
++- **Couverture** : Gatineau (Outaouais)
++- **Extraction** : n/d
++- **Note** : Aucun jeu de données « événements » sur Données Québec (portail Gatineau : géomatique seulement) et site 100 % JavaScript sans API découverte (vérifié 2026-08-18)
++
++## Accès
++
++- **Type** : municipal
++- **Endpoint** : voir URL source (https://www.gatineau.ca/)
++- **Auth** : Aucune (accès public, identification honnête par User-Agent)
++- **Accès légal** : n/d
++
++## Champs récupérés → schéma
++
++*Aucun événement actif en base pour cette source — pas de schéma live à montrer.*
++
++## Fréquence & budgets
++
++- **Cadence** : n/d
++- **Budget global** : géocodage Nominatim plafonné à `SORTIKA_GEOCODE_MAX` (défaut 120) requêtes réseau/cycle, toutes sources confondues (`sortika/geocode.py`, cache disque).
++
++## Volumétrie & complétude live
++
++*Source sans connecteur runtime : aucune donnée en base.*
++
++## Erreurs & dépannage
++
++
++## Licence / attribution
++
++- n/d
++
++## Historique
++
++- **Source abandonnée** — Aucun jeu de données « événements » sur Données Québec (portail Gatineau : géomatique seulement) et site 100 % JavaScript sans API découverte (vérifié 2026-08-18)
++- **2026-08-18 — Vague 1 d'enrichissement** (commit `7d9d1b0`) : géocodage Nominatim des salles (`sortika/geocode.py`, cache disque, plafond `SORTIKA_GEOCODE_MAX`), fiches détail lepointdevente (description, heure, tarifs réels `/plugins/rates/<id>`), contacts Tourinsoft (SITQ), heure locale Montréal via JSON-LD.
++- **2026-08-18 — Vague 2 d'enrichissement** (commit `65d2d33`) : colonnes additives `events.start_time` (HH:MM locale QC) et `events.artists` (JSON) + migration auto ; heure captée partout où la source la publie (lepointdevente, evenko, Laval, Sherbrooke, Montréal, atuvu) ; artistes (headliners evenko, lineup Bandsintown, attractions Ticketmaster, patrons sûrs sur les titres) ; 3 nouveaux connecteurs (brossard, ticketmaster, bandsintown).

added docs/connecteurs/laval.md +99 −0

++# Ville de Laval — Calendrier des activités (`laval`)
++
++> Fiche générée le 2026-08-18 03:22 EDT par `scripts/gen_connector_docs.py` — ne pas éditer à la main, relancer le script.
++
++**Statut : actif** · Type : `donnees-ouvertes` · Connecteur : `sortika/connectors/laval.py`
++
++## Description
++
++- **Source** : [Ville de Laval — Calendrier des activités](https://www.donneesquebec.ca/recherche/dataset/calendrier-des-activites)
++- **Couverture** : Activités municipales, Laval
++- **Extraction** : fichier JSON officiel (Données Québec) — EventDate/EndDate publiés en UTC (vérifié 2026-08) → convertis en date + heure locales Québec (minuit local = « toute la journée », pas d'heure)
++
++## Accès
++
++- **Type** : donnees-ouvertes
++- **Endpoint** (`FEED`) : `https://www.donneesquebec.ca/recherche/dataset/df7add74-a741-4374-b3bd-22da8921c8b3/resource/b51a25de-bd06-4247-87ba-2b1ea8228005/download/calendrier-activites.json`
++- **Endpoint** (`SITE`) : `https://www.laval.ca`
++- **Auth** : Aucune (accès public, identification honnête par User-Agent)
++- **Pagination** : par numéro de page
++- **Backend** : GET direct `requests` (throttlé, UA `SortiKa/1.0` identifié)
++- **Accès légal** : Licence CC 4.0 (Données Québec) — Ville de Laval
++
++<details><summary>En-tête documentaire du connecteur</summary>
++
++> connectors/laval.py : connecteur Ville de Laval — calendrier des activités
++> Source    : donneesquebec.ca, jeu « Calendrier des activités » (laval.ca)
++> Extraction: fichier JSON officiel (données ouvertes, licence CC 4.0)
++> Couverture: ~300 activités municipales (bibliothèques, culture, famille,
++> plein air) avec dates, catégories, clientèles, lieux, images.
++> https://www.donneesquebec.ca/recherche/dataset/calendrier-des-activites
++
++</details>
++
++## Champs récupérés → schéma
++
++Complétude mesurée sur les **277 événements actifs** de la source ; exemples tirés d'un événement réel (`laval:biblio-jeunesse-educazoo-saint-valentin-2025-02-15`).
++
++| Champ (`events.*`) | Description | Complétude | Exemple réel |
++|---|---|---|---|
++| `title` — Titre | titre de l'événement | 100 % | Éducazoo |
++| `description` — Description | texte descriptif (source ou fiche détail) | 100 % | Cadeaux, parades, chants langoureux et techniques parfois étranges : les animaux déballent un ar… |
++| `url` — URL | lien vers la fiche originale / billetterie | 100 % | https://www.laval.ca/Pages/Fr/Calendrier/biblio-jeunesse-educazoo-saint-valentin.aspx |
++| `categories` — Catégories | taxonomie canonique Sorti-Ka (JSON) | 100 % | ["conference", "musique", "famille"] |
++| `venue` — Salle (venue) | nom du lieu | 90 % | Bibliothèque Émile-Nelligan |
++| `address` — Adresse | adresse civique | 0 % | ∅ |
++| `city` — Ville | municipalité | 100 % | Laval |
++| `region` — Région | région administrative | 100 % | Laval |
++| `lat` — GPS (lat/lng) | coordonnées géographiques | 51 % | 45.5521349, -73.7077536 |
++| `start_date` — Date début | date locale AAAA-MM-JJ | 100 % | 2025-02-15 |
++| `end_date` — Date fin | date locale AAAA-MM-JJ | 100 % | 2025-02-15 |
++| `start_time` — Heure (start_time) | heure locale HH:MM (Québec) | 95 % | 14:45 |
++| `is_free` — Gratuité (is_free) | 1 gratuit / 0 payant / NULL inconnu | 0 % | ∅ |
++| `price_min` — Prix min | tarif minimal réel ($) | 0 % | ∅ |
++| `price_label` — Libellé prix | étiquette tarifaire affichable | 0 % | ∅ |
++| `artists` — Artistes | têtes d'affiche / lineup (JSON) | 0 % | [] |
++| `organizer` — Organisateur | promoteur / organisme | 100 % | Ville de Laval |
++| `image` — Image | visuel (og:image ou média source) | 98 % | https://www.laval.ca/PublishingImages/Calendrier-des-activites/bibliotheque/jeunesse-educazoo-sa… |
++| `website` — Site web | site officiel de l'événement | 0 % | ∅ |
++
++## Fréquence & budgets
++
++- **Cadence** : horaire (watcher PM2)
++- **Budget global** : géocodage Nominatim plafonné à `SORTIKA_GEOCODE_MAX` (défaut 120) requêtes réseau/cycle, toutes sources confondues (`sortika/geocode.py`, cache disque).
++
++## Volumétrie & complétude live
++
++*(mesuré le 2026-08-18 03:22 EDT dans `data/sortika.db`)*
++
++- **Événements en base** : 277 (dont **277 actifs**)
++- **GPS** : 142/277 actifs (51 %)
++- **Prix** : 0/277 actifs (0 %)
++- **Heure (start_time)** : 264/277 actifs (95 %)
++- **Artistes** : 0/277 actifs (0 %)
++- **Image** : 271/277 actifs (98 %)
++- **Salle (venue)** : 248/277 actifs (90 %)
++- **Dernier sync** : 2026-08-18 02:35 — fetched 293, +0 ajoutés, ~32 mis à jour, -0 retirés
++- **Syncs enregistrés** (sync_log) : 21
++
++## Erreurs & dépannage
++
++Aucune erreur dans `sync_log` pour cette source. ✅
++
++- Rejouer un sync isolé : `python3 run.py sync --source laval` (ou via le watcher PM2) ; inspecter ensuite `sync_log` : `sqlite3 data/sortika.db "SELECT * FROM sync_log WHERE source='laval' ORDER BY ts DESC LIMIT 5;"`
++
++## Licence / attribution
++
++- Licence CC 4.0 (Données Québec) — Ville de Laval
++
++**Mention requise (CC 4.0 — Données Québec)** : « Données de la **Ville de Laval** (Calendrier des activités), diffusées sous licence Creative Commons 4.0 via Données Québec. » L'attribution à la Ville de Laval est obligatoire.
++
++## Historique
++
++- **2026-08-18 — Vague 1 d'enrichissement** (commit `7d9d1b0`) : géocodage Nominatim des salles (`sortika/geocode.py`, cache disque, plafond `SORTIKA_GEOCODE_MAX`), fiches détail lepointdevente (description, heure, tarifs réels `/plugins/rates/<id>`), contacts Tourinsoft (SITQ), heure locale Montréal via JSON-LD.
++- **2026-08-18 — Vague 2 d'enrichissement** (commit `65d2d33`) : colonnes additives `events.start_time` (HH:MM locale QC) et `events.artists` (JSON) + migration auto ; heure captée partout où la source la publie (lepointdevente, evenko, Laval, Sherbrooke, Montréal, atuvu) ; artistes (headliners evenko, lineup Bandsintown, attractions Ticketmaster, patrons sûrs sur les titres) ; 3 nouveaux connecteurs (brossard, ticketmaster, bandsintown).
++
++Commits touchant `sortika/connectors/laval.py` :
++
++- `65d2d33` 2026-08-18 Vague 2 d'enrichissement : heure précise, artistes, 3 nouveaux connecteurs
++- `9164456` 2026-08-17 Sorti·Ka v1 — agrégateur de sorties & événements du Québec

added docs/connecteurs/lavitrine.md +110 −0

++# La Vitrine culturelle (`lavitrine`)
++
++> Fiche générée le 2026-08-18 03:22 EDT par `scripts/gen_connector_docs.py` — ne pas éditer à la main, relancer le script.
++
++**Statut : actif** · Type : `billetterie` · Connecteur : `sortika/connectors/lavitrine.py`
++
++## Description
++
++- **Source** : [La Vitrine culturelle](https://www.lavitrine.com/)
++- **Couverture** : Spectacles et sorties culturelles, Grand Montréal
++- **Extraction** : GET directs — sitemap.xml (2 000 fiches evenement + 185 exposition) + fiches HTML (bloc event_calendar), cache incrémental, 150 fiches/sync, re-visite 7 j
++
++## Accès
++
++- **Type** : billetterie
++- **Endpoint** (`SITEMAP`) : `https://www.lavitrine.com/sitemap.xml`
++- **Auth** : Aucune (accès public, identification honnête par User-Agent)
++- **Pagination** : parcours de sitemap XML
++- **Backend** : GET direct `requests` (throttlé, UA `SortiKa/1.0` identifié)
++- **Throttle** : 0.8 s entre requêtes
++- **Accès légal** : robots.txt : Allow / + Content-Signal search=yes, use=reference — usage index + lien vers la fiche originale
++
++<details><summary>En-tête documentaire du connecteur</summary>
++
++> connectors/lavitrine.py : connecteur La Vitrine culturelle (lavitrine.com)
++> Source    : billetterie/calendrier culturel — spectacles, expositions,
++> concerts (Grand Montréal + Québec + tournées).
++> Extraction: sitemap.xml public (~2 000 fiches /fr/evenement/ + 185
++> /fr/exposition/, lastmod par URL) puis pages fiche rendues
++> serveur (h1, bloc .event_calendar : jour/mois/année, salle,
++> ville ; og:image). GET directs — pas d'anti-bot.
++> INCRÉMENTAL avec cache disque (data/lavitrine_cache.json) :
++> nouvelles fiches d'abord, re-visite roulante après 7 jours,
++> plafonné à LV_MAX_FETCH fiches/sync.
++> Accès     : robots.txt « User-Agent: * / Allow: / » + Content-Signal
++> « search=yes, use=reference » → usage index + lien vers la
++> fiche originale, conforme aux signaux publiés (CLAUDE.md §15).
++> Prix      : non exposés sur la fiche → is_free inconnu (jamais inventé).
++
++</details>
++
++## Champs récupérés → schéma
++
++Complétude mesurée sur les **5127 événements actifs** de la source ; exemples tirés d'un événement réel (`lavitrine:23777-2026-11-22`).
++
++| Champ (`events.*`) | Description | Complétude | Exemple réel |
++|---|---|---|---|
++| `title` — Titre | titre de l'événement | 100 % | 100 ans de chansons françaises avec Richard Charest |
++| `description` — Description | texte descriptif (source ou fiche détail) | 0 % | ∅ |
++| `url` — URL | lien vers la fiche originale / billetterie | 100 % | https://www.lavitrine.com/fr/evenement/100-ans-de-chansons-francaises-avec-richard-charest/23777 |
++| `categories` — Catégories | taxonomie canonique Sorti-Ka (JSON) | 100 % | ["musique"] |
++| `venue` — Salle (venue) | nom du lieu | 100 % | Théâtre Petit Champlain |
++| `address` — Adresse | adresse civique | 0 % | ∅ |
++| `city` — Ville | municipalité | 100 % | Québec |
++| `region` — Région | région administrative | 100 % | Capitale-Nationale |
++| `lat` — GPS (lat/lng) | coordonnées géographiques | 52 % | 46.8115511, -71.203632 |
++| `start_date` — Date début | date locale AAAA-MM-JJ | 100 % | 2026-11-22 |
++| `end_date` — Date fin | date locale AAAA-MM-JJ | 100 % | 2026-11-22 |
++| `start_time` — Heure (start_time) | heure locale HH:MM (Québec) | 0 % | ∅ |
++| `is_free` — Gratuité (is_free) | 1 gratuit / 0 payant / NULL inconnu | 0 % | ∅ |
++| `price_min` — Prix min | tarif minimal réel ($) | 0 % | ∅ |
++| `price_label` — Libellé prix | étiquette tarifaire affichable | 0 % | ∅ |
++| `artists` — Artistes | têtes d'affiche / lineup (JSON) | 0 % | [] |
++| `organizer` — Organisateur | promoteur / organisme | 0 % | ∅ |
++| `image` — Image | visuel (og:image ou média source) | 100 % | https://lvc-medias.lavitrine.com/acf4025b-3502-5217-b26d-f3bd5a35c6dc.webp |
++| `website` — Site web | site officiel de l'événement | 0 % | ∅ |
++
++## Fréquence & budgets
++
++- **Cadence** : horaire (watcher PM2, incrémental)
++- **Budgets / plafonds (variables d'environnement)** :
++
++| Variable | Défaut | Rôle |
++|---|---|---|
++| `LV_MAX_FETCH` | `400` | fiches/sync (GET directs polis) |
++- **Budget global** : géocodage Nominatim plafonné à `SORTIKA_GEOCODE_MAX` (défaut 120) requêtes réseau/cycle, toutes sources confondues (`sortika/geocode.py`, cache disque).
++
++## Volumétrie & complétude live
++
++*(mesuré le 2026-08-18 03:22 EDT dans `data/sortika.db`)*
++
++- **Événements en base** : 5137 (dont **5127 actifs**)
++- **GPS** : 2681/5127 actifs (52 %)
++- **Prix** : 0/5127 actifs (0 %)
++- **Heure (start_time)** : 0/5127 actifs (0 %)
++- **Artistes** : 0/5127 actifs (0 %)
++- **Image** : 5127/5127 actifs (100 %)
++- **Salle (venue)** : 5125/5127 actifs (100 %)
++- **Dernier sync** : 2026-08-18 02:35 — fetched 5127, +0 ajoutés, ~5127 mis à jour, -0 retirés
++- **Syncs enregistrés** (sync_log) : 11
++
++## Erreurs & dépannage
++
++Aucune erreur dans `sync_log` pour cette source. ✅
++
++- Parcours par sitemap incrémental (`LV_MAX_FETCH` fiches/sync) : après un reset de cache, plusieurs cycles sont nécessaires pour recouvrir tout le catalogue.
++- Rejouer un sync isolé : `python3 run.py sync --source lavitrine` (ou via le watcher PM2) ; inspecter ensuite `sync_log` : `sqlite3 data/sortika.db "SELECT * FROM sync_log WHERE source='lavitrine' ORDER BY ts DESC LIMIT 5;"`
++
++## Licence / attribution
++
++- robots.txt : Allow / + Content-Signal search=yes, use=reference — usage index + lien vers la fiche originale
++
++## Historique
++
++- **2026-08-18 — Vague 1 d'enrichissement** (commit `7d9d1b0`) : géocodage Nominatim des salles (`sortika/geocode.py`, cache disque, plafond `SORTIKA_GEOCODE_MAX`), fiches détail lepointdevente (description, heure, tarifs réels `/plugins/rates/<id>`), contacts Tourinsoft (SITQ), heure locale Montréal via JSON-LD.
++- **2026-08-18 — Vague 2 d'enrichissement** (commit `65d2d33`) : colonnes additives `events.start_time` (HH:MM locale QC) et `events.artists` (JSON) + migration auto ; heure captée partout où la source la publie (lepointdevente, evenko, Laval, Sherbrooke, Montréal, atuvu) ; artistes (headliners evenko, lineup Bandsintown, attractions Ticketmaster, patrons sûrs sur les titres) ; 3 nouveaux connecteurs (brossard, ticketmaster, bandsintown).
++
++Commits touchant `sortika/connectors/lavitrine.py` :
++
++- `9164456` 2026-08-17 Sorti·Ka v1 — agrégateur de sorties & événements du Québec

added docs/connecteurs/lepointdevente.md +115 −0

++# Le point de vente — billetterie québécoise (`lepointdevente`)
++
++> Fiche générée le 2026-08-18 03:22 EDT par `scripts/gen_connector_docs.py` — ne pas éditer à la main, relancer le script.
++
++**Statut : actif** · Type : `billetterie` · Connecteur : `sortika/connectors/lepointdevente.py`
++
++## Description
++
++- **Source** : [Le point de vente — billetterie québécoise](https://lepointdevente.com/billets)
++- **Couverture** : Concerts, humour, théâtre, festivals — partout au Québec (~2 500 événements à venir)
++- **Extraction** : pages de liste HTML rendues serveur (paginées), parse des cartes (titre, date FR + heure « 17 août 2026, 20h00 » → start_time, salle, ville, image) + fiches détail /billets/<id> incrémentales (cache data/lepointdevente_cache.json, 150 fiches/sync, re-visite 7 j) : description og:description, heure précise, tarifs JSON réels via /plugins/rates/<id> → price_min/price_label/is_free ; artistes extraits des titres par patrons sûrs seulement (« Artiste - Salle », « X en concert »)
++
++## Accès
++
++- **Type** : billetterie
++- **Endpoint** (`BASE`) : `https://lepointdevente.com`
++- **Auth** : Aucune (accès public, identification honnête par User-Agent)
++- **Pagination** : par numéro de page
++- **Backend** : GET direct `requests` (throttlé, UA `SortiKa/1.0` identifié)
++- **Throttle** : 0.8 s entre requêtes
++- **Accès légal** : robots.txt : « User-Agent: * / Allow: * » — GET throttlés, identification honnête, lien direct vers chaque billetterie
++
++<details><summary>En-tête documentaire du connecteur</summary>
++
++> connectors/lepointdevente.py : connecteur Le point de vente (lepointdevente.com)
++> Source    : billetterie québécoise indépendante — concerts, humour, théâtre,
++> festivals, partout au Québec (~1 500 événements à venir).
++> Extraction: pages de liste HTML rendues serveur (/billets?page=N, paginé),
++> parse regex des cartes (titre, date FR, salle + ville, image).
++> Aucun rendu JS nécessaire.
++> Accès     : robots.txt = « User-Agent: * / Allow: * » (scraping permis) ;
++> GET throttlés 0,6 s, identification honnête, ~65 requêtes/sync.
++> Détail    : enrichissement incrémental par fiches /billets/<id> (modèle
++> lavitrine) — cache disque data/lepointdevente_cache.json,
++> plafond LPDV_DETAIL_MAX fiches/sync (défaut 150), re-visite
++> après 7 jours, throttle poli 0,8 s. Chaque fiche donne :
++> description (og:description), heure précise (data-event-name)
++> et l'id interne du widget billetterie (data-reference) →
++> tarifs JSON réels via /plugins/rates/<id> (prix TTC affichés
++> par la billetterie elle-même : price_min / price_label /
++> is_free si tous les tarifs sont à 0 $). Jamais de prix inventé.
++
++</details>
++
++## Champs récupérés → schéma
++
++Complétude mesurée sur les **1787 événements actifs** de la source ; exemples tirés d'un événement réel (`lepointdevente:98a260908001`).
++
++| Champ (`events.*`) | Description | Complétude | Exemple réel |
++|---|---|---|---|
++| `title` — Titre | titre de l'événement | 100 % | GRANDE ALLÉE - Souper tardif festif |
++| `description` — Description | texte descriptif (source ou fiche détail) | 31 % | Séance d'information des Missions commerciales de l'Université Laval!Le programme des Missions c… |
++| `url` — URL | lien vers la fiche originale / billetterie | 100 % | https://lepointdevente.com/billets/98a260908001 |
++| `categories` — Catégories | taxonomie canonique Sorti-Ka (JSON) | 100 % | ["autre"] |
++| `venue` — Salle (venue) | nom du lieu | 99 % | Grande-Allée |
++| `address` — Adresse | adresse civique | 0 % | ∅ |
++| `city` — Ville | municipalité | 100 % | Québec |
++| `region` — Région | région administrative | 98 % | Capitale-Nationale |
++| `lat` — GPS (lat/lng) | coordonnées géographiques | 27 % | 46.2897843, -72.6724193 |
++| `start_date` — Date début | date locale AAAA-MM-JJ | 100 % | 2026-09-08 |
++| `end_date` — Date fin | date locale AAAA-MM-JJ | 100 % | 2026-09-08 |
++| `start_time` — Heure (start_time) | heure locale HH:MM (Québec) | 94 % | 19:00 |
++| `is_free` — Gratuité (is_free) | 1 gratuit / 0 payant / NULL inconnu | 31 % | 1 |
++| `price_min` — Prix min | tarif minimal réel ($) | 29 % | ∅ |
++| `price_label` — Libellé prix | étiquette tarifaire affichable | 31 % | Admission générale 0 $ |
++| `artists` — Artistes | têtes d'affiche / lineup (JSON) | 1 % | [] |
++| `organizer` — Organisateur | promoteur / organisme | 0 % | ∅ |
++| `image` — Image | visuel (og:image ou média source) | 100 % | https://tpos.s3.amazonaws.com/events/98A/26/09/03/001/98a260903001-1152x648-fr-6a677853.png |
++| `website` — Site web | site officiel de l'événement | 0 % | ∅ |
++
++## Fréquence & budgets
++
++- **Cadence** : horaire (watcher PM2)
++- **Budgets / plafonds (variables d'environnement)** :
++
++| Variable | Défaut | Rôle |
++|---|---|---|
++| `LPDV_DETAIL_MAX` | `150` | fiches/sync |
++- **Budget global** : géocodage Nominatim plafonné à `SORTIKA_GEOCODE_MAX` (défaut 120) requêtes réseau/cycle, toutes sources confondues (`sortika/geocode.py`, cache disque).
++
++## Volumétrie & complétude live
++
++*(mesuré le 2026-08-18 03:22 EDT dans `data/sortika.db`)*
++
++- **Événements en base** : 4191 (dont **1787 actifs**)
++- **GPS** : 476/1787 actifs (27 %)
++- **Prix** : 547/1787 actifs (31 %)
++- **Heure (start_time)** : 1673/1787 actifs (94 %)
++- **Artistes** : 16/1787 actifs (1 %)
++- **Image** : 1787/1787 actifs (100 %)
++- **Salle (venue)** : 1777/1787 actifs (99 %)
++- **Dernier sync** : 2026-08-18 02:41 — fetched 1787, +0 ajoutés, ~164 mis à jour, -0 retirés
++- **Syncs enregistrés** (sync_log) : 22
++
++## Erreurs & dépannage
++
++Aucune erreur dans `sync_log` pour cette source. ✅
++
++- L'enrichissement par fiches détail est incrémental (cache `data/lepointdevente_cache.json`, plafond `LPDV_DETAIL_MAX`/sync, re-visite 7 j) : la complétude description/heure/prix monte au fil des cycles.
++- Rejouer un sync isolé : `python3 run.py sync --source lepointdevente` (ou via le watcher PM2) ; inspecter ensuite `sync_log` : `sqlite3 data/sortika.db "SELECT * FROM sync_log WHERE source='lepointdevente' ORDER BY ts DESC LIMIT 5;"`
++
++## Licence / attribution
++
++- robots.txt : « User-Agent: * / Allow: * » — GET throttlés, identification honnête, lien direct vers chaque billetterie
++
++## Historique
++
++- **2026-08-18 — Vague 1 d'enrichissement** (commit `7d9d1b0`) : géocodage Nominatim des salles (`sortika/geocode.py`, cache disque, plafond `SORTIKA_GEOCODE_MAX`), fiches détail lepointdevente (description, heure, tarifs réels `/plugins/rates/<id>`), contacts Tourinsoft (SITQ), heure locale Montréal via JSON-LD.
++- **2026-08-18 — Vague 2 d'enrichissement** (commit `65d2d33`) : colonnes additives `events.start_time` (HH:MM locale QC) et `events.artists` (JSON) + migration auto ; heure captée partout où la source la publie (lepointdevente, evenko, Laval, Sherbrooke, Montréal, atuvu) ; artistes (headliners evenko, lineup Bandsintown, attractions Ticketmaster, patrons sûrs sur les titres) ; 3 nouveaux connecteurs (brossard, ticketmaster, bandsintown).
++
++Commits touchant `sortika/connectors/lepointdevente.py` :
++
++- `65d2d33` 2026-08-18 Vague 2 d'enrichissement : heure précise, artistes, 3 nouveaux connecteurs
++- `7d9d1b0` 2026-08-18 Enrichissement des connecteurs + géocodage des salles
++- `9164456` 2026-08-17 Sorti·Ka v1 — agrégateur de sorties & événements du Québec

added docs/connecteurs/levis.md +45 −0

++# Ville de Lévis — Calendrier (`levis`)
++
++> Fiche générée le 2026-08-18 03:22 EDT par `scripts/gen_connector_docs.py` — ne pas éditer à la main, relancer le script.
++
++**Statut : abandonnee** · Type : `municipal` · Connecteur : *aucun (source sans connecteur runtime)*
++
++## Description
++
++- **Source** : [Ville de Lévis — Calendrier](https://www.ville.levis.qc.ca/)
++- **Couverture** : Lévis (Chaudière-Appalaches)
++- **Extraction** : n/d
++- **Note** : Site derrière un WAF (403 sur GET identifiés) et aucun jeu « événements » sur Données Québec (vérifié 2026-08-18)
++
++## Accès
++
++- **Type** : municipal
++- **Endpoint** : voir URL source (https://www.ville.levis.qc.ca/)
++- **Auth** : Aucune (accès public, identification honnête par User-Agent)
++- **Accès légal** : n/d
++
++## Champs récupérés → schéma
++
++*Aucun événement actif en base pour cette source — pas de schéma live à montrer.*
++
++## Fréquence & budgets
++
++- **Cadence** : n/d
++- **Budget global** : géocodage Nominatim plafonné à `SORTIKA_GEOCODE_MAX` (défaut 120) requêtes réseau/cycle, toutes sources confondues (`sortika/geocode.py`, cache disque).
++
++## Volumétrie & complétude live
++
++*Source sans connecteur runtime : aucune donnée en base.*
++
++## Erreurs & dépannage
++
++
++## Licence / attribution
++
++- n/d
++
++## Historique
++
++- **Source abandonnée** — Site derrière un WAF (403 sur GET identifiés) et aucun jeu « événements » sur Données Québec (vérifié 2026-08-18)
++- **2026-08-18 — Vague 1 d'enrichissement** (commit `7d9d1b0`) : géocodage Nominatim des salles (`sortika/geocode.py`, cache disque, plafond `SORTIKA_GEOCODE_MAX`), fiches détail lepointdevente (description, heure, tarifs réels `/plugins/rates/<id>`), contacts Tourinsoft (SITQ), heure locale Montréal via JSON-LD.
++- **2026-08-18 — Vague 2 d'enrichissement** (commit `65d2d33`) : colonnes additives `events.start_time` (HH:MM locale QC) et `events.artists` (JSON) + migration auto ; heure captée partout où la source la publie (lepointdevente, evenko, Laval, Sherbrooke, Montréal, atuvu) ; artistes (headliners evenko, lineup Bandsintown, attractions Ticketmaster, patrons sûrs sur les titres) ; 3 nouveaux connecteurs (brossard, ticketmaster, bandsintown).

added docs/connecteurs/longueuil.md +45 −0

++# Ville de Longueuil — Événements (`longueuil`)
++
++> Fiche générée le 2026-08-18 03:22 EDT par `scripts/gen_connector_docs.py` — ne pas éditer à la main, relancer le script.
++
++**Statut : abandonnee** · Type : `donnees-ouvertes` · Connecteur : *aucun (source sans connecteur runtime)*
++
++## Description
++
++- **Source** : [Ville de Longueuil — Événements](https://www.donneesquebec.ca/recherche/dataset/evenements)
++- **Couverture** : Longueuil (Montérégie)
++- **Extraction** : CSV (Données Québec)
++- **Note** : Jeu de données périmé — dernière date d'événement : 2017-03 (vérifié 2026-08-17)
++
++## Accès
++
++- **Type** : donnees-ouvertes
++- **Endpoint** : voir URL source (https://www.donneesquebec.ca/recherche/dataset/evenements)
++- **Auth** : Aucune (accès public, identification honnête par User-Agent)
++- **Accès légal** : Licence CC 4.0 (Données Québec)
++
++## Champs récupérés → schéma
++
++*Aucun événement actif en base pour cette source — pas de schéma live à montrer.*
++
++## Fréquence & budgets
++
++- **Cadence** : n/d
++- **Budget global** : géocodage Nominatim plafonné à `SORTIKA_GEOCODE_MAX` (défaut 120) requêtes réseau/cycle, toutes sources confondues (`sortika/geocode.py`, cache disque).
++
++## Volumétrie & complétude live
++
++*Source sans connecteur runtime : aucune donnée en base.*
++
++## Erreurs & dépannage
++
++
++## Licence / attribution
++
++- Licence CC 4.0 (Données Québec)
++
++## Historique
++
++- **Source abandonnée** — Jeu de données périmé — dernière date d'événement : 2017-03 (vérifié 2026-08-17)
++- **2026-08-18 — Vague 1 d'enrichissement** (commit `7d9d1b0`) : géocodage Nominatim des salles (`sortika/geocode.py`, cache disque, plafond `SORTIKA_GEOCODE_MAX`), fiches détail lepointdevente (description, heure, tarifs réels `/plugins/rates/<id>`), contacts Tourinsoft (SITQ), heure locale Montréal via JSON-LD.
++- **2026-08-18 — Vague 2 d'enrichissement** (commit `65d2d33`) : colonnes additives `events.start_time` (HH:MM locale QC) et `events.artists` (JSON) + migration auto ; heure captée partout où la source la publie (lepointdevente, evenko, Laval, Sherbrooke, Montréal, atuvu) ; artistes (headliners evenko, lineup Bandsintown, attractions Ticketmaster, patrons sûrs sur les titres) ; 3 nouveaux connecteurs (brossard, ticketmaster, bandsintown).

added docs/connecteurs/montreal.md +114 −0

++# Ville de Montréal — Événements publics (`montreal`)
++
++> Fiche générée le 2026-08-18 03:22 EDT par `scripts/gen_connector_docs.py` — ne pas éditer à la main, relancer le script.
++
++**Statut : actif** · Type : `donnees-ouvertes` · Connecteur : `sortika/connectors/montreal.py`
++
++## Description
++
++- **Source** : [Ville de Montréal — Événements publics](https://donnees.montreal.ca/dataset/evenements-publics)
++- **Couverture** : Événements municipaux, île de Montréal
++- **Extraction** : API CKAN datastore_search (JSON, paginée) — venue = emplacement (si vrai nom de lieu) ou titre_adresse ; address = adresse_principale + adresse_secondaire ; le jeu de données ne publie pas l'heure → heure locale captée dans le JSON-LD des fiches montreal.ca (« startDate »:"…T19:30:00-04:00") lors de l'enrichissement og:image incrémental (cache, plafond MTL_IMG_MAX/sync)
++
++## Accès
++
++- **Type** : donnees-ouvertes
++- **Endpoint** (`API`) : `https://donnees.montreal.ca/api/3/action/datastore_search`
++- **Auth** : Aucune (accès public, identification honnête par User-Agent)
++- **Pagination** : offset/limit
++- **Backend** : GET direct `requests` (throttlé, UA `SortiKa/1.0` identifié)
++- **Throttle** : 0.4 s entre requêtes
++- **Accès légal** : Licence CC BY 4.0 (donnees.montreal.ca) — attribution : Ville de Montréal
++
++<details><summary>En-tête documentaire du connecteur</summary>
++
++> connectors/montreal.py : connecteur Ville de Montréal — événements publics
++> Source    : donnees.montreal.ca, jeu « Événements publics » (montreal.ca)
++> Extraction: API CKAN datastore_search (JSON, paginée) — données ouvertes,
++> Licence CC BY 4.0. Aucune restriction de scraping.
++> Couverture: ~5 600 événements municipaux (culture, conseils, famille,
++> sport, marchés) avec dates, coût, arrondissement, lat/lng.
++> Images    : absentes du jeu de données → enrichissement incrémental par
++> og:image des fiches montreal.ca (cache disque, plafonné par
++> sync via MTL_IMG_MAX, défaut 300).
++> https://donnees.montreal.ca/dataset/evenements-publics
++
++</details>
++
++## Champs récupérés → schéma
++
++Complétude mesurée sur les **5679 événements actifs** de la source ; exemples tirés d'un événement réel (`montreal:les-legendaires-cine-ete-111611`).
++
++| Champ (`events.*`) | Description | Complétude | Exemple réel |
++|---|---|---|---|
++| `title` — Titre | titre de l'événement | 100 % | Les Légendaires – Ciné-été |
++| `description` — Description | texte descriptif (source ou fiche détail) | 100 % | Découvrez cette adaptation cinématographique des bandes dessinées de Patrick Sobral, réalisée pa… |
++| `url` — URL | lien vers la fiche originale / billetterie | 100 % | https://montreal.ca/evenements/les-legendaires-cine-ete-111611 |
++| `categories` — Catégories | taxonomie canonique Sorti-Ka (JSON) | 100 % | ["cinema"] |
++| `venue` — Salle (venue) | nom du lieu | 4 % | Cinéma Beaubien |
++| `address` — Adresse | adresse civique | 4 % | 2396 Rue Beaubien E |
++| `city` — Ville | municipalité | 100 % | Montréal |
++| `region` — Région | région administrative | 100 % | Montréal |
++| `lat` — GPS (lat/lng) | coordonnées géographiques | 97 % | 45.548115, -73.5921 |
++| `start_date` — Date début | date locale AAAA-MM-JJ | 100 % | 2026-08-22 |
++| `end_date` — Date fin | date locale AAAA-MM-JJ | 100 % | 2026-08-22 |
++| `start_time` — Heure (start_time) | heure locale HH:MM (Québec) | 10 % | 09:30 |
++| `is_free` — Gratuité (is_free) | 1 gratuit / 0 payant / NULL inconnu | 100 % | 1 |
++| `price_min` — Prix min | tarif minimal réel ($) | 0 % | ∅ |
++| `price_label` — Libellé prix | étiquette tarifaire affichable | 100 % | Gratuit — Avec billet |
++| `artists` — Artistes | têtes d'affiche / lineup (JSON) | 0 % | [] |
++| `organizer` — Organisateur | promoteur / organisme | 100 % | Ville de Montréal — Rosemont–La Petite-Patrie |
++| `image` — Image | visuel (og:image ou média source) | 58 % | https://res.cloudinary.com/villemontreal/image/upload/w_1200,h_630,c_fill/f_auto,dpr_auto,q_auto… |
++| `website` — Site web | site officiel de l'événement | 0 % | ∅ |
++
++## Fréquence & budgets
++
++- **Cadence** : horaire (watcher PM2)
++- **Budgets / plafonds (variables d'environnement)** :
++
++| Variable | Défaut | Rôle |
++|---|---|---|
++| `MTL_IMG_MAX` | `300` | — |
++- **Budget global** : géocodage Nominatim plafonné à `SORTIKA_GEOCODE_MAX` (défaut 120) requêtes réseau/cycle, toutes sources confondues (`sortika/geocode.py`, cache disque).
++
++## Volumétrie & complétude live
++
++*(mesuré le 2026-08-18 03:22 EDT dans `data/sortika.db`)*
++
++- **Événements en base** : 5729 (dont **5679 actifs**)
++- **GPS** : 5530/5679 actifs (97 %)
++- **Prix** : 5679/5679 actifs (100 %)
++- **Heure (start_time)** : 588/5679 actifs (10 %)
++- **Artistes** : 0/5679 actifs (0 %)
++- **Image** : 3296/5679 actifs (58 %)
++- **Salle (venue)** : 246/5679 actifs (4 %)
++- **Dernier sync** : 2026-08-18 02:41 — fetched 5679, +0 ajoutés, ~300 mis à jour, -0 retirés
++- **Syncs enregistrés** (sync_log) : 22
++
++## Erreurs & dépannage
++
++Erreurs relevées dans `sync_log` :
++
++| Erreur | Occurrences | Dernière fois |
++|---|---|---|
++| 403 Client Error: Forbidden for url: https://donnees.montreal.ca/api/3/action/datastore_search?r… | 1 | 2026-08-17 15:45 |
++
++- Le WAF de donnees.montreal.ca renvoie **403** à tout User-Agent contenant « bot » — le UA `SortiKa/1.0 (+URL; courriel)` est volontairement sans ce mot. Un 403 ponctuel est en général transitoire (WAF) ; vérifier le UA avant tout.
++- Rejouer un sync isolé : `python3 run.py sync --source montreal` (ou via le watcher PM2) ; inspecter ensuite `sync_log` : `sqlite3 data/sortika.db "SELECT * FROM sync_log WHERE source='montreal' ORDER BY ts DESC LIMIT 5;"`
++
++## Licence / attribution
++
++- Licence CC BY 4.0 (donnees.montreal.ca) — attribution : Ville de Montréal
++
++**Mention requise (CC BY 4.0)** : « Contient des données de la **Ville de Montréal**, sous licence CC BY 4.0 (donnees.montreal.ca). » L'attribution doit accompagner toute réutilisation publique des événements de cette source.
++
++## Historique
++
++- **2026-08-18 — Vague 1 d'enrichissement** (commit `7d9d1b0`) : géocodage Nominatim des salles (`sortika/geocode.py`, cache disque, plafond `SORTIKA_GEOCODE_MAX`), fiches détail lepointdevente (description, heure, tarifs réels `/plugins/rates/<id>`), contacts Tourinsoft (SITQ), heure locale Montréal via JSON-LD.
++- **2026-08-18 — Vague 2 d'enrichissement** (commit `65d2d33`) : colonnes additives `events.start_time` (HH:MM locale QC) et `events.artists` (JSON) + migration auto ; heure captée partout où la source la publie (lepointdevente, evenko, Laval, Sherbrooke, Montréal, atuvu) ; artistes (headliners evenko, lineup Bandsintown, attractions Ticketmaster, patrons sûrs sur les titres) ; 3 nouveaux connecteurs (brossard, ticketmaster, bandsintown).
++
++Commits touchant `sortika/connectors/montreal.py` :
++
++- `65d2d33` 2026-08-18 Vague 2 d'enrichissement : heure précise, artistes, 3 nouveaux connecteurs
++- `7d9d1b0` 2026-08-18 Enrichissement des connecteurs + géocodage des salles
++- `9164456` 2026-08-17 Sorti·Ka v1 — agrégateur de sorties & événements du Québec

added docs/connecteurs/repentigny.md +45 −0

++# Ville de Repentigny — Événements (`repentigny`)
++
++> Fiche générée le 2026-08-18 03:22 EDT par `scripts/gen_connector_docs.py` — ne pas éditer à la main, relancer le script.
++
++**Statut : abandonnee** · Type : `donnees-ouvertes` · Connecteur : *aucun (source sans connecteur runtime)*
++
++## Description
++
++- **Source** : [Ville de Repentigny — Événements](https://www.donneesquebec.ca/recherche/dataset/evenement-sur-le-territoire-de-la-ville)
++- **Couverture** : Repentigny (Lanaudière)
++- **Extraction** : CSV (Données Québec)
++- **Note** : Jeu de données périmé — dernière date d'événement : 2021-09 (vérifié 2026-08-17)
++
++## Accès
++
++- **Type** : donnees-ouvertes
++- **Endpoint** : voir URL source (https://www.donneesquebec.ca/recherche/dataset/evenement-sur-le-territoire-de-la-ville)
++- **Auth** : Aucune (accès public, identification honnête par User-Agent)
++- **Accès légal** : Licence CC 4.0 (Données Québec)
++
++## Champs récupérés → schéma
++
++*Aucun événement actif en base pour cette source — pas de schéma live à montrer.*
++
++## Fréquence & budgets
++
++- **Cadence** : n/d
++- **Budget global** : géocodage Nominatim plafonné à `SORTIKA_GEOCODE_MAX` (défaut 120) requêtes réseau/cycle, toutes sources confondues (`sortika/geocode.py`, cache disque).
++
++## Volumétrie & complétude live
++
++*Source sans connecteur runtime : aucune donnée en base.*
++
++## Erreurs & dépannage
++
++
++## Licence / attribution
++
++- Licence CC 4.0 (Données Québec)
++
++## Historique
++
++- **Source abandonnée** — Jeu de données périmé — dernière date d'événement : 2021-09 (vérifié 2026-08-17)
++- **2026-08-18 — Vague 1 d'enrichissement** (commit `7d9d1b0`) : géocodage Nominatim des salles (`sortika/geocode.py`, cache disque, plafond `SORTIKA_GEOCODE_MAX`), fiches détail lepointdevente (description, heure, tarifs réels `/plugins/rates/<id>`), contacts Tourinsoft (SITQ), heure locale Montréal via JSON-LD.
++- **2026-08-18 — Vague 2 d'enrichissement** (commit `65d2d33`) : colonnes additives `events.start_time` (HH:MM locale QC) et `events.artists` (JSON) + migration auto ; heure captée partout où la source la publie (lepointdevente, evenko, Laval, Sherbrooke, Montréal, atuvu) ; artistes (headliners evenko, lineup Bandsintown, attractions Ticketmaster, patrons sûrs sur les titres) ; 3 nouveaux connecteurs (brossard, ticketmaster, bandsintown).

added docs/connecteurs/saguenay.md +45 −0

++# Ville de Saguenay — Événements culturels (`saguenay`)
++
++> Fiche générée le 2026-08-18 03:22 EDT par `scripts/gen_connector_docs.py` — ne pas éditer à la main, relancer le script.
++
++**Statut : abandonnee** · Type : `donnees-ouvertes` · Connecteur : *aucun (source sans connecteur runtime)*
++
++## Description
++
++- **Source** : [Ville de Saguenay — Événements culturels](https://www.donneesquebec.ca/recherche/dataset/sag_evenements-culturels)
++- **Couverture** : Saguenay
++- **Extraction** : CSV (Données Québec)
++- **Note** : Jeu de données périmé — dernière date d'événement : 2022-06 (vérifié 2026-08-17)
++
++## Accès
++
++- **Type** : donnees-ouvertes
++- **Endpoint** : voir URL source (https://www.donneesquebec.ca/recherche/dataset/sag_evenements-culturels)
++- **Auth** : Aucune (accès public, identification honnête par User-Agent)
++- **Accès légal** : Licence CC 4.0 (Données Québec)
++
++## Champs récupérés → schéma
++
++*Aucun événement actif en base pour cette source — pas de schéma live à montrer.*
++
++## Fréquence & budgets
++
++- **Cadence** : n/d
++- **Budget global** : géocodage Nominatim plafonné à `SORTIKA_GEOCODE_MAX` (défaut 120) requêtes réseau/cycle, toutes sources confondues (`sortika/geocode.py`, cache disque).
++
++## Volumétrie & complétude live
++
++*Source sans connecteur runtime : aucune donnée en base.*
++
++## Erreurs & dépannage
++
++
++## Licence / attribution
++
++- Licence CC 4.0 (Données Québec)
++
++## Historique
++
++- **Source abandonnée** — Jeu de données périmé — dernière date d'événement : 2022-06 (vérifié 2026-08-17)
++- **2026-08-18 — Vague 1 d'enrichissement** (commit `7d9d1b0`) : géocodage Nominatim des salles (`sortika/geocode.py`, cache disque, plafond `SORTIKA_GEOCODE_MAX`), fiches détail lepointdevente (description, heure, tarifs réels `/plugins/rates/<id>`), contacts Tourinsoft (SITQ), heure locale Montréal via JSON-LD.
++- **2026-08-18 — Vague 2 d'enrichissement** (commit `65d2d33`) : colonnes additives `events.start_time` (HH:MM locale QC) et `events.artists` (JSON) + migration auto ; heure captée partout où la source la publie (lepointdevente, evenko, Laval, Sherbrooke, Montréal, atuvu) ; artistes (headliners evenko, lineup Bandsintown, attractions Ticketmaster, patrons sûrs sur les titres) ; 3 nouveaux connecteurs (brossard, ticketmaster, bandsintown).

added docs/connecteurs/sherbrooke.md +100 −0

++# Ville de Sherbrooke — Calendrier des événements (`sherbrooke`)
++
++> Fiche générée le 2026-08-18 03:22 EDT par `scripts/gen_connector_docs.py` — ne pas éditer à la main, relancer le script.
++
++**Statut : actif** · Type : `municipal` · Connecteur : `sortika/connectors/sherbrooke.py`
++
++## Description
++
++- **Source** : [Ville de Sherbrooke — Calendrier des événements](https://www.sherbrooke.ca/fr/culture-sports-et-loisirs/calendrier-des-activites)
++- **Couverture** : Événements municipaux et culturels, Sherbrooke (Estrie)
++- **Extraction** : la page rend TOUT le calendrier dans window['TRANSFER_CACHE'] (JSON embarqué, CMS Maruche) → 1 seule requête, ~270 événements (nom, périodes en UTC → date + heure locales Québec, gratuité `payant`, catégories, clientèles, images)
++
++## Accès
++
++- **Type** : municipal
++- **Endpoint** (`PAGE`) : `https://www.sherbrooke.ca/fr/culture-sports-et-loisirs/calendrier-des-activites`
++- **Endpoint** (`SITE`) : `https://www.sherbrooke.ca`
++- **Auth** : Aucune (accès public, identification honnête par User-Agent)
++- **Pagination** : aucune (flux unique)
++- **Backend** : GET direct `requests` (throttlé, UA `SortiKa/1.0` identifié)
++- **Accès légal** : page municipale publique (référencée sur Données Québec) — GET direct, identification honnête
++
++<details><summary>En-tête documentaire du connecteur</summary>
++
++> connectors/sherbrooke.py : connecteur Ville de Sherbrooke — calendrier officiel
++> Source    : sherbrooke.ca, « Calendrier des événements en temps réel »
++> (référencé sur Données Québec : calendrier-des-evenements-en-temps-reel)
++> Extraction: la page rend TOUT le calendrier dans window['TRANSFER_CACHE']
++> (JSON embarqué, CMS Maruche) → 1 seule requête, ~270 événements
++> (nom, périodes, gratuité `payant`, catégories, clientèles,
++> images /Fichiers/<module>/Entities/<id>/<mainPicture>).
++> Accès     : page municipale publique, GET direct, identification honnête.
++> Prix      : booléen `payant` de la source → is_free (montants non exposés).
++
++</details>
++
++## Champs récupérés → schéma
++
++Complétude mesurée sur les **271 événements actifs** de la source ; exemples tirés d'un événement réel (`sherbrooke:499`).
++
++| Champ (`events.*`) | Description | Complétude | Exemple réel |
++|---|---|---|---|
++| `title` — Titre | titre de l'événement | 100 % | Séance d’échange et de discussion - relocalisation de la caserne d’incendie Hector-Olivier-Camir… |
++| `description` — Description | texte descriptif (source ou fiche détail) | 96 % | La construction d’un nouveau poste incendie vise à bonifier le service et à réduire les délais d… |
++| `url` — URL | lien vers la fiche originale / billetterie | 100 % | https://www.sherbrooke.ca/fr/culture-sports-et-loisirs/calendrier-des-activites/499/seance-d-ech… |
++| `categories` — Catégories | taxonomie canonique Sorti-Ka (JSON) | 100 % | ["autre"] |
++| `venue` — Salle (venue) | nom du lieu | 0 % | ∅ |
++| `address` — Adresse | adresse civique | 0 % | ∅ |
++| `city` — Ville | municipalité | 100 % | Sherbrooke |
++| `region` — Région | région administrative | 100 % | Estrie |
++| `lat` — GPS (lat/lng) | coordonnées géographiques | 0 % | ∅ |
++| `start_date` — Date début | date locale AAAA-MM-JJ | 100 % | 2022-06-13 |
++| `end_date` — Date fin | date locale AAAA-MM-JJ | 100 % | 2022-06-13 |
++| `start_time` — Heure (start_time) | heure locale HH:MM (Québec) | 88 % | 18:30 |
++| `is_free` — Gratuité (is_free) | 1 gratuit / 0 payant / NULL inconnu | 100 % | 1 |
++| `price_min` — Prix min | tarif minimal réel ($) | 0 % | ∅ |
++| `price_label` — Libellé prix | étiquette tarifaire affichable | 0 % | ∅ |
++| `artists` — Artistes | têtes d'affiche / lineup (JSON) | 0 % | [] |
++| `organizer` — Organisateur | promoteur / organisme | 100 % | Ville de Sherbrooke |
++| `image` — Image | visuel (og:image ou média source) | 100 % | https://www.sherbrooke.ca/Fichiers/3337a882-4a53-e611-80ea-00155d09650f/Entities/49d0f046-294c-4… |
++| `website` — Site web | site officiel de l'événement | 0 % | ∅ |
++
++## Fréquence & budgets
++
++- **Cadence** : horaire (watcher PM2)
++- **Budget global** : géocodage Nominatim plafonné à `SORTIKA_GEOCODE_MAX` (défaut 120) requêtes réseau/cycle, toutes sources confondues (`sortika/geocode.py`, cache disque).
++
++## Volumétrie & complétude live
++
++*(mesuré le 2026-08-18 03:22 EDT dans `data/sortika.db`)*
++
++- **Événements en base** : 271 (dont **271 actifs**)
++- **GPS** : 0/271 actifs (0 %)
++- **Prix** : 271/271 actifs (100 %)
++- **Heure (start_time)** : 239/271 actifs (88 %)
++- **Artistes** : 0/271 actifs (0 %)
++- **Image** : 270/271 actifs (100 %)
++- **Salle (venue)** : 0/271 actifs (0 %)
++- **Dernier sync** : 2026-08-18 02:41 — fetched 271, +0 ajoutés, ~0 mis à jour, -0 retirés
++- **Syncs enregistrés** (sync_log) : 14
++
++## Erreurs & dépannage
++
++Aucune erreur dans `sync_log` pour cette source. ✅
++
++- Rejouer un sync isolé : `python3 run.py sync --source sherbrooke` (ou via le watcher PM2) ; inspecter ensuite `sync_log` : `sqlite3 data/sortika.db "SELECT * FROM sync_log WHERE source='sherbrooke' ORDER BY ts DESC LIMIT 5;"`
++
++## Licence / attribution
++
++- page municipale publique (référencée sur Données Québec) — GET direct, identification honnête
++
++## Historique
++
++- **2026-08-18 — Vague 1 d'enrichissement** (commit `7d9d1b0`) : géocodage Nominatim des salles (`sortika/geocode.py`, cache disque, plafond `SORTIKA_GEOCODE_MAX`), fiches détail lepointdevente (description, heure, tarifs réels `/plugins/rates/<id>`), contacts Tourinsoft (SITQ), heure locale Montréal via JSON-LD.
++- **2026-08-18 — Vague 2 d'enrichissement** (commit `65d2d33`) : colonnes additives `events.start_time` (HH:MM locale QC) et `events.artists` (JSON) + migration auto ; heure captée partout où la source la publie (lepointdevente, evenko, Laval, Sherbrooke, Montréal, atuvu) ; artistes (headliners evenko, lineup Bandsintown, attractions Ticketmaster, patrons sûrs sur les titres) ; 3 nouveaux connecteurs (brossard, ticketmaster, bandsintown).
++
++Commits touchant `sortika/connectors/sherbrooke.py` :
++
++- `65d2d33` 2026-08-18 Vague 2 d'enrichissement : heure précise, artistes, 3 nouveaux connecteurs
++- `9164456` 2026-08-17 Sorti·Ka v1 — agrégateur de sorties & événements du Québec

added docs/connecteurs/sitq.md +112 −0

++# SIT Québec — Ministère du Tourisme (`sitq`)
++
++> Fiche générée le 2026-08-18 03:22 EDT par `scripts/gen_connector_docs.py` — ne pas éditer à la main, relancer le script.
++
++**Statut : actif** · Type : `donnees-ouvertes` · Connecteur : `sortika/connectors/sitq.py`
++
++## Description
++
++- **Source** : [SIT Québec — Ministère du Tourisme](https://www.donneesquebec.ca/recherche/dataset/sit-quebec-evenements)
++- **Couverture** : Événements touristiques, toutes les régions du Québec
++- **Extraction** : API JSON (Tourinsoft, syndication publique) — dates, géoloc, thèmes, contacts (TelephonePrincipals/Courriels → description « Renseignements : … ») ; le flux ne publie ni Descriptions* ni tarifs (vérifié 2026-08)
++
++## Accès
++
++- **Type** : donnees-ouvertes
++- **Endpoint** (`FEED`) : `https://api-v3.tourinsoft.com/api/syndications/mto.tourinsoft.com/c6ab1c9e-f594-463e-b036-5a029197f3a9?format=json`
++- **Auth** : Aucune (accès public, identification honnête par User-Agent)
++- **Pagination** : aucune (flux unique)
++- **Backend** : GET direct `requests` (throttlé, UA `SortiKa/1.0` identifié)
++- **Throttle** : 0.3 s entre requêtes
++- **Accès légal** : Licence Creative Commons 4.0 (Données Québec) — API officielle publiée par le Ministère du Tourisme
++
++<details><summary>En-tête documentaire du connecteur</summary>
++
++> connectors/sitq.py : connecteur SIT Québec — Ministère du Tourisme
++> Source    : Système d'information touristique Québec (Données Québec)
++> Extraction: API JSON officielle Tourinsoft (syndication publique)
++> Accès     : données ouvertes — Licence CC 4.0 (Données Québec), API publiée
++> par le Ministère du Tourisme. Aucune restriction de scraping.
++> Couverture: ~1 600 événements touristiques, TOUTES les régions du Québec
++> (festivals, salons, manifestations sportives et culturelles),
++> avec région touristique, thèmes, dates, géolocalisation, site web.
++> Contacts  : TelephonePrincipals / Courriels (moyens de communication) →
++> ligne « Renseignements : … » en description (le flux syndiqué
++> ne publie AUCUN groupe Descriptions* ni bloc tarifs — vérifié
++> sur l'union des clés des 1 598 fiches, 2026-08 ; is_free et
++> price_* restent donc inconnus, jamais inventés).
++> https://www.donneesquebec.ca/recherche/dataset/sit-quebec-evenements
++
++</details>
++
++## Champs récupérés → schéma
++
++Complétude mesurée sur les **1598 événements actifs** de la source ; exemples tirés d'un événement réel (`sitq:EVENMTOV500NIO`).
++
++| Champ (`events.*`) | Description | Complétude | Exemple réel |
++|---|---|---|---|
++| `title` — Titre | titre de l'événement | 100 % | JACKALOPE |
++| `description` — Description | texte descriptif (source ou fiche détail) | 87 % | ∅ |
++| `url` — URL | lien vers la fiche originale / billetterie | 100 % | http://jackalopefest.ca |
++| `categories` — Catégories | taxonomie canonique Sorti-Ka (JSON) | 100 % | ["sport", "musique"] |
++| `venue` — Salle (venue) | nom du lieu | 66 % | Quai Jacques-Cartier |
++| `address` — Adresse | adresse civique | 84 % | Rue de la Commune Est |
++| `city` — Ville | municipalité | 96 % | Montréal |
++| `region` — Région | région administrative | 99 % | Montréal |
++| `lat` — GPS (lat/lng) | coordonnées géographiques | 97 % | 45.507703, -73.552067 |
++| `start_date` — Date début | date locale AAAA-MM-JJ | 99 % | 2026-09-11 |
++| `end_date` — Date fin | date locale AAAA-MM-JJ | 99 % | 2026-09-13 |
++| `start_time` — Heure (start_time) | heure locale HH:MM (Québec) | 0 % | ∅ |
++| `is_free` — Gratuité (is_free) | 1 gratuit / 0 payant / NULL inconnu | 0 % | ∅ |
++| `price_min` — Prix min | tarif minimal réel ($) | 0 % | ∅ |
++| `price_label` — Libellé prix | étiquette tarifaire affichable | 0 % | ∅ |
++| `artists` — Artistes | têtes d'affiche / lineup (JSON) | 0 % | [] |
++| `organizer` — Organisateur | promoteur / organisme | 100 % | Tourisme Montréal |
++| `image` — Image | visuel (og:image ou média source) | 35 % | http://jackalope.co/cdn/shop/files/jackalope_e0d516dd-87d0-4058-ad4d-153c59ef7f99.jpg?v=17736954… |
++| `website` — Site web | site officiel de l'événement | 93 % | http://jackalopefest.ca |
++
++## Fréquence & budgets
++
++- **Cadence** : horaire (watcher PM2)
++- **Budgets / plafonds (variables d'environnement)** :
++
++| Variable | Défaut | Rôle |
++|---|---|---|
++| `SITQ_IMG_MAX` | `200` | — |
++- **Budget global** : géocodage Nominatim plafonné à `SORTIKA_GEOCODE_MAX` (défaut 120) requêtes réseau/cycle, toutes sources confondues (`sortika/geocode.py`, cache disque).
++
++## Volumétrie & complétude live
++
++*(mesuré le 2026-08-18 03:22 EDT dans `data/sortika.db`)*
++
++- **Événements en base** : 1606 (dont **1598 actifs**)
++- **GPS** : 1548/1598 actifs (97 %)
++- **Prix** : 0/1598 actifs (0 %)
++- **Heure (start_time)** : 0/1598 actifs (0 %)
++- **Artistes** : 0/1598 actifs (0 %)
++- **Image** : 558/1598 actifs (35 %)
++- **Salle (venue)** : 1050/1598 actifs (66 %)
++- **Dernier sync** : 2026-08-18 02:41 — fetched 1598, +0 ajoutés, ~1598 mis à jour, -0 retirés
++- **Syncs enregistrés** (sync_log) : 21
++
++## Erreurs & dépannage
++
++Aucune erreur dans `sync_log` pour cette source. ✅
++
++- Rejouer un sync isolé : `python3 run.py sync --source sitq` (ou via le watcher PM2) ; inspecter ensuite `sync_log` : `sqlite3 data/sortika.db "SELECT * FROM sync_log WHERE source='sitq' ORDER BY ts DESC LIMIT 5;"`
++
++## Licence / attribution
++
++- Licence Creative Commons 4.0 (Données Québec) — API officielle publiée par le Ministère du Tourisme
++
++**Mention requise (CC 4.0 — Données Québec)** : « Données du **SIT Québec — Ministère du Tourisme**, diffusées sous licence Creative Commons 4.0 via Données Québec. » L'attribution au Ministère du Tourisme est obligatoire.
++
++## Historique
++
++- **2026-08-18 — Vague 1 d'enrichissement** (commit `7d9d1b0`) : géocodage Nominatim des salles (`sortika/geocode.py`, cache disque, plafond `SORTIKA_GEOCODE_MAX`), fiches détail lepointdevente (description, heure, tarifs réels `/plugins/rates/<id>`), contacts Tourinsoft (SITQ), heure locale Montréal via JSON-LD.
++- **2026-08-18 — Vague 2 d'enrichissement** (commit `65d2d33`) : colonnes additives `events.start_time` (HH:MM locale QC) et `events.artists` (JSON) + migration auto ; heure captée partout où la source la publie (lepointdevente, evenko, Laval, Sherbrooke, Montréal, atuvu) ; artistes (headliners evenko, lineup Bandsintown, attractions Ticketmaster, patrons sûrs sur les titres) ; 3 nouveaux connecteurs (brossard, ticketmaster, bandsintown).
++
++Commits touchant `sortika/connectors/sitq.py` :
++
++- `7d9d1b0` 2026-08-18 Enrichissement des connecteurs + géocodage des salles
++- `9164456` 2026-08-17 Sorti·Ka v1 — agrégateur de sorties & événements du Québec

added docs/connecteurs/terrebonne.md +45 −0

++# Ville de Terrebonne — Calendrier (`terrebonne`)
++
++> Fiche générée le 2026-08-18 03:22 EDT par `scripts/gen_connector_docs.py` — ne pas éditer à la main, relancer le script.
++
++**Statut : abandonnee** · Type : `municipal` · Connecteur : *aucun (source sans connecteur runtime)*
++
++## Description
++
++- **Source** : [Ville de Terrebonne — Calendrier](https://terrebonne.ca/calendrier/)
++- **Couverture** : Terrebonne (Lanaudière)
++- **Extraction** : n/d
++- **Note** : Cloudflare bloque tout GET non navigateur (403) et aucun jeu « événements » sur Données Québec (vérifié 2026-08-18)
++
++## Accès
++
++- **Type** : municipal
++- **Endpoint** : voir URL source (https://terrebonne.ca/calendrier/)
++- **Auth** : Aucune (accès public, identification honnête par User-Agent)
++- **Accès légal** : n/d
++
++## Champs récupérés → schéma
++
++*Aucun événement actif en base pour cette source — pas de schéma live à montrer.*
++
++## Fréquence & budgets
++
++- **Cadence** : n/d
++- **Budget global** : géocodage Nominatim plafonné à `SORTIKA_GEOCODE_MAX` (défaut 120) requêtes réseau/cycle, toutes sources confondues (`sortika/geocode.py`, cache disque).
++
++## Volumétrie & complétude live
++
++*Source sans connecteur runtime : aucune donnée en base.*
++
++## Erreurs & dépannage
++
++
++## Licence / attribution
++
++- n/d
++
++## Historique
++
++- **Source abandonnée** — Cloudflare bloque tout GET non navigateur (403) et aucun jeu « événements » sur Données Québec (vérifié 2026-08-18)
++- **2026-08-18 — Vague 1 d'enrichissement** (commit `7d9d1b0`) : géocodage Nominatim des salles (`sortika/geocode.py`, cache disque, plafond `SORTIKA_GEOCODE_MAX`), fiches détail lepointdevente (description, heure, tarifs réels `/plugins/rates/<id>`), contacts Tourinsoft (SITQ), heure locale Montréal via JSON-LD.
++- **2026-08-18 — Vague 2 d'enrichissement** (commit `65d2d33`) : colonnes additives `events.start_time` (HH:MM locale QC) et `events.artists` (JSON) + migration auto ; heure captée partout où la source la publie (lepointdevente, evenko, Laval, Sherbrooke, Montréal, atuvu) ; artistes (headliners evenko, lineup Bandsintown, attractions Ticketmaster, patrons sûrs sur les titres) ; 3 nouveaux connecteurs (brossard, ticketmaster, bandsintown).

added docs/connecteurs/ticketmaster.md +89 −0

++# Ticketmaster — Discovery API (Québec) (`ticketmaster`)
++
++> Fiche générée le 2026-08-18 03:22 EDT par `scripts/gen_connector_docs.py` — ne pas éditer à la main, relancer le script.
++
++**Statut : prêt — clé requise** · Type : `billetterie` · Connecteur : `sortika/connectors/ticketmaster.py`
++
++## Description
++
++- **Source** : [Ticketmaster — Discovery API (Québec)](https://developer.ticketmaster.com/products-and-docs/apis/discovery-api/v2/)
++- **Couverture** : Grands spectacles, sports et concerts — partout au Québec
++- **Extraction** : API officielle Discovery v2 — GET JSON paginé (countryCode=CA & stateCode=QC, size=200, tri par date) : nom, dates + heure locale, salle géolocalisée (venues lat/lng), fourchette de prix (priceRanges min/max), images 16:9, classifications → catégories, attractions → artistes, URL de billetterie officielle ; throttle 0,25 s (quota 5 req/s)
++- **Note** : Nécessite TICKETMASTER_API_KEY dans .env (clé gratuite). Sans clé, le connecteur s'annonce « clé manquante » et ne retourne rien.
++
++## Accès
++
++- **Type** : billetterie
++- **Endpoint** (`API`) : `https://app.ticketmaster.com/discovery/v2/events.json`
++- **Auth** : Clé API gratuite `TICKETMASTER_API_KEY` (developer.ticketmaster.com)
++- **Pagination** : par numéro de page
++- **Backend** : GET direct `requests` (throttlé, UA `SortiKa/1.0` identifié)
++- **Throttle** : 0.25 s entre requêtes
++- **Accès légal** : API officielle publique avec clé gratuite (developer.ticketmaster.com) — conditions Ticketmaster Developer respectées
++
++<details><summary>En-tête documentaire du connecteur</summary>
++
++> connectors/ticketmaster.py : connecteur Ticketmaster Discovery API (Québec)
++> Source    : app.ticketmaster.com/discovery/v2/events — API officielle
++> publique (clé gratuite sur developer.ticketmaster.com).
++> Extraction: GET JSON paginé (countryCode=CA & stateCode=QC, size=200) —
++> nom, dates + heure locale, salle géolocalisée (venues lat/lng),
++> fourchette de prix (priceRanges min/max), images 16:9,
++> classifications (segment/genre) → catégories, attractions →
++> artistes, URL de billetterie officielle.
++> Accès     : API officielle avec clé — quota 5 req/s & 5 000 req/jour
++> (throttle 0,25 s ; ~10 requêtes/sync, pagination plafonnée par
++> l'API à 1 000 éléments par requête profonde).
++> Clé       : TICKETMASTER_API_KEY dans .env (voir .env.example). Sans clé,
++> le connecteur s'annonce « clé manquante » et ne retourne rien —
++> statut « prêt — clé requise » dans data/sources.json.
++
++</details>
++
++## Champs récupérés → schéma
++
++*Aucun événement actif en base pour cette source — pas de schéma live à montrer.*
++
++## Fréquence & budgets
++
++- **Cadence** : horaire (watcher PM2) dès que la clé est fournie
++- **Budgets / plafonds (variables d'environnement)** :
++
++| Variable | Défaut | Rôle |
++|---|---|---|
++| `TICKETMASTER_API_KEY` | `` | — |
++- **Budget global** : géocodage Nominatim plafonné à `SORTIKA_GEOCODE_MAX` (défaut 120) requêtes réseau/cycle, toutes sources confondues (`sortika/geocode.py`, cache disque).
++
++## Volumétrie & complétude live
++
++*(mesuré le 2026-08-18 03:22 EDT dans `data/sortika.db`)*
++
++- **Événements en base** : 0 (dont **0 actifs**)
++- **GPS** : 0/0 actifs (—)
++- **Prix** : 0/0 actifs (—)
++- **Heure (start_time)** : 0/0 actifs (—)
++- **Artistes** : 0/0 actifs (—)
++- **Image** : 0/0 actifs (—)
++- **Salle (venue)** : 0/0 actifs (—)
++- **Dernier sync** : 2026-08-18 02:41 — fetched 0, +0 ajoutés, ~0 mis à jour, -0 retirés
++- **Syncs enregistrés** (sync_log) : 2
++
++## Erreurs & dépannage
++
++Aucune erreur dans `sync_log` pour cette source. ✅
++
++- Sans `TICKETMASTER_API_KEY` dans `.env`, le connecteur s'annonce « clé manquante » et ne retourne rien (statut « prêt — clé requise »). Quota API : 5 req/s (throttle 0,25 s côté connecteur).
++- Rejouer un sync isolé : `python3 run.py sync --source ticketmaster` (ou via le watcher PM2) ; inspecter ensuite `sync_log` : `sqlite3 data/sortika.db "SELECT * FROM sync_log WHERE source='ticketmaster' ORDER BY ts DESC LIMIT 5;"`
++
++## Licence / attribution
++
++- API officielle publique avec clé gratuite (developer.ticketmaster.com) — conditions Ticketmaster Developer respectées
++
++## Historique
++
++- **2026-08-18 — Vague 1 d'enrichissement** (commit `7d9d1b0`) : géocodage Nominatim des salles (`sortika/geocode.py`, cache disque, plafond `SORTIKA_GEOCODE_MAX`), fiches détail lepointdevente (description, heure, tarifs réels `/plugins/rates/<id>`), contacts Tourinsoft (SITQ), heure locale Montréal via JSON-LD.
++- **2026-08-18 — Vague 2 d'enrichissement** (commit `65d2d33`) : colonnes additives `events.start_time` (HH:MM locale QC) et `events.artists` (JSON) + migration auto ; heure captée partout où la source la publie (lepointdevente, evenko, Laval, Sherbrooke, Montréal, atuvu) ; artistes (headliners evenko, lineup Bandsintown, attractions Ticketmaster, patrons sûrs sur les titres) ; 3 nouveaux connecteurs (brossard, ticketmaster, bandsintown).
++
++Commits touchant `sortika/connectors/ticketmaster.py` :
++
++- `65d2d33` 2026-08-18 Vague 2 d'enrichissement : heure précise, artistes, 3 nouveaux connecteurs

added docs/connecteurs/trois-rivieres.md +45 −0

++# Ville de Trois-Rivières — Événements (`trois-rivieres`)
++
++> Fiche générée le 2026-08-18 03:22 EDT par `scripts/gen_connector_docs.py` — ne pas éditer à la main, relancer le script.
++
++**Statut : abandonnee** · Type : `municipal` · Connecteur : *aucun (source sans connecteur runtime)*
++
++## Description
++
++- **Source** : [Ville de Trois-Rivières — Événements](https://www.v3r.net/)
++- **Couverture** : Trois-Rivières (Mauricie)
++- **Extraction** : n/d
++- **Note** : API REST WordPress verrouillée (401 rest_not_logged_in) et aucun jeu « événements » sur Données Québec (vérifié 2026-08-18)
++
++## Accès
++
++- **Type** : municipal
++- **Endpoint** : voir URL source (https://www.v3r.net/)
++- **Auth** : Aucune (accès public, identification honnête par User-Agent)
++- **Accès légal** : n/d
++
++## Champs récupérés → schéma
++
++*Aucun événement actif en base pour cette source — pas de schéma live à montrer.*
++
++## Fréquence & budgets
++
++- **Cadence** : n/d
++- **Budget global** : géocodage Nominatim plafonné à `SORTIKA_GEOCODE_MAX` (défaut 120) requêtes réseau/cycle, toutes sources confondues (`sortika/geocode.py`, cache disque).
++
++## Volumétrie & complétude live
++
++*Source sans connecteur runtime : aucune donnée en base.*
++
++## Erreurs & dépannage
++
++
++## Licence / attribution
++
++- n/d
++
++## Historique
++
++- **Source abandonnée** — API REST WordPress verrouillée (401 rest_not_logged_in) et aucun jeu « événements » sur Données Québec (vérifié 2026-08-18)
++- **2026-08-18 — Vague 1 d'enrichissement** (commit `7d9d1b0`) : géocodage Nominatim des salles (`sortika/geocode.py`, cache disque, plafond `SORTIKA_GEOCODE_MAX`), fiches détail lepointdevente (description, heure, tarifs réels `/plugins/rates/<id>`), contacts Tourinsoft (SITQ), heure locale Montréal via JSON-LD.
++- **2026-08-18 — Vague 2 d'enrichissement** (commit `65d2d33`) : colonnes additives `events.start_time` (HH:MM locale QC) et `events.artists` (JSON) + migration auto ; heure captée partout où la source la publie (lepointdevente, evenko, Laval, Sherbrooke, Montréal, atuvu) ; artistes (headliners evenko, lineup Bandsintown, attractions Ticketmaster, patrons sûrs sur les titres) ; 3 nouveaux connecteurs (brossard, ticketmaster, bandsintown).

added scripts/gen_connector_docs.py +561 −0

++#!/usr/bin/env python3
++# -----------------------------------------------------------------------------
++# Sorti-Ka — Agrégateur de sorties & événements (province de Québec)
++# Auteur : Simon-Pierre Boucher — contact@spboucher.ai
++# scripts/gen_connector_docs.py : générateur REJOUABLE de la documentation
++#   standardisée des connecteurs → docs/connecteurs/INDEX.md + une fiche par
++#   source. Croise trois vérités :
++#     1. le registre data/sources.json (description, licence, cadence, statut)
++#     2. l'introspection statique des connecteurs sortika/connectors/*.py
++#        (endpoints, pagination, backend, plafonds env, en-tête documentaire)
++#     3. la base LIVE data/sortika.db (volumétrie, complétude par champ,
++#        exemples réels, dernier sync, erreurs sync_log)
++#   + l'historique git de chaque connecteur.
++#
++#   Usage :  python3 scripts/gen_connector_docs.py
++#   (aucune dépendance hors stdlib ; la BD est ouverte en lecture seule)
++# -----------------------------------------------------------------------------
++from __future__ import annotations
++
++import ast
++import json
++import re
++import sqlite3
++import subprocess
++import sys
++from datetime import datetime, timezone
++from pathlib import Path
++
++ROOT = Path(__file__).resolve().parents[1]
++SOURCES_JSON = ROOT / "data" / "sources.json"
++DB_PATH = ROOT / "data" / "sortika.db"
++CONNECTORS_DIR = ROOT / "sortika" / "connectors"
++OUT_DIR = ROOT / "docs" / "connecteurs"
++
++NOW = datetime.now().astimezone()
++STAMP = NOW.strftime("%Y-%m-%d %H:%M %Z")
++
++# Champs documentés dans le tableau « Champs récupérés → schéma » de chaque
++# fiche : (colonne SQL, libellé, description courte).
++SCHEMA_FIELDS = [
++    ("title",       "Titre",        "titre de l'événement"),
++    ("description", "Description",  "texte descriptif (source ou fiche détail)"),
++    ("url",         "URL",          "lien vers la fiche originale / billetterie"),
++    ("categories",  "Catégories",   "taxonomie canonique Sorti-Ka (JSON)"),
++    ("venue",       "Salle (venue)","nom du lieu"),
++    ("address",     "Adresse",      "adresse civique"),
++    ("city",        "Ville",        "municipalité"),
++    ("region",      "Région",       "région administrative"),
++    ("lat",         "GPS (lat/lng)","coordonnées géographiques"),
++    ("start_date",  "Date début",   "date locale AAAA-MM-JJ"),
++    ("end_date",    "Date fin",     "date locale AAAA-MM-JJ"),
++    ("start_time",  "Heure (start_time)", "heure locale HH:MM (Québec)"),
++    ("is_free",     "Gratuité (is_free)", "1 gratuit / 0 payant / NULL inconnu"),
++    ("price_min",   "Prix min",     "tarif minimal réel ($)"),
++    ("price_label", "Libellé prix", "étiquette tarifaire affichable"),
++    ("artists",     "Artistes",     "têtes d'affiche / lineup (JSON)"),
++    ("organizer",   "Organisateur", "promoteur / organisme"),
++    ("image",       "Image",        "visuel (og:image ou média source)"),
++    ("website",     "Site web",     "site officiel de l'événement"),
++]
++
++# Complétude « clé » suivie dans l'INDEX et la section Volumétrie (SQL, libellé).
++KEY_METRICS = [
++    ("lat IS NOT NULL AND lng IS NOT NULL",                         "GPS"),
++    ("(is_free IS NOT NULL OR price_min IS NOT NULL OR (price_label IS NOT NULL AND price_label != ''))", "Prix"),
++    ("start_time IS NOT NULL AND start_time != ''",                 "Heure (start_time)"),
++    ("artists IS NOT NULL AND artists NOT IN ('', '[]')",           "Artistes"),
++    ("image IS NOT NULL AND image != ''",                           "Image"),
++    ("venue IS NOT NULL AND venue != ''",                           "Salle (venue)"),
++]
++
++# Attributions REQUISES par licence (rappelées mot à mot dans les fiches).
++ATTRIBUTIONS = {
++    "montreal": ("**Mention requise (CC BY 4.0)** : « Contient des données de "
++                 "la **Ville de Montréal**, sous licence CC BY 4.0 "
++                 "(donnees.montreal.ca). » L'attribution doit accompagner "
++                 "toute réutilisation publique des événements de cette source."),
++    "sitq":     ("**Mention requise (CC 4.0 — Données Québec)** : « Données du "
++                 "**SIT Québec — Ministère du Tourisme**, diffusées sous "
++                 "licence Creative Commons 4.0 via Données Québec. » "
++                 "L'attribution au Ministère du Tourisme est obligatoire."),
++    "laval":    ("**Mention requise (CC 4.0 — Données Québec)** : « Données de "
++                 "la **Ville de Laval** (Calendrier des activités), diffusées "
++                 "sous licence Creative Commons 4.0 via Données Québec. » "
++                 "L'attribution à la Ville de Laval est obligatoire."),
++}
++
++# Notes de dépannage spécifiques (complètent les erreurs sync_log live).
++DEPANNAGE = {
++    "montreal": ["Le WAF de donnees.montreal.ca renvoie **403** à tout "
++                 "User-Agent contenant « bot » — le UA `SortiKa/1.0 (+URL; "
++                 "courriel)` est volontairement sans ce mot. Un 403 ponctuel "
++                 "est en général transitoire (WAF) ; vérifier le UA avant tout."],
++    "atuvu":    ["Source derrière anti-bot/JS lourd → backend **Scrapfly** "
++                 "requis : vérifier `SCRAPFLY_API_KEY` dans `.env` et le solde "
++                 "de crédits Scrapfly si le connecteur ne rapporte plus rien."],
++    "ticketmaster": ["Sans `TICKETMASTER_API_KEY` dans `.env`, le connecteur "
++                     "s'annonce « clé manquante » et ne retourne rien (statut "
++                     "« prêt — clé requise »). Quota API : 5 req/s (throttle "
++                     "0,25 s côté connecteur)."],
++    "bandsintown": ["L'API n'accepte que certains formats d'`app_id` : le "
++                    "format widget `js_www.sorti-ka.com` est testé accepté "
++                    "(2026-08) ; un app_id arbitraire simple est refusé."],
++    "lepointdevente": ["L'enrichissement par fiches détail est incrémental "
++                       "(cache `data/lepointdevente_cache.json`, plafond "
++                       "`LPDV_DETAIL_MAX`/sync, re-visite 7 j) : la complétude "
++                       "description/heure/prix monte au fil des cycles."],
++    "lavitrine": ["Parcours par sitemap incrémental (`LV_MAX_FETCH` fiches/"
++                  "sync) : après un reset de cache, plusieurs cycles sont "
++                  "nécessaires pour recouvrir tout le catalogue."],
++}
++
++WAVE_HISTORY = (
++    "- **2026-08-18 — Vague 1 d'enrichissement** (commit `7d9d1b0`) : "
++    "géocodage Nominatim des salles (`sortika/geocode.py`, cache disque, "
++    "plafond `SORTIKA_GEOCODE_MAX`), fiches détail lepointdevente "
++    "(description, heure, tarifs réels `/plugins/rates/<id>`), contacts "
++    "Tourinsoft (SITQ), heure locale Montréal via JSON-LD.\n"
++    "- **2026-08-18 — Vague 2 d'enrichissement** (commit `65d2d33`) : "
++    "colonnes additives `events.start_time` (HH:MM locale QC) et "
++    "`events.artists` (JSON) + migration auto ; heure captée partout où la "
++    "source la publie (lepointdevente, evenko, Laval, Sherbrooke, Montréal, "
++    "atuvu) ; artistes (headliners evenko, lineup Bandsintown, attractions "
++    "Ticketmaster, patrons sûrs sur les titres) ; 3 nouveaux connecteurs "
++    "(brossard, ticketmaster, bandsintown)."
++)
++
++
++# ---------------------------------------------------------------------------
++# Introspection statique d'un connecteur
++# ---------------------------------------------------------------------------
++
++def introspect(path: Path) -> dict:
++    text = path.read_text(encoding="utf-8")
++    info: dict = {"file": path.name, "endpoints": [], "env": [], "header": [],
++                  "pagination": "", "backend": "", "request_delay": None}
++
++    # En-tête documentaire (bloc de commentaires en tête de fichier).
++    for line in text.splitlines():
++        s = line.rstrip()
++        if s.startswith("#"):
++            body = s.lstrip("#").strip()
++            if set(body) <= {"-"}:          # séparateurs -----
++                continue
++            info["header"].append(body)
++        elif s.startswith(("from ", "import ")) or not s:
++            if info["header"]:
++                break
++        else:
++            break
++    # Retire le tri-boilerplate commun (nom du projet, auteur, nom du fichier).
++    info["header"] = [h for h in info["header"]
++                      if not h.startswith(("Sorti-Ka —", "Auteur :"))]
++
++    # Constantes URL au niveau module (ast gère la concaténation implicite).
++    try:
++        tree = ast.parse(text)
++        for node in tree.body:
++            if isinstance(node, ast.Assign) and len(node.targets) == 1 \
++                    and isinstance(node.targets[0], ast.Name):
++                name = node.targets[0].id
++                val = node.value
++                if isinstance(val, ast.Constant) and isinstance(val.value, str) \
++                        and val.value.startswith("http"):
++                    info["endpoints"].append((name, val.value))
++    except SyntaxError:
++        pass
++
++    # Plafonds / clés env : VAR = int(os.environ.get("X", "def"))  # commentaire
++    env_re = re.compile(
++        r'(?:os\.environ|__import__\("os"\)\.environ)\.get\(\s*"([A-Z_]+)"\s*'
++        r'(?:,\s*"([^"]*)")?\s*\)[^\n#]*(?:#\s*(.*))?')
++    for m in env_re.finditer(text):
++        var, default, comment = m.group(1), m.group(2), (m.group(3) or "").strip()
++        info["env"].append((var, default if default is not None else "—", comment))
++
++    # Backend réseau.
++    low = text.lower()
++    if "scrapfly" in low:
++        info["backend"] = "Scrapfly (anti-bot / rendu JS) via `base.get_scrapfly()`"
++    else:
++        info["backend"] = "GET direct `requests` (throttlé, UA `SortiKa/1.0` identifié)"
++
++    # Pagination (heuristique sur le texte + l'en-tête).
++    hints = []
++    if "offset" in low:
++        hints.append("offset/limit")
++    if re.search(r'page["\']?\s*[:=]|page=\{page\}|\?page=', text):
++        hints.append("par numéro de page")
++    if "sitemap" in low:
++        hints.append("parcours de sitemap XML")
++    if "per_page" in low:
++        hints.append("per_page")
++    info["pagination"] = ", ".join(dict.fromkeys(hints)) or "aucune (flux unique)"
++
++    m = re.search(r"request_delay\s*[:=]\s*(?:float\s*=\s*)?([\d.]+)", text)
++    if m:
++        info["request_delay"] = m.group(1)
++
++    return info
++
++
++# ---------------------------------------------------------------------------
++# Base live
++# ---------------------------------------------------------------------------
++
++def db_stats(cur: sqlite3.Cursor, sid: str) -> dict:
++    row = cur.execute(
++        "SELECT COUNT(*), COALESCE(SUM(active),0) FROM events WHERE source=?",
++        (sid,)).fetchone()
++    total, active = row
++    metrics = []
++    for cond, label in KEY_METRICS:
++        n = cur.execute(
++            f"SELECT COUNT(*) FROM events WHERE source=? AND active=1 AND ({cond})",
++            (sid,)).fetchone()[0]
++        metrics.append((label, n))
++    # Complétude par champ du schéma (sur les événements actifs).
++    per_field = {}
++    for col, _label, _desc in SCHEMA_FIELDS:
++        if col == "lat":
++            cond = "lat IS NOT NULL AND lng IS NOT NULL"
++        elif col in ("categories", "artists"):
++            cond = f"{col} IS NOT NULL AND {col} NOT IN ('', '[]')"
++        elif col == "is_free":
++            cond = "is_free IS NOT NULL"
++        elif col == "price_min":
++            cond = "price_min IS NOT NULL"
++        else:
++            cond = f"{col} IS NOT NULL AND CAST({col} AS TEXT) != ''"
++        per_field[col] = cur.execute(
++            f"SELECT COUNT(*) FROM events WHERE source=? AND active=1 AND ({cond})",
++            (sid,)).fetchone()[0]
++
++    # Exemple réel : l'événement actif le plus « complet », le plus récent.
++    score = " + ".join(f"(CASE WHEN {c} THEN 1 ELSE 0 END)" for c, _ in KEY_METRICS)
++    ex = cur.execute(
++        f"SELECT * FROM events WHERE source=? AND active=1 "
++        f"ORDER BY ({score}) DESC, updated_at DESC LIMIT 1", (sid,)).fetchone()
++    example = dict(ex) if ex else {}
++
++    # sync_log : dernier sync, compteurs, erreurs.
++    last = cur.execute(
++        "SELECT ts, fetched, added, updated, removed, error FROM sync_log "
++        "WHERE source=? ORDER BY ts DESC LIMIT 1", (sid,)).fetchone()
++    nsync = cur.execute("SELECT COUNT(*) FROM sync_log WHERE source=?",
++                        (sid,)).fetchone()[0]
++    errors = cur.execute(
++        "SELECT error, COUNT(*), MAX(ts) FROM sync_log WHERE source=? AND "
++        "error IS NOT NULL GROUP BY error ORDER BY MAX(ts) DESC LIMIT 5",
++        (sid,)).fetchall()
++    return {"total": total, "active": active, "metrics": metrics,
++            "per_field": per_field, "example": example,
++            "last_sync": dict(last) if last else None, "nsync": nsync,
++            "errors": [dict(e) for e in errors] if errors else
++                      []}
++
++
++def fmt_ts(ts: float | None) -> str:
++    if not ts:
++        return "n/d"
++    return datetime.fromtimestamp(ts, tz=timezone.utc).astimezone() \
++                   .strftime("%Y-%m-%d %H:%M")
++
++
++def pct(n: int, d: int) -> str:
++    return f"{100.0 * n / d:.0f} %" if d else "—"
++
++
++def md_escape(v) -> str:
++    if v is None:
++        return "∅"
++    s = str(v).replace("\n", " ").replace("|", "\\|").strip()
++    return (s[:96] + "…") if len(s) > 96 else (s or "∅")
++
++
++def git_history(path: Path) -> list[str]:
++    try:
++        out = subprocess.run(
++            ["git", "log", "--follow", "--date=short",
++             "--format=%h %ad %s", "--", str(path.relative_to(ROOT))],
++            cwd=ROOT, capture_output=True, text=True, timeout=30).stdout
++        return out.strip().splitlines()[:12]
++    except Exception:
++        return []
++
++
++# ---------------------------------------------------------------------------
++# Rendu des fiches
++# ---------------------------------------------------------------------------
++
++def render_fiche(src: dict, intro: dict | None, stats: dict | None) -> str:
++    sid = src["id"]
++    L: list[str] = []
++    L.append(f"# {src['name']} (`{sid}`)")
++    L.append("")
++    L.append(f"> Fiche générée le {STAMP} par `scripts/gen_connector_docs.py` "
++             f"— ne pas éditer à la main, relancer le script.")
++    L.append("")
++    L.append(f"**Statut : {src.get('statut', 'n/d')}** · Type : "
++             f"`{src.get('type', 'n/d')}`" +
++             (f" · Connecteur : `sortika/connectors/{intro['file']}`" if intro
++              else " · Connecteur : *aucun (source sans connecteur runtime)*"))
++    L.append("")
++
++    # 1. Description --------------------------------------------------------
++    L.append("## Description")
++    L.append("")
++    L.append(f"- **Source** : [{src['name']}]({src['url']})")
++    L.append(f"- **Couverture** : {src.get('couverture', 'n/d')}")
++    L.append(f"- **Extraction** : {src.get('extraction', 'n/d')}")
++    if src.get("note"):
++        L.append(f"- **Note** : {src['note']}")
++    L.append("")
++
++    # 2. Accès ---------------------------------------------------------------
++    L.append("## Accès")
++    L.append("")
++    L.append(f"- **Type** : {src.get('type', 'n/d')}")
++    if intro and intro["endpoints"]:
++        for name, url in intro["endpoints"]:
++            L.append(f"- **Endpoint** (`{name}`) : `{url}`")
++    else:
++        L.append(f"- **Endpoint** : voir URL source ({src['url']})")
++    auth = "Aucune (accès public, identification honnête par User-Agent)"
++    if sid == "ticketmaster":
++        auth = "Clé API gratuite `TICKETMASTER_API_KEY` (developer.ticketmaster.com)"
++    elif sid == "bandsintown":
++        auth = "`app_id` d'identification (`BANDSINTOWN_APP_ID`, format widget accepté)"
++    elif intro and "Scrapfly" in intro["backend"]:
++        auth = "Aucune côté source ; `SCRAPFLY_API_KEY` requis pour le backend Scrapfly"
++    L.append(f"- **Auth** : {auth}")
++    if intro:
++        L.append(f"- **Pagination** : {intro['pagination']}")
++        L.append(f"- **Backend** : {intro['backend']}")
++        if intro["request_delay"]:
++            L.append(f"- **Throttle** : {intro['request_delay']} s entre requêtes")
++        L.append(f"- **Accès légal** : {src.get('acces_legal', 'n/d')}")
++        if intro["header"]:
++            L.append("")
++            L.append("<details><summary>En-tête documentaire du connecteur</summary>")
++            L.append("")
++            for h in intro["header"]:
++                L.append(f"> {h}")
++            L.append("")
++            L.append("</details>")
++    else:
++        L.append(f"- **Accès légal** : {src.get('acces_legal', 'n/d')}")
++    L.append("")
++
++    # 3. Champs récupérés → schéma -------------------------------------------
++    L.append("## Champs récupérés → schéma")
++    L.append("")
++    if stats and stats["active"]:
++        ex = stats["example"]
++        L.append(f"Complétude mesurée sur les **{stats['active']} événements "
++                 f"actifs** de la source ; exemples tirés d'un événement réel "
++                 f"(`{md_escape(ex.get('uid'))}`).")
++        L.append("")
++        L.append("| Champ (`events.*`) | Description | Complétude | Exemple réel |")
++        L.append("|---|---|---|---|")
++        for col, label, desc in SCHEMA_FIELDS:
++            n = stats["per_field"][col]
++            if col == "lat":
++                val = (f"{ex.get('lat')}, {ex.get('lng')}"
++                       if ex.get("lat") is not None else None)
++            else:
++                val = ex.get(col)
++            L.append(f"| `{col}` — {label} | {desc} | "
++                     f"{pct(n, stats['active'])} | {md_escape(val)} |")
++    else:
++        L.append("*Aucun événement actif en base pour cette source — pas de "
++                 "schéma live à montrer.*")
++    L.append("")
++
++    # 4. Fréquence & budgets ---------------------------------------------------
++    L.append("## Fréquence & budgets")
++    L.append("")
++    L.append(f"- **Cadence** : {src.get('cadence', 'n/d')}")
++    if intro and intro["env"]:
++        L.append("- **Budgets / plafonds (variables d'environnement)** :")
++        L.append("")
++        L.append("| Variable | Défaut | Rôle |")
++        L.append("|---|---|---|")
++        for var, default, comment in intro["env"]:
++            L.append(f"| `{var}` | `{default}` | {comment or '—'} |")
++    L.append("- **Budget global** : géocodage Nominatim plafonné à "
++             "`SORTIKA_GEOCODE_MAX` (défaut 120) requêtes réseau/cycle, "
++             "toutes sources confondues (`sortika/geocode.py`, cache disque).")
++    L.append("")
++
++    # 5. Volumétrie & complétude live ------------------------------------------
++    L.append("## Volumétrie & complétude live")
++    L.append("")
++    if stats:
++        L.append(f"*(mesuré le {STAMP} dans `data/sortika.db`)*")
++        L.append("")
++        L.append(f"- **Événements en base** : {stats['total']} "
++                 f"(dont **{stats['active']} actifs**)")
++        for label, n in stats["metrics"]:
++            L.append(f"- **{label}** : {n}/{stats['active']} actifs "
++                     f"({pct(n, stats['active'])})")
++        ls = stats["last_sync"]
++        if ls:
++            L.append(f"- **Dernier sync** : {fmt_ts(ls['ts'])} — "
++                     f"fetched {ls['fetched']}, +{ls['added']} ajoutés, "
++                     f"~{ls['updated']} mis à jour, -{ls['removed']} retirés"
++                     + (f", **erreur : {md_escape(ls['error'])}**"
++                        if ls["error"] else ""))
++        L.append(f"- **Syncs enregistrés** (sync_log) : {stats['nsync']}")
++    else:
++        L.append("*Source sans connecteur runtime : aucune donnée en base.*")
++    L.append("")
++
++    # 6. Erreurs & dépannage -----------------------------------------------------
++    L.append("## Erreurs & dépannage")
++    L.append("")
++    if stats and stats["errors"]:
++        L.append("Erreurs relevées dans `sync_log` :")
++        L.append("")
++        L.append("| Erreur | Occurrences | Dernière fois |")
++        L.append("|---|---|---|")
++        for e in stats["errors"]:
++            err, cnt, ts = list(e.values())
++            L.append(f"| {md_escape(err)} | {cnt} | {fmt_ts(ts)} |")
++        L.append("")
++    elif stats:
++        L.append("Aucune erreur dans `sync_log` pour cette source. ✅")
++        L.append("")
++    for tip in DEPANNAGE.get(sid, []):
++        L.append(f"- {tip}")
++    if intro:
++        L.append("- Rejouer un sync isolé : `python3 run.py sync --source "
++                 f"{sid}` (ou via le watcher PM2) ; inspecter ensuite "
++                 "`sync_log` : `sqlite3 data/sortika.db \"SELECT * FROM "
++                 f"sync_log WHERE source='{sid}' ORDER BY ts DESC LIMIT 5;\"`")
++    L.append("")
++
++    # 7. Licence / attribution ------------------------------------------------------
++    L.append("## Licence / attribution")
++    L.append("")
++    L.append(f"- {src.get('acces_legal', 'n/d')}")
++    if sid in ATTRIBUTIONS:
++        L.append("")
++        L.append(ATTRIBUTIONS[sid])
++    L.append("")
++
++    # 8. Historique -------------------------------------------------------------------
++    L.append("## Historique")
++    L.append("")
++    if src.get("statut") == "abandonnee":
++        L.append(f"- **Source abandonnée** — {src.get('note', 'sans note')}")
++    L.append(WAVE_HISTORY)
++    if intro:
++        hist = git_history(CONNECTORS_DIR / intro["file"])
++        if hist:
++            L.append("")
++            L.append(f"Commits touchant `sortika/connectors/{intro['file']}` :")
++            L.append("")
++            for h in hist:
++                L.append(f"- `{h.split(' ', 1)[0]}` {h.split(' ', 1)[1]}")
++    L.append("")
++    return "\n".join(L)
++
++
++# ---------------------------------------------------------------------------
++# INDEX
++# ---------------------------------------------------------------------------
++
++def render_index(rows: list[dict]) -> str:
++    L: list[str] = []
++    L.append("# Sorti-Ka — Connecteurs de sources d'événements")
++    L.append("")
++    L.append(f"> Index généré le {STAMP} par `scripts/gen_connector_docs.py` "
++             f"(rejouable : `python3 scripts/gen_connector_docs.py`). "
++             f"Croise `data/sources.json`, l'introspection de "
++             f"`sortika/connectors/*.py` et la base live `data/sortika.db`.")
++    L.append("")
++    actives = [r for r in rows if r["src"].get("statut") != "abandonnee"]
++    abandon = [r for r in rows if r["src"].get("statut") == "abandonnee"]
++    tot = sum(r["stats"]["total"] for r in rows if r["stats"])
++    act = sum(r["stats"]["active"] for r in rows if r["stats"])
++    L.append(f"**{len(rows)} sources au registre** — {len(actives)} "
++             f"actives/prêtes, {len(abandon)} abandonnées · "
++             f"**{tot} événements en base** (dont {act} actifs).")
++    L.append("")
++    L.append("⚠️ **Attributions requises** : Ville de Montréal (CC BY 4.0) ; "
++             "SIT Québec / Ministère du Tourisme et Ville de Laval "
++             "(CC 4.0 — Données Québec). Détails dans chaque fiche, section "
++             "« Licence / attribution ».")
++    L.append("")
++    L.append("## Sources actives / prêtes")
++    L.append("")
++    L.append("| Source | Type | Statut | Actifs | GPS | Prix | Heure | "
++             "Artistes | Image | Salle | Dernier sync |")
++    L.append("|---|---|---|---|---|---|---|---|---|---|---|")
++    for r in actives:
++        s, st = r["src"], r["stats"]
++        if st and st["active"]:
++            cells = [pct(n, st["active"]) for _, n in st["metrics"]]
++            last = fmt_ts(st["last_sync"]["ts"]) if st["last_sync"] else "n/d"
++            L.append(f"| [{s['name']}]({s['id']}.md) | {s['type']} | "
++                     f"{s['statut']} | {st['active']} | " + " | ".join(cells) +
++                     f" | {last} |")
++        else:
++            last = (fmt_ts(st["last_sync"]["ts"])
++                    if st and st["last_sync"] else "n/d")
++            L.append(f"| [{s['name']}]({s['id']}.md) | {s['type']} | "
++                     f"{s['statut']} | 0 | — | — | — | — | — | — | {last} |")
++    L.append("")
++    L.append("## Sources abandonnées")
++    L.append("")
++    L.append("| Source | Type | Raison |")
++    L.append("|---|---|---|")
++    for r in abandon:
++        s = r["src"]
++        L.append(f"| [{s['name']}]({s['id']}.md) | {s['type']} | "
++                 f"{md_escape(s.get('note', 'n/d'))} |")
++    L.append("")
++    L.append("## Régénérer cette documentation")
++    L.append("")
++    L.append("```bash")
++    L.append("cd ~/apps/sorti-ka && python3 scripts/gen_connector_docs.py")
++    L.append("```")
++    L.append("")
++    return "\n".join(L)
++
++
++# ---------------------------------------------------------------------------
++
++def main() -> int:
++    sources = json.loads(SOURCES_JSON.read_text(encoding="utf-8"))["sources"]
++    con = sqlite3.connect(f"file:{DB_PATH}?mode=ro", uri=True)
++    con.row_factory = sqlite3.Row
++    cur = con.cursor()
++    OUT_DIR.mkdir(parents=True, exist_ok=True)
++
++    rows = []
++    for src in sources:
++        sid = src["id"]
++        cpath = CONNECTORS_DIR / f"{sid.replace('-', '_')}.py"
++        intro = introspect(cpath) if cpath.exists() else None
++        has_data = cur.execute(
++            "SELECT COUNT(*) FROM events WHERE source=?", (sid,)).fetchone()[0]
++        has_log = cur.execute(
++            "SELECT COUNT(*) FROM sync_log WHERE source=?", (sid,)).fetchone()[0]
++        stats = db_stats(cur, sid) if (intro or has_data or has_log) else None
++        fiche = render_fiche(src, intro, stats)
++        (OUT_DIR / f"{sid}.md").write_text(fiche, encoding="utf-8")
++        rows.append({"src": src, "intro": intro, "stats": stats})
++        print(f"  fiche : docs/connecteurs/{sid}.md"
++              + (f"  ({stats['active']} actifs)" if stats else "  (sans données)"))
++
++    (OUT_DIR / "INDEX.md").write_text(render_index(rows), encoding="utf-8")
++    print(f"  index : docs/connecteurs/INDEX.md ({len(rows)} sources)")
++    con.close()
++    return 0
++
++
++if __name__ == "__main__":
++    sys.exit(main())

spb/sorti-ka

docs: documentation standardisée des connecteurs (générateur rejouable)

Theme