feat(collab): v4.9.0 Collaboration - commentaires inline, mentions @, notifications in-app + email

ROADMAP.md

@@ -312,12 +312,22 @@ Détails livrés :
 - [x] **Bouton « + » à droite** — ajoute une colonne à droite (équivalent « Add column »).
 - [x] **Redimensionnement des colonnes** — curseur `col-resize` au survol des bordures d'en-tête, drag = largeur ; persisté via `colsW`.
 
-### v4.9.0 — Collaboration
-- [ ] **Inline comments** — commentaires sur sélection de texte
-- [ ] **@mentions** — notifier un utilisateur → page/commentaire
-- [ ] **Email notifications** — changements, mentions
+### v4.9.0 — Collaboration ✅ (2026-09-04)
+> **Objectif** : commentaires inline, mentions @, notifications in-app + email. **COMPLETED**.
+> **Doc** : [`docs/Guide_Complet_Notion_sharing_collaborartion.md`](docs/Guide_Complet_Notion_sharing_collaborartion.md)
 
-### v4.10.0 — FlowDeck Agent (Agent IA natif)
+- [x] **Inline comments** — commentaires sur sélection de texte dans l'éditeur (bouton flottant 💬) ; table `comments` étendue (`target_type`/`target_id`/`anchor_block_id`/`anchor_start`/`anchor_end`) et migrée (FK générique, idempotente) ; panneau de commentaires + résolution/suppression + compteur topbar
+- [x] **@mentions** — autocomplétion `@` (recherche utilisateurs temps réel), insertion `@login` dans les blocs et commentaires, table `notifications` ; endpoint `POST /api/pages/{id}/mentions` (notif des mentions de contenu)
+- [x] **Email notifications** — service SMTP (`app/services/mailer.py` + templates HTML) ; préférences email par utilisateur (comments/mentions) ; config `.env` (`SMTP_*`, `APP_BASE_URL`) ; repli no-op sans SMTP
+- [x] **Centre de notifications in-app** — cloche topbar (badge non-lus, polling 30s), panneau déroulant, mark as read / mark all read
+- [x] **Settings** — toggles réels dans Settings → Notifications (Commentaires / Mentions)
+- [x] **208 tests passent** (+9 v4.9.0)
+
+### v4.10.0 — FlowDeck Agent (Agent IA natif) ⬜ (0 % implémenté)
+
+> ⚠️ **État actuel** : documentation de design complète (`docs/Flowdeck_Agent_integration.md`),
+> mais **aucun code** : pas de `routers/agent.py`, `services/agent_engine.py`, `llm_client.py`,
+> `tool_registry.py`, `context_builder.py`, ni aucune table `agent_*`.
 
 **Objectif :** Un agent IA intégré à FlowDeck, capable de planifier, rechercher et **agir** directement sur les workspaces — collections, pages, propriétés, vues, issues Gitea. Inspiré de Notion Agent (2026).
 
@@ -392,32 +402,42 @@ app/
 - Budget tokens max par conversation (500k tokens)
 - Timeout 5 minutes par run
 
-### v5.0.0 — Command Palette & Recherche
-- [ ] **Command palette** — Ctrl+K / Ctrl+P recherche universelle
+### v5.0.0 — Command Palette & Recherche ⬜ (stub uniquement)
+> ⚠️ **État actuel** : `Ctrl+K` appelle `openQuickFind()` dans `base.html` qui n'affiche qu'un
+> toast « Quick Find — Ctrl+K ». Le raccourci est déjà câblé, la palette elle-même n'existe pas.
+
+- [ ] **Command palette** — Ctrl+K / Ctrl+P recherche universelle (modale, fuzzy, navigation clavier)
 - [ ] **Quick actions** — navigation, création, commandes
+- [ ] **Recherche full-text** — SQLite FTS5 sur pages + propriétés (prérequis technique de la palette)
 
-### v5.1.0 — Automations
-- [ ] **Database automations** — if-this-then-that
-- [ ] **Buttons** — cliquables déclenchant actions
+### v5.1.0 — Automations ⬜ (non commencé)
 
-### v5.2.0 — Infrastructure & Polish
-> **Objectif** : Qualité de code, design system, backup, CI/CD.
-> **Items issus de l'ancien docs/ROADMAP.md (v3.0)**
+> 💡 Note : les **webhooks sortants** (`webhook_subscriptions`, CRUD `/workspace/webhooks`,
+> `services/webhook_outbound.py`) sont déjà implémentés — bonne base pour les actions automation.
+
+- [ ] **Database automations** — moteur de règles if-this-then-that (trigger + condition + action)
+- [ ] **Buttons** — boutons cliquables déclenchant des actions
+
+### v5.2.0 — Infrastructure & Polish ⬜ (à prioriser)
+> ⚠️ **Priorité recommandée n°1** : les **migrations versionnées** d'abord — la base compte
+> déjà 30+ tables créées ad-hoc ; ajouter agent/automations sans versioning va créer une dette ingérable.
+> **État actuel** : API publique + tokens **partiellement implémentés** (`routers/public_api.py`,
+> test `test_public_api_token`) — à compléter dans la section Sécurité.
 
 **Design system**
 - [ ] **Design tokens** — `design-tokens.css` (couleurs, espacements, typographie unifiés)
 - [ ] **Composants réutilisables** — boutons, inputs, modales, dropdowns, toasts
 
 **Sécurité & Utilisateur**
-- [ ] **API Tokens** — générer/révoquer des clés API utilisateur
+- [ ] **API Tokens** — générer/révoquer des clés API utilisateur *(PARTIEL : `public_api.py` + tokens existent, manque la gestion UI dans Settings)*
 - [ ] **Sessions actives** — voir et révoquer les sessions
 - [ ] **Onboarding wizard** — `/welcome` au premier lancement (créer compte → lier forges → premier projet)
 
 **Infrastructure**
-- [ ] **Migrations versionnées** — Alembic ou table `schema_version`
+- [ ] **🥇 Migrations versionnées** — Alembic ou table `schema_version` *(URGENT avant v4.10/v5.x)*
 - [ ] **Backup automatique** — cron daily → fichier daté
 - [ ] **Index manquants** — `users.email`, `forge_connections.user_id`
-- [ ] **Linting** — ruff (Python), eslint (JS)
+- [ ] **Linting** — ruff (Python), eslint (JS) *(aucune config actuellement)*
 - [ ] **Tests parallèles** — pytest-xdist
 - [ ] **Build Docker multi-stage** — optimiser taille d'image
 
@@ -432,10 +452,17 @@ app/
 - [ ] Tests des adapters forge (mock HTTP)
 - [ ] Tests multi-user (permissions croisées)
 
-### v5.3.0 — Database Avancée
-- [ ] Inline databases dans n'importe quelle page
-- [ ] Templates de database (Project tracker, CRM…)
-- [ ] Validation des propriétés (required, unique, min/max)
+### v5.3.0 — Database Avancée ⬜ (partiel)
+- [ ] **Inline databases dans n'importe quelle page** *(PARTIEL : API `POST /db/inline/api` existe depuis v4.1.0 ; manque l'insertion via slash command `/database` + bloc rendu dans l'éditeur)*
+- [ ] **Templates de database prédéfinis** (CRM, Project tracker…) — galerie au clic « New database » *(templates de pages existent, pas de galerie DB)*
+- [ ] **Validation des propriétés** (required, unique, min/max) — côté serveur + messages UI
+
+### v5.4.0 — Expérience éditeur (nouveautés, parité Notion)
+- [ ] **Backlinks** — section « Lié depuis… » en bas de page (scan des liens internes)
+- [ ] **Duplicates** — « Duplicate » sur page + collection (menu `...`)
+- [ ] **Corbeille globale améliorée** — vue cross-workspace + purge automatique après 30 jours
+- [ ] **Historique de version UI** — browser + restaurer une version (table `page_history` existe)
+- [ ] **Import** — Markdown/CSV/Notion (complète l'export v4.7.0, facilite la migration d'utilisateurs)
 
 ---
 
@@ -445,12 +472,31 @@ app/
 - [ ] **SSO/SAML** — enterprise authentication
 - [ ] **Granular permissions** — page-level, property-level access control
 - [ ] **Web Clipper** — extension navigateur
-- [ ] **API publique** — REST API + webhooks documentés
+- [ ] **API publique complète** — REST API documentée (OpenAPI) *(base existante : `public_api.py`, à étendre + documenter)*
 - [ ] **Realtime editing** — WebSocket, curseurs multi-utilisateurs
 - [ ] **Synced blocks** — bloc synchronisé entre plusieurs pages
 
 ---
 
+## ✅ Fonctionnalités livrées hors roadmap (bonus détectés dans le code)
+
+| Feature | Fichiers | Note |
+|---------|----------|------|
+| Webhooks sortants | `services/webhook_outbound.py`, `routers/workspace.py` (`/workspace/webhooks`) | CRUD + dispatch d'événements — base pour automations/API publique |
+| API publique + tokens | `routers/public.py` / `public_api.py`, test `test_public_api_token` | À formaliser dans v5.2.0 et documenter pour v6.0.0 |
+
+---
+
+## 🎯 Ordre de priorité recommandé (état 2026-09)
+
+1. **v5.2.0 → Migrations versionnées** (bloquant pour tout le reste)
+2. **v4.9.0 → Collaboration ✅** (comments + mentions + notifications) — livré 2026-09-04
+3. **v5.0.0 → Command palette + FTS5** — le raccourci Ctrl+K est déjà câblé, petit effort / gros impact
+4. **v5.3.0 → Inline databases dans pages** — API serveur prête, uniquement travail éditeur
+5. **v4.10.0 → Agent IA** — gros chantier, démarrer Phase 1 (engine + 3 outils) une fois 1–4 livrés
+
+---
+
 ## Résumé des phases
 
 ```
@@ -460,8 +506,8 @@ Base + Kanban         Éditeur + Gitea      UX Pro          MVP          Onboard
 + UI Notion           + Tags + Admin                       + Sharing    COMPLETED
                       + GitHub OAuth                       + Library
 
-v4.0.2 ✅    v4.1.0 ✅    v4.2.0 ✅    v4.3.0 ✅    v4.4.0 ✅    v4.5.0 ✅    v4.6.0 ✅    v4.7.0 ✅    v4.8.0 ✅    v4.9–4.10 ⬜   v5.x–v6.0 ⬜
-Quality     Data Sources  Templates +  10 Views     Tasks &      Sprints &     Content      Export       Bloc Table    Collab +      Pro + Agent
-& Tests     & Linked DB   Dashboards   complets     Dependencies  My Tasks     Blocks       MD/PDF/HTML  simple        Agent IA      (futur)
+v4.0.2 ✅    v4.1.0 ✅    v4.2.0 ✅    v4.3.0 ✅    v4.4.0 ✅    v4.5.0 ✅    v4.6.0 ✅    v4.7.0 ✅    v4.8.0 ✅    v4.9.0 ✅    v4.10 ⬜   v5.x–v6.0 ⬜
+Quality     Data Sources  Templates +  10 Views     Tasks &      Sprints &     Content      Export       Bloc Table    Collaboration  Agent IA    Pro + Agent
+& Tests     & Linked DB   Dashboards   complets     Dependencies  My Tasks     Blocks       MD/PDF/HTML  simple        (comments@)    (futur)      (futur)
 
-*Dernière mise à jour: 2026-09-03 — v4.8.1 Bloc Tableau : + Row / + Col / redimensionnement ✅*
+*Dernière mise à jour: 2026-09-04 — Audit complet : statuts réels v4.9–v5.3, bonus détectés (webhooks sortants, API publique), nouvelles v5.4.0 (backlinks, duplicates, corbeille, import), ordre de priorité recommandé*