SPB Git forge

spb/lou-ka

Public

Lou·Ka — tous les logements à louer du Québec, un seul endroit.

232commits 1branches 0releases
172.9 MBsize
maindefault branch
2 days agolast push
HTML 98.9% Python 0.6%
5.4 KB

# Hazelview Properties — connecteur hazelview

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 : actif · Région : Montréal · Backend : direct · Annonces actives : 3/57

# Description de la source

connecteur Hazelview Properties (hazelviewproperties.com — ex-Timbercreek). Le site est rendu côté client via l'API RentSync/LiftSystem (lift-api.rentsync.com/v2, client_id 497, jeton public embarqué dans le JS du site). On interroge /v2/cities pour les villes QC (toutes dans le Grand Montréal : Montréal, Verdun, Côte-Saint-Luc, Pointe-Claire, Longueuil...), puis /v2/search par ville et par nombre de chambres pour obtenir les types d'unités disponibles et leur loyer. Une annonce par immeuble et par type d'unité. La page immeuble du site (via cache BD) embarque un JSON complet (attribut data-locations de la carte) : commodités, galerie photos, animaux détaillés, suites. Expansion Ontario 2026-08 — gaté LOUKA_ONTARIO=1 : on inclut TOUTES les villes province_code=="ON" retournées par /v2/cities (Ottawa, GTA, Hamilton, London, KW… selon les disponibilités du moment), sans whitelist de villes — la whitelist Grand Montréal reste le garde-fou QC. Sans la variable d'environnement, comportement strictement identique (prod QC).

# Accès

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

Le connecteur (direct, API JSON interne du site) alimente les colonnes de la table listings. Complétude mesurée en SQL sur les 3 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 % 4545 Walkley — 3½
address Adresse civique 100 % 4545 Walkley Avenue, Montréal, H4B 2K8
city Ville (normalisée) 100 % Montréal
sector Secteur / quartier 0 % —
unit_type Type d'unité (3½, 4½…) 100 % 3½
price Loyer mensuel ($) 100 % 1 390 $
bedrooms Chambres 100 % 1
bathrooms Salles de bain 0 % —
area_sqft Superficie (pi²) 100 % 671
availability_date Date de disponibilité 100 % now
lat GPS (lat/lng) 100 % 45.46557
description Description 100 % Students, families, and young professionals all choose 4545 Walkley as their ideal apartm…
images Photos (JSON) 100 % 15 photo(s) — https://assets.rentsync.com/timbercreek_communities/images/gallery/full/177…
amenities Commodités (JSON) 100 % ["5 minute drive to the Côte St-Luc Shopping Centre", "Abundance of Natural Light", "Balc…
details Détails additionnels (JSON) 100 % {"appliances": {"fridge": true, "dishwasher": true}, "elevator": true, "balcony": true, "…
url URL de l'annonce source 100 % https://hazelviewproperties.com/properties/walkley

# Fréquence & budget

  • Cadence observée (médiane des passages OK, sync_log) : ≈ 3.4 h
  • Dernier passage OK : 2026-09-04 13:44 — 3 trouvées, +0 / ~0 / -0
  • Throttling : 0.6 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 : 57 au total, 3 actives
  • Première ingestion : 2026-08-06 · Dernière observation : 2026-09-04
  • Complétude clé (actives) : GPS 100 % · prix 100 % · photos 100 % · description 100 %
  • Runs journalisés (60 derniers) : 60, dont 0 en erreur

# Erreurs connues & dépannage

Aucune erreur dans les 60 derniers runs journalisés.

Rejouer la source seule : python3 run.py sync hazelview · vérifier ensuite sync_log (SELECT * FROM sync_log WHERE source='hazelview' 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 0.6 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-06 — 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).