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.1 KB

# Gestion Floria — connecteur floria

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 : Estrie · Backend : direct · Annonces actives : 19/22

# Description de la source

connecteur Gestion Floria (gestionfloria.ca) Condos locatifs neufs à Sherbrooke, Magog (Mont-Orford) et Coaticook. Site WordPress (Avada) : chaque page /immeuble// embarque le module de plans interactifs Livya (app.livya.com, client « gestion-floria », un projet/entité par immeuble). Même patron que somex_saintnicolas/louis14 : la page Next.js du module est rendue serveur et son flux RSC contient l'inventaire JSON complet (numéro, statut, loyer, pièces, superficie, adresse, ville, GPS, photos, plans). Découverte des immeubles via la page /secteurs/. Certains immeubles partagent le même projet Livya (jumelés 52/58 Flanc-Sud, 753/765 Rachel-Hébert…) : dédoublonnage par unitId. Seules les unités AVAILABLE deviennent des annonces ; certains projets ne publient pas le loyer (rentalPrice = 0) -> prix absent, rien d'inventé.

# Accès

  • Type d'accès : pages HTML (rendu serveur)
  • Endpoint de base : https://gestionfloria.ca
  • URLs de départ (constantes du module) : https://gestionfloria.ca · https://app.livya.com
  • Authentification : aucune — contenu public
  • Pagination : page de liste unique (pas de pagination)
  • Backend anti-bot / rendu : requests direct (session UA LouKaBot, throttling poli)
  • Politesse : 0.7 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 19 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 % 52 Rue du Flanc Sud — unité 8 (4½)
address Adresse civique 100 % 52 Rue du Flanc Sud, J1X 0J6
city Ville (normalisée) 100 % Magog
sector Secteur / quartier 0 % —
unit_type Type d'unité (3½, 4½…) 100 % 4½
price Loyer mensuel ($) 26 % 1 440 $
bedrooms Chambres 100 % 2
bathrooms Salles de bain 0 % —
area_sqft Superficie (pi²) 11 % —
availability_date Date de disponibilité 100 % now
lat GPS (lat/lng) 100 % 45.2952
description Description 100 % Étage 1 | Modèle B | 2 chambre(s) | 1 salle(s) de bain | Balcon de 65 pi²
images Photos (JSON) 95 % 1 photo(s) — https://d10eh8wo1l4y8c.cloudfront.net/projects/33aff699-5fff-443e-80d6-d12eb…
amenities Commodités (JSON) 0 % []
details Détails additionnels (JSON) 100 % {"balcony": true, "floor": 1}
url URL de l'annonce source 100 % https://gestionfloria.ca/immeuble/52-rue-flanc-sud/

# Fréquence & budget

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

# Erreurs connues & dépannage

Date Message (sync_log)
2026-08-28 12:48 500 Server Error: Internal Server Error for url: https://gestionfloria.ca/secteurs/

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