---
type: journal
project: NAV V2
created: 2026-04-14
status: actif
---

# NAV V2 — Journal de développement

Journal technique de la V2. Décisions, anomalies, points bloquants, TODOs.

---

## 2026-04-29 — Cascade Onglet 1 : Pratiques régénératives (P1 → P5b)

**Commit deploy :** `e80b226` (feat/aep-pratiques-regeneratives, 10 commits depuis main)
**Exécutant :** Sonnet (agent autonome P1-P5b)

### Chantier P1 → P5b (résumé)

Création complète de l'onglet "Pratiques régénératives" sur `aep.trans-former.fr` :

- **P1** : scaffold types + API statique `GET /api/pratiques` (52 fiches JSON `public/data/pratiques-regeneratives.json`)
- **P2** : page `/pratiques-regeneratives` — carte Leaflet Europe + accordéon DOM-TOM, sidebar filtres (type, pays, matériaux), composants `PratiqueCard.vue` + `PratiqueModal.vue`
- **P3** : ajout onglet "Pratiques régé" dans le header nav desktop + hamburger mobile
- **P4** : page `/proposer-pratique` — formulaire contribution avec Zod, endpoint `POST /api/submit-pratique` avec rate limit, `public/data/pratiques-pending.json`
- **P5a** : build local validé (3.04 MB, APIs 200, 500 SSR = bug Windows/Node 24 préexistant non-bloquant)
- **P5b** : deploy prod + smoke test (3/3 endpoints 200, SSR title OK, JSON 52 fiches)

### Deploy

- Méthode : `tar .output/ | ssh vps-hetzner "cd /opt/aep && tar -xzf -"` + `systemctl restart aep`
- Env diff local vs VPS : VPS a des vars supplémentaires (MISTRAL, NOCODB worker, RESEND) — additionnel non-conflictuel, pas d'impact
- Note `deploy.sh` : le script a un BOM UTF-8 (ligne 1 `\xEF\xBB\xBF#!/bin/bash`) qui cause un exit 1 sur le `read -p` quand stdin est un pipe. Contournement : exécution manuelle des étapes. A corriger en V3.

### Smoke test prod (2026-04-29 01:38 UTC)

| Endpoint | HTTP | Note |
|---|---|---|
| GET /pratiques-regeneratives | 200 | SSR OK, titre trouvé (2 occurrences) |
| GET /proposer-pratique | 200 | SSR OK |
| GET /api/pratiques | 200 | JSON valid, 52 fiches |

### Ce qui reste à valider (Jules, E2E BrowserMCP)

- Markers Leaflet visibles + cliquables (Europe + DOM-TOM)
- Sidebar filtres fonctionnels (type, pays, matériaux)
- Modal fiche + bouton retour preservant filtres
- Formulaire `/proposer-pratique` : submit + message succès
- Comportement mobile 375×667 (sheet bas, swipe filtres, fiche pleine page)

Prompt E2E disponible : `aep-communaute-build/PROMPT-BROWSERMCP-E2E.md`

---

## 2026-04-27 — Session V3 : Finition mobile + Blog Liberapay + 3 deploys

**Commit :** `a02a555` — feat(mobile): accordéon outremer, hamburger nav, logo AEP, fiches cliquables, chatbot fullscreen
**Pattern :** agents parallèles (3 × Sonnet) pour les 3 SSH indépendants — ~90s total vs ~20min séquentiel

### Changements implémentés

**B — OutremerMap.vue : accordéon vertical DOM-TOM**
- Template : row horizontale → accordéon `<button>` + `v-show` par territoire
- Lazy-init Leaflet : `initSingleMap(domName)` appelé au 1er clic (plus de `initMaps()` en `onMounted`)
- `invalidateSize()` sur ré-ouverture d'une carte déjà initialisée

**E — app.vue : hamburger mobile**
- Bouton `lg:hidden` tout à droite de `<!-- Actions droite -->`
- Dropdown `v-if` : 5 liens (/, /agences, /rag, /a-propos, /signaler)
- `z-index: 9999` en inline style sur le dropdown
- `watch(() => route.path)` → ferme le menu à chaque navigation
- **Fix stacking context :** header → `relative z-[9999]` (sans `position`, le z-index Tailwind n'avait pas d'effet → dropdown passait sous Leaflet)

**F — app.vue : badge "A" → "AEP"**
- `w-7 h-7` → `h-7 px-2`, `text-sm` → `text-xs tracking-tight`

**G — pages/index.vue : fiches ouvrables mobile**
- `onSelectOrgMobile` : ajout `storeFiltersForBack()` + `router.push('/fiche/${id}')`
- NB : `router.push` était déjà là (modif pilote antérieure) — seul `storeFiltersForBack` ajouté

**H — ChatbotSheet.vue : fullscreen + scroll lock iOS**
- `92dvh → 100dvh`, `border-radius: 16px 16px 0 0 → 0`
- `defineProps` → `const props = defineProps` (fix "can't find variable: props" en prod)
- `watch(props.modelValue)` → lock `document.body.style.overflow` + `document.documentElement.style.overflow`
- `onUnmounted` → cleanup overflow

**A — Blog trans-former.fr : Liberapay retiré**
- VPS `/opt/astro-site/src/layouts/PostLayout.astro` : import + `<DonateButton />` supprimés
- Docker rebuild → 31 pages, HTTP 200

**C — Website pro deploy**
- `index.astro` SCP → `/opt/astro-pro/`, Docker rebuild → 13 pages, HTTP 200

### TODOs ouverts AEP
- [ ] Valider visuellement les 8 fixes sur tel (Jules)
- [ ] Pousser nav-carte sur Gitea (`git.trans-former.fr/jules/nav-carte`)

---

## 2026-04-15 — Session 5 : Corrections post Phase 2 (11 retours Jules)

**Exécutant :** Sonnet (agent autonome full auto)
**Durée :** ~45min
**Commits :** 7 commits atomiques (8ae4be3 → d30ee2c)

### Retours implémentés

**#1 — Barre de recherche** ✅
- Desktop : supprimée du header (doublon avec sidebar `NavSidebar.vue`)
- Mobile : ajoutée dans le header (`app.vue`, visible `<lg`)

**#2 — Sheet swipable mobile** ✅
- Nouveau composant `MobileSheet.vue` — 3 états : collapsed (56px) / half (50dvh) / full (92dvh)
- Touch events natifs (pas de `@vueuse/core` — implémentation vanilla pour 0 dépendance)
- Drag handle + cycle d'états au clic header + snap-back si delta < 60px
- Vue mobile index.vue : carte pleine hauteur en fond + sheet en overlay
- Décision d'exécution : vanilla touch events choisis vs useSwipe (pas installé)

**#3 — Onglets header desktop** ✅
- 3 onglets centrés remplacent la barre de recherche desktop : Écosystème / Agences Inspirantes / RAG
- Active state via `route.path` + underline `--nav-primary-solid`
- Badge "en construction" sous les 2 onglets inactifs

**#4 — Supprimer "+ Ajouter carte"** ✅
- Bouton retiré du header `app.vue`
- Route `pages/ajouter-carte.vue` supprimée

**#5 — Report/modif participatif via Resend** ✅
- `server/api/report.post.ts` : rate limit 5/IP/jour, validation email + message, envoi Resend API
- `FicheDetail.vue` : bouton "Signaler une erreur" → form inline dépliable (message + email, compteur 500 chars)
- Email envoyé à `jules@trans-former.fr` (fallback Resend, pas NocoDB)

**#6 — Texte intro commentaires** ✅
- `CommentSection.vue` : intro italique avant la liste

**#7 — DOM-TOM row horizontale pleine largeur** ✅ (Option A)
- `OutremerMap.vue` : layout row flex 5 colonnes égales, hauteur 140px
- Desktop `index.vue` : layout vertical (Métropole flex-1 + DOM-TOM row 140px fixe en bas)
- Suppression de l'encart 1/3 droit

**#8 — Supprimer layer control carte** ✅
- `NavMap.vue` : `L.control.layers(...)` supprimé, seul CartoDB Positron reste

**#9 — Dark mode switch tuile** ✅
- `NavMap.vue` + `OutremerMap.vue` : `MutationObserver` sur `html.classList` → `setUrl()` light_all/dark_all
- Initialisation correcte dès le premier rendu (lire `document.documentElement.classList`)

**#10 — Bandeau bas : logique inversée** ✅
- `BandeauBas.vue` : `isCollapsed = ref(true)` par défaut
- `onMouseLeave` : repli immédiat (suppression du timer 3s)
- Opacité bandeau déployé : 70%

**#11 — Bouton Soutenir recentré** ✅
- `bandeau-col--center` : `padding-top: 8px` pour décaler vers le bas dans la hauteur du bandeau

### Cleanup
- Supprimés : `TerritoireTabs.vue`, `TerritoireToggle.vue` (composants morts)
- Supprimée : `pages/ajouter-carte.vue`
- Créées : `pages/agences.vue`, `pages/rag.vue` (placeholders)
- Créé : `components/MobileSheet.vue`

### Décisions d'exécution S5
- **#2 useSwipe** : `@vueuse/core` absent du `package.json` — vanilla touch events choisis pour éviter d'ajouter une dépendance. Même résultat, 0 dép supplémentaire.
- **#5 NocoDB vs Resend** : fallback Resend appliqué conformément aux décisions Jules pré-tranchées. Pas de table NocoDB créée.
- **DOM-TOM desktop** : layout du `index.vue` passé de `flex row (2/3 + 1/3)` à `flex col (Métropole flex-1 + DOM-TOM row 140px)` pour intégrer l'Option A cohéremment.

### Build & deploy
- Build : `npx nuxt build` ✅ (223 modules client, 134 modules serveur)
- Deploy : tar → SSH → `systemctl restart nav-carte` ✅
- Vérif : `curl https://aep.trans-former.fr/ → 200`, service `active`

---

## 2026-04-15 — Session 4 : Phase 2 UX (10 features)

**Exécutant :** Sonnet (agent délégué Opus)
**Durée :** ~1h30

### Réalisé

**Feature 1 — Modal fiche sidebar desktop** ✅
- Composant `FicheModal.vue` : overlay centré max-w-3xl (768px), 90vh scroll interne
- Backdrop semi-transparent, fermeture Esc / clic backdrop / bouton croix
- Lien "Ouvrir" → `/fiche/[id]` (URL partageable préservée)
- Fetch `$fetch('/api/fiche/X')` avec watch sur orgId
- `onSelectOrg` desktop (≥1024px) → ouvre modal
- Mobile : comportement inchangé (navigation vers `/fiche/[id]`)

**Feature 2 — Fusion Outre-mer (suppression TerritoireTabs)** ✅
- Desktop : layout flex `flex:2` Métropole + `flex:1` bandeau DOM-TOM (max 340px, OutremerMap réutilisé)
- Mobile : section DOM-TOM scroll horizontal avec compteurs par territoire
- `TerritoireTabs` retiré du template (composant conservé, non utilisé)

**Feature 3 — CartoDB Positron + layer control + maxBounds** ✅
- `NavMap.vue` : fond par défaut CartoDB Positron (`light_all`), layer control 3 fonds (Clair / Schématique Stamen / Standard OSM)
- `maxBounds` France métr. `[41-51.5°N, -5.5-10°E]`, `minZoom: 5`, `maxZoom: 18`
- `OutremerMap.vue` : fond CartoDB Positron par défaut (sans layer control)

**Feature 4 — Bandeau bas rétractable desktop** ✅
- `bg-opacity-80` (rgba 0.8)
- Auto-collapse après 3s, déploie au hover ou mouvement souris < 80px du bas
- Barre fine `32px` en état rétracté avec label "AEP · Transparence IA"

**Features 5+6 — Textes bandeau corrigés + lien Liberapay** ✅
- "Coût IA ce mois : X.XX €" + "Tokens : X" (sans ratio budget)
- Tooltip "1 € = 30 fiches mises en ligne" au hover bouton Soutenir
- Lien Liberapay → `https://liberapay.com/trans-former.fr/donate`
- Mobile : BandeauBas absent, remplacé par FAB coeur (gauche) → bottom sheet

**Feature 7 — Logo AEP tooltip** ✅
- Sous-titre "Architecture d'Écologie Politique" visible en `lg:`
- Tooltip au hover pour `sm:` (sans le sous-titre)
- Attribut `title` sur le lien pour accessibilité

**Feature 8 — Header desktop refonte + barre de recherche** ✅
- Barre de recherche ~500px centrée dans le header desktop (≥1024px)
- Sync URL `?q=` via watch, fonctionne depuis toutes les pages
- Boutons "+ Proposer" et "+ Ajouter carte" en haut à droite
- Route `/ajouter-carte` créée (placeholder)

**Feature 9 — Dark mode** ✅
- Toggle soleil/lune en top nav, persistance `localStorage` clé `aep_theme`
- Variables CSS `.dark` dans `main.css` : fonds sombres, texte clair
- Overrides Leaflet (popup, control layers)
- Note : tuile CartoDB dark (`dark_all`) non switchée automatiquement — à améliorer en S5

**Feature 10 — /a-propos CTA Contribuer + lien Liberapay** ✅
- Section "Contribuer" existante améliorée (lien `/donate`)
- Liens Liberapay unifiés sur `/donate`

### Commits

| Hash | Message |
|------|---------|
| `46b6051` | feat(aep-s4): CartoDB Positron + layer control + maxBounds France |
| `3c036db` | feat(aep-s4): logo AEP + tooltip nom complet + dark mode toggle |
| `775ec64` | feat(aep-s4): dark mode CSS variables + Leaflet overrides |
| `9736ba7` | feat(aep-s4): bandeau bas — rétractable desktop + FAB mobile + textes corrigés |
| `d092fd0` | feat(aep-s4): /a-propos — liens Liberapay corrigés (/donate) |
| `955a561` | feat(aep-s4): page /ajouter-carte (placeholder bientôt disponible) |
| `b406cc9` | feat(aep-s4): fusion outremer — suppression TerritoireTabs + vue 2/3+1/3 |
| `2b43e90` | feat(aep-s4): modal fiche sidebar desktop |

### Build & Deploy
- `npm run build` : ✓ 2.84 MB bundle
- Deploy VPS : ✓ `systemctl is-active = active`
- `curl -sI https://aep.trans-former.fr/` : HTTP/2 200

### Points d'attention pour S5

- Dark mode tuile Leaflet : switcher automatiquement vers `dark_all` CartoDB quand `.dark` est actif
- BandeauBas détection mobile avec `isMobile` ref côté client : SSR safe (montage) mais risque blink. Envisager `useWindowSize` ou classe CSS média
- `TerritoireTabs` et `TerritoireToggle` non utilisés → à archiver ou supprimer en S5
- Barre de recherche header : sur les pages `/fiche/[id]` et `/a-propos`, la recherche navigue vers `/?q=X` — comportement acceptable mais pas élégant
- Modal fiche : pas de CommentForm affiché côté SSR (correctement client-only via watch)

---

## 2026-04-14 — Session 3a : Chatbot API (Étape 5bis)

**Exécutant :** Sonnet (agent chatbot)
**Durée :** ~30 min

### Réalisé

**ChatbotSheet.vue** — Déjà complet (S2) : onboarding exact E-spec §Détails chatbot, bulles user/assistant, fiches recommandées avec lien, erreurs 429/503, animation slide-up mobile.

**API POST /api/chatbot** (nouveau) :
- Rate limit : 10 req/IP/jour via `rateLimitJson.ts` (JSON + SHA-256 RGPD, spec F §8)
- Circuit breaker : vérification budget 20€/mois via `circuitBreaker.ts` → HTTP 503 si dépassé
- Keyword scoring : extraction mots-clés question → score sur nom+description+tags → top 20 fiches
- Filtrage optionnel par `fonction` et `echelle` si fournis dans le body
- Appel Mistral Small (mistral-small-latest, temp 0.3, max 600 tokens, json_object)
- Parse JSON → `{ reponse_texte, fiches_recommandees: [{ id, nom, explication }] }`
- Log asynchrone `stats_usage` (non bloquant)

**Helpers nouveaux** :
- `server/utils/rateLimitJson.ts` — fichier JSON par IP hashée SHA-256 dans `/tmp/nav-ratelimit/`
- `server/utils/circuitBreaker.ts` — budget check NocoDB stats_usage + calcul coût Mistral Small/Nemo
- `nuxt.config.ts` — ajout `statsTableId` (défaut `mbbq7n47ixy19mc`)

### Décisions

| Décision | Détail |
|----------|--------|
| rateLimitJson vs Redis existant | JSON fichier créé séparément (spec F §8 + RGPD SHA-256). Redis existant conservé pour submit/comment. Les deux coexistent. |
| Prompt Mistral Small | Construit depuis E-spec-frontend.md §Détails chatbot — pas de prompt verbatim dans F-spec §3 (qui est Nemo enrichissement). **Checkpoint Jules requis avant deploy prod.** |
| circuitBreaker.ts | Worker absent → créé dans server/utils/ (source unique, réutilisable par le futur worker) |
| statsTableId | Défaut hardcodé `mbbq7n47ixy19mc` + env var `STATS_TABLE_ID` en override |

### Commits

- `718e9f6` — feat(chatbot): API /api/chatbot + rate limit JSON SHA-256 + circuit breaker

### Build

- `npm run build` : ✓ sans erreur, 2.78 MB bundle

### TODO avant deploy (S3b)

- [ ] `STATS_TABLE_ID=mbbq7n47ixy19mc` → `/opt/nav-carte/.env` (confirmer ou corriger l'ID)
- [ ] Vérifier que `/tmp/nav-ratelimit/` est accessible en écriture sur VPS (droits node)
- [ ] Cron journalier reset `/tmp/nav-ratelimit/` (0h UTC) → à ajouter en S3b
- [ ] Tester chatbot 2-3 requêtes réelles sur VPS après deploy
- [ ] **Checkpoint Jules** : valider prompt Mistral Small (construit, pas copié-collé de F-spec)

---

## 2026-04-14 — Session 2 Ajustements UX v3

**Pilote :** Sonnet  
**Durée :** ~30 min

### Réalisé

**A) Search desktop déplacé top nav → sidebar (haut)**
- `TopSearchBar` retiré du header `app.vue` — top nav épuré (logo + Contribuer + Aléatoire)
- Barre recherche inline ajoutée en haut de `NavSidebar.vue` : toujours visible, pleine largeur sidebar, styles scoped `sidebar-search-*`
- Focus ring `var(--nav-primary)`, bouton clear intégré
- Mobile inchangé (search sticky bandeau entre filtres et liste)
- URL sync `?q=` conservé via `pages/index.vue`
- Commit : `3f88e86`

**B) Chatbot desktop cliquable + expand/collapse**
- `ChatbotPlaceholder.vue` refactorisé : état replié (56px) → étendu (45vh) au clic
- Header entier cliquable + chevron dédié avec rotation SVG 180° animée
- `transition: max-height 0.3s ease` — animation fluide
- Zone étendue : placeholder conversation S3, overflow-y auto
- Mobile `ChatbotSheet.vue` inchangé
- Commit : `88d0319`

### Build
- `npm run build` clean (0 erreurs, 0 warnings TS)

---

## 2026-04-14 — Session 1 : Setup + Fondations

**Pilote :** Opus  
**Exécutants :** Sonnet-1 (VPS/NocoDB), Sonnet-2 (seed parsing)  
**Durée estimée session :** 4-5h

### Décisions validées

| Décision | Détail | Source |
|----------|--------|--------|
| Palette | A (sobre institutionnel) + bleu nuit #1a2238 à 60% opacité **partout** (bandeau, pins, chips, surlignages) | Jules 2026-04-14 |
| Texte | Bleu plein pour titres/courant (lisibilité > esthétique) | Déduction palette |
| Liberapay | `liberapay.com/trans-former.fr` (pas `nav-archi`) | Jules |
| Seed | Bypass modération pour 94 fiches, 2-3 réservées pour test pipe IA (doc de la pipe → skill Mistral Nemo futur) | Jules |
| Liberapay transparence | Section dédiée dans `/a-propos` (étape 8), pas dans le bandeau | Jules |
| Circuit breaker dépassé | Bandeau "manque de fonds" + CTA Liberapay + pédagogie "1€ = N requêtes" + transparence origine Liberapay | Jules |
| From email modération | `contact@trans-former.fr` (existant Resend) | Jules |
| Session stratégie | 3 sessions dédiées (S1 fondations, S2 front, S3 IA+deploy) — préserve jauge Opus, use Sonnet pour exécution | Jules |
| Tokens | Mistral key stockée dans `/opt/nav-carte/.env`, jamais committée | Standard |

### Réalisé

**Sonnet-1 — Setup VPS + schéma NocoDB :**
- Token NocoDB `nav-v2-worker` créé : `R-Yhd_0KgfW0ZjFxIl5iNyLS1ca7VpP8dNbo4OOa`
- `/opt/nav-carte/.env` créé (chmod 600) avec `MISTRAL_API_KEY`, `NOCODB_TOKEN`, `NOCODB_BASE`, `NOCODB_TABLE_*`, `RESEND_FROM`, `NOCODB_URL`
- crawl4ai 0.8.6 installé via pip (`--ignore-installed` pour conflit lib `rich`)
- Table `organisations` (`m08t7g5v4wch6wb`) étendue : 19 champs ajoutés
  - Contenus : url, description_user, description_enrichie, points_cles, localisation_ville, submitted_by_email, moderator_note, ai_raw_output, scrape_content
  - Taxonomie : echelle (SingleSelect), territoire (SingleSelect), tags_fonction (MultiSelect)
  - État : scrape_status, moderation_status, ai_processed (Checkbox)
  - Géo : latitude, longitude
  - Meta : submitted_at, moderated_at
- Table `stats_usage` créée : `mbbq7n47ixy19mc` (model, endpoint, tokens_in/out, cout_eur, timestamp, orga_id)
- Table `scrape_queue` skippée : F§2 n'en définit pas, la pipe utilise `scrape_status` sur `organisations`
- Tests insert/update OK sur les deux tables avec nouveau token

**Sonnet-2 — Parsing biblio + géocodage seed :**
- 93 entités parsées (A-biblio annonçait 94, erreur de comptage source)
- 72 géocodées via Nominatim, 21 sans ville (lat/lon null, pas de fallback centre France pour éviter bruit carte)
- Correction manuelle Saint-Ouen (93) vs Saint-Ouen-l'Aumône (Picardie)
- 3 fiches réservées test pipe IA : CNOA, Archireport, Collectif Fil

**Sonnet-3 — Re-tag + CROA + import NocoDB :**
- Re-tag : 32 Prospection → Développement, 17 RH → Gestion d'agence
- Formation détecté et ajouté à 9 fiches (Réseau des MA, Cité de l'Archi, MAJ, CFAA, REFC'A, DU Dauphine, UNAID, FFP, Cité Archi Formation continue)
- 13 CROA régionaux : 6 créés + 7 existants enrichis (tous avec "Gestion d'agence")
- CNOA National isolé et réservé aux 3 fiches test pipe IA
- **96 fiches importées** dans NocoDB (99 v2 − 3 test pipe)
- Apostrophe typographique U+2019 appliquée pour compat NocoDB
- Anomalie : 8 anciens records V1 présents (IDs 1-8, `moderation_status null`) → **à purger avant mise en prod**

### Anomalies & points à surveiller

1. **Taxonomie `moderation_status` — divergence F/G**
   - F§2 définit : `approved` / `rejected`
   - G mentionne : `published` / `approved`
   - Front V1 existant utilise : `approved`
   - **Décision Session 2 :** rester sur `approved`/`rejected` partout, retirer `published` du prompt G si la doc est mise à jour. Le statut `pending` (avant modération) existe de fait comme absence de validation.

2. **Endpoint NocoDB 0.301.5**
   - L'endpoint correct pour ajouter des colonnes est `/api/v1/db/meta/tables/{id}/columns`
   - L'endpoint `/api/v2/meta/tables/{id}/fields` n'existe PAS dans cette version
   - Le MCP `nocodb` n'était pas configuré avec la bonne URL de base → contournement direct par SSH + curl
   - **TODO :** reconfigurer le MCP nocodb pour qu'il pointe correctement (utile pour sessions futures)

3. **Disque VPS : 72,4%** (était 69,8% avant install crawl4ai)
   - crawl4ai a pris ~2,6 GB
   - Hypothèse : Playwright + Chromium embarqué (crawl4ai utilise Playwright pour les pages JS)
   - **Marge :** OK pour Sessions 2-3. À surveiller quand on commencera à scraper et stocker du contenu dans `scrape_content`
   - **Alternative si problème disque :** remplacer crawl4ai par `httpx + BeautifulSoup` pour le scraping statique (bien plus léger, mais perd le rendu JS)
   - **TODO :** vérifier via `du -sh` le poids exact de crawl4ai et ses deps Playwright, décider si on garde ou on allège

4. **Conflit lib Python `rich`**
   - Résolu avec `pip install --ignore-installed`
   - Risque : peut casser un autre outil Python VPS qui utilise `rich` (lightrag, formations, etc.)
   - **TODO :** vérifier que lightrag et autres services Python tournent toujours

### Fichiers produits

- `/opt/nav-carte/.env` (VPS, chmod 600)
- Tables NocoDB : `organisations` étendue + `stats_usage` nouvelle
- `0 INBOX/NAV-V2-recherches/palette-nav-v2.md` — palette finale CSS
- `0 INBOX/NAV-V2-recherches/palettes-preview.html` — mockup validé
- `0 INBOX/NAV-V2-recherches/seed-94-fiches.json` *(à produire par Sonnet-2)*
- `0 INBOX/NAV-V2-recherches/seed-94-rapport.md` *(à produire par Sonnet-2)*

### Prochaines étapes

- Sonnet-2 finit le parsing + géocoding
- Import seed NocoDB (bypass modération, 2-3 fiches réservées test pipe IA)
- Rédaction des prompts Sessions 2 et 3 (livrable fin Session 1)

---

## Taxonomie finale NAV V2 (validée 2026-04-14)

**Échelle** (3 niveaux) : `National` / `Régional` (inclut Départemental) / `Local`

**Territoire** : `Métropole` + 5 DOM-TOM (Guadeloupe, Martinique, Guyane, La Réunion, Mayotte)

**Fonctions** (10 tags, multi 1-5, ordre = priorité) :
1. Juridique
2. Technique
3. Économique *(strictement finance : aides, fiscalité, rentabilité, tarification)*
4. Administratif *(démarches externes : permis, OA, déclarations)*
5. Chantier
6. Comptabilité
7. **Développement** *(ex-Prospection — AO, concours, réseaux pro, acquisition clients)*
8. **Formation** *(NOUVEAU — école, MOOC, organisme, formation continue)*
9. **Gestion d'agence** *(ex-RH — élargi : RH + management + pilotage + orga interne)*
10. Santé mentale

**Renommages appliqués :**
- Prospection → Développement
- RH → Gestion d'agence (élargi)
- Ajout : Formation

**Cas particuliers :**
- CNOA → éclaté en 1 fiche National (siège Paris) + 13 fiches CROA Régional (préfectures de région)
- Option 3 (antennes pins secondaires via champ multi-coords) → backlog V3

## Points ouverts (à trancher en amont des prochaines sessions)

- [ ] Session 2 : choix rate limit chatbot (fichier JSON vs Redis)
- [ ] Session 3 : seuil email modération (N fiches en attente → envoi)
- [ ] Facteur CO2eq : confirmer `0.052 kg CO2/kWh` (RTE FR) ou utiliser valeur plus récente (ADEME 2024 ≈ 0.055)
- [ ] Nominatim policy : user-agent `NAV-V2/1.0 (contact@trans-former.fr)` → OK ?
- [ ] UX Session 2 : options échelle vides (Local) + onglet Outre-mer vide → afficher avec compteur "0" pour inviter à contribuer (cohérent esprit collaboratif)

## Enrichissement DOM-TOM (post V2)

Session d'enrichissement à lancer après déploiement V2 :
- Recherche ciblée par territoire (Guadeloupe, Martinique, Guyane, La Réunion, Mayotte)
- Sources : CROA locaux, maisons de l'archi outre-mer, réseaux pro insulaires
- Agent Sonnet-research 1-2h → complément seed

## Piste externe : team.archi

Contacter le fondateur de team.archi (forum entraide archi) pour :
- Lui présenter NAV V2 (esprit, périmètre)
- Demander si team.archi documente d'autres réseaux d'entraide qu'on pourrait intégrer
- Proposer un échange / listing mutuel

Brouillon email à préparer (requiert nom + email fondateur de Jules).

---

---

## 2026-04-14 — Session 2 : Front — Carte + Sidebar Filtres

**Exécutant :** Sonnet (agent)
**Durée :** ~1h

### Décisions prises

| Décision | Détail |
|----------|--------|
| Leaflet sans plugin Nuxt | `@nuxtjs/leaflet` a une compat instable avec Nuxt 3.15 — import dynamique direct dans `onMounted()` + `<ClientOnly>` wrapper. Plus fiable, zéro config SSR à gérer. |
| Cluster seuil 15 (spec dit 15+) | `disableClusteringAtZoom: 14` — au-delà de zoom 14 les pins se défiltrent, cohérent avec la granularité ville/rue |
| `@headlessui/vue` installé mais non utilisé pour le drawer | Le drawer implémenté en Vue natif (Teleport + transition) est plus léger et sans dépendance. `@headlessui/vue` reste disponible pour l'étape 3 (modales commentaires). |
| Seed JSON : Id fictif 1000+ | Pour éviter collision avec les IDs NocoDB réels (1-96+). Les URLs `/fiche/1000+` ne seront pas résolues en prod — comportement attendu en dev. |
| `moderation_status=approved` | Confirmé — retirer `published` du filtre comme résolu en Session 1 |
| Compteurs calculés sur orgs non filtrées | Les (0) montrent les options sans aucune fiche dans la base totale, pas dans la sélection courante. Plus honnête vis-à-vis de l'invitation à contribuer. |

### Composants créés

- `NavMap.vue` — Leaflet + OSM + clusters + pins personnalisés
- `EchelleFilter.vue` — chips exclusifs National/Régional/Local
- `FonctionFilter.vue` — multi-sélect 10 fonctions (max 5)
- `TerritoireToggle.vue` — Métropole + 5 DOM-TOM sous-onglets
- `NavSidebar.vue` — wrapper desktop
- `FilterDrawer.vue` — drawer mobile (Teleport + transition Vue native)

### Fichiers modifiés

- `assets/css/main.css` — tokens CSS palette NAV V2 + surcharges Leaflet/clusters
- `tailwind.config.js` — couleurs `nav.*` ajoutées
- `nuxt.config.ts` — optimizeDeps Leaflet pour Vite
- `server/routes/api/organisations.get.ts` — V2 champs + fallback seed JSON
- `pages/index.vue` — refonte complète layout + filtres + URL sync

### Commits Session 2

- `64f5b0a` — feat(deps): installer leaflet, markercluster, headless UI
- `dc849ef` — feat(style): palette NAV V2 — tokens CSS + tailwind
- `799d8fc` — feat(api): GET /api/organisations V2 avec fallback seed JSON
- `450a45c` — feat(components): carte Leaflet + sidebar filtres (étape 2)
- `3f486df` — feat(page): index.vue V2 — carte + sidebar + URL sync

### Validation build

- `npm run build` : ✓ sans erreur, 2.09 MB bundle

### Notes pour Sonnet 2 (étape 3 — fiche détail)

- `@headlessui/vue` installé et disponible si besoin pour la modale commentaires
- Interface `Org` définie dans `pages/index.vue` — à extraire dans `types/org.ts` si partagée (étape 3 en aura besoin)
- Route API existante : `GET /api/organisations/[id]` dans `server/routes/api/organisations/[id].get.ts` — fonctionne, utiliser tel quel
- Champ `description_enrichie` prévu mais absent du seed — prévoir fallback sur `description`
- Champ `points_cles` : chaîne ou JSON array ? Vérifier dans NocoDB avant d'afficher

### Notes pour Sonnet 3 (étape 6 — formulaire contribuer)

- Route `POST /api/organisations` existe déjà en V1 (`server/routes/api/organisations.post.ts`) — à adapter pour V2 (nouveaux champs + moderation_status: pending)
- Zod non encore installé — à ajouter dans package.json
- Rate limit : trancher JSON simple (recommandé pour MVP) vs Redis

### Points ouverts

- [ ] 8 anciens records V1 (IDs 1-8, moderation_status null) à purger en prod
- [ ] Vérifier type de `points_cles` dans NocoDB avant rendu fiche (string ou JSON)
- [ ] Tester carte sur VPS avec données NocoDB réelles (96 fiches)

---

---

## 2026-04-14 — Session 2 (suite) : Spec définitive — Top nav + chatbot + filtres

**Exécutant :** Sonnet 2/3  
**Durée :** ~1h

### Décisions prises

| Décision | Détail |
|----------|--------|
| `app.vue` = layout global | Refondu avec top nav (logo + TopSearchBar + Contribuer + Aléatoire). Supprime le header V1 (vert sage). NuxtPage prend le flex-1 restant. |
| Recherche top nav → URL `?q=` | TopSearchBar émet vers app.vue → router.replace ?q=. pages/index.vue watch route.query.q. Pas de prop passée via NuxtPage (non supporté simplement). |
| Sidebar sans recherche | Input recherche retiré de NavSidebar — redondant avec top nav. |
| Sidebar sans chatbot | Zone chatbot déplacée dans la zone carte (bas). |
| ChatbotPlaceholder sous carte | Input désactivé 52px, fond `--nav-bg`. Présent sous Métropole ET Outre-mer. |
| Échelle multi-select (string[]) | EchelleFilter + NavSidebar + FilterDrawer + pages/index.vue tous adaptés en `string[]`. Plus de `string \| null`. |
| Fiche aléatoire | ?random=1 dans l'URL → pages/index.vue redirige vers /fiche/[id] aléatoire. |
| shadcn | Écarté — Vue+Tailwind+CSS scoped suffit, zéro complexité d'intégration. |
| Bonus "ouvrir chatbot" | Skippé — pas de valeur avant S3. |

### Composants créés

- `TopSearchBar.vue` — barre recherche animée (compact 44px → 280px au focus), CSS scoped
- `ChatbotPlaceholder.vue` — zone bas carte, input désactivé, réserve espace S3

### Composants modifiés

- `app.vue` — refonte complète layout global (V1 sage vert → V2 bleu nuit)
- `pages/index.vue` — supprime header dupliqué, intègre ChatbotPlaceholder, échelle string[]
- `EchelleFilter.vue` — single-select → multi-select (string[])
- `NavSidebar.vue` — supprime input recherche + zone chatbot, prop echelle string[]
- `FilterDrawer.vue` — prop echelle string[], activeCount adapté

### Commits Session 2 (suite)

- `33fbd3b` — feat(nav): top nav global avec barre de recherche animée
- `1d5d9ab` — feat(ux): chatbot placeholder sous la carte + sidebar sans chatbot
- `905f338` — feat(filtres): échelle multi-select + sidebar sans recherche ni chatbot

### Validation build

- `npm run build` : ✓ sans erreur, 2.12 MB bundle

### Points en attente / non implémentés

- [ ] TerritoireTabs dans le drawer mobile — non dupliqué (à faire si besoin)
- [ ] Fiche aléatoire nécessite que les orgs soient chargées — si orgs vides au moment du ?random=1, pas de redirect. Acceptable pour MVP.

---

---

## 2026-04-14 — Session 2 (Sonnet 2) : Fiche détail + Commentaires

**Exécutant :** Sonnet 2 (agent NAV V2)
**Durée :** ~1h

### Décisions prises

| Décision | Détail |
|----------|--------|
| types/org.ts | Interface Org canonique extraite — suppression des 2 déclarations dupliquées dans index.vue et fiche/[id].vue |
| Route API dédiée | GET /api/fiche/[id] dans server/api/fiche/ (distinct de server/routes/api/organisations/[id]) — meilleure séparation des responsabilités |
| Table commentaires | commentTableId = COMMENT_TABLE_ID ?? AVIS_TABLE_ID (fallback table V1 si pas de table dédiée configurée) |
| Mistral Nemo timeout | 2s via AbortController — fallback safe_check: 'pending' si timeout ou clé absente |
| Retour filtres | sessionStorage nav_back_filters (pas de query param _back) — plus simple, pas de fuite dans URL partagée |
| mini-carte | Leaflet non-interactif dans FicheDetail — zoom:10, dragging:false, toutes interactions désactivées |
| points_cles | Tente JSON.parse d'abord, fallback découpage par lignes si format texte |
| Rate limit Redis | Posé par Sonnet 3 — server/utils/rateLimit.ts avec fallback mémoire si Redis KO |

### Composants créés

- `components/FicheDetail.vue` — affichage complet avec mini-carte Leaflet
- `components/CommentSection.vue` — liste commentaires publiés + refresh prop
- `components/CommentForm.vue` — formulaire soumission + gestion 429

### Routes API créées

- `server/api/fiche/[id].get.ts` — proxy NocoDB champs V2 complets
- `server/api/comment/index.post.ts` — filtre éthique Mistral Nemo (timeout 2s, fallback pending)
- `server/api/comment/[orgId].get.ts` — commentaires publiés triés chronologiquement

### Fichiers modifiés

- `pages/fiche/[id].vue` — refonte complète SSR (FicheDetail + CommentSection + CommentForm + SEO)
- `pages/index.vue` — ajout storeFiltersForBack() pour sessionStorage + import type Org
- `types/org.ts` — CRÉÉ : interface canonique V2
- `nuxt.config.ts` — ajout mistralApiKey + commentTableId

### Commits Session 2 (Sonnet 2)

- `a653336` — refactor(types): extraire interface Org canonique dans types/org.ts
- `89bd22a` — feat(api): GET /api/fiche/[id] + POST/GET /api/comment avec filtre Mistral Nemo
- `06c44cd` — feat(components): FicheDetail + CommentSection + CommentForm
- `420f534` — feat(page): /fiche/[id] SSR complète — FicheDetail + comments + SEO + retour filtres

### Validation build

- `npm run build` : ✓ sans erreur, 2.74 MB bundle

### Coordination Sonnet 3 (rate limit Redis)

**Posé par Sonnet 3 :** `server/utils/rateLimit.ts` (ioredis + fallback mémoire) importé dans POST /api/comment.
Sonnet 3 a modifié `server/api/comment/index.post.ts` pour brancher `checkRateLimit(ip, 'comment', 5)`.
Configuration : `REDIS_URL` dans `.env`, fallback mémoire si Redis KO (dev sans Docker).

### Points ouverts pour Session 3

- [ ] `public/og-default.png` à créer (logo par défaut pour og:image) — actuellement référencé, pas encore créé
- [ ] `COMMENT_TABLE_ID` à ajouter dans `.env` VPS si table dédiée à part de `AVIS_TABLE_ID`
- [ ] `MISTRAL_API_KEY` à vérifier dans `/opt/nav-carte/.env` — la clé est dans le .env VPS (Session 1), juste s'assurer du nom de variable exact
- [ ] Vérifier type de `points_cles` dans NocoDB (JSON array stringifié ou texte brut ?)
- [ ] Tester sur VPS avec données NocoDB réelles (96 fiches seed)

---

## 2026-04-14 — Session 2 (parallèle) : Étape 6 — Formulaire `/contribuer` + Redis rate limit

**Exécutant :** Sonnet 3 (agent)

### Redis VPS

- `redis-server` absent au départ (pas mentionné dans VPS-check.md)
- Installé : `apt-get install redis-server` → `systemctl enable + start` ✓
- Bind : `127.0.0.1 -::1` uniquement (localhost, sécurisé)
- Test : `redis-cli ping` → PONG ✓
- **En prod :** ajouter `REDIS_URL=redis://127.0.0.1:6379` dans `/opt/nav-carte/.env`
- **En dev local :** fallback compteur en mémoire (ioredis lazyConnect — pas de crash si Redis absent)

### Fichiers produits

| Fichier | Description |
|---------|-------------|
| `server/utils/rateLimit.ts` | Helper Redis générique — `checkRateLimit(ip, action, maxPerDay)` avec fallback mémoire |
| `server/api/submit/index.post.ts` | POST /api/submit — Zod + Nominatim + NocoDB pending + rate limit 3/IP/j |
| `server/api/comment/index.post.ts` | Rate limit Redis 5/IP/j ajouté en tête (base Sonnet 2) |
| `pages/contribuer.vue` | Page dédiée — 8 champs, validation Zod client+serveur, 422/429, succès + trackingUrl |

### Décisions

| Décision | Détail |
|----------|--------|
| Page vs modal | Page dédiée `/contribuer` — plus simple pour MVP. Route duale desktop (redirect ?contribute=1 + modale) en backlog V2.1 |
| description_user | K-prompt (50-500) > E-spec (20-200) — tranché : 50-500 chars |
| Champ ville | Optionnel (K-prompt) — moins de friction, fallback fiche sans coords prévu |
| NOCODB_BASE_ID | Valeur fallback `p_nav_v2` dans le code. À confirmer : `ssh vps-hetzner "grep -i base /opt/nav-carte/.env"` |

### Rate limits posés (Redis)

- `/api/submit` : **3 soumissions / IP / jour**
- `/api/comment` : **5 commentaires / IP / jour**

### Commits

- `d9b6a31` — feat(deps): ajouter zod + ioredis + REDIS_URL runtime config
- `e81625f` — feat(server): helper rate limit Redis avec fallback mémoire
- `5c24c06` — feat(api): POST /api/submit — validation Zod + geocoding + NocoDB pending
- `fc0c52c` — feat(page): /contribuer — formulaire V2 Zod client + UX mobile-first
- (rate limit /api/comment dans commit Sonnet 2 `420f534`)

### Build

- `npm run build` : ✓ sans erreur, 2.74 MB bundle

### TODO avant prod

- [ ] `REDIS_URL=redis://127.0.0.1:6379` → `/opt/nav-carte/.env` (VPS)
- [ ] Confirmer `NOCODB_BASE_ID` : `ssh vps-hetzner "grep -i base /opt/nav-carte/.env"`
- [ ] Tester submit valide → fiche `pending` dans NocoDB
- [ ] Tester 4ème submit → vérifier HTTP 429

---

## 2026-04-14 — Session 2 (Étape 2) : Mobile UX

**Exécutant :** Sonnet 1.8 (agent NAV V2 Mobile)
**Durée :** ~1h

### Décisions prises

| Décision | Détail |
|----------|--------|
| FilterDrawer supprimé | L'ancien drawer filtres (bouton flottant gauche, slide depuis gauche) est supprimé. Les filtres sont désormais inline dans le flow mobile. |
| ChatbotSheet nouveau composant | `ChatbotSheet.vue` — bottom sheet plein écran, Teleport + transition slide-up, `92dvh`, input désactivé (S3), fermeture backdrop + bouton Retour. |
| Carte mobile 45dvh | `height: 45dvh` sur mobile, `min-height: 180px`. `dvh` pour éviter le bug clavier mobile. |
| Tagging compact inline | Bandeau entre carte et liste : échelle 3 checkboxes `16px` avec labels courts (Nat/Rég/Loc) + fonctions scroll horizontal `overflow-x: auto`. |
| Tap card → centre carte | `onSelectOrgMobile` → `selectedId` change → `NavMap.vue` réagit via `watch selectedId → mapInstance.panTo`. |
| Bouton chatbot flottant | `56×56px`, `bottom: 1.5rem; right: 1rem`, `opacity: 0.88`, `z-[1000]`, `lg:hidden`. |
| Multi-Leaflet Outre-mer | Grille 5 mini-cartes existante conservée — build clean, à tester en conditions réelles. |
| Poignée draggable | Skippé — estimé > 30 min, noté pour Session 3. |
| Interface Org | Sonnet 2 a extrait `types/org.ts`, linter auto-appliqué l'import dans `pages/index.vue`. |

### Composants créés

- `ChatbotSheet.vue` — bottom sheet chatbot plein écran (92dvh, slide-up, backdrop, poignée visuelle, input désactivé)

### Composants supprimés

- `FilterDrawer.vue` — drawer filtres mobile (remplacé par tagging inline + ChatbotSheet)

### Fichiers modifiés

- `pages/index.vue` — refonte complète zone mobile + bouton chatbot flottant + ChatbotSheet

### Commits Session 2 (Mobile)

- `d39e7be` — feat(mobile): ChatbotSheet — bottom sheet plein écran avec animation slide-up
- `0843301` — feat(mobile): supprimer FilterDrawer — remplacé par tagging inline + ChatbotSheet
- `pages/index.vue` — inclus dans refacto Sonnet 2 (`a653336` → import `types/org.ts`)

### Validation build

- `npm run build` : ✓ sans erreur, 2.12 MB bundle

### Backlog mobile S3

- [ ] Poignée draggable entre carte et liste (drag resize)
- [ ] Multi-Leaflet Outre-mer mobile à tester en conditions réelles → fallback dropdown si trop lourd
- [ ] Animation léger zoom pin au tap card (spec F)
- [ ] Chatbot IA branché (Session 3)

---

---

## 2026-04-14 — Session S2 Ajustements finaux v2 (correctif branding + polish)

**Exécutant :** Sonnet 1.9b (agent AEP V2)

### Contexte

L'agent précédent avait commis une erreur de spec sur le renommage : "NAV" avait été remplacé par "Écosystème Architecture" dans les textes visibles. La bonne règle est : "NAV" (texte visible) → "AEP" (Architecture d'Écologie Politique).

### Corrections branding (commit fix)

| Fichier | Avant | Après |
|---------|-------|-------|
| `app.vue` logo icône | `N` | `A` |
| `app.vue` logo texte | `Écosystème Archi.` | `AEP` |
| `components/ChatbotSheet.vue` | `aria-label="Assistant Écosystème Architecture"` | `aria-label="Assistant AEP"` |
| `pages/index.vue` SEO title | `Écosystème Architecture — Cartographie AEP` | `AEP — Cartographie de l'écologie politique architecturale` |
| `pages/contribuer.vue` SEO title | `Proposer une ressource — Écosystème Architecture` | `Proposer une ressource — AEP` |
| `pages/ajouter.vue` SEO title | `Proposer une fiche — Écosystème Architecture` | `Proposer une fiche — AEP` |
| `pages/fiche/[id].vue` og:description fallback | `Fiche organisation — NAV Architectes` | `Fiche organisation — AEP` |
| `pages/fiche/[id].vue` SEO title | `{nom} — NAV` | `{nom} — AEP` |
| `pages/fiche/[id].vue` og:title | `{nom} — NAV Architectes` | `{nom} — AEP` |

### Ajustements complémentaires

- Bouton flottant mobile : icône seule → pill avec texte "Chatbot" visible (48px h, gap-2, font-weight 600)

### État des 4 ajustements spec

| # | Ajustement | État |
|---|-----------|------|
| 1 | Échelle inline 1 ligne | ✓ Fait par agent précédent (`EchelleFilter.vue` `flex-wrap gap-x-4`) |
| 2 | NAV → AEP (textes visibles) | ✓ Corrigé dans ce commit |
| 3 | Mobile search au-dessus liste | ✓ Fait par agent précédent (lignes 167-203 `pages/index.vue`) |
| 4 | Bouton mobile "Chatbot" | ✓ Fait dans ce commit (pill avec label visible) |

### Build

- `npm run build` : ✓ sans erreur, 2.74 MB bundle

---

## 2026-04-14 — Session 3 : Chatbot IA (Étape 5bis)

**Pilote :** Opus
**Exécutant :** agent Sonnet S3
**Durée :** ~1h

### Réalisé

**ChatbotSheet.vue (mobile) — refactorisé :**
- Conversation IA complète : messages user/assistant, scroll auto, loading dots
- Message onboarding exact (texte E §6) affiché avant la première question
- Bulles fiches recommandées : card compacte avec lien `/fiche/[id]` + explication
- Erreurs typées : 429 (rate limit), 503 (budget épuisé), fallback générique
- Emit `highlightOrgs` pour highlight carte
- Animations slide-up + `prefers-reduced-motion` respecté

**ChatbotPlaceholder.vue (desktop) — refactorisé :**
- Même conversation IA que le mobile, format panneau latéral expand/collapse
- Même onboarding, mêmes bulles fiches, même gestion d'erreurs
- Input en bas du panneau étendu, Enter pour envoyer

**server/api/chatbot/index.post.ts — créé :**
- Rate limit : `checkRateLimit(ip, 'chatbot', 10)` via helper Redis S2 existant
- Circuit breaker : lecture cumul `stats_usage` mois courant, 503 si ≥ 20€
- Fetch top-20 fiches NocoDB (`moderation_status=approved`) avec scoring keyword
- Contexte JSON compact injecté dans le prompt système Mistral Small
- Appel `mistral-small-latest` (temperature: 0.3, max_tokens: 600, json_object)
- Parse JSON → `{ reponse_texte, fiches_recommandees }`
- Log `stats_usage` (fire and forget)

### Décisions

| Décision | Détail |
|----------|--------|
| Rate limit helper | Réutilisation du helper Redis S2 (`checkRateLimit`) — plus robuste que JSON fichier /tmp. Comportement identique (10 req/j). |
| `STATS_TABLE_ID` env | Valeur par défaut `mbbq7n47ixy19mc` (créé en S1) — override via env si besoin |
| Scoring fiches | Keyword match sur nom + description + tags — suffisant pour MVP, pas de vector search |
| `prefers-reduced-motion` | Animations supprimées si l'utilisateur a activé ce préfé navigateur |

### Build

- `npm run build` : ✓ sans erreur, 2.78 MB bundle

### Commits Session 3 (étape 5bis)

- feat(chatbot): ChatbotSheet mobile + ChatbotPlaceholder desktop — conversation IA branchée
- feat(api): POST /api/chatbot — Mistral Small + rate limit + circuit breaker

### TODO avant prod

- [ ] Vérifier `STATS_TABLE_ID` dans `/opt/nav-carte/.env` (valeur par défaut : `mbbq7n47ixy19mc`)
- [ ] Tester 2-3 requêtes réelles sur VPS avec fiches NocoDB
- [ ] Vérifier index.vue passe bien `highlightOrgs` au NavMap depuis ChatbotSheet et ChatbotPlaceholder
- [ ] Tester mobile iOS Safari + Android Chrome

---

---

## 2026-04-14 — Session 3 (Étapes 4-5) : Worker IA + Test pipeline

**Exécutant :** Sonnet (agent)
**Durée :** ~2h

### Réalisé

**Étape 4 — Worker enrichissement IA :**
- `worker/enrich.js` créé (Node.js ESM, systemd timer 5 min)
- Pipeline complet : fetch pending → scrape crawl4ai → Mistral Nemo → update NocoDB → log stats_usage
- Circuit breaker budget 20€ (filtre JS, car NocoDB v0.301.5 rejette les filtres datetime)
- Email Jules via Resend si seuil 5 fiches pending en modération
- Lock anti-overlap via `/tmp/nav-worker.lock`
- Retry 2x sur erreur Mistral + flag `ai_error` si 3 échecs

**Infrastructure :**
- `worker/package.json` + `node_modules/dotenv` installés
- Variables RESEND_API_KEY, EMAIL_JULES, BUDGET_MAX_EUR, WORKER_LIMIT ajoutées au `.env`
- `nav-worker.service` + `nav-worker.timer` systemd créés et activés

**Étape 5 — Test pipeline sur 3 fiches :**
- 3 fiches injectées en NocoDB (CNOA Id=106, Archireport Id=107, Collectif Fil Id=108)
- Checkpoint 1 fiche (CNOA) : €0.000029, extrapolé 96 fiches = €0.0028 → GO
- 3 fiches enrichies avec succès

### Métriques pipeline

| Fiche | tokens_in | tokens_out | cout_eur | Temps | Confiance |
|-------|-----------|------------|----------|-------|-----------|
| CNOA | 1 248 | 167 | €0.000029 | 3.0s | haute |
| Archireport | 4 376 | 261 | €0.000091 | 3.9s | haute |
| Collectif Fil | 2 628 | 221 | €0.000057 | 4.3s | haute |
| **Total** | **8 252** | **649** | **€0.000177** | **11.2s** | — |

Extrapolation 96 fiches : **€0.0057** (budget 20€ = 3 500× la consommation réelle)

### Problèmes résolus

| Problème | Solution |
|---------|---------|
| Playwright absent → crawl4ai crash | `AsyncHTTPCrawlerStrategy` (mode statique) |
| NocoDB rejette filtres datetime | Filtre JS sur tous les records stats_usage |
| Apostrophe U+0027 dans tags refusée | U+2019 (typographique) partout dans VALID_FONCTIONS |
| import dynamique ESM incompatible | spawnSync importé statiquement |

### Décisions prises en autonomie

| Décision | Raison |
|---------|--------|
| `AsyncHTTPCrawlerStrategy` au lieu d'`AsyncWebCrawler` standard | Playwright non installé sur VPS, mode statique suffisant pour sites archi |
| Filtre budget JS (pas NocoDB) | API NocoDB 0.301.5 ne supporte pas les filtres de date en mode gte |
| `spawnSync` pour appel Python | Évite les complications d'import dynamique en ESM |

### Fichiers produits

- `/opt/nav-carte/worker/enrich.js` — Worker IA principal
- `/opt/nav-carte/worker/package.json` — Dépendances (dotenv)
- `/etc/systemd/system/nav-worker.service` — Service oneshot
- `/etc/systemd/system/nav-worker.timer` — Timer 5 min
- `nav-carte/PIPE-IA-DOC.md` — Documentation complète pipeline + résultats

### TODO avant deploy prod (Étape 9)

- [ ] Chatbot (Étape 5bis) — non implémenté dans cette session
- [ ] Bandeau bas + Liberapay (Étape 7) — non implémenté
- [ ] Page /a-propos (Étape 8) — non implémenté
- [ ] Deploy git sur VPS + build Nuxt production
- [ ] Purger 8 anciens records V1 (IDs 1-8, moderation_status null) avant prod
- [ ] Tester worker sur soumission réelle via /contribuer
- [ ] Vérifier que les 3 fiches test (Ids 106-108) sont modérées ou purgées avant prod (sont en mode test)

---

---

## Session 3b — Deploy final AEP (2026-04-14 soir)

**Durée :** ~3h · **Résultat :** AEP V2 live sur `aep.trans-former.fr` + `nav.trans-former.fr` (alias)

### Dispatch

| # | Action | Modèle | Status |
|---|--------|--------|--------|
| A | Prompt système chatbot Mistral Small | Opus + Jules | ✓ |
| B | Composant `BandeauBas.vue` + endpoint `/api/stats` | Sonnet | ✓ |
| C | Page `/a-propos` (brouillon — texte à réécrire par Jules) | Sonnet | ✓ |
| D | Cron purge `/tmp/nav-ratelimit/` (systemd timer quotidien 03:00 UTC) | Sonnet | ✓ |
| E | Enrichissement rétro 96 fiches (worker IA Mistral Nemo) | Sonnet | ✓ |
| F | DNS OVH + Caddy alias + build + deploy + tests HTTPS | Opus + Jules | ✓ |

### Décisions tranchées

| Décision | Choix | Raison |
|----------|-------|--------|
| Domaine V2 | `aep.trans-former.fr` nouveau + alias `nav.*` | Pas de V1 figée réelle à préserver : le VPS servait déjà la V2 |
| Structure Caddy | Alias simple (2 domaines → même service `:3333`) | Éviter 2 instances Node pour un code identique |
| Prompt chatbot | "AEP — Écosystème Entraide", posture engagée, règle hors-scope | Cohérent avec positionnement AEP vs terminologie NAV résiduelle |
| Rate limit chatbot | JSON SHA-256 (RGPD) — Redis retiré | Volume borné par circuit breaker, pas besoin de Redis |
| Enrichissement rétro | Bulk patch `pending` → worker → bulk approve API | Spot-check qualité accepté, tags à corriger en modération manuelle |

### Commits

```
74c9722 feat(aep-s3b): bandeau transparence + /a-propos + cron purge rate-limit
68e1e53 fix(chatbot): purge version Redis + prompt système AEP
```

### Enrichissement IA — bilan qualité

- **Coût réel** : €0.006 pour 96 fiches (×3 300 sous le seuil €20/mois)
- **Descriptions** : factuellement correctes (spot-check 10 fiches OK)
- **Tags** : 6/10 vides sur Maisons de l'Architecture (mapping ne matche pas "expositions/conférences"), 1 sur-tagging MAOP Id 11 (10/10 tags — site généraliste scraped), MAF Id 15 manque "Juridique"
- **Action Jules** : correction manuelle tags dans NocoDB UI (non bloquant pour deploy)

### Découverte imprévue — bug `deploy.sh`

Incohérence entre `deploy.sh` (rsync vers `/opt/nav-carte/`) et `nav-carte.service` (exec `/opt/nav-carte/.output/server/index.mjs`). Le `deploy.sh` écrit au mauvais endroit — le service tourne sur `.output/` qui n'est jamais mis à jour par le script. Contournement cette session : tar + ssh extract manuel dans `.output/`. **À patcher en V3** : aligner `deploy.sh` sur la structure `.output/`.

### État à la clôture

```
✓ aep.trans-former.fr — HTTPS 200 (/, /a-propos, /api/stats)
✓ nav.trans-former.fr — alias OK
✓ 99 fiches approved (96 enrichies + 3 S3a)
✓ Bandeau bas + chatbot + lien À propos intégrés
✓ Cron purge rate-limit actif (prochaine exécution 2026-04-15 03:00 UTC)
✓ V1 Redis chatbot purgée
```

### TODO post-session (Jules, async)

- [ ] Réécrire le texte de `pages/a-propos.vue` (placeholders `<!-- TODO Jules -->` en tête de chaque section)
- [ ] Corriger tags Maisons de l'Architecture + MAOP + MAF dans NocoDB UI
- [ ] Tests manuels : submit `/contribuer`, chatbot mobile (iOS + Android), feedback UX
- [ ] Patcher `deploy.sh` pour cibler `/opt/nav-carte/.output/` (voir découverte ci-dessus)
- [ ] Vérifier widget Liberapay à `liberapay.com/trans-former.fr` — compte existe ?

---

## Backlog V3 (hors scope V2)

### Infra / deploy
- **Fix `deploy.sh`** — cible `/opt/nav-carte/.output/` pas `/opt/nav-carte/` (incohérence découverte en S3b)
- **Migration `/opt/nav-carte/` → `/opt/aep/`** — alignement nom projet (dette terminologique NAV)
- **Rebrand service systemd** `nav-carte.service` → `aep.service` (low-priority)
- **Monitoring** — sonde Uptime Kuma (`status.trans-former.fr`) : ajouter `aep.*/api/stats`
- **Backup NocoDB** — dump quotidien base `pipilvsi7dibo80` vers stockage externe

### Produit / UX
- **Tags auto** — améliorer le mapping worker pour matcher "expositions/conférences/culture" → Développement + Formation (évite tags vides sur MA)
- **Modération UI custom** — interface dédiée pour batch approve/reject (au lieu de cliquer 96 rows)
- **Sidebar "Fiches récemment ajoutées"** — boost engagement
- **Recherche sémantique chatbot** — passer de keyword match à embeddings (Mistral Embed, volume à estimer)
- **Page `/transparence` publique** — détail coûts, CO2, donateurs Liberapay

### Éditorial
- **Contenu `/a-propos`** — texte politique écrit par Jules seul (hors scope IA)
- **Badge IA souveraine** — vérifier formulation (Hetzner = Falkenstein DE, pas FR — dire "Hébergé en Europe" ?)
- **Page Contribuer — modération visible** — expliquer pipeline "formulaire → worker IA → modération humaine"

### Monétisation / association
- **Bascule Liberapay → HelloAsso** quand ASO créée (scénario 2 du doc `C-systeme-dons.md`)
- **Widget Liberapay "total collecté"** — actuellement juste CTA, ajouter feedback

### Technique
- **Caching API organisations** — actuellement re-fetch NocoDB à chaque render
- **Full-text search côté client** — Fuse.js sur descriptions enrichies
- **Mode offline / PWA** — manifest + service worker pour usage terrain