# Décisions d'architecture (ADR) — Toveli

# ADR-1 · Quatrième plateforme autonome, lecture seule sur les sources

Toveli possède son dépôt (toveli.git sur spbgit), son nœud (M3U96b), son port (8460), son domaine, sa base (data/toveli.db) et ses secrets. Les trois plateformes ne sont ni modifiées ni interrogées en production : des instantanés sqlite3 ATTACH … CREATE TABLE AS SELECT sont pris sur le nœud source puis rapatriés (≈ 1,5 Go/nuit sur le LAN). Seul effet de bord : une clé publique ajoutée à M4M64a:~/.ssh/authorized_keys (ligne commentée toveli-sync-depuis-M3U96b-2026-10-17, sauvegarde authorized_keys.bak-20261017).

# ADR-2 · SQLite canonique reconstruite chaque nuit plutôt que Postgres synchronisé

Les sources sont elles-mêmes en SQLite et changent par lots ; une reconstruction complète (≈ 2 min) avec bascule atomique est plus simple et plus sûre qu'une réplication incrémentale. Le handle better-sqlite3 est rouvert quand l'inode change. Limite : pas d'écriture utilisateur dans cette base → les favoris sont locaux (v1) ; l'identité/annonces directes iront dans une base PostgreSQL séparée (extension).

# ADR-3 · Modèle canonique « annonce ≠ propriété »

property (clé rôle / adresse / coordonnées + confiance), listing (provenance JSON), price_event, valuation (modèle, version, méthode, verdict), sale_transaction, role_unit, market_metric, neighbourhood_score, source. Les unités en copropriété ne sont pas fusionnées automatiquement.

# ADR-4 · Estimation : réutiliser le moteur pur de Vrai-Prix, recalculer en direct

engine.ts copié tel quel (attribution en en-tête). En direct sur chaque fiche quand l'unité du rôle est connue, sinon estimation manuelle par comparables ; valuations nocturnes vp_eval comme repli. Toujours : fourchette, confiance A–D, méthode, version, date, limites, avertissement OEAQ.

# ADR-5 · Cartes libres

MapLibre GL + style OpenFreeMap (positron) : aucune clé, attribution OSM/OpenMapTiles. Mapbox exclu (jeton Groupe Ka).

# ADR-6 · Assistant IA

Anthropic côté serveur, boucle d'outils (recherche, fiche, marché, estimation, hypothèque) ; réponses citant les uid des annonces (cartes affichées) ; limitation 30 req/10 min/IP ; aucun stockage des conversations. Abstraction fournisseur par variables d'environnement.

# ADR-7 · Interface

Français québécois, mobile-first (navigation basse 5 onglets, cartes 2 colonnes, carte plein écran), ordre du DOM = ordre visuel, aucune mention des marques sources dans l'interface (crédit = site d'origine), pas de console d'administration publique.