# Q Residential — connecteur `qresidential`

_Fiche générée automatiquement par `scripts/gen_connector_docs.py` le 2026-09-04 14:12 — ne pas éditer à la main, régénérer._

**État : pause** · Région : Ontario — multi-régions · Backend : direct · Annonces actives : 25/25

## Description de la source

connecteur Q Residential (qresidential.ca) Gestionnaire ontarien (~7 000 unités — Toronto, St. Catharines, Hamilton, Oshawa/GTA, Brampton, Barrie). « Corporate site » Yardi RentCafe derrière un Cloudflare STRICT (curl direct = 403) : tout passe par Scrapfly ASP (self.get_scrapfly, asp=true, SANS render_js — le contenu est rendu serveur, vérifié sur la recherche et les fiches). Contrairement à killam.py (même famille RentCafe), il n'y a PAS de blob #available_prop : la page /searchlisting.aspx rend 25 cartes propriétés côté serveur (nom, adresse, ville, province, vignette, URL de fiche). La fiche propriété fournit un JSON-LD ApartmentComplex (description, adresse postale, GPS, commodités, téléphone) et un tableau « Floor Plans » (tbody.floorplan-details : nom, Bed/Bath, pi², loyer — souvent « Call for pricing » —, disponibilité). Une annonce PAR PLAN D'ÉTAGE quand au moins un plan affiche un prix ; sinon repli « une annonce par propriété » sans prix (rien d'inventé). Fiches visitées via le cache BD self.detail(), clé datée du jour : au plus UNE visite Scrapfly par propriété par jour, peu importe le nombre de synchronisations. Expansion Ontario — GATÉE par LOUKA_ONTARIO=1 : sans la variable, le connecteur est `disabled` et exclu du registre (zéro impact prod QC).

- **Site** : https://www.qresidential.ca
- **Page des annonces** : https://www.qresidential.ca/searchlisting.aspx
- **Secteurs couverts** : Toronto, St. Catharines, Hamilton, Niagara, Kitchener
- **Module** : `louka/connectors/qresidential.py` — classe `QResidentialConnector`

## Accès

- **Type d'accès** : pages HTML (rendu serveur)
- **Endpoint de base** : https://www.qresidential.ca
- **URLs de départ (constantes du module)** : https://www.qresidential.ca
- **Authentification** : aucune — contenu public
- **Pagination** : page de liste unique (pas de pagination)
- **Backend anti-bot / rendu** : requests direct
- **Politesse** : 1.5 s entre requêtes, timeout 30 s, User-Agent identifiable `LouKaBot/1.0 (+https://www.lou-ka.com/bot)`

## Champs récupérés → schéma cible

Le connecteur (direct, pages HTML (rendu serveur)) alimente les colonnes de la table `listings`. Complétude mesurée en SQL sur les 25 annonces actives ; exemple tiré d'une ligne réelle de la BD.

| Colonne `listings` | Contenu | Renseignée (actives) | Exemple réel |
|---|---|---|---|
| `title` | Titre de l'annonce | 100 % | Queenston Manor |
| `address` | Adresse civique | 100 % | 382 Queenston Street, St. Catharines, ON L2P 3V5 |
| `city` | Ville (normalisée) | 100 % | St. Catharines |
| `sector` | Secteur / quartier | 0 % | — |
| `unit_type` | Type d'unité (3½, 4½…) | 4 % | — |
| `price` | Loyer mensuel ($) | 0 % | — |
| `bedrooms` | Chambres | 8 % | — |
| `bathrooms` | Salles de bain | 0 % | — |
| `area_sqft` | Superficie (pi²) | 0 % | — |
| `availability_date` | Date de disponibilité | 0 % | — |
| `lat` | GPS (lat/lng) | 100 % | 43.158181 |
| `description` | Description | 56 % | Queenston Manor is a building that offers spacious one and two bedroom suites. The buildi… |
| `images` | Photos (JSON) | 100 % | 13 photo(s) — https://cdngeneralcf.rentcafe.com/dmslivecafe/2/143346/382QueenstonSt-Thumb… |
| `amenities` | Commodités (JSON) | 60 % | ["Recycling", "Fitness Center", "Library", "Secured Entry", "On-Site Maintenance", "On-Si… |
| `details` | Détails additionnels (JSON) | 64 % | {"inclusions": {"heating": true, "electricity": true, "cable": true}, "appliances": {"fri… |
| `url` | URL de l'annonce source | 100 % | https://www.qresidential.ca/apartments/on/st.-catharines/queenston-manor/default.aspx |

## Fréquence & budget

- **Cadence observée** (médiane des passages OK, sync_log) : ≈ 2.8 h
- **Dernier passage OK** : 2026-08-27 14:09 — 25 trouvées, +0 / ~0 / -0
- **Throttling** : 1.5 s entre requêtes (constante de classe `request_delay`)
- **Cache des pages détail (BD `detail_cache`)** : activé — évite de re-visiter les fiches inchangées

## Volumétrie & complétude

- **Annonces en BD** : 25 au total, **25 actives**
- **Première ingestion** : 2026-08-27 · **Dernière observation** : 2026-08-27
- **Complétude clé (actives)** : GPS 100 % · prix 0 % · photos 100 % · description 56 %
- **Runs journalisés (60 derniers)** : 5, dont 0 en erreur

## Erreurs connues & dépannage

Aucune erreur dans les 60 derniers runs journalisés.

**Note du registre** : pause

Rejouer la source seule : `python3 run.py sync qresidential` · vérifier ensuite `sync_log` (`SELECT * FROM sync_log WHERE source='qresidential' ORDER BY ts DESC LIMIT 5;`).

## Licence, attribution & conditions

- Scraping poli d'annonces **publiques** (données factuelles : prix, adresse, disponibilité) publiées par le gestionnaire sur son propre site.
- User-Agent **identifiable** avec page d'information et contact : `LouKaBot/1.0 (+https://www.lou-ka.com/bot; contact@spboucher.ai)` ; throttling 1.5 s ; cache détail pour minimiser les requêtes.
- Chaque annonce affichée sur Lou-Ka **pointe vers l'annonce d'origine** (colonne `url`) — la source garde le trafic de conversion.
- Retrait sur demande : contact@spboucher.ai.

## Historique

- 2026-08-27 — premières annonces de la source ingérées dans la BD.
- 2026-08-18 — vague d'enrichissement : standardisation de la documentation des connecteurs (fiche générée par `scripts/gen_connector_docs.py`).