nav-carte/V2-cadrage/I-prompt-session-3-ia-deploy.md

I — Prompt Session 3 : IA + Deploy NAV V2

Session dédiée Claude Code, modèle Opus pilote avec délégation sous-agents Sonnet autorisée.
Prérequis : Sessions 1 et 2 terminées (front navigable, fiches visibles, formulaire OK).
Durée estimée : 6-8h.
Autonomie : 6/10 (checkpoints : test pipeline IA sur 3 fiches + deploy final).

Mission

Brancher la couche IA et déployer la V2 :

1. Worker IA async qui enrichit les soumissions (Mistral Nemo)
2. Chatbot recherche sémantique (Mistral Small)
3. Bandeau bas stats (coût IA + dons + activité)
4. Page /a-propos (souveraineté, gouvernance, transparence Liberapay)
5. Deploy production nav.trans-former.fr
6. Test pipeline IA sur les 3 fiches réservées

Fichiers de référence (à LIRE en premier)

Tous dans C:\Users\jules\Dropbox\ATIS - IPCJRA\0 INBOX\NAV-V2-recherches\ :

• G-prompt-dev-final.md (vision V2, étapes 4, 5, 7, 8, 9)
• B-provider-ia-souverain.md (Mistral Nemo + Small, circuit breaker 20€/mois)
• C-systeme-dons.md (Liberapay widget)
• F-spec-pipe-collaboration.md (§3 prompts IA exacts, §4 endpoints)
• VPS-check.md (deploy process)
• palette-nav-v2.md (palette bandeau + /a-propos)
• seed-test-pipe-ia.json (3 fiches CNOA/Archireport/Collectif Fil réservées pour test worker)

Journal projet : 1 PROJETS\TECH - infra VPS, website pro, RAG\nav-carte\JOURNAL-V2.md
Code en cours : 1 PROJETS\TECH - infra VPS, website pro, RAG\nav-carte\

Décisions tranchées (Sessions 1 + 2 + pilote S3)

• Circuit breaker 20€/mois dépassé → bandeau "manque de fonds" + CTA Liberapay + pédagogie "1€ = N requêtes" + transparence origine Liberapay
• Transparence Liberapay (origine belge, asso non-lucrative, hébergement FR/UE éthique) → section dédiée dans /a-propos
• From email modération : contact@trans-former.fr
• Liberapay URL : liberapay.com/trans-former.fr (widgets fournis dans C-systeme-dons.md)
• Seuil email modération : 5 fiches pending → envoi mail Jules via Resend
• Facteur CO2eq : 0.052 kg CO2/kWh (RTE FR) pour calcul bandeau carbone
• Scraping : crawl4ai seul, pas de fallback httpx+BS4 (diag VPS pilote : crawl4ai occupe 4.3 MB, ms-playwright absent donc crawl4ai tourne en mode statique léger — un seul chemin de code, plus simple à maintenir)
• Rate limit chatbot : 10 req/IP/jour (F §8, fichier JSON /tmp/nav-ratelimit/{IP_hash}.json, cron reset journalier)
• Prompts Mistral Nemo + Small : copier-coller exact depuis F §3 et §4, ne pas reformuler
• Stack deploy : systemd + Caddy sur nav.trans-former.fr (même domaine que V1, pas de sous-domaine API)
• Endpoint soumission : /api/organisations (POST JSON standard, déjà existant — S2 a utilisé organisations.post.ts)

État S1 et S2 — à lire AVANT de coder

Lecture obligatoire en premier : 1 PROJETS/TECH - infra VPS, website pro, RAG/nav-carte/JOURNAL-V2.md

Points d'attention :

• 96 fiches importées NocoDB, 3 réservées test pipe IA (CNOA, Archireport, Collectif Fil)
• 8 anciens records V1 (IDs 1-8, moderation_status null) à purger avant deploy prod
• Divergence taxonomie moderation_status tranchée : approved/rejected partout, pending = absence de validation
• Endpoint NocoDB correct : /api/v1/db/meta/tables/{id}/columns (v0.301.5)
• Disque VPS 76% (21/04) — surveiller pendant scraping, alerter si > 85%
• Conflit lib Python rich résolu avec --ignore-installed — vérifier au passage que lightrag tourne toujours (TODO S1)

Préflight avant tout code (obligatoire)

1. Lire JOURNAL-V2.md en entier
2. Lire F-spec-pipe-collaboration.md §3, §4, §6 (circuit breaker), §7 (endpoints), §9 (worker)
3. ssh vps-hetzner "cat /opt/nav-carte/.env | grep -E 'MISTRAL|NOCODB|RESEND'" → vérifier toutes les clés présentes
4. ssh vps-hetzner "df -h /" → confirmer disque < 85%
5. Si une clé manque ou disque > 85% → STOP, remonter au pilote Jules

Test coût AVANT de scaler (règle sacrée)

Étape 5 (test pipe IA) :

1. Lancer le worker sur 1 seule fiche (CNOA)
2. Vérifier stats_usage : tokens_in, tokens_out, cout_eur
3. Extrapoler coût pour 96 fiches → si > 1€ pour le batch test, STOP + ping Jules
4. Si OK, lancer sur les 2 fiches restantes (Archireport, Collectif Fil)

Credentials

VPS : ssh vps-hetzner (port 4422)
NocoDB : localhost:8070
Token nav-v2-worker : dans /opt/nav-carte/.env
Mistral API key : dans /opt/nav-carte/.env (MISTRAL_API_KEY)
Resend SMTP : /opt/vps-kit/.env
Deploy : /opt/nav-carte/ (systemd nav-carte.service)
Domaine : nav.trans-former.fr (Caddy config existante)

Étapes

Étape 4 — Worker IA enrichissement (4-5h)

• Script worker/enrich.js (Node.js, lancé via systemd timer toutes les 5 min)
• Pipeline :
  1. Fetch organisations WHERE moderation_status=pending AND ai_processed=false (LIMIT 5 par run)
  2. Pour chaque fiche :
     • Scrape URL via crawl4ai (timeout 3 min, mode statique) — si échec : flag scrape_status=failed, pas de fallback httpx+BS4
     • Truncate contenu scrapé à 4k tokens
     • Appel Mistral Nemo avec prompt F §3 (copier-coller exact)
     • Parser réponse → update description_enrichie, points_cles, tags_fonction (si IA propose), ai_raw_output, ai_processed=true, scrape_status
     • Log dans stats_usage (model, tokens_in, tokens_out, cout_eur, timestamp, orga_id)
  3. Si circuit breaker 20€/mois dépassé : skip enrich, log, trigger bandeau "manque de fonds"
  4. Si 5 fiches en attente modération : email Jules via Resend (from contact@trans-former.fr)
  5. Si scrape échoué : flag scrape_status=failed, review manuel
• Gestion erreurs : retry 2x, puis flag scrape_status=failed

Étape 5 — Test pipeline IA sur 3 fiches (1-2h)

Utiliser seed-test-pipe-ia.json (3 entrées : CNOA, Archireport, Collectif Fil) :

• Injecter manuellement dans NocoDB avec moderation_status=pending, ai_processed=false
• Déclencher worker manuellement (pas attendre cron)
• Observer les 3 runs, documenter :
  • Temps d'exécution par fiche
  • Qualité description_enrichie et points_cles
  • Fonctions détectées par l'IA vs fonctions Jules
  • Coût Mistral (stats_usage)
• Produire 1 PROJETS/TECH - infra VPS.../nav-carte/PIPE-IA-DOC.md : documentation précise du pipeline, input, output, prompts, paramètres — servira de base pour le futur skill /mistral-nemo-vps

Étape 5bis — Chatbot recherche (3-4h)

• Composant ChatbotSheet.vue (bottom-sheet Headless UI, mobile + desktop)
• Message onboarding : texte exact E §6
• Template requête : champs besoin / thématique / lieu → prompt structuré
• API POST /api/chatbot :
  • Input : question utilisateur + contexte JSON des fiches (top N matchs par taxonomie)
  • Appel Mistral Small (prompt F §3)
  • Output : fiches recommandées + explication 1-2 lignes par fiche
• Rate limit : 10 req/IP/jour, fichier JSON /tmp/nav-ratelimit/{IP_hash}.json (F §8, aligné avec S2)

Étape 7 — Bandeau bas + Liberapay (1-2h)

• Composant BandeauBas.vue, fond --nav-primary 60%
• Gauche : stats live depuis stats_usage
  • Coût mois en cours / 20€
  • Nombre tokens utilisés
  • Carbone estimé : kWh × 0.052 kg CO2eq/kWh (RTE FR) — valeur tranchée
• Milieu : CTA "Soutenir NAV" → Liberapay widget (snippet C-systeme-dons.md)
• Droite : compteurs semaine (nouveaux dons, fiches ajoutées, requêtes chatbot)
• Mode "manque de fonds" (si circuit breaker dépassé) : bandeau bascule en mode "NAV a épuisé son budget IA ce mois — aide-nous à continuer" + pédagogie "1€ permet ~X requêtes" (calcul depuis prix Mistral)

Étape 8 — Page /a-propos (1-2h)

• Sections :
  • NAV — mission, esprit collaboratif, pour qui
  • Souveraineté — IA française (Mistral), hébergement FR (Hetzner), zéro cookie US
  • Gouvernance — qui tient le projet, transparence code (GitHub si public)
  • Transparence Liberapay — origine (asso belge Liberapay Recurrent Donations ASBL), non lucrative, pas de cut par défaut, hébergement FR/UE éthique, modèle de dons récurrents
  • Transparence IA — modèles utilisés, circuit breaker, coût mensuel visible sur bandeau
• Badges : "IA souveraine", "Hébergé en France", "Zéro cookie US"
• Lien vers formulaire + widget Liberapay

Étape 9 — Deploy + tests (2-3h)

• Build production (npm run build)
• Avant deploy : purger les 8 anciens records V1 (IDs 1-8, moderation_status null) dans NocoDB
• Deploy via git pull && systemctl restart nav-carte.service
• Vérifier DNS nav.trans-former.fr, HTTPS Caddy (config V1 déjà présente — vérifier si routes V2 nécessitent ajustement)
• Checkpoint Jules : test manuel
  • Soumettre une fiche test via /contribuer
  • Vérifier passage dans worker (cron 5 min)
  • Jules valide en NocoDB manuellement
  • Vérifier apparition sur la carte
• Tester chatbot avec 2-3 requêtes réelles
• Tester mobile iOS Safari + Android Chrome

Checkpoints Jules

1. Avant étape 5 : valider texte onboarding chatbot + prompt recherche
2. Étape 5 test pipe : valider qualité enrichissement sur 3 fiches
3. Étape 8 : review texte /a-propos (ton Jules appliqué)
4. Étape 9 : checkpoint deploy final + submit test

Délégation (Opus pilote)

• Sonnet 1 : worker IA + test pipe 3 fiches + PIPE-IA-DOC (étapes 4-5)
• Sonnet 2 : chatbot (étape 5bis)
• Sonnet 3 : bandeau + /a-propos (étapes 7-8)
• Opus : deploy + checkpoint finaux + debug

Règles

• Tester pipeline IA sur 1 fiche AVANT de scaler aux 3
• Circuit breaker 20€ = sacré, jamais dépasser
• Secrets via .env, jamais dans le code
• Si blocage > 30 min → reporter au pilote
• À la fin : mettre à jour JOURNAL-V2 avec backlog V3 détaillé

Output attendu

1. V2 déployée sur nav.trans-former.fr
2. ~103 fiches sur la carte + 3 fiches enrichies par IA
3. Worker cron 5 min opérationnel
4. Chatbot fonctionnel
5. Bandeau live avec stats
6. Liberapay relié + page /a-propos complète
7. PIPE-IA-DOC.md produit (base skill /mistral-nemo-vps)
8. JOURNAL-V2.md final avec backlog V3