<!--
=============================================================================
Job·Ka — Groupe KA
Auteur  : Simon-Pierre Boucher
Contact : contact@spboucher.ai
Fichier : docs/connecteurs/usamechasp.md
Rôle    : Fiche connecteur — USA Mechanical & Energy Services (employeur direct, ATS greenhouse)
Généré  : 2026-09-21 18:06 EDT par scripts/gen_connector_docs.py — NE PAS ÉDITER,
          relancer le script pour régénérer.
=============================================================================
-->

# USA Mechanical & Energy Services (`usamechasp`)

**Employeur direct** · Plateforme ATS : [`greenhouse`](ats-greenhouse.md) · Statut registre : actif · Connecteur : `jobka/connectors/usamechasp.py`

## Description

- **Site** : [USA Mechanical & Energy Services]()
- **Page carrières** : https://job-boards.greenhouse.io/usamechasp
- **Secteurs** : Énergie, Services
- **Région** : East Granby, East Granby CT
- Offres marquées **« Offre directe »** dans l'app (badge) : la candidature se fait chez l'employeur, jamais via un intermédiaire.

## Accès

- **Mécanique** : voir la fiche plateforme [`ats-greenhouse.md`](ats-greenhouse.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 |
|---|---|
| `BOARD` | `usamechasp` |
| `EMPLOYER` | `USA Mechanical & Energy Services` |
- **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

*Aucune offre active en base pour cette source.*

## 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`).
- 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** : 3 (dont **0 actives**, 0 masquées comme doublons `dup_of`)
- **Salaire** : 0/0 actives (—)
- **GPS** : 0/0 actives (—)
- **Mode** : 0/0 actives (—)
- **Parution** : 0/0 actives (—)
- **Dernier sync** : 2026-09-21 17:39 — trouvées 0, +0, ~0, -0
- **Syncs enregistrés** (`sync_log`) : 220

## Erreurs & dépannage

Aucune erreur dans `sync_log` pour cette source.

- Rejouer un sync isolé : `.venv/bin/python run.py sync usamechasp` puis inspecter `sync_log` : `sqlite3 data/jobka.db "SELECT * FROM sync_log WHERE source='usamechasp' 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 USA Mechanical & Energy Services » 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/usamechasp.py` :

- `b387be9` 2026-08-27 [ka6] fix connecteur usamechasp: employeur USA Mechanical & Energy Services américain — entreprise CVC/mécanique du Connecticut (siège East Granby, CT). Les 3 offres captées (Commercial HVAC Technician, Human Resources Assistant, HVAC Commercial Mechanical Engineer) étaient localisées « East Granby, CT » / « East Granby CT » : faux positif du filtre Québec parce que « Granby » (ville d'Estrie, dans _QC_CITIES) matchait à l'intérieur de « East Granby » — même famille que coorstek b7ebb74 / echodynecorp 5bf3718 / edelmanfinancialenginesllc 6f6298c / epwealth e34defd / insomniacookies 9f92204 / blockslearning 3bf461d / bluetoothsiginc 7d5cd82 / kestramedicaltechnologiesinc f41a81a / lakewashingtondermatology 411e4a1 / lifestance 25262c1 / nadel 80e2f6f / onemedical a57eee6 / phynetdermatology 9a9de3d / residential11 46f36ee / sweeneyconrad 91b5a0e / synterra 68745a5 / seymourpacificdevelopmentsltd e27e36a / tealcommunicationsinc 24812b3. Depuis le fix is_quebec_location f4038e4, ces offres sont correctement rejetées (volume 0), y compris la variante « East Granby CT » sans virgule. Purge par le mécanisme normal du pipeline: sync isolé rejoué le 2026-08-27 → miss_count=2 → active=0 (found=0, removed=3, statut ok); médiane 3.0 < DRIFT_MIN_BASE=8 donc garde anti-dérive non déclenchée. Vérifié à la source: 23 postings Greenhouse, TOUS au Connecticut (East Granby, Hartford, Middletown, Enfield, New London, Waterbury, New Haven, Meriden, Avon, West Hartford, Glastonbury), zéro au Québec. Filtre vérifié sur les 23 libellés: is_quebec_location = False partout. Volume 0 = comportement correct. Note de contexte ajoutée au connecteur.
- `c45c753` 2026-08-23 Vague C — +620 connecteurs employeurs directs (350 -> 968)