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
3 days agolast push
HTML 98.9% Python 0.6%
4.7 KB

# Place du Barrage — connecteur place_barrage

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 : 10/10

# Description de la source

connecteur Place du Barrage (placedubarrage.com) Immeuble locatif au 2, rue Vertu à Windsor (Estrie), géré par Sphère immobilier. Site Wix rendu serveur : la page /appartements liste 24 cartes (répéteur Wix « wixui-repeater__item ») — « Appartement 101-A », courte description, prix (« 1475$ ») ou « LOUÉ », lien vers la fiche /appartements/appartement--. ⚠️ Le du gabarit Wix mentionne un autre projet (Le Connaught) : ignorer. On dérive l'URL de la fiche du numéro affiché sur la carte (les hrefs peuvent être désalignés). Granularité : unité ; prix affichés, typologies non publiées.</p> <ul> <li><strong>Site</strong> : <a href="https://www.placedubarrage.com">https://www.placedubarrage.com</a></li> <li><strong>Page des annonces</strong> : <a href="https://www.placedubarrage.com/appartements">https://www.placedubarrage.com/appartements</a></li> <li><strong>Secteurs couverts</strong> : Windsor (2 rue Vertu)</li> <li><strong>Module</strong> : <code>louka/connectors/place_barrage.py</code> — classe <code>PlaceBarrageConnector</code></li> </ul> <h2 id="accès" tabindex="-1"><a class="heading-anchor" href="#accès" aria-hidden="true"><span class="anchor-icon" aria-hidden="true">#</span></a> Accès</h2> <ul> <li><strong>Type d'accès</strong> : pages HTML (rendu serveur)</li> <li><strong>Endpoint de base</strong> : <a href="https://www.placedubarrage.com">https://www.placedubarrage.com</a></li> <li><strong>URLs de départ (constantes du module)</strong> : <a href="https://www.placedubarrage.com">https://www.placedubarrage.com</a></li> <li><strong>Authentification</strong> : aucune — contenu public</li> <li><strong>Pagination</strong> : page de liste unique (pas de pagination)</li> <li><strong>Backend anti-bot / rendu</strong> : requests direct (session UA LouKaBot, throttling poli)</li> <li><strong>Politesse</strong> : 0.6 s entre requêtes, timeout 30 s, User-Agent identifiable <code>LouKaBot/1.0 (+https://www.lou-ka.com/bot)</code></li> </ul> <h2 id="champs-récupérés--schéma-cible" tabindex="-1"><a class="heading-anchor" href="#champs-récupérés--schéma-cible" aria-hidden="true"><span class="anchor-icon" aria-hidden="true">#</span></a> Champs récupérés → schéma cible</h2> <p>Le connecteur (direct, pages HTML (rendu serveur)) alimente les colonnes de la table <code>listings</code>. Complétude mesurée en SQL sur les 10 annonces actives ; exemple tiré d'une ligne réelle de la BD.</p> <table> <thead> <tr> <th>Colonne <code>listings</code></th> <th>Contenu</th> <th>Renseignée (actives)</th> <th>Exemple réel</th> </tr> </thead> <tbody> <tr> <td><code>title</code></td> <td>Titre de l'annonce</td> <td>100 %</td> <td>Appartement 101-A — Place du Barrage</td> </tr> <tr> <td><code>address</code></td> <td>Adresse civique</td> <td>100 %</td> <td>2, rue Vertu, Windsor</td> </tr> <tr> <td><code>city</code></td> <td>Ville (normalisée)</td> <td>100 %</td> <td>Windsor</td> </tr> <tr> <td><code>sector</code></td> <td>Secteur / quartier</td> <td>0 %</td> <td>—</td> </tr> <tr> <td><code>unit_type</code></td> <td>Type d'unité (3½, 4½…)</td> <td>0 %</td> <td>—</td> </tr> <tr> <td><code>price</code></td> <td>Loyer mensuel ($)</td> <td>100 %</td> <td>1 475 $</td> </tr> <tr> <td><code>bedrooms</code></td> <td>Chambres</td> <td>0 %</td> <td>—</td> </tr> <tr> <td><code>bathrooms</code></td> <td>Salles de bain</td> <td>0 %</td> <td>—</td> </tr> <tr> <td><code>area_sqft</code></td> <td>Superficie (pi²)</td> <td>0 %</td> <td>—</td> </tr> <tr> <td><code>availability_date</code></td> <td>Date de disponibilité</td> <td>100 %</td> <td>now</td> </tr> <tr> <td><code>lat</code></td> <td>GPS (lat/lng)</td> <td>100 %</td> <td>45.560455699</td> </tr> <tr> <td><code>description</code></td> <td>Description</td> <td>100 %</td> <td>Appartement situé au premier étage de l'immeuble.</td> </tr> <tr> <td><code>images</code></td> <td>Photos (JSON)</td> <td>100 %</td> <td>2 photo(s) — <a href="https://static.wixstatic.com/media/9efd1e_f6b3d8ed14d34cee98b8e2d12103a06d~m%E2%80%A6">https://static.wixstatic.com/media/9efd1e_f6b3d8ed14d34cee98b8e2d12103a06d~m…</a></td> </tr> <tr> <td><code>amenities</code></td> <td>Commodités (JSON)</td> <td>0 %</td> <td>[]</td> </tr> <tr> <td><code>details</code></td> <td>Détails additionnels (JSON)</td> <td>100 %</td> <td>{"floor": "Étage 1"}</td> </tr> <tr> <td><code>url</code></td> <td>URL de l'annonce source</td> <td>100 %</td> <td><a href="https://www.placedubarrage.com/appartements/appartement-101-a">https://www.placedubarrage.com/appartements/appartement-101-a</a></td> </tr> </tbody> </table> <h2 id="fréquence--budget" tabindex="-1"><a class="heading-anchor" href="#fréquence--budget" aria-hidden="true"><span class="anchor-icon" aria-hidden="true">#</span></a> Fréquence & budget</h2> <ul> <li><strong>Cadence observée</strong> (médiane des passages OK, sync_log) : ≈ 3.4 h</li> <li><strong>Dernier passage OK</strong> : 2026-09-04 08:18 — 10 trouvées, +0 / ~0 / -0</li> <li><strong>Throttling</strong> : 0.6 s entre requêtes (constante de classe <code>request_delay</code>)</li> <li><strong>Cache des pages détail (BD <code>detail_cache</code>)</strong> : activé — évite de re-visiter les fiches inchangées</li> </ul> <h2 id="volumétrie--complétude" tabindex="-1"><a class="heading-anchor" href="#volumétrie--complétude" aria-hidden="true"><span class="anchor-icon" aria-hidden="true">#</span></a> Volumétrie & complétude</h2> <ul> <li><strong>Annonces en BD</strong> : 10 au total, <strong>10 actives</strong></li> <li><strong>Première ingestion</strong> : 2026-08-25 · <strong>Dernière observation</strong> : 2026-09-04</li> <li><strong>Complétude clé (actives)</strong> : GPS 100 % · prix 100 % · photos 100 % · description 100 %</li> <li><strong>Runs journalisés (60 derniers)</strong> : 46, dont 0 en erreur</li> </ul> <h2 id="erreurs-connues--dépannage" tabindex="-1"><a class="heading-anchor" href="#erreurs-connues--dépannage" aria-hidden="true"><span class="anchor-icon" aria-hidden="true">#</span></a> Erreurs connues & dépannage</h2> <p>Aucune erreur dans les 60 derniers runs journalisés.</p> <p>Rejouer la source seule : <code>python3 run.py sync place_barrage</code> · vérifier ensuite <code>sync_log</code> (<code>SELECT * FROM sync_log WHERE source='place_barrage' ORDER BY ts DESC LIMIT 5;</code>).</p> <h2 id="licence-attribution--conditions" tabindex="-1"><a class="heading-anchor" href="#licence-attribution--conditions" aria-hidden="true"><span class="anchor-icon" aria-hidden="true">#</span></a> Licence, attribution & conditions</h2> <ul> <li>Scraping poli d'annonces <strong>publiques</strong> (données factuelles : prix, adresse, disponibilité) publiées par le gestionnaire sur son propre site.</li> <li>User-Agent <strong>identifiable</strong> avec page d'information et contact : <code>LouKaBot/1.0 (+https://www.lou-ka.com/bot; contact@spboucher.ai)</code> ; throttling 0.6 s ; cache détail pour minimiser les requêtes.</li> <li>Chaque annonce affichée sur Lou-Ka <strong>pointe vers l'annonce d'origine</strong> (colonne <code>url</code>) — la source garde le trafic de conversion.</li> <li>Retrait sur demande : <a href="mailto:contact@spboucher.ai">contact@spboucher.ai</a>.</li> </ul> <h2 id="historique" tabindex="-1"><a class="heading-anchor" href="#historique" aria-hidden="true"><span class="anchor-icon" aria-hidden="true">#</span></a> Historique</h2> <ul> <li>2026-08-25 — premières annonces de la source ingérées dans la BD.</li> <li>2026-08-18 — vague d'enrichissement : standardisation de la documentation des connecteurs (fiche générée par <code>scripts/gen_connector_docs.py</code>).</li> </ul>