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%
10.4 KB · 160 lines html
Raw Blame History
1<!DOCTYPE html>2<!-- GABARIT COMMUN — page /doc des sites du Groupe KA (2026-08-24).3     À adapter par site : remplacer lou-ka (id, ex. lou-ka), Lou·Ka (ex. Lou·Ka),4     Tous les logements à louer du Québec, agrégés au même endroit — un index fidèle, sans prix inventé ni coordonnée devinée., #ff6a00 (couleur accent du site, ex. #b7f000), les sections5     et les étapes (captures dans ./img/). Page auto-suffisante (aucun JS requis). -->6<html lang="fr">7<head>8<meta charset="utf-8">9<meta name="viewport" content="width=device-width, initial-scale=1, viewport-fit=cover">10<title>Documentation — Lou·Ka</title>11<meta name="description" content="Comment fonctionne Lou·Ka : guide pas à pas, données, architecture.">12<style>13  :root{ --ink:#101014; --paper:#faf9f6; --accent:#ff6a00; --muted:#6b6b70; --line:#e6e4de; }14  *{box-sizing:border-box} html,body{margin:0;padding:0;background:var(--paper);color:var(--ink);15    font:16px/1.65 -apple-system,BlinkMacSystemFont,"Segoe UI",Roboto,sans-serif;-webkit-text-size-adjust:100%}16  .container{max-width:960px;margin:0 auto;padding:0 20px}17  header.doc{background:var(--ink);color:var(--paper);padding:20px 0}18  header.doc .container{display:flex;align-items:center;justify-content:space-between;gap:12px;flex-wrap:wrap}19  header.doc a{color:var(--paper);text-decoration:none}20  .wordmark{font-weight:800;font-size:20px;letter-spacing:.02em}21  .wordmark .ka{color:var(--accent)}22  .btn-pdf{display:inline-block;background:var(--accent);color:var(--ink);font-weight:700;23    padding:10px 18px;border-radius:999px;text-decoration:none;font-size:15px}24  .hero{padding:48px 0 8px}25  .hero h1{font-size:clamp(28px,5vw,44px);line-height:1.1;margin:0 0 12px}26  .hero h1 mark{background:var(--accent);color:var(--ink);padding:2px 8px}27  .hero p.lead{font-size:18px;color:var(--muted);max-width:640px}28  .kicker{font-size:12px;letter-spacing:.14em;text-transform:uppercase;color:var(--muted);29    border-left:3px solid var(--accent);padding-left:10px;margin:40px 0 8px;font-weight:700}30  section{padding:8px 0 16px}31  h2{font-size:26px;margin:6px 0 12px}32  .step{display:grid;grid-template-columns:56px 1fr;gap:16px;margin:26px 0;align-items:start}33  .step .num{width:44px;height:44px;border-radius:50%;background:var(--ink);color:var(--accent);34    display:flex;align-items:center;justify-content:center;font-weight:800;font-size:18px}35  .step h3{margin:6px 0 6px;font-size:19px}36  .step p{margin:0 0 12px;color:#3a3a40}37  .shot{border:1px solid var(--line);border-radius:12px;overflow:hidden;box-shadow:0 8px 30px rgba(16,16,20,.08)}38  .shot img{display:block;width:100%;height:auto}39  .cards{display:grid;grid-template-columns:repeat(auto-fit,minmax(240px,1fr));gap:14px;margin:16px 0}40  .card{border:1px solid var(--line);border-radius:12px;padding:16px;background:#fff}41  .card b{display:block;margin-bottom:6px}42  table{border-collapse:collapse;width:100%;font-size:15px}43  th,td{border:1px solid var(--line);padding:8px 10px;text-align:left;vertical-align:top}44  th{background:var(--ink);color:var(--paper)}45  footer.doc{margin-top:56px;background:var(--ink);color:var(--paper);padding:28px 0;font-size:14px}46  footer.doc a{color:var(--accent);text-decoration:none}47  @media print{48    header.doc .btn-pdf{display:none}49    .shot{box-shadow:none;break-inside:avoid}50    .step{break-inside:avoid}51    a{color:inherit;text-decoration:none}52  }53  @media(max-width:640px){ .step{grid-template-columns:40px 1fr} .step .num{width:34px;height:34px;font-size:15px} }54</style>55</head>56<body>57<header class="doc">58  <div class="container">59    <a class="wordmark" href="/">Lou<span class="ka">·Ka</span></a>60    <nav style="display:flex;gap:14px;align-items:center">61      <a href="/">← Retour au site</a>62      <a class="btn-pdf" href="./lou-ka-documentation.pdf" download>Télécharger le PDF</a>63    </nav>64  </div>65</header>6667<div class="container">68  <div class="hero">69    <p class="kicker">Documentation · mise à jour 2026-08-24</p>70    <h1>Comment fonctionne <mark>Lou·Ka</mark></h1>71    <p class="lead">Tous les logements à louer du Québec, agrégés au même endroit — un index fidèle, sans prix inventé ni coordonnée devinée.</p>72  </div>7374  <section>75    <p class="kicker">Vue d'ensemble</p>76    <h2>À quoi sert le site</h2>77    <p>Chercher un appartement au Québec, c'est ouvrir des dizaines de sites différents. <b>Lou·Ka</b>78    (<a href="https://www.lou-ka.com">www.lou-ka.com</a>) retourne le problème : un <b>connecteur dédié par gestionnaire immobilier</b>79    visite chaque site, normalise chaque annonce vers un schéma unique et détecte les changements en continu — ajouts, mises à jour80    et retraits automatiques. Chaque fiche renvoie vers l'annonce originale du gestionnaire via la passerelle de sortie81    <code>/passerelle/{uid}</code>. Pour les locataires (recherche filtrée, carte 3D, fiches complètes), les curieux du marché82    (observatoire des loyers, rapports PDF) et les gestionnaires (pages réclamables).</p>83    <div class="cards">84      <div class="card"><b>22 900+ annonces actives</b>Dans 820 villes et 11 régions du Québec, ~70 % géolocalisées.</div>85      <div class="card"><b>212 connecteurs</b>265 sources recensées ; chaque gestionnaire a son connecteur dédié, resynchronisé en continu.</div>86      <div class="card"><b>Rien d'inventé</b>Aucun prix inventé ni coordonnée devinée ; une annonce disparue répond 410 Gone.</div>87      <div class="card"><b>Fiches enrichies</b>Registre des loyers, inondation, criminalité, air, essence, transport, Hydro-Québec, KA Scores.</div>88    </div>89  </section>9091  <section>92    <p class="kicker">Guide pas à pas</p>93    <h2>Utiliser le site en 4 étapes</h2>94    <div class="step">95      <div class="num">1</div>96      <div>97        <h3>Cherchez depuis l'accueil</h3>98        <p>Entrez une ville ou un quartier, choisissez le type (3½, 4½…), le loyer min/max et vos options (animaux, meublé, superficie). La liste et la carte 3D restent synchronisées : les compteurs correspondent exactement aux marqueurs.</p>99        <div class="shot"><img src="./img/etape1.png" alt="Étape 1 — Cherchez depuis l'accueil"></div>100      </div>101    </div>102    <div class="step">103      <div class="num">2</div>104      <div>105        <h3>Parcourez les résultats d'une ville</h3>106        <p>Les pages villes (ex. /ville/montreal) listent toutes les annonces actives avec leurs filtres. Sur la carte Lou-Ka Maps : clusters par prix moyen, « Rechercher dans cette zone », bascule 3D/2D.</p>107        <div class="shot"><img src="./img/etape2.png" alt="Étape 2 — Parcourez les résultats d'une ville"></div>108      </div>109    </div>110    <div class="step">111      <div class="num">3</div>112      <div>113        <h3>Ouvrez la fiche d'un logement</h3>114        <p>Toutes les photos, un digest structuré de la description, le badge marché (position du loyer vs le secteur, registre des loyers), l'historique de prix, les couches de quartier (criminalité, air, transport, KA Scores…) et une fiche PDF avec QR code. Le bouton vers l'annonce originale passe par la passerelle transparente.</p>115        <div class="shot"><img src="./img/etape3.png" alt="Étape 3 — Ouvrez la fiche d'un logement"></div>116      </div>117    </div>118    <div class="step">119      <div class="num">4</div>120      <div>121        <h3>Suivez le marché sur /stats</h3>122        <p>L'observatoire du marché : KPI temps réel, loyers médians par région, ville et taille, et rapport de marché PDF multi-pages téléchargeable.</p>123        <div class="shot"><img src="./img/etape4.png" alt="Étape 4 — Suivez le marché sur /stats"></div>124      </div>125    </div>126  </section>127128  <section>129    <p class="kicker">Sous le capot</p>130    <h2>D'où viennent les données</h2>131    <p>Pipeline : <b>connecteurs → normalisation → déduplication → SQLite → API/frontend</b>. 212 connecteurs auto-découverts132    visitent chaque gestionnaire à la source (extraction directe, Firecrawl ou Scrapfly selon le site), et une boucle de133    resynchronisation (<code>lou-ka-sync</code>) tourne en continu : le hash de contenu de chaque annonce détecte ajouts, mises à jour134    et retraits — une annonce disparue répond <code>410 Gone</code>. Un garde-fou anti-dérive suspend les retraits si une source135    retourne soudainement beaucoup moins d'annonces. L'enrichissement croise géocodage (Nominatim + Adresses Québec),136    recensement 2021, registre des loyers, données d'inondation (BDZI), criminalité (SPVM), qualité de l'air, prix de l'essence,137    commerces et transport en commun. Le registre public <a href="/sources">/sources</a> montre chaque source, son statut et sa dernière synchro.</p>138  </section>139140  <section>141    <p class="kicker">Questions fréquentes</p>142    <h2>FAQ</h2>143    <div class="card" style="margin:10px 0"><b>Les prix sont-ils fiables ?</b><p style="margin:6px 0 0">Les loyers affichés sont ceux publiés par les gestionnaires eux-mêmes, captés à la source. Lou·Ka n'invente aucun prix et ne devine aucune coordonnée.</p></div>144    <div class="card" style="margin:10px 0"><b>Puis-je louer directement sur Lou·Ka ?</b><p style="margin:6px 0 0">Non. Lou·Ka est un index : chaque fiche renvoie vers l'annonce originale du gestionnaire via la passerelle de sortie. Groupe KA n'est partie à aucune transaction.</p></div>145    <div class="card" style="margin:10px 0"><b>À quelle fréquence les annonces sont-elles mises à jour ?</b><p style="margin:6px 0 0">La resynchronisation tourne en boucle continue ; les annonces retirées chez le gestionnaire disparaissent automatiquement (410 Gone).</p></div>146    <div class="card" style="margin:10px 0"><b>D'où viennent les données de quartier ?</b><p style="margin:6px 0 0">De sources publiques : recensement 2021, registre des loyers, BDZI (inondation), SPVM (criminalité), RSQAQ (air), Régie de l'énergie (essence), OSM (commerces, transport), plus une estimation Hydro-Québec.</p></div>147    <div class="card" style="margin:10px 0"><b>Je suis gestionnaire, puis-je gérer ma page ?</b><p style="margin:6px 0 0">Oui : chaque source a une page réclamable (/g/{source}) ; connectez-vous avec votre KA ID pour la réclamer.</p></div>148  </section>149</div>150151<footer class="doc">152  <div class="container">153    <p><b>Lou·Ka</b> — un service <a href="https://www.groupe-ka.com">Groupe KA</a>.154    Écosystème : les 13 plateformes sont liées au pied de chaque site.</p>155    <p>© 2026 Groupe KA — Simon-Pierre Boucher · <a href="mailto:contact@spboucher.ai">contact@spboucher.ai</a></p>156  </div>157</footer>158</body>159</html>160