recherche

AGENTS.md

@@ -12,6 +12,31 @@
 - [x] Module Visites + IA (`pb_hooks/generate_rapport.pb.js`, route `POST /api/mdb/generate-rapport`)
 - [x] Module Agenda (tâches, snooze, création modal)
 - [x] Dashboard (alertes, KPIs, pipeline, derniers biens, tâches du jour)
+- [x] Module Recherche & Analyse marché (onglet Recherche : Secteur / Opportunités / Grille de prix + fiche bien)
+
+## Roadmap — Agrégation type MoteurImmo & agents IA
+
+Référence produit : [moteurimmo.fr](https://moteurimmo.fr/) (agrégation multi-portails, alertes, DVF/transactions, API pro).
+
+**Écart actuel** : pas d’ingestion de flux externes ni de moteur d’alertes ; la grille / secteur restent des données **saisies ou locales** (PocketBase), pas une veille marché temps réel.
+
+### Personas agents (rôles métier + briques techniques)
+
+| Agent | Mission | Briques typiques |
+|-------|---------|------------------|
+| **Immobilier** | Off-market, diffusion agence (priorité site maison), prospection pour alimenter le pipe | Collections opportunités / contacts / tâches ; hooks ou jobs pour brouillons de contenu ; pas de scraping illégal — privilégier saisie, imports CSV, API partenaires. |
+| **Marchand de biens** | Prix secteur, €/m², repérage bonnes offres | Grille perso + DVF / transactions (open data) ; scoring simple ; alertes sur critères (prix/m², surface, zone). |
+| **Data / DVF** | Normaliser transactions publiques, relier zone ↔ bien | Import DVF (fichiers ou API tiers), tables dérivées, carto plus tard. |
+| **Veille annonces** | Agréger sources autorisées (API, flux partenaires, [API MoteurImmo](https://moteurimmo.fr/) si abonnement) | Collections `sources_flux`, `annonces_brutes`, `alertes_recherche` ; cron PocketBase ou worker externe ; dédoublonnage. |
+| **Alertes & notif** | Push / email quand une annonce ou une transac matche une recherche sauvegardée | Règles métier + Expo notifications ; file d’événements côté PB. |
+| **Rédaction / CRM** | Textes vitrine, relances, synthèses pour prospection | Réutiliser le pattern hook IA (`generate_rapport`) par type de prompt. |
+
+### Phases suggérées
+
+1. **Modèle de données** : recherches sauvegardées, alertes, log d’ingestion (sans agrégateur massif au début).
+2. **Données publiques** : DVF ou extrait local par zone (preuve de valeur pour €/m² réel).
+3. **Une source API fiable** (partenaire ou open data) avant tout volume type MoteurImmo.
+4. **UI** : liste annonces unifiée + filtres + onglet alertes dans Recherche.
 
 ## Infos techniques
 - PocketBase : http://localhost:8090