SPB Git forge

spb/sorti-ka

Public

Toutes les sorties et tous les événements du Québec, un seul endroit — 7 connecteurs, fiches SSR, design Groupe KA.

58commits 1branches 0releases
13.7 MBsize
maindefault branch
17 days agolast push
HTML 82.9% Python 15.2% TypeScript 0.9% JavaScript 0.7%
10.0 KB

# Ticketpro — billetterie canadienne (tenants Québec) (ticketpro)

Fiche générée le 2026-08-25 19:01 EDT par scripts/gen_connector_docs.py — ne pas éditer à la main, relancer le script.

Statut : actif · Type : billetterie · Connecteur : sortika/connectors/ticketpro.py

# Description

  • Source : Ticketpro — billetterie canadienne (tenants Québec)
  • Couverture : Théâtre St-Denis + Studio St-Denis (Montréal), Fun Nation (Salle Pierre-Mercure, Monument-National, Club Soda), ExpoCité (Québec), Salle André-Gagnon (La Pocatière), Palais des congrès de Montréal, La Belle Église de Chertsey, Théâtre Rialto, Huntingdon… ~200 spectacles / ~1 100 séances datées (vérifié 2026-08-22)
  • Extraction : API JSON publique de la nouvelle plateforme SPA par tenant (.ticketpro.ca/api/v1/pages, aucun anti-bot ni rendu JS) : 1 fiche par spectacle avec titre, artiste, description, image, lieu complet (adresse, ville, code postal, lat/lng), toutes les dates horodatées, tags et drapeaux cancelled/soldout → 1 Event par (page, date à venir). 6 tenants QC dans data/ticketpro_tenants.json (tproqc agrège la province mais pas tprotsd), dédup inter-tenants par id de page. Lieux de restauration (soupers-spectacles St-Denis) et musée à créneaux exclus par config. startingPrice toujours 0 → aucun prix émis. MAJ 2026-08-25 : startingPrice vide dans la liste MAIS tarifs réels publics en 2 GET/spectacle (détail /api/v1/pages/ → offre ?options=prices) : priceLevels.price_min en cents (taxes+frais inclus) → prix plancher (92,8 % des séances) + statut PAR séance (saleState, séances datées sans heure → repli au jour) ; cache data/ticketpro_cache.json, TP_PRICE_MAX=40/sync, re-visite 3 j ; 8 tenants QC (+arsenalcontemporarysale, +lefifa)

# Accès

  • Type : billetterie
  • Endpoint : voir URL source (https://www.ticketpro.ca/)
  • Auth : Aucune côté source ; SCRAPFLY_API_KEY requis pour le backend Scrapfly
  • Pagination : par numéro de page
  • Backend : Scrapfly (anti-bot / rendu JS) via base.get_scrapfly()
  • Throttle : 1.0 s entre requêtes
  • Accès légal : Billetterie publique ; robots.txt n'interdit que /admin/ /gui/ /report/ (vérifié 2026-08-22) ; API du site officiel consommée telle quelle, GET throttlés 1 s, UA honnête, lien d'achat vers la fiche officielle /fr/pages/ du tenant
En-tête documentaire du connecteur

connectors/ticketpro.py : Ticketpro — billetterie canadienne, tenants Québec (Phase 5). Grande billetterie indépendante (Théâtre St-Denis, Fun Nation, ExpoCité, Salle André-Gagnon, Palais des congrès, salles régionales…). Source : nouvelle plateforme SPA par tenant .ticketpro.ca dont l'API JSON est PUBLIQUE et sans anti-bot (vérifié 2026-08-22, robots.txt : seuls /admin/ /gui/ /report/ interdits) : GET /api/v1/pages = 1 fiche par spectacle avec titre, artiste, sous-titre, description, image, lieu COMPLET (adresse, ville, province, code postal, lat/lng), TOUTES les dates horodatées des représentations, tags (catégories) et drapeaux cancelled/soldout. AUCUN rendu JS ni Scrapfly nécessaire. Extraction: 1 GET /api/v1/pages par tenant (6 tenants QC configurés dans data/ticketpro_tenants.json — tproqc agrège la province mais PAS tprotsd, vérifié) → 1 Event par (page, date à venir), dédup inter-tenants par id de page (ids globaux). Les lieux de restauration (soupers-spectacles) et le musée à créneaux sont exclus par config (exclure_lieux). Filtre province: provinceState == QC. startingPrice et prices[] sont toujours vides dans la LISTE, mais les tarifs réels sont publics en 2 GET par spectacle (vérifié 2026-08-25) : /api/v1/pages/ (détail → itemsDates.items[].dates[] = séances avec saleState + URL relative de l'offre) puis /api/v1<url de la 1re séance à venir> (?options=prices) → itemHours[].priceLevels[].price_min en CENTS (taxes et frais inclus : taxIncluded/serviceChargesIncluded=true). Prix plancher de la page appliqué à ses séances + statut PAR séance (saleState SOLDOUT/CANCELLED…). Enrichissement incrémental : cache data/ticketpro_cache.json, TP_PRICE_MAX pages/sync, re-visite 3 j, version de parse « v » (patron lavitrine). Accès : billetterie publique, API du site officiel, GET throttlés 1 s, identification honnête, lien d'achat vers la fiche officielle /fr/pages/ du tenant.

# Champs récupérés → schéma

Complétude mesurée sur les 395 événements actifs de la source ; exemples tirés d'un événement réel (ticketpro:1673194652-2026-12-13T1400).

Champ (events.*) Description Complétude Exemple réel
title — Titre titre de l'événement 100 % Décembre
description — Description texte descriptif (source ou fiche détail) 98 % Québec Issime fête ses 30 ans et est de retour à la Salle Pierre-Mercure avec son spectacle embl…
url — URL lien vers la fiche originale / billetterie 100 % https://tproqc.ticketpro.ca/fr/pages/Decembre2026
categories — Catégories taxonomie canonique Sorti-Ka (JSON) 100 % ["arts-scene"]
venue — Salle (venue) nom du lieu 100 % Salle Pierre-Mercure du centre Pierre-Péladeau
address — Adresse adresse civique 99 % 300, boulevard De Maisonneuve Est
city — Ville municipalité 100 % Montréal
region — Région région administrative 100 % Montréal
lat — GPS (lat/lng) coordonnées géographiques 99 % 45.5134852, -73.5622721
start_date — Date début date locale AAAA-MM-JJ 100 % 2026-12-13
end_date — Date fin date locale AAAA-MM-JJ 100 % 2026-12-13
start_time — Heure (start_time) heure locale HH:MM (Québec) 100 % 14:00
end_time — Heure de fin (end_time) heure locale HH:MM (Québec) 0 % ∅
status — Statut cancelled / postponed / soldout (NULL = prévu) 2 % soldout
is_free — Gratuité (is_free) 1 gratuit / 0 payant / NULL inconnu 85 % 0
price_min — Prix min tarif minimal réel ($) 85 % 39.5
price_label — Libellé prix étiquette tarifaire affichable 0 % ∅
artists — Artistes têtes d'affiche / lineup (JSON) 70 % ["Décembre"]
organizer — Organisateur promoteur / organisme 0 % ∅
image — Image visuel (og:image ou média source) 100 % https://tproqc.ticketpro.ca/api/v1/resources/1673194602.jpeg?version=1
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
TP_PRICE_MAX 40 —
  • 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-25 19:01 EDT dans data/sortika.db)

  • Événements en base : 403 (dont 395 actifs)
  • GPS : 390/395 actifs (99 %)
  • Prix : 334/395 actifs (85 %)
  • Heure (start_time) : 395/395 actifs (100 %)
  • Heure de fin : 0/395 actifs (0 %)
  • Statut (annulé/reporté/complet) : 7/395 actifs (2 %)
  • Artistes : 275/395 actifs (70 %)
  • Image : 394/395 actifs (100 %)
  • Salle (venue) : 395/395 actifs (100 %)
  • Dernier sync : 2026-08-25 18:54 — fetched 398, +0 ajoutés, ~334 mis à jour, -0 retirés
  • Syncs enregistrés (sync_log) : 57

# Erreurs & dépannage

Aucune erreur dans sync_log pour cette source. ✅

  • Rejouer un sync isolé : python3 run.py sync --source ticketpro (ou via le watcher PM2) ; inspecter ensuite sync_log : sqlite3 data/sortika.db "SELECT * FROM sync_log WHERE source='ticketpro' ORDER BY ts DESC LIMIT 5;"

# Licence / attribution

  • Billetterie publique ; robots.txt n'interdit que /admin/ /gui/ /report/ (vérifié 2026-08-22) ; API du site officiel consommée telle quelle, GET throttlés 1 s, UA honnête, lien d'achat vers la fiche officielle /fr/pages/ du tenant

# 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).
  • 2026-08-19 — Phase 2 (travail de moine) : colonnes additives end_time, status (annulé/reporté/complet) et quarantine (règles anti-aberrations, non publié mais réintégrable) ; règle d'ARCHIVAGE des événements terminés à chaque cycle (jamais supprimés) ; dedup_key inclut désormais l'heure (les séances multiples d'un même jour ne sont plus écrasées à l'affichage) ; alerte « 0 événement futur / chute > 80 % » par source (data/future_counts.json + /api/sources) ; heure et description La Vitrine ; end_time/organisateur/statut Eventbrite ; og:description Atuvu ; premières parties + portes + tournée evenko ; offres billets Bandsintown ; taxonomie type-event + description intégrale Brossard ; image Longueuil ; géocodage par ADRESSE CIVIQUE prioritaire ; villes normalisées au Répertoire MAMH (data/villes_canon.json) ; laval consignée « morte-a-la-source ».

Commits touchant sortika/connectors/ticketpro.py :

  • c12344b 2026-08-22 Phase 5 — billetterie Ticketpro (API JSON multi-tenants : St-Denis, Fun Nation, ExpoCité, PdC, SAG…) + salle Odyscène (Ste-Thérèse, Laurentides) via sallesjsonld