# realstar — Realstar Management

site: https://www.realstar.ca/searchlisting?province=Quebec
méthode: firecrawl
annonces: 6 → 6
couverture après (sur 6 annonces): prix 100%, adresse 100%, dispo 83%, superficie 83%, commodités 83%
fixture: ok · test: ok

# Champs extraits

Carte liste : nom, adresse complète, ville (mapping slug), lits/sdb/pi² (fourchette), fourchette de prix, vignette, téléphone du bureau de location (lien tel: structuré → details.contact.phone).
Fiche propriété : galerie photos rentcafe, description (2 premiers paragraphes), « Points forts de la propriété » → amenities.
NOUVEAU — page /floorplans (RentCafe, structurée : #fp-container-*, .fp-availability, data-selenium-id) : par plan — nom (« 4 ½ D »), chambres, pi², prix mensuel, nombre d'unités disponibles. En dérive :
- availability réelle (« N unité(s) disponible(s) — plans… ») → availability_date="now" via finalize() ;
- price = minimum des plans disponibles (au lieu de la fourchette carte), price_label fidèle ;
- area_sqft + unit_type explicites quand un seul plan est disponible ; sinon superficies dans la description (finalize() en dérive le minimum).

pets en valeur structurée (le point fort « ANIMAUX DE COMPAGNIE » est ambigu — laissé au normaliseur générique, qui ne le mappe pas car pas de verbe accepté/refusé).
lat/lng (la carte Google est initialisée en JS, aucune coordonnée dans le HTML rendu).
Date précise de disponibilité par unité (derrière le portail sécurisé RentCafe).
Meublé, étage, JSON-LD (absents).

Tout passe par Firecrawl (Cloudflare + rendu client) : 1 rendu recherche + 2 rendus par propriété. Coût contrôlé par le cache self.detail(...) (clé = hash de la carte liste, incluant le prix) + plafond max_renders=20 (exception _BudgetReached, rien de mis en cache si plafond atteint).
Rendu parfois incomplet : seconde chance avec waitFor plus long sur la page recherche.
Sélecteurs RentCafe (fp-container, data-selenium-id) : stables mais propres au thème Yardi.
FIRECRAWL_API_KEY absent ne lève plus au niveau du connecteur (nécessaire au rejeu hors-ligne des fixtures) ; en direct, Firecrawl répond 401.

requests.post module → self.session.post dans _rendered (les fixtures capturent désormais les 13 réponses Firecrawl).
Pages détail (fiche + plans) déplacées derrière self.detail(...) (cache BD) : plus de re-rendu Firecrawl à chaque sync si la carte n'a pas changé.
Ajout du parsing structuré de /floorplans : disponibilité réelle (0 % → 83 %), superficie (0 % → 83 %), prix « à partir de » réels des unités disponibles.
Téléphone du bureau → details.contact.phone.
Fixture + tests enregistrés (13 requêtes, 6 annonces).
2026-08-08 — Expansion provinciale (lot 0) : gatineau, hull (secteur de Gatineau) et sherbrooke ajoutés à _GM_CITIES ; max_properties 8 → 12 (9 propriétés QC sur la page de recherche). +3 annonces : Heritage Lofts I&II (Gatineau, 1 550 $), Les Jardins Hauterive (Sherbrooke, 1 015 $ — propriété signalée dans reports/expansion/estrie.md) et Lumineau Appartements (Sherbrooke, 1 495 $). 6 → 9 annonces. Fixture réenregistrée (19 requêtes), 2 tests verts.

AVANT : Excelsior Apartments | 1645.0 | | dispo="" (date NULL) | area NULL | details sans contact
APRÈS : Excelsior Apartments | 1645.0 | dispo="5 unité(s) disponible(s) — 3 ½ G, 3 ½ A, 4 ½ D, 4 ½ O, 4 ½ T" → now | area 620 | contact.phone=514-447-6264
APRÈS : Bourg Du Village | 1750.0 | 4½ | "1 unité(s) disponible(s) — 4 ½ C" → now | area 918 pi² (plan unique disponible → type + superficie explicites)
« Marc Chagall » : 0 unité disponible aux plans → dispo laissée vide (fidèle), prix = fourchette de la carte.