SPB Git forge

spb/job-ka

Public
229commits 1branches 0releases
38.1 MBsize
maindefault branch
2 h agolast push
HTML 82.1% Python 14.6% TypeScript 1.9% CSS 1% JavaScript 0.5%
8.5 KB · 123 lines markdown
Rendered Raw Blame History
1<!--2=============================================================================3Job·Ka — Groupe KA4Auteur  : Simon-Pierre Boucher5Contact : contact@spboucher.ai6Fichier : docs/connecteurs/groupe_nordik.md7Rôle    : Fiche connecteur — Groupe Nordik (Nordik Spa-Nature) (employeur direct, ATS adp)8Généré  : 2026-09-21 18:06 EDT par scripts/gen_connector_docs.py — NE PAS ÉDITER,9          relancer le script pour régénérer.10=============================================================================11-->1213# Groupe Nordik (Nordik Spa-Nature) (`groupe_nordik`)1415**Employeur direct** · Plateforme ATS : [`adp`](ats-adp.md) · Statut registre : actif · Connecteur : `jobka/connectors/groupe_nordik.py`1617## Description1819- **Site** : [Groupe Nordik (Nordik Spa-Nature)](https://groupenordik.com)20- **Page carrières** : https://workforcenow.adp.com/mascsr/default/mdf/recruitment/recruitment.html?cid=b0ed2582-382c-4558-a5a6-be185625046e&ccId=168215231511_9449&lang=fr_CA21- **Secteurs** : Tourisme et hôtellerie22- **Région** : Outaouais23- Offres marquées **« Offre directe »** dans l'app (badge) : la candidature se fait chez l'employeur, jamais via un intermédiaire.2425## Accès2627- **Mécanique** : voir la fiche plateforme [`ats-adp.md`](ats-adp.md) — API JSON publique du site carrières, backend `requests` direct (Scrapfly seulement si indiqué sur la fiche plateforme).28- **Identifiants du tenant** (attributs du connecteur) :2930| Attribut | Valeur |31|---|---|32| `CCID` | `168215231511_9449` |33| `CID` | `b0ed2582-382c-4558-a5a6-be185625046e` |34| `EMPLOYER` | `Groupe Nordik (Nordik Spa-Nature)` |35| `LANG` | `fr_CA` |36- **Throttle** : 1.0 s entre requêtes.37- **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).3839## Champs → schéma4041Complétude mesurée sur les **12 offres actives** de la source (base live, 2026-09-21 18:06 EDT).4243| Champ (`jobs.*`) | Rôle | Complétude |44|---|---|---|45| `title` — Titre | titre du poste | 100 % |46| `employer` — Employeur | nom de l'entreprise | 100 % |47| `url` — URL | lien direct vers l'offre originale | 100 % |48| `description` — Description | texte complet (HTML nettoyé) | 100 % |49| `city` — Ville | municipalité normalisée | 100 % |50| `region` — Région | région administrative | 100 % |51| `address` — Adresse | adresse du lieu de travail | 0 % |52| `postal_code` — Code postal | code postal si publié | 100 % |53| `work_mode` — Mode | presentiel / hybride / teletravail | 0 % |54| `employment_type` — Type | temps_plein / temps_partiel / … | 100 % |55| `salary` — Salaire ($) | bornes numériques normalisées $/h et $/an | 33 % |56| `salary_label` — Libellé salaire | texte salarial original | 17 % |57| `benefits` — Avantages | avantages sociaux publiés (JSON) | 0 % |58| `requirements` — Exigences | scolarité, expérience, langues (JSON) | 100 % |59| `date_posted` — Date de parution | ISO 8601 | 100 % |60| `date_deadline` — Date limite | date limite pour postuler | 0 % |61| `category` — Catégorie | taxonomie interne (TI, Santé, …) | 33 % |62| `language` — Langue | fr / en / bilingue (source ou heuristique) | 100 % |63| `company_logo` — Logo employeur | URL du logo si exposé par la source | 0 % |64| `apply_url` — Candidature | lien de candidature directe | 0 % |65| `gps` — GPS | lat/lng (géocodage sans invention) | 100 % |6667Exemple réel : *Spécialiste en finition* — Chelsea · Salaire de départ : 28,00 $/heure · parue le 2026-09-14.6869## Fréquence & budgets7071- **Cadence** : resynchronisation **horaire** (PM2 `job-ka-sync` = `run.py watch 60`), suivie du géocodage en lot puis de la déduplication inter-sources.72- **Throttle** : 1.0 s minimum entre deux requêtes vers la source (`request_delay`).73- **Budgets / plafonds (variables d'environnement)** :7475| Variable | Défaut |76|---|---|77| `JOBKA_ADP_DETAIL_LIMIT` | `80` |78- 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.7980## Volumétrie & complétude live8182*(mesuré le 2026-09-21 18:06 EDT dans `data/jobka.db`)*8384- **Offres en base** : 31 (dont **12 actives**, 0 masquées comme doublons `dup_of`)85- **Salaire** : 4/12 actives (33 %)86- **GPS** : 12/12 actives (100 %)87- **Mode** : 0/12 actives (0 %)88- **Parution** : 12/12 actives (100 %)89- **Dernier sync** : 2026-09-21 17:01 — trouvées 12, +0, ~0, -190- **Syncs enregistrés** (`sync_log`) : 2509192## Erreurs & dépannage9394Erreurs relevées dans `sync_log` :9596| Erreur | Occurrences | Dernière fois |97|---|---|---|98| Expecting value: line 1 column 1 (char 0) | 4 | 2026-08-30 01:41 |99100- Rejouer un sync isolé : `.venv/bin/python run.py sync groupe_nordik` puis inspecter `sync_log` : `sqlite3 data/jobka.db "SELECT * FROM sync_log WHERE source='groupe_nordik' ORDER BY ts DESC LIMIT 5;"`101- 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`.102103## Licence / conformité104105**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 Groupe Nordik (Nordik Spa-Nature) » 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.106107## Historique108109**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 :110- `fd4bfc8` qualité lieux : rejet des villes hors Québec, bâtiments McGill → Montréal ;111- `5a66f48` +59 employeurs (sondage massif d'ATS + détection de pages carrières) ;112- `4917d57` 8 nouveaux ATS (Taleo, Njoyn, UltiPro, iCIMS, SuccessFactors, ADP WFN, Digital Recruiters, Workland) + 23 employeurs publics/parapublics ;113- `f6e7571` portails Guichet-Emplois, Jobillico, Espresso-Jobs — l'offre directe gagne toujours la canonique (dédup) ;114- `744cbfc` badge « Offre directe », stats directes/portails, dépôt direct employeurs ;115- `1604ff9` reprise sur coupure WAF Guichet-Emplois (retry + acquis partiel).116117Commits touchant `jobka/connectors/groupe_nordik.py` :118119- `a17b979` 2026-08-30 [ka6] fix connecteur groupe_nordik: repli « détail seulement » pendant les maintenances nocturnes d'ADP WFN — cause de l'échec du 2026-08-29 22:16 : 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), 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/ciena) : si la liste échoue en 5xx/non-JSON, revalidation une à une des offres actives connues via l'API détail job-requisitions/<itemID> (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 → 13 offres revalidées live ; run.py sync groupe_nordik (chemin normal) → ok, found=13 (= médiane 13.0), 13 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.120- `271d373` 2026-08-29 Revert "[ka6] fix connecteur groupe_nordik: 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, doc mission richelieu e152035) ; maintenance terminée, sync rejoué = 13 offres (médiane 13.0) ; note de contexte ajoutée au connecteur"121- `af54cec` 2026-08-29 [ka6] fix connecteur groupe_nordik: 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, doc mission richelieu e152035) ; maintenance terminée, sync rejoué = 13 offres (médiane 13.0) ; note de contexte ajoutée au connecteur122- `856863d` 2026-08-25 Vague D implémentée — 75 nouveaux connecteurs (968 -> 1044 employeurs), ~768 offres QC123