Files
mdb/AGENTS.md
Bastien COIGNOUX 360522f30a recherche
2026-05-04 22:11:46 +02:00

51 lines
3.5 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# AGENTS — Suivi du projet
## État actuel
- [x] Docker + PocketBase configuré et lancé
- [x] Migration collections (fichiers `pb_migrations`) — à appliquer au démarrage serveur si besoin
- [x] App Expo initialisée
- [x] Auth fonctionnelle
- [x] Navigation complète
- [x] Module Prospection (pipeline / biens)
- [x] Module Fiche bien + Calculateur
- [x] Module Contacts (liste par catégorie, recherche, fiche + biens liés)
- [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)
- [x] Multi-agents MVP (migration `1760000000`, hooks `agents_veille.pb.js`, onglet **Veille & agents** : recherches, alertes, annonces veille, transactions secteur, courriers + routes `/api/mdb/agent-*`)
## 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 dingestion de flux externes ni de moteur dalertes ; 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 dingestion (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
- Admin : http://localhost:8090/_/ (admin@mdb.fr)
- Binaire : /usr/local/bin/pocketbase
- Données : /pb_data
- Hooks JS : volume `pb_hooks` monté sur `/pb_hooks` ; **docker-compose.dev** : `command: --dir=/pb_data --hooksDir=/pb_hooks` pour charger les routes `/api/mdb/*`
- Variable IA : `ANTHROPIC_API_KEY` dans `.env.local` (chargée par Docker pour PocketBase)
- OS : Windows Git Bash (MSYS_NO_PATHCONV=1)
- PocketBase : v0.23+