SPB Git forge

spb/job-ka

Public
227commits 1branches 0releases
37.7 MBsize
maindefault branch
1 h agolast push
HTML 82.1% Python 14.6% TypeScript 1.9% CSS 1% JavaScript 0.5%
8.5 KB

# H2O Innovation (h2o_innovation)

Employeur direct · Plateforme ATS : adp · Statut registre : actif · Connecteur : jobka/connectors/h2o_innovation.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 19000101_000001
CID 7682e0ff-ab6e-4e2a-b4c4-4d3845982888
EMPLOYER H2O Innovation
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 13 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 / … 100 %
salary — Salaire ($) bornes numériques normalisées $/h et $/an 8 %
salary_label — Libellé salaire texte salarial original 0 %
benefits — Avantages avantages sociaux publiés (JSON) 0 %
requirements — Exigences scolarité, expérience, langues (JSON) 77 %
date_posted — Date de parution ISO 8601 100 %
date_deadline — Date limite date limite pour postuler 0 %
category — Catégorie taxonomie interne (TI, Santé, …) 69 %
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 : Soudeur.euse – Tuyauterie industrielle | CWB — Ham-Nord · ∅ · parue le 2026-09-14.

# 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 : 14 (dont 13 actives, 0 masquées comme doublons dup_of)
  • Salaire : 1/13 actives (8 %)
  • GPS : 13/13 actives (100 %)
  • Mode : 0/13 actives (0 %)
  • Parution : 13/13 actives (100 %)
  • Dernier sync : 2026-09-21 17:08 — trouvées 13, +0, ~0, -0
  • Syncs enregistrés (sync_log) : 243

# 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:46
  • Rejouer un sync isolé : .venv/bin/python run.py sync h2o_innovation puis inspecter sync_log : sqlite3 data/jobka.db "SELECT * FROM sync_log WHERE source='h2o_innovation' 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 H2O Innovation » 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/h2o_innovation.py :

  • 644a2d4 2026-08-30 [ka6] fix connecteur h2o_innovation: repli « détail seulement » pendant les maintenances nocturnes d'ADP WFN — cause de l'échec du 2026-08-29 22:19 : fenêtre de maintenance planifiée d'ADP Workforce Now du samedi soir (~22:00→02:00 ET, même événement systémique que cultures_genv a57f452 et groupe_nordik a17b979), pendant laquelle workforcenow.adp.com redirige vers sorry.adp.com et la liste job-requisitions renvoie du HTML (« Expecting value: line 1 column 1 »). Un seul passage raté + cycle ~3 h suffit à dépasser le seuil stale de 4 h. Fix (pattern cultures_genv/groupe_nordik/ciena) : 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 — 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 → 9 offres revalidées live ; run.py sync h2o_innovation (chemin normal) → ok, found=9 (= médiane 9.0), 9 actives en base. Corrige aussi le chemin erroné dans l'en-tête du fichier. pm2 restart job-ka-sync OK, site local 200, www.job-ka.com 200.
  • feee4d1 2026-08-29 Revert "[ka6] fix connecteur h2o_innovation: aucun bug — séquelle de la maintenance planifiée ADP WFN du 2026-08-28 soir (302 vers sorry.adp.com, même cause que cultures_genv/groupe_nordik, doc mission richelieu e152035) ; maintenance terminée, sync rejoué = 9 offres (médiane 9.0) ; note de contexte ajoutée au connecteur"
  • 64ca139 2026-08-29 [ka6] fix connecteur h2o_innovation: aucun bug — séquelle de la maintenance planifiée ADP WFN du 2026-08-28 soir (302 vers sorry.adp.com, même cause que cultures_genv/groupe_nordik, doc mission richelieu e152035) ; maintenance terminée, sync rejoué = 9 offres (médiane 9.0) ; note de contexte ajoutée au connecteur
  • 856863d 2026-08-25 Vague D implémentée — 75 nouveaux connecteurs (968 -> 1044 employeurs), ~768 offres QC