SPB Git forge

spb/job-ka

Public
229commits 1branches 0releases
38.1 MBsize
maindefault branch
2 min agolast push
HTML 82.1% Python 14.6% TypeScript 1.9% CSS 1% JavaScript 0.5%
9.4 KB

# Cultures Gen V (cultures_genv)

Employeur direct · Plateforme ATS : adp · Statut registre : actif · Connecteur : jobka/connectors/cultures_genv.py

# Description

# Accès

  • Mécanique : voir la fiche plateforme ats-adp.md — API JSON publique du site carrières, backend requests direct (Scrapfly seulement si indiqué sur la fiche plateforme).
  • Identifiants du tenant (attributs du connecteur) :
Attribut Valeur
CCID 36427051_2
CID 8b346731-d189-4cf2-a14c-9e48d38befde
EMPLOYER Cultures Gen V
LANG fr_CA
  • Throttle : 1.0 s entre requêtes.
  • Filtre Québec : seuls les postes localisés au Québec sont conservés (facette serveur quand l'ATS en offre une, sinon is_quebec_location côté client).

# Champs → schéma

Complétude mesurée sur les 5 offres actives de la source (base live, 2026-09-21 18:06 EDT).

Champ (jobs.*) Rôle Complétude
title — Titre titre du poste 100 %
employer — Employeur nom de l'entreprise 100 %
url — URL lien direct vers l'offre originale 100 %
description — Description texte complet (HTML nettoyé) 100 %
city — Ville municipalité normalisée 100 %
region — Région région administrative 100 %
address — Adresse adresse du lieu de travail 0 %
postal_code — Code postal code postal si publié 100 %
work_mode — Mode presentiel / hybride / teletravail 0 %
employment_type — Type temps_plein / temps_partiel / … 60 %
salary — Salaire ($) bornes numériques normalisées $/h et $/an 20 %
salary_label — Libellé salaire texte salarial original 0 %
benefits — Avantages avantages sociaux publiés (JSON) 0 %
requirements — Exigences scolarité, expérience, langues (JSON) 80 %
date_posted — Date de parution ISO 8601 100 %
date_deadline — Date limite date limite pour postuler 0 %
category — Catégorie taxonomie interne (TI, Santé, …) 40 %
language — Langue fr / en / bilingue (source ou heuristique) 100 %
company_logo — Logo employeur URL du logo si exposé par la source 0 %
apply_url — Candidature lien de candidature directe 0 %
gps — GPS lat/lng (géocodage sans invention) 100 %

Exemple réel : Gestionnaire de compte — Ste-Clotilde · ∅ · parue le 2026-09-18.

# Fréquence & budgets

  • Cadence : resynchronisation horaire (PM2 job-ka-sync = run.py watch 60), suivie du géocodage en lot puis de la déduplication inter-sources.
  • Throttle : 1.0 s minimum entre deux requêtes vers la source (request_delay).
  • Budgets / plafonds (variables d'environnement) :
Variable Défaut
JOBKA_ADP_DETAIL_LIMIT 80
  • Cache BD des pages détail (detail_cache) : le détail d'une offre n'est re-téléchargé que si sa ligne de liste change.

# Volumétrie & complétude live

(mesuré le 2026-09-21 18:06 EDT dans data/jobka.db)

  • Offres en base : 9 (dont 5 actives, 0 masquées comme doublons dup_of)
  • Salaire : 1/5 actives (20 %)
  • GPS : 5/5 actives (100 %)
  • Mode : 0/5 actives (0 %)
  • Parution : 5/5 actives (100 %)
  • Dernier sync : 2026-09-21 16:51 — trouvées 5, +0, ~0, -0
  • Syncs enregistrés (sync_log) : 338

# Erreurs & dépannage

Erreurs relevées dans sync_log :

Erreur Occurrences Dernière fois
Expecting value: line 1 column 1 (char 0) 4 2026-08-30 01:26
500 Server Error: for url: https://workforcenow.adp.com/mascsr/default/careercenter/publi… 1 2026-08-22 00:35
  • Rejouer un sync isolé : .venv/bin/python run.py sync cultures_genv puis inspecter sync_log : sqlite3 data/jobka.db "SELECT * FROM sync_log WHERE source='cultures_genv' ORDER BY ts DESC LIMIT 5;"
  • Garde-fous : une source qui retourne ≤ 25 % de sa médiane historique déclenche une alerte et les retraits sont suspendus ; une offre doit manquer 2 syncs consécutifs avant active=0.

# Licence / conformité

Flux public du site carrières officiel de l'employeur (API JSON de l'ATS ou HTML rendu serveur) — le même contenu que la page carrière affiche publiquement, prévu pour la diffusion des offres, sans authentification. Chaque offre conserve son URL originale et le bouton « Postuler chez Cultures Gen V » renvoie chez l'employeur. Aucune donnée personnelle de candidat n'est collectée. User-Agent identifié JobKaBot/1.0 (+https://www.job-ka.com; contact@spboucher.ai) sur les accès directs ; requêtes throttlées et plafonnées par budgets.

# Historique

Mission connecteurs du 2026-08-18 — passage de 135 à 217 employeurs directs connectés, de 9 à 17 plateformes ATS, ajout de 3 portails agrégateurs et du canal de dépôt direct :

  • fd4bfc8 qualité lieux : rejet des villes hors Québec, bâtiments McGill → Montréal ;
  • 5a66f48 +59 employeurs (sondage massif d'ATS + détection de pages carrières) ;
  • 4917d57 8 nouveaux ATS (Taleo, Njoyn, UltiPro, iCIMS, SuccessFactors, ADP WFN, Digital Recruiters, Workland) + 23 employeurs publics/parapublics ;
  • f6e7571 portails Guichet-Emplois, Jobillico, Espresso-Jobs — l'offre directe gagne toujours la canonique (dédup) ;
  • 744cbfc badge « Offre directe », stats directes/portails, dépôt direct employeurs ;
  • 1604ff9 reprise sur coupure WAF Guichet-Emplois (retry + acquis partiel).

Commits touchant jobka/connectors/cultures_genv.py :

  • a57f452 2026-08-30 [ka6] fix connecteur cultures_genv: repli « détail seulement » pendant les maintenances nocturnes d'ADP WFN — cause de l'échec du 2026-08-29 22:01 : deuxième fenêtre de maintenance planifiée d'ADP Workforce Now (samedi soir ~22:00→02:00 ET, après celle de vendredi déjà documentée), pendant laquelle tout workforcenow.adp.com redirige vers sorry.adp.com et la liste job-requisitions renvoie du HTML (« Expecting value: line 1 column 1 »). TOUS les connecteurs ADP passés entre 22:00 et 23:27 ont échoué à l'identique (cookit, groupe_nordik, h2o_innovation, msi_gestion, mitsubishi_hc_capital, nemaska_lithium, richelieu, etc.) = systémique côté ADP, aucun tenant en cause. Comme le cycle met ~3 h entre deux passages, un seul passage raté pendant la fenêtre dépasse le seuil stale de 4 h. Fix (pattern ciena ae44d7c) : si la liste échoue en 5xx/non-JSON, revalidation une à une des offres actives connues via l'API détail job-requisitions/ (réquisition complète live : titre, date, lieux, description — aucune donnée inventée) ; 404 = offre retirée ; si RIEN n'est validable (maintenance totale) l'erreur d'origine est propagée (sync en échec, inventaire préservé). Le chemin liste normal reprend seul dès la fin de la maintenance. Tests réels : repli avec liste 502 simulée → 7 offres revalidées live ; run.py sync cultures_genv (chemin normal) → ok, found=7 (= médiane 7.0), 7 actives en base. pm2 restart job-ka-sync OK, site local 200, www.job-ka.com 200.
  • 45173d5 2026-08-29 Revert "[ka6] fix connecteur cultures_genv: aucun bug — séquelle de la maintenance planifiée ADP WFN du 2026-08-28 soir (302 vers sorry.adp.com, cause documentée par la mission richelieu e152035) ; maintenance terminée, sync rejoué = 7 offres (médiane 7.0) ; note de contexte ajoutée au connecteur"
  • 7efe1b9 2026-08-29 [ka6] fix connecteur cultures_genv: aucun bug — séquelle de la maintenance planifiée ADP WFN du 2026-08-28 soir (302 vers sorry.adp.com, cause documentée par la mission richelieu e152035) ; maintenance terminée, sync rejoué = 7 offres (médiane 7.0) ; note de contexte ajoutée au connecteur
  • 0298197 2026-08-19 Vague A (detected-other-ats) — nouveaux employeurs sur familles existantes : Hydro-Québec (SuccessFactors CSB emploi.hydroquebec.com, 66 offres) ; Deloitte Canada (CSB careers.deloitte.ca, 105 offres QC — remplace la détection Taleo périmée) ; CGI (Njoyn corporatif via Scrapfly, babillard mondial de ~2 900 postes filtré Québec, budgets frugaux) ; Fruit d'Or (12) et Nortera (24 QC) sur UKG Pro recruiting.ultipro.ca ; Placements Mackenzie/groupe Power (iCIMS FR, 3 QC) ; Cultures Gen V (6), Bento Sushi (9 QC), Osgoode Properties (1) sur ADP WFN. Retrait ttcglobal (plus d'offre QC : 2 offres Dallas/Londres). Écartés avec raisons (docs/CONFORMITE.md) : Canada Vie, Groupe Dynamite, Jack Astor's/SIR, Méchant Bœuf, Valero (0 offre), Résolu (fusion Domtar), Power Corp directe.