1<!--2=============================================================================3Job·Ka — Groupe KA4Auteur : Simon-Pierre Boucher5Contact : contact@spboucher.ai6Fichier : docs/connecteurs/cusm_ir.md7Rôle : Fiche connecteur — Institut de recherche du CUSM (employeur direct, ATS njoyn)8Généré : 2026-10-30 10:17 EDT par scripts/gen_connector_docs.py — NE PAS ÉDITER,9 relancer le script pour régénérer.10=============================================================================11-->1213# Institut de recherche du CUSM (`cusm_ir`)1415**Employeur direct** · Plateforme ATS : [`njoyn`](ats-njoyn.md) · Statut registre : actif · Connecteur : `jobka/connectors/cusm_ir.py`1617## Description1819- **Site** : [Institut de recherche du CUSM](https://rimuhc.ca)20- **Page carrières** : https://cusm.njoyn.com/CL3/xweb/xweb.asp?clid=55242&page=joblisting&lang=221- **Secteurs** : n/d22- **Région** : Québec (province)23- 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-njoyn.md`](ats-njoyn.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| `BASE` | `https://cusm.njoyn.com` |33| `CL` | `CL3` |34| `CLID` | `55242` |35| `EMPLOYER` | `Institut de recherche du CUSM` |36| `LANG` | `2` |37| `USE_SCRAPFLY` | `True` |38- **Throttle** : 1.2 s entre requêtes.39- **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).4041## Champs → schéma4243Complétude mesurée sur les **27 offres actives** de la source (base live, 2026-10-30 10:17 EDT).4445| Champ (`jobs.*`) | Rôle | Complétude |46|---|---|---|47| `title` — Titre | titre du poste | 100 % |48| `employer` — Employeur | nom de l'entreprise | 100 % |49| `url` — URL | lien direct vers l'offre originale | 100 % |50| `description` — Description | texte complet (HTML nettoyé) | 96 % |51| `city` — Ville | municipalité normalisée | 0 % |52| `region` — Région | région administrative | 0 % |53| `address` — Adresse | adresse du lieu de travail | 0 % |54| `postal_code` — Code postal | code postal si publié | 0 % |55| `work_mode` — Mode | presentiel / hybride / teletravail | 0 % |56| `employment_type` — Type | temps_plein / temps_partiel / … | 11 % |57| `salary` — Salaire ($) | bornes numériques normalisées $/h et $/an | 96 % |58| `salary_label` — Libellé salaire | texte salarial original | 100 % |59| `benefits` — Avantages | avantages sociaux publiés (JSON) | 0 % |60| `requirements` — Exigences | scolarité, expérience, langues (JSON) | 100 % |61| `date_posted` — Date de parution | ISO 8601 | 63 % |62| `date_deadline` — Date limite | date limite pour postuler | 0 % |63| `category` — Catégorie | taxonomie interne (TI, Santé, …) | 96 % |64| `language` — Langue | fr / en / bilingue (source ou heuristique) | 96 % |65| `company_logo` — Logo employeur | URL du logo si exposé par la source | 0 % |66| `apply_url` — Candidature | lien de candidature directe | 0 % |67| `gps` — GPS | lat/lng (géocodage sans invention) | 0 % |6869Exemple réel : *Adjoint.e de direction* — ∅ · 50960 $ - 94658.2 $ /année · parue le 2026-10-29.7071## Fréquence & budgets7273- **Cadence** : resynchronisation **horaire** (PM2 `job-ka-sync` = `run.py watch 60`), suivie du géocodage en lot puis de la déduplication inter-sources.74- **Throttle** : 1.2 s minimum entre deux requêtes vers la source (`request_delay`).75- **Budgets / plafonds (variables d'environnement)** :7677| Variable | Défaut |78|---|---|79| `JOBKA_NJOYN_DETAIL_LIMIT` | `40` |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.8182## Volumétrie & complétude live8384*(mesuré le 2026-10-30 10:17 EDT dans `data/jobka.db`)*8586- **Offres en base** : 103 (dont **27 actives**, 0 masquées comme doublons `dup_of`)87- **Salaire** : 26/27 actives (96 %)88- **GPS** : 0/27 actives (0 %)89- **Mode** : 0/27 actives (0 %)90- **Parution** : 17/27 actives (63 %)91- **Dernier sync** : 2026-10-30 10:16 — trouvées 27, +0, ~0, -092- **Syncs enregistrés** (`sync_log`) : 6809394## Erreurs & dépannage9596Erreurs relevées dans `sync_log` :9798| Erreur | Occurrences | Dernière fois |99|---|---|---|100| njoyn cusm_ir: page liste illisible après 3 essais (vide ou anti-bot, 0 octets) — sync avo… | 5 | 2026-10-30 06:00 |101| njoyn cusm_ir: plateforme Njoyn en maintenance planifiée (redirection maintenance.njoyn.co… | 7 | 2026-10-24 06:32 |102| njoyn cusm_ir: page liste illisible (vide ou anti-bot, 29125 octets) — sync avorté | 2 | 2026-09-06 02:01 |103| njoyn cusm_ir: page liste illisible (vide ou anti-bot, 0 octets) — sync avorté — cause ide… | 1 | 2026-09-04 03:09 |104| njoyn cusm_ir: page liste illisible (vide ou anti-bot, 0 octets) — sync avorté | 13 | 2026-09-04 00:41 |105106- Rejouer un sync isolé : `.venv/bin/python run.py sync cusm_ir` puis inspecter `sync_log` : `sqlite3 data/jobka.db "SELECT * FROM sync_log WHERE source='cusm_ir' ORDER BY ts DESC LIMIT 5;"`107- 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`.108109## Licence / conformité110111**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 Institut de recherche du CUSM » 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.112113Certains domaines de cette plateforme sont servis derrière un gestionnaire anti-bot : la lecture passe alors par Scrapfly, toujours sur des pages strictement publiques, au même rythme throttlé.114115## Historique116117**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 :118- `fd4bfc8` qualité lieux : rejet des villes hors Québec, bâtiments McGill → Montréal ;119- `5a66f48` +59 employeurs (sondage massif d'ATS + détection de pages carrières) ;120- `4917d57` 8 nouveaux ATS (Taleo, Njoyn, UltiPro, iCIMS, SuccessFactors, ADP WFN, Digital Recruiters, Workland) + 23 employeurs publics/parapublics ;121- `f6e7571` portails Guichet-Emplois, Jobillico, Espresso-Jobs — l'offre directe gagne toujours la canonique (dédup) ;122- `744cbfc` badge « Offre directe », stats directes/portails, dépôt direct employeurs ;123- `1604ff9` reprise sur coupure WAF Guichet-Emplois (retry + acquis partiel).124125Commits touchant `jobka/connectors/cusm_ir.py` :126127- `092a29c5` 2026-10-24 Revert "[ka6] connecteur cusm_ir: stale = faux positif, maintenance planifiée Njoyn en cours — rien à réparer. Même fenêtre systémique que cgi (ecb31c08, récidive du 2026-09-05→07, vendredi soir → dimanche ~21h EDT) : cusm_ir vert found=24 (médiane 24.0) jusqu'à 18:09 EDT le 2026-10-23, puis « maintenance planifiée (redirection maintenance.njoyn.com) » à 20:36 et 22:59, comme les 11 tenants Njoyn de l'app. Vérification live 23:32 EDT : cusm.njoyn.com (racine et joblisting CL3/clid=55242) 302 → maintenance.njoyn.com/.../platform-maintenance.html (page officielle). Le garde-fou _MAINT_RE fonctionne comme prévu : sync avorté proprement, 24 offres actives conservées en base (0 retrait). Sync isolé rejoué : abort explicite en 3,0 s avec le message maintenance. Le tenant reverdira seul à sa rotation horaire au retour du service (~dimanche 21h). Aucun code de fetch modifié, docstring chronologie seulement ; fiches cusm_ir.md/ats-njoyn.md/INDEX.md régénérées (1131 autres fiches restaurées, hors périmètre). 108 tests verts, pm2 restart job-ka-sync OK, site local 200, www.job-ka.com 200."128- `d6a7c87f` 2026-10-23 [ka6] connecteur cusm_ir: stale = faux positif, maintenance planifiée Njoyn en cours — rien à réparer. Même fenêtre systémique que cgi (ecb31c08, récidive du 2026-09-05→07, vendredi soir → dimanche ~21h EDT) : cusm_ir vert found=24 (médiane 24.0) jusqu'à 18:09 EDT le 2026-10-23, puis « maintenance planifiée (redirection maintenance.njoyn.com) » à 20:36 et 22:59, comme les 11 tenants Njoyn de l'app. Vérification live 23:32 EDT : cusm.njoyn.com (racine et joblisting CL3/clid=55242) 302 → maintenance.njoyn.com/.../platform-maintenance.html (page officielle). Le garde-fou _MAINT_RE fonctionne comme prévu : sync avorté proprement, 24 offres actives conservées en base (0 retrait). Sync isolé rejoué : abort explicite en 3,0 s avec le message maintenance. Le tenant reverdira seul à sa rotation horaire au retour du service (~dimanche 21h). Aucun code de fetch modifié, docstring chronologie seulement ; fiches cusm_ir.md/ats-njoyn.md/INDEX.md régénérées (1131 autres fiches restaurées, hors périmètre). 108 tests verts, pm2 restart job-ka-sync OK, site local 200, www.job-ka.com 200.129- `df3faf02` 2026-08-25 Vague E — 3 nouvelles familles ATS (JazzHR, Teamtailor, Zoho Recruit) + 60 connecteurs, ~547 offres QC130