// -----------------------------------------------------------------------------
// Lou-Ka — Agrégateur de logements à louer (province de Québec)
// Auteur : Simon-Pierre Boucher — contact@spboucher.ai
// pages/JusteValeur.tsx : « Comment est calculée la juste valeur ? »
//   Page de transparence sur le framework d'estimation (louka/fairvalue.py).
// -----------------------------------------------------------------------------
import { Link } from "react-router-dom";
import FairValueBadge from "../components/FairValueBadge";

export default function JusteValeurPage() {
  return (
    <div className="container legal">
      <span className="kicker">Analyse de prix Lou-Ka</span>
      <h1>Comment est calculée la juste valeur ?</h1>

      <section>
        <p>
          Sur chaque annonce, Lou-Ka affiche une <b>juste valeur estimée</b> du
          loyer et une pastille qui situe le prix demandé par rapport au
          marché :
        </p>
        <p className="fv-demo">
          <FairValueBadge verdict="sous" deviation={-0.12} />{" "}
          <FairValueBadge verdict="marche" deviation={0.02} />{" "}
          <FairValueBadge verdict="sur" deviation={0.15} />
        </p>
      </section>

      <section>
        <h3>La méthode, simplement</h3>
        <ul>
          <li>
            <b>1. Le marché comme référence.</b> Nous partons de l'ensemble des
            annonces actuellement publiées sur Lou-Ka (plusieurs dizaines de
            milliers, mises à jour en continu par nos synchronisations). Pour
            chaque segment de marché — ville, quartier, nombre de chambres —
            nous calculons le loyer médian et sa fourchette typique. Les
            chambres et colocations forment leur propre segment.
          </li>
          <li>
            <b>2. Les caractéristiques comptent.</b> Chauffage ou électricité
            inclus, stationnement, meublé, climatisation, superficie… : l'effet
            de chaque caractéristique sur le loyer est mesuré à partir des
            annonces elles-mêmes, puis appliqué à l'estimation.
          </li>
          <li>
            <b>3. Les voisins comparables.</b> Quand l'annonce est géolocalisée,
            nous affinons avec les annonces comparables les plus proches
            (même gabarit, à moins de 3 km), en donnant plus de poids aux plus
            proches et aux plus semblables.
          </li>
          <li>
            <b>4. Des garde-fous.</b> L'estimation reste bornée à un couloir
            plausible autour de la référence du segment. Chaque estimation
            porte une fourchette et un indice de confiance. S'il n'y a pas
            assez de comparables fiables, ou si le prix affiché est ambigu
            (« à partir de », prix à la semaine), <b>aucune pastille n'est
            affichée</b> plutôt qu'un verdict trompeur.
          </li>
        </ul>
      </section>

      <section>
        <h3>La classification</h3>
        <p>
          L'écart entre le prix demandé et la juste valeur détermine la
          pastille : <b>sous le marché</b> à partir de −8 %, <b>au-dessus du
          marché</b> à partir de +8 %, <b>dans le marché</b> entre les deux.
          Ces seuils sont recalibrés périodiquement en observant le marché —
          notamment la vitesse à laquelle les annonces « sous le marché »
          trouvent preneur.
        </p>
        <p>
          Astuce : sur la page d'accueil, le filtre <b>« ▼ Sous le marché »</b>
          montre uniquement les bonnes affaires, les plus avantageuses d'abord.
        </p>
      </section>

      <section>
        <h3>Ce que ce n'est pas</h3>
        <p>
          La juste valeur Lou-Ka est une <b>estimation statistique
          indicative</b>, recalculée à chaque synchronisation. Ce n'est ni une
          évaluation professionnelle, ni un avis juridique sur le loyer (pour
          les recours officiels, voir le Tribunal administratif du logement).
          Aucune donnée n'est inventée : quand le marché local ne fournit pas
          assez d'annonces comparables, nous l'indiquons au lieu d'estimer à
          l'aveugle.
        </p>
      </section>

      <div className="fine">
        Questions ou observations sur une estimation ?{" "}
        <Link to="/contact">Écrivez-nous</Link>.
      </div>
    </div>
  );
}