# Toveli — plateforme immobilière québécoise unifiée (www.toveli.ca)

« Trouver. Comprendre. Décider. » Annonces à vendre et à louer, carte, estimation de valeur avec fourchette et confiance, comparables, marché, financement, assistant IA ancré dans les données.

## Stack
Next.js 16 (App Router, TypeScript strict, Tailwind v4), better-sqlite3 (base canonique `data/toveli.db`, lecture seule au runtime), MapLibre GL + OpenFreeMap (sans clé), Recharts, Anthropic SDK (assistant, clé serveur), Vitest.

## Lancer en local
```bash
pnpm install
cp .env.example .env.local            # ANTHROPIC_API_KEY pour l'assistant (facultatif)
TOVELI_SSH_KEY="" TOVELI_VP_SSH=M3U96a TOVELI_LK_SSH=M4M64a NO_RESTART=1 pnpm sync   # ~3 min, construit data/toveli.db (2,4 Go)
pnpm dev                              # http://localhost:3000
pnpm test && pnpm typecheck && pnpm lint && pnpm build
```

## Données (scripts/sync.ts, chaque nuit à 04:30 sur le nœud)
Extraits minces en lecture seule (`sqlite3 ATTACH` sur le nœud source, rsync LAN) → normalisation → rapprochement annonce → propriété (rôle ≤ 40 m > adresse normalisée > cellule de coordonnées, confiance affichée) → valuations, scores de quartier, transactions, rôle MAMH, indices → métriques de marché → FTS → bascule atomique + `pm2 restart toveli`. Schéma : `scripts/schema.sql`. Aucune écriture vers les sources. Voir `docs/source-audit/`.

## Déploiement (MacLustr, remote-first)
Manifeste `M1M32:~/dispatch/apps/toveli.json` (nœud épinglé M3U96b, port 8460, route MacLustr Tunnel https://www.toveli.ca). Création : `mld stage <dir> toveli && mld deploy toveli && mld adopt toveli`, puis première synchro `ssh M3U96b 'cd ~/apps/toveli && pnpm sync'`. Ensuite, toute modification se fait dans `M3U96b:~/apps/toveli` (dépôt git, origin spbgit `toveli.git`).

## Comptes, publications directes, échanges (extension 2026-10-17)
PostgreSQL 17 local (compte `toveli_app`, port non exposé) + Drizzle (`src/db/schema.ts`, migrations `drizzle/`). Connexion sans mot de passe par code courriel (Resend ; transport simulé sans clé), sessions révocables, wizard de publication (location/vente, photos traitées par sharp, attestation, modération), messagerie et visites, favoris et alertes serveur, console admin protégée par TOTP. Détails : `docs/architecture/account-and-listings.md`.

```bash
createdb toveli && createuser toveli_app                       # ou docker compose up postgres
DATABASE_URL=postgresql://toveli_app:…@127.0.0.1:5432/toveli pnpm db:migrate
pnpm test                                                       # unitaires + intégration PostgreSQL (toveli_test)
pnpm start & scripts/smoke.sh http://127.0.0.1:8460 toveli      # parcours API bout en bout (courriels dans data/outbox)
pnpm jobs                                                       # alertes, expirations, purge (PM2 cron horaire en prod)
pnpm tsx scripts/grant-role.ts <courriel> ADMIN                 # rôle serveur ; TOTP exigé ensuite sur /admin
```

## Garde-fous produit
Pas de « bonne affaire » : écart estimation / prix demandé avec confiance ; estimation ≠ évaluation agréée (OEAQ) ; photos hotlinkées avec crédit source ; chaque fiche renvoie à l'annonce d'origine ; favoris/comparateur/recherches en local (aucun compte) ; clés API uniquement côté serveur.