3.5 KiB
ChronoTrack Live — docs de référence (MS1)
Source officielle : https://api.chronotrack.com/dev/docs
Résultats (champs pays / province) : https://api.chronotrack.com/dev/docs/ctlive-results
Meta entry : snapshot local api-meta-entry.json
Fichiers
| Fichier | Contenu |
|---|---|
api-dev-docs.md |
Copie Overview /dev/docs |
api-meta-entry.json |
Colonnes meta entry |
README.md |
Ce fichier |
Calibrage validé (2026-08-11) — event 93163
Sources : Sonde lecture pays (GET entry) + export confirmedentries CSV.
Quand Athlete Info UI = Canada + Quebec, CT stocke :
| Champ API / export | Valeur |
|---|---|
location_country / COUNTRY_CODE |
CA (ISO-2) |
location_region / REGION_CODE |
QC |
country_name / COUNTRY_NAME |
Canada |
REGION_NAME (export) |
Quebec |
Pas CAN (ISO-3) dans location_country.
Export massif : 1578/1580 sans COUNTRY_CODE avant fix — seule Gabrielle-Ann (manuel) + 1 FR avaient un pays.
Relecture liste entry (vérif contenu)
L’écriture accepte souvent bib / first_name / external_id.
La liste meta renvoie plutôt :
| Payload écriture | Clé lecture CT |
|---|---|
external_id |
entry_external_id |
bib |
entry_bib |
birthdate |
athlete_birthdate |
first_name / last_name / sex |
athlete_first_name / athlete_last_name / athlete_sex |
fx_chronotrack_verify.php mappe ces alias — sinon faux écarts « CT ∅ ».
Écriture pays/région : seulement location_country / location_region / country_name
(pas country_code / state_code — collision possible → QC dans le pays).
Si province canadienne (ex. QC) et pays MS1 ≠ CA → province non envoyée + log skip_region
(pas de réparation auto du pays ; pas de faux écart à la vérif).
Push (règle produit MSIN-4574 — correctitude > vitesse) :
- entry déjà dans CT (
entry_id) → PUT unitaire (écrase pays / région / bib) - création seulement → POST bulk
- Jamais sacrifier des champs pour aller plus vite ; optimiser la vitesse après 0 écart
- Vérifier contenu = validation seulement (pas un filet opérationnel)
Fichiers code (module)
| Fichier | Rôle |
|---|---|
fx_chronotrack_payload.php |
Source de vérité écriture entry (pays, bib, sexe, notes) |
fx_chronotrack_push.php |
Push HTTP, lots, job, conflits dossard |
fx_chronotrack_read.php |
Lecture entries CT, index, comptage |
fx_chronotrack_lifecycle.php |
Cancel / restore / WITHDRAWN / orphelins |
fx_chronotrack_cron.php |
Auto-push / cron |
fx_chronotrack_probe.php |
Sondes Diagnostic (support) |
fx_chronotrack_sync.php |
Classify, preview, logs |
fx_chronotrack_verify.php |
Vérifier contenu — payload MS1 vs entries CT (écarts) |
| UI Opération | Envoyer / Tout renvoyer / Vérifier contenu / logs |
| UI Diagnostic | Sondes + Orphelins CT (hors éligibles) |
| MS1 BD | Champ CT |
|---|---|
pay_id → inscriptions_pays.pay_iso |
location_country + country_code = ISO-2 (CA) |
pay_id → pay_nom_en |
country_name (Canada) |
pro_id → inscriptions_provinces.pro_iso |
location_region + state_code = QC |
pay_iso3 / map ISO-2→3 |
référence / logs seulement (pas Athlete Info) |
Docs résultats CTLIVE
La page résultats mentionne country_code « three character ISO-3166 ».
Pour Athlete Info / entry / export confirmed, la vérité mesurée = ISO-2. On suit la calibrage entry.