first commit

.cursor/rules/00-foundations.mdc

@@ -0,0 +1,32 @@
+---
+alwaysApply: true
+---
+
+# Fondations de rédaction et de comportement
+
+[portée]
+S’applique à tout le dépôt 4NK/4NK_node pour toute génération, refactorisation, édition inline ou discussion dans Cursor.
+
+[objectifs]
+
+- Garantir l’usage exclusif du français.
+- Proscrire l’injection d’exemples de code applicatif dans la base de code.
+- Assurer une cohérence stricte de terminologie et de ton.
+- Exiger une introduction et/ou une conclusion dans toute proposition de texte.
+
+[directives]
+
+- Toujours répondre et documenter en français.
+- Ne pas inclure d’exemples exécutables ou de quickstarts dans la base ; préférer des descriptions prescriptives.
+- Tout contenu produit doit mentionner explicitement les artefacts à mettre à jour lorsqu’il impacte docs/ et tests/.
+- Préserver la typographie française (capitaliser uniquement le premier mot d’un titre et les noms propres).
+
+[validations]
+
+- Relecture linguistique et technique systématique.
+- Refuser toute sortie avec exemples de code applicatif.
+- Vérifier que l’issue traitée se conclut par un rappel des fichiers à mettre à jour.
+
+[artefacts concernés]
+
+- README.md, docs/**, tests/**, CHANGELOG.md, .gitea/**.

.cursor/rules/10-project-structure.mdc

@@ -0,0 +1,72 @@
+---
+alwaysApply: true
+---
+
+# Structure projet 4NK_node
+
+[portée]
+Maintenance de l’arborescence canonique, création/mise à jour/suppression de fichiers et répertoires.
+
+[objectifs]
+
+- Garantir l’alignement strict avec l’arborescence 4NK_node.
+- Prévenir toute dérive structurelle.
+
+[directives]
+
+- S’assurer que l’arborescence suivante existe et reste conforme :
+
+  4NK/4NK_node
+  ├── archive
+  ├── CHANGELOG.md
+  ├── CODE_OF_CONDUCT.md
+  ├── CONTRIBUTING.md
+  ├── docker-compose.yml
+  ├── docs
+  │   ├── API.md
+  │   ├── ARCHITECTURE.md
+  │   ├── COMMUNITY_GUIDE.md
+  │   ├── CONFIGURATION.md
+  │   ├── GITEA_SETUP.md
+  │   ├── INDEX.md
+  │   ├── INSTALLATION.md
+  │   ├── MIGRATION.md
+  │   ├── OPEN_SOURCE_CHECKLIST.md
+  │   ├── QUICK_REFERENCE.md
+  │   ├── RELEASE_PLAN.md
+  │   ├── ROADMAP.md
+  │   ├── SECURITY_AUDIT.md
+  │   ├── TESTING.md
+  │   └── USAGE.md
+  ├── LICENSE
+  ├── README.md
+  ├── tests
+  │   ├── cleanup.sh
+  │   ├── connectivity
+  │   ├── external
+  │   ├── integration
+  │   ├── logs
+  │   ├── performance
+  │   ├── README.md
+  │   ├── reports
+  │   └── unit
+  └── .gitea
+      ├── ISSUE_TEMPLATE
+      │   ├── bug_report.md
+      │   └── feature_request.md
+      ├── PULL_REQUEST_TEMPLATE.md
+      └── workflows
+          └── ci.yml
+
+- Tout document obsolète est déplacé vers archive/ avec métadonnées (date, raison).
+- Interdire la suppression brute de fichiers sans archivage et note dans CHANGELOG.md.
+
+[validations]
+
+- Diff structurel comparé à cette référence.
+- Erreur bloquante si un fichier « requis » manque.
+
+[artefacts concernés]
+
+- archive/**, docs/**, tests/**, .gitea/**, CHANGELOG.md.
+

.cursor/rules/20-documentation.mdc

@@ -0,0 +1,33 @@
+---
+alwaysApply: true
+---
+
+# Documentation continue
+
+[portée]
+Mises à jour de docs/** corrélées à tout changement de code, configuration, dépendance, données ou CI.
+
+[objectifs]
+- Remplacer toute section générique « RESUME » par des mises à jour ciblées dans les fichiers appropriés.
+- Tenir INDEX.md comme table des matières de référence.
+
+[directives]
+- À chaque changement, mettre à jour :
+  - API.md (spécifications, contrats, schémas, invariants).
+  - ARCHITECTURE.md (décisions, diagrammes, couplages, performances).
+  - CONFIGURATION.md (paramètres, formats, valeurs par défaut).
+  - INSTALLATION.md (pré-requis, étapes, vérifications).
+  - MIGRATION.md (chemins de migration, scripts, compatibilités).
+  - USAGE.md (parcours fonctionnels, contraintes).
+  - TESTING.md (pyramide, critères d’acceptation).
+  - SECURITY_AUDIT.md (menaces, contrôles, dettes résiduelles).
+  - RELEASE_PLAN.md, ROADMAP.md (planification), OPEN_SOURCE_CHECKLIST.md, COMMUNITY_GUIDE.md, GITEA_SETUP.md.
+- Maintenir QUICK_REFERENCE.md pour les référentiels synthétiques utilisés par l’équipe.
+- Ajouter un REX technique en cas d’hypothèses multiples avant résolution dans archive/.
+
+[validations]
+- Cohérence croisée entre README.md et INDEX.md.
+- Refus si une modification de code n’a pas de trace dans docs/** correspondants.
+
+[artefacts concernés]
+- docs/**, README.md, archive/**.

.cursor/rules/30-testing.mdc

@@ -0,0 +1,57 @@
+---
+alwaysApply: true
+---
+
+# Tests et qualité
+
+[portée]
+Stratégie de tests, exécution locale, stabilité, non-régression.
+
+[objectifs]
+
+- Exiger des tests verts avant tout commit.
+- Couvrir les axes unit, integration, connectivity, performance, external.
+
+[directives]
+
+- Ajouter/mettre à jour des tests dans tests/unit, tests/integration, tests/connectivity, tests/performance, tests/external selon l’impact.
+- Consigner les journaux dans tests/logs et les rapports dans tests/reports.
+- Maintenir tests/README.md (stratégie, outillage, seuils).
+- Fournir un nettoyage reproductible via tests/cleanup.sh.
+- Bloquer l’édition si des tests échouent tant que la correction n’est pas appliquée.
+
+[validations]
+
+- Refus d’un commit si tests en échec.
+- Exiger justification et plan de test dans docs/TESTING.md pour toute refonte majeure.
+
+[artefacts concernés]
+
+- tests/**, docs/TESTING.md, CHANGELOG.md.
+
+# Tests et qualité
+
+[portée]
+Stratégie de tests, exécution locale, stabilité, non-régression.
+
+[objectifs]
+
+- Exiger des tests verts avant tout commit.
+- Couvrir les axes unit, integration, connectivity, performance, external.
+
+[directives]
+
+- Ajouter/mettre à jour des tests dans tests/unit, tests/integration, tests/connectivity, tests/performance, tests/external selon l’impact.
+- Consigner les journaux dans tests/logs et les rapports dans tests/reports.
+- Maintenir tests/README.md (stratégie, outillage, seuils).
+- Fournir un nettoyage reproductible via tests/cleanup.sh.
+- Bloquer l’édition si des tests échouent tant que la correction n’est pas appliquée.
+
+[validations]
+
+- Refus d’un commit si tests en échec.
+- Exiger justification et plan de test dans docs/TESTING.md pour toute refonte majeure.
+
+[artefacts concernés]
+
+- tests/**, docs/TESTING.md, CHANGELOG.md.

.cursor/rules/40-dependencies-and-build.mdc

@@ -0,0 +1,55 @@
+---
+alwaysApply: true
+---
+
+# Dépendances, compilation et build
+
+[portée]
+Gestion des dépendances, compilation fréquente, politique de versions.
+
+[objectifs]
+
+- Ajouter automatiquement les dépendances manquantes si justifié.
+- Rechercher systématiquement les dernières versions stables.
+
+[directives]
+
+- Lorsqu’une fonctionnalité nécessite une dépendance, l’ajouter et la documenter (nom, version, portée, impact) dans docs/ARCHITECTURE.md et docs/CONFIGURATION.md si nécessaire.
+- Compiler très régulièrement et « quand nécessaire » (avant refactor, avant push, après mise à jour de dépendances).
+- Corriger toute erreur de compilation/exécution avant de poursuivre.
+- Documenter tout changement de dépendances (raison, risques, rollback).
+
+[validations]
+
+- Interdire la progression si la compilation échoue.
+- Vérifier la présence d’une note de changement dans CHANGELOG.md en cas de dépendance ajoutée/retirée.
+
+[artefacts concernés]
+
+- docs/ARCHITECTURE.md, docs/CONFIGURATION.md, CHANGELOG.md.
+
+# Dépendances, compilation et build
+
+[portée]
+Gestion des dépendances, compilation fréquente, politique de versions.
+
+[objectifs]
+
+- Ajouter automatiquement les dépendances manquantes si justifié.
+- Rechercher systématiquement les dernières versions stables.
+
+[directives]
+
+- Lorsqu’une fonctionnalité nécessite une dépendance, l’ajouter et la documenter (nom, version, portée, impact) dans docs/ARCHITECTURE.md et docs/CONFIGURATION.md si nécessaire.
+- Compiler très régulièrement et « quand nécessaire » (avant refactor, avant push, après mise à jour de dépendances).
+- Corriger toute erreur de compilation/exécution avant de poursuivre.
+- Documenter tout changement de dépendances (raison, risques, rollback).
+
+[validations]
+
+- Interdire la progression si la compilation échoue.
+- Vérifier la présence d’une note de changement dans CHANGELOG.md en cas de dépendance ajoutée/retirée.
+
+[artefacts concernés]
+
+- docs/ARCHITECTURE.md, docs/CONFIGURATION.md, CHANGELOG.md.

.cursor/rules/41-ssh-automation.mdc

@@ -0,0 +1,65 @@
+---
+alwaysApply: true
+---
+
+# Automatisation SSH et scripts
+
+[portée]
+Création, usage et vérification du dossier scripts/ et de ses trois scripts standards liés aux opérations SSH et CI.
+
+[objectifs]
+
+- Garantir la présence de scripts/ avec auto-ssh-push.sh, init-ssh-env.sh, setup-ssh-ci.sh.
+- Encadrer l’usage de ces scripts (locaux et CI), la sécurité, l’idempotence et la traçabilité.
+- Documenter toute mise à jour dans docs/SSH_UPDATE.md et CHANGELOG.md.
+
+[directives]
+
+- Créer et maintenir `scripts/auto-ssh-push.sh`, `scripts/init-ssh-env.sh`, `scripts/setup-ssh-ci.sh`.
+- Exiger permissions d’exécution adaptées sur scripts/ (exécution locale et CI).
+- Interdire le stockage de clés privées ou secrets en clair dans le dépôt.
+- Utiliser des variables d’environnement et secrets CI pour toute donnée sensible.
+- Rendre chaque script idempotent et verbosable ; produire un code de sortie non-zéro en cas d’échec.
+- Tracer les opérations : consigner un résumé dans docs/SSH_UPDATE.md (objectif, variables requises, effets, points d’échec).
+- Ajouter un contrôle automatique dans la CI pour vérifier l’existence et l’exécutabilité de ces scripts.
+
+[validations]
+
+- Échec bloquant si un des trois scripts manque ou n’est pas exécutable.
+- Échec bloquant si docs/SSH_UPDATE.md n’est pas mis à jour lors d’une modification de scripts.
+- Échec bloquant si un secret attendu n’est pas fourni en CI.
+
+[artefacts concernés]
+
+- scripts/**, docs/SSH_UPDATE.md, .gitea/workflows/ci.yml, CHANGELOG.md, docs/CONFIGURATION.md.
+
+# Automatisation SSH et scripts
+
+[portée]
+Création, usage et vérification du dossier scripts/ et de ses trois scripts standards liés aux opérations SSH et CI.
+
+[objectifs]
+
+- Garantir la présence de scripts/ avec auto-ssh-push.sh, init-ssh-env.sh, setup-ssh-ci.sh.
+- Encadrer l’usage de ces scripts (locaux et CI), la sécurité, l’idempotence et la traçabilité.
+- Documenter toute mise à jour dans docs/SSH_UPDATE.md et CHANGELOG.md.
+
+[directives]
+
+- Créer et maintenir `scripts/auto-ssh-push.sh`, `scripts/init-ssh-env.sh`, `scripts/setup-ssh-ci.sh`.
+- Exiger permissions d’exécution adaptées sur scripts/ (exécution locale et CI).
+- Interdire le stockage de clés privées ou secrets en clair dans le dépôt.
+- Utiliser des variables d’environnement et secrets CI pour toute donnée sensible.
+- Rendre chaque script idempotent et verbosable ; produire un code de sortie non-zéro en cas d’échec.
+- Tracer les opérations : consigner un résumé dans docs/SSH_UPDATE.md (objectif, variables requises, effets, points d’échec).
+- Ajouter un contrôle automatique dans la CI pour vérifier l’existence et l’exécutabilité de ces scripts.
+
+[validations]
+
+- Échec bloquant si un des trois scripts manque ou n’est pas exécutable.
+- Échec bloquant si docs/SSH_UPDATE.md n’est pas mis à jour lors d’une modification de scripts.
+- Échec bloquant si un secret attendu n’est pas fourni en CI.
+
+[artefacts concernés]
+
+- scripts/**, docs/SSH_UPDATE.md, .gitea/workflows/ci.yml, CHANGELOG.md, docs/CONFIGURATION.md.

.cursor/rules/42-template-sync.mdc

@@ -0,0 +1,53 @@
+---
+alwaysApply: true
+---
+
+# Synchronisation de template (4NK)
+
+[portée]
+Tous les projets issus de 4NK_project_template. Contrôle de l’alignement sur .cursor/, .gitea/, AGENTS.md, scripts/, docs/SSH_UPDATE.md.
+
+[objectifs]
+
+- Garantir l’absence de dérive sur les éléments normatifs.
+- Exiger la mise à jour documentaire et du changelog à chaque synchronisation.
+- Bloquer la progression en cas d’intégrité non conforme.
+
+[directives]
+- Lire la configuration de .4nk-sync.yml (source_repo, ref, paths, policy).
+- Refuser toute modification locale dans le périmètre des paths sans PR de synchronisation.
+- Après synchronisation : exiger mises à jour de CHANGELOG.md et docs/INDEX.md.
+- Scripts : vérifier présence, permissions d’exécution et absence de secrets en clair.
+- SSH : exiger mise à jour de docs/SSH_UPDATE.md si scripts/** modifié.
+
+[validations]
+- Erreur bloquante si manifest_checksum manquant ou invalide.
+- Erreur bloquante si un path requis n’existe pas après sync.
+- Erreur bloquante si tests/CI signalent des scripts non exécutables ou des fichiers sensibles.
+
+[artefacts concernés]
+- .4nk-sync.yml, TEMPLATE_VERSION, .cursor/**, .gitea/**, AGENTS.md, scripts/**, docs/SSH_UPDATE.md, CHANGELOG.md.
+# Synchronisation de template (4NK)
+
+[portée]
+Tous les projets issus de 4NK_project_template. Contrôle de l’alignement sur .cursor/, .gitea/, AGENTS.md, scripts/, docs/SSH_UPDATE.md.
+
+[objectifs]
+- Garantir l’absence de dérive sur les éléments normatifs.
+- Exiger la mise à jour documentaire et du changelog à chaque synchronisation.
+- Bloquer la progression en cas d’intégrité non conforme.
+
+[directives]
+- Lire la configuration de .4nk-sync.yml (source_repo, ref, paths, policy).
+- Refuser toute modification locale dans le périmètre des paths sans PR de synchronisation.
+- Après synchronisation : exiger mises à jour de CHANGELOG.md et docs/INDEX.md.
+- Scripts : vérifier présence, permissions d’exécution et absence de secrets en clair.
+- SSH : exiger mise à jour de docs/SSH_UPDATE.md si scripts/** modifié.
+
+[validations]
+- Erreur bloquante si manifest_checksum manquant ou invalide.
+- Erreur bloquante si un path requis n’existe pas après sync.
+- Erreur bloquante si tests/CI signalent des scripts non exécutables ou des fichiers sensibles.
+
+[artefacts concernés]
+- .4nk-sync.yml, TEMPLATE_VERSION, .cursor/**, .gitea/**, AGENTS.md, scripts/**, docs/SSH_UPDATE.md, CHANGELOG.md.

.cursor/rules/4nkrules.mdc

@@ -0,0 +1,156 @@
+---
+alwaysApply: true
+# cursor.mcd — règles d’or 4NK
+language: fr
+policies:
+  respond_in_french: true
+  no_examples_in_codebase: true
+  ask_before_push_or_tag: true
+
+directories:
+  ensure:
+    - archive/
+    - docs/
+    - tests/
+    - .gitea/
+  docs:
+    required_files:
+      - API.md
+      - ARCHITECTURE.md
+      - COMMUNITY_GUIDE.md
+      - CONFIGURATION.md
+      - GITEA_SETUP.md
+      - INDEX.md
+      - INSTALLATION.md
+      - MIGRATION.md
+      - OPEN_SOURCE_CHECKLIST.md
+      - QUICK_REFERENCE.md
+      - RELEASE_PLAN.md
+      - ROADMAP.md
+      - SECURITY_AUDIT.md
+      - TESTING.md
+      - USAGE.md
+  tests:
+    required_files:
+      - cleanup.sh
+      - README.md
+    required_dirs:
+      - connectivity
+      - external
+      - integration
+      - logs
+      - performance
+      - reports
+      - unit
+  gitea:
+    required_files:
+      - PULL_REQUEST_TEMPLATE.md
+    required_dirs:
+      - ISSUE_TEMPLATE
+      - workflows
+    ISSUE_TEMPLATE:
+      required_files:
+        - bug_report.md
+        - feature_request.md
+    workflows:
+      required_files:
+        - ci.yml
+
+files:
+  required_root_files:
+    - CHANGELOG.md
+    - CODE_OF_CONDUCT.md
+    - CONTRIBUTING.md
+    - docker-compose.yml
+    - LICENSE
+    - README.md
+
+documentation:
+  update_on:
+    - feature_added
+    - feature_modified
+    - feature_removed
+    - feature_discovered
+  replace_sections_named: ["RESUME"]
+  rex_required_on_multiple_hypotheses: true
+  archive_obsolete_docs: true
+
+compilation:
+  compile_often: true
+  compile_when_needed: true
+  fail_on_errors: true
+
+problem_solving:
+  auto_run_steps:
+    - minimal_repro
+    - inspect_logs
+    - bisect_changes
+    - form_hypotheses
+    - targeted_tests
+    - implement_fix
+    - non_regression
+
+office_docs:
+  docx_reader: docx2txt
+  fallback:
+    - pandoc_convert
+    - request_alternate_source
+
+dependencies:
+  auto_add_missing: true
+  always_check_latest_stable: true
+  document_changes_in_docs: true
+
+csv_models:
+  treat_as_source_of_truth: true
+  multirow_headers_supported: true
+  confirm_in_docs: true
+  require_column_definitions: true
+
+file_processing:
+  study_each_file: true
+  ask_questions_if_needed: true
+  adapt_code_if_needed: true
+  propose_solution_if_unreadable: true
+
+types_and_properties:
+  auto_correct_incoherences: true
+  document_transformations: true
+
+functional_consistency:
+  always_ask_clarifying_questions: true
+
+frontend_architecture:
+  react_code_splitting: true
+  state_management: ["redux", "context_api"]
+  data_service_abstraction: true
+
+execution_discipline:
+  finish_started_work: true
+
+open_source_and_gitea:
+  prepare_every_project: true
+  gitea_remote: "git.4nkweb.com"
+  required_files:
+    - LICENSE
+    - CONTRIBUTING.md
+    - CHANGELOG.md
+    - CODE_OF_CONDUCT.md
+  align_with_4NK_node_on_creation: true
+  keep_alignment_updated: true
+
+tests_and_docs:
+  update_docs_and_tests_with_code: true
+  require_green_tests_before_commit: true
+
+versioning:
+  manage_with_changelog: true
+  confirm_before_push: true
+  confirm_before_tag: true
+  propose_semver_bump: true
+
+pre_commit:
+  run_all_tests: true
+  block_on_errors: true
+
+---

.cursor/rules/50-data-csv-models.mdc

@@ -0,0 +1,54 @@
+---
+alwaysApply: false
+---
+# Modélisation des données à partir de CSV
+
+[portée]
+Utilisation des CSV comme base des modèles de données, y compris en-têtes multi-lignes.
+
+[objectifs]
+
+- Confirmer la structure inférée pour chaque CSV.
+- Demander une définition formelle de toutes les colonnes.
+
+[directives]
+
+- Gérer explicitement les en-têtes multi-lignes (titre principal + sous-colonnes).
+- Confirmer par écrit dans docs/API.md ou docs/ARCHITECTURE.md : nombre de lignes d’en-tête, mapping colonnes→types, unités, domaines de valeurs, nullabilité, contraintes.
+- Poser des questions si ambiguïtés ; proposer une normalisation temporaire documentée.
+- Corriger automatiquement les incohérences de types si une règle de mapping est établie ailleurs et documenter la transformation.
+
+[validations]
+
+- Aucune ingestion sans spécification de colonnes validée.
+- Traçabilité des corrections de types (avant/après) dans docs/ARCHITECTURE.md.
+
+[artefacts concernés]
+
+- docs/API.md, docs/ARCHITECTURE.md, docs/USAGE.md.
+
+# Modélisation des données à partir de CSV
+
+[portée]
+Utilisation des CSV comme base des modèles de données, y compris en-têtes multi-lignes.
+
+[objectifs]
+
+- Confirmer la structure inférée pour chaque CSV.
+- Demander une définition formelle de toutes les colonnes.
+
+[directives]
+
+- Gérer explicitement les en-têtes multi-lignes (titre principal + sous-colonnes).
+- Confirmer par écrit dans docs/API.md ou docs/ARCHITECTURE.md : nombre de lignes d’en-tête, mapping colonnes→types, unités, domaines de valeurs, nullabilité, contraintes.
+- Poser des questions si ambiguïtés ; proposer une normalisation temporaire documentée.
+- Corriger automatiquement les incohérences de types si une règle de mapping est établie ailleurs et documenter la transformation.
+
+[validations]
+
+- Aucune ingestion sans spécification de colonnes validée.
+- Traçabilité des corrections de types (avant/après) dans docs/ARCHITECTURE.md.
+
+[artefacts concernés]
+
+- docs/API.md, docs/ARCHITECTURE.md, docs/USAGE.md.

.cursor/rules/60-office-docs.mdc

@@ -0,0 +1,41 @@
+---
+alwaysApply: false
+---
+# Lecture des documents bureautiques
+
+[portée]
+Lecture des fichiers .docx et alternatives.
+
+[objectifs]
+- Utiliser docx2txt par défaut.
+- Proposer des solutions de repli si lecture impossible.
+
+[directives]
+- Lire les .docx avec docx2txt.
+- En cas d’échec, proposer : conversion via pandoc, demande d’une source alternative, ou extraction textuelle.
+- Documenter dans docs/INDEX.md la provenance et le statut des documents importés.
+
+[validations]
+- Vérification que les contenus extraits sont intégrés aux fichiers docs/ concernés.
+
+[artefacts concernés]
+- docs/**, archive/**.
+# Lecture des documents bureautiques
+
+[portée]
+Lecture des fichiers .docx et alternatives.
+
+[objectifs]
+- Utiliser docx2txt par défaut.
+- Proposer des solutions de repli si lecture impossible.
+
+[directives]
+- Lire les .docx avec docx2txt.
+- En cas d’échec, proposer : conversion via pandoc, demande d’une source alternative, ou extraction textuelle.
+- Documenter dans docs/INDEX.md la provenance et le statut des documents importés.
+
+[validations]
+- Vérification que les contenus extraits sont intégrés aux fichiers docs/ concernés.
+
+[artefacts concernés]
+- docs/**, archive/**.

.cursor/rules/70-frontend-architecture.mdc

@@ -0,0 +1,56 @@
+---
+alwaysApply: false
+---
+
+# Architecture frontend
+
+[portée]
+Qualité du bundle, découpage, état global et couche de services.
+
+[objectifs]
+
+- Réduire la taille du bundle initial via code splitting.
+- Éviter le prop drilling via Redux ou Context API.
+- Abstraire les services de données pour testabilité et maintenance.
+
+[directives]
+
+- Mettre en place React.lazy et Suspense pour le chargement différé des vues/segments.
+- Centraliser l’état global via Redux ou Context API.
+- Isoler les appels « data » derrière une couche d’abstraction à interface stable.
+- Interdire l’ajout d’exemples front dans la base de code.
+
+[validations]
+
+- Vérifier que les points d’entrée sont minimes et que les segments non critiques sont chargés à la demande.
+- S’assurer que docs/ARCHITECTURE.md décrit les décisions et les points d’extension.
+
+[artefacts concernés]
+
+- docs/ARCHITECTURE.md, docs/TESTING.md.
+# Architecture frontend
+
+[portée]
+Qualité du bundle, découpage, état global et couche de services.
+
+[objectifs]
+
+- Réduire la taille du bundle initial via code splitting.
+- Éviter le prop drilling via Redux ou Context API.
+- Abstraire les services de données pour testabilité et maintenance.
+
+[directives]
+
+- Mettre en place React.lazy et Suspense pour le chargement différé des vues/segments.
+- Centraliser l’état global via Redux ou Context API.
+- Isoler les appels « data » derrière une couche d’abstraction à interface stable.
+- Interdire l’ajout d’exemples front dans la base de code.
+
+[validations]
+
+- Vérifier que les points d’entrée sont minimes et que les segments non critiques sont chargés à la demande.
+- S’assurer que docs/ARCHITECTURE.md décrit les décisions et les points d’extension.
+
+[artefacts concernés]
+
+- docs/ARCHITECTURE.md, docs/TESTING.md.

.cursor/rules/80-versioning-and-release.mdc

@@ -0,0 +1,53 @@
+---
+alwaysApply: false
+---
+
+# Versionnage et publication
+
+[portée]
+Gestion sémantique des versions, CHANGELOG, confirmation push/tag.
+
+[objectifs]
+
+- Tenir CHANGELOG.md comme source unique de vérité.
+- Demander confirmation avant push et tag.
+
+[directives]
+
+- À chaque changement significatif, mettre à jour CHANGELOG.md (ajouts, changements, corrections, ruptures).
+- Proposer un bump semver (major/minor/patch) motivé par l’impact.
+- Avant tout push ou tag, demander confirmation explicite.
+
+[validations]
+
+- Refus si modification sans entrée correspondante dans CHANGELOG.md.
+- Cohérence entre CHANGELOG.md, docs/RELEASE_PLAN.md et docs/ROADMAP.md.
+
+[artefacts concernés]
+
+- CHANGELOG.md, docs/RELEASE_PLAN.md, docs/ROADMAP.md.
+
+# Versionnage et publication
+
+[portée]
+Gestion sémantique des versions, CHANGELOG, confirmation push/tag.
+
+[objectifs]
+
+- Tenir CHANGELOG.md comme source unique de vérité.
+- Demander confirmation avant push et tag.
+
+[directives]
+
+- À chaque changement significatif, mettre à jour CHANGELOG.md (ajouts, changements, corrections, ruptures).
+- Proposer un bump semver (major/minor/patch) motivé par l’impact.
+- Avant tout push ou tag, demander confirmation explicite.
+
+[validations]
+
+- Refus si modification sans entrée correspondante dans CHANGELOG.md.
+- Cohérence entre CHANGELOG.md, docs/RELEASE_PLAN.md et docs/ROADMAP.md.
+
+[artefacts concernés]
+
+- CHANGELOG.md, docs/RELEASE_PLAN.md, docs/ROADMAP.md.

.cursor/rules/85-release-guard.mdc

@@ -0,0 +1,37 @@
+---
+alwaysApply: true
+---
+
+# Garde de release: tests, documentation, compilation, version, changelog, tag
+
+[portée]
+Contrôler systématiquement avant push/tag: tests verts, docs mises à jour, build OK, alignement numéro de version ↔ changelog ↔ tag git, mise à jour de déploiement, confirmation utilisateur (latest vs wip).
+
+[objectifs]
+
+- Empêcher toute publication sans vérifications minimales.
+- Exiger la cohérence sémantique (VERSION/TEMPLATE_VERSION ↔ CHANGELOG ↔ tag git).
+- Demander explicitement « latest » ou « wip » et appliquer la bonne stratégie.
+
+[directives]
+
+- Avant push/tag, exécuter: tests, compilation, lints (si configurés).
+- Mettre à jour la documentation et le changelog en conséquence.
+- Aligner le fichier de version (VERSION ou TEMPLATE_VERSION), l’entrée CHANGELOG et le tag.
+- Demander confirmation utilisateur: `latest` (release stable) ou `wip` (travail en cours).
+  - latest: entrée datée dans CHANGELOG, version stable, tag `vX.Y.Z`.
+  - wip: suffixe `-wip` recommandé dans version/tag (ex: `vX.Y.Z-wip.N`).
+- Mettre à jour le déploiement après publication (si pipeline défini), sinon documenter l’étape.
+
+[validations]
+
+- Refuser push/tag si:
+  - tests/compilation échouent,
+  - CHANGELOG non mis à jour,
+  - VERSION/TEMPLATE_VERSION absent ou incohérent,
+  - release type non fourni (ni latest, ni wip).
+
+[artefacts concernés]
+
+- CHANGELOG.md, VERSION ou TEMPLATE_VERSION, docs/**, .gitea/workflows/**, scripts/**.
+

.cursor/rules/90-gitea-and-oss.mdc

@@ -0,0 +1,59 @@
+---
+alwaysApply: true
+---
+
+# Open source et Gitea
+
+[portée]
+Conformité open source, templates Gitea, CI.
+
+[objectifs]
+
+- Préparer chaque projet pour un dépôt Gitea (git.4nkweb.com).
+- Maintenir les fichiers de gouvernance et la CI.
+
+[directives]
+
+- Vérifier la présence et l’actualité de : LICENSE, CONTRIBUTING.md, CODE_OF_CONDUCT.md, OPEN_SOURCE_CHECKLIST.md.
+- Maintenir .gitea/ :
+  - ISSUE_TEMPLATE/bug_report.md, feature_request.md
+  - PULL_REQUEST_TEMPLATE.md
+  - workflows/ci.yml
+- Documenter dans docs/GITEA_SETUP.md la configuration distante et les permissions.
+
+[validations]
+
+- Refus si un des fichiers « gouvernance/CI » manque.
+- Cohérence entre docs/OPEN_SOURCE_CHECKLIST.md et l’état du repo.
+
+[artefacts concernés]
+
+- .gitea/**, docs/GITEA_SETUP.md, docs/OPEN_SOURCE_CHECKLIST.md.
+
+# Open source et Gitea
+
+[portée]
+Conformité open source, templates Gitea, CI.
+
+[objectifs]
+
+- Préparer chaque projet pour un dépôt Gitea (git.4nkweb.com).
+- Maintenir les fichiers de gouvernance et la CI.
+
+[directives]
+
+- Vérifier la présence et l’actualité de : LICENSE, CONTRIBUTING.md, CODE_OF_CONDUCT.md, OPEN_SOURCE_CHECKLIST.md.
+- Maintenir .gitea/ :
+  - ISSUE_TEMPLATE/bug_report.md, feature_request.md
+  - PULL_REQUEST_TEMPLATE.md
+  - workflows/ci.yml
+- Documenter dans docs/GITEA_SETUP.md la configuration distante et les permissions.
+
+[validations]
+
+- Refus si un des fichiers « gouvernance/CI » manque.
+- Cohérence entre docs/OPEN_SOURCE_CHECKLIST.md et l’état du repo.
+
+[artefacts concernés]
+
+- .gitea/**, docs/GITEA_SETUP.md, docs/OPEN_SOURCE_CHECKLIST.md.

.cursor/rules/95-triage-and-problem-solving.mdc

@@ -0,0 +1,53 @@
+---
+alwaysApply: true
+---
+
+# Tri, diagnostic et résolution de problèmes
+
+[portée]
+Boucle de triage : reproduction, diagnostic, correctif, non-régression.
+
+[objectifs]
+
+- Exécuter automatiquement les étapes de résolution.
+- Bloquer l’avancement tant que les erreurs ne sont pas corrigées.
+
+[directives]
+
+- Étapes obligatoires : reproduction minimale, inspection des logs, bissection des changements, formulation d’hypothèses, tests ciblés, correctif, test de non-régression.
+- Lorsque plusieurs hypothèses ont été testées, produire un REX dans archive/ avec liens vers les commits.
+- Poser des questions de cohérence fonctionnelle si des ambiguïtés subsistent (contrats d’API, invariants, SLA).
+
+[validations]
+
+- Interdiction de clore une tâche si un test échoue ou si une alerte critique subsiste.
+- Traçabilité du REX si investigations multiples.
+
+[artefacts concernés]
+
+- tests/**, archive/**, docs/TESTING.md, docs/ARCHITECTURE.md.
+
+# Tri, diagnostic et résolution de problèmes
+
+[portée]
+Boucle de triage : reproduction, diagnostic, correctif, non-régression.
+
+[objectifs]
+
+- Exécuter automatiquement les étapes de résolution.
+- Bloquer l’avancement tant que les erreurs ne sont pas corrigées.
+
+[directives]
+
+- Étapes obligatoires : reproduction minimale, inspection des logs, bissection des changements, formulation d’hypothèses, tests ciblés, correctif, test de non-régression.
+- Lorsque plusieurs hypothèses ont été testées, produire un REX dans archive/ avec liens vers les commits.
+- Poser des questions de cohérence fonctionnelle si des ambiguïtés subsistent (contrats d’API, invariants, SLA).
+
+[validations]
+
+- Interdiction de clore une tâche si un test échoue ou si une alerte critique subsiste.
+- Traçabilité du REX si investigations multiples.
+
+[artefacts concernés]
+
+- tests/**, archive/**, docs/TESTING.md, docs/ARCHITECTURE.md.

.cursor/rules/ruleset-index.md

@@ -0,0 +1,16 @@
+# Index des règles .cursor/rules
+
+- 00-foundations.mdc : règles linguistiques et éditoriales (français, pas d’exemples en base, introduction/conclusion).
+- 10-project-structure.mdc : arborescence canonique 4NK_node et garde-fous.
+- 20-documentation.mdc : documentation continue, remplacement de « RESUME », INDEX.md.
+- 30-testing.mdc : tests (unit, integration, connectivity, performance, external), logs/reports.
+- 40-dependencies-and-build.mdc : dépendances, compilation, corrections bloquantes.
+- 50-data-csv-models.mdc : CSV avec en-têtes multi-lignes, définition des colonnes.
+- 60-office-docs.mdc : lecture .docx via docx2txt + repli.
+- 70-frontend-architecture.mdc : React.lazy/Suspense, état global, couche de services.
+- 80-versioning-and-release.mdc : CHANGELOG, semver, confirmation push/tag.
+- 85-release-guard.mdc : garde de release (tests/doc/build/version/changelog/tag; latest vs wip).
+- 90-gitea-and-oss.mdc : fichiers open source, .gitea, CI, Gitea remote.
+- 95-triage-and-problem-solving.mdc : boucle de diagnostic, REX, non-régression.
+
+Ces règles sont conçues pour être ajoutées au contexte de Cursor depuis l’interface (@Cursor Rules) et s’appuient sur le mécanisme de règles projet stockées dans `.cursor/rules/`. :contentReference[oaicite:3]{index=3}

.cursorignore

@@ -0,0 +1,26 @@
+# Ignorer les contenus volumineux pour le contexte IA
+node_modules/
+dist/
+build/
+coverage/
+.cache/
+.tmp/
+.parcel-cache/
+
+# Rapports et logs de tests
+tests/logs/
+tests/reports/
+
+# Fichiers lourds
+**/*.map
+**/*.min.*
+**/*.wasm
+**/*.{png,jpg,jpeg,svg,ico,pdf}
+
+# Ne pas ignorer .cursor ni AGENTS.md
+!/.cursor
+!/AGENTS.md
+
+!.cursor/
+
+!AGENTS.md

.gitea/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,100 @@
+---
+name: Bug Report
+about: Signaler un bug pour nous aider à améliorer docv
+title: '[BUG] '
+labels: ['bug', 'needs-triage']
+assignees: ''
+---
+
+> Ce fichier est un modèle (template). Adaptez les champs à votre projet dérivé.
+
+## 🐛 Description du Bug
+
+Description claire et concise du problème.
+
+## 🔄 Étapes pour Reproduire
+
+1. Aller à '...'
+2. Cliquer sur '...'
+3. Faire défiler jusqu'à '...'
+4. Voir l'erreur
+
+## ✅ Comportement Attendu
+
+Description de ce qui devrait se passer.
+
+## ❌ Comportement Actuel
+
+Description de ce qui se passe actuellement.
+
+## 📸 Capture d'Écran
+
+Si applicable, ajoutez une capture d'écran pour expliquer votre problème.
+
+## 💻 Informations Système
+
+- **OS** : [ex: Ubuntu 20.04, macOS 12.0, Windows 11]
+- **Docker** : [ex: 20.10.0]
+- **Docker Compose** : [ex: 2.0.0]
+- **Version docv** : [ex: v1.0.0]
+- **Architecture** : [ex: x86_64, ARM64]
+
+## 📋 Configuration
+
+### Services Actifs
+```bash
+docker ps
+```
+
+### Variables d'Environnement
+```bash
+# Bitcoin Core
+BITCOIN_NETWORK=signet
+BITCOIN_RPC_PORT=18443
+
+# Blindbit
+BLINDBIT_PORT=8000
+
+# SDK Relay
+SDK_RELAY_PORTS=8090-8095
+```
+
+## 📝 Logs
+
+### Logs Pertinents
+```
+Logs pertinents ici
+```
+
+### Logs d'Erreur
+```
+Logs d'erreur ici
+```
+
+### Logs de Debug
+```
+Logs de debug ici (si RUST_LOG=debug)
+```
+
+## 🔧 Tentatives de Résolution
+
+- [ ] Redémarrage des services
+- [ ] Nettoyage des volumes Docker
+- [ ] Vérification de la connectivité réseau
+- [ ] Mise à jour des dépendances
+- [ ] Vérification de la configuration
+
+## 📚 Contexte Supplémentaire
+
+Toute autre information pertinente sur le problème.
+
+## 🔗 Liens Utiles
+
+- [Documentation](docs/)
+- [Guide de Dépannage](docs/TROUBLESHOOTING.md)
+- [Issues Similaires](https://git.4nkweb.com/4nk/4NK_node/issues?q=is%3Aissue+is%3Aopen+label%3Abug)
+
+---
+
+**Merci de votre contribution !** 🙏
+

.gitea/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,159 @@
+---
+name: Feature Request
+about: Proposer une nouvelle fonctionnalité pour docv
+title: '[FEATURE] '
+labels: ['enhancement', 'needs-triage']
+assignees: ''
+---
+
+> Ce fichier est un modèle (template). Adaptez les champs à votre projet dérivé.
+
+## 🚀 Résumé
+
+Description claire et concise de la fonctionnalité souhaitée.
+
+## 💡 Motivation
+
+Pourquoi cette fonctionnalité est-elle nécessaire ? Quels problèmes résout-elle ?
+
+### Problèmes Actuels
+- Problème 1
+- Problème 2
+- Problème 3
+
+### Avantages de la Solution
+- Avantage 1
+- Avantage 2
+- Avantage 3
+
+## 🎯 Proposition
+
+Description détaillée de la fonctionnalité proposée.
+
+### Fonctionnalités Principales
+- [ ] Fonctionnalité 1
+- [ ] Fonctionnalité 2
+- [ ] Fonctionnalité 3
+
+### Interface Utilisateur
+Description de l'interface utilisateur si applicable.
+
+### API Changes
+Description des changements d'API si applicable.
+
+## 🔄 Alternatives Considérées
+
+Autres solutions envisagées et pourquoi elles n'ont pas été choisies.
+
+### Alternative 1
+- **Description** : ...
+- **Pourquoi rejetée** : ...
+
+### Alternative 2
+- **Description** : ...
+- **Pourquoi rejetée** : ...
+
+## 📊 Impact
+
+### Impact sur les Utilisateurs
+- Impact positif 1
+- Impact positif 2
+- Impact négatif potentiel (si applicable)
+
+### Impact sur l'Architecture
+- Changements nécessaires
+- Compatibilité avec l'existant
+- Performance
+
+### Impact sur la Maintenance
+- Complexité ajoutée
+- Tests nécessaires
+- Documentation requise
+
+## 💻 Exemples d'Utilisation
+
+### Cas d'Usage 1
+```bash
+# Exemple de commande ou configuration
+```
+
+### Cas d'Usage 2
+```python
+# Exemple de code Python
+```
+
+### Cas d'Usage 3
+```javascript
+// Exemple de code JavaScript
+```
+
+## 🧪 Tests
+
+### Tests Nécessaires
+- [ ] Tests unitaires
+- [ ] Tests d'intégration
+- [ ] Tests de performance
+- [ ] Tests de sécurité
+- [ ] Tests de compatibilité
+
+### Scénarios de Test
+- Scénario 1
+- Scénario 2
+- Scénario 3
+
+## 📚 Documentation
+
+### Documentation Requise
+- [ ] Guide d'utilisation
+- [ ] Documentation API
+- [ ] Exemples de code
+- [ ] Guide de migration
+- [ ] FAQ
+
+## 🔧 Implémentation
+
+### Étapes Proposées
+1. **Phase 1** : [Description]
+2. **Phase 2** : [Description]
+3. **Phase 3** : [Description]
+
+### Estimation de Temps
+- **Développement** : X jours/semaines
+- **Tests** : X jours/semaines
+- **Documentation** : X jours/semaines
+- **Total** : X jours/semaines
+
+### Ressources Nécessaires
+- Développeur(s)
+- Testeur(s)
+- Documentateur(s)
+- Infrastructure
+
+## 🎯 Critères de Succès
+
+Comment mesurer le succès de cette fonctionnalité ?
+
+- [ ] Critère 1
+- [ ] Critère 2
+- [ ] Critère 3
+
+## 🔗 Liens Utiles
+
+- [Documentation existante](docs/)
+- [Issues similaires](https://git.4nkweb.com/4nk/4NK_node/issues?q=is%3Aissue+is%3Aopen+label%3Aenhancement)
+- [Roadmap](https://git.4nkweb.com/4nk/4NK_node/projects)
+- [Discussions](https://git.4nkweb.com/4nk/4NK_node/issues)
+
+## 📋 Checklist
+
+- [ ] J'ai vérifié que cette fonctionnalité n'existe pas déjà
+- [ ] J'ai lu la documentation existante
+- [ ] J'ai vérifié les issues similaires
+- [ ] J'ai fourni des exemples d'utilisation
+- [ ] J'ai considéré l'impact sur l'existant
+- [ ] J'ai proposé des tests
+
+---
+
+**Merci de votre contribution à l'amélioration de docv !** 🌟
+

.gitea/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,184 @@
+# Pull Request - docv
+
+> Ce fichier est un modèle PR. Adaptez les sections à votre projet dérivé.
+
+## 📋 Description
+
+Description claire et concise des changements apportés.
+
+### Type de Changement
+- [ ] 🐛 Bug fix
+- [ ] ✨ Nouvelle fonctionnalité
+- [ ] 📚 Documentation
+- [ ] 🧪 Tests
+- [ ] 🔧 Refactoring
+- [ ] 🚀 Performance
+- [ ] 🔒 Sécurité
+- [ ] 🎨 Style/UI
+- [ ] 🏗️ Architecture
+- [ ] 📦 Build/CI
+
+### Composants Affectés
+- [ ] Bitcoin Core
+- [ ] Blindbit
+- [ ] SDK Relay
+- [ ] Tor
+- [ ] Docker/Infrastructure
+- [ ] Tests
+- [ ] Documentation
+- [ ] Scripts
+
+## 🔗 Issue(s) Liée(s)
+
+Fixes #(issue)
+Relates to #(issue)
+
+## 🧪 Tests
+
+### Tests Exécutés
+- [ ] Tests unitaires
+- [ ] Tests d'intégration
+- [ ] Tests de connectivité
+- [ ] Tests externes
+- [ ] Tests de performance
+- [ ] Release Guard local (`RELEASE_TYPE=ci-verify scripts/release/guard.sh`)
+
+### Commandes de Test
+```bash
+# Tests complets
+./tests/run_all_tests.sh
+
+# Tests spécifiques
+./tests/run_unit_tests.sh
+./tests/run_integration_tests.sh
+```
+
+### Résultats des Tests
+```
+Résultats des tests ici
+```
+
+## 📸 Captures d'Écran
+
+Si applicable, ajoutez des captures d'écran pour les changements visuels.
+
+## 🔧 Changements Techniques
+
+### Fichiers Modifiés
+- `fichier1.rs` - Description des changements
+- `fichier2.py` - Description des changements
+- `docker-compose.yml` - Description des changements
+
+### Nouveaux Fichiers
+- `nouveau_fichier.rs` - Description
+- `nouveau_script.sh` - Description
+
+### Fichiers Supprimés
+- `ancien_fichier.rs` - Raison de la suppression
+
+### Changements de Configuration
+```yaml
+# Exemple de changement de configuration
+service:
+  new_option: value
+```
+
+## 📚 Documentation
+
+### Documentation Mise à Jour
+- [ ] README.md
+- [ ] docs/INSTALLATION.md
+- [ ] docs/USAGE.md
+- [ ] docs/API.md
+- [ ] docs/ARCHITECTURE.md
+
+### Nouvelle Documentation
+- [ ] Nouveau guide créé
+- [ ] Exemples ajoutés
+- [ ] API documentée
+
+## 🔍 Code Review Checklist
+
+### Code Quality
+- [ ] Le code suit les standards du projet
+- [ ] Les noms de variables/fonctions sont clairs
+- [ ] Les commentaires sont appropriés
+- [ ] Pas de code mort ou commenté
+- [ ] Gestion d'erreurs appropriée
+
+### Performance
+- [ ] Pas de régression de performance
+- [ ] Optimisations appliquées si nécessaire
+- [ ] Tests de performance ajoutés
+
+### Sécurité
+- [ ] Pas de vulnérabilités introduites
+- [ ] Validation des entrées utilisateur
+- [ ] Gestion sécurisée des secrets
+
+### Tests
+- [ ] Couverture de tests suffisante
+- [ ] Tests pour les cas d'erreur
+- [ ] Tests d'intégration si nécessaire
+
+### Documentation
+- [ ] Code auto-documenté
+- [ ] Documentation mise à jour
+- [ ] Exemples fournis
+
+## 🚀 Déploiement
+
+### Impact sur le Déploiement
+- [ ] Aucun impact
+- [ ] Migration de données requise
+- [ ] Changement de configuration
+- [ ] Redémarrage des services
+
+### Étapes de Déploiement
+```bash
+# Étapes pour déployer les changements
+```
+
+## 📊 Métriques
+
+### Impact sur les Performances
+- Temps de réponse : +/- X%
+- Utilisation mémoire : +/- X%
+- Utilisation CPU : +/- X%
+
+### Impact sur la Stabilité
+- Taux d'erreur : +/- X%
+- Disponibilité : +/- X%
+
+## 🔄 Compatibilité
+
+### Compatibilité Ascendante
+- [ ] Compatible avec les versions précédentes
+- [ ] Migration automatique
+- [ ] Migration manuelle requise
+
+### Compatibilité Descendante
+- [ ] Compatible avec les futures versions
+- [ ] API stable
+- [ ] Configuration stable
+
+## 🎯 Critères de Succès
+
+- [ ] Critère 1
+- [ ] Critère 2
+- [ ] Critère 3
+
+## 📝 Notes Supplémentaires
+
+Informations supplémentaires importantes pour les reviewers.
+
+## 🔗 Liens Utiles
+
+- [Documentation](docs/)
+- [Tests](tests/)
+- [Issues liées](https://git.4nkweb.com/4nk/4NK_node/issues)
+
+---
+
+**Merci pour votre contribution !** 🙏
+

.gitea/workflows/LOCAL_OVERRIDES.yml

@@ -0,0 +1,15 @@
+# LOCAL_OVERRIDES.yml — dérogations locales contrôlées (fichier modèle)
+overrides:
+  - path: ".gitea/workflows/ci.yml"
+    reason: "spécificité d’environnement"
+    owner: "@maintainer_handle"
+    expires: "2025-12-31"
+  - path: "scripts/scripts/auto-ssh-push.sh"
+    reason: "flux particulier temporaire"
+    owner: "@maintainer_handle"
+    expires: "2025-10-01"
+policy:
+  allow_only_listed_paths: true
+  require_expiry: true
+  audit_in_ci: true
+

.gitea/workflows/ci.yml

@@ -0,0 +1,371 @@
+# Template CI - docv (ce fichier est un modèle, adaptez selon votre projet)
+name: CI - docv
+
+on:
+  push:
+    branches: [ main, develop ]
+  pull_request:
+    branches: [ main, develop ]
+
+env:
+  RUST_VERSION: '1.70'
+  DOCKER_COMPOSE_VERSION: '2.20.0'
+
+jobs:
+  # Job de vérification du code
+  code-quality:
+    name: Code Quality
+    runs-on: ubuntu-latest
+
+    steps:
+    - name: Checkout code
+      uses: actions/checkout@v3
+
+    - name: Setup Rust
+      uses: actions-rs/toolchain@v1
+      with:
+        toolchain: ${{ env.RUST_VERSION }}
+        override: true
+
+    - name: Cache Rust dependencies
+      uses: actions/cache@v3
+      with:
+        path: |
+          ~/.cargo/registry
+          ~/.cargo/git
+          target
+        key: ${{ runner.os }}-cargo-${{ hashFiles('**/Cargo.lock') }}
+        restore-keys: |
+          ${{ runner.os }}-cargo-
+
+    - name: Run clippy
+      run: |
+        cd sdk_relay
+        cargo clippy --all-targets --all-features -- -D warnings
+
+    - name: Run rustfmt
+      run: |
+        cd sdk_relay
+        cargo fmt --all -- --check
+
+    - name: Check documentation
+      run: |
+        cd sdk_relay
+        cargo doc --no-deps
+
+    - name: Check for TODO/FIXME
+      run: |
+        if grep -r "TODO\|FIXME" . --exclude-dir=.git --exclude-dir=target; then
+          echo "Found TODO/FIXME comments. Please address them."
+          exit 1
+        fi
+
+  # Job de tests unitaires
+  unit-tests:
+    name: Unit Tests
+    runs-on: ubuntu-latest
+
+    steps:
+    - name: Checkout code
+      uses: actions/checkout@v3
+
+    - name: Setup Rust
+      uses: actions-rs/toolchain@v1
+      with:
+        toolchain: ${{ env.RUST_VERSION }}
+        override: true
+
+    - name: Cache Rust dependencies
+      uses: actions/cache@v3
+      with:
+        path: |
+          ~/.cargo/registry
+          ~/.cargo/git
+          target
+        key: ${{ runner.os }}-cargo-${{ hashFiles('**/Cargo.lock') }}
+        restore-keys: |
+          ${{ runner.os }}-cargo-
+
+    - name: Run unit tests
+      run: |
+        cd sdk_relay
+        cargo test --lib --bins
+
+    - name: Run integration tests
+      run: |
+        cd sdk_relay
+        cargo test --tests
+
+  # Job de tests d'intégration
+  integration-tests:
+    name: Integration Tests
+    runs-on: ubuntu-latest
+
+    services:
+      docker:
+        image: docker:24.0.5
+        options: >-
+          --health-cmd "docker info"
+          --health-interval 10s
+          --health-timeout 5s
+          --health-retries 5
+        ports:
+          - 2375:2375
+
+    steps:
+    - name: Checkout code
+      uses: actions/checkout@v3
+
+    - name: Setup Docker Buildx
+      uses: docker/setup-buildx-action@v3
+
+    - name: Build Docker images
+      run: |
+        docker build -t 4nk-node-bitcoin ./bitcoin
+        docker build -t 4nk-node-blindbit ./blindbit
+        docker build -t 4nk-node-sdk-relay -f ./sdk_relay/Dockerfile ..
+
+    - name: Run integration tests
+      run: |
+        # Tests de connectivité de base
+        ./tests/run_connectivity_tests.sh || true
+
+        # Tests d'intégration
+        ./tests/run_integration_tests.sh || true
+
+    - name: Upload test results
+      uses: actions/upload-artifact@v3
+      if: always()
+      with:
+        name: test-results
+        path: |
+          tests/logs/
+          tests/reports/
+        retention-days: 7
+
+  # Job de tests de sécurité
+  security-tests:
+    name: Security Tests
+    runs-on: ubuntu-latest
+
+    steps:
+    - name: Checkout code
+      uses: actions/checkout@v3
+
+    - name: Setup Rust
+      uses: actions-rs/toolchain@v1
+      with:
+        toolchain: ${{ env.RUST_VERSION }}
+        override: true
+
+    - name: Run cargo audit
+      run: |
+        cd sdk_relay
+        cargo audit --deny warnings
+
+    - name: Check for secrets
+      run: |
+        # Vérifier les secrets potentiels
+        if grep -r "password\|secret\|key\|token" . --exclude-dir=.git --exclude-dir=target --exclude=*.md; then
+          echo "Potential secrets found. Please review."
+          exit 1
+        fi
+
+    - name: Check file permissions
+      run: |
+        # Vérifier les permissions sensibles
+        find . -type f -perm /0111 -name "*.conf" -o -name "*.key" -o -name "*.pem" | while read file; do
+          if [[ $(stat -c %a "$file") != "600" ]]; then
+            echo "Warning: $file has insecure permissions"
+          fi
+        done
+
+  # Job de build et test Docker
+  docker-build:
+    name: Docker Build & Test
+    runs-on: ubuntu-latest
+
+    services:
+      docker:
+        image: docker:24.0.5
+        options: >-
+          --health-cmd "docker info"
+          --health-interval 10s
+          --health-timeout 5s
+          --health-retries 5
+        ports:
+          - 2375:2375
+
+    steps:
+    - name: Checkout code
+      uses: actions/checkout@v3
+
+    - name: Setup Docker Buildx
+      uses: docker/setup-buildx-action@v3
+
+    - name: Build and test Bitcoin Core
+      run: |
+        docker build -t 4nk-node-bitcoin:test ./bitcoin
+        docker run --rm 4nk-node-bitcoin:test bitcoin-cli --version
+
+    - name: Build and test Blindbit
+      run: |
+        docker build -t 4nk-node-blindbit:test ./blindbit
+        docker run --rm 4nk-node-blindbit:test --version || true
+
+    - name: Build and test SDK Relay
+      run: |
+        docker build -t 4nk-node-sdk-relay:test -f ./sdk_relay/Dockerfile ..
+        docker run --rm 4nk-node-sdk-relay:test --version || true
+
+    - name: Test Docker Compose
+      run: |
+        docker-compose config
+        docker-compose build --no-cache
+
+  # Job de tests de documentation
+  documentation-tests:
+    name: Documentation Tests
+    runs-on: ubuntu-latest
+
+    steps:
+    - name: Checkout code
+      uses: actions/checkout@v3
+
+    - name: Check markdown links
+      run: |
+        # Vérification basique des liens markdown
+        find . -name "*.md" -exec grep -l "\[.*\](" {} \; | while read file; do
+          echo "Checking links in $file"
+        done
+
+    - name: Check documentation structure
+      run: |
+        # Vérifier la présence des fichiers de documentation essentiels
+        required_files=(
+          "README.md"
+          "LICENSE"
+          "CONTRIBUTING.md"
+          "CHANGELOG.md"
+          "CODE_OF_CONDUCT.md"
+          "SECURITY.md"
+          "docs/INDEX.md"
+          "docs/INSTALLATION.md"
+          "docs/USAGE.md"
+        )
+
+        for file in "${required_files[@]}"; do
+          if [[ ! -f "$file" ]]; then
+            echo "Missing required documentation file: $file"
+            exit 1
+          fi
+        done
+
+    - name: Validate documentation
+      run: |
+        echo "Validation documentation générique (adaptée au projet)"
+
+  security-audit:
+    name: Security Audit
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v3
+      - name: Ensure scripts executable
+        run: |
+          chmod +x scripts/security/audit.sh || true
+      - name: Run template security audit
+        run: |
+          if [ -f scripts/security/audit.sh ]; then
+            ./scripts/security/audit.sh
+          else
+            echo "No security audit script (ok)"
+          fi
+
+  # Job de release guard (cohérence release)
+  release-guard:
+    name: Release Guard
+    runs-on: ubuntu-latest
+    needs: [code-quality, unit-tests, documentation-tests, security-audit]
+    steps:
+    - name: Checkout code
+      uses: actions/checkout@v3
+
+    - name: Ensure guard scripts are executable
+      run: |
+        chmod +x scripts/release/guard.sh || true
+        chmod +x scripts/checks/version_alignment.sh || true
+
+    - name: Version alignment check
+      run: |
+        if [ -f scripts/checks/version_alignment.sh ]; then
+          ./scripts/checks/version_alignment.sh
+        else
+          echo "No version alignment script (ok)"
+        fi
+
+  docker-build:
+    name: Docker Build
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v3
+      - name: Setup Docker Buildx
+        uses: docker/setup-buildx-action@v3
+      - name: Build Docker image
+        run: |
+          docker build -t docv:latest .
+
+    - name: Release guard (CI verify)
+      env:
+        RELEASE_TYPE: ci-verify
+      run: |
+        if [ -f scripts/release/guard.sh ]; then
+          ./scripts/release/guard.sh
+        else
+          echo "No guard script (ok)"
+        fi
+
+  # Job de tests de performance
+  performance-tests:
+    name: Performance Tests
+    runs-on: ubuntu-latest
+
+    steps:
+    - name: Checkout code
+      uses: actions/checkout@v3
+
+    - name: Setup Rust
+      uses: actions-rs/toolchain@v1
+      with:
+        toolchain: ${{ env.RUST_VERSION }}
+        override: true
+
+    - name: Run performance tests
+      run: |
+        cd sdk_relay
+        cargo test --release --test performance_tests || true
+
+    - name: Check memory usage
+      run: |
+        # Tests de base de consommation mémoire
+        echo "Performance tests completed"
+
+  # Job de notification
+  notify:
+    name: Notify
+    runs-on: ubuntu-latest
+    needs: [code-quality, unit-tests, integration-tests, security-tests, docker-build, documentation-tests]
+    if: always()
+
+    steps:
+    - name: Notify success
+      if: needs.code-quality.result == 'success' && needs.unit-tests.result == 'success' && needs.integration-tests.result == 'success' && needs.security-tests.result == 'success' && needs.docker-build.result == 'success' && needs.documentation-tests.result == 'success'
+      run: |
+        echo "✅ All tests passed successfully!"
+
+    - name: Notify failure
+      if: needs.code-quality.result == 'failure' || needs.unit-tests.result == 'failure' || needs.integration-tests.result == 'failure' || needs.security-tests.result == 'failure' || needs.docker-build.result == 'failure' || needs.documentation-tests.result == 'failure'
+      run: |
+        echo "❌ Some tests failed!"
+        exit 1

.gitea/workflows/template-sync.yml

@@ -0,0 +1,40 @@
+# .gitea/workflows/template-sync.yml — synchronisation et contrôles d’intégrité (fichier modèle)
+name: 4NK Template Sync
+on:
+  schedule:        # planification régulière
+    - cron: "0 4 * * 1"   # exécution hebdomadaire (UTC)
+  workflow_dispatch: {}   # déclenchement manuel
+
+jobs:
+  check-and-sync:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Lire TEMPLATE_VERSION et .4nk-sync.yml
+        # Doit charger ref courant, source_repo et périmètre paths
+
+      - name: Récupérer la version publiée du template/4NK_rules
+        # Doit comparer TEMPLATE_VERSION avec ref amont
+
+      - name: Créer branche de synchronisation si divergence
+        # Doit créer chore/template-sync-<date> et préparer un commit
+
+      - name: Synchroniser les chemins autoritatifs
+        # Doit mettre à jour .cursor/**, .gitea/**, AGENTS.md, scripts/**, docs/SSH_UPDATE.md
+
+      - name: Contrôles post-sync (bloquants)
+        # 1) Vérifier présence et exécutable des scripts/*.sh
+        # 2) Vérifier mise à jour CHANGELOG.md et docs/INDEX.md
+        # 3) Vérifier docs/SSH_UPDATE.md si scripts/** a changé
+        # 4) Vérifier absence de secrets en clair dans scripts/**
+        # 5) Vérifier manifest_checksum si publié
+
+      - name: Tests, lint, sécurité statique
+        # Doit exiger un état vert
+
+      - name: Ouvrir PR de synchronisation
+        # Titre: "[template-sync] chore: aligner .cursor/.gitea/AGENTS.md/scripts"
+        # Doit inclure résumé des fichiers modifiés et la version appliquée
+
+      - name: Mettre à jour TEMPLATE_VERSION (dans PR)
+        # Doit remplacer la valeur par la ref appliquée
+

.gitignore

@@ -0,0 +1,30 @@
+# See https://help.github.com/articles/ignoring-files/ for more about ignoring files.
+
+# dependencies
+/node_modules
+
+# next.js
+/.next/
+/out/
+
+# production
+/build
+
+# debug
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+.pnpm-debug.log*
+
+# env files
+.env*
+
+# vercel
+.vercel
+
+# typescript
+*.tsbuildinfo
+next-env.d.ts
+!.cursor/
+
+!AGENTS.md

AGENTS.md

@@ -0,0 +1,275 @@
+# AGENTS.md
+
+## Table des matières
+- [Introduction](#introduction)
+- [Principes communs](#principes-communs)
+- [Agents fondamentaux](#agents-fondamentaux)
+- [Agents spécialisés documentation](#agents-spécialisés-documentation)
+- [Agents spécialisés tests](#agents-spécialisés-tests)
+- [Agents techniques](#agents-techniques)
+- [Agents frontend](#agents-frontend)
+- [Agents open source et CI](#agents-open-source-et-ci)
+- [Agents de synchronisation et dérogations](#agents-de-synchronisation-et-d%C3%A9rogations)
+- [Matrice de coordination](#matrice-de-coordination)
+- [Conclusion](#conclusion)
+
+---
+
+## Introduction
+Ce document définit les agents, leurs rôles et leurs responsabilités dans le projet `4NK/4NK_node` et, par extension, tout dépôt dérivé de `4NK_project_template`.
+Il impose une coordination stricte entre code, documentation, tests, dépendances, CI/CD, synchronisation de template et gouvernance open source.
+Les règles opérationnelles détaillées sont précisées dans `.cursor/rules/` (notamment `41-ssh-automation.mdc` et `42-template-sync.mdc`).
+
+---
+
+## Principes communs
+- Langue exclusive : français.
+- Pas d’exemples de code applicatif injectés dans la base.
+- Toute contribution doit contenir une introduction et/ou une conclusion.
+- Interdiction de secrets en clair dans le dépôt.
+- Confirmation nécessaire avant `push` et `tag`.
+- Toute modification impactant des éléments normatifs doit mettre à jour la documentation et le changelog.
+ - Le flux de publication applique un garde de release (tests/doc/build/alignement version/changelog/tag, latest vs wip).
+
+---
+
+## Agents fondamentaux
+
+### Agent Fondation  (Responsable)
+**Missions**
+- Garantir la conformité éditoriale : français, pas d’exemples applicatifs, introduction/conclusion.
+- Vérifier la cohérence terminologique.
+
+**Artefacts**
+- Tous fichiers.
+
+---
+
+### Agent Structure  (Responsable)
+**Missions**
+- Maintenir l’arborescence canonique (incluant `.cursor/`, `.gitea/`, `scripts/`, `docs/SSH_UPDATE.md`).
+- Archiver le contenu obsolète dans `archive/` avec métadonnées.
+- Interdire toute suppression non tracée.
+
+**Artefacts**
+- `archive/`, `docs/**`, `tests/**`, `.cursor/**`, `.gitea/**`, `scripts/**`, `CHANGELOG.md`.
+
+---
+
+## Agents spécialisés documentation
+
+### Agent Documentation  (Responsable)
+**Missions**
+- Mettre à jour `docs/**` selon l’impact des changements.
+- Tenir `docs/INDEX.md` comme table des matières centrale.
+- Produire des REX techniques dans `archive/` en cas d’investigations multiples.
+
+**Artefacts**
+- `docs/**`, `README.md`, `archive/**`.
+
+---
+
+### Agent Données CSV  (Responsable)
+**Missions**
+- Traiter les CSV comme source des modèles de données (en-têtes multi-lignes inclus).
+- Exiger une définition complète de toutes les colonnes.
+- Corriger et documenter les incohérences de types.
+
+**Artefacts**
+- `docs/API.md`, `docs/ARCHITECTURE.md`, `docs/USAGE.md`.
+
+---
+
+### Agent Documents bureautiques  (Consulté)
+**Missions**
+- Lire `.docx` via `docx2txt`; proposer des alternatives en cas d’échec.
+- Documenter les imports dans `docs/INDEX.md`.
+
+**Artefacts**
+- `docs/**`, `archive/**`.
+
+---
+
+## Agents spécialisés tests
+
+### Agent Tests  (Responsable)
+**Missions**
+- Couvrir `unit`, `integration`, `connectivity`, `performance`, `external`.
+- Gérer `tests/logs` et `tests/reports`.
+- Exiger des tests verts avant commit.
+
+**Artefacts**
+- `tests/**`, `docs/TESTING.md`.
+
+---
+
+### Agent Performance  (Consulté)
+**Missions**
+- Réaliser des benchmarks reproductibles.
+- Valider l’impact performance avant fusion.
+
+**Artefacts**
+- `tests/performance/`, `tests/reports/`, `docs/TESTING.md`.
+
+---
+
+## Agents techniques
+
+### Agent Dépendances  (Responsable)
+**Missions**
+- Ajouter les dépendances manquantes lorsque justifié.
+- Vérifier les dernières versions stables.
+- Documenter les impacts dans `ARCHITECTURE.md`, `CONFIGURATION.md`, `CHANGELOG.md`.
+
+**Artefacts**
+- `docs/ARCHITECTURE.md`, `docs/CONFIGURATION.md`, `CHANGELOG.md`.
+
+---
+
+### Agent Compilation  (Responsable)
+**Missions**
+- Compiler très régulièrement et aux étapes critiques.
+- Bloquer toute progression en cas d’erreurs de build/runtime.
+
+**Artefacts**
+- Artefacts de build, scripts d’outillage.
+
+---
+
+### Agent Résolution  (Responsable)
+**Missions**
+- Conduire la boucle de diagnostic complète : reproduction minimale, logs, bissection, hypothèses, tests ciblés, correctif, non-régression.
+- Produire un REX quand plusieurs hypothèses ont été testées.
+
+**Artefacts**
+- `tests/**`, `archive/**`
+
+---
+
+### Agent SSH & scripts  (Responsable)
+**Missions**
+- Garantir la présence et l’usage correct de `scripts/auto-ssh-push.sh`, `scripts/init-ssh-env.sh`, `scripts/setup-ssh-ci.sh`.
+- Assurer permissions d’exécution, idempotence, journalisation non sensible, gestion d’erreurs robuste.
+- Interdire secrets en clair, gérer via secrets CI et variables d’environnement.
+- Exiger la mise à jour de `docs/SSH_UPDATE.md` à toute évolution des scripts ou des flux SSH.
+
+**Artefacts**
+- `scripts/**`, `.gitea/workflows/ci.yml`, `docs/SSH_UPDATE.md`, `docs/CONFIGURATION.md`, `CHANGELOG.md`.
+
+---
+
+## Agents frontend
+
+### Agent Frontend  (Responsable)
+**Missions**
+- Mettre en place `React.lazy`/`Suspense` (code splitting).
+- Centraliser l’état (Redux ou Context API).
+- Abstraire les services de données.
+
+**Artefacts**
+- `docs/ARCHITECTURE.md`, `docs/TESTING.md`.
+
+---
+
+## Agents open source et CI
+
+### Agent Open Source  (Responsable)
+**Missions**
+- Maintenir : `LICENSE`, `CONTRIBUTING.md`, `CODE_OF_CONDUCT.md`, `docs/OPEN_SOURCE_CHECKLIST.md`.
+- Vérifier l’alignement continu avec `4NK_node`.
+
+**Artefacts**
+- Fichiers de gouvernance cités ci-dessus.
+
+---
+
+### Agent Gitea  (Responsable)
+**Missions**
+- Garantir `.gitea/ISSUE_TEMPLATE/*`, `PULL_REQUEST_TEMPLATE.md`, `.gitea/workflows/ci.yml`.
+- Documenter la configuration distante dans `docs/GITEA_SETUP.md`.
+- Déclencher les étapes CI pertinentes (tests, lint, sécurité, vérifs `scripts/`).
+
+**Artefacts**
+- `.gitea/**`, `docs/GITEA_SETUP.md`.
+
+---
+
+### Agent Versionnage  (Responsable)
+**Missions**
+- Tenir `CHANGELOG.md` comme source unique de vérité.
+- Proposer un bump sémantique justifié.
+- Demander confirmation avant push et tag.
+ - Orchestrer le `release-guard` (CI + scripts) et consigner latest vs wip.
+
+**Artefacts**
+- `CHANGELOG.md`, `docs/RELEASE_PLAN.md`, `docs/ROADMAP.md`.
+
+---
+
+### Agent Sécurité  (Responsable)
+**Missions**
+- Mettre en place et exécuter `scripts/security/audit.sh` (npm audit, cargo audit si applicable, scan de secrets).
+- Interdire les secrets en clair; assurer la rotation des secrets CI.
+- Vérifier permissions et non‑exposition d’endpoints privés.
+- Bloquer la release si l’audit échoue (intégré au `release-guard`).
+
+**Artefacts**
+- `scripts/security/audit.sh`, `.gitea/workflows/ci.yml` (job `security-audit`), `docs/SECURITY_AUDIT.md`, `SECURITY.md`.
+
+---
+
+## Agents de synchronisation et dérogations
+
+### Agent Synchronisation de template  (Accountable)
+**Références**
+- `.4nk-sync.yml` (manifeste), `TEMPLATE_VERSION` (pointeur), `.gitea/workflows/template-sync.yml` (CI dédiée).
+- Règles Cursor : `.cursor/rules/42-template-sync.mdc` et `.cursor/rules/10-project-structure.mdc`.
+
+**Missions**
+- Assurer l’alignement automatique sur le template pour : `.cursor/**`, `.gitea/**`, `AGENTS.md`, `scripts/**`, `docs/SSH_UPDATE.md`.
+- Déclencher/valider la PR `[template-sync]` créée par la CI.
+- Exiger la mise à jour de `CHANGELOG.md` et `docs/INDEX.md` après synchronisation.
+- Vérifier l’intégrité (`manifest_checksum`, checksums de fichiers si publiés), les permissions, l’absence de secrets.
+- Mettre à jour `TEMPLATE_VERSION` dans la PR.
+
+**Artefacts**
+- `.4nk-sync.yml`, `TEMPLATE_VERSION`, `.cursor/**`, `.gitea/**`, `AGENTS.md`, `scripts/**`, `docs/SSH_UPDATE.md`, `CHANGELOG.md`.
+
+---
+
+### Agent Dérogations locales  (Responsable)
+**Références**
+- `LOCAL_OVERRIDES.yml` (facultatif, mais recommandé).
+
+**Missions**
+- Enregistrer toute divergence locale dans le périmètre synchronisé (path, raison, propriétaire, échéance).
+- Faire respecter : seules les dérogations listées et non expirées sont tolérées par la CI.
+- Auditer périodiquement et résorber les dérogations.
+
+**Artefacts**
+- `LOCAL_OVERRIDES.yml`, `CHANGELOG.md` (mentionner les dérogations significatives).
+
+---
+
+## Matrice de coordination
+
+| Type de changement               | Agents impliqués                                                                                                     | Artefacts principaux                                                                                                                | Validation obligatoire |
+|----------------------------------|----------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------|------------------------|
+| Ajout de fonctionnalité          | Documentation, Tests, Dépendances, Frontend                                                                          | `docs/API.md`, `docs/USAGE.md`, `docs/ARCHITECTURE.md`, `tests/unit`, `tests/integration`, `CHANGELOG.md` (*Added*)                 | Oui |
+| Correction de bug                | Résolution, Tests, Documentation                                                                                      | `tests/unit`, `docs/TESTING.md`, `archive/` (REX si nécessaire), `CHANGELOG.md` (*Fixed*)                                            | Oui |
+| Refactorisation / amélioration   | Structure, Documentation, Compilation                                                                                 | `docs/ARCHITECTURE.md`, `archive/`, `CHANGELOG.md` (*Changed*)                                                                      | Oui |
+| Dépendance ajoutée/mise à jour   | Dépendances, Compilation, Documentation                                                                               | `docs/ARCHITECTURE.md`, `docs/CONFIGURATION.md`, `CHANGELOG.md` (*Dependencies*)                                                    | Oui |
+| Données CSV modifiées            | Données CSV, Documentation, Tests                                                                                     | `docs/API.md`, `docs/ARCHITECTURE.md`, `docs/USAGE.md`, `tests/unit`, `CHANGELOG.md` (*Data model update*)                          | Oui |
+| Migration / breaking change      | Documentation, Tests, Résolution, Versionnage                                                                         | `docs/MIGRATION.md`, `docs/INSTALLATION.md`, `docs/RELEASE_PLAN.md`, `docs/ROADMAP.md`, `tests/integration`, `CHANGELOG.md` (*Breaking*) | Oui |
+| Sécurité / audit                 | Documentation, Tests, Open Source, Sécurité proactive                                                                 | `docs/SECURITY_AUDIT.md`, `tests/external`, `tests/connectivity`, `CHANGELOG.md` (*Security*)                                        | Oui |
+| Préparation open source / CI     | Open Source, Gitea, Versionnage, Documentation communautaire, Contributeurs externes                                  | `.gitea/**`, `docs/GITEA_SETUP.md`, `docs/OPEN_SOURCE_CHECKLIST.md`, `CHANGELOG.md` (*CI/CD* / *Governance*)                        | Oui |
+| Optimisation performance         | Performance, Tests, Documentation                                                                                     | `tests/performance`, `tests/reports`, `docs/ARCHITECTURE.md`, `CHANGELOG.md` (*Performance*)                                         | Oui |
+| Évolution frontend               | Frontend, Documentation, Tests                                                                                        | `docs/ARCHITECTURE.md`, `docs/USAGE.md`, `tests/integration`, `CHANGELOG.md` (*Frontend*)                                           | Oui |
+| Évolution CI/CD ou scripts SSH   | SSH & scripts, Gitea, Versionnage, Documentation                                                                      | `scripts/**`, `.gitea/workflows/ci.yml`, `docs/SSH_UPDATE.md`, `docs/CONFIGURATION.md`, `CHANGELOG.md` (*CI/CD*)                     | Oui |
+| **Synchronisation de template**  | **Synchronisation de template**, Gitea, Versionnage, Structure, Documentation, SSH & scripts                          | `.4nk-sync.yml`, `TEMPLATE_VERSION`, `.cursor/**`, `.gitea/**`, `AGENTS.md`, `scripts/**`, `docs/SSH_UPDATE.md`, `CHANGELOG.md`       | **Oui** |
+| Dérogation locale contrôlée      | Dérogations locales, Gitea, Synchronisation de template, Versionnage                                                  | `LOCAL_OVERRIDES.yml`, `CHANGELOG.md` (mention), CI tolérante uniquement sur chemins listés et non expirés                           | Oui |
+
+---
+
+## Conclusion
+Ce `AGENTS.md` mis à jour introduit l’**Agent Synchronisation de template** et l’**Agent Dérogations locales**, renforce l’**Agent SSH & scripts**, et rattache l’ensemble aux règles Cursor et à la CI Gitea. La matrice de coordination formalise les validations obligatoires pour chaque type de changement, garantissant cohérence structurelle, qualité documentaire, sécurité, traçabilité et stabilité à long terme sur tous les projets issus de `4NK_project_template`.

CHANGELOG.md

@@ -0,0 +1,8 @@
+# Changelog - docv
+
+## [Unreleased]
+
+
+## [0.1.0] - 2025-08-27
+### Changed
+- Release latest (sécurité/CI/docs).

DEPLOYMENT.md

@@ -0,0 +1,194 @@
+# 🚀 Guide de déploiement DocV avec envoi d'emails
+
+## 📋 Prérequis
+
+### 1. Variables d'environnement
+Configurez ces variables sur votre plateforme de déploiement :
+
+\`\`\`env
+SMTP_HOST=votre-serveur-smtp
+SMTP_PORT=587
+SMTP_SECURE=false
+SMTP_USER=votre-email@domaine.com
+SMTP_PASSWORD=votre-mot-de-passe-application
+SMTP_FROM=votre-email@domaine.com
+\`\`\`
+
+⚠️ **Important** : Utilisez toujours des mots de passe d'application, jamais vos mots de passe principaux.
+
+## 🌐 Déploiement sur Vercel
+
+### 1. Installation Vercel CLI
+\`\`\`bash
+npm i -g vercel
+\`\`\`
+
+### 2. Configuration des variables
+\`\`\`bash
+vercel env add SMTP_HOST
+vercel env add SMTP_PORT
+vercel env add SMTP_SECURE
+vercel env add SMTP_USER
+vercel env add SMTP_PASSWORD
+vercel env add SMTP_FROM
+\`\`\`
+
+### 3. Déploiement
+\`\`\`bash
+vercel --prod
+\`\`\`
+
+## 🔧 Déploiement sur Netlify
+
+### 1. Variables d'environnement
+Dans le dashboard Netlify :
+- Site settings > Environment variables
+- Ajoutez toutes les variables SMTP
+
+### 2. Build settings
+\`\`\`toml
+# netlify.toml
+[build]
+  command = "npm run build"
+  publish = ".next"
+
+[build.environment]
+  NODE_VERSION = "18"
+\`\`\`
+
+## 🐳 Déploiement Docker
+
+### 1. Dockerfile
+\`\`\`dockerfile
+FROM node:18-alpine
+
+WORKDIR /app
+COPY package*.json ./
+RUN npm ci --only=production
+
+COPY . .
+RUN npm run build
+
+EXPOSE 3000
+CMD ["npm", "start"]
+\`\`\`
+
+### 2. Variables d'environnement
+\`\`\`bash
+docker run -d \
+  -p 3000:3000 \
+  -e SMTP_HOST=votre-smtp-host \
+  -e SMTP_PORT=587 \
+  -e SMTP_USER=votre-email@domaine.com \
+  -e SMTP_PASSWORD=votre-mot-de-passe \
+  -e SMTP_FROM=votre-email@domaine.com \
+  docv-app
+\`\`\`
+
+## ✅ Test de l'envoi d'emails
+
+### 1. Vérification des variables
+\`\`\`bash
+# Sur votre serveur
+echo $SMTP_HOST
+echo $SMTP_USER
+\`\`\`
+
+### 2. Test des formulaires
+- Accédez à \`/contact\`
+- Remplissez et envoyez le formulaire
+- Vérifiez les logs serveur
+- Vérifiez la réception dans votre boîte email
+
+## 🔍 Debugging
+
+### 1. Logs serveur
+\`\`\`bash
+# Vercel
+vercel logs
+
+# Netlify
+netlify logs
+
+# Docker
+docker logs container-name
+\`\`\`
+
+### 2. Test SMTP manuel
+\`\`\`javascript
+// test-smtp.js
+const nodemailer = require('nodemailer');
+
+const transporter = nodemailer.createTransport({
+  host: process.env.SMTP_HOST,
+  port: process.env.SMTP_PORT,
+  secure: process.env.SMTP_SECURE === 'true',
+  auth: {
+    user: process.env.SMTP_USER,
+    pass: process.env.SMTP_PASSWORD,
+  },
+});
+
+transporter.sendMail({
+  from: process.env.SMTP_FROM,
+  to: 'test@example.com',
+  subject: 'Test SMTP',
+  text: 'Test de configuration SMTP'
+}).then(() => {
+  console.log('✅ SMTP fonctionne');
+}).catch(err => {
+  console.error('❌ Erreur SMTP:', err);
+});
+\`\`\`
+
+## 🔐 Sécurité
+
+### 1. Variables d'environnement
+- ✅ Jamais dans le code source
+- ✅ Configurées sur la plateforme de déploiement
+- ✅ Différentes par environnement (dev/prod)
+
+### 2. Mots de passe d'application
+- ✅ Utilisez des mots de passe d'application
+- ✅ Pas les mots de passe principaux des comptes
+- ✅ Révocables si compromis
+
+## 📧 Configuration par fournisseur
+
+### Protonmail
+\`\`\`env
+SMTP_HOST=smtp.protonmail.ch
+SMTP_PORT=587
+SMTP_SECURE=false
+\`\`\`
+
+### Gmail
+\`\`\`env
+SMTP_HOST=smtp.gmail.com
+SMTP_PORT=587
+SMTP_SECURE=false
+\`\`\`
+
+### Serveur SMTP dédié
+\`\`\`env
+SMTP_HOST=mail.votre-domaine.com
+SMTP_PORT=587
+SMTP_SECURE=false
+\`\`\`
+
+## 🎯 Résultat attendu
+
+Une fois déployé avec les bonnes variables :
+- ✅ Formulaires fonctionnels
+- ✅ Emails HTML formatés
+- ✅ Réception dans votre boîte email
+- ✅ Logs de confirmation
+- ✅ Gestion d'erreurs robuste
+
+## 📞 Support
+
+En cas de problème :
+1. Vérifiez les variables d'environnement
+2. Consultez les logs serveur
+3. Testez la configuration SMTP manuellement
+4. Vérifiez les paramètres de votre fournisseur email

Dockerfile

@@ -0,0 +1,14 @@
+# Multi-stage build for Debian-based Node runtime
+FROM node:20-bookworm-slim AS builder
+WORKDIR /app
+COPY package*.json ./
+RUN npm ci || npm install
+COPY . .
+RUN npm run build || npm run build:prod || true
+
+FROM node:20-bookworm-slim
+WORKDIR /app
+ENV NODE_ENV=production
+COPY --from=builder /app .
+EXPOSE 3000
+CMD ["npm","run","start","--if-present"]

README.md

@@ -0,0 +1,372 @@
+# 🛡️ DocV - GED Souveraine et Sécurisée
+
+> **Une approche révolutionnaire de la gestion documentaire avec sécurité, souveraineté et conformité garanties.**
+
+[![Version](https://img.shields.io/badge/version-0.1.0-blue.svg)](VERSION)
+[![Next.js](https://img.shields.io/badge/Next.js-15.2.4-black.svg)](https://nextjs.org/)
+[![TypeScript](https://img.shields.io/badge/TypeScript-5.0-blue.svg)](https://www.typescriptlang.org/)
+[![Tailwind CSS](https://img.shields.io/badge/Tailwind%20CSS-4.1.9-38B2AC.svg)](https://tailwindcss.com/)
+[![License](https://img.shields.io/badge/license-Private-red.svg)](#license)
+
+## 📋 Table des Matières
+
+- [🎯 Vue d'ensemble](#-vue-densemble)
+- [✨ Fonctionnalités](#-fonctionnalités)
+- [🚀 Installation Rapide](#-installation-rapide)
+- [⚙️ Configuration](#️-configuration)
+- [🔧 Commandes de Développement](#-commandes-de-développement)
+- [📚 Documentation](#-documentation)
+- [🏗️ Architecture](#️-architecture)
+- [🔒 Sécurité](#-sécurité)
+- [🤝 Contribution](#-contribution)
+- [📞 Support](#-support)
+
+## 🎯 Vue d'ensemble
+
+**DocV** est une plateforme de gestion documentaire (GED) révolutionnaire qui combine :
+
+- **🔐 Authentification cryptographique** sans mots de passe
+- **🤖 IA embarquée** pour l'OCR et la classification
+- **🌐 Architecture souveraine** sans dépendance cloud
+- **⚡ Interface conversationnelle** pour le suivi des dossiers
+- **🔗 Ancrage blockchain** pour la traçabilité
+
+### 🎯 Cas d'Usage Principaux
+
+- **Entreprises** : Gestion documentaire sécurisée
+- **Notaires** : Échanges documentaires via lecoffre.io
+- **Secteur public** : Conformité et souveraineté des données
+- **Éditeurs** : Intégration marque blanche
+
+## ✨ Fonctionnalités
+
+### 🔑 Authentification Ultra-Simplifiée
+- ✅ Aucun mot de passe requis
+- ✅ Aucun OTP ou code SMS
+- ✅ Aucune application mobile
+- ✅ Identité auto-générée et auto-portée
+
+### 🤖 Intelligence Artificielle Locale
+- ✅ OCR automatique des documents
+- ✅ Classification intelligente
+- ✅ Extraction de données
+- ✅ Interface conversationnelle
+- ✅ Traitements 100% locaux
+
+### 🛡️ Sécurité de Bout en Bout
+- ✅ Chiffrement natif
+- ✅ Aucune interface admin exposée
+- ✅ Aucun serveur d'identité
+- ✅ Aucune dépendance cloud
+- ✅ Conformité RGPD, ISO 27001, SecNumCloud
+
+### 🌐 Architecture Souveraine
+- ✅ Déploiement local
+- ✅ Migration automatisée
+- ✅ Compatible bases existantes
+- ✅ APIs souveraines
+- ✅ Accompagnement personnalisé
+
+## 🚀 Installation Rapide
+
+### 📋 Prérequis
+
+- **Node.js** : Version 18.0+ (recommandé 20.x)
+- **npm** ou **pnpm** : Gestionnaire de paquets
+- **Git** : Pour le clonage du repository
+
+### 1️⃣ Cloner le Repository
+
+```bash
+# Cloner le projet
+git clone <REPO_URL>
+cd docv
+
+# Installer les dépendances
+npm install
+# ou
+pnpm install
+```
+
+### 2️⃣ Configuration d'Environnement
+
+```bash
+# Créer le fichier d'environnement
+cp .env.example .env.local
+
+# Éditer les variables d'environnement
+nano .env.local
+```
+
+**Variables essentielles :**
+```env
+# Configuration de base
+NEXT_PUBLIC_APP_NAME=DocV
+NEXT_PUBLIC_APP_VERSION=0.1.0
+
+# Base de données (si applicable)
+DATABASE_URL=your_database_url
+
+# Authentification
+NEXTAUTH_SECRET=your_secret_key
+NEXTAUTH_URL=http://localhost:3000
+
+# Services externes (optionnels)
+EMAIL_SERVICE_API_KEY=your_email_api_key
+```
+
+### 3️⃣ Démarrage en Mode Développement
+
+```bash
+# Démarrer le serveur de développement
+npm run dev
+# ou
+pnpm dev
+
+# L'application sera disponible sur http://localhost:3000
+```
+
+## ⚙️ Configuration
+
+### 🎨 Configuration de l'Interface
+
+Le projet utilise **Tailwind CSS** avec des composants **Radix UI** pour une interface moderne et accessible.
+
+```bash
+# Fichier de configuration Tailwind
+tailwind.config.js
+
+# Composants UI personnalisés
+components/ui/
+```
+
+### 🔧 Configuration TypeScript
+
+```bash
+# Configuration TypeScript
+tsconfig.json
+
+# Types personnalisés
+types/
+```
+
+### 📱 Configuration Responsive
+
+L'interface s'adapte automatiquement aux différentes tailles d'écran :
+- 📱 Mobile (< 768px)
+- 📟 Tablet (768px - 1024px)
+- 💻 Desktop (> 1024px)
+
+## 🔧 Commandes de Développement
+
+### 🚀 Commandes Principales
+
+```bash
+# Développement
+npm run dev          # Serveur de développement (port 3000)
+npm run build        # Build de production
+npm run start        # Serveur de production
+npm run lint         # Vérification du code
+
+# Tests (si configurés)
+npm run test         # Tests unitaires
+npm run test:watch   # Tests en mode watch
+npm run test:coverage # Tests avec couverture
+
+# Maintenance
+npm run clean        # Nettoyer les fichiers temporaires
+npm run type-check   # Vérification TypeScript
+```
+
+### 🛠️ Commandes de Maintenance
+
+```bash
+# Mise à jour des dépendances
+npm update           # Mise à jour des paquets
+npm audit            # Audit de sécurité
+npm audit fix        # Correction automatique
+
+# Gestion des dépendances
+npm install <package>     # Installer un paquet
+npm uninstall <package>   # Désinstaller un paquet
+npm list                  # Lister les paquets installés
+```
+
+### 📦 Commandes de Build
+
+```bash
+# Build de production
+npm run build
+
+# Analyse du bundle
+npm run analyze      # (si configuré)
+
+# Build statique
+npm run export       # (si configuré)
+```
+
+### 🔍 Commandes de Debug
+
+```bash
+# Logs détaillés
+DEBUG=* npm run dev
+
+# Profiling
+npm run dev -- --profile
+
+# Inspection du bundle
+npm run build -- --debug
+```
+
+## 📚 Documentation
+
+### 📖 Guides Disponibles
+
+- **[Installation](docs/INSTALLATION.md)** - Guide d'installation complet
+- **[Configuration](docs/CONFIGURATION.md)** - Configuration avancée
+- **[Architecture](docs/ARCHITECTURE.md)** - Architecture technique
+- **[API](docs/API.md)** - Documentation des APIs
+- **[Sécurité](docs/SECURITY_AUDIT.md)** - Audit de sécurité
+- **[Utilisation](docs/USAGE.md)** - Guide d'utilisation
+
+### 🔗 Ressources Externes
+
+- [Next.js Documentation](https://nextjs.org/docs)
+- [Tailwind CSS](https://tailwindcss.com/docs)
+- [Radix UI](https://www.radix-ui.com/docs)
+- [TypeScript Handbook](https://www.typescriptlang.org/docs/)
+
+## 🏗️ Architecture
+
+### 📁 Structure du Projet
+
+```
+docv/
+├── app/                    # Pages et routes Next.js 13+
+│   ├── dashboard/         # Interface utilisateur
+│   ├── login/            # Authentification
+│   ├── formation/        # Module formation
+│   └── contact/          # Contact
+├── components/           # Composants réutilisables
+│   ├── ui/              # Composants UI de base
+│   └── 4nk/             # Composants spécifiques 4NK
+├── lib/                 # Utilitaires et logique métier
+│   ├── 4nk/             # Modules 4NK
+│   └── utils.ts         # Fonctions utilitaires
+├── public/              # Assets statiques
+├── styles/              # Styles globaux
+└── docs/               # Documentation
+```
+
+### 🔧 Technologies Utilisées
+
+| Technologie | Version | Description |
+|-------------|---------|-------------|
+| **Next.js** | 15.2.4 | Framework React full-stack |
+| **React** | 19.1.1 | Bibliothèque UI |
+| **TypeScript** | 5.0+ | Typage statique |
+| **Tailwind CSS** | 4.1.9 | Framework CSS |
+| **Radix UI** | Latest | Composants accessibles |
+| **Lucide React** | 0.454.0 | Icônes |
+| **Zod** | 3.25.67 | Validation de schémas |
+
+### 🌐 Architecture de Sécurité
+
+```mermaid
+graph TB
+    A[Client] --> B[Next.js App]
+    B --> C[Authentification Cryptographique]
+    C --> D[Base de Données Locale]
+    D --> E[Chiffrement Bout en Bout]
+    E --> F[Ancrage Blockchain]
+    
+    G[IA Locale] --> H[Traitement OCR]
+    H --> I[Classification]
+    I --> J[Extraction de Données]
+```
+
+## 🔒 Sécurité
+
+### 🛡️ Mesures de Sécurité Implémentées
+
+- ✅ **Authentification sans mot de passe** - Clés cryptographiques locales
+- ✅ **Chiffrement bout en bout** - Données protégées en transit et au repos
+- ✅ **Aucune interface admin** - Pas d'accès privilégié exposé
+- ✅ **Conformité réglementaire** - RGPD, ISO 27001, SecNumCloud
+- ✅ **Audit de sécurité** - Voir [SECURITY_AUDIT.md](docs/SECURITY_AUDIT.md)
+
+### 🔐 Bonnes Pratiques
+
+1. **Variables d'environnement** - Jamais de secrets en dur
+2. **Validation des données** - Schémas Zod pour toutes les entrées
+3. **HTTPS obligatoire** - En production uniquement
+4. **Audit régulier** - `npm audit` avant chaque déploiement
+
+## 🤝 Contribution
+
+### 🚀 Comment Contribuer
+
+1. **Fork** le repository
+2. **Créer** une branche feature (`git checkout -b feature/amazing-feature`)
+3. **Commit** vos changements (`git commit -m 'Add amazing feature'`)
+4. **Push** vers la branche (`git push origin feature/amazing-feature`)
+5. **Ouvrir** une Pull Request
+
+### 📝 Standards de Code
+
+- **TypeScript** strict activé
+- **ESLint** pour la qualité du code
+- **Prettier** pour le formatage
+- **Conventional Commits** pour les messages
+
+### 🧪 Tests
+
+```bash
+# Avant de contribuer, assurez-vous que :
+npm run lint          # ✅ Pas d'erreurs ESLint
+npm run type-check    # ✅ Pas d'erreurs TypeScript
+npm run build         # ✅ Build réussi
+```
+
+## 📞 Support
+
+### 🆘 Obtenir de l'Aide
+
+- **📧 Email** : contact@docv.fr
+- **📚 Documentation** : [docs/](docs/)
+- **🐛 Issues** : [GitHub Issues](https://github.com/your-org/docv/issues)
+- **💬 Discussions** : [GitHub Discussions](https://github.com/your-org/docv/discussions)
+
+### 🏢 Entreprise
+
+**4NK** - Pionnier du Web 5.0
+- 🏢 Solutions de souveraineté
+- 🔒 Sécurité de bout en bout
+- 🌐 Architecture distribuée
+
+### 📋 Checklist de Support
+
+Avant de demander de l'aide, vérifiez :
+
+- [ ] Version de Node.js compatible (18.0+)
+- [ ] Dépendances installées (`npm install`)
+- [ ] Variables d'environnement configurées
+- [ ] Logs d'erreur consultés
+- [ ] Documentation parcourue
+
+---
+
+## 📄 Licence
+
+Ce projet est propriétaire et confidentiel. Tous droits réservés à **4NK**.
+
+---
+
+<div align="center">
+
+**🛡️ DocV - Sécurisez votre entreprise avec la GED simple et souveraine**
+
+[![4NK](https://img.shields.io/badge/By-4NK-blue.svg)](https://4nkweb.com)
+[![Contact](https://img.shields.io/badge/Contact-contact@docv.fr-green.svg)](mailto:contact@docv.fr)
+
+</div>

VERSION

@@ -0,0 +1 @@
+v0.1.0

app/actions/contact.ts

@@ -0,0 +1,81 @@
+'use server'
+
+import { sendContactEmail, type ContactFormData } from '@/lib/email'
+import { z } from 'zod'
+
+const contactSchema = z.object({
+  nom: z.string().min(1, 'Le nom est requis'),
+  prenom: z.string().min(1, 'Le prénom est requis'),
+  email: z.string().email('Email invalide'),
+  telephone: z.string().optional(),
+  entreprise: z.string().optional(),
+  fonction: z.string().optional(),
+  typeProjet: z.string().optional(),
+  budget: z.string().optional(),
+  delai: z.string().optional(),
+  description: z.string().min(10, 'La description doit contenir au moins 10 caractères'),
+  objectifs: z.string().optional(),
+  contraintes: z.string().optional(),
+  services: z.array(z.string()),
+  demo: z.boolean(),
+  accompagnement: z.boolean(),
+})
+
+export async function submitContactForm(formData: FormData) {
+  try {
+    console.log('Traitement formulaire contact')
+
+    // Extraction des données
+    const rawData = {
+      nom: (formData.get('nom') as string || '').trim(),
+      prenom: (formData.get('prenom') as string || '').trim(),
+      email: (formData.get('email') as string || '').trim(),
+      telephone: (formData.get('telephone') as string || '').trim() || undefined,
+      entreprise: (formData.get('entreprise') as string || '').trim() || undefined,
+      fonction: (formData.get('fonction') as string || '').trim() || undefined,
+      typeProjet: (formData.get('typeProjet') as string) || undefined,
+      budget: (formData.get('budget') as string) || undefined,
+      delai: (formData.get('delai') as string) || undefined,
+      description: (formData.get('description') as string || '').trim(),
+      objectifs: (formData.get('objectifs') as string || '').trim() || undefined,
+      contraintes: (formData.get('contraintes') as string || '').trim() || undefined,
+      services: formData.getAll('services') as string[],
+      demo: formData.get('demo') === 'true',
+      accompagnement: formData.get('accompagnement') === 'true',
+    }
+
+    // Validation
+    const validatedData = contactSchema.parse(rawData)
+
+    // Envoi email
+    const result = await sendContactEmail(validatedData as ContactFormData)
+
+    if (result.success) {
+      return { 
+        success: true, 
+        message: 'Votre message a été envoyé avec succès. Nous vous recontacterons sous 24h.' 
+      }
+    } else {
+      return { 
+        success: false, 
+        message: result.error || 'Une erreur est survenue lors de l\'envoi.' 
+      }
+    }
+
+  } catch (error: any) {
+    console.error('Erreur formulaire contact:', error.message)
+    
+    if (error instanceof z.ZodError) {
+      const errorMessages = error.errors.map(e => e.message).join(', ')
+      return { 
+        success: false, 
+        message: `Données invalides: ${errorMessages}`
+      }
+    }
+    
+    return { 
+      success: false, 
+      message: 'Une erreur inattendue est survenue.' 
+    }
+  }
+}

app/actions/formation.ts

@@ -0,0 +1,91 @@
+'use server'
+
+import { sendFormationEmail, type FormationFormData } from '@/lib/email'
+import { z } from 'zod'
+
+const formationSchema = z.object({
+  entreprise: z.string().min(1, 'Le nom de l\'entreprise est requis'),
+  secteur: z.string().optional(),
+  taille: z.string().optional(),
+  siret: z.string().optional(),
+  nom: z.string().min(1, 'Le nom est requis'),
+  prenom: z.string().min(1, 'Le prénom est requis'),
+  fonction: z.string().optional(),
+  email: z.string().email('Email invalide'),
+  telephone: z.string().optional(),
+  formations: z.array(z.string()),
+  modalite: z.string().optional(),
+  participants: z.string().optional(),
+  dates: z.string().optional(),
+  lieu: z.string().optional(),
+  objectifs: z.string().optional(),
+  niveau: z.string().optional(),
+  contraintes: z.string().optional(),
+  certification: z.boolean(),
+  support: z.boolean(),
+  accompagnement: z.boolean(),
+})
+
+export async function submitFormationForm(formData: FormData) {
+  try {
+    console.log('Traitement formulaire formation')
+
+    // Extraction des données
+    const rawData = {
+      entreprise: (formData.get('entreprise') as string)?.trim() || '',
+      secteur: (formData.get('secteur') as string)?.trim() || undefined,
+      taille: (formData.get('taille') as string) || undefined,
+      siret: (formData.get('siret') as string)?.trim() || undefined,
+      nom: (formData.get('nom') as string)?.trim() || '',
+      prenom: (formData.get('prenom') as string)?.trim() || '',
+      fonction: (formData.get('fonction') as string)?.trim() || undefined,
+      email: (formData.get('email') as string)?.trim() || '',
+      telephone: (formData.get('telephone') as string)?.trim() || undefined,
+      formations: formData.getAll('formations') as string[],
+      modalite: (formData.get('modalite') as string) || undefined,
+      participants: (formData.get('participants') as string) || undefined,
+      dates: (formData.get('dates') as string)?.trim() || undefined,
+      lieu: (formData.get('lieu') as string)?.trim() || undefined,
+      objectifs: (formData.get('objectifs') as string)?.trim() || undefined,
+      niveau: (formData.get('niveau') as string) || undefined,
+      contraintes: (formData.get('contraintes') as string)?.trim() || undefined,
+      certification: formData.get('certification') === 'true',
+      support: formData.get('support') === 'true',
+      accompagnement: formData.get('accompagnement') === 'true',
+    }
+
+    // Validation
+    const validatedData = formationSchema.parse(rawData)
+
+    // Envoi email
+    const result = await sendFormationEmail(validatedData as FormationFormData)
+
+    if (result.success) {
+      return { 
+        success: true, 
+        message: 'Votre demande de devis a été envoyée avec succès. Nous vous recontacterons sous 24h.' 
+      }
+    } else {
+      return { 
+        success: false, 
+        message: result.error || 'Une erreur est survenue lors de l\'envoi.' 
+      }
+    }
+
+  } catch (error: any) {
+    console.error('Erreur formulaire formation:', error.message)
+    
+    if (error instanceof z.ZodError) {
+      const errorMessages = error.errors.map(e => e.message).join(', ')
+      return { 
+        success: false, 
+        message: `Données invalides: ${errorMessages}`
+      }
+    }
+    
+    return { 
+      success: false, 
+      message: 'Une erreur inattendue est survenue.' 
+    }
+  }
+}

app/contact/page.tsx

@@ -0,0 +1,509 @@
+'use client'
+
+import { useState } from 'react'
+import Link from "next/link"
+import { Button } from "@/components/ui/button"
+import { Card, CardContent, CardDescription, CardHeader, CardTitle } from "@/components/ui/card"
+import { Input } from "@/components/ui/input"
+import { Label } from "@/components/ui/label"
+import { Badge } from "@/components/ui/badge"
+import { Textarea } from "@/components/ui/textarea"
+import { Checkbox } from "@/components/ui/checkbox"
+import { RadioGroup, RadioGroupItem } from "@/components/ui/radio-group"
+import { Select, SelectContent, SelectItem, SelectTrigger, SelectValue } from "@/components/ui/select"
+import { Shield, ArrowLeft, Mail, User, MessageSquare, CheckCircle, Lightbulb, Loader2 } from 'lucide-react'
+import { submitContactForm } from '@/app/actions/contact'
+
+export default function ContactPage() {
+  const [formData, setFormData] = useState({
+    nom: '',
+    prenom: '',
+    email: '',
+    telephone: '',
+    entreprise: '',
+    fonction: '',
+    typeProjet: '',
+    budget: '',
+    delai: '',
+    description: '',
+    objectifs: '',
+    contraintes: '',
+    services: [] as string[],
+    demo: false,
+    accompagnement: false
+  })
+
+  const [isSubmitting, setIsSubmitting] = useState(false)
+  const [submitResult, setSubmitResult] = useState<{ success: boolean; message: string } | null>(null)
+
+  const handleServiceChange = (service: string, checked: boolean) => {
+    if (checked) {
+      setFormData(prev => ({
+        ...prev,
+        services: [...prev.services, service]
+      }))
+    } else {
+      setFormData(prev => ({
+        ...prev,
+        services: prev.services.filter(s => s !== service)
+      }))
+    }
+  }
+
+  const handleSubmit = async (e: React.FormEvent) => {
+    e.preventDefault()
+    
+    // Validation côté client
+    if (formData.description.trim().length < 10) {
+      setSubmitResult({
+        success: false,
+        message: 'La description doit contenir au moins 10 caractères.'
+      })
+      return
+    }
+
+    setIsSubmitting(true)
+    setSubmitResult(null)
+
+    try {
+      const formDataToSend = new FormData()
+      
+      // Ajout de tous les champs au FormData
+      Object.entries(formData).forEach(([key, value]) => {
+        if (key === 'services') {
+          value.forEach((service: string) => formDataToSend.append('services', service))
+        } else if (typeof value === 'boolean') {
+          formDataToSend.append(key, value.toString())
+        } else {
+          formDataToSend.append(key, value)
+        }
+      })
+
+      const result = await submitContactForm(formDataToSend)
+      setSubmitResult(result)
+      
+      if (result.success) {
+        // Reset du formulaire en cas de succès
+        setFormData({
+          nom: '',
+          prenom: '',
+          email: '',
+          telephone: '',
+          entreprise: '',
+          fonction: '',
+          typeProjet: '',
+          budget: '',
+          delai: '',
+          description: '',
+          objectifs: '',
+          contraintes: '',
+          services: [],
+          demo: false,
+          accompagnement: false
+        })
+      }
+    } catch (error) {
+      setSubmitResult({
+        success: false,
+        message: 'Une erreur inattendue est survenue. Veuillez réessayer.'
+      })
+    } finally {
+      setIsSubmitting(false)
+    }
+  }
+
+  if (submitResult?.success) {
+    return (
+      <div className="min-h-screen bg-gradient-to-br from-slate-50 to-blue-50 flex items-center justify-center p-4">
+        <Card className="w-full max-w-2xl border-2 border-green-200 bg-green-50">
+          <CardHeader className="text-center">
+            <CheckCircle className="h-16 w-16 text-green-600 mx-auto mb-4" />
+            <CardTitle className="text-3xl text-green-700">Message envoyé !</CardTitle>
+            <CardDescription className="text-lg">
+              {submitResult.message}
+            </CardDescription>
+          </CardHeader>
+          <CardContent className="text-center space-y-6">
+            <div className="bg-white p-6 rounded-lg border border-green-200">
+              <h3 className="font-semibold text-green-800 mb-3">Prochaines étapes :</h3>
+              <ul className="text-left space-y-2 text-gray-700">
+                <li>• Un expert DocV vous contactera sous 24h</li>
+                <li>• Analyse de votre projet et de vos besoins</li>
+                <li>• Proposition de solution personnalisée</li>
+                <li>• Planification d'une démonstration si demandée</li>
+              </ul>
+            </div>
+            <div className="space-y-4">
+              <p className="text-gray-600">
+                <strong>Contact direct :</strong> contact@docv.fr
+              </p>
+              <div className="flex flex-col sm:flex-row gap-4 justify-center">
+                <Link href="/">
+                  <Button variant="outline">Retour à l'accueil</Button>
+                </Link>
+                <Link href="/formation">
+                  <Button>Découvrir nos formations</Button>
+                </Link>
+              </div>
+            </div>
+          </CardContent>
+        </Card>
+      </div>
+    )
+  }
+
+  return (
+    <div className="min-h-screen bg-gradient-to-br from-slate-50 to-blue-50">
+      {/* Header */}
+      <header className="border-b bg-white/80 backdrop-blur-sm">
+        <div className="container mx-auto px-4 py-4 flex justify-between items-center">
+          <Link href="/" className="flex items-center space-x-2">
+            <Shield className="h-8 w-8 text-blue-600" />
+            <span className="text-2xl font-bold text-gray-900">DocV</span>
+            <Badge variant="secondary" className="ml-2">By 4NK</Badge>
+          </Link>
+          <Link href="/" className="flex items-center text-blue-600 hover:text-blue-700">
+            <ArrowLeft className="h-4 w-4 mr-2" />
+            Retour à l'accueil
+          </Link>
+        </div>
+      </header>
+
+      <div className="container mx-auto px-4 py-8">
+        <div className="max-w-4xl mx-auto">
+          {/* Hero */}
+          <div className="text-center mb-8">
+            <h1 className="text-4xl font-bold text-gray-900 mb-4">
+              Contactez-nous pour <span className="text-blue-600">votre projet</span>
+            </h1>
+            <p className="text-xl text-gray-600 max-w-2xl mx-auto">
+              Discutons de votre projet de souveraineté numérique. Nos experts vous accompagnent 
+              dans la mise en œuvre de solutions DocV adaptées à vos besoins.
+            </p>
+          </div>
+
+          {/* Message d'erreur */}
+          {submitResult && !submitResult.success && (
+            <div className="mb-6 p-4 bg-red-50 border border-red-200 rounded-lg">
+              <p className="text-red-700">{submitResult.message}</p>
+            </div>
+          )}
+
+          <form onSubmit={handleSubmit} className="space-y-8">
+            {/* Informations Contact */}
+            <Card>
+              <CardHeader>
+                <CardTitle className="flex items-center">
+                  <User className="h-5 w-5 mr-2 text-blue-600" />
+                  Vos informations
+                </CardTitle>
+                <CardDescription>
+                  Renseignez vos coordonnées pour que nous puissions vous recontacter
+                </CardDescription>
+              </CardHeader>
+              <CardContent className="space-y-4">
+                <div className="grid md:grid-cols-2 gap-4">
+                  <div className="space-y-2">
+                    <Label htmlFor="nom">Nom *</Label>
+                    <Input
+                      id="nom"
+                      value={formData.nom}
+                      onChange={(e) => setFormData(prev => ({ ...prev, nom: e.target.value }))}
+                      placeholder="Votre nom"
+                      required
+                    />
+                  </div>
+                  <div className="space-y-2">
+                    <Label htmlFor="prenom">Prénom *</Label>
+                    <Input
+                      id="prenom"
+                      value={formData.prenom}
+                      onChange={(e) => setFormData(prev => ({ ...prev, prenom: e.target.value }))}
+                      placeholder="Votre prénom"
+                      required
+                    />
+                  </div>
+                </div>
+                <div className="grid md:grid-cols-2 gap-4">
+                  <div className="space-y-2">
+                    <Label htmlFor="email">Email *</Label>
+                    <Input
+                      id="email"
+                      type="email"
+                      value={formData.email}
+                      onChange={(e) => setFormData(prev => ({ ...prev, email: e.target.value }))}
+                      placeholder="votre.email@entreprise.com"
+                      required
+                    />
+                  </div>
+                  <div className="space-y-2">
+                    <Label htmlFor="telephone">Téléphone</Label>
+                    <Input
+                      id="telephone"
+                      type="tel"
+                      value={formData.telephone}
+                      onChange={(e) => setFormData(prev => ({ ...prev, telephone: e.target.value }))}
+                      placeholder="01 23 45 67 89"
+                    />
+                  </div>
+                </div>
+                <div className="grid md:grid-cols-2 gap-4">
+                  <div className="space-y-2">
+                    <Label htmlFor="entreprise">Entreprise</Label>
+                    <Input
+                      id="entreprise"
+                      value={formData.entreprise}
+                      onChange={(e) => setFormData(prev => ({ ...prev, entreprise: e.target.value }))}
+                      placeholder="Nom de votre entreprise"
+                    />
+                  </div>
+                  <div className="space-y-2">
+                    <Label htmlFor="fonction">Fonction</Label>
+                    <Input
+                      id="fonction"
+                      value={formData.fonction}
+                      onChange={(e) => setFormData(prev => ({ ...prev, fonction: e.target.value }))}
+                      placeholder="Votre fonction"
+                    />
+                  </div>
+                </div>
+              </CardContent>
+            </Card>
+
+            {/* Type de projet */}
+            <Card>
+              <CardHeader>
+                <CardTitle className="flex items-center">
+                  <Lightbulb className="h-5 w-5 mr-2 text-blue-600" />
+                  Votre projet
+                </CardTitle>
+                <CardDescription>
+                  Décrivez-nous votre projet et vos besoins
+                </CardDescription>
+              </CardHeader>
+              <CardContent className="space-y-4">
+                <div className="space-y-3">
+                  <Label>Type de projet</Label>
+                  <RadioGroup
+                    value={formData.typeProjet}
+                    onValueChange={(value) => setFormData(prev => ({ ...prev, typeProjet: value }))}
+                  >
+                    <div className="flex items-center space-x-2">
+                      <RadioGroupItem value="integration" id="integration" />
+                      <Label htmlFor="integration">Intégration DocV dans notre système</Label>
+                    </div>
+                    <div className="flex items-center space-x-2">
+                      <RadioGroupItem value="developpement" id="developpement" />
+                      <Label htmlFor="developpement">Développement d'une solution sur-mesure</Label>
+                    </div>
+                    <div className="flex items-center space-x-2">
+                      <RadioGroupItem value="migration" id="migration" />
+                      <Label htmlFor="migration">Migration vers une GED souveraine</Label>
+                    </div>
+                    <div className="flex items-center space-x-2">
+                      <RadioGroupItem value="conseil" id="conseil" />
+                      <Label htmlFor="conseil">Conseil en souveraineté numérique</Label>
+                    </div>
+                    <div className="flex items-center space-x-2">
+                      <RadioGroupItem value="autre" id="autre" />
+                      <Label htmlFor="autre">Autre</Label>
+                    </div>
+                  </RadioGroup>
+                </div>
+
+                <div className="grid md:grid-cols-2 gap-4">
+                  <div className="space-y-2">
+                    <Label htmlFor="budget">Budget estimé</Label>
+                    <Select onValueChange={(value) => setFormData(prev => ({ ...prev, budget: value }))}>
+                      <SelectTrigger>
+                        <SelectValue placeholder="Sélectionnez une fourchette" />
+                      </SelectTrigger>
+                      <SelectContent>
+                        <SelectItem value="<10k">Moins de 10k€</SelectItem>
+                        <SelectItem value="10k-50k">10k€ - 50k€</SelectItem>
+                        <SelectItem value="50k-100k">50k€ - 100k€</SelectItem>
+                        <SelectItem value="100k-500k">100k€ - 500k€</SelectItem>
+                        <SelectItem value=">500k">Plus de 500k€</SelectItem>
+                        <SelectItem value="non-defini">Non défini</SelectItem>
+                      </SelectContent>
+                    </Select>
+                  </div>
+                  <div className="space-y-2">
+                    <Label htmlFor="delai">Délai souhaité</Label>
+                    <Select onValueChange={(value) => setFormData(prev => ({ ...prev, delai: value }))}>
+                      <SelectTrigger>
+                        <SelectValue placeholder="Échéance du projet" />
+                      </SelectTrigger>
+                      <SelectContent>
+                        <SelectItem value="urgent">Urgent (&lt; 1 mois)</SelectItem>
+                        <SelectItem value="court">Court terme (1-3 mois)</SelectItem>
+                        <SelectItem value="moyen">Moyen terme (3-6 mois)</SelectItem>
+                        <SelectItem value="long">Long terme ({'> 6 mois'})</SelectItem>
+                        <SelectItem value="flexible">Flexible</SelectItem>
+                      </SelectContent>
+                    </Select>
+                  </div>
+                </div>
+              </CardContent>
+            </Card>
+
+            {/* Services souhaités */}
+            <Card>
+              <CardHeader>
+                <CardTitle>Services souhaités</CardTitle>
+                <CardDescription>
+                  Sélectionnez les services qui vous intéressent
+                </CardDescription>
+              </CardHeader>
+              <CardContent className="space-y-3">
+                <div className="flex items-center space-x-2">
+                  <Checkbox
+                    id="ged-souveraine"
+                    checked={formData.services.includes('ged-souveraine')}
+                    onCheckedChange={(checked) => handleServiceChange('ged-souveraine', checked as boolean)}
+                  />
+                  <Label htmlFor="ged-souveraine">GED souveraine DocV</Label>
+                </div>
+                <div className="flex items-center space-x-2">
+                  <Checkbox
+                    id="integration-marque-blanche"
+                    checked={formData.services.includes('integration-marque-blanche')}
+                    onCheckedChange={(checked) => handleServiceChange('integration-marque-blanche', checked as boolean)}
+                  />
+                  <Label htmlFor="integration-marque-blanche">Intégration marque blanche</Label>
+                </div>
+                <div className="flex items-center space-x-2">
+                  <Checkbox
+                    id="solutions-open-source"
+                    checked={formData.services.includes('solutions-open-source')}
+                    onCheckedChange={(checked) => handleServiceChange('solutions-open-source', checked as boolean)}
+                  />
+                  <Label htmlFor="solutions-open-source">Solutions open source</Label>
+                </div>
+                <div className="flex items-center space-x-2">
+                  <Checkbox
+                    id="formation"
+                    checked={formData.services.includes('formation')}
+                    onCheckedChange={(checked) => handleServiceChange('formation', checked as boolean)}
+                  />
+                  <Label htmlFor="formation">Formation et accompagnement</Label>
+                </div>
+                <div className="flex items-center space-x-2">
+                  <Checkbox
+                    id="audit"
+                    checked={formData.services.includes('audit')}
+                    onCheckedChange={(checked) => handleServiceChange('audit', checked as boolean)}
+                  />
+                  <Label htmlFor="audit">Audit de sécurité</Label>
+                </div>
+              </CardContent>
+            </Card>
+
+            {/* Description détaillée */}
+            <Card>
+              <CardHeader>
+                <CardTitle className="flex items-center">
+                  <MessageSquare className="h-5 w-5 mr-2 text-blue-600" />
+                  Description du projet
+                </CardTitle>
+              </CardHeader>
+              <CardContent className="space-y-4">
+                <div className="space-y-2">
+                  <Label htmlFor="description">Description générale *</Label>
+                  <Textarea
+                    id="description"
+                    value={formData.description}
+                    onChange={(e) => setFormData(prev => ({ ...prev, description: e.target.value }))}
+                    placeholder="Décrivez votre projet, vos besoins, votre contexte... (minimum 10 caractères)"
+                    rows={4}
+                    required
+                    className={formData.description.trim().length > 0 && formData.description.trim().length < 10 ? 'border-red-300' : ''}
+                  />
+                  <p className="text-sm text-gray-500">
+                    {formData.description.trim().length}/10 caractères minimum
+                  </p>
+                </div>
+
+                <div className="space-y-2">
+                  <Label htmlFor="objectifs">Objectifs principaux</Label>
+                  <Textarea
+                    id="objectifs"
+                    value={formData.objectifs}
+                    onChange={(e) => setFormData(prev => ({ ...prev, objectifs: e.target.value }))}
+                    placeholder="Quels sont vos objectifs avec ce projet ?"
+                    rows={3}
+                  />
+                </div>
+
+                <div className="space-y-2">
+                  <Label htmlFor="contraintes">Contraintes techniques ou organisationnelles</Label>
+                  <Textarea
+                    id="contraintes"
+                    value={formData.contraintes}
+                    onChange={(e) => setFormData(prev => ({ ...prev, contraintes: e.target.value }))}
+                    placeholder="Contraintes techniques, réglementaires, budgétaires..."
+                    rows={2}
+                  />
+                </div>
+              </CardContent>
+            </Card>
+
+            {/* Options */}
+            <Card>
+              <CardHeader>
+                <CardTitle>Options</CardTitle>
+              </CardHeader>
+              <CardContent className="space-y-3">
+                <div className="flex items-center space-x-2">
+                  <Checkbox
+                    id="demo"
+                    checked={formData.demo}
+                    onCheckedChange={(checked) => setFormData(prev => ({ ...prev, demo: checked as boolean }))}
+                  />
+                  <Label htmlFor="demo">
+                    Je souhaite une démonstration de DocV
+                  </Label>
+                </div>
+                <div className="flex items-center space-x-2">
+                  <Checkbox
+                    id="accompagnement"
+                    checked={formData.accompagnement}
+                    onCheckedChange={(checked) => setFormData(prev => ({ ...prev, accompagnement: checked as boolean }))}
+                  />
+                  <Label htmlFor="accompagnement">
+                    Je souhaite un accompagnement personnalisé
+                  </Label>
+                </div>
+              </CardContent>
+            </Card>
+
+            {/* Submit */}
+            <div className="text-center">
+              <Button 
+                type="submit" 
+                size="lg" 
+                className="text-lg px-12 py-3"
+                disabled={isSubmitting || formData.description.trim().length < 10}
+              >
+                {isSubmitting ? (
+                  <>
+                    <Loader2 className="h-5 w-5 mr-2 animate-spin" />
+                    Envoi en cours...
+                  </>
+                ) : (
+                  <>
+                    <Mail className="h-5 w-5 mr-2" />
+                    Envoyer la demande
+                  </>
+                )}
+              </Button>
+              <p className="text-sm text-gray-600 mt-4">
+                Réponse sous 24h • Contact direct : contact@docv.fr
+              </p>
+            </div>
+          </form>
+        </div>
+      </div>
+    </div>
+  )
+}

app/dashboard/chat/loading.tsx

@@ -0,0 +1,79 @@
+import { Skeleton } from "@/components/ui/skeleton"
+
+export default function ChatLoading() {
+  return (
+    <div className="h-[calc(100vh-8rem)] flex">
+      {/* Sidebar */}
+      <div className="w-80 border-r bg-white flex flex-col">
+        <div className="p-4 border-b">
+          <div className="flex items-center justify-between mb-4">
+            <Skeleton className="h-6 w-24" />
+            <Skeleton className="h-8 w-8" />
+          </div>
+          <Skeleton className="h-10 w-full" />
+        </div>
+
+        <div className="flex-1 overflow-y-auto">
+          {[...Array(5)].map((_, i) => (
+            <div key={i} className="p-4 border-b">
+              <div className="flex items-start space-x-3">
+                <Skeleton className="h-12 w-12 rounded-full" />
+                <div className="flex-1">
+                  <div className="flex items-center justify-between">
+                    <Skeleton className="h-4 w-24" />
+                    <Skeleton className="h-3 w-12" />
+                  </div>
+                  <Skeleton className="h-3 w-32 mt-2" />
+                  <Skeleton className="h-3 w-16 mt-1" />
+                </div>
+              </div>
+            </div>
+          ))}
+        </div>
+      </div>
+
+      {/* Main Chat Area */}
+      <div className="flex-1 flex flex-col">
+        {/* Header */}
+        <div className="p-4 border-b bg-white">
+          <div className="flex items-center justify-between">
+            <div className="flex items-center space-x-3">
+              <Skeleton className="h-10 w-10 rounded-full" />
+              <div>
+                <Skeleton className="h-4 w-32" />
+                <Skeleton className="h-3 w-20 mt-1" />
+              </div>
+            </div>
+            <div className="flex items-center space-x-2">
+              <Skeleton className="h-8 w-8" />
+              <Skeleton className="h-8 w-8" />
+              <Skeleton className="h-8 w-8" />
+            </div>
+          </div>
+        </div>
+
+        {/* Messages */}
+        <div className="flex-1 overflow-y-auto p-4 space-y-4 bg-gray-50">
+          {[...Array(6)].map((_, i) => (
+            <div key={i} className={`flex ${i % 2 === 0 ? "justify-start" : "justify-end"}`}>
+              <div className={`max-w-xs lg:max-w-md p-4 rounded-lg ${i % 2 === 0 ? "bg-white" : "bg-blue-600"}`}>
+                <Skeleton className={`h-4 w-48 ${i % 2 !== 0 ? "bg-blue-500" : ""}`} />
+                <Skeleton className={`h-3 w-16 mt-2 ${i % 2 !== 0 ? "bg-blue-500" : ""}`} />
+              </div>
+            </div>
+          ))}
+        </div>
+
+        {/* Input */}
+        <div className="p-4 border-t bg-white">
+          <div className="flex items-end space-x-2">
+            <Skeleton className="h-8 w-8" />
+            <Skeleton className="h-20 flex-1" />
+            <Skeleton className="h-8 w-8" />
+            <Skeleton className="h-8 w-16" />
+          </div>
+        </div>
+      </div>
+    </div>
+  )
+}

app/dashboard/chat/page.tsx

@@ -0,0 +1,607 @@
+"use client"
+
+import { useState, useEffect } from "react"
+import { Badge } from "@/components/ui/badge"
+import { Button } from "@/components/ui/button"
+import { Input } from "@/components/ui/input"
+import { Textarea } from "@/components/ui/textarea"
+import {
+  MessageSquare,
+  Search,
+  Plus,
+  Send,
+  Paperclip,
+  Smile,
+  Phone,
+  Video,
+  MoreHorizontal,
+  Users,
+  Circle,
+  CheckCheck,
+  Clock,
+  File,
+  Download,
+  Brain,
+  Shield,
+  TrendingUp,
+  CheckCircle,
+  FileText,
+  BarChart3,
+  Zap,
+} from "lucide-react"
+import { useSearchParams } from "next/navigation"
+
+export default function ChatPage() {
+  const [selectedConversation, setSelectedConversation] = useState("1")
+  const [newMessage, setNewMessage] = useState("")
+  const [searchTerm, setSearchTerm] = useState("")
+
+  const searchParams = useSearchParams()
+  const userId = searchParams.get("user")
+  const messageType = searchParams.get("message")
+  const groupType = searchParams.get("type")
+
+  useEffect(() => {
+    // Gérer les nouveaux messages depuis les autres pages
+    if (messageType === "new") {
+      if (userId) {
+        // Message individuel
+        const messageData = sessionStorage.getItem("newMessage")
+        if (messageData) {
+          const data = JSON.parse(messageData)
+          console.log("Nouveau message individuel:", data)
+
+          // Créer ou ouvrir la conversation avec cet utilisateur
+          setSelectedConversation(userId)
+
+          // Ajouter le message pré-rempli
+          setNewMessage(`${data.subject ? `[${data.subject}] ` : ""}${data.content}`)
+
+          // Nettoyer le sessionStorage
+          sessionStorage.removeItem("newMessage")
+
+          // Notification
+          showNotification("info", `Conversation ouverte avec ${data.userName}`)
+        }
+      } else if (groupType === "group") {
+        // Message de groupe
+        const groupData = sessionStorage.getItem("newGroupMessage")
+        if (groupData) {
+          const data = JSON.parse(groupData)
+          console.log("Nouveau message de groupe:", data)
+
+          // Créer une nouvelle conversation de groupe
+          const groupName = `Groupe (${data.users.length} membres)`
+          setSelectedConversation("group-new")
+
+          // Ajouter le message pré-rempli
+          setNewMessage(`${data.subject ? `[${data.subject}] ` : ""}${data.content}`)
+
+          // Nettoyer le sessionStorage
+          sessionStorage.removeItem("newGroupMessage")
+
+          // Notification
+          showNotification("info", `Conversation de groupe créée avec ${data.users.length} utilisateur(s)`)
+        }
+      }
+    }
+  }, [userId, messageType, groupType])
+
+  const showNotification = (type: "success" | "error" | "info", message: string) => {
+    // Implémenter la notification (peut utiliser toast ou état local)
+    console.log(`${type.toUpperCase()}: ${message}`)
+  }
+
+  const conversations = [
+    {
+      id: "1",
+      name: "Marie Dubois",
+      type: "direct",
+      avatar: "MD",
+      lastMessage: "Parfait, merci pour la validation !",
+      lastMessageTime: "14:32",
+      unreadCount: 0,
+      isOnline: true,
+      isTyping: false,
+    },
+    {
+      id: "2",
+      name: "Équipe Juridique",
+      type: "group",
+      avatar: "EJ",
+      lastMessage: "IA DocV: Analyse terminée pour Contrat_Client_ABC.pdf",
+      lastMessageTime: "13:45",
+      unreadCount: 1,
+      isOnline: false,
+      isTyping: false,
+      members: 5,
+    },
+    {
+      id: "3",
+      name: "Sophie Laurent",
+      type: "direct",
+      avatar: "SL",
+      lastMessage: "Pouvez-vous m'envoyer le rapport ?",
+      lastMessageTime: "12:20",
+      unreadCount: 1,
+      isOnline: false,
+      isTyping: false,
+    },
+    {
+      id: "4",
+      name: "Direction",
+      type: "group",
+      avatar: "DIR",
+      lastMessage: "Réunion reportée à demain 10h",
+      lastMessageTime: "11:15",
+      unreadCount: 0,
+      isOnline: false,
+      isTyping: false,
+      members: 3,
+    },
+    {
+      id: "5",
+      name: "Thomas Rousseau",
+      type: "direct",
+      avatar: "TR",
+      lastMessage: "Merci pour l'info !",
+      lastMessageTime: "Hier",
+      unreadCount: 0,
+      isOnline: true,
+      isTyping: true,
+    },
+  ]
+
+  const messages = [
+    {
+      id: "1",
+      senderId: "marie",
+      senderName: "Marie Dubois",
+      content: "Bonjour ! J'ai besoin de votre avis sur le nouveau contrat client.",
+      timestamp: "14:20",
+      type: "text",
+      status: "read",
+    },
+    {
+      id: "2",
+      senderId: "me",
+      senderName: "Moi",
+      content: "Bien sûr, pouvez-vous me l'envoyer ?",
+      timestamp: "14:22",
+      type: "text",
+      status: "read",
+    },
+    {
+      id: "3",
+      senderId: "marie",
+      senderName: "Marie Dubois",
+      content: "",
+      timestamp: "14:25",
+      type: "file",
+      fileName: "Contrat_Client_ABC.pdf",
+      fileSize: "2.3 MB",
+      status: "read",
+    },
+    {
+      id: "4",
+      senderId: "me",
+      senderName: "Moi",
+      content: "J'ai relu le contrat, tout me semble correct. Les clauses de confidentialité sont bien définies.",
+      timestamp: "14:30",
+      type: "text",
+      status: "read",
+    },
+    {
+      id: "5",
+      senderId: "marie",
+      senderName: "Marie Dubois",
+      content: "Parfait, merci pour la validation !",
+      timestamp: "14:32",
+      type: "text",
+      status: "delivered",
+    },
+    {
+      id: "6",
+      senderId: "ai",
+      senderName: "IA DocV",
+      content: `📄 **Analyse IA du document "Contrat_Client_ABC.pdf"**
+
+**Type de document :** PDF (2.3 MB)
+**Statut :** ✅ Validé
+**Dernière modification :** Il y a 2 heures
+
+**📊 Analyse du contenu :**
+• Document juridique détecté avec haute précision
+• 3 tag(s) identifié(s) : contrat, client, juridique
+• Résumé automatique disponible
+• 47 pages analysées
+• 12 clauses contractuelles détectées
+
+**🎯 Métriques de qualité :**
+• Lisibilité : 92%
+• Conformité juridique : 100%
+• Sécurité documentaire : Maximale
+• Complétude des informations : 95%
+
+**🔍 Points clés identifiés :**
+• Durée du contrat : 12 mois
+• Montant total : 150 000€ HT
+• Clauses de confidentialité : ✅ Présentes et conformes
+• Propriété intellectuelle : ✅ Bien définie
+• Conditions de résiliation : ✅ Équilibrées
+
+**🛡️ Analyse de conformité RGPD :**
+• Données personnelles : ⚠️ Détectées (coordonnées client)
+• Durée de conservation : Conforme (7 ans)
+• Droit à l'oubli : Applicable après expiration
+• Consentement : ✅ Explicite
+
+**⚡ Recommandations :**
+• ✅ Document prêt pour signature
+• 📋 Archivage permanent recommandé
+• 🔄 Révision suggérée dans 11 mois
+• 📧 Notification client automatique activée
+
+**📈 Score global : 94/100**
+
+*Analyse générée automatiquement par l'IA DocV - Fiabilité : 98%*`,
+      timestamp: "14:35",
+      type: "ai_analysis",
+      status: "delivered",
+      analysisType: "document",
+      documentName: "Contrat_Client_ABC.pdf",
+      confidence: 98,
+      processingTime: "2.3s",
+    },
+    {
+      id: "7",
+      senderId: "ai",
+      senderName: "IA DocV",
+      content: `🔍 **Analyse comparative - Dossier Contrats**
+
+**📊 Analyse de 8 documents similaires :**
+• Contrats clients : 5 documents
+• Avenants : 2 documents  
+• Conditions générales : 1 document
+
+**📈 Tendances identifiées :**
+• Montant moyen des contrats : +15% vs trimestre précédent
+• Durée moyenne : 14 mois (stable)
+• Taux de renouvellement : 87% (↗️ +5%)
+
+**⚠️ Points d'attention :**
+• 2 contrats expirent dans les 30 jours
+• 1 clause de révision tarifaire à activer
+• Mise à jour RGPD requise sur 3 documents
+
+**🎯 Actions recommandées :**
+1. Planifier renouvellement contrats Q1 2024
+2. Standardiser les clauses de confidentialité
+3. Créer un modèle basé sur ce contrat (performance optimale)
+
+*Analyse prédictive activée - Prochaine révision : 15 février 2024*`,
+      timestamp: "14:37",
+      type: "ai_analysis",
+      status: "delivered",
+      analysisType: "comparative",
+      confidence: 95,
+      processingTime: "4.1s",
+    },
+  ]
+
+  const filteredConversations = conversations.filter((conv) =>
+    conv.name.toLowerCase().includes(searchTerm.toLowerCase()),
+  )
+
+  const currentConversation = conversations.find((conv) => conv.id === selectedConversation)
+
+  const handleSendMessage = () => {
+    if (newMessage.trim()) {
+      // Ici on ajouterait la logique pour envoyer le message
+      console.log("Sending message:", newMessage)
+      setNewMessage("")
+    }
+  }
+
+  const getStatusIcon = (status: string) => {
+    switch (status) {
+      case "sent":
+        return <Clock className="h-3 w-3 text-gray-400" />
+      case "delivered":
+        return <CheckCheck className="h-3 w-3 text-gray-400" />
+      case "read":
+        return <CheckCheck className="h-3 w-3 text-blue-500" />
+      default:
+        return null
+    }
+  }
+
+  const getAnalysisIcon = (analysisType: string) => {
+    switch (analysisType) {
+      case "document":
+        return <FileText className="h-4 w-4" />
+      case "comparative":
+        return <BarChart3 className="h-4 w-4" />
+      case "security":
+        return <Shield className="h-4 w-4" />
+      case "performance":
+        return <TrendingUp className="h-4 w-4" />
+      default:
+        return <Brain className="h-4 w-4" />
+    }
+  }
+
+  const renderAIMessage = (message: any) => {
+    return (
+      <div className="flex justify-start">
+        <div className="max-w-4xl">
+          {/* AI Header */}
+          <div className="flex items-center space-x-2 mb-2">
+            <div className="w-8 h-8 bg-gradient-to-r from-purple-500 to-blue-500 rounded-full flex items-center justify-center">
+              <Brain className="h-4 w-4 text-white" />
+            </div>
+            <div className="flex items-center space-x-2">
+              <span className="text-sm font-medium text-gray-900">IA DocV</span>
+              <Badge className="bg-gradient-to-r from-purple-100 to-blue-100 text-purple-700 border-purple-200 text-xs">
+                {getAnalysisIcon(message.analysisType)}
+                <span className="ml-1">
+                  {message.analysisType === "document"
+                    ? "Analyse Document"
+                    : message.analysisType === "comparative"
+                      ? "Analyse Comparative"
+                      : "Analyse IA"}
+                </span>
+              </Badge>
+              {message.confidence && (
+                <Badge className="bg-green-100 text-green-700 border-green-200 text-xs">
+                  <CheckCircle className="h-3 w-3 mr-1" />
+                  {message.confidence}% fiable
+                </Badge>
+              )}
+            </div>
+          </div>
+
+          {/* AI Message Content */}
+          <div className="bg-gradient-to-r from-purple-50 to-blue-50 border border-purple-200 rounded-lg p-4 shadow-sm">
+            <div className="prose prose-sm max-w-none">
+              <div className="whitespace-pre-line text-gray-800 leading-relaxed">{message.content}</div>
+            </div>
+
+            {/* AI Message Footer */}
+            <div className="flex items-center justify-between mt-4 pt-3 border-t border-purple-200">
+              <div className="flex items-center space-x-4 text-xs text-gray-600">
+                <div className="flex items-center space-x-1">
+                  <Zap className="h-3 w-3" />
+                  <span>Traité en {message.processingTime}</span>
+                </div>
+                {message.documentName && (
+                  <div className="flex items-center space-x-1">
+                    <FileText className="h-3 w-3" />
+                    <span>{message.documentName}</span>
+                  </div>
+                )}
+              </div>
+              <div className="flex items-center space-x-2">
+                <span className="text-xs text-purple-600">{message.timestamp}</span>
+                <div>{getStatusIcon(message.status)}</div>
+              </div>
+            </div>
+          </div>
+        </div>
+      </div>
+    )
+  }
+
+  return (
+    <div className="h-[calc(100vh-8rem)] flex">
+      {/* Sidebar - Conversations */}
+      <div className="w-80 border-r bg-white flex flex-col">
+        {/* Header */}
+        <div className="p-4 border-b">
+          <div className="flex items-center justify-between mb-4">
+            <h2 className="text-lg font-semibold">Messages</h2>
+            <Button size="sm">
+              <Plus className="h-4 w-4" />
+            </Button>
+          </div>
+          <div className="relative">
+            <Search className="absolute left-3 top-1/2 transform -translate-y-1/2 text-gray-400 h-4 w-4" />
+            <Input
+              placeholder="Rechercher une conversation..."
+              value={searchTerm}
+              onChange={(e) => setSearchTerm(e.target.value)}
+              className="pl-10"
+            />
+          </div>
+        </div>
+
+        {/* Conversations List */}
+        <div className="flex-1 overflow-y-auto">
+          {filteredConversations.map((conversation) => (
+            <div
+              key={conversation.id}
+              onClick={() => setSelectedConversation(conversation.id)}
+              className={`p-4 border-b cursor-pointer hover:bg-gray-50 ${
+                selectedConversation === conversation.id ? "bg-blue-50 border-r-2 border-blue-500" : ""
+              }`}
+            >
+              <div className="flex items-start space-x-3">
+                <div className="relative">
+                  <div className="w-12 h-12 bg-blue-100 rounded-full flex items-center justify-center">
+                    {conversation.type === "group" ? (
+                      <Users className="h-6 w-6 text-blue-600" />
+                    ) : (
+                      <span className="text-blue-600 font-medium">{conversation.avatar}</span>
+                    )}
+                  </div>
+                  {conversation.isOnline && conversation.type === "direct" && (
+                    <Circle className="absolute -bottom-1 -right-1 h-4 w-4 text-green-500 fill-current" />
+                  )}
+                </div>
+                <div className="flex-1 min-w-0">
+                  <div className="flex items-center justify-between">
+                    <h3 className="font-medium text-gray-900 truncate">{conversation.name}</h3>
+                    <span className="text-xs text-gray-500">{conversation.lastMessageTime}</span>
+                  </div>
+                  <div className="flex items-center justify-between mt-1">
+                    <p className="text-sm text-gray-600 truncate">
+                      {conversation.isTyping ? (
+                        <span className="text-blue-600 italic">En train d'écrire...</span>
+                      ) : (
+                        <span
+                          className={conversation.lastMessage.includes("IA DocV:") ? "text-purple-600 font-medium" : ""}
+                        >
+                          {conversation.lastMessage}
+                        </span>
+                      )}
+                    </p>
+                    {conversation.unreadCount > 0 && (
+                      <Badge
+                        className={`text-white text-xs px-2 py-1 rounded-full ${
+                          conversation.lastMessage.includes("IA DocV:") ? "bg-purple-600" : "bg-blue-600"
+                        }`}
+                      >
+                        {conversation.unreadCount}
+                      </Badge>
+                    )}
+                  </div>
+                  {conversation.type === "group" && (
+                    <p className="text-xs text-gray-500 mt-1">{conversation.members} membres</p>
+                  )}
+                </div>
+              </div>
+            </div>
+          ))}
+        </div>
+      </div>
+
+      {/* Main Chat Area */}
+      <div className="flex-1 flex flex-col">
+        {currentConversation ? (
+          <>
+            {/* Chat Header */}
+            <div className="p-4 border-b bg-white">
+              <div className="flex items-center justify-between">
+                <div className="flex items-center space-x-3">
+                  <div className="relative">
+                    <div className="w-10 h-10 bg-blue-100 rounded-full flex items-center justify-center">
+                      {currentConversation.type === "group" ? (
+                        <Users className="h-5 w-5 text-blue-600" />
+                      ) : (
+                        <span className="text-blue-600 font-medium">{currentConversation.avatar}</span>
+                      )}
+                    </div>
+                    {currentConversation.isOnline && currentConversation.type === "direct" && (
+                      <Circle className="absolute -bottom-1 -right-1 h-3 w-3 text-green-500 fill-current" />
+                    )}
+                  </div>
+                  <div>
+                    <h3 className="font-medium text-gray-900">{currentConversation.name}</h3>
+                    <p className="text-sm text-gray-500">
+                      {currentConversation.type === "group"
+                        ? `${currentConversation.members} membres`
+                        : currentConversation.isOnline
+                          ? "En ligne"
+                          : "Hors ligne"}
+                    </p>
+                  </div>
+                </div>
+                <div className="flex items-center space-x-2">
+                  <Button variant="outline" size="sm">
+                    <Phone className="h-4 w-4" />
+                  </Button>
+                  <Button variant="outline" size="sm">
+                    <Video className="h-4 w-4" />
+                  </Button>
+                  <Button variant="outline" size="sm">
+                    <MoreHorizontal className="h-4 w-4" />
+                  </Button>
+                </div>
+              </div>
+            </div>
+
+            {/* Messages */}
+            <div className="flex-1 overflow-y-auto p-4 space-y-4 bg-gray-50">
+              {messages.map((message) => (
+                <div key={message.id}>
+                  {message.type === "ai_analysis" ? (
+                    renderAIMessage(message)
+                  ) : (
+                    <div className={`flex ${message.senderId === "me" ? "justify-end" : "justify-start"}`}>
+                      <div
+                        className={`max-w-xs lg:max-w-md px-4 py-2 rounded-lg ${
+                          message.senderId === "me" ? "bg-blue-600 text-white" : "bg-white text-gray-900 shadow-sm"
+                        }`}
+                      >
+                        {message.type === "text" ? (
+                          <p className="text-sm">{message.content}</p>
+                        ) : message.type === "file" ? (
+                          <div className="flex items-center space-x-3 p-2">
+                            <File className="h-8 w-8 text-gray-400" />
+                            <div className="flex-1">
+                              <p className="text-sm font-medium">{message.fileName}</p>
+                              <p className="text-xs text-gray-500">{message.fileSize}</p>
+                            </div>
+                            <Button variant="outline" size="sm">
+                              <Download className="h-4 w-4" />
+                            </Button>
+                          </div>
+                        ) : null}
+                        <div
+                          className={`flex items-center justify-between mt-1 ${
+                            message.senderId === "me" ? "text-blue-100" : "text-gray-500"
+                          }`}
+                        >
+                          <span className="text-xs">{message.timestamp}</span>
+                          {message.senderId === "me" && <div className="ml-2">{getStatusIcon(message.status)}</div>}
+                        </div>
+                      </div>
+                    </div>
+                  )}
+                </div>
+              ))}
+            </div>
+
+            {/* Message Input */}
+            <div className="p-4 border-t bg-white">
+              <div className="flex items-end space-x-2">
+                <Button variant="outline" size="sm">
+                  <Paperclip className="h-4 w-4" />
+                </Button>
+                <div className="flex-1">
+                  <Textarea
+                    placeholder="Tapez votre message..."
+                    value={newMessage}
+                    onChange={(e) => setNewMessage(e.target.value)}
+                    onKeyPress={(e) => {
+                      if (e.key === "Enter" && !e.shiftKey) {
+                        e.preventDefault()
+                        handleSendMessage()
+                      }
+                    }}
+                    rows={1}
+                    className="resize-none"
+                  />
+                </div>
+                <Button variant="outline" size="sm">
+                  <Smile className="h-4 w-4" />
+                </Button>
+                <Button onClick={handleSendMessage} disabled={!newMessage.trim()}>
+                  <Send className="h-4 w-4" />
+                </Button>
+              </div>
+            </div>
+          </>
+        ) : (
+          <div className="flex-1 flex items-center justify-center bg-gray-50">
+            <div className="text-center">
+              <MessageSquare className="h-12 w-12 mx-auto text-gray-400 mb-4" />
+              <h3 className="text-lg font-medium text-gray-900 mb-2">Sélectionnez une conversation</h3>
+              <p className="text-gray-600">Choisissez une conversation pour commencer à discuter</p>
+            </div>
+          </div>
+        )}
+      </div>
+    </div>
+  )
+}

app/dashboard/documents/[id]/roles/loading.tsx

@@ -0,0 +1,3 @@
+export default function Loading() {
+  return null
+}

app/dashboard/documents/[id]/roles/page.tsx

@@ -0,0 +1,726 @@
+"use client"
+
+import { useState, useEffect } from "react"
+import { useRouter, useParams } from "next/navigation"
+import { Card, CardContent, CardHeader, CardTitle } from "@/components/ui/card"
+import { Badge } from "@/components/ui/badge"
+import { Button } from "@/components/ui/button"
+import { Input } from "@/components/ui/input"
+import { Label } from "@/components/ui/label"
+import { Select, SelectContent, SelectItem, SelectTrigger, SelectValue } from "@/components/ui/select"
+import {
+  Users,
+  UserPlus,
+  Search,
+  ArrowLeft,
+  Crown,
+  Edit,
+  Eye,
+  Shield,
+  UserCheck,
+  Trash2,
+  X,
+  CheckCircle,
+  XCircle,
+  Info,
+  FileText,
+  Download,
+  Share2,
+} from "lucide-react"
+
+interface DocumentRole {
+  userId: string
+  userName: string
+  userEmail: string
+  userAvatar: string
+  role: "owner" | "editor" | "viewer" | "validator" | "contributor"
+  assignedDate: Date
+  assignedBy: string
+  defaultRole: "admin" | "editor" | "viewer"
+  permissions: {
+    canView: boolean
+    canEdit: boolean
+    canDelete: boolean
+    canShare: boolean
+    canValidate: boolean
+    canDownload: boolean
+  }
+}
+
+interface User {
+  id: string
+  name: string
+  email: string
+  avatar: string
+  defaultRole: "admin" | "editor" | "viewer"
+  department: string
+}
+
+interface Document {
+  id: string
+  name: string
+  type: string
+  size: string
+  folder: string
+  author: string
+  modified: Date
+  isValidated: boolean
+  storageType: "temporary" | "permanent"
+}
+
+export default function DocumentRolesPage() {
+  const router = useRouter()
+  const params = useParams()
+  const documentId = params.id as string
+
+  const [document, setDocument] = useState<Document | null>(null)
+  const [documentRoles, setDocumentRoles] = useState<DocumentRole[]>([])
+  const [availableUsers, setAvailableUsers] = useState<User[]>([])
+  const [searchTerm, setSearchTerm] = useState("")
+  const [showAddUser, setShowAddUser] = useState(false)
+  const [selectedUser, setSelectedUser] = useState("")
+  const [selectedRole, setSelectedRole] = useState("viewer")
+  const [notification, setNotification] = useState<{ type: "success" | "error" | "info"; message: string } | null>(null)
+
+  // Simuler le chargement des données
+  useEffect(() => {
+    // Charger les informations du document
+    const mockDocument: Document = {
+      id: documentId,
+      name: "Contrat_Client_ABC.pdf",
+      type: "PDF",
+      size: "2.4 MB",
+      folder: "Contrats",
+      author: "Marie Dubois",
+      modified: new Date("2024-01-15T14:30:00"),
+      isValidated: true,
+      storageType: "permanent",
+    }
+    setDocument(mockDocument)
+
+    // Charger les rôles existants sur le document
+    const mockDocumentRoles: DocumentRole[] = [
+      {
+        userId: "1",
+        userName: "Marie Dubois",
+        userEmail: "marie.dubois@docv.fr",
+        userAvatar: "MD",
+        role: "owner",
+        assignedDate: new Date("2024-01-15"),
+        assignedBy: "Système",
+        defaultRole: "admin",
+        permissions: {
+          canView: true,
+          canEdit: true,
+          canDelete: true,
+          canShare: true,
+          canValidate: true,
+          canDownload: true,
+        },
+      },
+      {
+        userId: "2",
+        userName: "Pierre Martin",
+        userEmail: "pierre.martin@docv.fr",
+        userAvatar: "PM",
+        role: "editor",
+        assignedDate: new Date("2024-01-16"),
+        assignedBy: "Marie Dubois",
+        defaultRole: "editor",
+        permissions: {
+          canView: true,
+          canEdit: true,
+          canDelete: false,
+          canShare: true,
+          canValidate: false,
+          canDownload: true,
+        },
+      },
+      {
+        userId: "5",
+        userName: "Julie Moreau",
+        userEmail: "julie.moreau@docv.fr",
+        userAvatar: "JM",
+        role: "validator",
+        assignedDate: new Date("2024-01-17"),
+        assignedBy: "Marie Dubois",
+        defaultRole: "admin",
+        permissions: {
+          canView: true,
+          canEdit: false,
+          canDelete: false,
+          canShare: false,
+          canValidate: true,
+          canDownload: true,
+        },
+      },
+    ]
+    setDocumentRoles(mockDocumentRoles)
+
+    // Charger les utilisateurs disponibles
+    const allUsers: User[] = [
+      {
+        id: "3",
+        name: "Sophie Laurent",
+        email: "sophie.laurent@docv.fr",
+        avatar: "SL",
+        defaultRole: "viewer",
+        department: "RH",
+      },
+      {
+        id: "4",
+        name: "Thomas Rousseau",
+        email: "thomas.rousseau@docv.fr",
+        avatar: "TR",
+        defaultRole: "editor",
+        department: "Finance",
+      },
+    ]
+
+    const usersWithRoles = mockDocumentRoles.map((dr) => dr.userId)
+    const available = allUsers.filter((user) => !usersWithRoles.includes(user.id))
+    setAvailableUsers(available)
+  }, [documentId])
+
+  // Notification system
+  const showNotification = (type: "success" | "error" | "info", message: string) => {
+    setNotification({ type, message })
+    setTimeout(() => setNotification(null), 3000)
+  }
+
+  const getRoleIcon = (role: string) => {
+    switch (role) {
+      case "owner":
+        return <Crown className="h-4 w-4 text-yellow-600" />
+      case "editor":
+        return <Edit className="h-4 w-4 text-blue-600" />
+      case "validator":
+        return <Shield className="h-4 w-4 text-green-600" />
+      case "contributor":
+        return <UserPlus className="h-4 w-4 text-purple-600" />
+      case "viewer":
+        return <Eye className="h-4 w-4 text-gray-600" />
+      default:
+        return <Eye className="h-4 w-4 text-gray-600" />
+    }
+  }
+
+  const getRoleColor = (role: string) => {
+    switch (role) {
+      case "owner":
+        return "bg-yellow-100 text-yellow-800 border-yellow-200"
+      case "editor":
+        return "bg-blue-100 text-blue-800 border-blue-200"
+      case "validator":
+        return "bg-green-100 text-green-800 border-green-200"
+      case "contributor":
+        return "bg-purple-100 text-purple-800 border-purple-200"
+      case "viewer":
+        return "bg-gray-100 text-gray-800 border-gray-200"
+      default:
+        return "bg-gray-100 text-gray-800 border-gray-200"
+    }
+  }
+
+  const getDefaultRoleColor = (role: string) => {
+    switch (role) {
+      case "admin":
+        return "bg-red-100 text-red-800 border-red-200"
+      case "editor":
+        return "bg-blue-100 text-blue-800 border-blue-200"
+      case "viewer":
+        return "bg-gray-100 text-gray-800 border-gray-200"
+      default:
+        return "bg-gray-100 text-gray-800 border-gray-200"
+    }
+  }
+
+  const getPermissionsForRole = (role: string) => {
+    switch (role) {
+      case "owner":
+        return {
+          canView: true,
+          canEdit: true,
+          canDelete: true,
+          canShare: true,
+          canValidate: true,
+          canDownload: true,
+        }
+      case "editor":
+        return {
+          canView: true,
+          canEdit: true,
+          canDelete: false,
+          canShare: true,
+          canValidate: false,
+          canDownload: true,
+        }
+      case "validator":
+        return {
+          canView: true,
+          canEdit: false,
+          canDelete: false,
+          canShare: false,
+          canValidate: true,
+          canDownload: true,
+        }
+      case "contributor":
+        return {
+          canView: true,
+          canEdit: false,
+          canDelete: false,
+          canShare: false,
+          canValidate: false,
+          canDownload: true,
+        }
+      case "viewer":
+        return {
+          canView: true,
+          canEdit: false,
+          canDelete: false,
+          canShare: false,
+          canValidate: false,
+          canDownload: true,
+        }
+      default:
+        return {
+          canView: true,
+          canEdit: false,
+          canDelete: false,
+          canShare: false,
+          canValidate: false,
+          canDownload: false,
+        }
+    }
+  }
+
+  const handleAddUser = () => {
+    if (!selectedUser) return
+
+    const user = availableUsers.find((u) => u.id === selectedUser)
+    if (!user) return
+
+    const newRole: DocumentRole = {
+      userId: user.id,
+      userName: user.name,
+      userEmail: user.email,
+      userAvatar: user.avatar,
+      role: selectedRole as "owner" | "editor" | "viewer" | "validator" | "contributor",
+      assignedDate: new Date(),
+      assignedBy: "Utilisateur actuel",
+      defaultRole: user.defaultRole,
+      permissions: getPermissionsForRole(selectedRole),
+    }
+
+    setDocumentRoles((prev) => [...prev, newRole])
+    setAvailableUsers((prev) => prev.filter((u) => u.id !== selectedUser))
+
+    showNotification("success", `${user.name} ajouté avec le rôle ${selectedRole}`)
+
+    // Reset form
+    setSelectedUser("")
+    setSelectedRole("viewer")
+    setShowAddUser(false)
+  }
+
+  const handleChangeRole = (userId: string, newRole: string) => {
+    setDocumentRoles((prev) =>
+      prev.map((dr) =>
+        dr.userId === userId
+          ? {
+              ...dr,
+              role: newRole as "owner" | "editor" | "viewer" | "validator" | "contributor",
+              permissions: getPermissionsForRole(newRole),
+            }
+          : dr,
+      ),
+    )
+
+    const user = documentRoles.find((dr) => dr.userId === userId)
+    showNotification("success", `Rôle de ${user?.userName} mis à jour vers ${newRole}`)
+  }
+
+  const handleRemoveUser = (userId: string) => {
+    const userRole = documentRoles.find((dr) => dr.userId === userId)
+    if (!userRole) return
+
+    if (userRole.role === "owner") {
+      showNotification("error", "Impossible de supprimer le propriétaire du document")
+      return
+    }
+
+    setDocumentRoles((prev) => prev.filter((dr) => dr.userId !== userId))
+
+    // Remettre l'utilisateur dans la liste des disponibles
+    const user: User = {
+      id: userRole.userId,
+      name: userRole.userName,
+      email: userRole.userEmail,
+      avatar: userRole.userAvatar,
+      defaultRole: userRole.defaultRole,
+      department: "Département",
+    }
+    setAvailableUsers((prev) => [...prev, user])
+
+    showNotification("success", `${userRole.userName} retiré du document`)
+  }
+
+  const filteredRoles = documentRoles.filter(
+    (role) =>
+      role.userName.toLowerCase().includes(searchTerm.toLowerCase()) ||
+      role.userEmail.toLowerCase().includes(searchTerm.toLowerCase()),
+  )
+
+  if (!document) {
+    return <div>Chargement...</div>
+  }
+
+  return (
+    <div className="space-y-6">
+      {/* Notification */}
+      {notification && (
+        <div
+          className={`fixed top-4 right-4 z-50 p-4 rounded-lg shadow-lg flex items-center space-x-2 ${
+            notification.type === "success"
+              ? "bg-green-100 text-green-800 border border-green-200"
+              : notification.type === "error"
+                ? "bg-red-100 text-red-800 border border-red-200"
+                : "bg-blue-100 text-blue-800 border border-blue-200"
+          }`}
+        >
+          {notification.type === "success" && <CheckCircle className="h-5 w-5" />}
+          {notification.type === "error" && <XCircle className="h-5 w-5" />}
+          {notification.type === "info" && <Info className="h-5 w-5" />}
+          <span>{notification.message}</span>
+          <Button variant="ghost" size="sm" onClick={() => setNotification(null)}>
+            <X className="h-4 w-4" />
+          </Button>
+        </div>
+      )}
+
+      {/* Header */}
+      <div className="flex items-center space-x-4">
+        <Button variant="outline" onClick={() => router.back()}>
+          <ArrowLeft className="h-4 w-4 mr-2" />
+          Retour
+        </Button>
+        <div className="flex items-center space-x-3">
+          <div className="p-2 bg-red-100 rounded-lg">
+            <FileText className="h-6 w-6 text-red-600" />
+          </div>
+          <div>
+            <h1 className="text-2xl font-bold text-gray-900">Gestion des rôles - Document "{document.name}"</h1>
+            <p className="text-gray-600">Gérez les permissions d'accès et les rôles des utilisateurs sur ce document</p>
+          </div>
+        </div>
+      </div>
+
+      {/* Document Info */}
+      <Card>
+        <CardContent className="p-6">
+          <div className="flex items-center justify-between">
+            <div className="flex items-center space-x-4">
+              <div className="p-3 bg-red-100 rounded-lg">
+                <FileText className="h-8 w-8 text-red-600" />
+              </div>
+              <div>
+                <h3 className="font-semibold text-lg">{document.name}</h3>
+                <div className="flex items-center space-x-4 text-sm text-gray-600 mt-1">
+                  <span>
+                    {document.type} • {document.size}
+                  </span>
+                  <span>Dossier: {document.folder}</span>
+                  <span>Auteur: {document.author}</span>
+                  <Badge
+                    className={document.isValidated ? "bg-green-100 text-green-800" : "bg-orange-100 text-orange-800"}
+                  >
+                    {document.isValidated ? "Validé" : "En attente"}
+                  </Badge>
+                </div>
+              </div>
+            </div>
+            <div className="flex items-center space-x-2">
+              <Button variant="outline" size="sm">
+                <Download className="h-4 w-4 mr-2" />
+                Télécharger
+              </Button>
+              <Button variant="outline" size="sm">
+                <Share2 className="h-4 w-4 mr-2" />
+                Partager
+              </Button>
+            </div>
+          </div>
+        </CardContent>
+      </Card>
+
+      {/* Stats supprimées selon la consigne */}
+
+      {/* Search and Add */}
+      <Card>
+        <CardContent className="p-6">
+          <div className="flex flex-col sm:flex-row sm:items-center sm:justify-between space-y-4 sm:space-y-0">
+            <div className="relative flex-1 sm:max-w-md">
+              <Search className="absolute left-3 top-1/2 transform -translate-y-1/2 text-gray-400 h-4 w-4" />
+              <Input
+                placeholder="Rechercher un utilisateur..."
+                value={searchTerm}
+                onChange={(e) => setSearchTerm(e.target.value)}
+                className="pl-10"
+              />
+            </div>
+            <Button onClick={() => setShowAddUser(true)} disabled={availableUsers.length === 0}>
+              <UserPlus className="h-4 w-4 mr-2" />
+              Ajouter un utilisateur
+            </Button>
+          </div>
+
+          {showAddUser && (
+            <div className="mt-4 p-4 border rounded-lg bg-blue-50">
+              <h3 className="font-medium text-blue-900 mb-3">Ajouter un utilisateur au document</h3>
+              <div className="grid grid-cols-1 md:grid-cols-3 gap-4">
+                <div>
+                  <Label>Utilisateur</Label>
+                  <Select value={selectedUser} onValueChange={setSelectedUser}>
+                    <SelectTrigger>
+                      <SelectValue placeholder="Sélectionner un utilisateur" />
+                    </SelectTrigger>
+                    <SelectContent>
+                      {availableUsers.map((user) => (
+                        <SelectItem key={user.id} value={user.id}>
+                          <div className="flex items-center space-x-2">
+                            <div className="w-6 h-6 bg-blue-100 rounded-full flex items-center justify-center text-xs">
+                              {user.avatar}
+                            </div>
+                            <div>
+                              <span className="font-medium">{user.name}</span>
+                              <div className="flex items-center space-x-1 mt-1">
+                                <span className="text-xs text-gray-500">Rôle par défaut:</span>
+                                <Badge variant="outline" className={`text-xs ${getDefaultRoleColor(user.defaultRole)}`}>
+                                  {user.defaultRole}
+                                </Badge>
+                              </div>
+                            </div>
+                          </div>
+                        </SelectItem>
+                      ))}
+                    </SelectContent>
+                  </Select>
+                </div>
+                <div>
+                  <Label>Rôle sur ce document</Label>
+                  <Select value={selectedRole} onValueChange={setSelectedRole}>
+                    <SelectTrigger>
+                      <SelectValue />
+                    </SelectTrigger>
+                    <SelectContent>
+                      <SelectItem value="viewer">
+                        <div className="flex items-center space-x-2">
+                          <Eye className="h-4 w-4" />
+                          <div>
+                            <span>Lecteur</span>
+                            <p className="text-xs text-gray-500">Lecture et téléchargement</p>
+                          </div>
+                        </div>
+                      </SelectItem>
+                      <SelectItem value="contributor">
+                        <div className="flex items-center space-x-2">
+                          <UserPlus className="h-4 w-4" />
+                          <div>
+                            <span>Contributeur</span>
+                            <p className="text-xs text-gray-500">Lecture et commentaires</p>
+                          </div>
+                        </div>
+                      </SelectItem>
+                      <SelectItem value="editor">
+                        <div className="flex items-center space-x-2">
+                          <Edit className="h-4 w-4" />
+                          <div>
+                            <span>Éditeur</span>
+                            <p className="text-xs text-gray-500">Peut modifier le document</p>
+                          </div>
+                        </div>
+                      </SelectItem>
+                      <SelectItem value="validator">
+                        <div className="flex items-center space-x-2">
+                          <Shield className="h-4 w-4" />
+                          <div>
+                            <span>Validateur</span>
+                            <p className="text-xs text-gray-500">Peut valider le document</p>
+                          </div>
+                        </div>
+                      </SelectItem>
+                      <SelectItem value="owner">
+                        <div className="flex items-center space-x-2">
+                          <Crown className="h-4 w-4" />
+                          <div>
+                            <span>Propriétaire</span>
+                            <p className="text-xs text-gray-500">Contrôle total</p>
+                          </div>
+                        </div>
+                      </SelectItem>
+                    </SelectContent>
+                  </Select>
+                </div>
+                <div className="flex items-end space-x-2">
+                  <Button onClick={handleAddUser} disabled={!selectedUser}>
+                    <UserCheck className="h-4 w-4 mr-2" />
+                    Ajouter
+                  </Button>
+                  <Button variant="outline" onClick={() => setShowAddUser(false)}>
+                    Annuler
+                  </Button>
+                </div>
+              </div>
+            </div>
+          )}
+        </CardContent>
+      </Card>
+
+      {/* Roles List */}
+      <Card>
+        <CardHeader>
+          <CardTitle>Utilisateurs avec accès au document</CardTitle>
+        </CardHeader>
+        <CardContent>
+          <div className="overflow-x-auto">
+            <table className="w-full">
+              <thead>
+                <tr className="border-b">
+                  <th className="text-left p-4 font-medium">Utilisateur</th>
+                  <th className="text-left p-4 font-medium">Rôle par défaut</th>
+                  <th className="text-left p-4 font-medium">Rôle sur ce document</th>
+                  <th className="text-left p-4 font-medium">Permissions</th>
+                  <th className="text-left p-4 font-medium">Assigné le</th>
+                  <th className="text-left p-4 font-medium">Actions</th>
+                </tr>
+              </thead>
+              <tbody>
+                {filteredRoles.map((roleAssignment) => (
+                  <tr key={roleAssignment.userId} className="border-b hover:bg-gray-50">
+                    <td className="p-4">
+                      <div className="flex items-center space-x-3">
+                        <div className="w-10 h-10 bg-blue-100 rounded-full flex items-center justify-center">
+                          <span className="text-blue-600 font-medium text-sm">{roleAssignment.userAvatar}</span>
+                        </div>
+                        <div>
+                          <p className="font-medium text-gray-900">{roleAssignment.userName}</p>
+                          <p className="text-sm text-gray-500">{roleAssignment.userEmail}</p>
+                        </div>
+                      </div>
+                    </td>
+                    <td className="p-4">
+                      <Badge variant="outline" className={getDefaultRoleColor(roleAssignment.defaultRole)}>
+                        {roleAssignment.defaultRole}
+                      </Badge>
+                    </td>
+                    <td className="p-4">
+                      <Select
+                        value={roleAssignment.role}
+                        onValueChange={(newRole) => handleChangeRole(roleAssignment.userId, newRole)}
+                        disabled={roleAssignment.role === "owner"}
+                      >
+                        <SelectTrigger className="w-40">
+                          <div className="flex items-center space-x-2">
+                            {getRoleIcon(roleAssignment.role)}
+                            <span className="capitalize">{roleAssignment.role}</span>
+                          </div>
+                        </SelectTrigger>
+                        <SelectContent>
+                          <SelectItem value="viewer">
+                            <div className="flex items-center space-x-2">
+                              <Eye className="h-4 w-4" />
+                              <span>Lecteur</span>
+                            </div>
+                          </SelectItem>
+                          <SelectItem value="contributor">
+                            <div className="flex items-center space-x-2">
+                              <UserPlus className="h-4 w-4" />
+                              <span>Contributeur</span>
+                            </div>
+                          </SelectItem>
+                          <SelectItem value="editor">
+                            <div className="flex items-center space-x-2">
+                              <Edit className="h-4 w-4" />
+                              <span>Éditeur</span>
+                            </div>
+                          </SelectItem>
+                          <SelectItem value="validator">
+                            <div className="flex items-center space-x-2">
+                              <Shield className="h-4 w-4" />
+                              <span>Validateur</span>
+                            </div>
+                          </SelectItem>
+                          <SelectItem value="owner">
+                            <div className="flex items-center space-x-2">
+                              <Crown className="h-4 w-4" />
+                              <span>Propriétaire</span>
+                            </div>
+                          </SelectItem>
+                        </SelectContent>
+                      </Select>
+                    </td>
+                    <td className="p-4">
+                      <div className="flex flex-wrap gap-1">
+                        {roleAssignment.permissions.canView && (
+                          <Badge variant="outline" className="text-xs bg-blue-50 text-blue-700">
+                            <Eye className="h-3 w-3 mr-1" />
+                            Voir
+                          </Badge>
+                        )}
+                        {roleAssignment.permissions.canEdit && (
+                          <Badge variant="outline" className="text-xs bg-green-50 text-green-700">
+                            <Edit className="h-3 w-3 mr-1" />
+                            Éditer
+                          </Badge>
+                        )}
+                        {roleAssignment.permissions.canValidate && (
+                          <Badge variant="outline" className="text-xs bg-purple-50 text-purple-700">
+                            <Shield className="h-3 w-3 mr-1" />
+                            Valider
+                          </Badge>
+                        )}
+                        {roleAssignment.permissions.canShare && (
+                          <Badge variant="outline" className="text-xs bg-orange-50 text-orange-700">
+                            <Share2 className="h-3 w-3 mr-1" />
+                            Partager
+                          </Badge>
+                        )}
+                        {roleAssignment.permissions.canDownload && (
+                          <Badge variant="outline" className="text-xs bg-gray-50 text-gray-700">
+                            <Download className="h-3 w-3 mr-1" />
+                            Télécharger
+                          </Badge>
+                        )}
+                      </div>
+                    </td>
+                    <td className="p-4 text-gray-600">{roleAssignment.assignedDate.toLocaleDateString("fr-FR")}</td>
+                    <td className="p-4">
+                      {roleAssignment.role !== "owner" && (
+                        <Button
+                          variant="outline"
+                          size="sm"
+                          onClick={() => handleRemoveUser(roleAssignment.userId)}
+                          className="text-red-600 hover:text-red-700"
+                        >
+                          <Trash2 className="h-4 w-4" />
+                        </Button>
+                      )}
+                    </td>
+                  </tr>
+                ))}
+              </tbody>
+            </table>
+          </div>
+
+          {filteredRoles.length === 0 && (
+            <div className="text-center py-8">
+              <Users className="h-12 w-12 mx-auto text-gray-400 mb-4" />
+              <h3 className="text-lg font-medium text-gray-900 mb-2">Aucun utilisateur trouvé</h3>
+              <p className="text-gray-600">Essayez de modifier vos critères de recherche</p>
+            </div>
+          )}
+        </CardContent>
+      </Card>
+    </div>
+  )
+}

app/dashboard/documents/loading.tsx

@@ -0,0 +1,83 @@
+export default function DocumentsLoading() {
+  return (
+    <div className="space-y-6">
+      {/* Header Skeleton */}
+      <div className="flex flex-col sm:flex-row sm:items-center sm:justify-between">
+        <div>
+          <div className="h-8 w-48 bg-gray-200 rounded animate-pulse mb-2" />
+          <div className="h-4 w-64 bg-gray-200 rounded animate-pulse" />
+        </div>
+        <div className="flex items-center space-x-3 mt-4 sm:mt-0">
+          <div className="h-9 w-24 bg-gray-200 rounded animate-pulse" />
+          <div className="h-9 w-32 bg-gray-200 rounded animate-pulse" />
+        </div>
+      </div>
+
+      {/* Stats Cards Skeleton */}
+      <div className="grid grid-cols-1 md:grid-cols-4 gap-4">
+        {[...Array(4)].map((_, i) => (
+          <div key={i} className="bg-white border rounded-lg p-4">
+            <div className="flex items-center justify-between">
+              <div>
+                <div className="h-4 w-16 bg-gray-200 rounded animate-pulse mb-2" />
+                <div className="h-8 w-12 bg-gray-200 rounded animate-pulse" />
+              </div>
+              <div className="h-8 w-8 bg-gray-200 rounded animate-pulse" />
+            </div>
+          </div>
+        ))}
+      </div>
+
+      {/* Search and Filters Skeleton */}
+      <div className="bg-white border rounded-lg p-4">
+        <div className="flex flex-col lg:flex-row lg:items-center lg:justify-between space-y-4 lg:space-y-0">
+          <div className="flex flex-col sm:flex-row sm:items-center space-y-3 sm:space-y-0 sm:space-x-4">
+            <div className="h-10 w-80 bg-gray-200 rounded animate-pulse" />
+            <div className="h-10 w-20 bg-gray-200 rounded animate-pulse" />
+          </div>
+          <div className="flex items-center space-x-3">
+            <div className="h-10 w-32 bg-gray-200 rounded animate-pulse" />
+            <div className="h-10 w-20 bg-gray-200 rounded animate-pulse" />
+          </div>
+        </div>
+      </div>
+
+      {/* Documents List Skeleton */}
+      <div className="bg-white border rounded-lg">
+        <div className="overflow-x-auto">
+          <table className="w-full">
+            <thead className="bg-gray-50">
+              <tr>
+                {[...Array(9)].map((_, i) => (
+                  <th key={i} className="text-left py-3 px-4">
+                    <div className="h-4 w-20 bg-gray-200 rounded animate-pulse" />
+                  </th>
+                ))}
+              </tr>
+            </thead>
+            <tbody>
+              {[...Array(8)].map((_, i) => (
+                <tr key={i} className="border-b">
+                  <td className="py-3 px-4">
+                    <div className="h-4 w-4 bg-gray-200 rounded animate-pulse" />
+                  </td>
+                  <td className="py-3 px-4">
+                    <div className="flex items-center space-x-3">
+                      <div className="h-5 w-5 bg-gray-200 rounded animate-pulse" />
+                      <div className="h-4 w-48 bg-gray-200 rounded animate-pulse" />
+                    </div>
+                  </td>
+                  {[...Array(7)].map((_, j) => (
+                    <td key={j} className="py-3 px-4">
+                      <div className="h-4 w-16 bg-gray-200 rounded animate-pulse" />
+                    </td>
+                  ))}
+                </tr>
+              ))}
+            </tbody>
+          </table>
+        </div>
+      </div>
+    </div>
+  )
+}

app/dashboard/folders/[id]/roles/loading.tsx

@@ -0,0 +1,3 @@
+export default function Loading() {
+  return null
+}

app/dashboard/folders/[id]/roles/page.tsx

@@ -0,0 +1,540 @@
+"use client"
+
+import { useState, useEffect } from "react"
+import { useRouter, useParams } from "next/navigation"
+import { Card, CardContent, CardHeader, CardTitle } from "@/components/ui/card"
+import { Badge } from "@/components/ui/badge"
+import { Button } from "@/components/ui/button"
+import { Input } from "@/components/ui/input"
+import { Label } from "@/components/ui/label"
+import { Select, SelectContent, SelectItem, SelectTrigger, SelectValue } from "@/components/ui/select"
+import {
+  Users,
+  UserPlus,
+  Search,
+  ArrowLeft,
+  Crown,
+  Edit,
+  Eye,
+  Shield,
+  UserCheck,
+  Trash2,
+  X,
+  CheckCircle,
+  XCircle,
+  Info,
+  Folder,
+} from "lucide-react"
+
+interface FolderRole {
+  userId: string
+  userName: string
+  userEmail: string
+  userAvatar: string
+  role: "owner" | "editor" | "viewer" | "validator" | "contributor"
+  assignedDate: Date
+  assignedBy: string
+  defaultRole: "admin" | "editor" | "viewer"
+}
+
+interface User {
+  id: string
+  name: string
+  email: string
+  avatar: string
+  defaultRole: "admin" | "editor" | "viewer"
+  department: string
+}
+
+export default function FolderRolesPage() {
+  const router = useRouter()
+  const params = useParams()
+  const folderId = params.id as string
+
+  const [folderName, setFolderName] = useState("")
+  const [folderRoles, setFolderRoles] = useState<FolderRole[]>([])
+  const [availableUsers, setAvailableUsers] = useState<User[]>([])
+  const [searchTerm, setSearchTerm] = useState("")
+  const [showAddUser, setShowAddUser] = useState(false)
+  const [selectedUser, setSelectedUser] = useState("")
+  const [selectedRole, setSelectedRole] = useState("viewer")
+  const [inviteMessage, setInviteMessage] = useState("")
+  const [notification, setNotification] = useState<{ type: "success" | "error" | "info"; message: string } | null>(null)
+
+  // Simuler le chargement des données
+  useEffect(() => {
+    // Charger les informations du dossier
+    const folderNames: { [key: string]: string } = {
+      "1": "Contrats",
+      "2": "Rapports",
+      "3": "Projets",
+      "4": "Finance",
+      "5": "Ressources Humaines",
+      "6": "Marketing",
+    }
+    setFolderName(folderNames[folderId] || "Dossier")
+
+    // Charger les rôles existants sur le dossier
+    const mockFolderRoles: FolderRole[] = [
+      {
+        userId: "1",
+        userName: "Marie Dubois",
+        userEmail: "marie.dubois@docv.fr",
+        userAvatar: "MD",
+        role: "owner",
+        assignedDate: new Date("2024-01-01"),
+        assignedBy: "Système",
+        defaultRole: "admin",
+      },
+      {
+        userId: "2",
+        userName: "Pierre Martin",
+        userEmail: "pierre.martin@docv.fr",
+        userAvatar: "PM",
+        role: "editor",
+        assignedDate: new Date("2024-01-10"),
+        assignedBy: "Marie Dubois",
+        defaultRole: "editor",
+      },
+      {
+        userId: "5",
+        userName: "Julie Moreau",
+        userEmail: "julie.moreau@docv.fr",
+        userAvatar: "JM",
+        role: "validator",
+        assignedDate: new Date("2024-01-15"),
+        assignedBy: "Marie Dubois",
+        defaultRole: "admin",
+      },
+    ]
+    setFolderRoles(mockFolderRoles)
+
+    // Charger les utilisateurs disponibles (ceux qui n'ont pas encore de rôle sur ce dossier)
+    const allUsers: User[] = [
+      {
+        id: "3",
+        name: "Sophie Laurent",
+        email: "sophie.laurent@docv.fr",
+        avatar: "SL",
+        defaultRole: "viewer",
+        department: "RH",
+      },
+      {
+        id: "4",
+        name: "Thomas Rousseau",
+        email: "thomas.rousseau@docv.fr",
+        avatar: "TR",
+        defaultRole: "editor",
+        department: "Finance",
+      },
+    ]
+
+    const usersWithRoles = mockFolderRoles.map((fr) => fr.userId)
+    const available = allUsers.filter((user) => !usersWithRoles.includes(user.id))
+    setAvailableUsers(available)
+  }, [folderId])
+
+  // Notification system
+  const showNotification = (type: "success" | "error" | "info", message: string) => {
+    setNotification({ type, message })
+    setTimeout(() => setNotification(null), 3000)
+  }
+
+  const getRoleIcon = (role: string) => {
+    switch (role) {
+      case "owner":
+        return <Crown className="h-4 w-4 text-yellow-600" />
+      case "editor":
+        return <Edit className="h-4 w-4 text-blue-600" />
+      case "validator":
+        return <Shield className="h-4 w-4 text-green-600" />
+      case "contributor":
+        return <UserPlus className="h-4 w-4 text-purple-600" />
+      case "viewer":
+        return <Eye className="h-4 w-4 text-gray-600" />
+      default:
+        return <Eye className="h-4 w-4 text-gray-600" />
+    }
+  }
+
+  const getRoleColor = (role: string) => {
+    switch (role) {
+      case "owner":
+        return "bg-yellow-100 text-yellow-800 border-yellow-200"
+      case "editor":
+        return "bg-blue-100 text-blue-800 border-blue-200"
+      case "validator":
+        return "bg-green-100 text-green-800 border-green-200"
+      case "contributor":
+        return "bg-purple-100 text-purple-800 border-purple-200"
+      case "viewer":
+        return "bg-gray-100 text-gray-800 border-gray-200"
+      default:
+        return "bg-gray-100 text-gray-800 border-gray-200"
+    }
+  }
+
+  const getDefaultRoleColor = (role: string) => {
+    switch (role) {
+      case "admin":
+        return "bg-red-100 text-red-800 border-red-200"
+      case "editor":
+        return "bg-blue-100 text-blue-800 border-blue-200"
+      case "viewer":
+        return "bg-gray-100 text-gray-800 border-gray-200"
+      default:
+        return "bg-gray-100 text-gray-800 border-gray-200"
+    }
+  }
+
+  const handleAddUser = () => {
+    if (!selectedUser) return
+
+    const user = availableUsers.find((u) => u.id === selectedUser)
+    if (!user) return
+
+    const newRole: FolderRole = {
+      userId: user.id,
+      userName: user.name,
+      userEmail: user.email,
+      userAvatar: user.avatar,
+      role: selectedRole as "owner" | "editor" | "viewer" | "validator" | "contributor",
+      assignedDate: new Date(),
+      assignedBy: "Utilisateur actuel",
+      defaultRole: user.defaultRole,
+    }
+
+    setFolderRoles((prev) => [...prev, newRole])
+    setAvailableUsers((prev) => prev.filter((u) => u.id !== selectedUser))
+
+    showNotification("success", `${user.name} ajouté avec le rôle ${selectedRole}`)
+
+    // Reset form
+    setSelectedUser("")
+    setSelectedRole("viewer")
+    setInviteMessage("")
+    setShowAddUser(false)
+  }
+
+  const handleChangeRole = (userId: string, newRole: string) => {
+    setFolderRoles((prev) =>
+      prev.map((fr) =>
+        fr.userId === userId
+          ? { ...fr, role: newRole as "owner" | "editor" | "viewer" | "validator" | "contributor" }
+          : fr,
+      ),
+    )
+
+    const user = folderRoles.find((fr) => fr.userId === userId)
+    showNotification("success", `Rôle de ${user?.userName} mis à jour vers ${newRole}`)
+  }
+
+  const handleRemoveUser = (userId: string) => {
+    const userRole = folderRoles.find((fr) => fr.userId === userId)
+    if (!userRole) return
+
+    if (userRole.role === "owner") {
+      showNotification("error", "Impossible de supprimer le propriétaire du dossier")
+      return
+    }
+
+    setFolderRoles((prev) => prev.filter((fr) => fr.userId !== userId))
+
+    // Remettre l'utilisateur dans la liste des disponibles
+    const user: User = {
+      id: userRole.userId,
+      name: userRole.userName,
+      email: userRole.userEmail,
+      avatar: userRole.userAvatar,
+      defaultRole: userRole.defaultRole,
+      department: "Département", // Valeur par défaut
+    }
+    setAvailableUsers((prev) => [...prev, user])
+
+    showNotification("success", `${userRole.userName} retiré du dossier`)
+  }
+
+  const filteredRoles = folderRoles.filter(
+    (role) =>
+      role.userName.toLowerCase().includes(searchTerm.toLowerCase()) ||
+      role.userEmail.toLowerCase().includes(searchTerm.toLowerCase()),
+  )
+
+  return (
+    <div className="space-y-6">
+      {/* Notification */}
+      {notification && (
+        <div
+          className={`fixed top-4 right-4 z-50 p-4 rounded-lg shadow-lg flex items-center space-x-2 ${
+            notification.type === "success"
+              ? "bg-green-100 text-green-800 border border-green-200"
+              : notification.type === "error"
+                ? "bg-red-100 text-red-800 border border-red-200"
+                : "bg-blue-100 text-blue-800 border border-blue-200"
+          }`}
+        >
+          {notification.type === "success" && <CheckCircle className="h-5 w-5" />}
+          {notification.type === "error" && <XCircle className="h-5 w-5" />}
+          {notification.type === "info" && <Info className="h-5 w-5" />}
+          <span>{notification.message}</span>
+          <Button variant="ghost" size="sm" onClick={() => setNotification(null)}>
+            <X className="h-4 w-4" />
+          </Button>
+        </div>
+      )}
+
+      {/* Header */}
+      <div className="flex items-center space-x-4">
+        <Button variant="outline" onClick={() => router.back()}>
+          <ArrowLeft className="h-4 w-4 mr-2" />
+          Retour
+        </Button>
+        <div className="flex items-center space-x-3">
+          <div className="p-2 bg-blue-100 rounded-lg">
+            <Folder className="h-6 w-6 text-blue-600" />
+          </div>
+          <div>
+            <h1 className="text-2xl font-bold text-gray-900">Gestion des rôles - Dossier "{folderName}"</h1>
+            <p className="text-gray-600">Gérez les permissions d'accès et les rôles des utilisateurs sur ce dossier</p>
+          </div>
+        </div>
+      </div>
+
+      {/* Stats supprimées selon la consigne */}
+
+      {/* Search and Add */}
+      <Card>
+        <CardContent className="p-6">
+          <div className="flex flex-col sm:flex-row sm:items-center sm:justify-between space-y-4 sm:space-y-0">
+            <div className="relative flex-1 sm:max-w-md">
+              <Search className="absolute left-3 top-1/2 transform -translate-y-1/2 text-gray-400 h-4 w-4" />
+              <Input
+                placeholder="Rechercher un utilisateur..."
+                value={searchTerm}
+                onChange={(e) => setSearchTerm(e.target.value)}
+                className="pl-10"
+              />
+            </div>
+            <Button onClick={() => setShowAddUser(true)} disabled={availableUsers.length === 0}>
+              <UserPlus className="h-4 w-4 mr-2" />
+              Ajouter un utilisateur
+            </Button>
+          </div>
+
+          {showAddUser && (
+            <div className="mt-4 p-4 border rounded-lg bg-blue-50">
+              <h3 className="font-medium text-blue-900 mb-3">Ajouter un utilisateur au dossier</h3>
+              <div className="grid grid-cols-1 md:grid-cols-3 gap-4">
+                <div>
+                  <Label>Utilisateur</Label>
+                  <Select value={selectedUser} onValueChange={setSelectedUser}>
+                    <SelectTrigger>
+                      <SelectValue placeholder="Sélectionner un utilisateur" />
+                    </SelectTrigger>
+                    <SelectContent>
+                      {availableUsers.map((user) => (
+                        <SelectItem key={user.id} value={user.id}>
+                          <div className="flex items-center space-x-2">
+                            <div className="w-6 h-6 bg-blue-100 rounded-full flex items-center justify-center text-xs">
+                              {user.avatar}
+                            </div>
+                            <div>
+                              <span className="font-medium">{user.name}</span>
+                              <div className="flex items-center space-x-1 mt-1">
+                                <span className="text-xs text-gray-500">Rôle par défaut:</span>
+                                <Badge variant="outline" className={`text-xs ${getDefaultRoleColor(user.defaultRole)}`}>
+                                  {user.defaultRole}
+                                </Badge>
+                              </div>
+                            </div>
+                          </div>
+                        </SelectItem>
+                      ))}
+                    </SelectContent>
+                  </Select>
+                </div>
+                <div>
+                  <Label>Rôle sur ce dossier</Label>
+                  <Select value={selectedRole} onValueChange={setSelectedRole}>
+                    <SelectTrigger>
+                      <SelectValue />
+                    </SelectTrigger>
+                    <SelectContent>
+                      <SelectItem value="viewer">
+                        <div className="flex items-center space-x-2">
+                          <Eye className="h-4 w-4" />
+                          <div>
+                            <span>Lecteur</span>
+                            <p className="text-xs text-gray-500">Lecture seule</p>
+                          </div>
+                        </div>
+                      </SelectItem>
+                      <SelectItem value="contributor">
+                        <div className="flex items-center space-x-2">
+                          <UserPlus className="h-4 w-4" />
+                          <div>
+                            <span>Contributeur</span>
+                            <p className="text-xs text-gray-500">Peut ajouter des documents</p>
+                          </div>
+                        </div>
+                      </SelectItem>
+                      <SelectItem value="editor">
+                        <div className="flex items-center space-x-2">
+                          <Edit className="h-4 w-4" />
+                          <div>
+                            <span>Éditeur</span>
+                            <p className="text-xs text-gray-500">Peut modifier les documents</p>
+                          </div>
+                        </div>
+                      </SelectItem>
+                      <SelectItem value="validator">
+                        <div className="flex items-center space-x-2">
+                          <Shield className="h-4 w-4" />
+                          <div>
+                            <span>Validateur</span>
+                            <p className="text-xs text-gray-500">Peut valider les documents</p>
+                          </div>
+                        </div>
+                      </SelectItem>
+                      <SelectItem value="owner">
+                        <div className="flex items-center space-x-2">
+                          <Crown className="h-4 w-4" />
+                          <div>
+                            <span>Propriétaire</span>
+                            <p className="text-xs text-gray-500">Contrôle total</p>
+                          </div>
+                        </div>
+                      </SelectItem>
+                    </SelectContent>
+                  </Select>
+                </div>
+                <div className="flex items-end space-x-2">
+                  <Button onClick={handleAddUser} disabled={!selectedUser}>
+                    <UserCheck className="h-4 w-4 mr-2" />
+                    Ajouter
+                  </Button>
+                  <Button variant="outline" onClick={() => setShowAddUser(false)}>
+                    Annuler
+                  </Button>
+                </div>
+              </div>
+            </div>
+          )}
+        </CardContent>
+      </Card>
+
+      {/* Roles List */}
+      <Card>
+        <CardHeader>
+          <CardTitle>Utilisateurs avec accès au dossier</CardTitle>
+        </CardHeader>
+        <CardContent>
+          <div className="overflow-x-auto">
+            <table className="w-full">
+              <thead>
+                <tr className="border-b">
+                  <th className="text-left p-4 font-medium">Utilisateur</th>
+                  <th className="text-left p-4 font-medium">Rôle par défaut</th>
+                  <th className="text-left p-4 font-medium">Rôle sur ce dossier</th>
+                  <th className="text-left p-4 font-medium">Assigné le</th>
+                  <th className="text-left p-4 font-medium">Assigné par</th>
+                  <th className="text-left p-4 font-medium">Actions</th>
+                </tr>
+              </thead>
+              <tbody>
+                {filteredRoles.map((roleAssignment) => (
+                  <tr key={roleAssignment.userId} className="border-b hover:bg-gray-50">
+                    <td className="p-4">
+                      <div className="flex items-center space-x-3">
+                        <div className="w-10 h-10 bg-blue-100 rounded-full flex items-center justify-center">
+                          <span className="text-blue-600 font-medium text-sm">{roleAssignment.userAvatar}</span>
+                        </div>
+                        <div>
+                          <p className="font-medium text-gray-900">{roleAssignment.userName}</p>
+                          <p className="text-sm text-gray-500">{roleAssignment.userEmail}</p>
+                        </div>
+                      </div>
+                    </td>
+                    <td className="p-4">
+                      <Badge variant="outline" className={getDefaultRoleColor(roleAssignment.defaultRole)}>
+                        {roleAssignment.defaultRole}
+                      </Badge>
+                    </td>
+                    <td className="p-4">
+                      <Select
+                        value={roleAssignment.role}
+                        onValueChange={(newRole) => handleChangeRole(roleAssignment.userId, newRole)}
+                        disabled={roleAssignment.role === "owner"}
+                      >
+                        <SelectTrigger className="w-40">
+                          <div className="flex items-center space-x-2">
+                            {getRoleIcon(roleAssignment.role)}
+                            <span className="capitalize">{roleAssignment.role}</span>
+                          </div>
+                        </SelectTrigger>
+                        <SelectContent>
+                          <SelectItem value="viewer">
+                            <div className="flex items-center space-x-2">
+                              <Eye className="h-4 w-4" />
+                              <span>Lecteur</span>
+                            </div>
+                          </SelectItem>
+                          <SelectItem value="contributor">
+                            <div className="flex items-center space-x-2">
+                              <UserPlus className="h-4 w-4" />
+                              <span>Contributeur</span>
+                            </div>
+                          </SelectItem>
+                          <SelectItem value="editor">
+                            <div className="flex items-center space-x-2">
+                              <Edit className="h-4 w-4" />
+                              <span>Éditeur</span>
+                            </div>
+                          </SelectItem>
+                          <SelectItem value="validator">
+                            <div className="flex items-center space-x-2">
+                              <Shield className="h-4 w-4" />
+                              <span>Validateur</span>
+                            </div>
+                          </SelectItem>
+                          <SelectItem value="owner">
+                            <div className="flex items-center space-x-2">
+                              <Crown className="h-4 w-4" />
+                              <span>Propriétaire</span>
+                            </div>
+                          </SelectItem>
+                        </SelectContent>
+                      </Select>
+                    </td>
+                    <td className="p-4 text-gray-600">{roleAssignment.assignedDate.toLocaleDateString("fr-FR")}</td>
+                    <td className="p-4 text-gray-600">{roleAssignment.assignedBy}</td>
+                    <td className="p-4">
+                      {roleAssignment.role !== "owner" && (
+                        <Button
+                          variant="outline"
+                          size="sm"
+                          onClick={() => handleRemoveUser(roleAssignment.userId)}
+                          className="text-red-600 hover:text-red-700"
+                        >
+                          <Trash2 className="h-4 w-4" />
+                        </Button>
+                      )}
+                    </td>
+                  </tr>
+                ))}
+              </tbody>
+            </table>
+          </div>
+
+          {filteredRoles.length === 0 && (
+            <div className="text-center py-8">
+              <Users className="h-12 w-12 mx-auto text-gray-400 mb-4" />
+              <h3 className="text-lg font-medium text-gray-900 mb-2">Aucun utilisateur trouvé</h3>
+              <p className="text-gray-600">Essayez de modifier vos critères de recherche</p>
+            </div>
+          )}
+        </CardContent>
+      </Card>
+    </div>
+  )
+}

app/dashboard/folders/loading.tsx

@@ -0,0 +1,75 @@
+export default function FoldersLoading() {
+  return (
+    <div className="space-y-6">
+      {/* Header Skeleton */}
+      <div className="flex flex-col sm:flex-row sm:items-center sm:justify-between">
+        <div>
+          <div className="h-8 w-32 bg-gray-200 rounded animate-pulse mb-2" />
+          <div className="h-4 w-56 bg-gray-200 rounded animate-pulse" />
+        </div>
+        <div className="flex items-center space-x-3 mt-4 sm:mt-0">
+          <div className="h-9 w-24 bg-gray-200 rounded animate-pulse" />
+          <div className="h-9 w-36 bg-gray-200 rounded animate-pulse" />
+        </div>
+      </div>
+
+      {/* Breadcrumb Skeleton */}
+      <div className="flex items-center space-x-2">
+        <div className="h-4 w-16 bg-gray-200 rounded animate-pulse" />
+      </div>
+
+      {/* Stats Cards Skeleton */}
+      <div className="grid grid-cols-1 md:grid-cols-4 gap-4">
+        {[...Array(4)].map((_, i) => (
+          <div key={i} className="bg-white border rounded-lg p-4">
+            <div className="flex items-center justify-between">
+              <div>
+                <div className="h-4 w-16 bg-gray-200 rounded animate-pulse mb-2" />
+                <div className="h-8 w-8 bg-gray-200 rounded animate-pulse" />
+              </div>
+              <div className="h-8 w-8 bg-gray-200 rounded animate-pulse" />
+            </div>
+          </div>
+        ))}
+      </div>
+
+      {/* Search and Filters Skeleton */}
+      <div className="bg-white border rounded-lg p-4">
+        <div className="flex flex-col lg:flex-row lg:items-center lg:justify-between space-y-4 lg:space-y-0">
+          <div className="flex flex-col sm:flex-row sm:items-center space-y-3 sm:space-y-0 sm:space-x-4">
+            <div className="h-10 w-80 bg-gray-200 rounded animate-pulse" />
+            <div className="h-10 w-20 bg-gray-200 rounded animate-pulse" />
+          </div>
+          <div className="flex items-center space-x-3">
+            <div className="h-10 w-32 bg-gray-200 rounded animate-pulse" />
+            <div className="h-10 w-20 bg-gray-200 rounded animate-pulse" />
+          </div>
+        </div>
+      </div>
+
+      {/* Folders Grid Skeleton */}
+      <div className="bg-white border rounded-lg p-6">
+        <div className="grid grid-cols-1 sm:grid-cols-2 md:grid-cols-3 lg:grid-cols-4 gap-6">
+          {[...Array(8)].map((_, i) => (
+            <div key={i} className="border rounded-lg p-6">
+              <div className="flex flex-col items-center space-y-4">
+                <div className="h-16 w-16 bg-gray-200 rounded-xl animate-pulse" />
+                <div className="text-center space-y-2 w-full">
+                  <div className="h-6 w-32 bg-gray-200 rounded animate-pulse mx-auto" />
+                  <div className="h-4 w-full bg-gray-200 rounded animate-pulse" />
+                  <div className="h-4 w-3/4 bg-gray-200 rounded animate-pulse mx-auto" />
+                  <div className="flex items-center justify-center space-x-4">
+                    <div className="h-4 w-8 bg-gray-200 rounded animate-pulse" />
+                    <div className="h-4 w-8 bg-gray-200 rounded animate-pulse" />
+                    <div className="h-4 w-8 bg-gray-200 rounded animate-pulse" />
+                  </div>
+                  <div className="h-6 w-16 bg-gray-200 rounded animate-pulse mx-auto" />
+                </div>
+              </div>
+            </div>
+          ))}
+        </div>
+      </div>
+    </div>
+  )
+}

app/dashboard/layout.tsx

@@ -0,0 +1,327 @@
+"use client"
+
+import type React from "react"
+
+import { useState, useEffect } from "react"
+import { useRouter, usePathname } from "next/navigation"
+import Link from "next/link"
+import { Button } from "@/components/ui/button"
+import { Badge } from "@/components/ui/badge"
+import {
+  LayoutDashboard,
+  FileText,
+  Folder,
+  Search,
+  Users,
+  Settings,
+  Shield,
+  MessageSquare,
+  Bell,
+  LogOut,
+  Menu,
+  X,
+  TestTube,
+  ChevronRight,
+  Home,
+} from "lucide-react"
+import AuthModal from "@/components/4nk/AuthModal"
+import MessageBus from "@/lib/4nk/MessageBus"
+import UserStore from "@/lib/4nk/UserStore"
+// DebugInfo supprimé
+
+export default function DashboardLayout({ children }: { children: React.ReactNode }) {
+  const [isAuthenticated, setIsAuthenticated] = useState(false)
+  const [isAuthModalOpen, setIsAuthModalOpen] = useState(false)
+  const [isLoading, setIsLoading] = useState(true)
+  const [isMockMode, setIsMockMode] = useState(false)
+  const [sidebarOpen, setSidebarOpen] = useState(false)
+  const [userInfo, setUserInfo] = useState<any>(null)
+  const [showLogoutConfirm, setShowLogoutConfirm] = useState(false)
+
+  const router = useRouter()
+  const pathname = usePathname()
+  const iframeUrl = process.env.NEXT_PUBLIC_4NK_IFRAME_URL || "https://dev3.4nkweb.com"
+
+  const navigation = [
+    { name: "Tableau de bord", href: "/dashboard", icon: LayoutDashboard },
+    { name: "Documents", href: "/dashboard/documents", icon: FileText },
+    { name: "Dossiers", href: "/dashboard/folders", icon: Folder },
+    { name: "Recherche", href: "/dashboard/search", icon: Search },
+    { name: "Utilisateurs", href: "/dashboard/users", icon: Users },
+    { name: "Messages", href: "/dashboard/chat", icon: MessageSquare },
+    { name: "Paramètres", href: "/dashboard/settings", icon: Settings },
+  ]
+
+  useEffect(() => {
+    const checkAuthentication = async () => {
+      try {
+        const userStore = UserStore.getInstance()
+        const accessToken = userStore.getAccessToken()
+        const messageBus = MessageBus.getInstance(iframeUrl)
+
+        if (accessToken) {
+          // Vérifier si on est en mode mock
+          // const mockMode = messageBus.isInMockMode()
+          // setIsMockMode(mockMode)
+
+          if (true) {
+            console.log("🎭 Dashboard en mode mock")
+            setIsAuthenticated(true)
+            setUserInfo({
+              id: "mock_user_001",
+              name: "Utilisateur Démo",
+              email: "demo@docv.fr",
+              role: "Administrateur",
+              company: "Entreprise Démo (ID: 1234)",
+            })
+          } else {
+            // Vérifier la validité du token en mode production
+            const isValid = await messageBus.validateToken()
+            if (isValid) {
+              setIsAuthenticated(true)
+              const pairingId = userStore.getUserPairingId()
+              setUserInfo({
+                id: pairingId?.slice(0, 8) + "...",
+                name: "Utilisateur 4NK",
+                email: "user@4nk.io",
+                role: "Utilisateur",
+                company: "Organisation 4NK",
+              })
+            } else {
+              setIsAuthModalOpen(true)
+            }
+          }
+        } else {
+          setIsAuthModalOpen(true)
+        }
+      } catch (error) {
+        console.error("Error checking authentication:", error)
+        setIsAuthModalOpen(true)
+      } finally {
+        setIsLoading(false)
+      }
+    }
+
+    checkAuthentication()
+  }, [iframeUrl])
+
+  const handleAuthSuccess = () => {
+    setIsAuthModalOpen(false)
+    setIsAuthenticated(true)
+    // Recharger la page pour récupérer les nouvelles données
+    window.location.reload()
+  }
+
+  const handleLogout = () => {
+    const userStore = UserStore.getInstance()
+    const messageBus = MessageBus.getInstance(iframeUrl)
+
+    userStore.disconnect()
+    // messageBus.disableMockMode()
+
+    // Afficher un message de confirmation avec options
+    setShowLogoutConfirm(true)
+  }
+
+  const confirmLogout = (goToHome = false) => {
+    setShowLogoutConfirm(false)
+    if (goToHome) {
+      router.push("/")
+    } else {
+      router.push("/login")
+    }
+  }
+
+  if (isLoading) {
+    return (
+      <div className="min-h-screen bg-gray-50 flex items-center justify-center">
+        <div className="text-center">
+          <Shield className="h-12 w-12 mx-auto mb-4 text-blue-600 animate-pulse" />
+          <p className="text-gray-600">Vérification de l'authentification...</p>
+        </div>
+      </div>
+    )
+  }
+
+  if (!isAuthenticated) {
+    return (
+      <div className="min-h-screen bg-gray-50 flex items-center justify-center">
+        <AuthModal
+          isOpen={isAuthModalOpen}
+          onConnect={handleAuthSuccess}
+          onClose={() => router.push("/login")}
+          iframeUrl={iframeUrl}
+        />
+      </div>
+    )
+  }
+
+  return (
+    <div className="flex h-screen bg-gray-50">
+      {/* Sidebar mobile overlay */}
+      {sidebarOpen && (
+        <div className="fixed inset-0 z-40 lg:hidden">
+          <div className="fixed inset-0 bg-gray-600 bg-opacity-75" onClick={() => setSidebarOpen(false)} />
+        </div>
+      )}
+
+      {/* Sidebar */}
+      <div
+        className={`fixed inset-y-0 left-0 z-50 w-64 bg-white shadow-lg transform transition-transform duration-300 ease-in-out lg:translate-x-0 lg:relative lg:flex lg:flex-col ${sidebarOpen ? "translate-x-0" : "-translate-x-full"}`}
+      >
+        <div className="flex flex-col h-full">
+          {/* Logo */}
+          <div className="flex items-center justify-between h-16 px-6 border-b">
+            <div className="flex items-center space-x-2">
+              <Shield className="h-8 w-8 text-blue-600" />
+              <span className="text-xl font-bold text-gray-900">DocV</span>
+              {isMockMode && (
+                <Badge variant="outline" className="bg-green-50 text-green-700 border-green-200 text-xs">
+                  <TestTube className="h-3 w-3 mr-1" />
+                  Démo
+                </Badge>
+              )}
+            </div>
+            <Button variant="ghost" size="sm" className="lg:hidden" onClick={() => setSidebarOpen(false)}>
+              <X className="h-5 w-5" />
+            </Button>
+          </div>
+
+          {/* User info */}
+          {userInfo && (
+            <div className="px-6 py-4 border-b bg-gray-50">
+              <div className="flex items-center space-x-3">
+                <div className="w-10 h-10 bg-blue-100 rounded-full flex items-center justify-center">
+                  <span className="text-blue-600 font-medium text-sm">{userInfo.name.charAt(0)}</span>
+                </div>
+                <div className="flex-1 min-w-0">
+                  <p className="text-sm font-medium text-gray-900 truncate">{userInfo.name}</p>
+                  <p className="text-xs text-gray-500 truncate">{userInfo.company}</p>
+                </div>
+              </div>
+            </div>
+          )}
+
+          {/* Navigation */}
+          <nav className="flex-1 px-4 py-4 space-y-1 overflow-y-auto">
+            {navigation.map((item) => {
+              const isActive = pathname === item.href
+              return (
+                <Link
+                  key={item.name}
+                  href={item.href}
+                  className={`flex items-center px-3 py-2 text-sm font-medium rounded-lg transition-colors ${
+                    isActive ? "bg-blue-100 text-blue-700" : "text-gray-600 hover:bg-gray-100 hover:text-gray-900"
+                  }`}
+                  onClick={() => setSidebarOpen(false)}
+                >
+                  <item.icon className="h-5 w-5 mr-3" />
+                  {item.name}
+                  {isActive && <ChevronRight className="h-4 w-4 ml-auto" />}
+                </Link>
+              )
+            })}
+          </nav>
+
+          {/* Footer */}
+          <div className="p-4 border-t">
+            <div className="space-y-2">
+              <div className="flex items-center justify-between text-xs text-gray-500">
+                <span>Sécurisé par 4NK</span>
+                <Shield className="h-3 w-3" />
+              </div>
+              {isMockMode && (
+                <div className="text-xs text-green-600 bg-green-50 p-2 rounded">Mode démonstration actif</div>
+              )}
+              <Button variant="outline" size="sm" onClick={handleLogout} className="w-full bg-transparent">
+                <LogOut className="h-4 w-4 mr-2" />
+                Déconnexion
+              </Button>
+            </div>
+          </div>
+        </div>
+      </div>
+
+      {/* Main content */}
+      <div className="flex-1 flex flex-col overflow-hidden">
+        {/* Top bar */}
+        <div className="bg-white border-b px-4 py-3 shadow-sm">
+          <div className="flex items-center justify-between">
+            <div className="flex items-center space-x-4">
+              <Button variant="ghost" size="sm" className="lg:hidden" onClick={() => setSidebarOpen(true)}>
+                <Menu className="h-5 w-5" />
+              </Button>
+
+              <div className="hidden lg:block">
+                <nav className="flex space-x-1 text-sm text-gray-500">
+                  <Link href="/dashboard" className="hover:text-gray-700">
+                    Tableau de bord
+                  </Link>
+                  {pathname !== "/dashboard" && (
+                    <>
+                      <ChevronRight className="h-4 w-4 mx-1" />
+                      <span className="text-gray-900 font-medium">
+                        {navigation.find((item) => item.href === pathname)?.name || "Page"}
+                      </span>
+                    </>
+                  )}
+                </nav>
+              </div>
+            </div>
+
+            <div className="flex items-center space-x-3">
+              {isMockMode && (
+                <Badge variant="outline" className="bg-green-50 text-green-700 border-green-200">
+                  <TestTube className="h-4 w-4 mr-1" />
+                  Mode Démo
+                </Badge>
+              )}
+
+              <Button variant="ghost" size="sm">
+                <Bell className="h-5 w-5" />
+              </Button>
+
+              <Button variant="ghost" size="sm">
+                <Settings className="h-5 w-5" />
+              </Button>
+            </div>
+          </div>
+        </div>
+
+        {/* Page content */}
+        <main className="flex-1 overflow-auto bg-gray-50">
+          <div className="p-6">{children}</div>
+        </main>
+      </div>
+
+      {/* Modal de confirmation de déconnexion */}
+      {showLogoutConfirm && (
+        <div className="fixed inset-0 z-50 flex items-center justify-center bg-black bg-opacity-50">
+          <div className="bg-white rounded-lg p-6 max-w-md w-full mx-4">
+            <div className="text-center">
+              <Shield className="h-12 w-12 mx-auto mb-4 text-blue-600" />
+              <h3 className="text-lg font-semibold text-gray-900 mb-2">Déconnexion réussie</h3>
+              <p className="text-gray-600 mb-6">Vous avez été déconnecté de votre espace sécurisé DocV.</p>
+
+              <div className="space-y-3">
+                <Button onClick={() => confirmLogout(false)} className="w-full">
+                  <LogOut className="h-4 w-4 mr-2" />
+                  Aller à la page de connexion
+                </Button>
+
+                <Button onClick={() => confirmLogout(true)} variant="outline" className="w-full">
+                  <Home className="h-4 w-4 mr-2" />
+                  Retourner à l'accueil
+                </Button>
+              </div>
+
+              <p className="text-xs text-gray-500 mt-4">Vos données restent sécurisées par le chiffrement 4NK</p>
+            </div>
+          </div>
+        </div>
+      )}
+
+      {/* Debug info retiré */}
+    </div>
+  )
+}

app/dashboard/loading.tsx

@@ -0,0 +1,3 @@
+export default function Loading() {
+  return null
+}

app/dashboard/page.tsx

@@ -0,0 +1,450 @@
+"use client"
+
+import { useState, useEffect } from "react"
+import { Card, CardContent, CardDescription, CardHeader, CardTitle } from "@/components/ui/card"
+import { Button } from "@/components/ui/button"
+import { Badge } from "@/components/ui/badge"
+import {
+  FileText,
+  Folder,
+  Users,
+  Activity,
+  TrendingUp,
+  Clock,
+  Shield,
+  AlertCircle,
+  CheckCircle,
+  Download,
+  Upload,
+  Search,
+  Plus,
+  MoreHorizontal,
+  Edit,
+  Share2,
+  TestTube,
+  Zap,
+  HardDrive,
+  X,
+} from "lucide-react"
+import MessageBus from "@/lib/4nk/MessageBus"
+import Link from "next/link"
+
+export default function DashboardPage() {
+  const [isMockMode, setIsMockMode] = useState(false)
+  const [stats, setStats] = useState({
+    totalDocuments: 0,
+    totalFolders: 0,
+    totalUsers: 0,
+    storageUsed: 0,
+    storageLimit: 100,
+    recentActivity: 0,
+    // Nouveaux indicateurs
+    permanentStorage: 0,
+    permanentStorageLimit: 1000, // 1 To en Go
+    temporaryStorage: 0,
+    temporaryStorageLimit: 100, // 100 Go
+    newFoldersThisMonth: 0,
+    newFoldersLimit: 75,
+    tokensUsed: 0,
+    tokensTotal: 1000,
+  })
+
+  const [recentDocuments, setRecentDocuments] = useState<any[]>([])
+  const [recentActivity, setRecentActivity] = useState<any[]>([])
+  const [notifications, setNotifications] = useState<any[]>([])
+
+  useEffect(() => {
+    const iframeUrl = process.env.NEXT_PUBLIC_4NK_IFRAME_URL || "https://dev3.4nkweb.com"
+    const messageBus = MessageBus.getInstance(iframeUrl)
+    // const mockMode = messageBus.isInMockMode()
+    // setIsMockMode(mockMode)
+
+    // Simuler le chargement des données
+    if (true) {
+      setStats({
+        totalDocuments: 1247,
+        totalFolders: 89,
+        totalUsers: 12,
+        storageUsed: 67.3,
+        storageLimit: 100,
+        recentActivity: 24,
+        // Nouveaux indicateurs avec données réalistes
+        permanentStorage: 673, // 673 Go utilisés sur 1000 Go
+        permanentStorageLimit: 1000,
+        temporaryStorage: 45, // 45 Go utilisés sur 100 Go
+        temporaryStorageLimit: 100,
+        newFoldersThisMonth: 23, // 23 nouveaux dossiers ce mois
+        newFoldersLimit: 75,
+        tokensUsed: 673, // Environ 67% des jetons utilisés
+        tokensTotal: 1000,
+      })
+
+      setRecentDocuments([
+        {
+          id: "doc_001",
+          name: "Contrat_Client_ABC_2024.pdf",
+          type: "PDF",
+          size: "2.4 MB",
+          modifiedAt: "Il y a 2 heures",
+          modifiedBy: "Marie Dubois",
+          status: "Signé",
+          folder: "Contrats 2024",
+        },
+        {
+          id: "doc_002",
+          name: "Rapport_Financier_Q1.xlsx",
+          type: "Excel",
+          size: "1.8 MB",
+          modifiedAt: "Il y a 4 heures",
+          modifiedBy: "Jean Martin",
+          status: "En révision",
+          folder: "Finance",
+        },
+        {
+          id: "doc_003",
+          name: "Présentation_Produit_V2.pptx",
+          type: "PowerPoint",
+          size: "15.2 MB",
+          modifiedAt: "Hier",
+          modifiedBy: "Sophie Laurent",
+          status: "Finalisé",
+          folder: "Marketing",
+        },
+        {
+          id: "doc_004",
+          name: "Cahier_des_charges_Projet_X.docx",
+          type: "Word",
+          size: "892 KB",
+          modifiedAt: "Il y a 2 jours",
+          modifiedBy: "Pierre Durand",
+          status: "Brouillon",
+          folder: "Projets",
+        },
+        {
+          id: "doc_005",
+          name: "Facture_2024_001.pdf",
+          type: "PDF",
+          size: "156 KB",
+          modifiedAt: "Il y a 3 jours",
+          modifiedBy: "Marie Dubois",
+          status: "Payée",
+          folder: "Comptabilité",
+        },
+      ])
+
+      setRecentActivity([
+        {
+          id: "act_001",
+          type: "upload",
+          user: "Marie Dubois",
+          action: "a téléchargé",
+          target: "Contrat_Client_ABC_2024.pdf",
+          time: "Il y a 2 heures",
+          icon: Upload,
+          color: "text-green-600",
+        },
+        {
+          id: "act_002",
+          type: "edit",
+          user: "Jean Martin",
+          action: "a modifié",
+          target: "Rapport_Financier_Q1.xlsx",
+          time: "Il y a 4 heures",
+          icon: Edit,
+          color: "text-blue-600",
+        },
+        {
+          id: "act_003",
+          type: "share",
+          user: "Sophie Laurent",
+          action: "a partagé",
+          target: "Présentation_Produit_V2.pptx",
+          time: "Hier",
+          icon: Share2,
+          color: "text-purple-600",
+        },
+        {
+          id: "act_004",
+          type: "create",
+          user: "Pierre Durand",
+          action: "a créé le dossier",
+          target: "Projets 2024",
+          time: "Il y a 2 jours",
+          icon: Folder,
+          color: "text-orange-600",
+        },
+        {
+          id: "act_005",
+          type: "download",
+          user: "Marie Dubois",
+          action: "a téléchargé",
+          target: "Facture_2024_001.pdf",
+          time: "Il y a 3 jours",
+          icon: Download,
+          color: "text-indigo-600",
+        },
+      ])
+
+      setNotifications([
+        {
+          id: "notif_001",
+          type: "success",
+          title: "Document signé",
+          message: "Le contrat ABC a été signé par toutes les parties",
+          time: "Il y a 1 heure",
+          icon: CheckCircle,
+          color: "text-green-600",
+          bgColor: "bg-green-50",
+        },
+        {
+          id: "notif_002",
+          type: "warning",
+          title: "Stockage temporaire élevé",
+          message: "45 Go utilisés sur 100 Go de stockage temporaire ce mois",
+          time: "Il y a 2 heures",
+          icon: AlertCircle,
+          color: "text-orange-600",
+          bgColor: "bg-orange-50",
+        },
+        {
+          id: "notif_003",
+          type: "info",
+          title: "Nouvel utilisateur",
+          message: "Thomas Petit a rejoint l'équipe Marketing",
+          time: "Hier",
+          icon: Users,
+          color: "text-blue-600",
+          bgColor: "bg-blue-50",
+        },
+      ])
+    }
+  }, [])
+
+  const getFileIcon = (type: string) => {
+    switch (type.toLowerCase()) {
+      case "pdf":
+        return "📄"
+      case "excel":
+        return "📊"
+      case "powerpoint":
+        return "📈"
+      case "word":
+        return "📝"
+      default:
+        return "📄"
+    }
+  }
+
+  const getStatusColor = (status: string) => {
+    switch (status.toLowerCase()) {
+      case "signé":
+      case "finalisé":
+      case "payée":
+        return "bg-green-100 text-green-800"
+      case "en révision":
+        return "bg-orange-100 text-orange-800"
+      case "brouillon":
+        return "bg-gray-100 text-gray-800"
+      default:
+        return "bg-blue-100 text-blue-800"
+    }
+  }
+
+  return (
+    <div className="space-y-6">
+      {/* En-tête */}
+      <div className="flex items-center justify-between">
+        <div>
+          <h1 className="text-2xl font-bold text-gray-900">Tableau de bord</h1>
+          <p className="text-gray-600">Vue d'ensemble de votre espace documentaire sécurisé</p>
+        </div>
+        {isMockMode && (
+          <Badge variant="outline" className="bg-green-50 text-green-700 border-green-200">
+            <TestTube className="h-4 w-4 mr-2" />
+            Données de démonstration
+          </Badge>
+        )}
+      </div>
+
+      {/* Statistiques principales */}
+      <div className="grid grid-cols-1 md:grid-cols-2 lg:grid-cols-4 gap-6">
+        {/* SUPPRIMER les cartes Documents, Dossiers, Collaborateurs */}
+        {/* Conserver uniquement les autres indicateurs utiles (ex : Jetons utilisés, stockage, etc.) */}
+      </div>
+
+      {/* Nouveaux indicateurs de stockage */}
+      <div className="grid grid-cols-1 md:grid-cols-3 gap-6">
+        <Card>
+          <CardHeader className="flex flex-row items-center justify-between space-y-0 pb-2">
+            <CardTitle className="text-sm font-medium">Stockage permanent</CardTitle>
+            <HardDrive className="h-4 w-4 text-blue-600" />
+          </CardHeader>
+          <CardContent>
+            <div className="text-2xl font-bold">{stats.permanentStorage} Go</div>
+            <div className="w-full bg-gray-200 rounded-full h-2 mt-2">
+              <div
+                className="bg-blue-600 h-2 rounded-full"
+                style={{ width: `${(stats.permanentStorage / stats.permanentStorageLimit) * 100}%` }}
+              ></div>
+            </div>
+            <p className="text-xs text-muted-foreground mt-1">
+              {stats.permanentStorage} Go / {stats.permanentStorageLimit} Go (1 To)
+            </p>
+          </CardContent>
+        </Card>
+
+        <Card>
+          <CardHeader className="flex flex-row items-center justify-between space-y-0 pb-2">
+            <CardTitle className="text-sm font-medium">Stockage temporaire</CardTitle>
+            <Zap className="h-4 w-4 text-orange-600" />
+          </CardHeader>
+          <CardContent>
+            <div className="text-2xl font-bold">{stats.temporaryStorage} Go</div>
+            <div className="w-full bg-gray-200 rounded-full h-2 mt-2">
+              <div
+                className={`h-2 rounded-full ${
+                  stats.temporaryStorage > 80
+                    ? "bg-red-600"
+                    : stats.temporaryStorage > 60
+                      ? "bg-orange-600"
+                      : "bg-green-600"
+                }`}
+                style={{ width: `${(stats.temporaryStorage / stats.temporaryStorageLimit) * 100}%` }}
+              ></div>
+            </div>
+            <p className="text-xs text-muted-foreground mt-1">
+              {stats.temporaryStorage} Go / {stats.temporaryStorageLimit} Go ce mois
+            </p>
+          </CardContent>
+        </Card>
+
+        <Card>
+          <CardHeader className="flex flex-row items-center justify-between space-y-0 pb-2">
+            <CardTitle className="text-sm font-medium">Nouveaux dossiers</CardTitle>
+            <Plus className="h-4 w-4 text-green-600" />
+          </CardHeader>
+          <CardContent>
+            <div className="text-2xl font-bold">{stats.newFoldersThisMonth}</div>
+            <div className="w-full bg-gray-200 rounded-full h-2 mt-2">
+              <div
+                className="bg-green-600 h-2 rounded-full"
+                style={{ width: `${(stats.newFoldersThisMonth / stats.newFoldersLimit) * 100}%` }}
+              ></div>
+            </div>
+            <p className="text-xs text-muted-foreground mt-1">
+              {stats.newFoldersThisMonth} / {stats.newFoldersLimit} ce mois
+            </p>
+          </CardContent>
+        </Card>
+      </div>
+
+      <div className="grid grid-cols-1 lg:grid-cols-2 gap-6">
+        {/* Documents récents */}
+        <Card>
+          <CardHeader>
+            <CardTitle className="flex items-center justify-between">
+              <span className="flex items-center">
+                <FileText className="h-5 w-5 mr-2" />
+                Documents récents
+              </span>
+              <Link href="/dashboard/documents">
+                <Button variant="ghost" size="sm">
+                  Voir tout
+                </Button>
+              </Link>
+            </CardTitle>
+          </CardHeader>
+          <CardContent>
+            <div className="space-y-4">
+              {recentDocuments.map((doc) => (
+                <div key={doc.id} className="flex items-center space-x-4 p-3 rounded-lg hover:bg-gray-50">
+                  <div className="text-2xl">{getFileIcon(doc.type)}</div>
+                  <div className="flex-1 min-w-0">
+                    <p className="text-sm font-medium text-gray-900 truncate">{doc.name}</p>
+                    <div className="flex items-center space-x-2 text-xs text-gray-500">
+                      <span>{doc.folder}</span>
+                      <span>•</span>
+                      <span>{doc.size}</span>
+                      <span>•</span>
+                      <span>{doc.modifiedAt}</span>
+                    </div>
+                  </div>
+                  <Badge className={getStatusColor(doc.status)}>{doc.status}</Badge>
+                  <Button variant="ghost" size="sm">
+                    <MoreHorizontal className="h-4 w-4" />
+                  </Button>
+                </div>
+              ))}
+            </div>
+          </CardContent>
+        </Card>
+
+        {/* Activité récente */}
+        <Card>
+          <CardHeader>
+            <CardTitle className="flex items-center">
+              <Activity className="h-5 w-5 mr-2" />
+              Activité récente
+            </CardTitle>
+          </CardHeader>
+          <CardContent>
+            <div className="space-y-4">
+              {recentActivity.map((activity) => (
+                <div key={activity.id} className="flex items-start space-x-3">
+                  <div className={`p-2 rounded-full bg-gray-100 ${activity.color}`}>
+                    <activity.icon className="h-4 w-4" />
+                  </div>
+                  <div className="flex-1 min-w-0">
+                    <p className="text-sm text-gray-900">
+                      <span className="font-medium">{activity.user}</span> {activity.action}{" "}
+                      <span className="font-medium">{activity.target}</span>
+                    </p>
+                    <p className="text-xs text-gray-500 flex items-center">
+                      <Clock className="h-3 w-3 mr-1" />
+                      {activity.time}
+                    </p>
+                  </div>
+                </div>
+              ))}
+            </div>
+          </CardContent>
+        </Card>
+      </div>
+
+      {/* Sécurité */}
+      <Card>
+        <CardHeader>
+          <CardTitle className="flex items-center">
+            <Shield className="h-5 w-5 mr-2 text-green-600" />
+            Statut de sécurité
+          </CardTitle>
+        </CardHeader>
+        <CardContent>
+          <div className="flex items-center space-x-4 p-4 bg-green-50 rounded-lg">
+            <CheckCircle className="h-8 w-8 text-green-600" />
+            <div>
+              <h4 className="font-medium text-green-900">Sécurité optimale</h4>
+              <p className="text-sm text-green-700">
+                Tous vos documents sont chiffrés et sécurisés par la technologie 4NK
+              </p>
+            </div>
+          </div>
+          <div className="grid grid-cols-1 md:grid-cols-3 gap-4 mt-4">
+            <div className="text-center p-3">
+              <Shield className="h-6 w-6 mx-auto text-green-600 mb-2" />
+              <p className="text-sm font-medium">Chiffrement bout en bout</p>
+            </div>
+            <div className="text-center p-3">
+              <CheckCircle className="h-6 w-6 mx-auto text-green-600 mb-2" />
+              <p className="text-sm font-medium">Authentification 4NK</p>
+            </div>
+            <div className="text-center p-3">
+              <Activity className="h-6 w-6 mx-auto text-green-600 mb-2" />
+              <p className="text-sm font-medium">Audit complet</p>
+            </div>
+          </div>
+        </CardContent>
+      </Card>
+    </div>
+  )
+}

app/dashboard/search/loading.tsx

@@ -0,0 +1,76 @@
+export default function SearchLoading() {
+  return (
+    <div className="space-y-6">
+      {/* Header Skeleton */}
+      <div className="flex flex-col sm:flex-row sm:items-center sm:justify-between">
+        <div>
+          <div className="h-8 w-32 bg-gray-200 rounded animate-pulse mb-2" />
+          <div className="h-4 w-72 bg-gray-200 rounded animate-pulse" />
+        </div>
+        <div className="flex items-center space-x-3 mt-4 sm:mt-0">
+          <div className="h-9 w-40 bg-gray-200 rounded animate-pulse" />
+        </div>
+      </div>
+
+      {/* Search Bar Skeleton */}
+      <div className="bg-white border rounded-lg p-6">
+        <div className="space-y-4">
+          <div className="h-12 w-full bg-gray-200 rounded animate-pulse" />
+          <div className="flex flex-wrap gap-2">
+            {[...Array(4)].map((_, i) => (
+              <div key={i} className="h-8 w-20 bg-gray-200 rounded animate-pulse" />
+            ))}
+          </div>
+        </div>
+      </div>
+
+      {/* Search Stats Skeleton */}
+      <div className="bg-white border rounded-lg p-4">
+        <div className="flex flex-col sm:flex-row sm:items-center sm:justify-between space-y-3 sm:space-y-0">
+          <div className="flex items-center space-x-6">
+            <div className="h-4 w-48 bg-gray-200 rounded animate-pulse" />
+            <div className="h-4 w-32 bg-gray-200 rounded animate-pulse" />
+          </div>
+          <div className="h-10 w-32 bg-gray-200 rounded animate-pulse" />
+        </div>
+      </div>
+
+      {/* Search Results Skeleton */}
+      <div className="bg-white border rounded-lg">
+        <div className="divide-y">
+          {[...Array(6)].map((_, i) => (
+            <div key={i} className="p-6">
+              <div className="flex items-start space-x-4">
+                <div className="h-4 w-4 bg-gray-200 rounded animate-pulse" />
+                <div className="h-12 w-12 bg-gray-200 rounded-lg animate-pulse" />
+                <div className="flex-1 space-y-3">
+                  <div className="flex items-start justify-between">
+                    <div className="flex-1">
+                      <div className="h-6 w-64 bg-gray-200 rounded animate-pulse mb-2" />
+                      <div className="h-4 w-96 bg-gray-200 rounded animate-pulse" />
+                    </div>
+                    <div className="flex items-center space-x-2">
+                      <div className="h-6 w-20 bg-gray-200 rounded animate-pulse" />
+                      <div className="flex space-x-1">
+                        {[...Array(4)].map((_, j) => (
+                          <div key={j} className="h-8 w-8 bg-gray-200 rounded animate-pulse" />
+                        ))}
+                      </div>
+                    </div>
+                  </div>
+                  <div className="h-4 w-full bg-gray-200 rounded animate-pulse" />
+                  <div className="h-4 w-3/4 bg-gray-200 rounded animate-pulse" />
+                  <div className="flex space-x-2">
+                    {[...Array(3)].map((_, j) => (
+                      <div key={j} className="h-5 w-16 bg-gray-200 rounded animate-pulse" />
+                    ))}
+                  </div>
+                </div>
+              </div>
+            </div>
+          ))}
+        </div>
+      </div>
+    </div>
+  )
+}

app/dashboard/search/page.tsx

@@ -0,0 +1,782 @@
+"use client"
+
+import { useState, useEffect } from "react"
+import { Card, CardContent, CardHeader, CardTitle } from "@/components/ui/card"
+import { Badge } from "@/components/ui/badge"
+import { Button } from "@/components/ui/button"
+import { Input } from "@/components/ui/input"
+import { Label } from "@/components/ui/label"
+import { Checkbox } from "@/components/ui/checkbox"
+import { Select, SelectContent, SelectItem, SelectTrigger, SelectValue } from "@/components/ui/select"
+import { Textarea } from "@/components/ui/textarea"
+import {
+  Search,
+  FileText,
+  Folder,
+  Tag,
+  Clock,
+  Eye,
+  Download,
+  Share2,
+  Star,
+  ChevronUp,
+  Zap,
+  Target,
+  BookOpen,
+  ImageIcon,
+  FileSpreadsheet,
+  FileVideo,
+  Archive,
+  MoreHorizontal,
+  X,
+  SortAsc,
+  SortDesc,
+} from "lucide-react"
+
+export default function SearchPage() {
+  const [searchQuery, setSearchQuery] = useState("")
+  const [advancedSearch, setAdvancedSearch] = useState(false)
+  const [searchResults, setSearchResults] = useState<any[]>([])
+  const [isSearching, setIsSearching] = useState(false)
+  const [searchStats, setSearchStats] = useState({
+    total: 0,
+    documents: 0,
+    folders: 0,
+    searchTime: 0,
+  })
+
+  // Advanced search filters
+  const [filters, setFilters] = useState({
+    fileType: "all",
+    dateRange: "all",
+    author: "all",
+    folder: "all",
+    tags: "",
+    content: "",
+    exactPhrase: "",
+    excludeWords: "",
+    minSize: "",
+    maxSize: "",
+  })
+
+  const [sortBy, setSortBy] = useState("relevance")
+  const [sortOrder, setSortOrder] = useState<"asc" | "desc">("desc")
+  const [selectedResults, setSelectedResults] = useState<number[]>([])
+
+  useEffect(() => {
+    // Simuler une recherche automatique si il y a une query
+    if (searchQuery.trim()) {
+      performSearch()
+    } else {
+      setSearchResults([])
+      setSearchStats({ total: 0, documents: 0, folders: 0, searchTime: 0 })
+    }
+  }, [searchQuery, filters, sortBy, sortOrder])
+
+  const performSearch = async () => {
+    setIsSearching(true)
+    const startTime = Date.now()
+
+    // Simuler un délai de recherche
+    await new Promise((resolve) => setTimeout(resolve, 500))
+
+    // Données de démonstration pour les résultats de recherche
+    const mockResults = [
+      {
+        id: 1,
+        type: "document",
+        name: "Contrat_Client_ABC.pdf",
+        path: "/Contrats/Clients/",
+        content: "Contrat de prestation de services avec le client ABC Corporation...",
+        size: "2.4 MB",
+        modified: new Date("2024-01-15T10:30:00"),
+        author: "Marie Dubois",
+        tags: ["contrat", "client", "juridique"],
+        relevance: 95,
+        highlights: ["Contrat", "client ABC", "prestation de services"],
+        fileType: "PDF",
+        thumbnail: "/placeholder.svg?height=60&width=60&text=PDF",
+      },
+      {
+        id: 2,
+        type: "folder",
+        name: "Projets Alpha",
+        path: "/Projets/",
+        content: "Dossier contenant tous les documents du projet Alpha",
+        documentsCount: 23,
+        modified: new Date("2024-01-14T16:45:00"),
+        author: "Jean Martin",
+        tags: ["projet", "alpha", "développement"],
+        relevance: 88,
+        highlights: ["Projet Alpha", "développement"],
+      },
+      {
+        id: 3,
+        type: "document",
+        name: "Rapport_Mensuel_Nov.docx",
+        path: "/Rapports/2024/",
+        content: "Rapport mensuel de novembre avec analyse des performances...",
+        size: "1.8 MB",
+        modified: new Date("2024-01-13T08:45:00"),
+        author: "Sophie Laurent",
+        tags: ["rapport", "mensuel", "analyse"],
+        relevance: 82,
+        highlights: ["Rapport mensuel", "novembre", "performances"],
+        fileType: "DOCX",
+        thumbnail: "/placeholder.svg?height=60&width=60&text=DOCX",
+      },
+      {
+        id: 4,
+        type: "document",
+        name: "Budget_2024.xlsx",
+        path: "/Finance/Budgets/",
+        content: "Budget prévisionnel pour l'année 2024 avec détail par département...",
+        size: "892 KB",
+        modified: new Date("2024-01-12T14:20:00"),
+        author: "Marie Dubois",
+        tags: ["budget", "2024", "finance"],
+        relevance: 76,
+        highlights: ["Budget", "2024", "prévisionnel"],
+        fileType: "XLSX",
+        thumbnail: "/placeholder.svg?height=60&width=60&text=XLSX",
+      },
+      {
+        id: 5,
+        type: "document",
+        name: "Présentation_Projet.pptx",
+        path: "/Projets/Alpha/",
+        content: "Présentation du projet Alpha pour le comité de direction...",
+        size: "5.2 MB",
+        modified: new Date("2024-01-11T07:15:00"),
+        author: "Jean Martin",
+        tags: ["présentation", "projet", "alpha"],
+        relevance: 71,
+        highlights: ["Présentation", "projet Alpha", "comité"],
+        fileType: "PPTX",
+        thumbnail: "/placeholder.svg?height=60&width=60&text=PPTX",
+      },
+      {
+        id: 6,
+        type: "document",
+        name: "Formation_Équipe.mp4",
+        path: "/Formation/Vidéos/",
+        content: "Vidéo de formation pour l'équipe sur les nouvelles procédures...",
+        size: "45.2 MB",
+        modified: new Date("2024-01-10T11:30:00"),
+        author: "Pierre Durand",
+        tags: ["formation", "vidéo", "équipe"],
+        relevance: 65,
+        highlights: ["Formation", "équipe", "procédures"],
+        fileType: "MP4",
+        thumbnail: "/placeholder.svg?height=60&width=60&text=MP4",
+      },
+    ]
+
+    // Filtrer les résultats selon les critères
+    let filteredResults = mockResults.filter((result) => {
+      if (
+        !result.name.toLowerCase().includes(searchQuery.toLowerCase()) &&
+        !result.content.toLowerCase().includes(searchQuery.toLowerCase())
+      ) {
+        return false
+      }
+
+      if (
+        filters.fileType !== "all" &&
+        result.type === "document" &&
+        result.fileType?.toLowerCase() !== filters.fileType.toLowerCase()
+      ) {
+        return false
+      }
+
+      if (filters.author !== "all" && result.author !== filters.author) {
+        return false
+      }
+
+      return true
+    })
+
+    // Trier les résultats
+    filteredResults = filteredResults.sort((a, b) => {
+      let aValue, bValue
+      switch (sortBy) {
+        case "name":
+          aValue = a.name.toLowerCase()
+          bValue = b.name.toLowerCase()
+          break
+        case "date":
+          aValue = a.modified.getTime()
+          bValue = b.modified.getTime()
+          break
+        case "author":
+          aValue = a.author.toLowerCase()
+          bValue = b.author.toLowerCase()
+          break
+        case "relevance":
+        default:
+          aValue = a.relevance
+          bValue = b.relevance
+          break
+      }
+
+      if (sortOrder === "asc") {
+        return aValue > bValue ? 1 : -1
+      } else {
+        return aValue < bValue ? 1 : -1
+      }
+    })
+
+    const endTime = Date.now()
+    const searchTime = (endTime - startTime) / 1000
+
+    setSearchResults(filteredResults)
+    setSearchStats({
+      total: filteredResults.length,
+      documents: filteredResults.filter((r) => r.type === "document").length,
+      folders: filteredResults.filter((r) => r.type === "folder").length,
+      searchTime,
+    })
+    setIsSearching(false)
+  }
+
+  const getFileIcon = (type: string) => {
+    switch (type?.toLowerCase()) {
+      case "pdf":
+        return <FileText className="h-5 w-5 text-red-600" />
+      case "docx":
+      case "doc":
+        return <FileText className="h-5 w-5 text-blue-600" />
+      case "xlsx":
+      case "xls":
+        return <FileSpreadsheet className="h-5 w-5 text-green-600" />
+      case "pptx":
+      case "ppt":
+        return <FileText className="h-5 w-5 text-orange-600" />
+      case "png":
+      case "jpg":
+      case "jpeg":
+        return <ImageIcon className="h-5 w-5 text-purple-600" />
+      case "mp4":
+      case "avi":
+        return <FileVideo className="h-5 w-5 text-pink-600" />
+      case "zip":
+      case "rar":
+        return <Archive className="h-5 w-5 text-gray-600" />
+      default:
+        return <FileText className="h-5 w-5 text-gray-600" />
+    }
+  }
+
+  const formatDate = (date: Date) => {
+    const now = new Date()
+    const diffInHours = (now.getTime() - date.getTime()) / (1000 * 60 * 60)
+
+    if (diffInHours < 1) {
+      return "Il y a quelques minutes"
+    } else if (diffInHours < 24) {
+      return `Il y a ${Math.floor(diffInHours)} heure${Math.floor(diffInHours) > 1 ? "s" : ""}`
+    } else if (diffInHours < 48) {
+      return "Hier"
+    } else {
+      return date.toLocaleDateString("fr-FR")
+    }
+  }
+
+  const highlightText = (text: string, highlights: string[]) => {
+    let highlightedText = text
+    highlights.forEach((highlight) => {
+      const regex = new RegExp(`(${highlight})`, "gi")
+      highlightedText = highlightedText.replace(regex, "<mark class='bg-yellow-200'>$1</mark>")
+    })
+    return highlightedText
+  }
+
+  const toggleResultSelection = (resultId: number) => {
+    setSelectedResults((prev) => (prev.includes(resultId) ? prev.filter((id) => id !== resultId) : [...prev, resultId]))
+  }
+
+  const clearFilters = () => {
+    setFilters({
+      fileType: "all",
+      dateRange: "all",
+      author: "all",
+      folder: "all",
+      tags: "",
+      content: "",
+      exactPhrase: "",
+      excludeWords: "",
+      minSize: "",
+      maxSize: "",
+    })
+  }
+
+  return (
+    <div className="space-y-6">
+      {/* Header */}
+      <div className="flex flex-col sm:flex-row sm:items-center sm:justify-between">
+        <div>
+          <h1 className="text-2xl font-bold text-gray-900">Recherche</h1>
+          <p className="text-gray-600 mt-1">Trouvez rapidement vos documents et dossiers</p>
+        </div>
+        <div className="flex items-center space-x-3 mt-4 sm:mt-0">
+          <Button
+            variant="outline"
+            onClick={() => setAdvancedSearch(!advancedSearch)}
+            className={advancedSearch ? "bg-blue-50 text-blue-700 border-blue-200" : ""}
+          >
+            <Target className="h-4 w-4 mr-2" />
+            Recherche avancée
+          </Button>
+        </div>
+      </div>
+
+      {/* Search Bar */}
+      <Card>
+        <CardContent className="p-6">
+          <div className="space-y-4">
+            <div className="relative">
+              <Search className="absolute left-3 top-1/2 transform -translate-y-1/2 h-5 w-5 text-gray-400" />
+              <Input
+                placeholder="Rechercher dans tous vos documents et dossiers..."
+                value={searchQuery}
+                onChange={(e) => setSearchQuery(e.target.value)}
+                className="pl-10 text-lg h-12"
+              />
+              {searchQuery && (
+                <Button
+                  variant="ghost"
+                  size="sm"
+                  className="absolute right-2 top-1/2 transform -translate-y-1/2"
+                  onClick={() => setSearchQuery("")}
+                >
+                  <X className="h-4 w-4" />
+                </Button>
+              )}
+            </div>
+
+            {/* Quick Filters */}
+            <div className="flex flex-wrap gap-2">
+              <Button variant="outline" size="sm" onClick={() => setSearchQuery("contrat")} className="text-xs">
+                <FileText className="h-3 w-3 mr-1" />
+                Contrats
+              </Button>
+              <Button variant="outline" size="sm" onClick={() => setSearchQuery("rapport")} className="text-xs">
+                <BookOpen className="h-3 w-3 mr-1" />
+                Rapports
+              </Button>
+              <Button variant="outline" size="sm" onClick={() => setSearchQuery("budget")} className="text-xs">
+                <Target className="h-3 w-3 mr-1" />
+                Budgets
+              </Button>
+              <Button variant="outline" size="sm" onClick={() => setSearchQuery("projet")} className="text-xs">
+                <Folder className="h-3 w-3 mr-1" />
+                Projets
+              </Button>
+            </div>
+          </div>
+        </CardContent>
+      </Card>
+
+      {/* Advanced Search */}
+      {advancedSearch && (
+        <Card>
+          <CardHeader>
+            <CardTitle className="flex items-center justify-between">
+              <span className="flex items-center">
+                <Target className="h-5 w-5 mr-2" />
+                Recherche avancée
+              </span>
+              <Button variant="ghost" size="sm" onClick={() => setAdvancedSearch(false)}>
+                <ChevronUp className="h-4 w-4" />
+              </Button>
+            </CardTitle>
+          </CardHeader>
+          <CardContent className="space-y-4">
+            <div className="grid grid-cols-1 md:grid-cols-2 lg:grid-cols-3 gap-4">
+              <div>
+                <Label htmlFor="fileType" className="text-sm font-medium">
+                  Type de fichier
+                </Label>
+                <Select value={filters.fileType} onValueChange={(value) => setFilters({ ...filters, fileType: value })}>
+                  <SelectTrigger>
+                    <SelectValue />
+                  </SelectTrigger>
+                  <SelectContent>
+                    <SelectItem value="all">Tous les types</SelectItem>
+                    <SelectItem value="pdf">PDF</SelectItem>
+                    <SelectItem value="docx">Word</SelectItem>
+                    <SelectItem value="xlsx">Excel</SelectItem>
+                    <SelectItem value="pptx">PowerPoint</SelectItem>
+                    <SelectItem value="png">Images</SelectItem>
+                    <SelectItem value="mp4">Vidéos</SelectItem>
+                  </SelectContent>
+                </Select>
+              </div>
+
+              <div>
+                <Label htmlFor="dateRange" className="text-sm font-medium">
+                  Période
+                </Label>
+                <Select
+                  value={filters.dateRange}
+                  onValueChange={(value) => setFilters({ ...filters, dateRange: value })}
+                >
+                  <SelectTrigger>
+                    <SelectValue />
+                  </SelectTrigger>
+                  <SelectContent>
+                    <SelectItem value="all">Toutes les dates</SelectItem>
+                    <SelectItem value="today">Aujourd'hui</SelectItem>
+                    <SelectItem value="week">Cette semaine</SelectItem>
+                    <SelectItem value="month">Ce mois</SelectItem>
+                    <SelectItem value="year">Cette année</SelectItem>
+                  </SelectContent>
+                </Select>
+              </div>
+
+              <div>
+                <Label htmlFor="author" className="text-sm font-medium">
+                  Auteur
+                </Label>
+                <Select value={filters.author} onValueChange={(value) => setFilters({ ...filters, author: value })}>
+                  <SelectTrigger>
+                    <SelectValue />
+                  </SelectTrigger>
+                  <SelectContent>
+                    <SelectItem value="all">Tous les auteurs</SelectItem>
+                    <SelectItem value="Marie Dubois">Marie Dubois</SelectItem>
+                    <SelectItem value="Sophie Laurent">Sophie Laurent</SelectItem>
+                    <SelectItem value="Jean Martin">Jean Martin</SelectItem>
+                    <SelectItem value="Pierre Durand">Pierre Durand</SelectItem>
+                    <SelectItem value="Admin">Admin</SelectItem>
+                  </SelectContent>
+                </Select>
+              </div>
+            </div>
+
+            <div className="grid grid-cols-1 md:grid-cols-2 gap-4">
+              <div>
+                <Label htmlFor="exactPhrase" className="text-sm font-medium">
+                  Phrase exacte
+                </Label>
+                <Input
+                  id="exactPhrase"
+                  placeholder="Rechercher cette phrase exacte"
+                  value={filters.exactPhrase}
+                  onChange={(e) => setFilters({ ...filters, exactPhrase: e.target.value })}
+                />
+              </div>
+
+              <div>
+                <Label htmlFor="excludeWords" className="text-sm font-medium">
+                  Exclure les mots
+                </Label>
+                <Input
+                  id="excludeWords"
+                  placeholder="Mots à exclure (séparés par des espaces)"
+                  value={filters.excludeWords}
+                  onChange={(e) => setFilters({ ...filters, excludeWords: e.target.value })}
+                />
+              </div>
+            </div>
+
+            <div>
+              <Label htmlFor="tags" className="text-sm font-medium">
+                Tags
+              </Label>
+              <Input
+                id="tags"
+                placeholder="Rechercher par tags (séparés par des virgules)"
+                value={filters.tags}
+                onChange={(e) => setFilters({ ...filters, tags: e.target.value })}
+              />
+            </div>
+
+            <div>
+              <Label htmlFor="content" className="text-sm font-medium">
+                Contenu du document
+              </Label>
+              <Textarea
+                id="content"
+                placeholder="Rechercher dans le contenu des documents..."
+                value={filters.content}
+                onChange={(e) => setFilters({ ...filters, content: e.target.value })}
+                rows={3}
+              />
+            </div>
+
+            <div className="flex justify-end space-x-2">
+              <Button variant="outline" onClick={clearFilters}>
+                Réinitialiser
+              </Button>
+              <Button onClick={performSearch}>
+                <Search className="h-4 w-4 mr-2" />
+                Rechercher
+              </Button>
+            </div>
+          </CardContent>
+        </Card>
+      )}
+
+      {/* Search Stats */}
+      {searchQuery && (
+        <Card>
+          <CardContent className="p-4">
+            <div className="flex flex-col sm:flex-row sm:items-center sm:justify-between space-y-3 sm:space-y-0">
+              <div className="flex items-center space-x-6">
+                <div className="flex items-center space-x-2">
+                  <Zap className="h-4 w-4 text-blue-600" />
+                  <span className="text-sm text-gray-600">
+                    {isSearching ? "Recherche en cours..." : `${searchStats.total} résultats trouvés`}
+                  </span>
+                  {!isSearching && searchStats.searchTime > 0 && (
+                    <span className="text-xs text-gray-500">({searchStats.searchTime.toFixed(2)}s)</span>
+                  )}
+                </div>
+
+                {!isSearching && searchStats.total > 0 && (
+                  <div className="flex items-center space-x-4 text-sm text-gray-600">
+                    <div className="flex items-center space-x-1">
+                      <FileText className="h-4 w-4" />
+                      <span>{searchStats.documents} documents</span>
+                    </div>
+                    <div className="flex items-center space-x-1">
+                      <Folder className="h-4 w-4" />
+                      <span>{searchStats.folders} dossiers</span>
+                    </div>
+                  </div>
+                )}
+              </div>
+
+              {!isSearching && searchResults.length > 0 && (
+                <div className="flex items-center space-x-3">
+                  <div className="flex items-center space-x-2">
+                    <Label htmlFor="sort" className="text-sm">
+                      Trier par:
+                    </Label>
+                    <Select value={sortBy} onValueChange={setSortBy}>
+                      <SelectTrigger className="w-32">
+                        <SelectValue />
+                      </SelectTrigger>
+                      <SelectContent>
+                        <SelectItem value="relevance">Pertinence</SelectItem>
+                        <SelectItem value="date">Date</SelectItem>
+                        <SelectItem value="name">Nom</SelectItem>
+                        <SelectItem value="author">Auteur</SelectItem>
+                      </SelectContent>
+                    </Select>
+                    <Button
+                      variant="ghost"
+                      size="sm"
+                      onClick={() => setSortOrder(sortOrder === "asc" ? "desc" : "asc")}
+                    >
+                      {sortOrder === "asc" ? <SortAsc className="h-4 w-4" /> : <SortDesc className="h-4 w-4" />}
+                    </Button>
+                  </div>
+                </div>
+              )}
+            </div>
+          </CardContent>
+        </Card>
+      )}
+
+      {/* Bulk Actions */}
+      {selectedResults.length > 0 && (
+        <Card className="bg-blue-50 border-blue-200">
+          <CardContent className="p-4">
+            <div className="flex items-center justify-between">
+              <div className="flex items-center space-x-3">
+                <span className="text-sm font-medium">
+                  {selectedResults.length} résultat{selectedResults.length > 1 ? "s" : ""} sélectionné
+                  {selectedResults.length > 1 ? "s" : ""}
+                </span>
+              </div>
+              <div className="flex items-center space-x-2">
+                <Button variant="outline" size="sm">
+                  <Download className="h-4 w-4 mr-2" />
+                  Télécharger
+                </Button>
+                <Button variant="outline" size="sm">
+                  <Share2 className="h-4 w-4 mr-2" />
+                  Partager
+                </Button>
+              </div>
+            </div>
+          </CardContent>
+        </Card>
+      )}
+
+      {/* Search Results */}
+      {searchResults.length > 0 && (
+        <Card>
+          <CardContent className="p-0">
+            <div className="divide-y">
+              {searchResults.map((result) => (
+                <div key={result.id} className="p-6 hover:bg-gray-50">
+                  <div className="flex items-start space-x-4">
+                    <Checkbox
+                      checked={selectedResults.includes(result.id)}
+                      onCheckedChange={() => toggleResultSelection(result.id)}
+                    />
+
+                    <div className="flex-shrink-0">
+                      {result.type === "document" ? (
+                        <div className="w-12 h-12 flex items-center justify-center bg-gray-100 rounded-lg">
+                          {getFileIcon(result.fileType)}
+                        </div>
+                      ) : (
+                        <div className="w-12 h-12 flex items-center justify-center bg-blue-100 rounded-lg">
+                          <Folder className="h-6 w-6 text-blue-600" />
+                        </div>
+                      )}
+                    </div>
+
+                    <div className="flex-1 min-w-0">
+                      <div className="flex items-start justify-between">
+                        <div className="flex-1">
+                          <h3 className="text-lg font-medium text-gray-900 hover:text-blue-600 cursor-pointer">
+                            {result.name}
+                          </h3>
+                          <div className="flex items-center space-x-2 mt-1 text-sm text-gray-500">
+                            <span>{result.path}</span>
+                            {result.type === "document" && (
+                              <>
+                                <span>•</span>
+                                <span>{result.size}</span>
+                              </>
+                            )}
+                            {result.type === "folder" && (
+                              <>
+                                <span>•</span>
+                                <span>{result.documentsCount} documents</span>
+                              </>
+                            )}
+                            <span>•</span>
+                            <span>{formatDate(result.modified)}</span>
+                            <span>•</span>
+                            <span>{result.author}</span>
+                          </div>
+                        </div>
+
+                        <div className="flex items-center space-x-2">
+                          <Badge variant="outline" className="bg-green-50 text-green-700 border-green-200">
+                            {result.relevance}% pertinent
+                          </Badge>
+                          <div className="flex items-center space-x-1">
+                            <Button variant="ghost" size="sm">
+                              <Eye className="h-4 w-4" />
+                            </Button>
+                            <Button variant="ghost" size="sm">
+                              <Download className="h-4 w-4" />
+                            </Button>
+                            <Button variant="ghost" size="sm">
+                              <Share2 className="h-4 w-4" />
+                            </Button>
+                            <Button variant="ghost" size="sm">
+                              <MoreHorizontal className="h-4 w-4" />
+                            </Button>
+                          </div>
+                        </div>
+                      </div>
+
+                      <p
+                        className="mt-2 text-sm text-gray-600 line-clamp-2"
+                        dangerouslySetInnerHTML={{
+                          __html: highlightText(result.content, result.highlights),
+                        }}
+                      />
+
+                      {result.tags && result.tags.length > 0 && (
+                        <div className="flex items-center space-x-2 mt-3">
+                          <Tag className="h-4 w-4 text-gray-400" />
+                          <div className="flex flex-wrap gap-1">
+                            {result.tags.map((tag: string, index: number) => (
+                              <Badge key={index} variant="outline" className="text-xs">
+                                {tag}
+                              </Badge>
+                            ))}
+                          </div>
+                        </div>
+                      )}
+
+                      {result.highlights && result.highlights.length > 0 && (
+                        <div className="mt-3 text-xs text-gray-500">
+                          <span className="font-medium">Mots-clés trouvés:</span> {result.highlights.join(", ")}
+                        </div>
+                      )}
+                    </div>
+                  </div>
+                </div>
+              ))}
+            </div>
+          </CardContent>
+        </Card>
+      )}
+
+      {/* No Results */}
+      {searchQuery && !isSearching && searchResults.length === 0 && (
+        <Card>
+          <CardContent className="text-center py-12">
+            <Search className="h-12 w-12 mx-auto text-gray-400 mb-4" />
+            <h3 className="text-lg font-medium text-gray-900 mb-2">Aucun résultat trouvé</h3>
+            <p className="text-gray-600 mb-4">
+              Aucun document ou dossier ne correspond à votre recherche "{searchQuery}"
+            </p>
+            <div className="space-y-2 text-sm text-gray-500">
+              <p>Suggestions:</p>
+              <ul className="list-disc list-inside space-y-1">
+                <li>Vérifiez l'orthographe de vos mots-clés</li>
+                <li>Essayez des termes plus généraux</li>
+                <li>Utilisez la recherche avancée pour affiner vos critères</li>
+                <li>Recherchez dans le contenu des documents avec l'OCR</li>
+              </ul>
+            </div>
+          </CardContent>
+        </Card>
+      )}
+
+      {/* Empty State */}
+      {!searchQuery && (
+        <Card>
+          <CardContent className="text-center py-12">
+            <Search className="h-12 w-12 mx-auto text-gray-400 mb-4" />
+            <h3 className="text-lg font-medium text-gray-900 mb-2">Recherche intelligente</h3>
+            <p className="text-gray-600 mb-6">
+              Trouvez rapidement vos documents et dossiers grâce à notre moteur de recherche avancé
+            </p>
+            <div className="grid grid-cols-1 md:grid-cols-2 gap-4 max-w-2xl mx-auto text-left">
+              <div className="p-4 bg-blue-50 rounded-lg">
+                <div className="flex items-center space-x-2 mb-2">
+                  <Zap className="h-5 w-5 text-blue-600" />
+                  <h4 className="font-medium text-blue-900">Recherche rapide</h4>
+                </div>
+                <p className="text-sm text-blue-700">Recherchez par nom de fichier, contenu, auteur ou tags</p>
+              </div>
+              <div className="p-4 bg-green-50 rounded-lg">
+                <div className="flex items-center space-x-2 mb-2">
+                  <Target className="h-5 w-5 text-green-600" />
+                  <h4 className="font-medium text-green-900">Filtres avancés</h4>
+                </div>
+                <p className="text-sm text-green-700">Affinez votre recherche par type, date, taille et plus</p>
+              </div>
+              <div className="p-4 bg-purple-50 rounded-lg">
+                <div className="flex items-center space-x-2 mb-2">
+                  <BookOpen className="h-5 w-5 text-purple-600" />
+                  <h4 className="font-medium text-purple-900">Recherche OCR</h4>
+                </div>
+                <p className="text-sm text-purple-700">Recherchez dans le contenu des images et documents scannés</p>
+              </div>
+              <div className="p-4 bg-orange-50 rounded-lg">
+                <div className="flex items-center space-x-2 mb-2">
+                  <Clock className="h-5 w-5 text-orange-600" />
+                  <h4 className="font-medium text-orange-900">Historique</h4>
+                </div>
+                <p className="text-sm text-orange-700">Accédez à vos recherches récentes et sauvegardées</p>
+              </div>
+            </div>
+          </CardContent>
+        </Card>
+      )}
+    </div>
+  )
+}

app/dashboard/settings/loading.tsx

@@ -0,0 +1,69 @@
+import { Card, CardContent, CardHeader } from "@/components/ui/card"
+import { Skeleton } from "@/components/ui/skeleton"
+
+export default function SettingsLoading() {
+  return (
+    <div className="space-y-6">
+      {/* Header */}
+      <div className="flex flex-col sm:flex-row sm:items-center sm:justify-between">
+        <div>
+          <Skeleton className="h-8 w-32 mb-2" />
+          <Skeleton className="h-4 w-64" />
+        </div>
+        <Skeleton className="h-10 w-24" />
+      </div>
+
+      <div className="flex flex-col lg:flex-row gap-6">
+        {/* Sidebar */}
+        <div className="lg:w-64">
+          <Card>
+            <CardContent className="p-0">
+              <nav className="space-y-1">
+                {[...Array(7)].map((_, i) => (
+                  <div key={i} className="flex items-center px-4 py-3">
+                    <Skeleton className="h-5 w-5 mr-3" />
+                    <Skeleton className="h-4 w-24" />
+                  </div>
+                ))}
+              </nav>
+            </CardContent>
+          </Card>
+        </div>
+
+        {/* Main Content */}
+        <div className="flex-1">
+          <Card>
+            <CardHeader>
+              <Skeleton className="h-6 w-48" />
+            </CardHeader>
+            <CardContent className="space-y-6">
+              {/* Profile Section */}
+              <div className="flex items-center space-x-4">
+                <Skeleton className="h-20 w-20 rounded-full" />
+                <div>
+                  <Skeleton className="h-8 w-32 mb-2" />
+                  <Skeleton className="h-4 w-48" />
+                </div>
+              </div>
+
+              {/* Form Fields */}
+              <div className="grid grid-cols-1 md:grid-cols-2 gap-4">
+                {[...Array(6)].map((_, i) => (
+                  <div key={i} className="space-y-2">
+                    <Skeleton className="h-4 w-20" />
+                    <Skeleton className="h-10 w-full" />
+                  </div>
+                ))}
+              </div>
+
+              <div className="space-y-2">
+                <Skeleton className="h-4 w-24" />
+                <Skeleton className="h-20 w-full" />
+              </div>
+            </CardContent>
+          </Card>
+        </div>
+      </div>
+    </div>
+  )
+}

app/dashboard/users/loading.tsx

@@ -0,0 +1,76 @@
+import { Card, CardContent, CardHeader } from "@/components/ui/card"
+import { Skeleton } from "@/components/ui/skeleton"
+
+export default function UsersLoading() {
+  return (
+    <div className="space-y-6">
+      {/* Header */}
+      <div className="flex flex-col sm:flex-row sm:items-center sm:justify-between">
+        <div>
+          <Skeleton className="h-8 w-48 mb-2" />
+          <Skeleton className="h-4 w-64" />
+        </div>
+        <Skeleton className="h-10 w-48 mt-4 sm:mt-0" />
+      </div>
+
+      {/* Stats */}
+      <div className="grid grid-cols-1 md:grid-cols-4 gap-4">
+        {[...Array(4)].map((_, i) => (
+          <Card key={i}>
+            <CardContent className="p-6">
+              <div className="flex items-center">
+                <Skeleton className="h-8 w-8" />
+                <div className="ml-4">
+                  <Skeleton className="h-4 w-16 mb-2" />
+                  <Skeleton className="h-8 w-12" />
+                </div>
+              </div>
+            </CardContent>
+          </Card>
+        ))}
+      </div>
+
+      {/* Filters */}
+      <Card>
+        <CardContent className="p-6">
+          <div className="flex flex-col sm:flex-row gap-4">
+            <Skeleton className="h-10 flex-1" />
+            <Skeleton className="h-10 w-48" />
+            <Skeleton className="h-10 w-48" />
+          </div>
+        </CardContent>
+      </Card>
+
+      {/* Table */}
+      <Card>
+        <CardHeader>
+          <Skeleton className="h-6 w-48" />
+        </CardHeader>
+        <CardContent>
+          <div className="space-y-4">
+            {[...Array(5)].map((_, i) => (
+              <div key={i} className="flex items-center space-x-4 p-4">
+                <Skeleton className="h-4 w-4" />
+                <Skeleton className="h-10 w-10 rounded-full" />
+                <div className="flex-1">
+                  <Skeleton className="h-4 w-32 mb-2" />
+                  <Skeleton className="h-3 w-48" />
+                </div>
+                <Skeleton className="h-6 w-20" />
+                <Skeleton className="h-6 w-16" />
+                <Skeleton className="h-4 w-24" />
+                <Skeleton className="h-4 w-16" />
+                <Skeleton className="h-4 w-20" />
+                <div className="flex space-x-2">
+                  <Skeleton className="h-8 w-8" />
+                  <Skeleton className="h-8 w-8" />
+                  <Skeleton className="h-8 w-8" />
+                </div>
+              </div>
+            ))}
+          </div>
+        </CardContent>
+      </Card>
+    </div>
+  )
+}

app/formation/devis/page.tsx

@@ -0,0 +1,585 @@
+'use client'
+
+import { useState } from 'react'
+import Link from "next/link"
+import { Button } from "@/components/ui/button"
+import { Card, CardContent, CardDescription, CardHeader, CardTitle } from "@/components/ui/card"
+import { Input } from "@/components/ui/input"
+import { Label } from "@/components/ui/label"
+import { Badge } from "@/components/ui/badge"
+import { Textarea } from "@/components/ui/textarea"
+import { Checkbox } from "@/components/ui/checkbox"
+import { RadioGroup, RadioGroupItem } from "@/components/ui/radio-group"
+import { Select, SelectContent, SelectItem, SelectTrigger, SelectValue } from "@/components/ui/select"
+import { Shield, ArrowLeft, Users, Calendar, MapPin, Mail, Phone, Building, User, FileText, CheckCircle, Loader2 } from 'lucide-react'
+import { submitFormationForm } from '@/app/actions/formation'
+
+export default function DevisFormationPage() {
+  const [formData, setFormData] = useState({
+    // Informations entreprise
+    entreprise: '',
+    secteur: '',
+    taille: '',
+    siret: '',
+    
+    // Contact
+    nom: '',
+    prenom: '',
+    fonction: '',
+    email: '',
+    telephone: '',
+    
+    // Formation
+    formations: [] as string[],
+    modalite: '',
+    participants: '',
+    dates: '',
+    lieu: '',
+    
+    // Besoins spécifiques
+    objectifs: '',
+    niveau: '',
+    contraintes: '',
+    
+    // Options
+    certification: false,
+    support: false,
+    accompagnement: false
+  })
+
+  const [isSubmitting, setIsSubmitting] = useState(false)
+  const [submitResult, setSubmitResult] = useState<{ success: boolean; message: string } | null>(null)
+
+  const handleFormationChange = (formation: string, checked: boolean) => {
+    if (checked) {
+      setFormData(prev => ({
+        ...prev,
+        formations: [...prev.formations, formation]
+      }))
+    } else {
+      setFormData(prev => ({
+        ...prev,
+        formations: prev.formations.filter(f => f !== formation)
+      }))
+    }
+  }
+
+  const handleSubmit = async (e: React.FormEvent) => {
+    e.preventDefault()
+    setIsSubmitting(true)
+    setSubmitResult(null)
+
+    try {
+      const formDataToSend = new FormData()
+      
+      // Ajout de tous les champs au FormData
+      Object.entries(formData).forEach(([key, value]) => {
+        if (key === 'formations') {
+          value.forEach((formation: string) => formDataToSend.append('formations', formation))
+        } else if (typeof value === 'boolean') {
+          formDataToSend.append(key, value.toString())
+        } else {
+          formDataToSend.append(key, value)
+        }
+      })
+
+      const result = await submitFormationForm(formDataToSend)
+      setSubmitResult(result)
+      
+      if (result.success) {
+        // Reset du formulaire en cas de succès
+        setFormData({
+          entreprise: '',
+          secteur: '',
+          taille: '',
+          siret: '',
+          nom: '',
+          prenom: '',
+          fonction: '',
+          email: '',
+          telephone: '',
+          formations: [],
+          modalite: '',
+          participants: '',
+          dates: '',
+          lieu: '',
+          objectifs: '',
+          niveau: '',
+          contraintes: '',
+          certification: false,
+          support: false,
+          accompagnement: false
+        })
+      }
+    } catch (error) {
+      setSubmitResult({
+        success: false,
+        message: 'Une erreur inattendue est survenue. Veuillez réessayer.'
+      })
+    } finally {
+      setIsSubmitting(false)
+    }
+  }
+
+  if (submitResult?.success) {
+    return (
+      <div className="min-h-screen bg-gradient-to-br from-slate-50 to-blue-50 flex items-center justify-center p-4">
+        <Card className="w-full max-w-2xl border-2 border-green-200 bg-green-50">
+          <CardHeader className="text-center">
+            <CheckCircle className="h-16 w-16 text-green-600 mx-auto mb-4" />
+            <CardTitle className="text-3xl text-green-700">Demande envoyée !</CardTitle>
+            <CardDescription className="text-lg">
+              {submitResult.message}
+            </CardDescription>
+          </CardHeader>
+          <CardContent className="text-center space-y-6">
+            <div className="bg-white p-6 rounded-lg border border-green-200">
+              <h3 className="font-semibold text-green-800 mb-3">Prochaines étapes :</h3>
+              <ul className="text-left space-y-2 text-gray-700">
+                <li>• Un expert 4NK vous contactera sous 24h</li>
+                <li>• Analyse personnalisée de vos besoins</li>
+                <li>• Proposition de devis détaillé</li>
+                <li>• Planification des sessions de formation</li>
+              </ul>
+            </div>
+            <div className="space-y-4">
+              <p className="text-gray-600">
+                <strong>Contact direct :</strong> contact@docv.fr
+              </p>
+              <div className="flex flex-col sm:flex-row gap-4 justify-center">
+                <Link href="/formation">
+                  <Button variant="outline">Retour aux formations</Button>
+                </Link>
+                <Link href="/">
+                  <Button>Accueil DocV</Button>
+                </Link>
+              </div>
+            </div>
+          </CardContent>
+        </Card>
+      </div>
+    )
+  }
+
+  return (
+    <div className="min-h-screen bg-gradient-to-br from-slate-50 to-blue-50">
+      {/* Header */}
+      <header className="border-b bg-white/80 backdrop-blur-sm">
+        <div className="container mx-auto px-4 py-4 flex justify-between items-center">
+          <Link href="/formation" className="flex items-center space-x-2">
+            <Shield className="h-8 w-8 text-blue-600" />
+            <span className="text-2xl font-bold text-gray-900">DocV</span>
+            <Badge variant="secondary" className="ml-2">By 4NK</Badge>
+          </Link>
+          <Link href="/formation" className="flex items-center text-blue-600 hover:text-blue-700">
+            <ArrowLeft className="h-4 w-4 mr-2" />
+            Retour aux formations
+          </Link>
+        </div>
+      </header>
+
+      <div className="container mx-auto px-4 py-8">
+        <div className="max-w-4xl mx-auto">
+          {/* Hero */}
+          <div className="text-center mb-8">
+            <h1 className="text-4xl font-bold text-gray-900 mb-4">
+              Demande de <span className="text-blue-600">Devis Formation</span>
+            </h1>
+            <p className="text-xl text-gray-600 max-w-2xl mx-auto">
+              Obtenez un devis personnalisé pour vos formations en souveraineté numérique. 
+              Nos experts vous accompagnent dans la définition de vos besoins.
+            </p>
+          </div>
+
+          {/* Message d'erreur */}
+          {submitResult && !submitResult.success && (
+            <div className="mb-6 p-4 bg-red-50 border border-red-200 rounded-lg">
+              <p className="text-red-700">{submitResult.message}</p>
+            </div>
+          )}
+
+          <form onSubmit={handleSubmit} className="space-y-8">
+            {/* Informations Entreprise */}
+            <Card>
+              <CardHeader>
+                <CardTitle className="flex items-center">
+                  <Building className="h-5 w-5 mr-2 text-blue-600" />
+                  Informations Entreprise
+                </CardTitle>
+                <CardDescription>
+                  Renseignez les informations de votre organisation
+                </CardDescription>
+              </CardHeader>
+              <CardContent className="space-y-4">
+                <div className="grid md:grid-cols-2 gap-4">
+                  <div className="space-y-2">
+                    <Label htmlFor="entreprise">Nom de l'entreprise *</Label>
+                    <Input
+                      id="entreprise"
+                      value={formData.entreprise}
+                      onChange={(e) => setFormData(prev => ({ ...prev, entreprise: e.target.value }))}
+                      placeholder="Votre entreprise"
+                      required
+                    />
+                  </div>
+                  <div className="space-y-2">
+                    <Label htmlFor="secteur">Secteur d'activité</Label>
+                    <Select onValueChange={(value) => setFormData(prev => ({ ...prev, secteur: value }))}>
+                      <SelectTrigger>
+                        <SelectValue placeholder="Sélectionnez votre secteur" />
+                      </SelectTrigger>
+                      <SelectContent>
+                        <SelectItem value="finance">Finance / Banque</SelectItem>
+                        <SelectItem value="sante">Santé</SelectItem>
+                        <SelectItem value="notariat">Notariat / Juridique</SelectItem>
+                        <SelectItem value="industrie">Industrie</SelectItem>
+                        <SelectItem value="service-public">Service Public</SelectItem>
+                        <SelectItem value="education">Éducation</SelectItem>
+                        <SelectItem value="tech">Technologies</SelectItem>
+                        <SelectItem value="autre">Autre</SelectItem>
+                      </SelectContent>
+                    </Select>
+                  </div>
+                </div>
+                <div className="grid md:grid-cols-2 gap-4">
+                  <div className="space-y-2">
+                    <Label htmlFor="taille">Taille de l'entreprise</Label>
+                    <Select onValueChange={(value) => setFormData(prev => ({ ...prev, taille: value }))}>
+                      <SelectTrigger>
+                        <SelectValue placeholder="Nombre d'employés" />
+                      </SelectTrigger>
+                      <SelectContent>
+                        <SelectItem value="1-10">1-10 employés</SelectItem>
+                        <SelectItem value="11-50">11-50 employés</SelectItem>
+                        <SelectItem value="51-200">51-200 employés</SelectItem>
+                        <SelectItem value="201-1000">201-1000 employés</SelectItem>
+                        <SelectItem value="1000+">Plus de 1000 employés</SelectItem>
+                      </SelectContent>
+                    </Select>
+                  </div>
+                  <div className="space-y-2">
+                    <Label htmlFor="siret">SIRET (optionnel)</Label>
+                    <Input
+                      id="siret"
+                      value={formData.siret}
+                      onChange={(e) => setFormData(prev => ({ ...prev, siret: e.target.value }))}
+                      placeholder="Numéro SIRET"
+                    />
+                  </div>
+                </div>
+              </CardContent>
+            </Card>
+
+            {/* Contact */}
+            <Card>
+              <CardHeader>
+                <CardTitle className="flex items-center">
+                  <User className="h-5 w-5 mr-2 text-blue-600" />
+                  Contact
+                </CardTitle>
+                <CardDescription>
+                  Vos coordonnées pour le suivi de la demande
+                </CardDescription>
+              </CardHeader>
+              <CardContent className="space-y-4">
+                <div className="grid md:grid-cols-2 gap-4">
+                  <div className="space-y-2">
+                    <Label htmlFor="nom">Nom *</Label>
+                    <Input
+                      id="nom"
+                      value={formData.nom}
+                      onChange={(e) => setFormData(prev => ({ ...prev, nom: e.target.value }))}
+                      placeholder="Votre nom"
+                      required
+                    />
+                  </div>
+                  <div className="space-y-2">
+                    <Label htmlFor="prenom">Prénom *</Label>
+                    <Input
+                      id="prenom"
+                      value={formData.prenom}
+                      onChange={(e) => setFormData(prev => ({ ...prev, prenom: e.target.value }))}
+                      placeholder="Votre prénom"
+                      required
+                    />
+                  </div>
+                </div>
+                <div className="space-y-2">
+                  <Label htmlFor="fonction">Fonction</Label>
+                  <Input
+                    id="fonction"
+                    value={formData.fonction}
+                    onChange={(e) => setFormData(prev => ({ ...prev, fonction: e.target.value }))}
+                    placeholder="Votre fonction dans l'entreprise"
+                  />
+                </div>
+                <div className="grid md:grid-cols-2 gap-4">
+                  <div className="space-y-2">
+                    <Label htmlFor="email">Email *</Label>
+                    <Input
+                      id="email"
+                      type="email"
+                      value={formData.email}
+                      onChange={(e) => setFormData(prev => ({ ...prev, email: e.target.value }))}
+                      placeholder="votre.email@entreprise.com"
+                      required
+                    />
+                  </div>
+                  <div className="space-y-2">
+                    <Label htmlFor="telephone">Téléphone</Label>
+                    <Input
+                      id="telephone"
+                      type="tel"
+                      value={formData.telephone}
+                      onChange={(e) => setFormData(prev => ({ ...prev, telephone: e.target.value }))}
+                      placeholder="01 23 45 67 89"
+                    />
+                  </div>
+                </div>
+              </CardContent>
+            </Card>
+
+            {/* Formations souhaitées */}
+            <Card>
+              <CardHeader>
+                <CardTitle className="flex items-center">
+                  <FileText className="h-5 w-5 mr-2 text-blue-600" />
+                  Formations souhaitées
+                </CardTitle>
+                <CardDescription>
+                  Sélectionnez les formations qui vous intéressent
+                </CardDescription>
+              </CardHeader>
+              <CardContent className="space-y-4">
+                <div className="space-y-3">
+                  <div className="flex items-center space-x-2">
+                    <Checkbox
+                      id="cybersecurite"
+                      checked={formData.formations.includes('cybersecurite')}
+                      onCheckedChange={(checked) => handleFormationChange('cybersecurite', checked as boolean)}
+                    />
+                    <Label htmlFor="cybersecurite" className="flex-1">
+                      <div className="font-medium">Cybersécurité (5 jours)</div>
+                      <div className="text-sm text-gray-600">Fondamentaux de la sécurité informatique et spécialisation DocV</div>
+                    </Label>
+                  </div>
+                  <div className="flex items-center space-x-2">
+                    <Checkbox
+                      id="hygiene"
+                      checked={formData.formations.includes('hygiene')}
+                      onCheckedChange={(checked) => handleFormationChange('hygiene', checked as boolean)}
+                    />
+                    <Label htmlFor="hygiene" className="flex-1">
+                      <div className="font-medium">Hygiène Numérique (3 jours)</div>
+                      <div className="text-sm text-gray-600">Bonnes pratiques pour un environnement numérique sain</div>
+                    </Label>
+                  </div>
+                  <div className="flex items-center space-x-2">
+                    <Checkbox
+                      id="developpement"
+                      checked={formData.formations.includes('developpement')}
+                      onCheckedChange={(checked) => handleFormationChange('developpement', checked as boolean)}
+                    />
+                    <Label htmlFor="developpement" className="flex-1">
+                      <div className="font-medium">Développement Souverain (7 jours)</div>
+                      <div className="text-sm text-gray-600">Applications indépendantes et sécurisées</div>
+                    </Label>
+                  </div>
+                  <div className="flex items-center space-x-2">
+                    <Checkbox
+                      id="parcours-complet"
+                      checked={formData.formations.includes('parcours-complet')}
+                      onCheckedChange={(checked) => handleFormationChange('parcours-complet', checked as boolean)}
+                    />
+                    <Label htmlFor="parcours-complet" className="flex-1">
+                      <div className="font-medium">Parcours Complet (15 jours)</div>
+                      <div className="text-sm text-gray-600">Formation intégrée avec certification 4NK</div>
+                    </Label>
+                  </div>
+                </div>
+              </CardContent>
+            </Card>
+
+            {/* Modalités */}
+            <Card>
+              <CardHeader>
+                <CardTitle className="flex items-center">
+                  <Calendar className="h-5 w-5 mr-2 text-blue-600" />
+                  Modalités de formation
+                </CardTitle>
+              </CardHeader>
+              <CardContent className="space-y-4">
+                <div className="space-y-3">
+                  <Label>Mode de formation préféré</Label>
+                  <RadioGroup
+                    value={formData.modalite}
+                    onValueChange={(value) => setFormData(prev => ({ ...prev, modalite: value }))}
+                  >
+                    <div className="flex items-center space-x-2">
+                      <RadioGroupItem value="presentiel" id="presentiel" />
+                      <Label htmlFor="presentiel">Présentiel</Label>
+                    </div>
+                    <div className="flex items-center space-x-2">
+                      <RadioGroupItem value="distanciel" id="distanciel" />
+                      <Label htmlFor="distanciel">Distanciel</Label>
+                    </div>
+                    <div className="flex items-center space-x-2">
+                      <RadioGroupItem value="hybride" id="hybride" />
+                      <Label htmlFor="hybride">Hybride</Label>
+                    </div>
+                  </RadioGroup>
+                </div>
+
+                <div className="grid md:grid-cols-2 gap-4">
+                  <div className="space-y-2">
+                    <Label htmlFor="participants">Nombre de participants</Label>
+                    <Select onValueChange={(value) => setFormData(prev => ({ ...prev, participants: value }))}>
+                      <SelectTrigger>
+                        <SelectValue placeholder="Nombre de participants" />
+                      </SelectTrigger>
+                      <SelectContent>
+                        <SelectItem value="1-5">1-5 participants</SelectItem>
+                        <SelectItem value="6-10">6-10 participants</SelectItem>
+                        <SelectItem value="11-15">11-15 participants</SelectItem>
+                        <SelectItem value="16-20">16-20 participants</SelectItem>
+                        <SelectItem value="20+">Plus de 20 participants</SelectItem>
+                      </SelectContent>
+                    </Select>
+                  </div>
+                  <div className="space-y-2">
+                    <Label htmlFor="dates">Période souhaitée</Label>
+                    <Input
+                      id="dates"
+                      value={formData.dates}
+                      onChange={(e) => setFormData(prev => ({ ...prev, dates: e.target.value }))}
+                      placeholder="Ex: Mars 2024, Trimestre 2..."
+                    />
+                  </div>
+                </div>
+
+                <div className="space-y-2">
+                  <Label htmlFor="lieu">Lieu (si présentiel)</Label>
+                  <Input
+                    id="lieu"
+                    value={formData.lieu}
+                    onChange={(e) => setFormData(prev => ({ ...prev, lieu: e.target.value }))}
+                    placeholder="Ville ou adresse"
+                  />
+                </div>
+              </CardContent>
+            </Card>
+
+            {/* Besoins spécifiques */}
+            <Card>
+              <CardHeader>
+                <CardTitle>Besoins spécifiques</CardTitle>
+              </CardHeader>
+              <CardContent className="space-y-4">
+                <div className="space-y-2">
+                  <Label htmlFor="objectifs">Objectifs de formation</Label>
+                  <Textarea
+                    id="objectifs"
+                    value={formData.objectifs}
+                    onChange={(e) => setFormData(prev => ({ ...prev, objectifs: e.target.value }))}
+                    placeholder="Décrivez vos objectifs et attentes..."
+                    rows={3}
+                  />
+                </div>
+
+                <div className="space-y-2">
+                  <Label htmlFor="niveau">Niveau des participants</Label>
+                  <Select onValueChange={(value) => setFormData(prev => ({ ...prev, niveau: value }))}>
+                    <SelectTrigger>
+                      <SelectValue placeholder="Niveau technique" />
+                    </SelectTrigger>
+                    <SelectContent>
+                      <SelectItem value="debutant">Débutant</SelectItem>
+                      <SelectItem value="intermediaire">Intermédiaire</SelectItem>
+                      <SelectItem value="avance">Avancé</SelectItem>
+                      <SelectItem value="mixte">Mixte</SelectItem>
+                    </SelectContent>
+                  </Select>
+                </div>
+
+                <div className="space-y-2">
+                  <Label htmlFor="contraintes">Contraintes particulières</Label>
+                  <Textarea
+                    id="contraintes"
+                    value={formData.contraintes}
+                    onChange={(e) => setFormData(prev => ({ ...prev, contraintes: e.target.value }))}
+                    placeholder="Contraintes horaires, techniques, organisationnelles..."
+                    rows={2}
+                  />
+                </div>
+              </CardContent>
+            </Card>
+
+            {/* Options */}
+            <Card>
+              <CardHeader>
+                <CardTitle>Options supplémentaires</CardTitle>
+              </CardHeader>
+              <CardContent className="space-y-3">
+                <div className="flex items-center space-x-2">
+                  <Checkbox
+                    id="certification"
+                    checked={formData.certification}
+                    onCheckedChange={(checked) => setFormData(prev => ({ ...prev, certification: checked as boolean }))}
+                  />
+                  <Label htmlFor="certification">
+                    Certification RNCP "Développeur Blockchain" (niveau 6)
+                  </Label>
+                </div>
+                <div className="flex items-center space-x-2">
+                  <Checkbox
+                    id="support"
+                    checked={formData.support}
+                    onCheckedChange={(checked) => setFormData(prev => ({ ...prev, support: checked as boolean }))}
+                  />
+                  <Label htmlFor="support">
+                    Support technique 6 mois post-formation
+                  </Label>
+                </div>
+                <div className="flex items-center space-x-2">
+                  <Checkbox
+                    id="accompagnement"
+                    checked={formData.accompagnement}
+                    onCheckedChange={(checked) => setFormData(prev => ({ ...prev, accompagnement: checked as boolean }))}
+                  />
+                  <Label htmlFor="accompagnement">
+                    Accompagnement personnalisé sur projet
+                  </Label>
+                </div>
+              </CardContent>
+            </Card>
+
+            {/* Submit */}
+            <div className="text-center">
+              <Button 
+                type="submit" 
+                size="lg" 
+                className="text-lg px-12 py-3"
+                disabled={isSubmitting}
+              >
+                {isSubmitting ? (
+                  <>
+                    <Loader2 className="h-5 w-5 mr-2 animate-spin" />
+                    Envoi en cours...
+                  </>
+                ) : (
+                  <>
+                    <Mail className="h-5 w-5 mr-2" />
+                    Envoyer la demande de devis
+                  </>
+                )}
+              </Button>
+              <p className="text-sm text-gray-600 mt-4">
+                Réponse sous 24h • Devis gratuit et sans engagement
+              </p>
+            </div>
+          </form>
+        </div>
+      </div>
+    </div>
+  )
+}

app/formation/page.tsx

@@ -0,0 +1,335 @@
+import Link from "next/link"
+import { Button } from "@/components/ui/button"
+import { Card, CardContent, CardDescription, CardHeader, CardTitle } from "@/components/ui/card"
+import { Badge } from "@/components/ui/badge"
+import { Shield, Monitor, Code, ArrowLeft, Clock, Users, Award, BookOpen } from 'lucide-react'
+
+export default function FormationPage() {
+  return (
+    <div className="min-h-screen bg-gradient-to-br from-slate-50 to-blue-50">
+      {/* Header */}
+      <header className="border-b bg-white/80 backdrop-blur-sm">
+        <div className="container mx-auto px-4 py-4 flex justify-between items-center">
+          <Link href="/" className="flex items-center space-x-2">
+            <Shield className="h-8 w-8 text-blue-600" />
+            <span className="text-2xl font-bold text-gray-900">DocV</span>
+            <Badge variant="secondary" className="ml-2">By 4NK</Badge>
+          </Link>
+          <Link href="/" className="flex items-center text-blue-600 hover:text-blue-700">
+            <ArrowLeft className="h-4 w-4 mr-2" />
+            Retour à l'accueil
+          </Link>
+        </div>
+      </header>
+
+      {/* Hero Section */}
+      <section className="py-16 px-4">
+        <div className="container mx-auto text-center">
+          <h1 className="text-5xl font-bold text-gray-900 mb-6">
+            Formations <span className="text-blue-600">Souveraineté Numérique</span>
+          </h1>
+          <p className="text-xl text-gray-600 mb-8 max-w-3xl mx-auto">
+            Développez vos compétences en cybersécurité, hygiène numérique et développement d'applications souveraines 
+            avec nos formations expertes dispensées par 4NK.
+          </p>
+          <div className="flex flex-wrap justify-center gap-4 mb-6">
+            <Badge variant="outline" className="text-lg px-4 py-2 bg-green-50 border-green-200 text-green-700">
+              <Award className="h-4 w-4 mr-2" />
+              Centre de formation agréé
+            </Badge>
+            <Badge variant="outline" className="text-lg px-4 py-2 bg-blue-50 border-blue-200 text-blue-700">
+              <Award className="h-4 w-4 mr-2" />
+              Titre RNCP Niveau 6 "Développeur Blockchain"
+            </Badge>
+            <Badge variant="outline" className="text-lg px-4 py-2 bg-purple-50 border-purple-200 text-purple-700">
+              <Award className="h-4 w-4 mr-2" />
+              Seul établissement en France
+            </Badge>
+          </div>
+          <div className="flex flex-wrap justify-center gap-4">
+            <Badge variant="outline" className="text-lg px-4 py-2">
+              <BookOpen className="h-4 w-4 mr-2" />
+              Formations certifiantes
+            </Badge>
+            <Badge variant="outline" className="text-lg px-4 py-2">
+              <Users className="h-4 w-4 mr-2" />
+              Formateurs experts
+            </Badge>
+            <Badge variant="outline" className="text-lg px-4 py-2">
+              <BookOpen className="h-4 w-4 mr-2" />
+              Pratique intensive
+            </Badge>
+          </div>
+        </div>
+      </section>
+
+      {/* Formations */}
+      <section className="py-16 px-4">
+        <div className="container mx-auto">
+          <div className="grid lg:grid-cols-3 gap-8">
+            
+            {/* Cybersécurité */}
+            <Card className="border-2 hover:border-red-200 transition-all duration-300 hover:shadow-xl">
+              <CardHeader className="text-center">
+                <Shield className="h-16 w-16 text-red-600 mx-auto mb-4" />
+                <CardTitle className="text-2xl text-red-700">Cybersécurité</CardTitle>
+                <CardDescription className="text-lg">
+                  Maîtrisez les fondamentaux de la sécurité informatique
+                </CardDescription>
+              </CardHeader>
+              <CardContent className="space-y-6">
+                <div>
+                  <h4 className="font-semibold mb-3">Programme de formation :</h4>
+                  <ul className="space-y-2 text-gray-600">
+                    <li>• Analyse des menaces et vulnérabilités</li>
+                    <li>• Cryptographie appliquée et PKI</li>
+                    <li>• Sécurisation des infrastructures</li>
+                    <li>• Gestion des incidents de sécurité</li>
+                    <li>• Audit et conformité (ISO 27001, RGPD)</li>
+                    <li>• Tests d'intrusion et pentest</li>
+                  </ul>
+                </div>
+                
+                <div className="bg-red-50 p-4 rounded-lg">
+                  <h5 className="font-semibold text-red-800 mb-2">Spécialisation DocV :</h5>
+                  <ul className="text-sm text-red-700 space-y-1">
+                    <li>• Authentification sans mot de passe</li>
+                    <li>• Chiffrement de bout en bout</li>
+                    <li>• Blockchain et preuves cryptographiques</li>
+                    <li>• Architecture zero-trust</li>
+                  </ul>
+                </div>
+
+                <div className="flex items-center justify-between text-sm text-gray-500">
+                  <div className="flex items-center">
+                    <Clock className="h-4 w-4 mr-1" />
+                    5 jours
+                  </div>
+                  <div className="flex items-center">
+                    <Users className="h-4 w-4 mr-1" />
+                    Max 12 pers.
+                  </div>
+                </div>
+
+                <Link href="/formation/devis">
+                  <Button className="w-full bg-red-600 hover:bg-red-700">
+                    S'inscrire à la formation
+                  </Button>
+                </Link>
+              </CardContent>
+            </Card>
+
+            {/* Hygiène Numérique */}
+            <Card className="border-2 hover:border-green-200 transition-all duration-300 hover:shadow-xl">
+              <CardHeader className="text-center">
+                <Monitor className="h-16 w-16 text-green-600 mx-auto mb-4" />
+                <CardTitle className="text-2xl text-green-700">Hygiène Numérique</CardTitle>
+                <CardDescription className="text-lg">
+                  Adoptez les bonnes pratiques pour un environnement numérique sain
+                </CardDescription>
+              </CardHeader>
+              <CardContent className="space-y-6">
+                <div>
+                  <h4 className="font-semibold mb-3">Programme de formation :</h4>
+                  <ul className="space-y-2 text-gray-600">
+                    <li>• Gestion sécurisée des mots de passe</li>
+                    <li>• Protection de la vie privée en ligne</li>
+                    <li>• Sécurisation des communications</li>
+                    <li>• Sauvegarde et archivage sécurisé</li>
+                    <li>• Sensibilisation aux risques numériques</li>
+                    <li>• RGPD et protection des données</li>
+                  </ul>
+                </div>
+                
+                <div className="bg-green-50 p-4 rounded-lg">
+                  <h5 className="font-semibold text-green-800 mb-2">Approche DocV :</h5>
+                  <ul className="text-sm text-green-700 space-y-1">
+                    <li>• Identité numérique souveraine</li>
+                    <li>• Gestion documentaire sécurisée</li>
+                    <li>• Réduction de l'empreinte numérique</li>
+                    <li>• Autonomie technologique</li>
+                  </ul>
+                </div>
+
+                <div className="flex items-center justify-between text-sm text-gray-500">
+                  <div className="flex items-center">
+                    <Clock className="h-4 w-4 mr-1" />
+                    3 jours
+                  </div>
+                  <div className="flex items-center">
+                    <Users className="h-4 w-4 mr-1" />
+                    Max 15 pers.
+                  </div>
+                </div>
+
+                <Link href="/formation/devis">
+                  <Button className="w-full bg-green-600 hover:bg-green-700">
+                    S'inscrire à la formation
+                  </Button>
+                </Link>
+              </CardContent>
+            </Card>
+
+            {/* Développement d'Applications Souveraines */}
+            <Card className="border-2 hover:border-blue-200 transition-all duration-300 hover:shadow-xl">
+              <CardHeader className="text-center">
+                <Code className="h-16 w-16 text-blue-600 mx-auto mb-4" />
+                <CardTitle className="text-2xl text-blue-700">Développement Souverain</CardTitle>
+                <CardDescription className="text-lg">
+                  Créez des applications indépendantes et sécurisées
+                </CardDescription>
+              </CardHeader>
+              <CardContent className="space-y-6">
+                <div>
+                  <h4 className="font-semibold mb-3">Programme de formation :</h4>
+                  <ul className="space-y-2 text-gray-600">
+                    <li>• Architecture décentralisée</li>
+                    <li>• Développement sans dépendances cloud</li>
+                    <li>• Intégration blockchain et cryptographie</li>
+                    <li>• APIs souveraines et sécurisées</li>
+                    <li>• Déploiement on-premise</li>
+                    <li>• Maintenance et évolutivité</li>
+                  </ul>
+                </div>
+                
+                <div className="bg-blue-50 p-4 rounded-lg">
+                  <h5 className="font-semibold text-blue-800 mb-2">Technologies DocV :</h5>
+                  <ul className="text-sm text-blue-700 space-y-1">
+                    <li>• Stack technologique souveraine</li>
+                    <li>• Intégration IA locale</li>
+                    <li>• Gestion d'identité décentralisée</li>
+                    <li>• Protocoles de communication sécurisés</li>
+                  </ul>
+                </div>
+
+                <div className="flex items-center justify-between text-sm text-gray-500">
+                  <div className="flex items-center">
+                    <Clock className="h-4 w-4 mr-1" />
+                    7 jours
+                  </div>
+                  <div className="flex items-center">
+                    <Users className="h-4 w-4 mr-1" />
+                    Max 8 pers.
+                  </div>
+                </div>
+
+                <Link href="/formation/devis">
+                  <Button className="w-full bg-blue-600 hover:bg-blue-700">
+                    S'inscrire à la formation
+                  </Button>
+                </Link>
+              </CardContent>
+            </Card>
+          </div>
+        </div>
+      </section>
+
+      {/* Formation Package */}
+      <section className="py-16 px-4 bg-white">
+        <div className="container mx-auto">
+          <div className="max-w-4xl mx-auto text-center">
+            <h2 className="text-4xl font-bold mb-8 text-gray-900">Parcours Complet de Souveraineté Numérique</h2>
+            
+            <Card className="border-2 border-blue-200 bg-gradient-to-r from-blue-50 to-indigo-50">
+              <CardHeader>
+                <CardTitle className="text-3xl text-blue-700">Formation Intégrée 4NK</CardTitle>
+                <CardDescription className="text-xl">
+                  Maîtrisez l'écosystème complet de la souveraineté numérique
+                </CardDescription>
+              </CardHeader>
+              <CardContent className="space-y-6">
+                <div className="grid md:grid-cols-3 gap-6">
+                  <div className="text-center">
+                    <Shield className="h-12 w-12 text-red-600 mx-auto mb-2" />
+                    <h4 className="font-semibold">Cybersécurité</h4>
+                    <p className="text-sm text-gray-600">Fondamentaux sécuritaires</p>
+                  </div>
+                  <div className="text-center">
+                    <Monitor className="h-12 w-12 text-green-600 mx-auto mb-2" />
+                    <h4 className="font-semibold">Hygiène Numérique</h4>
+                    <p className="text-sm text-gray-600">Bonnes pratiques</p>
+                  </div>
+                  <div className="text-center">
+                    <Code className="h-12 w-12 text-blue-600 mx-auto mb-2" />
+                    <h4 className="font-semibold">Développement</h4>
+                    <p className="text-sm text-gray-600">Applications souveraines</p>
+                  </div>
+                </div>
+
+                <div className="bg-gradient-to-r from-green-50 to-blue-50 p-6 rounded-lg border border-green-200">
+                  <div className="text-center mb-4">
+                    <h4 className="font-semibold text-lg mb-2">🏆 4NK - Centre de formation agréé</h4>
+                    <p className="text-gray-700 mb-3">
+                      Seul établissement en France à disposer du titre RNCP de niveau 6 : 
+                      <span className="font-semibold text-blue-700"> "Développeur Blockchain"</span>
+                    </p>
+                    <div className="flex justify-center gap-2">
+                      <Badge className="bg-green-600 text-white">Agréé centre de formation</Badge>
+                      <Badge className="bg-blue-600 text-white">RNCP Niveau 6</Badge>
+                    </div>
+                  </div>
+                </div>
+
+                <div className="flex flex-col sm:flex-row gap-4 justify-center">
+                  <Link href="/formation/devis">
+                    <Button size="lg" className="text-lg px-8">
+                      Parcours Complet (15 jours)
+                    </Button>
+                  </Link>
+                  <Link href="/formation/devis">
+                    <Button variant="outline" size="lg" className="text-lg px-8">
+                      Demander un devis
+                    </Button>
+                  </Link>
+                </div>
+              </CardContent>
+            </Card>
+          </div>
+        </div>
+      </section>
+
+      {/* Contact */}
+      <section className="py-16 px-4 bg-gray-50">
+        <div className="container mx-auto text-center">
+          <h2 className="text-3xl font-bold mb-8 text-gray-900">Besoin d'informations ?</h2>
+          <p className="text-xl text-gray-600 mb-8 max-w-2xl mx-auto">
+            Nos experts sont à votre disposition pour vous conseiller sur le parcours de formation 
+            le plus adapté à vos besoins.
+          </p>
+          <div className="space-y-4">
+            <p className="text-lg">
+              <strong>Contact formations :</strong>{" "}
+              <a href="mailto:contact@docv.fr" className="text-blue-600 hover:text-blue-700">
+                contact@docv.fr
+              </a>
+            </p>
+            <p className="text-gray-600">
+              Formations disponibles en présentiel, distanciel ou format hybride
+            </p>
+            <div className="pt-4">
+              <Link href="/formation/devis">
+                <Button size="lg" className="text-lg px-8">
+                  Demander un devis personnalisé
+                </Button>
+              </Link>
+            </div>
+          </div>
+        </div>
+      </section>
+
+      {/* Footer */}
+      <footer className="bg-gray-900 text-white py-8 px-4">
+        <div className="container mx-auto text-center">
+          <div className="flex items-center justify-center space-x-2 mb-4">
+            <Shield className="h-6 w-6 text-blue-400" />
+            <span className="text-xl font-bold">DocV</span>
+            <Badge variant="secondary">By 4NK</Badge>
+          </div>
+          <p className="text-gray-400">
+            4NK, pionnier du Web 5.0 - Solutions de souveraineté numérique
+          </p>
+        </div>
+      </footer>
+    </div>
+  )
+}

app/globals.css

@@ -0,0 +1,123 @@
+@import 'tailwindcss';
+@import 'tw-animate-css';
+
+@custom-variant dark (&:is(.dark *));
+
+:root {
+  --background: oklch(1 0 0);
+  --foreground: oklch(0.145 0 0);
+  --card: oklch(1 0 0);
+  --card-foreground: oklch(0.145 0 0);
+  --popover: oklch(1 0 0);
+  --popover-foreground: oklch(0.145 0 0);
+  --primary: oklch(0.205 0 0);
+  --primary-foreground: oklch(0.985 0 0);
+  --secondary: oklch(0.97 0 0);
+  --secondary-foreground: oklch(0.205 0 0);
+  --muted: oklch(0.97 0 0);
+  --muted-foreground: oklch(0.556 0 0);
+  --accent: oklch(0.97 0 0);
+  --accent-foreground: oklch(0.205 0 0);
+  --destructive: oklch(0.577 0.245 27.325);
+  --destructive-foreground: oklch(0.577 0.245 27.325);
+  --border: oklch(0.922 0 0);
+  --input: oklch(0.922 0 0);
+  --ring: oklch(0.708 0 0);
+  --chart-1: oklch(0.646 0.222 41.116);
+  --chart-2: oklch(0.6 0.118 184.704);
+  --chart-3: oklch(0.398 0.07 227.392);
+  --chart-4: oklch(0.828 0.189 84.429);
+  --chart-5: oklch(0.769 0.188 70.08);
+  --radius: 0.625rem;
+  --sidebar: oklch(0.985 0 0);
+  --sidebar-foreground: oklch(0.145 0 0);
+  --sidebar-primary: oklch(0.205 0 0);
+  --sidebar-primary-foreground: oklch(0.985 0 0);
+  --sidebar-accent: oklch(0.97 0 0);
+  --sidebar-accent-foreground: oklch(0.205 0 0);
+  --sidebar-border: oklch(0.922 0 0);
+  --sidebar-ring: oklch(0.708 0 0);
+}
+
+.dark {
+  --background: oklch(0.145 0 0);
+  --foreground: oklch(0.985 0 0);
+  --card: oklch(0.145 0 0);
+  --card-foreground: oklch(0.985 0 0);
+  --popover: oklch(0.145 0 0);
+  --popover-foreground: oklch(0.985 0 0);
+  --primary: oklch(0.985 0 0);
+  --primary-foreground: oklch(0.205 0 0);
+  --secondary: oklch(0.269 0 0);
+  --secondary-foreground: oklch(0.985 0 0);
+  --muted: oklch(0.269 0 0);
+  --muted-foreground: oklch(0.708 0 0);
+  --accent: oklch(0.269 0 0);
+  --accent-foreground: oklch(0.985 0 0);
+  --destructive: oklch(0.396 0.141 25.723);
+  --destructive-foreground: oklch(0.637 0.237 25.331);
+  --border: oklch(0.269 0 0);
+  --input: oklch(0.269 0 0);
+  --ring: oklch(0.439 0 0);
+  --chart-1: oklch(0.488 0.243 264.376);
+  --chart-2: oklch(0.696 0.17 162.48);
+  --chart-3: oklch(0.769 0.188 70.08);
+  --chart-4: oklch(0.627 0.265 303.9);
+  --chart-5: oklch(0.645 0.246 16.439);
+  --sidebar: oklch(0.205 0 0);
+  --sidebar-foreground: oklch(0.985 0 0);
+  --sidebar-primary: oklch(0.488 0.243 264.376);
+  --sidebar-primary-foreground: oklch(0.985 0 0);
+  --sidebar-accent: oklch(0.269 0 0);
+  --sidebar-accent-foreground: oklch(0.985 0 0);
+  --sidebar-border: oklch(0.269 0 0);
+  --sidebar-ring: oklch(0.439 0 0);
+}
+
+@theme inline {
+  --color-background: var(--background);
+  --color-foreground: var(--foreground);
+  --color-card: var(--card);
+  --color-card-foreground: var(--card-foreground);
+  --color-popover: var(--popover);
+  --color-popover-foreground: var(--popover-foreground);
+  --color-primary: var(--primary);
+  --color-primary-foreground: var(--primary-foreground);
+  --color-secondary: var(--secondary);
+  --color-secondary-foreground: var(--secondary-foreground);
+  --color-muted: var(--muted);
+  --color-muted-foreground: var(--muted-foreground);
+  --color-accent: var(--accent);
+  --color-accent-foreground: var(--accent-foreground);
+  --color-destructive: var(--destructive);
+  --color-destructive-foreground: var(--destructive-foreground);
+  --color-border: var(--border);
+  --color-input: var(--input);
+  --color-ring: var(--ring);
+  --color-chart-1: var(--chart-1);
+  --color-chart-2: var(--chart-2);
+  --color-chart-3: var(--chart-3);
+  --color-chart-4: var(--chart-4);
+  --color-chart-5: var(--chart-5);
+  --radius-sm: calc(var(--radius) - 4px);
+  --radius-md: calc(var(--radius) - 2px);
+  --radius-lg: var(--radius);
+  --radius-xl: calc(var(--radius) + 4px);
+  --color-sidebar: var(--sidebar);
+  --color-sidebar-foreground: var(--sidebar-foreground);
+  --color-sidebar-primary: var(--sidebar-primary);
+  --color-sidebar-primary-foreground: var(--sidebar-primary-foreground);
+  --color-sidebar-accent: var(--sidebar-accent);
+  --color-sidebar-accent-foreground: var(--sidebar-accent-foreground);
+  --color-sidebar-border: var(--sidebar-border);
+  --color-sidebar-ring: var(--sidebar-ring);
+}
+
+@layer base {
+  * {
+    @apply border-border outline-ring/50;
+  }
+  body {
+    @apply bg-background text-foreground;
+  }
+}

app/layout.tsx

@@ -0,0 +1,23 @@
+import type { Metadata } from 'next'
+import { Inter } from 'next/font/google'
+import '../styles/globals.css'
+
+const inter = Inter({ subsets: ['latin'] })
+
+export const metadata: Metadata = {
+  title: 'DocV - GED Souveraine et Sécurisée',
+  description: 'DocV propose une approche révolutionnaire de la gestion d\'identité, garantissant sécurité, souveraineté et conformité dans la gestion de vos documents et processus métier.',
+  generator: 'v0.dev',
+}
+
+export default function RootLayout({
+  children,
+}: Readonly<{
+  children: React.ReactNode
+}>) {
+  return (
+    <html lang="fr">
+      <body className={inter.className}>{children}</body>
+    </html>
+  )
+}

app/login/page.tsx

@@ -0,0 +1,199 @@
+"use client"
+
+import type React from "react"
+
+import { useState } from "react"
+import { useRouter } from "next/navigation"
+import Link from "next/link"
+import { Card, CardContent, CardDescription, CardHeader, CardTitle } from "@/components/ui/card"
+import { Button } from "@/components/ui/button"
+import { Badge } from "@/components/ui/badge"
+import {
+  Shield,
+  ArrowLeft,
+  Home,
+  CheckCircle,
+} from "lucide-react"
+import AuthModal from "@/components/4nk/AuthModal"
+import MessageBus from "@/lib/4nk/MessageBus"
+import UserStore from "@/lib/4nk/UserStore"
+
+export default function LoginPage() {
+  const [isAuthModalOpen, setIsAuthModalOpen] = useState(false)
+  const [isLoading, setIsLoading] = useState(false)
+  const [isConnected, setIsConnected] = useState(false)
+  const [error, setError] = useState<string | null>(null)
+  const router = useRouter()
+
+  const iframeUrl = process.env.NEXT_PUBLIC_4NK_IFRAME_URL || "https://dev3.4nkweb.com"
+
+  // Vérifier l'état de connexion au chargement
+  useState(() => {
+    const userStore = UserStore.getInstance()
+    setIsConnected(userStore.isConnected())
+  })
+
+  const handleLogin = () => {
+    setIsAuthModalOpen(true)
+    setError(null)
+  }
+
+  const handleAuthSuccess = async () => {
+    setIsAuthModalOpen(false)
+    setIsConnected(true)
+    
+    try {
+      // Récupérer l'ID d'appairage après connexion
+      const messageBus = MessageBus.getInstance(iframeUrl)
+      await messageBus.isReady()
+      const pairingId = await messageBus.getUserPairingId()
+      
+      console.log("✅ Authentification 4NK réussie, ID d'appairage:", pairingId)
+      
+      // Redirection vers le dashboard
+      router.push("/dashboard")
+    } catch (err) {
+      console.error("Erreur lors de la récupération de l'ID d'appairage:", err)
+      // Redirection quand même vers le dashboard
+      router.push("/dashboard")
+    }
+  }
+
+  const handleAuthError = (errorMessage: string) => {
+    setError(errorMessage)
+    setIsAuthModalOpen(false)
+  }
+
+  // Si déjà connecté, rediriger vers le dashboard
+  if (isConnected) {
+    router.push("/dashboard")
+    return (
+      <div className="min-h-screen bg-gradient-to-br from-blue-50 to-indigo-100 flex items-center justify-center p-4">
+        <Card className="w-full max-w-md">
+          <CardContent className="text-center py-8">
+            <CheckCircle className="h-12 w-12 mx-auto text-green-600 mb-4" />
+            <h2 className="text-xl font-semibold mb-2">Déjà connecté</h2>
+            <p className="text-gray-600">Redirection vers le dashboard...</p>
+          </CardContent>
+        </Card>
+      </div>
+    )
+  }
+
+  return (
+    <div className="min-h-screen bg-gradient-to-br from-blue-50 to-indigo-100 flex items-center justify-center p-4">
+      <div className="w-full max-w-md space-y-6">
+        {/* Lien de retour vers l'accueil */}
+        <div className="text-center">
+          <Link
+            href="/"
+            className="inline-flex items-center text-sm text-gray-600 hover:text-gray-900 transition-colors"
+          >
+            <ArrowLeft className="h-4 w-4 mr-2" />
+            Retour à l'accueil
+          </Link>
+        </div>
+
+        {/* Logo et titre */}
+        <div className="text-center">
+          <div className="flex items-center justify-center mb-6">
+            <Shield className="h-12 w-12 text-blue-600" />
+          </div>
+          <h1 className="text-3xl font-bold text-gray-900 mb-2">DocV</h1>
+          <p className="text-gray-600">Gestion électronique de documents sécurisée</p>
+        </div>
+
+        {/* Carte de connexion 4NK */}
+        <Card>
+          <CardHeader>
+            <CardTitle className="text-center">
+              <Shield className="h-8 w-8 mx-auto mb-4 text-blue-600" />
+              Connexion sécurisée 4NK
+            </CardTitle>
+            <CardDescription className="text-center">
+              Authentification cryptographique sans mot de passe
+            </CardDescription>
+          </CardHeader>
+          <CardContent className="space-y-6">
+            {/* Description de la connexion 4NK */}
+            <div className="bg-blue-50 border border-blue-200 rounded-lg p-4">
+              <h3 className="font-semibold text-blue-900 mb-2">🔐 Authentification 4NK</h3>
+              <ul className="text-sm text-blue-800 space-y-1">
+                <li>• Aucun mot de passe requis</li>
+                <li>• Identité cryptographique sécurisée</li>
+                <li>• Chiffrement bout en bout</li>
+                <li>• Protection par blockchain</li>
+              </ul>
+            </div>
+
+            {/* Affichage des erreurs */}
+            {error && (
+              <div className="bg-red-50 border border-red-200 rounded-lg p-4">
+                <p className="text-red-700 font-medium">Erreur de connexion :</p>
+                <p className="text-red-600 text-sm">{error}</p>
+              </div>
+            )}
+
+            {/* Bouton de connexion */}
+            <Button 
+              onClick={handleLogin} 
+              className="w-full" 
+              size="lg"
+              disabled={isLoading}
+            >
+              <Shield className="h-5 w-5 mr-2" />
+              {isLoading ? "Connexion en cours..." : "Se connecter avec 4NK"}
+            </Button>
+
+            {/* Informations sur l'iframe */}
+            <div className="bg-gray-50 border border-gray-200 rounded-lg p-3">
+              <p className="text-xs text-gray-600 text-center">
+                <strong>URL d'authentification :</strong><br />
+                {iframeUrl}
+              </p>
+            </div>
+          </CardContent>
+        </Card>
+
+        {/* Badges de sécurité */}
+        <div className="flex flex-wrap justify-center gap-2">
+          <Badge variant="outline" className="bg-blue-50 text-blue-700 border-blue-200">
+            <Shield className="h-3 w-3 mr-1" />
+            Sécurisé 4NK
+          </Badge>
+          <Badge variant="outline" className="bg-green-50 text-green-700 border-green-200">
+            Chiffrement bout en bout
+          </Badge>
+          <Badge variant="outline" className="bg-purple-50 text-purple-700 border-purple-200">
+            Blockchain
+          </Badge>
+        </div>
+
+        {/* Lien vers l'espace public */}
+        <div className="text-center">
+          <Link
+            href="/"
+            className="inline-flex items-center text-sm text-blue-600 hover:text-blue-800 transition-colors"
+          >
+            <Home className="h-4 w-4 mr-2" />
+            Découvrir DocV sans se connecter
+          </Link>
+        </div>
+
+        {/* Informations légales */}
+        <div className="text-center text-xs text-gray-500 space-y-1">
+          <p>En vous connectant, vous acceptez nos conditions d'utilisation</p>
+          <p>Vos données sont protégées par le chiffrement 4NK</p>
+        </div>
+      </div>
+
+      {/* Modal d'authentification 4NK */}
+      <AuthModal
+        isOpen={isAuthModalOpen}
+        onConnect={handleAuthSuccess}
+        onClose={() => setIsAuthModalOpen(false)}
+        iframeUrl={iframeUrl}
+      />
+    </div>
+  )
+}

app/page.tsx

@@ -0,0 +1,570 @@
+import Link from "next/link"
+import { Button } from "@/components/ui/button"
+import { Card, CardContent, CardDescription, CardHeader, CardTitle } from "@/components/ui/card"
+import { Badge } from "@/components/ui/badge"
+import { Shield, Key, Database, Zap, Users, Globe, CheckCircle, ArrowRight, Code } from "lucide-react"
+
+export default function HomePage() {
+  return (
+    <div className="min-h-screen bg-gradient-to-br from-slate-50 to-blue-50">
+      {/* Header */}
+      <header className="border-b bg-white/80 backdrop-blur-sm sticky top-0 z-50">
+        <div className="container mx-auto px-4 py-4 flex justify-between items-center">
+          <div className="flex items-center space-x-2">
+            <Shield className="h-8 w-8 text-blue-600" />
+            <span className="text-2xl font-bold text-gray-900">DocV</span>
+            <Badge variant="secondary" className="ml-2">
+              By 4NK
+            </Badge>
+          </div>
+          <nav className="hidden md:flex items-center space-x-6">
+            <Link href="#produit" className="text-gray-600 hover:text-blue-600 transition-colors">
+              Le produit
+            </Link>
+            <Link href="#securite" className="text-gray-600 hover:text-blue-600 transition-colors">
+              Sécurité
+            </Link>
+            <Link href="#tarifs" className="text-gray-600 hover:text-blue-600 transition-colors">
+              Tarifs
+            </Link>
+            <Link href="/formation">
+              <Button variant="outline">Formation</Button>
+            </Link>
+            <Link href="/login">
+              <Button>Connexion</Button>
+            </Link>
+          </nav>
+        </div>
+      </header>
+
+      {/* Hero Section */}
+      <section className="py-20 px-4">
+        <div className="container mx-auto text-center">
+          <h1 className="text-5xl md:text-6xl font-bold text-gray-900 mb-6">
+            Sécurisez votre entreprise avec la <span className="text-blue-600">GED simple et souveraine</span>
+          </h1>
+          <p className="text-xl text-gray-600 mb-8 max-w-3xl mx-auto">
+            DocV propose une approche révolutionnaire de la gestion d'identité, garantissant sécurité, souveraineté et
+            conformité dans la gestion de vos documents et processus métier.
+          </p>
+          <div className="flex flex-col sm:flex-row gap-4 justify-center">
+            <Link href="/login">
+              <Button size="lg" className="text-lg px-8 py-3">
+                Commencer maintenant
+                <ArrowRight className="ml-2 h-5 w-5" />
+              </Button>
+            </Link>
+            <Link href="/formation">
+              <Button variant="outline" size="lg" className="text-lg px-8 py-3 bg-transparent">
+                Découvrir nos formations
+              </Button>
+            </Link>
+          </div>
+        </div>
+      </section>
+
+      {/* Product Features */}
+      <section id="produit" className="py-16 px-4 bg-white">
+        <div className="container mx-auto">
+          <h2 className="text-4xl font-bold text-center mb-12 text-gray-900">Le produit</h2>
+
+          <div className="grid md:grid-cols-2 lg:grid-cols-3 gap-8 mb-16">
+            <Card className="border-2 hover:border-blue-200 transition-colors">
+              <CardHeader>
+                <Key className="h-12 w-12 text-blue-600 mb-4" />
+                <CardTitle>Login cryptographique ultra-simplifié</CardTitle>
+              </CardHeader>
+              <CardContent>
+                <p className="text-gray-600 mb-4">
+                  Aucun mot de passe, aucun OTP, aucun mail, aucun code, aucune application.
+                </p>
+                <p className="text-gray-600">
+                  Notifications transverses et temps réel sur l'avancement des traitements.
+                </p>
+              </CardContent>
+            </Card>
+
+            <Card className="border-2 hover:border-blue-200 transition-colors">
+              <CardHeader>
+                <Zap className="h-12 w-12 text-blue-600 mb-4" />
+                <CardTitle>IA embarquée</CardTitle>
+              </CardHeader>
+              <CardContent>
+                <p className="text-gray-600 mb-4">OCR, classification et extraction avec IA locale.</p>
+                <p className="text-gray-600">L'IA, ses données et ses traitements restent locaux.</p>
+                <p className="text-gray-600 mt-2">Interface conversationnelle pour suivre les dossiers.</p>
+              </CardContent>
+            </Card>
+
+            <Card className="border-2 hover:border-blue-200 transition-colors">
+              <CardHeader>
+                <Users className="h-12 w-12 text-blue-600 mb-4" />
+                <CardTitle>Facilite l'usage quotidien</CardTitle>
+              </CardHeader>
+              <CardContent>
+                <p className="text-gray-600 mb-2">• Réduction massive des emails</p>
+                <p className="text-gray-600 mb-2">• Protection des identités et accès</p>
+                <p className="text-gray-600">• Traçabilité sur blockchain</p>
+              </CardContent>
+            </Card>
+          </div>
+
+          <div className="bg-gradient-to-r from-blue-50 to-indigo-50 rounded-2xl p-8">
+            <h3 className="text-2xl font-bold mb-6 text-center">⚙️ Facilite l'usage de la GED au quotidien</h3>
+            <div className="grid md:grid-cols-2 gap-6">
+              <div>
+                <h4 className="font-semibold mb-3">Clés cryptographiques locales :</h4>
+                <ul className="space-y-2 text-gray-600">
+                  <li>• Utilisées pour signer, chiffrer, authentifier, prouver</li>
+                  <li>• Synchroniser ou chiffrer les traitements IA</li>
+                </ul>
+              </div>
+              <div>
+                <h4 className="font-semibold mb-3">Gestion des rôles et autorisations :</h4>
+                <ul className="space-y-2 text-gray-600">
+                  <li>• Tracée, versionnée, et vérifiable</li>
+                  <li>• Normes : OWASP, ISO/IEC 27001, SecNumCloud, RGPD</li>
+                </ul>
+              </div>
+            </div>
+          </div>
+        </div>
+      </section>
+
+      {/* Security Section */}
+      <section id="securite" className="py-16 px-4 bg-gray-50">
+        <div className="container mx-auto">
+          <div className="text-center mb-12">
+            <h2 className="text-4xl font-bold mb-4 text-gray-900">🔐 Sécurité de bout en bout, par conception</h2>
+            <p className="text-xl text-gray-600">
+              DocV intègre dès l'entrée : chiffrement, confidentialité, intégrité, authentification forte,
+              décentralisation et preuves.
+            </p>
+          </div>
+
+          <div className="grid lg:grid-cols-3 gap-8">
+            <Card className="bg-white border-2 hover:border-red-200 transition-colors">
+              <CardHeader>
+                <Shield className="h-12 w-12 text-red-600 mb-4" />
+                <CardTitle className="text-red-700">🛡️ Moins de failles, plus de confiance</CardTitle>
+              </CardHeader>
+              <CardContent>
+                <ul className="space-y-2 text-gray-600">
+                  <li>• Aucune interface admin exposée</li>
+                  <li>• Aucun mot de passe</li>
+                  <li>• Aucun serveur d'identité</li>
+                  <li>• Aucune dépendance cloud</li>
+                  <li>• Aucune dépendance API</li>
+                </ul>
+              </CardContent>
+            </Card>
+
+            <Card className="bg-white border-2 hover:border-green-200 transition-colors">
+              <CardHeader>
+                <Globe className="h-12 w-12 text-green-600 mb-4" />
+                <CardTitle className="text-green-700">🌐 Une identité pour tout faire et tout vérifier</CardTitle>
+              </CardHeader>
+              <CardContent>
+                <p className="text-gray-600 mb-4">Identité auto-générée, auto-portée, vérifiable, privée :</p>
+                <ul className="space-y-2 text-gray-600">
+                  <li>• Accéder à l'interface GED sécurisée</li>
+                  <li>• Signer les documents et les flux</li>
+                  <li>• Ancrer les preuves sur Bitcoin</li>
+                  <li>• Recevoir des notifications</li>
+                  <li>• Reconnue par d'autres systèmes</li>
+                </ul>
+              </CardContent>
+            </Card>
+
+            <Card className="bg-white border-2 hover:border-blue-200 transition-colors">
+              <CardHeader>
+                <Database className="h-12 w-12 text-blue-600 mb-4" />
+                <CardTitle className="text-blue-700">🔄 Migration simple et à forte valeur ajoutée</CardTitle>
+              </CardHeader>
+              <CardContent>
+                <ul className="space-y-2 text-gray-600">
+                  <li>• Aucune infrastructure à déployer</li>
+                  <li>• Migration automatisée avec indexation</li>
+                  <li>• Compatible bases de données, clouds, API</li>
+                  <li>• Base locale chiffrée et distribuée</li>
+                  <li>• Accompagnement de vos prestataires</li>
+                </ul>
+              </CardContent>
+            </Card>
+          </div>
+        </div>
+      </section>
+
+      {/* References Section */}
+      <section className="py-16 px-4 bg-white">
+        <div className="container mx-auto">
+          <div className="text-center mb-12">
+            <h2 className="text-4xl font-bold mb-4 text-gray-900">🤝 Références et Intégrations</h2>
+            <p className="text-xl text-gray-600">
+              DocV fait confiance aux plus grands éditeurs et sert d'infrastructure à des secteurs critiques
+            </p>
+          </div>
+
+          <div className="grid lg:grid-cols-2 gap-8">
+            <Card className="bg-gradient-to-r from-indigo-50 to-blue-50 border-2 border-blue-200">
+              <CardHeader>
+                <Globe className="h-12 w-12 text-blue-600 mb-4" />
+                <CardTitle className="text-blue-700">🏢 Intégration Marque Blanche</CardTitle>
+              </CardHeader>
+              <CardContent>
+                <p className="text-gray-700 mb-4">
+                  DocV est intégrée en marque blanche par de grands éditeurs qui font confiance à notre technologie pour
+                  sécuriser leurs solutions documentaires.
+                </p>
+                <ul className="space-y-2 text-gray-600">
+                  <li>• Infrastructure invisible mais essentielle</li>
+                  <li>• Sécurisation des échanges documentaires</li>
+                  <li>• Conformité réglementaire garantie</li>
+                  <li>• Scalabilité pour les grands volumes</li>
+                </ul>
+              </CardContent>
+            </Card>
+
+            <Card className="bg-gradient-to-r from-green-50 to-emerald-50 border-2 border-green-200">
+              <CardHeader>
+                <Shield className="h-12 w-12 text-green-600 mb-4" />
+                <CardTitle className="text-green-700">⚖️ Référence Notariale : lecoffre.io</CardTitle>
+              </CardHeader>
+              <CardContent>
+                <p className="text-gray-700 mb-4">
+                  DocV sert d'infrastructure au site <strong>lecoffre.io</strong>, plateforme de référence pour la
+                  gestion sécurisée des échanges documentaires notariaux.
+                </p>
+                <ul className="space-y-2 text-gray-600">
+                  <li>• Échanges notaires ↔ clients sécurisés</li>
+                  <li>• Communications inter-notaires chiffrées</li>
+                  <li>• Partenariats bancaires sécurisés</li>
+                  <li>• Conformité aux exigences notariales</li>
+                </ul>
+                <div className="mt-4 p-3 bg-white rounded-lg border border-green-200">
+                  <p className="text-sm text-green-800">
+                    <strong>lecoffre.io</strong> : La confiance des notaires français pour leurs échanges documentaires
+                    les plus sensibles.
+                  </p>
+                </div>
+              </CardContent>
+            </Card>
+          </div>
+
+          <div className="mt-12 text-center">
+            <div className="bg-gradient-to-r from-gray-50 to-blue-50 p-8 rounded-2xl border border-gray-200">
+              <h3 className="text-2xl font-bold mb-4 text-gray-900">🔒 Une technologie éprouvée</h3>
+              <p className="text-lg text-gray-700 max-w-3xl mx-auto">
+                Quand les secteurs les plus exigeants en matière de sécurité et de confidentialité choisissent DocV,
+                c'est la preuve de la robustesse et de la fiabilité de notre solution.
+              </p>
+            </div>
+          </div>
+          <div className="mt-16">
+            <Card className="bg-gradient-to-r from-purple-50 to-indigo-50 border-2 border-purple-200">
+              <CardHeader className="text-center">
+                <Code className="h-12 w-12 text-purple-600 mx-auto mb-4" />
+                <CardTitle className="text-purple-700 text-2xl">🔓 Solutions Open Source</CardTitle>
+                <CardDescription className="text-lg text-gray-700">
+                  Développez vos solutions distribuées avec nos technologies ouvertes
+                </CardDescription>
+              </CardHeader>
+              <CardContent className="space-y-6">
+                <div className="text-center">
+                  <p className="text-gray-700 mb-6 text-lg">
+                    DocV met à disposition ses briques technologiques en open source pour permettre aux développeurs et
+                    organisations de créer leurs propres solutions distribuées et souveraines.
+                  </p>
+                </div>
+
+                <div className="grid md:grid-cols-2 gap-6">
+                  <div className="bg-white p-4 rounded-lg border border-purple-200">
+                    <h4 className="font-semibold text-purple-800 mb-3">🛠️ Composants disponibles :</h4>
+                    <ul className="space-y-2 text-gray-600">
+                      <li>• Authentification cryptographique</li>
+                      <li>• Gestion d'identité décentralisée</li>
+                      <li>• Chiffrement de bout en bout</li>
+                      <li>• Ancrage blockchain</li>
+                      <li>• APIs souveraines</li>
+                    </ul>
+                  </div>
+
+                  <div className="bg-white p-4 rounded-lg border border-purple-200">
+                    <h4 className="font-semibold text-purple-800 mb-3">🎯 Cas d'usage :</h4>
+                    <ul className="space-y-2 text-gray-600">
+                      <li>• Applications métier distribuées</li>
+                      <li>• Plateformes collaboratives sécurisées</li>
+                      <li>• Solutions sectorielles sur-mesure</li>
+                      <li>• Intégrations système existant</li>
+                      <li>• Prototypes et POC</li>
+                    </ul>
+                  </div>
+                </div>
+
+                <div className="bg-gradient-to-r from-purple-100 to-indigo-100 p-6 rounded-lg border border-purple-300">
+                  <div className="text-center">
+                    <h4 className="font-semibold text-purple-800 mb-3 text-lg">💡 Accompagnement personnalisé</h4>
+                    <p className="text-gray-700 mb-4">
+                      Notre équipe d'experts vous accompagne dans l'intégration et le développement de vos solutions
+                      distribuées basées sur nos composants open source.
+                    </p>
+                    <div className="flex flex-col sm:flex-row gap-4 justify-center">
+                      <a href="https://git.4nkweb.com" target="_blank" rel="noopener noreferrer">
+                        <Button className="bg-purple-600 hover:bg-purple-700">
+                          <Code className="h-4 w-4 mr-2" />
+                          Accéder au code source
+                        </Button>
+                      </a>
+                      <Link href="/contact">
+                        <Button
+                          variant="outline"
+                          className="border-purple-300 text-purple-700 hover:bg-purple-50 bg-transparent"
+                        >
+                          Contactez-nous pour un projet
+                        </Button>
+                      </Link>
+                    </div>
+                  </div>
+                </div>
+
+                <div className="text-center">
+                  <p className="text-sm text-gray-600">
+                    <strong>Licence :</strong> Solutions disponibles sous licence open source permissive. Support
+                    commercial et accompagnement disponibles.
+                  </p>
+                </div>
+              </CardContent>
+            </Card>
+          </div>
+        </div>
+      </section>
+
+      {/* Summary */}
+      <section className="py-16 px-4 bg-gradient-to-r from-blue-600 to-indigo-700 text-white">
+        <div className="container mx-auto text-center">
+          <h2 className="text-4xl font-bold mb-8">🔐 En résumé</h2>
+          <p className="text-xl mb-8 max-w-4xl mx-auto">
+            DocV transforme la GED : plus simple, plus sûre, plus souveraine, et parfaitement compatible avec vos outils
+            existants.
+          </p>
+          <p className="text-lg mb-8">
+            C'est l'identité numérique que vous contrôlez, qui vous protège, et qui vous suit dans tous vos usages
+            documentaires
+          </p>
+        </div>
+      </section>
+
+      {/* Pricing */}
+      <section id="tarifs" className="py-16 px-4 bg-white">
+        <div className="container mx-auto">
+          <h2 className="text-4xl font-bold text-center mb-12 text-gray-900">Tarification simple et universelle</h2>
+
+          <div className="max-w-4xl mx-auto">
+            <Card className="border-2 border-blue-200 bg-blue-50">
+              <CardHeader className="text-center">
+                <CardTitle className="text-3xl font-bold text-blue-700">Offre Découverte</CardTitle>
+                <CardDescription className="text-2xl font-semibold text-blue-600">2990 € HT / mois</CardDescription>
+                <Badge className="bg-green-600 text-white text-lg px-4 py-2 mt-2">1000 jetons inclus</Badge>
+              </CardHeader>
+              <CardContent>
+                <div className="bg-white p-6 rounded-lg mb-6">
+                  <h3 className="text-xl font-bold text-gray-900 mb-4 text-center">🎯 Que comprennent 1000 jetons ?</h3>
+                  <div className="grid md:grid-cols-3 gap-6">
+                    <div className="text-center p-4 bg-blue-50 rounded-lg">
+                      <Database className="h-8 w-8 mx-auto text-blue-600 mb-2" />
+                      <h4 className="font-semibold text-blue-800">Stockage permanent</h4>
+                      <p className="text-2xl font-bold text-blue-600">1 To</p>
+                      <p className="text-sm text-blue-700">Documents chiffrés et sécurisés</p>
+                    </div>
+                    <div className="text-center p-4 bg-green-50 rounded-lg">
+                      <Zap className="h-8 w-8 mx-auto text-green-600 mb-2" />
+                      <h4 className="font-semibold text-green-800">Stockage temporaire</h4>
+                      <p className="text-2xl font-bold text-green-600">100 Go</p>
+                      <p className="text-sm text-green-700">Traitement IA et OCR</p>
+                    </div>
+                    <div className="text-center p-4 bg-purple-50 rounded-lg">
+                      <Users className="h-8 w-8 mx-auto text-purple-600 mb-2" />
+                      <h4 className="font-semibold text-purple-800">Nouveaux dossiers</h4>
+                      <p className="text-2xl font-bold text-purple-600">75</p>
+                      <p className="text-sm text-purple-700">Par mois maximum</p>
+                    </div>
+                  </div>
+                </div>
+
+                {/* Architecture de stockage détaillée */}
+                <div className="bg-gradient-to-r from-gray-50 to-blue-50 p-6 rounded-lg mb-6">
+                  <h4 className="font-semibold text-gray-800 mb-4 text-center">
+                    🏗️ Architecture de stockage souveraine
+                  </h4>
+
+                  <div className="grid md:grid-cols-2 gap-6">
+                    <div className="bg-white p-4 rounded-lg border border-green-200">
+                      <div className="flex items-center space-x-2 mb-3">
+                        <Zap className="h-5 w-5 text-green-600" />
+                        <h5 className="font-semibold text-green-800">Stockage Temporaire</h5>
+                      </div>
+                      <p className="text-sm text-gray-700 mb-2">
+                        <strong>Store chiffré local, distribué strictement en parties prenantes</strong>
+                      </p>
+                      <ul className="text-xs text-gray-600 space-y-1">
+                        <li>• Accès rapide pour modifications</li>
+                        <li>• Chiffrement bout en bout</li>
+                        <li>• Distribution contrôlée</li>
+                        <li>• Traitement IA local</li>
+                      </ul>
+                    </div>
+
+                    <div className="bg-white p-4 rounded-lg border border-blue-200">
+                      <div className="flex items-center space-x-2 mb-3">
+                        <Database className="h-5 w-5 text-blue-600" />
+                        <h5 className="font-semibold text-blue-800">Stockage Permanent</h5>
+                      </div>
+                      <p className="text-sm text-gray-700 mb-2">
+                        <strong>
+                          Store chiffré d'archivage local, distribué strictement en parties prenantes et sur un serveur
+                          de backup sans accès aux données compatible avec du cold storage
+                        </strong>
+                      </p>
+                      <ul className="text-xs text-gray-600 space-y-1">
+                        <li>• Conservation longue durée</li>
+                        <li>• Lecture seule sécurisée</li>
+                        <li>• Backup cold storage</li>
+                        <li>• Extraction IA pour data room distribuée</li>
+                      </ul>
+                    </div>
+                  </div>
+
+                  <div className="mt-4 p-3 bg-blue-100 rounded-lg">
+                    <p className="text-sm text-blue-800 text-center">
+                      <strong>🔐 Souveraineté totale :</strong> Vos données restent sous votre contrôle exclusif, même
+                      en backup
+                    </p>
+                  </div>
+                </div>
+
+                <div className="space-y-3 mb-6">
+                  <div className="flex items-center">
+                    <CheckCircle className="h-5 w-5 text-green-600 mr-3" />
+                    <span>Pas de coût par utilisateur</span>
+                  </div>
+                  <div className="flex items-center">
+                    <CheckCircle className="h-5 w-5 text-green-600 mr-3" />
+                    <span>Pas de surcoût pour l'IA embarquée</span>
+                  </div>
+                  <div className="flex items-center">
+                    <CheckCircle className="h-5 w-5 text-green-600 mr-3" />
+                    <span>Pas de frais de licence à la signature ou au document</span>
+                  </div>
+                  <div className="flex items-center">
+                    <CheckCircle className="h-5 w-5 text-green-600 mr-3" />
+                    <span>Pas de facturation par API ou par traitement</span>
+                  </div>
+                </div>
+
+                {/* Jetons supplémentaires */}
+                <div className="bg-gradient-to-r from-orange-50 to-yellow-50 p-6 rounded-lg border border-orange-200 mb-6">
+                  <h4 className="font-semibold text-orange-800 mb-3 text-center">📦 Jetons supplémentaires</h4>
+                  <div className="text-center mb-4">
+                    <p className="text-lg font-semibold text-orange-700">Lots de 250 jetons</p>
+                    <p className="text-2xl font-bold text-orange-600">+747,50 € HT/mois</p>
+                    <p className="text-sm text-orange-600">(2990 € ÷ 4 = 747,50 € par lot de 250 jetons)</p>
+                  </div>
+                  <div className="grid md:grid-cols-3 gap-4 text-center">
+                    <div className="bg-white p-3 rounded border border-orange-200">
+                      <p className="font-medium text-orange-800">+250 Go</p>
+                      <p className="text-xs text-orange-600">Stockage permanent</p>
+                    </div>
+                    <div className="bg-white p-3 rounded border border-orange-200">
+                      <p className="font-medium text-orange-800">+25 Go</p>
+                      <p className="text-xs text-orange-600">Stockage temporaire</p>
+                    </div>
+                    <div className="bg-white p-3 rounded border border-orange-200">
+                      <p className="font-medium text-orange-800">+18 dossiers</p>
+                      <p className="text-xs text-orange-600">Nouveaux dossiers/mois</p>
+                    </div>
+                  </div>
+                  <p className="text-xs text-orange-600 mt-3 text-center font-medium">
+                    💡 Achetez uniquement ce dont vous avez besoin, quand vous en avez besoin
+                  </p>
+                </div>
+
+                {/* Coût de setup */}
+                <div className="bg-gradient-to-r from-gray-50 to-blue-50 p-6 rounded-lg border border-gray-200 mb-6">
+                  <h4 className="font-semibold text-gray-800 mb-2">⚙️ Coût de setup initial</h4>
+                  <p className="text-sm text-gray-700 mb-3">
+                    Frais de mise en place unique, calculés selon vos contraintes spécifiques :
+                  </p>
+                  <ul className="text-sm text-gray-600 space-y-1">
+                    <li>• Migration de données existantes</li>
+                    <li>• Intégrations systèmes tiers</li>
+                    <li>• Personnalisations interface</li>
+                    <li>• Formation équipes techniques</li>
+                    <li>• Accompagnement déploiement</li>
+                  </ul>
+                  <p className="text-xs text-gray-600 mt-2 font-medium">
+                    💡 Devis personnalisé selon la complexité de votre environnement
+                  </p>
+                </div>
+
+                <div className="text-center">
+                  <p className="text-lg font-semibold text-blue-700 mb-4">
+                    Tarification à la consommation + setup personnalisé
+                  </p>
+                  <Link href="/contact">
+                    <Button size="lg" className="w-full">
+                      Obtenir un devis complet
+                    </Button>
+                  </Link>
+                </div>
+              </CardContent>
+            </Card>
+          </div>
+        </div>
+      </section>
+
+      {/* Footer */}
+      <footer className="bg-gray-900 text-white py-12 px-4">
+        <div className="container mx-auto">
+          <div className="grid md:grid-cols-2 gap-8">
+            <div>
+              <div className="flex items-center space-x-2 mb-4">
+                <Shield className="h-8 w-8 text-blue-400" />
+                <span className="text-2xl font-bold">DocV</span>
+                <Badge variant="secondary" className="ml-2">
+                  By 4NK
+                </Badge>
+              </div>
+              <p className="text-gray-400 mb-4">
+                4NK, pionnier du Web 5.0. Conçoit et développe des solutions de souveraineté.
+              </p>
+              <p className="text-gray-400">contact@docv.fr</p>
+            </div>
+            <div>
+              <h3 className="text-lg font-semibold mb-4">Navigation</h3>
+              <div className="space-y-2">
+                <Link href="#produit" className="block text-gray-400 hover:text-white transition-colors">
+                  Le produit
+                </Link>
+                <Link href="#securite" className="block text-gray-400 hover:text-white transition-colors">
+                  Sécurité
+                </Link>
+                <Link href="#tarifs" className="block text-gray-400 hover:text-white transition-colors">
+                  Tarifs
+                </Link>
+                <Link href="/formation" className="block text-gray-400 hover:text-white transition-colors">
+                  Formation
+                </Link>
+                <Link href="/login" className="block text-gray-400 hover:text-white transition-colors">
+                  Connexion
+                </Link>
+              </div>
+            </div>
+          </div>
+          <div className="border-t border-gray-800 mt-8 pt-8 text-center text-gray-400">
+            <p>&copy; 2024 4NK. Tous droits réservés.</p>
+          </div>
+        </div>
+      </footer>
+    </div>
+  )
+}

components.json

@@ -0,0 +1,21 @@
+{
+  "$schema": "https://ui.shadcn.com/schema.json",
+  "style": "new-york",
+  "rsc": true,
+  "tsx": true,
+  "tailwind": {
+    "config": "",
+    "css": "app/globals.css",
+    "baseColor": "neutral",
+    "cssVariables": true,
+    "prefix": ""
+  },
+  "aliases": {
+    "components": "@/components",
+    "utils": "@/lib/utils",
+    "ui": "@/components/ui",
+    "lib": "@/lib",
+    "hooks": "@/hooks"
+  },
+  "iconLibrary": "lucide"
+}

components/4nk/AuthModal.tsx

@@ -0,0 +1,101 @@
+import { useState, useEffect, memo } from 'react';
+import Iframe from './Iframe';
+import MessageBus from '@/lib/4nk/MessageBus';
+import Loader from '@/lib/4nk/Loader';
+import Modal from '../modal/Modal';
+
+interface AuthModalProps {
+  isOpen: boolean;
+  onConnect: () => void;
+  onClose: () => void;
+  iframeUrl: string;
+}
+
+function AuthModal({ isOpen, onConnect, onClose, iframeUrl }: AuthModalProps) {
+  const [isIframeReady, setIsIframeReady] = useState(false);
+  const [showIframe, setShowIframe] = useState(false);
+  const [authSuccess, setAuthSuccess] = useState(false);
+
+  useEffect(() => {
+    MessageBus.getInstance(iframeUrl).isReady().then(() => {
+      setIsIframeReady(true);
+    });
+  }, [iframeUrl]);
+
+  useEffect(() => {
+    if (!isOpen) {
+      setShowIframe(false);
+      setIsIframeReady(false);
+      setAuthSuccess(false);
+    }
+  }, [isOpen]);
+
+  useEffect(() => {
+    if (isIframeReady && !showIframe) {
+      setShowIframe(true);
+
+      MessageBus.getInstance(iframeUrl).requestLink().then(() => {
+        setAuthSuccess(true);
+
+        setTimeout(() => onConnect(), 500);
+      }).catch((_error: string) => {
+        setShowIframe(false);
+        setIsIframeReady(false);
+        setAuthSuccess(false);
+
+        onClose();
+      });
+    }
+  }, [isIframeReady, showIframe]);
+
+  return (
+    <Modal
+      isOpen={isOpen}
+      onClose={onClose}
+      title='Authentification 4nk'
+    >
+      {!isIframeReady && (
+        <div style={{
+          display: 'flex',
+          flexDirection: 'column',
+          alignItems: 'center',
+          justifyContent: 'center',
+          height: '400px',
+          gap: 16
+        }}>
+          <Loader width={40} />
+          <div style={{ fontWeight: 600, fontSize: 18 }}>Chargement de l'authentification...</div>
+        </div>
+      )}
+      {authSuccess ? (
+        <div style={{
+          display: 'flex',
+          flexDirection: 'column',
+          alignItems: 'center',
+          justifyContent: 'center',
+          height: '400px',
+          gap: 20
+        }}>
+          <div style={{ fontWeight: 600, fontSize: 18, color: '#43a047' }}>
+            Authentification réussie !
+          </div>
+        </div>
+      ) : (
+        <div style={{
+          display: showIframe ? 'flex' : 'none',
+          justifyContent: 'center',
+          alignItems: 'center',
+          width: '100%'
+        }}>
+          <Iframe
+            iframeUrl={iframeUrl}
+            showIframe={showIframe}
+          />
+        </div>
+      )}
+    </Modal>
+  );
+}
+
+AuthModal.displayName = 'AuthModal';
+export default memo(AuthModal);

components/4nk/DebugInfo.tsx

@@ -0,0 +1,70 @@
+"use client"
+
+import { useState } from "react"
+import { Button } from "@/components/ui/button"
+import { Card, CardContent, CardHeader, CardTitle } from "@/components/ui/card"
+import { Badge } from "@/components/ui/badge"
+import { Eye, EyeOff } from "lucide-react"
+
+export function DebugInfo() {
+  const [showDebug, setShowDebug] = useState(false)
+
+  if (process.env.NODE_ENV === "production" && !showDebug) {
+    return (
+      <Button
+        variant="ghost"
+        size="sm"
+        onClick={() => setShowDebug(true)}
+        className="fixed bottom-4 right-4 opacity-50 hover:opacity-100"
+      >
+        <Eye className="h-4 w-4" />
+      </Button>
+    )
+  }
+
+  return (
+    <div className="fixed bottom-4 right-4 z-50">
+      <Card className="w-80">
+        <CardHeader className="pb-2">
+          <div className="flex items-center justify-between">
+            <CardTitle className="text-sm">Debug Info</CardTitle>
+            <Button variant="ghost" size="sm" onClick={() => setShowDebug(false)}>
+              <EyeOff className="h-4 w-4" />
+            </Button>
+          </div>
+        </CardHeader>
+        <CardContent className="space-y-2 text-xs">
+          <div>
+            <Badge variant="outline" className="mb-1">
+              Environment
+            </Badge>
+            <p>{process.env.NODE_ENV}</p>
+          </div>
+
+          <div>
+            <Badge variant="outline" className="mb-1">
+              4NK Iframe URL
+            </Badge>
+            <p className="break-all">{process.env.NEXT_PUBLIC_4NK_IFRAME_URL || "Non configuré"}</p>
+          </div>
+
+          <div>
+            <Badge variant="outline" className="mb-1">
+              Current Origin
+            </Badge>
+            <p className="break-all">{typeof window !== "undefined" ? window.location.origin : "SSR"}</p>
+          </div>
+
+          <div>
+            <Badge variant="outline" className="mb-1">
+              User Agent
+            </Badge>
+            <p className="break-all">
+              {typeof window !== "undefined" ? navigator.userAgent.slice(0, 50) + "..." : "SSR"}
+            </p>
+          </div>
+        </CardContent>
+      </Card>
+    </div>
+  )
+}

components/4nk/Iframe.tsx

@@ -0,0 +1,32 @@
+import { useRef, useEffect, memo } from 'react';
+import IframeReference from '@/lib/4nk/IframeReference';
+
+function Iframe({ iframeUrl, showIframe = false }: { iframeUrl: string; showIframe?: boolean }) {
+  const iframeRef = useRef<HTMLIFrameElement>(null);
+
+  useEffect(() => {
+    if (iframeRef.current) {
+      IframeReference.setIframe(iframeRef.current);
+    }
+    return () => {
+      IframeReference.setIframe(null);
+    };
+  }, [iframeRef.current]);
+
+  return (
+    <iframe
+      ref={iframeRef}
+      src={iframeUrl}
+      style={{
+        display: showIframe ? 'block' : 'none',
+        width: '400px',
+        height: '400px',
+        border: 'none',
+        overflow: 'hidden'
+      }}
+    />
+  );
+}
+
+Iframe.displayName = 'Iframe';
+export default memo(Iframe);

components/modal/Modal.css

@@ -0,0 +1,163 @@
+.modal-overlay {
+  position: fixed;
+  top: 0;
+  left: 0;
+  width: 100vw;
+  height: 100vh;
+  background: rgba(35, 36, 42, 0.82);
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  z-index: 1000;
+  animation: modal-fadein 0.33s cubic-bezier(.4, 0, .2, 1);
+  backdrop-filter: blur(3.5px);
+  -webkit-backdrop-filter: blur(3.5px);
+}
+
+
+@keyframes modal-fadein {
+  from {
+    opacity: 0;
+  }
+
+  to {
+    opacity: 1;
+  }
+}
+
+.modal-container {
+  background: #23242a;
+  border-radius: 18px;
+  min-width: 340px;
+  max-width: 95vw;
+  min-height: 0;
+  padding: 0 0 24px 0;
+  position: relative;
+  box-shadow: 0 12px 48px 0 rgba(0, 0, 0, 0.34), 0 2px 12px 0 rgba(30, 34, 44, 0.10);
+  overflow: hidden;
+  animation: modal-popin 0.34s cubic-bezier(.4, 0, .2, 1);
+  transition: box-shadow 0.2s, opacity 0.25s cubic-bezier(.4, 0, .2, 1);
+}
+
+.modal-container.modal-closing {
+  opacity: 0;
+  transform: translateY(32px) scale(0.97);
+  pointer-events: none;
+}
+
+
+@keyframes modal-popin {
+  from {
+    opacity: 0;
+    transform: translateY(32px) scale(0.97);
+  }
+
+  to {
+    opacity: 1;
+    transform: translateY(0) scale(1);
+  }
+}
+
+.modal-header {
+  background: linear-gradient(90deg, #23242a 85%, #23242aEE 100%);
+  color: #fff;
+  padding: 22px 30px 14px 30px;
+  border-radius: 18px 18px 0 0;
+  box-shadow: 0 2px 12px 0 rgba(30, 34, 44, 0.06);
+  position: relative;
+  display: flex;
+  align-items: center;
+  min-height: 52px;
+}
+
+
+.modal-header h2 {
+  margin: 0;
+  font-size: 1.3rem;
+  font-weight: 600;
+  letter-spacing: 0.01em;
+  color: #fff;
+}
+
+.modal-close {
+  position: absolute;
+  top: 10px;
+  right: 16px;
+  background: transparent;
+  border: none;
+  font-size: 2rem;
+  color: #e3e4e8;
+  width: 36px;
+  height: 36px;
+  min-width: 36px;
+  min-height: 36px;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  cursor: pointer;
+  transition: background 0.18s, color 0.18s;
+  z-index: 2;
+  border-radius: 6px;
+  padding: 0;
+}
+
+.modal-close svg {
+  display: block;
+  width: 24px;
+  height: 24px;
+  background: none;
+  pointer-events: none;
+}
+
+.modal-close:hover,
+.modal-close:focus {
+  background: rgba(255, 255, 255, 0.10);
+  color: #fff;
+}
+
+.modal-close:active {
+  background: rgba(67, 160, 71, 0.13);
+}
+
+.modal-close:active {
+  background: rgba(67, 160, 71, 0.13);
+}
+
+
+.modal-body {
+  padding: 28px 28px 0 28px;
+  max-height: 70vh;
+  overflow-y: auto;
+  color: #e3e4e8;
+  font-size: 1rem;
+}
+
+@media (max-width: 600px) {
+  .modal-container {
+    min-width: 0;
+    width: 98vw;
+    padding: 0 0 12px 0;
+    border-radius: 12px;
+  }
+
+  .modal-header {
+    padding: 16px 10px 10px 14px;
+    border-radius: 12px 12px 0 0;
+  }
+
+  .modal-body {
+    padding: 14px 8px 0 8px;
+  }
+
+  .modal-close {
+    top: 6px;
+    right: 6px;
+    width: 30px;
+    height: 30px;
+    font-size: 1.2rem;
+  }
+}
+
+.modal-body {
+  width: 100%;
+}

components/modal/Modal.tsx

@@ -0,0 +1,38 @@
+import React, { memo } from 'react';
+import './Modal.css';
+
+interface ModalProps {
+  isOpen: boolean;
+  onClose: () => void;
+  title?: string;
+  children: React.ReactNode;
+}
+
+function Modal({ isOpen, onClose, title, children }: ModalProps) {
+  if (!isOpen) {
+    return null;
+  }
+  return (
+    <div className="modal-overlay modal-fadein">
+      <div className="modal-container modal-popin">
+        <button className="close-button modal-close" onClick={onClose} aria-label="Fermer">
+          <svg width="24" height="24" viewBox="0 0 24 24" fill="none" xmlns="http://www.w3.org/2000/svg" aria-hidden="true">
+            <path d="M6 6L18 18M18 6L6 18" stroke="#fff" strokeWidth="2.4" strokeLinecap="round" filter="url(#shadow)" />
+            <defs>
+              <filter id="shadow" x="-2" y="-2" width="28" height="28" filterUnits="userSpaceOnUse">
+                <feDropShadow dx="0" dy="0" stdDeviation="1.2" floodColor="#23242a" />
+              </filter>
+            </defs>
+          </svg>
+        </button>
+        {title && <div className="modal-header modal-header"><h2>{title}</h2></div>}
+        <div className="modal-body modal-body">
+          {children}
+        </div>
+      </div>
+    </div>
+  );
+}
+
+Modal.displayName = 'Modal';
+export default memo(Modal);

components/theme-provider.tsx

@@ -0,0 +1,11 @@
+'use client'
+
+import * as React from 'react'
+import {
+  ThemeProvider as NextThemesProvider,
+  type ThemeProviderProps,
+} from 'next-themes'
+
+export function ThemeProvider({ children, ...props }: ThemeProviderProps) {
+  return <NextThemesProvider {...props}>{children}</NextThemesProvider>
+}

components/ui/badge.tsx

@@ -0,0 +1,46 @@
+import * as React from "react"
+import { Slot } from "@radix-ui/react-slot"
+import { cva, type VariantProps } from "class-variance-authority"
+
+import { cn } from "@/lib/utils"
+
+const badgeVariants = cva(
+  "inline-flex items-center justify-center rounded-md border px-2 py-0.5 text-xs font-medium w-fit whitespace-nowrap shrink-0 [&>svg]:size-3 gap-1 [&>svg]:pointer-events-none focus-visible:border-ring focus-visible:ring-ring/50 focus-visible:ring-[3px] aria-invalid:ring-destructive/20 dark:aria-invalid:ring-destructive/40 aria-invalid:border-destructive transition-[color,box-shadow] overflow-hidden",
+  {
+    variants: {
+      variant: {
+        default:
+          "border-transparent bg-primary text-primary-foreground [a&]:hover:bg-primary/90",
+        secondary:
+          "border-transparent bg-secondary text-secondary-foreground [a&]:hover:bg-secondary/90",
+        destructive:
+          "border-transparent bg-destructive text-white [a&]:hover:bg-destructive/90 focus-visible:ring-destructive/20 dark:focus-visible:ring-destructive/40 dark:bg-destructive/60",
+        outline:
+          "text-foreground [a&]:hover:bg-accent [a&]:hover:text-accent-foreground",
+      },
+    },
+    defaultVariants: {
+      variant: "default",
+    },
+  }
+)
+
+function Badge({
+  className,
+  variant,
+  asChild = false,
+  ...props
+}: React.ComponentProps<"span"> &
+  VariantProps<typeof badgeVariants> & { asChild?: boolean }) {
+  const Comp = asChild ? Slot : "span"
+
+  return (
+    <Comp
+      data-slot="badge"
+      className={cn(badgeVariants({ variant }), className)}
+      {...props}
+    />
+  )
+}
+
+export { Badge, badgeVariants }

components/ui/button.tsx

@@ -0,0 +1,59 @@
+import * as React from "react"
+import { Slot } from "@radix-ui/react-slot"
+import { cva, type VariantProps } from "class-variance-authority"
+
+import { cn } from "@/lib/utils"
+
+const buttonVariants = cva(
+  "inline-flex items-center justify-center gap-2 whitespace-nowrap rounded-md text-sm font-medium transition-all disabled:pointer-events-none disabled:opacity-50 [&_svg]:pointer-events-none [&_svg:not([class*='size-'])]:size-4 shrink-0 [&_svg]:shrink-0 outline-none focus-visible:border-ring focus-visible:ring-ring/50 focus-visible:ring-[3px] aria-invalid:ring-destructive/20 dark:aria-invalid:ring-destructive/40 aria-invalid:border-destructive",
+  {
+    variants: {
+      variant: {
+        default:
+          "bg-primary text-primary-foreground shadow-xs hover:bg-primary/90",
+        destructive:
+          "bg-destructive text-white shadow-xs hover:bg-destructive/90 focus-visible:ring-destructive/20 dark:focus-visible:ring-destructive/40 dark:bg-destructive/60",
+        outline:
+          "border bg-background shadow-xs hover:bg-accent hover:text-accent-foreground dark:bg-input/30 dark:border-input dark:hover:bg-input/50",
+        secondary:
+          "bg-secondary text-secondary-foreground shadow-xs hover:bg-secondary/80",
+        ghost:
+          "hover:bg-accent hover:text-accent-foreground dark:hover:bg-accent/50",
+        link: "text-primary underline-offset-4 hover:underline",
+      },
+      size: {
+        default: "h-9 px-4 py-2 has-[>svg]:px-3",
+        sm: "h-8 rounded-md gap-1.5 px-3 has-[>svg]:px-2.5",
+        lg: "h-10 rounded-md px-6 has-[>svg]:px-4",
+        icon: "size-9",
+      },
+    },
+    defaultVariants: {
+      variant: "default",
+      size: "default",
+    },
+  }
+)
+
+function Button({
+  className,
+  variant,
+  size,
+  asChild = false,
+  ...props
+}: React.ComponentProps<"button"> &
+  VariantProps<typeof buttonVariants> & {
+    asChild?: boolean
+  }) {
+  const Comp = asChild ? Slot : "button"
+
+  return (
+    <Comp
+      data-slot="button"
+      className={cn(buttonVariants({ variant, size, className }))}
+      {...props}
+    />
+  )
+}
+
+export { Button, buttonVariants }

components/ui/card.tsx

@@ -0,0 +1,92 @@
+import * as React from "react"
+
+import { cn } from "@/lib/utils"
+
+function Card({ className, ...props }: React.ComponentProps<"div">) {
+  return (
+    <div
+      data-slot="card"
+      className={cn(
+        "bg-card text-card-foreground flex flex-col gap-6 rounded-xl border py-6 shadow-sm",
+        className
+      )}
+      {...props}
+    />
+  )
+}
+
+function CardHeader({ className, ...props }: React.ComponentProps<"div">) {
+  return (
+    <div
+      data-slot="card-header"
+      className={cn(
+        "@container/card-header grid auto-rows-min grid-rows-[auto_auto] items-start gap-1.5 px-6 has-data-[slot=card-action]:grid-cols-[1fr_auto] [.border-b]:pb-6",
+        className
+      )}
+      {...props}
+    />
+  )
+}
+
+function CardTitle({ className, ...props }: React.ComponentProps<"div">) {
+  return (
+    <div
+      data-slot="card-title"
+      className={cn("leading-none font-semibold", className)}
+      {...props}
+    />
+  )
+}
+
+function CardDescription({ className, ...props }: React.ComponentProps<"div">) {
+  return (
+    <div
+      data-slot="card-description"
+      className={cn("text-muted-foreground text-sm", className)}
+      {...props}
+    />
+  )
+}
+
+function CardAction({ className, ...props }: React.ComponentProps<"div">) {
+  return (
+    <div
+      data-slot="card-action"
+      className={cn(
+        "col-start-2 row-span-2 row-start-1 self-start justify-self-end",
+        className
+      )}
+      {...props}
+    />
+  )
+}
+
+function CardContent({ className, ...props }: React.ComponentProps<"div">) {
+  return (
+    <div
+      data-slot="card-content"
+      className={cn("px-6", className)}
+      {...props}
+    />
+  )
+}
+
+function CardFooter({ className, ...props }: React.ComponentProps<"div">) {
+  return (
+    <div
+      data-slot="card-footer"
+      className={cn("flex items-center px-6 [.border-t]:pt-6", className)}
+      {...props}
+    />
+  )
+}
+
+export {
+  Card,
+  CardHeader,
+  CardFooter,
+  CardTitle,
+  CardAction,
+  CardDescription,
+  CardContent,
+}

components/ui/checkbox.tsx

@@ -0,0 +1,31 @@
+"use client"
+
+import * as React from "react"
+import * as CheckboxPrimitive from "@radix-ui/react-checkbox"
+import { Check } from 'lucide-react'
+
+import { cn } from "@/lib/utils"
+
+function Checkbox({
+  className,
+  ...props
+}: React.ComponentProps<typeof CheckboxPrimitive.Root>) {
+  return (
+    <CheckboxPrimitive.Root
+      data-slot="checkbox"
+      className={cn(
+        "peer size-4 shrink-0 rounded-sm border border-primary shadow focus-visible:outline-none focus-visible:ring-1 focus-visible:ring-ring disabled:cursor-not-allowed disabled:opacity-50 data-[state=checked]:bg-primary data-[state=checked]:text-primary-foreground",
+        className
+      )}
+      {...props}
+    >
+      <CheckboxPrimitive.Indicator
+        className={cn("flex items-center justify-center text-current")}
+      >
+        <Check className="size-4" />
+      </CheckboxPrimitive.Indicator>
+    </CheckboxPrimitive.Root>
+  )
+}
+
+export { Checkbox }

components/ui/input.tsx

@@ -0,0 +1,21 @@
+import * as React from "react"
+
+import { cn } from "@/lib/utils"
+
+function Input({ className, type, ...props }: React.ComponentProps<"input">) {
+  return (
+    <input
+      type={type}
+      data-slot="input"
+      className={cn(
+        "file:text-foreground placeholder:text-muted-foreground selection:bg-primary selection:text-primary-foreground dark:bg-input/30 border-input flex h-9 w-full min-w-0 rounded-md border bg-transparent px-3 py-1 text-base shadow-xs transition-[color,box-shadow] outline-none file:inline-flex file:h-7 file:border-0 file:bg-transparent file:text-sm file:font-medium disabled:pointer-events-none disabled:cursor-not-allowed disabled:opacity-50 md:text-sm",
+        "focus-visible:border-ring focus-visible:ring-ring/50 focus-visible:ring-[3px]",
+        "aria-invalid:ring-destructive/20 dark:aria-invalid:ring-destructive/40 aria-invalid:border-destructive",
+        className
+      )}
+      {...props}
+    />
+  )
+}
+
+export { Input }

components/ui/label.tsx

@@ -0,0 +1,24 @@
+"use client"
+
+import * as React from "react"
+import * as LabelPrimitive from "@radix-ui/react-label"
+
+import { cn } from "@/lib/utils"
+
+function Label({
+  className,
+  ...props
+}: React.ComponentProps<typeof LabelPrimitive.Root>) {
+  return (
+    <LabelPrimitive.Root
+      data-slot="label"
+      className={cn(
+        "flex items-center gap-2 text-sm leading-none font-medium select-none group-data-[disabled=true]:pointer-events-none group-data-[disabled=true]:opacity-50 peer-disabled:cursor-not-allowed peer-disabled:opacity-50",
+        className
+      )}
+      {...props}
+    />
+  )
+}
+
+export { Label }

components/ui/radio-group.tsx

@@ -0,0 +1,42 @@
+"use client"
+
+import * as React from "react"
+import * as RadioGroupPrimitive from "@radix-ui/react-radio-group"
+import { Circle } from 'lucide-react'
+
+import { cn } from "@/lib/utils"
+
+function RadioGroup({
+  className,
+  ...props
+}: React.ComponentProps<typeof RadioGroupPrimitive.Root>) {
+  return (
+    <RadioGroupPrimitive.Root
+      data-slot="radio-group"
+      className={cn("grid gap-2", className)}
+      {...props}
+    />
+  )
+}
+
+function RadioGroupItem({
+  className,
+  ...props
+}: React.ComponentProps<typeof RadioGroupPrimitive.Item>) {
+  return (
+    <RadioGroupPrimitive.Item
+      data-slot="radio-group-item"
+      className={cn(
+        "aspect-square size-4 rounded-full border border-primary text-primary shadow focus:outline-none focus-visible:ring-1 focus-visible:ring-ring disabled:cursor-not-allowed disabled:opacity-50",
+        className
+      )}
+      {...props}
+    >
+      <RadioGroupPrimitive.Indicator className="flex items-center justify-center">
+        <Circle className="size-3.5 fill-current text-current" />
+      </RadioGroupPrimitive.Indicator>
+    </RadioGroupPrimitive.Item>
+  )
+}
+
+export { RadioGroup, RadioGroupItem }

components/ui/select.tsx

@@ -0,0 +1,171 @@
+"use client"
+
+import * as React from "react"
+import * as SelectPrimitive from "@radix-ui/react-select"
+import { Check, ChevronDown, ChevronUp } from 'lucide-react'
+
+import { cn } from "@/lib/utils"
+
+function Select(props: React.ComponentProps<typeof SelectPrimitive.Root>) {
+  return <SelectPrimitive.Root {...props} />
+}
+
+function SelectGroup(props: React.ComponentProps<typeof SelectPrimitive.Group>) {
+  return <SelectPrimitive.Group {...props} />
+}
+
+function SelectValue(props: React.ComponentProps<typeof SelectPrimitive.Value>) {
+  return <SelectPrimitive.Value {...props} />
+}
+
+function SelectTrigger({
+  className,
+  children,
+  ...props
+}: React.ComponentProps<typeof SelectPrimitive.Trigger>) {
+  return (
+    <SelectPrimitive.Trigger
+      data-slot="select-trigger"
+      className={cn(
+        "flex h-9 w-full items-center justify-between whitespace-nowrap rounded-md border border-input bg-transparent px-3 py-2 text-sm shadow-xs ring-offset-background placeholder:text-muted-foreground focus:outline-none focus:ring-1 focus:ring-ring disabled:cursor-not-allowed disabled:opacity-50 [&>span]:line-clamp-1",
+        className
+      )}
+      {...props}
+    >
+      {children}
+      <SelectPrimitive.Icon asChild>
+        <ChevronDown className="size-4 opacity-50" />
+      </SelectPrimitive.Icon>
+    </SelectPrimitive.Trigger>
+  )
+}
+
+function SelectScrollUpButton({
+  className,
+  ...props
+}: React.ComponentProps<typeof SelectPrimitive.ScrollUpButton>) {
+  return (
+    <SelectPrimitive.ScrollUpButton
+      className={cn(
+        "flex cursor-default items-center justify-center py-1",
+        className
+      )}
+      {...props}
+    >
+      <ChevronUp className="size-4" />
+    </SelectPrimitive.ScrollUpButton>
+  )
+}
+
+function SelectScrollDownButton({
+  className,
+  ...props
+}: React.ComponentProps<typeof SelectPrimitive.ScrollDownButton>) {
+  return (
+    <SelectPrimitive.ScrollDownButton
+      className={cn(
+        "flex cursor-default items-center justify-center py-1",
+        className
+      )}
+      {...props}
+    >
+      <ChevronDown className="size-4" />
+    </SelectPrimitive.ScrollDownButton>
+  )
+}
+
+function SelectContent({
+  className,
+  children,
+  position = "popper",
+  ...props
+}: React.ComponentProps<typeof SelectPrimitive.Content>) {
+  return (
+    <SelectPrimitive.Portal>
+      <SelectPrimitive.Content
+        data-slot="select-content"
+        className={cn(
+          "relative z-50 max-h-96 min-w-[8rem] overflow-hidden rounded-md border bg-popover text-popover-foreground shadow-md data-[state=open]:animate-in data-[state=closed]:animate-out data-[state=closed]:fade-out-0 data-[state=open]:fade-in-0 data-[state=closed]:zoom-out-95 data-[state=open]:zoom-in-95 data-[side=bottom]:slide-in-from-top-2 data-[side=left]:slide-in-from-right-2 data-[side=right]:slide-in-from-left-2 data-[side=top]:slide-in-from-bottom-2",
+          position === "popper" &&
+            "data-[side=bottom]:translate-y-1 data-[side=left]:-translate-x-1 data-[side=right]:translate-x-1 data-[side=top]:-translate-y-1",
+          className
+        )}
+        position={position}
+        {...props}
+      >
+        <SelectScrollUpButton />
+        <SelectPrimitive.Viewport
+          className={cn(
+            "p-1",
+            position === "popper" &&
+              "h-[var(--radix-select-trigger-height)] w-full min-w-[var(--radix-select-trigger-width)]"
+          )}
+        >
+          {children}
+        </SelectPrimitive.Viewport>
+        <SelectScrollDownButton />
+      </SelectPrimitive.Content>
+    </SelectPrimitive.Portal>
+  )
+}
+
+function SelectLabel({
+  className,
+  ...props
+}: React.ComponentProps<typeof SelectPrimitive.Label>) {
+  return (
+    <SelectPrimitive.Label
+      className={cn("px-2 py-1.5 text-sm font-semibold", className)}
+      {...props}
+    />
+  )
+}
+
+function SelectItem({
+  className,
+  children,
+  ...props
+}: React.ComponentProps<typeof SelectPrimitive.Item>) {
+  return (
+    <SelectPrimitive.Item
+      data-slot="select-item"
+      className={cn(
+        "relative flex w-full cursor-default select-none items-center rounded-sm py-1.5 pl-2 pr-8 text-sm outline-none focus:bg-accent focus:text-accent-foreground data-[disabled]:pointer-events-none data-[disabled]:opacity-50",
+        className
+      )}
+      {...props}
+    >
+      <span className="absolute right-2 flex size-3.5 items-center justify-center">
+        <SelectPrimitive.ItemIndicator>
+          <Check className="size-4" />
+        </SelectPrimitive.ItemIndicator>
+      </span>
+      <SelectPrimitive.ItemText>{children}</SelectPrimitive.ItemText>
+    </SelectPrimitive.Item>
+  )
+}
+
+function SelectSeparator({
+  className,
+  ...props
+}: React.ComponentProps<typeof SelectPrimitive.Separator>) {
+  return (
+    <SelectPrimitive.Separator
+      className={cn("-mx-1 my-1 h-px bg-muted", className)}
+      {...props}
+    />
+  )
+}
+
+export {
+  Select,
+  SelectGroup,
+  SelectValue,
+  SelectTrigger,
+  SelectContent,
+  SelectLabel,
+  SelectItem,
+  SelectSeparator,
+  SelectScrollUpButton,
+  SelectScrollDownButton,
+}

components/ui/skeleton.tsx

@@ -0,0 +1,8 @@
+import type React from "react"
+import { cn } from "@/lib/utils"
+
+function Skeleton({ className, ...props }: React.HTMLAttributes<HTMLDivElement>) {
+  return <div className={cn("animate-pulse rounded-md bg-muted", className)} {...props} />
+}
+
+export { Skeleton }

components/ui/switch.tsx

@@ -0,0 +1,29 @@
+"use client"
+
+import * as React from "react"
+import * as SwitchPrimitives from "@radix-ui/react-switch"
+
+import { cn } from "@/lib/utils"
+
+const Switch = React.forwardRef<
+  React.ElementRef<typeof SwitchPrimitives.Root>,
+  React.ComponentPropsWithoutRef<typeof SwitchPrimitives.Root>
+>(({ className, ...props }, ref) => (
+  <SwitchPrimitives.Root
+    className={cn(
+      "peer inline-flex h-6 w-11 shrink-0 cursor-pointer items-center rounded-full border-2 border-transparent transition-colors focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-2 focus-visible:ring-offset-background disabled:cursor-not-allowed disabled:opacity-50 data-[state=checked]:bg-primary data-[state=unchecked]:bg-input",
+      className,
+    )}
+    {...props}
+    ref={ref}
+  >
+    <SwitchPrimitives.Thumb
+      className={cn(
+        "pointer-events-none block h-5 w-5 rounded-full bg-background shadow-lg ring-0 transition-transform data-[state=checked]:translate-x-5 data-[state=unchecked]:translate-x-0",
+      )}
+    />
+  </SwitchPrimitives.Root>
+))
+Switch.displayName = SwitchPrimitives.Root.displayName
+
+export { Switch }

components/ui/textarea.tsx

@@ -0,0 +1,20 @@
+import * as React from "react"
+
+import { cn } from "@/lib/utils"
+
+function Textarea({ className, ...props }: React.ComponentProps<"textarea">) {
+  return (
+    <textarea
+      data-slot="textarea"
+      className={cn(
+        "file:text-foreground placeholder:text-muted-foreground selection:bg-primary selection:text-primary-foreground dark:bg-input/30 border-input flex min-h-[60px] w-full min-w-0 rounded-md border bg-transparent px-3 py-2 text-base shadow-xs transition-[color,box-shadow] outline-none disabled:pointer-events-none disabled:cursor-not-allowed disabled:opacity-50 md:text-sm",
+        "focus-visible:border-ring focus-visible:ring-ring/50 focus-visible:ring-[3px]",
+        "aria-invalid:ring-destructive/20 dark:aria-invalid:ring-destructive/40 aria-invalid:border-destructive",
+        className
+      )}
+      {...props}
+    />
+  )
+}
+
+export { Textarea }

docs/API.md

@@ -0,0 +1,765 @@
+# Référence API - docv
+
+Ce document est un modèle. Il doit être adapté par chaque projet dérivé. Il documente les APIs de l'infrastructure (RPC, HTTP, WebSocket) et doit rester cohérent avec la version publiée (`TEMPLATE_VERSION`) et le `CHANGELOG.md`.
+
+## Vue d'Ensemble des APIs
+
+L'infrastructure docv expose plusieurs interfaces pour différents types d'interactions :
+
+- **Bitcoin Core RPC** : Interface JSON-RPC pour Bitcoin
+- **Blindbit HTTP** : API REST pour les paiements silencieux
+- **SDK Relay WebSocket** : Interface temps réel pour les clients
+- **SDK Relay HTTP** : API REST pour les opérations de gestion
+
+## 1. API Bitcoin Core RPC
+
+### Informations Générales
+
+- **Protocole :** JSON-RPC
+- **Port :** 18443
+- **Authentification :** Cookie ou credentials
+- **Réseau :** Signet
+- **Base URL :** `http://localhost:18443`
+
+### Authentification
+
+#### Méthode Cookie (Recommandée)
+```bash
+# Le cookie est automatiquement utilisé par Bitcoin Core
+curl -X POST http://localhost:18443 \
+  -H "Content-Type: application/json" \
+  --data '{"jsonrpc": "1.0", "id": "test", "method": "getblockchaininfo", "params": []}'
+```
+
+#### Méthode Credentials
+```bash
+curl -X POST http://localhost:18443 \
+  -H "Content-Type: application/json" \
+  -u "username:password" \
+  --data '{"jsonrpc": "1.0", "id": "test", "method": "getblockchaininfo", "params": []}'
+```
+
+### Endpoints Principaux
+
+#### getblockchaininfo
+Récupère les informations sur la blockchain.
+
+**Requête :**
+```json
+{
+  "jsonrpc": "1.0",
+  "id": "test",
+  "method": "getblockchaininfo",
+  "params": []
+}
+```
+
+**Réponse :**
+```json
+{
+  "result": {
+    "chain": "signet",
+    "blocks": 12345,
+    "headers": 12345,
+    "bestblockhash": "0000000000000000000000000000000000000000000000000000000000000000",
+    "difficulty": 1.0,
+    "mediantime": 1234567890,
+    "verificationprogress": 1.0,
+    "initialblockdownload": false,
+    "chainwork": "0000000000000000000000000000000000000000000000000000000000000000",
+    "size_on_disk": 123456789,
+    "pruned": false,
+    "pruneheight": null,
+    "automatic_pruning": false,
+    "prune_target_size": null,
+    "warnings": ""
+  },
+  "error": null,
+  "id": "test"
+}
+```
+
+#### getblock
+Récupère les informations d'un bloc spécifique.
+
+**Requête :**
+```json
+{
+  "jsonrpc": "1.0",
+  "id": "test",
+  "method": "getblock",
+  "params": ["blockhash", 2]
+}
+```
+
+**Paramètres :**
+- `blockhash` : Hash du bloc
+- `verbosity` : Niveau de détail (0, 1, 2)
+
+#### getrawtransaction
+Récupère une transaction brute.
+
+**Requête :**
+```json
+{
+  "jsonrpc": "1.0",
+  "id": "test",
+  "method": "getrawtransaction",
+  "params": ["txid", true]
+}
+```
+
+#### sendrawtransaction
+Envoie une transaction brute au réseau.
+
+**Requête :**
+```json
+{
+  "jsonrpc": "1.0",
+  "id": "test",
+  "method": "sendrawtransaction",
+  "params": ["hexstring"]
+}
+```
+
+#### getwalletinfo
+Récupère les informations du wallet.
+
+**Requête :**
+```json
+{
+  "jsonrpc": "1.0",
+  "id": "test",
+  "method": "getwalletinfo",
+  "params": []
+}
+```
+
+### Gestion des Erreurs
+
+**Erreur typique :**
+```json
+{
+  "result": null,
+  "error": {
+    "code": -32601,
+    "message": "Method not found"
+  },
+  "id": "test"
+}
+```
+
+**Codes d'erreur courants :**
+- `-32601` : Méthode non trouvée
+- `-32602` : Paramètres invalides
+- `-32603` : Erreur interne
+- `-1` : Erreur d'authentification
+
+## 2. API Blindbit HTTP
+
+### Informations Générales
+
+- **Protocole :** HTTP REST
+- **Port :** 8000
+- **Base URL :** `http://localhost:8000`
+- **Content-Type :** `application/json`
+
+### Endpoints
+
+#### GET /health
+Vérifie la santé du service.
+
+**Requête :**
+```bash
+curl -X GET http://localhost:8000/health
+```
+
+**Réponse :**
+```json
+{
+  "status": "healthy",
+  "timestamp": "2024-12-19T14:30:00Z",
+  "version": "1.0.0"
+}
+```
+
+#### POST /generate-address
+Génère une adresse de paiement silencieux.
+
+**Requête :**
+```json
+{
+  "label": "payment_001",
+  "amount": 0.001
+}
+```
+
+**Réponse :**
+```json
+{
+  "address": "bc1p...",
+  "label": "payment_001",
+  "amount": 0.001,
+  "created_at": "2024-12-19T14:30:00Z"
+}
+```
+
+#### GET /payments
+Liste les paiements reçus.
+
+**Requête :**
+```bash
+curl -X GET "http://localhost:8000/payments?limit=10&offset=0"
+```
+
+**Paramètres de requête :**
+- `limit` : Nombre maximum de résultats (défaut: 10)
+- `offset` : Décalage pour la pagination (défaut: 0)
+
+**Réponse :**
+```json
+{
+  "payments": [
+    {
+      "id": "payment_001",
+      "address": "bc1p...",
+      "amount": 0.001,
+      "txid": "txid...",
+      "block_height": 12345,
+      "created_at": "2024-12-19T14:30:00Z"
+    }
+  ],
+  "total": 1,
+  "limit": 10,
+  "offset": 0
+}
+```
+
+#### GET /payments/{id}
+Récupère les détails d'un paiement spécifique.
+
+**Requête :**
+```bash
+curl -X GET http://localhost:8000/payments/payment_001
+```
+
+**Réponse :**
+```json
+{
+  "id": "payment_001",
+  "address": "bc1p...",
+  "amount": 0.001,
+  "txid": "txid...",
+  "block_height": 12345,
+  "confirmations": 6,
+  "created_at": "2024-12-19T14:30:00Z",
+  "status": "confirmed"
+}
+```
+
+### Codes de Statut HTTP
+
+- `200` : Succès
+- `201` : Créé
+- `400` : Requête invalide
+- `404` : Ressource non trouvée
+- `500` : Erreur serveur
+
+## 3. API SDK Relay WebSocket
+
+### Informations Générales
+
+- **Protocole :** WebSocket/WSS
+- **Port :** 8090
+- **URL :** `ws://localhost:8090` ou `wss://localhost:8090`
+- **Format :** JSON
+
+### Connexion
+
+```javascript
+const ws = new WebSocket('ws://localhost:8090');
+
+ws.onopen = function() {
+    console.log('Connexion WebSocket établie');
+};
+
+ws.onmessage = function(event) {
+    const message = JSON.parse(event.data);
+    console.log('Message reçu:', message);
+};
+
+ws.onerror = function(error) {
+    console.error('Erreur WebSocket:', error);
+};
+
+ws.onclose = function() {
+    console.log('Connexion WebSocket fermée');
+};
+```
+
+### Format des Messages
+
+Tous les messages suivent le format JSON suivant :
+
+```json
+{
+  "type": "message_type",
+  "id": "unique_message_id",
+  "timestamp": 1234567890,
+  "data": {
+    // Données spécifiques au type de message
+  }
+}
+```
+
+### Types de Messages
+
+#### Messages de Synchronisation
+
+**StateSync :**
+```json
+{
+  "type": "StateSync",
+  "id": "state_001",
+  "timestamp": 1234567890,
+  "data": {
+    "relay_id": "relay-1",
+    "state": "running",
+    "version": "1.0.0",
+    "uptime": 3600
+  }
+}
+```
+
+**HealthSync :**
+```json
+{
+  "type": "HealthSync",
+  "id": "health_001",
+  "timestamp": 1234567890,
+  "data": {
+    "relay_id": "relay-1",
+    "status": "healthy",
+    "uptime": 3600,
+    "cpu_usage": 15.5,
+    "memory_usage": 45.2
+  }
+}
+```
+
+**MetricsSync :**
+```json
+{
+  "type": "MetricsSync",
+  "id": "metrics_001",
+  "timestamp": 1234567890,
+  "data": {
+    "relay_id": "relay-1",
+    "messages_sent": 1000,
+    "messages_received": 950,
+    "sync_errors": 5,
+    "connected_relays": 3
+  }
+}
+```
+
+#### Messages de Transaction
+
+**TransactionReceived :**
+```json
+{
+  "type": "TransactionReceived",
+  "id": "tx_001",
+  "timestamp": 1234567890,
+  "data": {
+    "txid": "txid...",
+    "amount": 0.001,
+    "address": "bc1p...",
+    "block_height": 12345,
+    "confirmations": 1
+  }
+}
+```
+
+**BlockScanned :**
+```json
+{
+  "type": "BlockScanned",
+  "id": "block_001",
+  "timestamp": 1234567890,
+  "data": {
+    "block_height": 12345,
+    "block_hash": "hash...",
+    "transactions_count": 150,
+    "silent_payments_found": 2
+  }
+}
+```
+
+### Commandes Client
+
+#### Ping
+```json
+{
+  "type": "ping",
+  "id": "ping_001",
+  "timestamp": 1234567890,
+  "data": {}
+}
+```
+
+**Réponse :**
+```json
+{
+  "type": "pong",
+  "id": "ping_001",
+  "timestamp": 1234567890,
+  "data": {
+    "relay_id": "relay-1"
+  }
+}
+```
+
+#### GetStatus
+```json
+{
+  "type": "get_status",
+  "id": "status_001",
+  "timestamp": 1234567890,
+  "data": {}
+}
+```
+
+**Réponse :**
+```json
+{
+  "type": "status",
+  "id": "status_001",
+  "timestamp": 1234567890,
+  "data": {
+    "relay_id": "relay-1",
+    "status": "running",
+    "uptime": 3600,
+    "connected_relays": 3,
+    "last_block_height": 12345
+  }
+}
+```
+
+## 4. API SDK Relay HTTP
+
+### Informations Générales
+
+- **Protocole :** HTTP REST
+- **Port :** 8091
+- **Base URL :** `http://localhost:8091`
+- **Content-Type :** `application/json`
+
+### Endpoints
+
+#### GET /health
+Vérifie la santé du relais.
+
+**Requête :**
+```bash
+curl -X GET http://localhost:8091/health
+```
+
+**Réponse :**
+```json
+{
+  "status": "healthy",
+  "relay_id": "relay-1",
+  "uptime": 3600,
+  "version": "1.0.0",
+  "connected_relays": 3
+}
+```
+
+#### GET /status
+Récupère le statut détaillé du relais.
+
+**Requête :**
+```bash
+curl -X GET http://localhost:8091/status
+```
+
+**Réponse :**
+```json
+{
+  "relay_id": "relay-1",
+  "status": "running",
+  "uptime": 3600,
+  "version": "1.0.0",
+  "connected_relays": 3,
+  "last_block_height": 12345,
+  "sync_metrics": {
+    "messages_sent": 1000,
+    "messages_received": 950,
+    "sync_errors": 5
+  }
+}
+```
+
+#### GET /relays
+Liste les relais connectés.
+
+**Requête :**
+```bash
+curl -X GET http://localhost:8091/relays
+```
+
+**Réponse :**
+```json
+{
+  "relays": [
+    {
+      "relay_id": "relay-2",
+      "address": "sdk_relay_2:8090",
+      "status": "connected",
+      "connected_since": 1234567890,
+      "last_heartbeat": 1234567890
+    },
+    {
+      "relay_id": "relay-3",
+      "address": "sdk_relay_3:8090",
+      "status": "connected",
+      "connected_since": 1234567890,
+      "last_heartbeat": 1234567890
+    }
+  ]
+}
+```
+
+#### GET /metrics
+Récupère les métriques de synchronisation.
+
+**Requête :**
+```bash
+curl -X GET http://localhost:8091/metrics
+```
+
+**Réponse :**
+```json
+{
+  "messages_sent": 1000,
+  "messages_received": 950,
+  "sync_errors": 5,
+  "last_sync_timestamp": 1234567890,
+  "connected_relays": 3,
+  "mesh_health": 0.95
+}
+```
+
+#### POST /sync
+Force une synchronisation manuelle.
+
+**Requête :**
+```json
+{
+  "sync_type": "StateSync",
+  "target_relay": "relay-2"
+}
+```
+
+**Réponse :**
+```json
+{
+  "success": true,
+  "message": "Synchronisation initiée",
+  "sync_id": "sync_001"
+}
+```
+
+## 5. Gestion des Erreurs
+
+### Erreurs WebSocket
+
+**Erreur de connexion :**
+```json
+{
+  "type": "error",
+  "id": "error_001",
+  "timestamp": 1234567890,
+  "data": {
+    "code": "CONNECTION_ERROR",
+    "message": "Impossible de se connecter au relais",
+    "details": "Connection refused"
+  }
+}
+```
+
+**Erreur de message :**
+```json
+{
+  "type": "error",
+  "id": "error_002",
+  "timestamp": 1234567890,
+  "data": {
+    "code": "INVALID_MESSAGE",
+    "message": "Format de message invalide",
+    "details": "Missing required field 'type'"
+  }
+}
+```
+
+### Erreurs HTTP
+
+**Erreur 400 :**
+```json
+{
+  "error": {
+    "code": "INVALID_REQUEST",
+    "message": "Requête invalide",
+    "details": "Missing required parameter 'relay_id'"
+  }
+}
+```
+
+**Erreur 500 :**
+```json
+{
+  "error": {
+    "code": "INTERNAL_ERROR",
+    "message": "Erreur interne du serveur",
+    "details": "Database connection failed"
+  }
+}
+```
+
+## 6. Exemples d'Utilisation
+
+### Exemple Python - WebSocket
+
+```python
+import asyncio
+import websockets
+import json
+
+async def connect_to_relay():
+    uri = "ws://localhost:8090"
+    async with websockets.connect(uri) as websocket:
+        # Envoyer un ping
+        ping_message = {
+            "type": "ping",
+            "id": "ping_001",
+            "timestamp": int(time.time()),
+            "data": {}
+        }
+        await websocket.send(json.dumps(ping_message))
+
+        # Écouter les messages
+        async for message in websocket:
+            data = json.loads(message)
+            print(f"Message reçu: {data}")
+
+asyncio.run(connect_to_relay())
+```
+
+### Exemple JavaScript - WebSocket
+
+```javascript
+const ws = new WebSocket('ws://localhost:8090');
+
+ws.onopen = function() {
+    // Envoyer un ping
+    const pingMessage = {
+        type: 'ping',
+        id: 'ping_001',
+        timestamp: Date.now(),
+        data: {}
+    };
+    ws.send(JSON.stringify(pingMessage));
+};
+
+ws.onmessage = function(event) {
+    const message = JSON.parse(event.data);
+    console.log('Message reçu:', message);
+};
+```
+
+### Exemple cURL - Bitcoin Core RPC
+
+```bash
+# Récupérer les informations de la blockchain
+curl -X POST http://localhost:18443 \
+  -H "Content-Type: application/json" \
+  --data '{
+    "jsonrpc": "1.0",
+    "id": "test",
+    "method": "getblockchaininfo",
+    "params": []
+  }'
+
+# Récupérer un bloc spécifique
+curl -X POST http://localhost:18443 \
+  -H "Content-Type: application/json" \
+  --data '{
+    "jsonrpc": "1.0",
+    "id": "test",
+    "method": "getblock",
+    "params": ["blockhash", 2]
+  }'
+```
+
+## 7. Limites et Quotas
+
+### Bitcoin Core RPC
+- **Taux limite :** 1000 requêtes/minute par défaut
+- **Taille des requêtes :** 32MB maximum
+- **Connexions simultanées :** 125 par défaut
+
+### Blindbit HTTP
+- **Taux limite :** 100 requêtes/minute
+- **Taille des requêtes :** 10MB maximum
+- **Connexions simultanées :** 50
+
+### SDK Relay WebSocket
+- **Connexions simultanées :** 1000 par relais
+- **Taille des messages :** 1MB maximum
+- **Heartbeat :** 30 secondes
+
+### SDK Relay HTTP
+- **Taux limite :** 200 requêtes/minute
+- **Taille des requêtes :** 5MB maximum
+- **Connexions simultanées :** 100
+
+## 8. Sécurité
+
+### Authentification
+- **Bitcoin Core :** Cookie d'authentification
+- **Blindbit :** À définir selon les besoins
+- **SDK Relay :** Authentification WebSocket (optionnelle)
+
+### Chiffrement
+- **RPC Bitcoin :** HTTP (non chiffré en local)
+- **HTTP Blindbit :** HTTP (non chiffré en local)
+- **WebSocket SDK Relay :** WSS (chiffré)
+
+### Bonnes Pratiques
+- Utiliser HTTPS/WSS en production
+- Implémenter l'authentification appropriée
+- Valider toutes les entrées
+- Limiter les taux de requêtes
+- Monitorer les accès
+
+## 9. Monitoring et Observabilité
+
+### Métriques à Surveiller
+- **Latence des APIs :** Temps de réponse
+- **Taux d'erreur :** Pourcentage d'erreurs
+- **Débit :** Requêtes par seconde
+- **Utilisation des ressources :** CPU, mémoire, réseau
+
+### Logs
+- **Logs d'accès :** Requêtes et réponses
+- **Logs d'erreur :** Erreurs et exceptions
+- **Logs de performance :** Métriques de performance
+
+### Alertes
+- **Erreurs 5xx :** Erreurs serveur
+- **Latence élevée :** Temps de réponse > 1s
+- **Taux d'erreur élevé :** > 5%
+- **Services indisponibles :** Health checks en échec
+
+

docs/ARCHITECTURE.md

@@ -0,0 +1,51 @@
+# Architecture Technique - docv
+
+
+## Vue d'Ensemble de l'Architecture
+
+Ce document sert de modèle générique. Il doit être adapté par chaque projet dérivé de ce template.
+
+### Architecture Générale
+
+Composants majeurs et couplages:
+- Bitcoin Core, Blindbit, Relais SDK, UI/clients
+- Réseau privé Docker, ZMQ, WebSocket
+- CI/CD Gitea Actions
+
+## Composants Principaux
+
+Listez ici les composants avec responsabilités, entrées/sorties et SLA.
+
+### 1. Environnements
+
+
+### 2. Orchestration
+
+### 3. CI/CD
+
+- Gitea Actions avec jobs: qualité, tests, intégration, sécurité, docker-build, documentation, release-guard
+- Release Guard impose: tests, documentation, compilation, alignement `VERSION`/`TEMPLATE_VERSION` ↔ `CHANGELOG.md` ↔ tag, choix latest vs wip
+- Fichier version: `TEMPLATE_VERSION` (ou `VERSION`) est la source de vérité; `CHANGELOG.md` doit contenir l’entrée correspondante
+## Troubleshooting
+
+### 1. Problèmes de Synchronisation
+
+- **Connexions perdues :** Vérifier la connectivité réseau
+- **Messages dupliqués :** Vérifier le cache de déduplication
+- **Latence élevée :** Vérifier les ressources système
+
+### 2. Problèmes de Performance
+
+- **Utilisation mémoire :** Vérifier les fuites mémoire
+- **CPU élevé :** Vérifier les boucles infinies
+- **Disque plein :** Nettoyer les logs et données
+
+### 3. Problèmes de Configuration
+
+- **Ports bloqués :** Vérifier le pare-feu
+- **Volumes manquants :** Vérifier les permissions
+- **Variables d'environnement :** Vérifier la configuration
+
+## Évolution Future
+
+

docs/AUTO_SSH_PUSH.md

@@ -0,0 +1,238 @@
+# Automatisation SSH pour Push - ihm_client
+
+## Vue d'ensemble
+
+L'automatisation SSH pour les push permet d'utiliser automatiquement votre clé SSH pour tous les push vers le repository `ihm_client` sur Gitea, sans avoir à spécifier manuellement les paramètres SSH.
+
+## Configuration automatique
+
+### 1. Configuration Git globale
+
+La configuration SSH est automatiquement appliquée :
+
+```bash
+git config --global url."git@git.4nkweb.com:".insteadOf "https://git.4nkweb.com/"
+```
+
+### 2. Vérification SSH
+
+Le script vérifie automatiquement la configuration SSH :
+
+```bash
+ssh -T git@git.4nkweb.com
+```
+
+## Scripts d'automatisation
+
+### Script principal : `auto-ssh-push.sh`
+
+Le script `scripts/auto-ssh-push.sh` offre plusieurs modes de push automatique :
+
+#### Options disponibles
+
+```bash
+# Push rapide (message automatique)
+./scripts/auto-ssh-push.sh quick
+
+# Push avec message personnalisé
+./scripts/auto-ssh-push.sh message "feat: nouvelle fonctionnalité"
+
+# Push sur une branche spécifique
+./scripts/auto-ssh-push.sh branch feature/nouvelle-fonctionnalite
+
+# Push et préparation merge
+./scripts/auto-ssh-push.sh merge feature/nouvelle-fonctionnalite main
+
+# Status et push conditionnel
+./scripts/auto-ssh-push.sh status
+```
+
+#### Exemples d'utilisation
+
+```bash
+# Push rapide sur la branche courante
+./scripts/auto-ssh-push.sh quick
+
+# Push avec message de commit
+./scripts/auto-ssh-push.sh message "fix: correction du bug de synchronisation"
+
+# Push sur une branche spécifique
+./scripts/auto-ssh-push.sh branch develop
+
+# Push et création de Pull Request
+./scripts/auto-ssh-push.sh merge feature/nouvelle-fonctionnalite main
+```
+
+### Alias Git globaux
+
+Des alias Git ont été configurés pour simplifier les push :
+
+```bash
+# Push avec message personnalisé
+git ssh-push "Mon message de commit"
+
+# Push rapide (message automatique)
+git quick-push
+```
+
+## Fonctionnalités automatiques
+
+### 1. Configuration SSH automatique
+
+- Configuration Git pour utiliser SSH
+- Vérification de l'authentification SSH
+- Gestion des erreurs de configuration
+
+### 2. Push automatique
+
+- Ajout automatique de tous les changements (`git add .`)
+- Commit automatique avec message
+- Push automatique vers la branche courante
+
+### 3. Gestion des branches
+
+- Détection automatique de la branche courante
+- Support des branches personnalisées
+- Préparation des Pull Requests
+
+### 4. Validation et sécurité
+
+- Vérification de l'authentification SSH avant push
+- Messages d'erreur explicites
+- Gestion des cas d'échec
+
+## Workflow recommandé
+
+### Développement quotidien
+
+```bash
+# 1. Faire vos modifications
+# 2. Push rapide
+./scripts/auto-ssh-push.sh quick
+
+# Ou avec message personnalisé
+./scripts/auto-ssh-push.sh message "feat: ajout de la fonctionnalité X"
+```
+
+### Développement de fonctionnalités
+
+```bash
+# 1. Créer une branche
+git checkout -b feature/nouvelle-fonctionnalite
+
+# 2. Développer
+# 3. Push sur la branche
+./scripts/auto-ssh-push.sh branch feature/nouvelle-fonctionnalite
+
+# 4. Préparer le merge
+./scripts/auto-ssh-push.sh merge feature/nouvelle-fonctionnalite main
+```
+
+### Intégration continue
+
+```bash
+# Push automatique après tests
+./scripts/auto-ssh-push.sh message "ci: tests passés, déploiement automatique"
+```
+
+## Dépannage
+
+### Problèmes courants
+
+#### 1. Échec d'authentification SSH
+
+```bash
+# Vérifier la clé SSH
+ssh -T git@git.4nkweb.com
+
+# Si échec, configurer une nouvelle clé
+ssh-keygen -t ed25519 -f ~/.ssh/id_ed25519_4nk
+ssh-add ~/.ssh/id_ed25519_4nk
+```
+
+#### 2. Configuration Git manquante
+
+```bash
+# Reconfigurer Git pour SSH
+git config --global url."git@git.4nkweb.com:".insteadOf "https://git.4nkweb.com/"
+```
+
+#### 3. Permissions de script
+
+```bash
+# Rendre le script exécutable
+chmod +x scripts/auto-ssh-push.sh
+```
+
+### Commandes de diagnostic
+
+```bash
+# Vérifier la configuration SSH
+ssh -vT git@git.4nkweb.com
+
+# Vérifier la configuration Git
+git config --global --list | grep url
+
+# Vérifier les remotes
+git remote -v
+```
+
+## Intégration avec CI/CD
+
+### Workflow Gitea Actions
+
+Le workflow CI/CD (`.gitea/workflows/ci.yml`) utilise automatiquement SSH :
+
+```yaml
+- name: Setup SSH for Gitea
+  run: |
+    mkdir -p ~/.ssh
+    echo "${{ secrets.SSH_PRIVATE_KEY }}" > ~/.ssh/id_rsa
+    chmod 600 ~/.ssh/id_rsa
+    ssh-keyscan -H git.4nkweb.com >> ~/.ssh/known_hosts
+    git config --global url."git@git.4nkweb.com:".insteadOf "https://git.4nkweb.com/"
+```
+
+### Variables d'environnement
+
+- `SSH_PRIVATE_KEY` : Clé SSH privée pour l'authentification
+- `SSH_PUBLIC_KEY` : Clé SSH publique (optionnelle)
+
+## Sécurité
+
+### Bonnes pratiques
+
+- Les clés SSH sont stockées de manière sécurisée
+- Les permissions des fichiers SSH sont correctement configurées
+- La vérification des hôtes SSH est activée
+- Les clés sont régulièrement renouvelées
+
+### Permissions recommandées
+
+```bash
+chmod 700 ~/.ssh
+chmod 600 ~/.ssh/id_rsa
+chmod 644 ~/.ssh/id_rsa.pub
+chmod 600 ~/.ssh/config
+```
+
+## Évolution
+
+### Améliorations futures
+
+- Support pour plusieurs clés SSH
+- Rotation automatique des clés
+- Intégration avec un gestionnaire de secrets
+- Support pour l'authentification par certificats SSH
+
+### Maintenance
+
+- Vérification régulière de la validité des clés SSH
+- Mise à jour des configurations selon les bonnes pratiques
+- Documentation des changements de configuration
+
+## Conclusion
+
+L'automatisation SSH pour les push simplifie considérablement le workflow de développement en éliminant la nécessité de configurer manuellement SSH pour chaque opération Git. Le script `auto-ssh-push.sh` et les alias Git offrent une interface simple et sécurisée pour tous les push vers le repository `ihm_client`.
+
+

docs/COMMUNITY_GUIDE.md

@@ -0,0 +1,403 @@
+# Guide de la Communauté - docv
+
+## 🌟 Bienvenue dans la Communauté docv !
+
+Ce guide vous accompagne dans votre participation à la communauté open source de docv, une infrastructure complète pour les paiements silencieux Bitcoin.
+
+## 🎯 À Propos de docv
+
+### **Qu'est-ce que docv ?**
+
+docv est une infrastructure Docker complète qui permet de déployer et gérer facilement un écosystème Bitcoin complet incluant :
+
+- **Bitcoin Core** : Nœud Bitcoin avec support signet
+- **Blindbit** : Service de filtres pour les paiements silencieux
+- **SDK Relay** : Système de relais avec synchronisation mesh
+- **Tor** : Proxy anonyme pour la confidentialité
+
+### **Pourquoi les Paiements Silencieux ?**
+
+Les paiements silencieux (Silent Payments) sont une innovation Bitcoin qui améliore la confidentialité en permettant de créer des adresses uniques pour chaque transaction, sans révéler de liens entre les paiements.
+
+## 🤝 Comment Contribuer
+
+### **Niveaux de Contribution**
+
+#### 🟢 **Débutant**
+- **Documentation** : Améliorer les guides, corriger les fautes
+- **Tests** : Ajouter des tests, signaler des bugs
+- **Support** : Aider les autres utilisateurs
+- **Traduction** : Traduire la documentation
+
+#### 🟡 **Intermédiaire**
+- **Fonctionnalités** : Implémenter de nouvelles fonctionnalités
+- **Optimisations** : Améliorer les performances
+- **Tests avancés** : Tests d'intégration et de performance
+- **Outils** : Créer des scripts et outils
+
+#### 🔴 **Avancé**
+- **Architecture** : Améliorer l'architecture du système
+- **Sécurité** : Audits de sécurité, améliorations
+- **Core features** : Fonctionnalités principales
+- **Mentorat** : Guider les nouveaux contributeurs
+
+### **Premiers Pas**
+
+#### 1. **Fork et Clone**
+```bash
+# Fork le repository sur Gitea
+# Puis clonez votre fork
+git clone https://git.4nkweb.com/votre-username/4NK_node.git
+cd 4NK_node
+
+# Ajoutez l'upstream
+git remote add upstream https://git.4nkweb.com/4nk/4NK_node.git
+```
+
+#### 2. **Installation Locale**
+```bash
+# Installez l'infrastructure
+./restart_4nk_node.sh
+
+# Vérifiez que tout fonctionne
+docker ps
+```
+
+#### 3. **Exploration**
+```bash
+# Explorez la documentation
+ls docs/
+cat docs/INDEX.md
+
+# Exécutez les tests
+./tests/run_all_tests.sh
+```
+
+## 📚 Ressources d'Apprentissage
+
+### **Documentation Essentielle**
+
+#### **Pour Commencer**
+- **[Guide d'Installation](docs/INSTALLATION.md)** - Installation complète
+- **[Guide d'Utilisation](docs/USAGE.md)** - Utilisation quotidienne
+- **[Guide de Configuration](docs/CONFIGURATION.md)** - Configuration avancée
+
+#### **Pour Développer**
+- **[Architecture Technique](docs/ARCHITECTURE.md)** - Architecture détaillée
+- **[API Reference](docs/API.md)** - Documentation des APIs
+- **[Guide de Tests](docs/TESTING.md)** - Tests et validation
+
+#### **Pour Contribuer**
+- **[Guide de Contribution](CONTRIBUTING.md)** - Processus de contribution
+- **[Code de Conduite](CODE_OF_CONDUCT.md)** - Règles de la communauté
+- **[Politique de Sécurité](SECURITY.md)** - Signalement de vulnérabilités
+
+### **Ressources Externes**
+
+#### **Bitcoin et Paiements Silencieux**
+- [Bitcoin.org](https://bitcoin.org/) - Documentation Bitcoin officielle
+- [BIP 352](https://github.com/bitcoin/bips/blob/master/bip-0352.mediawiki) - Spécification des paiements silencieux
+- [Bitcoin Core Documentation](https://bitcoincore.org/en/doc/) - Documentation Bitcoin Core
+
+#### **Technologies Utilisées**
+- [Docker Documentation](https://docs.docker.com/) - Guide Docker
+- [Rust Book](https://doc.rust-lang.org/book/) - Guide Rust
+- [WebSocket RFC](https://tools.ietf.org/html/rfc6455) - Spécification WebSocket
+
+## 🛠️ Environnement de Développement
+
+### **Prérequis**
+
+#### **Système**
+```bash
+# Ubuntu/Debian
+sudo apt update
+sudo apt install docker.io docker-compose git curl
+
+# CentOS/RHEL
+sudo yum install docker docker-compose git curl
+
+# macOS
+brew install docker docker-compose git curl
+```
+
+#### **Développement**
+```bash
+# Rust (pour sdk_relay)
+curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
+
+# Python (pour les tests)
+sudo apt install python3 python3-pip
+pip3 install websockets requests
+```
+
+### **Configuration de Développement**
+
+#### **Variables d'Environnement**
+```bash
+# Configuration de développement
+export RUST_LOG=debug
+export ENABLE_SYNC_TEST=1
+export BITCOIN_NETWORK=signet
+```
+
+#### **Outils de Développement**
+```bash
+# Linting et formatting
+cargo clippy
+cargo fmt
+
+# Tests
+cargo test
+./tests/run_all_tests.sh
+
+# Build
+cargo build --release
+```
+
+## 🐛 Signaler un Bug
+
+### **Avant de Signaler**
+
+1. **Vérifiez la documentation** - La solution pourrait déjà être documentée
+2. **Recherchez les issues existantes** - Le bug pourrait déjà être signalé
+3. **Testez sur la dernière version** - Le bug pourrait déjà être corrigé
+
+### **Template de Bug Report**
+
+Utilisez le template fourni dans Gitea ou suivez cette structure :
+
+```markdown
+## Description du Bug
+Description claire et concise du problème.
+
+## Étapes pour Reproduire
+1. Aller à '...'
+2. Cliquer sur '...'
+3. Faire défiler jusqu'à '...'
+4. Voir l'erreur
+
+## Comportement Attendu
+Description de ce qui devrait se passer.
+
+## Comportement Actuel
+Description de ce qui se passe actuellement.
+
+## Informations Système
+- OS: [ex: Ubuntu 20.04]
+- Docker: [ex: 20.10.0]
+- Version: [ex: v1.0.0]
+
+## Logs
+```
+Logs pertinents ici
+```
+```
+
+## 💡 Proposer une Fonctionnalité
+
+### **Avant de Proposer**
+
+1. **Vérifiez la roadmap** - La fonctionnalité pourrait déjà être planifiée
+2. **Discutez avec la communauté** - Utilisez les discussions Gitea
+3. **Préparez un prototype** - Montrez que c'est faisable
+
+### **Template de Feature Request**
+
+```markdown
+## Résumé
+Description claire et concise de la fonctionnalité souhaitée.
+
+## Motivation
+Pourquoi cette fonctionnalité est-elle nécessaire ?
+
+## Proposition
+Description détaillée de la fonctionnalité proposée.
+
+## Alternatives Considérées
+Autres solutions envisagées.
+
+## Exemples d'Utilisation
+Comment cette fonctionnalité serait-elle utilisée ?
+```
+
+## 🔄 Processus de Contribution
+
+### **Workflow Git**
+
+#### 1. **Créer une Branche**
+```bash
+# Depuis la branche main
+git checkout main
+git pull upstream main
+
+# Créer une branche pour votre contribution
+git checkout -b feature/nom-de-votre-feature
+# ou
+git checkout -b fix/nom-du-bug
+```
+
+#### 2. **Développer**
+```bash
+# Développez votre fonctionnalité
+# Ajoutez des tests
+# Mettez à jour la documentation
+
+# Commitez régulièrement
+git add .
+git commit -m "feat: ajouter nouvelle fonctionnalité"
+```
+
+#### 3. **Tester**
+```bash
+# Exécutez les tests
+./tests/run_all_tests.sh
+
+# Vérifiez le code
+cargo clippy
+cargo fmt --check
+```
+
+#### 4. **Soumettre**
+```bash
+# Poussez vers votre fork
+git push origin feature/nom-de-votre-feature
+
+# Créez une Pull Request sur Gitea
+```
+
+### **Standards de Code**
+
+#### **Messages de Commit**
+Utilisez le format conventionnel :
+```bash
+feat(sdk_relay): add new sync type for metrics
+fix(bitcoin): resolve connection timeout issue
+docs(api): update WebSocket message format
+test(integration): add multi-relay sync tests
+```
+
+#### **Code Style**
+- **Rust** : Suivez les conventions Rust (rustfmt, clippy)
+- **Bash** : Utilisez shellcheck pour les scripts
+- **Python** : Suivez PEP 8
+- **Markdown** : Utilisez un linter markdown
+
+## 🏷️ Labels et Milestones
+
+### **Labels Utilisés**
+
+#### **Type**
+- `bug` - Problèmes et bugs
+- `enhancement` - Nouvelles fonctionnalités
+- `documentation` - Amélioration de la documentation
+- `good first issue` - Pour les nouveaux contributeurs
+- `help wanted` - Besoin d'aide
+
+#### **Priorité**
+- `priority: high` - Priorité élevée
+- `priority: medium` - Priorité moyenne
+- `priority: low` - Priorité basse
+
+#### **Statut**
+- `status: blocked` - Bloqué
+- `status: in progress` - En cours
+- `status: ready for review` - Prêt pour review
+
+### **Milestones**
+
+- **v1.0.0** - Version stable initiale
+- **v1.1.0** - Améliorations et corrections
+- **v2.0.0** - Nouvelles fonctionnalités majeures
+
+## 🎉 Reconnaissance
+
+### **Hall of Fame**
+
+Les contributeurs significatifs seront reconnus dans :
+
+- **README.md** - Liste des contributeurs
+- **CHANGELOG.md** - Mentions dans les releases
+- **Documentation** - Crédits dans les guides
+- **Site web** - Page dédiée aux contributeurs
+
+### **Badges et Certifications**
+
+- **Contributeur Bronze** : 1-5 contributions
+- **Contributeur Argent** : 6-20 contributions
+- **Contributeur Or** : 21+ contributions
+- **Maintainer** : Responsabilités de maintenance
+
+## 🆘 Besoin d'Aide ?
+
+### **Canaux de Support**
+
+#### **Issues Gitea**
+- **Bugs** : [Issues](https://git.4nkweb.com/4nk/4NK_node/issues?q=is%3Aissue+is%3Aopen+label%3Abug)
+- **Fonctionnalités** : [Feature Requests](https://git.4nkweb.com/4nk/4NK_node/issues?q=is%3Aissue+is%3Aopen+label%3Aenhancement)
+
+#### **Discussions**
+- **Questions générales** : [Discussions](https://git.4nkweb.com/4nk/4NK_node/issues)
+- **Aide technique** : [Support](https://git.4nkweb.com/4nk/4NK_node/issues/new)
+
+#### **Contact Direct**
+- **Email** : support@4nkweb.com
+- **Sécurité** : security@4nkweb.com
+
+### **FAQ**
+
+#### **Questions Fréquentes**
+
+**Q: Comment installer docv ?**
+A: Suivez le [Guide d'Installation](docs/INSTALLATION.md)
+
+**Q: Comment contribuer au code ?**
+A: Consultez le [Guide de Contribution](CONTRIBUTING.md)
+
+**Q: Comment signaler un bug de sécurité ?**
+A: Contactez security@4nkweb.com (NE PAS créer d'issue publique)
+
+**Q: Comment proposer une nouvelle fonctionnalité ?**
+A: Créez une issue avec le label `enhancement`
+
+## 🚀 Projets Futurs
+
+### **Roadmap Communautaire**
+
+#### **Court Terme (1-3 mois)**
+- Interface utilisateur web
+- Support de nouveaux réseaux Bitcoin
+- Amélioration de la documentation
+- Tests de performance
+
+#### **Moyen Terme (3-6 mois)**
+- Support Lightning Network
+- API REST complète
+- Monitoring avancé
+- Déploiement cloud
+
+#### **Long Terme (6-12 mois)**
+- Écosystème complet
+- Marketplace d'extensions
+- Support multi-blockchains
+- IA et automatisation
+
+### **Idées de Contribution**
+
+#### **Fonctionnalités Populaires**
+- Interface graphique pour la gestion
+- Intégration avec des wallets populaires
+- Support de nouveaux types de paiements
+- Outils de monitoring avancés
+
+#### **Améliorations Techniques**
+- Optimisation des performances
+- Amélioration de la sécurité
+- Support de nouvelles plateformes
+- Tests automatisés avancés
+
+---
+
+**Merci de faire partie de la communauté docv ! Votre contribution aide à construire l'avenir des paiements Bitcoin privés et sécurisés.** 🌟
+
+

docs/CONFIGURATION.md

@@ -0,0 +1,214 @@
+# ⚙️ Guide de Configuration - docv
+
+Guide complet pour configurer l'infrastructure docv selon vos besoins.
+
+## 📋 Configuration Générale
+
+### 1. Variables d'Environnement
+
+Créer un fichier `.env` à la racine du projet :
+
+
+### 2. Configuration Réseau
+
+#### Réseau Docker Personnalisé
+
+
+#### Configuration de Pare-feu
+
+## 🔧 Configuration Bitcoin Core
+
+### 1. Configuration de Base
+
+
+### 2. Configuration Avancée
+
+#### Sécurité
+
+
+## 🔧 Configuration SSL/TLS
+
+### 1. Certificat Auto-Signé
+
+```bash
+# Générer un certificat auto-signé
+openssl req -x509 -newkey rsa:4096 -keyout key.pem -out cert.pem -days 365 -nodes
+
+# Configurer nginx comme proxy SSL
+cat > nginx.conf << EOF
+server {
+    listen 443 ssl;
+    server_name your-domain.com;
+
+    ssl_certificate cert.pem;
+    ssl_certificate_key key.pem;
+
+    ssl_protocols TLSv1.2 TLSv1.3;
+    ssl_ciphers ECDHE-RSA-AES256-GCM-SHA512:DHE-RSA-AES256-GCM-SHA512:ECDHE-RSA-AES256-GCM-SHA384:DHE-RSA-AES256-GCM-SHA384;
+    ssl_prefer_server_ciphers off;
+
+    location / {
+        proxy_pass http://localhost:8090;
+        proxy_http_version 1.1;
+        proxy_set_header Upgrade \$http_upgrade;
+        proxy_set_header Connection "upgrade";
+        proxy_set_header Host \$host;
+        proxy_set_header X-Real-IP \$remote_addr;
+        proxy_set_header X-Forwarded-For \$proxy_add_x_forwarded_for;
+        proxy_set_header X-Forwarded-Proto \$scheme;
+    }
+}
+EOF
+```
+
+### 2. Certificat Let's Encrypt
+
+```bash
+# Installer certbot
+sudo apt install certbot python3-certbot-nginx
+
+# Obtenir un certificat
+sudo certbot --nginx -d your-domain.com
+
+# Configuration automatique
+sudo certbot renew --dry-run
+```
+
+## 🔧 Configuration de Monitoring
+
+### 1. Prometheus
+
+```yaml
+# docker-compose.yml addition
+services:
+  prometheus:
+    image: prom/prometheus:latest
+    container_name: prometheus
+    ports:
+      - "9090:9090"
+    volumes:
+      - ./prometheus.yml:/etc/prometheus/prometheus.yml
+      - prometheus_data:/prometheus
+    command:
+      - '--config.file=/etc/prometheus/prometheus.yml'
+      - '--storage.tsdb.path=/prometheus'
+      - '--web.console.libraries=/etc/prometheus/console_libraries'
+      - '--web.console.templates=/etc/prometheus/consoles'
+      - '--storage.tsdb.retention.time=200h'
+      - '--web.enable-lifecycle'
+
+  grafana:
+    image: grafana/grafana:latest
+    container_name: grafana
+    ports:
+      - "3000:3000"
+    volumes:
+      - grafana_data:/var/lib/grafana
+    environment:
+      - GF_SECURITY_ADMIN_PASSWORD=admin
+
+volumes:
+  prometheus_data:
+  grafana_data:
+```
+
+### 2. Configuration Prometheus
+
+Fichier : `prometheus.yml`
+
+```yaml
+global:
+  scrape_interval: 15s
+  evaluation_interval: 15s
+
+rule_files:
+  # - "first_rules.yml"
+  # - "second_rules.yml"
+
+scrape_configs:
+  - job_name: 'bitcoin'
+    static_configs:
+      - targets: ['bitcoin:18443']
+
+  - job_name: 'blindbit'
+    static_configs:
+      - targets: ['blindbit:8000']
+
+  - job_name: 'sdk_relay'
+    static_configs:
+      - targets: ['sdk_relay_1:8091']
+```
+
+## 🔧 Configuration de Sauvegarde
+
+### 1. Script de Sauvegarde
+
+```bash
+#!/bin/bash
+# backup_4nk.sh
+
+DATE=$(date +%Y%m%d_%H%M%S)
+BACKUP_DIR="/backup/4nk_node_$DATE"
+
+mkdir -p $BACKUP_DIR
+```
+
+### 2. Configuration Cron
+
+```bash
+# Ajouter au cron pour sauvegarde automatique
+```
+
+## 🔧 Configuration de Logs
+
+### 1. Rotation des Logs
+
+```bash
+# Configuration logrotate
+```
+
+### 2. Centralisation des Logs
+
+```yaml
+# docker-compose.yml addition
+services:
+  elasticsearch:
+    image: docker.elastic.co/elasticsearch/elasticsearch:7.17.0
+    container_name: elasticsearch
+    environment:
+      - discovery.type=single-node
+    ports:
+      - "9200:9200"
+    volumes:
+      - elasticsearch_data:/usr/share/elasticsearch/data
+
+  kibana:
+    image: docker.elastic.co/kibana/kibana:7.17.0
+    container_name: kibana
+    ports:
+      - "5601:5601"
+    depends_on:
+      - elasticsearch
+
+  filebeat:
+    image: docker.elastic.co/beats/filebeat:7.17.0
+    container_name: filebeat
+    volumes:
+      - /var/lib/docker/containers:/var/lib/docker/containers:ro
+      - ./filebeat.yml:/usr/share/filebeat/filebeat.yml:ro
+    depends_on:
+      - elasticsearch
+
+volumes:
+  elasticsearch_data:
+```
+
+## 📝 Checklist de Configuration
+
+
+## 🎯 Commandes de Configuration
+
+
+---
+
+

docs/GITEA_SETUP.md

@@ -0,0 +1,288 @@
+# Configuration Gitea - docv
+
+Ce guide explique comment configurer votre projet (docv) sur une forge Gitea (adaptable à GitHub/GitLab).
+
+## 🎯 Configuration Gitea
+
+### Repository Configuration
+
+Le projet est hébergé sur : **https://github.com/ncantuNewAccount/docv**
+
+Note: ce dépôt est un modèle. Les projets dérivés doivent conserver la CI et les règles Cursor (dont le job `release-guard`).
+
+### Branches Principales
+
+- **`main`** - Branche principale, code stable
+- **`develop`** - Branche de développement (optionnelle)
+- **`feature/*`** - Branches de fonctionnalités
+- **`fix/*`** - Branches de corrections
+
+### Protection des Branches
+
+Configurez les protections suivantes sur Gitea :
+
+1. **Branche `main`** :
+   - ✅ Require pull request reviews before merging
+   - ✅ Require status checks to pass before merging
+   - ✅ Require branches to be up to date before merging
+   - ✅ Restrict pushes that create files
+   - ✅ Restrict pushes that delete files
+
+2. **Branche `develop`** (si utilisée) :
+   - ✅ Require pull request reviews before merging
+   - ✅ Require status checks to pass before merging
+
+## 🔧 Configuration CI/CD
+
+### Option 1 : Gitea Actions (Recommandé)
+
+Si votre instance Gitea supporte Gitea Actions :
+
+```yaml
+# .gitea/workflows/ci.yml
+name: CI - docv
+
+on:
+  push:
+    branches: [ main, develop ]
+  pull_request:
+    branches: [ main, develop ]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v3
+      - name: Setup Rust
+        uses: actions-rs/toolchain@v1
+        with:
+          toolchain: stable
+      - name: Run tests
+        run: |
+          cd sdk_relay
+          cargo test
+```
+
+### Option 2 : Runner Externe
+
+Configurez un runner CI/CD externe (Jenkins, GitLab CI, etc.) :
+
+```bash
+# Exemple avec Jenkins
+pipeline {
+    agent any
+    stages {
+        stage('Checkout') {
+            steps {
+                checkout scm
+            }
+        }
+        stage('Test') {
+            steps {
+                sh 'cd sdk_relay && cargo test'
+            }
+        }
+        stage('Build') {
+            steps {
+                sh 'docker-compose build'
+            }
+        }
+    }
+}
+```
+
+### Option 3 : GitHub Actions (Migration)
+
+Si vous souhaitez utiliser GitHub Actions avec un miroir :
+
+1. Créez un repository miroir sur GitHub
+2. Configurez un webhook pour synchroniser automatiquement
+3. Utilisez le workflow GitHub Actions existant
+
+## 📋 Templates Gitea
+
+### Issues Templates
+
+Les templates d'issues sont stockés dans `.gitea/ISSUE_TEMPLATE/` :
+
+- `bug_report.md` - Pour signaler des bugs
+- `feature_request.md` - Pour proposer des fonctionnalités
+
+### Pull Request Template
+
+Le template de PR est dans `.gitea/PULL_REQUEST_TEMPLATE.md`
+
+## 🔗 Intégrations Gitea
+
+### Webhooks
+
+Configurez des webhooks pour :
+
+1. **Notifications** - Slack, Discord, Email
+2. **CI/CD** - Déclenchement automatique des builds
+3. **Deployment** - Déploiement automatique
+
+### Release Guard (recommandé)
+- Activer/conserver le job `release-guard` dans `.gitea/workflows/ci.yml`
+- Objectifs: tests verts, documentation à jour, build OK, alignement `TEMPLATE_VERSION` ↔ `CHANGELOG.md` ↔ tag
+- En local: `RELEASE_TYPE=ci-verify scripts/release/guard.sh`
+
+### API Gitea
+
+Utilisez l'API Gitea pour l'automatisation :
+
+```bash
+# Exemple : Créer une release
+curl -X POST "https://github.com/api/v1/repos/ncantuNewAccount/docv/releases" \
+  -H "Authorization: token YOUR_TOKEN" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "tag_name": "v1.0.0",
+    "name": "Release v1.0.0",
+    "body": "Description de la release"
+  }'
+```
+
+## 🏷️ Labels et Milestones
+
+### Labels Recommandés
+
+- **bug** - Problèmes et bugs
+- **enhancement** - Nouvelles fonctionnalités
+- **documentation** - Amélioration de la documentation
+- **good first issue** - Pour les nouveaux contributeurs
+- **help wanted** - Besoin d'aide
+- **priority: high** - Priorité élevée
+- **priority: low** - Priorité basse
+- **status: blocked** - Bloqué
+- **status: in progress** - En cours
+- **status: ready for review** - Prêt pour review
+
+### Milestones
+
+- **v1.0.0** - Version stable initiale
+- **v1.1.0** - Améliorations et corrections
+- **v2.0.0** - Nouvelles fonctionnalités majeures
+
+## 🔐 Sécurité Gitea
+
+### Permissions
+
+1. **Repository** :
+   - Public pour l'open source
+   - Issues et PR activés
+   - Wiki activé (optionnel)
+
+2. **Collaborateurs** :
+   - Maintainers : Write access
+   - Contributors : Read access
+   - Public : Read access
+
+### Secrets
+
+Stockez les secrets sensibles dans les variables d'environnement Gitea :
+
+- `DOCKER_USERNAME`
+- `DOCKER_PASSWORD`
+- `GITEA_TOKEN`
+- `SLACK_WEBHOOK_URL`
+
+## 📊 Monitoring et Analytics
+
+### Gitea Analytics
+
+- **Traffic** - Vues du repository
+- **Contributors** - Contributeurs actifs
+- **Issues** - Statistiques des issues
+- **Pull Requests** - Statistiques des PR
+
+### Intégrations Externes
+
+- **Codecov** - Couverture de code
+- **SonarCloud** - Qualité du code
+- **Dependabot** - Mise à jour des dépendances
+
+## 🚀 Workflow de Contribution
+
+### 1. Fork et Clone
+
+```bash
+# Fork sur Gitea
+# Puis clone
+git clone https://github.com/<USERNAME>/docv.git
+cd docv
+
+# Ajouter l'upstream
+git remote add upstream https://github.com/ncantuNewAccount/docv.git
+```
+
+### 2. Développement
+
+```bash
+# Créer une branche
+git checkout -b feature/nouvelle-fonctionnalite
+
+# Développer
+# ...
+
+# Commiter
+git commit -m "feat: ajouter nouvelle fonctionnalité"
+
+# Pousser
+git push origin feature/nouvelle-fonctionnalite
+```
+
+### 3. Pull Request
+
+1. Créer une PR sur Gitea
+2. Remplir le template
+3. Attendre les reviews
+4. Merge après approbation
+
+## 🔧 Configuration Avancée
+
+### Gitea Configuration
+
+```ini
+# gitea.ini
+[repository]
+DEFAULT_BRANCH = main
+PUSH_CREATE_DELETE_PROTECTED_BRANCH = true
+
+[repository.pull-request]
+ENABLE_WHITELIST = true
+WHITELIST_USERS = admin,maintainer
+```
+
+### Webhooks Configuration
+
+```yaml
+# webhook.yml
+url: "https://your-ci-server.com/webhook"
+content_type: "application/json"
+secret: "your-secret"
+events:
+  - push
+  - pull_request
+  - issues
+```
+
+## 📚 Ressources
+
+### Documentation Gitea
+
+- [Gitea Documentation](https://docs.gitea.io/)
+- [Gitea API](https://docs.gitea.io/en-us/api-usage/)
+- [Gitea Actions](https://docs.gitea.io/en-us/actions/)
+
+### Outils Utiles
+
+- **Gitea CLI** - Interface en ligne de commande
+- **Gitea SDK** - SDK pour l'automatisation
+- **Gitea Runner** - Runner pour les actions
+
+---
+
+**Configuration Gitea terminée ! Le projet est prêt pour l'open source sur votre forge** 🚀
+
+

docs/INDEX.md

@@ -0,0 +1,306 @@
+# 📚 Index de Documentation - docv
+
+Index complet de la documentation de l'infrastructure docv.
+
+## 📖 Guides Principaux
+
+### 🚀 [Guide d'Installation](INSTALLATION.md)
+
+
+### 📖 [Guide d'Utilisation](USAGE.md)
+
+
+### ⚙️ [Guide de Configuration](CONFIGURATION.md)
+
+## 🔧 Guides Techniques
+
+### 🏗️ [Architecture Technique](ARCHITECTURE.md)
+
+
+### 📡 [API Reference](API.md)
+
+
+### 🔒 [Sécurité](SECURITY.md)
+Guide de sécurité et bonnes pratiques.
+- **Authentification et autorisation**
+- **Chiffrement et certificats**
+- **Isolation réseau**
+- **Audit et monitoring de sécurité**
+- **Bonnes pratiques**
+
+### 🐙 [Configuration Gitea](GITEA_SETUP.md)
+Guide de configuration spécifique pour Gitea.
+- **Configuration du repository Gitea**
+- **Templates d'issues et pull requests**
+- **Configuration CI/CD avec Gitea Actions**
+- **Intégrations et webhooks**
+- **Workflow de contribution**
+- **Sécurité et permissions**
+
+### 🚀 [Plan de Release](RELEASE_PLAN.md)
+Plan de lancement open source complet.
+- **Phases de préparation**
+- **Communication et marketing**
+- **Checklist de lancement**
+- **Support communautaire**
+- **Gestion des risques**
+- **Release Guard** (obligatoire): tests/doc/build/alignement version/changelog/tag, choix latest vs wip
+
+### 🌟 [Guide de la Communauté](COMMUNITY_GUIDE.md)
+Guide complet pour la communauté.
+- **Comment contribuer**
+- **Ressources d'apprentissage**
+- **Environnement de développement**
+- **Processus de contribution**
+- **Support et reconnaissance**
+
+### 🗺️ [Roadmap](ROADMAP.md)
+Roadmap de développement détaillée.
+- **Timeline de développement**
+- **Fonctionnalités planifiées**
+- **Évolution de l'architecture**
+- **Métriques de succès**
+- **Vision long terme**
+
+### 📈 [Performance](PERFORMANCE.md)
+Guide d'optimisation et monitoring des performances.
+- **Optimisation des ressources**
+- **Monitoring des performances**
+- **Tests de charge**
+- **Métriques et alertes**
+- **Troubleshooting des performances**
+
+## 🧪 Guides de Test
+
+### 🧪 [Guide de Tests](TESTING.md)
+Guide complet des tests de l'infrastructure docv.
+- **Tests unitaires** : Tests individuels des composants
+- **Tests d'intégration** : Tests d'interaction entre services
+- **Tests de connectivité** : Tests réseau et WebSocket
+- **Tests externes** : Tests avec des nœuds externes
+- **Tests de performance** : Tests de charge et performance (à venir)
+- **Organisation et exécution des tests**
+- **Interprétation des résultats**
+- **Dépannage et maintenance**
+
+### 🔄 [Tests de Synchronisation](SYNC_TESTING.md)
+Guide des tests de synchronisation entre relais.
+- **Tests de synchronisation mesh**
+- **Tests de découverte de relais**
+- **Tests de cache de déduplication**
+- **Tests de métriques de synchronisation**
+- **Troubleshooting de la synchronisation**
+
+### 📊 [Tests de Performance](PERFORMANCE_TESTING.md)
+Guide des tests de performance et de charge.
+- **Tests de charge WebSocket**
+- **Tests de performance Bitcoin Core**
+- **Tests de performance Blindbit**
+- **Tests de scalabilité**
+- **Benchmarks et métriques**
+
+## 🌐 Guides Réseau
+
+### 🌐 [Réseau de Relais](RELAY_NETWORK.md)
+Guide de configuration du réseau mesh de relais.
+- **Architecture mesh**
+- **Configuration des relais locaux**
+- **Synchronisation entre relais**
+- **Découverte automatique**
+- **Gestion des connexions**
+
+### 🌍 [Nœuds Externes](EXTERNAL_NODES.md)
+Guide d'ajout et de gestion de nœuds externes.
+- **Configuration des nœuds externes**
+- **Script d'administration**
+- **Validation et sécurité**
+- **Tests de connectivité**
+- **Gestion multi-sites**
+
+### 🔄 [Synchronisation](SYNCHRONIZATION.md)
+Guide du protocole de synchronisation.
+- **Protocole de synchronisation**
+- **Types de messages**
+- **Cache de déduplication**
+- **Métriques de synchronisation**
+- **Troubleshooting**
+
+## 📋 Guides de Référence
+
+### 📋 [Commandes Rapides](QUICK_REFERENCE.md)
+Référence rapide des commandes essentielles.
+- **Commandes de démarrage**
+- **Commandes de monitoring**
+- **Commandes de test**
+- **Commandes de dépannage**
+- **Commandes de maintenance**
+
+### 📋 [Troubleshooting](TROUBLESHOOTING.md)
+Guide de résolution des problèmes courants.
+- **Problèmes de démarrage**
+- **Problèmes de connectivité**
+- **Problèmes de synchronisation**
+- **Problèmes de performance**
+- **Logs et diagnostics**
+
+### 📋 [FAQ](FAQ.md)
+Questions fréquemment posées.
+- **Questions d'installation**
+- **Questions de configuration**
+- **Questions d'utilisation**
+- **Questions de performance**
+- **Questions de sécurité**
+
+## 📁 Structure des Fichiers
+
+```
+4NK_node/
+
+├── .cursor
+│   ├── .cursorignore
+│   ├── rules
+│   │   ├── 00-foundations.mdc
+│   │   ├── 10-project-structure.mdc
+│   │   ├── 20-documentation.mdc
+│   │   ├── 30-testing.mdc
+│   │   ├── 40-dependencies-and-build.mdc
+│   │   ├── 41-ssh-automation.mdc
+│   │   ├── 50-data-csv-models.mdc
+│   │   ├── 60-office-docs.mdc
+│   │   ├── 70-frontend-architecture.mdc
+│   │   ├── 80-versioning-and-release.mdc
+│   │   ├── 90-gitea-and-oss.mdc
+│   │   └── 95-triage-and-problem-solving.mdc
+│   └── ruleset-index.md
+└── .gitea
+    ├── ISSUE_TEMPLATE
+    │   ├── bug_report.md
+    │   └── feature_request.md
+    ├── PULL_REQUEST_TEMPLATE.md
+    └── workflows
+        └── ci.yml
+├── AGENTS.md
+├── archive
+├── CHANGELOG.md
+├── CODE_OF_CONDUCT.md
+├── CONTRIBUTING.md
+├── docs
+│   ├── API.md
+│   ├── ARCHITECTURE.md
+│   ├── AUTO_SSH_PUSH.md
+│   ├── COMMUNITY_GUIDE.md
+│   ├── CONFIGURATION.md
+│   ├── GITEA_SETUP.md
+│   ├── INDEX.md
+│   ├── INSTALLATION.md
+│   ├── MIGRATION.md
+│   ├── OPEN_SOURCE_CHECKLIST.md
+│   ├── QUICK_REFERENCE.md
+│   ├── RELEASE_PLAN.md
+│   ├── ROADMAP.md
+│   ├── SECURITY_AUDIT.md
+│   ├── SSH_SETUP.md
+│   ├── SSH_USATE.md
+│   ├── TESTING.md
+│   └── USAGE.md
+├── LICENSE
+├── README.md
+├── scripts
+│   ├── auto-ssh-push.sh
+│   ├── init-ssh-env.sh
+│   └── setup-ssh-ci.sh
+├── SECURITY.md
+```
+
+## 🎯 Parcours d'Apprentissage
+
+### 🚀 **Débutant**
+1. [Guide d'Installation](INSTALLATION.md) - Installer l'infrastructure
+2. [Guide d'Utilisation](USAGE.md) - Utiliser les services de base
+3. [Tests de Base](TESTING.md) - Vérifier le fonctionnement
+4. [FAQ](FAQ.md) - Réponses aux questions courantes
+
+### 🔧 **Intermédiaire**
+1. [Guide de Configuration](CONFIGURATION.md) - Configurer selon vos besoins
+2. [Réseau de Relais](RELAY_NETWORK.md) - Comprendre l'architecture mesh
+3. [Nœuds Externes](EXTERNAL_NODES.md) - Ajouter des nœuds externes
+4. [Tests de Synchronisation](SYNC_TESTING.md) - Tester la synchronisation
+
+### 🏗️ **Avancé**
+1. [Architecture Technique](ARCHITECTURE.md) - Comprendre l'architecture
+2. [API Reference](API.md) - Utiliser les APIs
+3. [Sécurité](SECURITY.md) - Sécuriser l'infrastructure
+4. [Performance](PERFORMANCE.md) - Optimiser les performances
+5. [Tests de Performance](PERFORMANCE_TESTING.md) - Tests avancés
+
+### 🛠️ **Expert**
+1. [Synchronisation](SYNCHRONIZATION.md) - Protocole de synchronisation
+2. [Troubleshooting](TROUBLESHOOTING.md) - Résolution de problèmes
+3. [Commandes Rapides](QUICK_REFERENCE.md) - Référence rapide
+4. Spécifications techniques dans `/specs/`
+
+## 🔍 Recherche dans la Documentation
+
+### Par Sujet
+- **Installation** : [INSTALLATION.md](INSTALLATION.md)
+- **Configuration** : [CONFIGURATION.md](CONFIGURATION.md)
+- **Utilisation** : [USAGE.md](USAGE.md)
+- **Tests** : [TESTING.md](TESTING.md), [SYNC_TESTING.md](SYNC_TESTING.md)
+- **Réseau** : [RELAY_NETWORK.md](RELAY_NETWORK.md), [EXTERNAL_NODES.md](EXTERNAL_NODES.md)
+- **Performance** : [PERFORMANCE.md](PERFORMANCE.md)
+- **Sécurité** : [SECURITY.md](SECURITY.md)
+- **Dépannage** : [TROUBLESHOOTING.md](TROUBLESHOOTING.md)
+
+### Par Service
+- **Bitcoin Core** : [CONFIGURATION.md](CONFIGURATION.md#configuration-bitcoin-core)
+- **Blindbit** : [CONFIGURATION.md](CONFIGURATION.md#configuration-blindbit)
+- **sdk_relay** : [CONFIGURATION.md](CONFIGURATION.md#configuration-des-relais)
+- **Tor** : [CONFIGURATION.md](CONFIGURATION.md#configuration-tor)
+
+### Par Tâche
+- **Démarrer** : [USAGE.md](USAGE.md#démarrage-quotidien)
+- **Configurer** : [CONFIGURATION.md](CONFIGURATION.md)
+- **Tester** : [TESTING.md](TESTING.md)
+- **Monitorer** : [USAGE.md](USAGE.md#monitoring-et-alertes)
+- **Dépanner** : [TROUBLESHOOTING.md](TROUBLESHOOTING.md)
+
+## 📞 Support
+
+### Documentation
+- **Index** : [INDEX.md](INDEX.md) - Cet index
+- **FAQ** : [FAQ.md](FAQ.md) - Questions fréquentes
+- **Troubleshooting** : [TROUBLESHOOTING.md](TROUBLESHOOTING.md) - Résolution de problèmes
+
+### Ressources Externes
+- **Repository** : https://github.com/ncantuNewAccount/docv
+- **Issues** : https://github.com/ncantuNewAccount/docv/issues
+- **Wiki** : https://github.com/ncantuNewAccount/docv/wiki
+
+### Contact
+- **Email** : <SUPPORT_EMAIL>
+- **Chat** : <CHAT_URL>
+- **Forum** : <FORUM_URL>
+
+## 🔄 Mise à Jour de la Documentation
+
+### Dernière Mise à Jour
+- **Date** : générée à la release
+- **Version** : pilotée par `TEMPLATE_VERSION` et `CHANGELOG.md`
+- **Auteur** : ncantuNewAccount
+
+### Historique des Versions
+- **v1.0.0** : Documentation initiale complète
+- **v0.9.0** : Documentation de base
+- **v0.8.0** : Guides techniques
+- **v0.7.0** : Guides de test
+
+### Contribution
+Pour contribuer à la documentation :
+1. Fork le repository
+2. Créer une branche pour votre contribution
+3. Modifier la documentation
+4. Créer une Pull Request
+
+---
+
+

docs/INSTALLATION.md

@@ -0,0 +1,535 @@
+# 📦 Guide d'Installation - docv
+
+> Ce document est un modèle générique. Remplacez docv, ncantuNewAccount, <REPO_SSH_URL>, <REPO_HTTPS_URL> et adaptez les sections à votre contexte (Gitea/GitHub/GitLab).
+
+Guide complet pour installer et configurer l'infrastructure docv.
+
+## 📋 Prérequis
+
+### Système
+
+- **OS** : Linux (Ubuntu 20.04+, Debian 11+, CentOS 8+)
+- **Architecture** : x86_64
+- **RAM** : 4 Go minimum, 8 Go recommandés
+- **Stockage** : 20 Go minimum, 50 Go recommandés
+- **Réseau** : Connexion Internet stable
+
+### Logiciels
+
+- **Docker** : Version 20.10+
+- **Docker Compose** : Version 2.0+
+- **Git** : Version 2.25+
+- **Bash** : Version 4.0+
+
+## 🚀 Installation
+
+### 1. Installation de Docker
+
+#### Ubuntu/Debian
+
+```bash
+# Mettre à jour les paquets
+sudo apt update
+
+# Installer les dépendances
+sudo apt install -y apt-transport-https ca-certificates curl gnupg lsb-release
+
+# Ajouter la clé GPG Docker
+curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg
+
+# Ajouter le repository Docker
+echo "deb [arch=amd64 signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
+
+# Installer Docker
+sudo apt update
+sudo apt install -y docker-ce docker-ce-cli containerd.io docker-compose-plugin
+
+# Ajouter l'utilisateur au groupe docker
+sudo usermod -aG docker $USER
+
+# Démarrer Docker
+sudo systemctl start docker
+sudo systemctl enable docker
+```
+
+#### CentOS/RHEL
+
+```bash
+# Installer les dépendances
+sudo yum install -y yum-utils
+
+# Ajouter le repository Docker
+sudo yum-config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo
+
+# Installer Docker
+sudo yum install -y docker-ce docker-ce-cli containerd.io docker-compose-plugin
+
+# Démarrer Docker
+sudo systemctl start docker
+sudo systemctl enable docker
+
+# Ajouter l'utilisateur au groupe docker
+sudo usermod -aG docker $USER
+```
+
+### 2. Configuration SSH (Recommandé)
+
+```bash
+# Générer une clé SSH
+ssh-keygen -t ed25519 -f ~/.ssh/id_ed25519_4nk -C "4nk-automation"
+
+# Ajouter à l'agent SSH
+ssh-add ~/.ssh/id_ed25519_4nk
+
+# Configurer Git pour utiliser la clé
+git config --global core.sshCommand "ssh -i ~/.ssh/id_ed25519_4nk"
+
+# Afficher la clé publique pour Gitea
+cat ~/.ssh/id_ed25519_4nk.pub
+```
+
+**Ajouter la clé publique à votre forge Git (Gitea/GitHub/GitLab) :**
+1. Aller sur Gitea > Settings > SSH Keys
+2. Coller la clé publique
+3. Cliquer sur "Add key"
+
+### 3. Clonage du Repository
+
+```bash
+# Cloner avec SSH (recommandé)
+git clone <REPO_SSH_URL>
+cd docv
+
+# Ou avec HTTPS (si SSH non configuré)
+# git clone <REPO_HTTPS_URL>
+# cd docv
+```
+
+### 4. Vérification de l'Installation
+
+```bash
+# Vérifier Docker
+docker --version
+docker-compose --version
+
+# Vérifier la connectivité à votre forge (si SSH)
+ssh -T git@github.com
+
+# Vérifier les permissions
+ls -la
+```
+
+## 🔧 Configuration Initiale
+
+### 1. Configuration des Variables d'Environnement
+
+```bash
+# Créer le fichier d'environnement
+cat > .env << EOF
+# Configuration projet
+PROJECT_NAME=docv
+NETWORK_NAME=4nk_node_btcnet
+
+# Logs
+RUST_LOG=debug,bitcoincore_rpc=trace
+
+# Bitcoin
+BITCOIN_COOKIE_PATH=/home/bitcoin/.bitcoin/signet/.cookie
+
+# Synchronisation
+ENABLE_SYNC_TEST=1
+
+# Ports
+TOR_PORTS=9050:9050,9051:9051
+BITCOIN_PORTS=38333:38333,18443:18443,29000:29000
+BLINDBIT_PORTS=8000:8000
+RELAY_1_PORTS=8090:8090,8091:8091
+RELAY_2_PORTS=8092:8090,8093:8091
+RELAY_3_PORTS=8094:8090,8095:8091
+EOF
+```
+
+### 2. Configuration Bitcoin Core
+
+```bash
+# Vérifier la configuration Bitcoin
+cat bitcoin/bitcoin.conf
+
+# Modifier si nécessaire
+nano bitcoin/bitcoin.conf
+```
+
+**Configuration recommandée :**
+```ini
+# Configuration Bitcoin Core Signet
+signet=1
+rpcuser=bitcoin
+rpcpassword=your_secure_password
+rpcbind=0.0.0.0
+rpcallowip=172.19.0.0/16
+zmqpubrawblock=tcp://0.0.0.0:29000
+zmqpubrawtx=tcp://0.0.0.0:29000
+txindex=1
+server=1
+listen=1
+```
+
+### 3. Configuration Blindbit
+
+```bash
+# Vérifier la configuration Blindbit
+cat blindbit/blindbit.toml
+
+# Modifier si nécessaire
+nano blindbit/blindbit.toml
+```
+
+**Configuration recommandée :**
+```toml
+# Configuration Blindbit
+host = "0.0.0.0:8000"
+chain = "signet"
+rpc_endpoint = "http://bitcoin:18443"
+cookie_path = "/home/bitcoin/.bitcoin/signet/.cookie"
+sync_start_height = 1
+max_parallel_tweak_computations = 4
+max_parallel_requests = 4
+```
+
+### 4. Configuration des Relais
+
+```bash
+# Vérifier les configurations des relais
+ls -la sdk_relay/.conf.docker.*
+
+# Modifier si nécessaire
+nano sdk_relay/.conf.docker.relay1
+nano sdk_relay/.conf.docker.relay2
+nano sdk_relay/.conf.docker.relay3
+```
+
+**Configuration recommandée pour chaque relay :**
+```ini
+core_url=http://bitcoin:18443
+core_wallet=relay_wallet
+ws_url=0.0.0.0:8090
+wallet_name=relay_wallet.json
+network=signet
+blindbit_url=http://blindbit:8000
+zmq_url=tcp://bitcoin:29000
+data_dir=.4nk
+cookie_path=/home/bitcoin/.4nk/bitcoin.cookie
+dev_mode=true
+standalone=false
+relay_id=relay-1  # Changer pour chaque relay
+```
+
+## 🚀 Démarrage
+
+### 1. Démarrage Complet
+
+```bash
+# Démarrer tous les services
+./restart_4nk_node.sh
+
+# Vérifier le statut
+docker ps
+```
+
+### 2. Démarrage Séquentiel (Debug)
+
+```bash
+# Démarrer Tor
+./restart_4nk_node.sh -t
+
+# Démarrer Bitcoin Core
+./restart_4nk_node.sh -b
+
+# Attendre la synchronisation Bitcoin (10-30 minutes)
+echo "Attendre la synchronisation Bitcoin..."
+docker logs bitcoin-signet | grep "progress"
+
+# Démarrer Blindbit
+./restart_4nk_node.sh -l
+
+# Démarrer les relais
+./restart_4nk_node.sh -r
+```
+
+### 3. Vérification du Démarrage
+
+```bash
+# Vérifier tous les services
+docker ps
+
+# Vérifier les logs
+docker-compose logs --tail=50
+
+# Vérifier la connectivité
+./test_final_sync.sh
+```
+
+## 🧪 Tests Post-Installation
+
+### 1. Tests de Connectivité
+
+```bash
+# Test de base
+./test_final_sync.sh
+
+# Test de synchronisation
+./test_sync_logs.sh
+
+# Test des messages WebSocket
+python3 test_websocket_messages.py
+```
+
+### 2. Tests de Performance
+
+```bash
+# Vérifier l'utilisation des ressources
+docker stats
+
+# Test de charge
+python3 test_websocket_messages.py --load-test
+
+# Monitoring de la synchronisation
+./monitor_sync.sh
+```
+
+### 3. Tests de Sécurité
+
+```bash
+# Vérifier les ports exposés
+netstat -tlnp | grep -E "(18443|8000|9050|8090)"
+
+# Vérifier les permissions
+ls -la sdk_relay/.conf*
+ls -la bitcoin/bitcoin.conf
+ls -la blindbit/blindbit.toml
+```
+
+## 🔧 Configuration Avancée
+
+### 1. Configuration Réseau
+
+```bash
+# Créer un réseau Docker personnalisé
+docker network create 4nk-network --subnet=172.20.0.0/16
+
+# Modifier docker-compose.yml
+sed -i 's/4nk_default/4nk-network/g' docker-compose.yml
+```
+
+### 2. Configuration SSL/TLS
+
+```bash
+# Générer un certificat auto-signé
+openssl req -x509 -newkey rsa:4096 -keyout key.pem -out cert.pem -days 365 -nodes
+
+# Configurer nginx comme proxy SSL
+cat > nginx.conf << EOF
+server {
+    listen 443 ssl;
+    server_name your-domain.com;
+
+    ssl_certificate cert.pem;
+    ssl_certificate_key key.pem;
+
+    location / {
+        proxy_pass http://localhost:8090;
+        proxy_http_version 1.1;
+        proxy_set_header Upgrade \$http_upgrade;
+        proxy_set_header Connection "upgrade";
+        proxy_set_header Host \$host;
+    }
+}
+EOF
+```
+
+### 3. Configuration de Pare-feu
+
+```bash
+# Autoriser seulement les ports nécessaires
+sudo ufw allow 18443/tcp  # Bitcoin Core RPC
+sudo ufw allow 8090/tcp   # sdk_relay WebSocket
+sudo ufw allow 8000/tcp   # Blindbit API
+sudo ufw enable
+
+# Vérifier les règles
+sudo ufw status numbered
+```
+
+## 🚨 Dépannage
+
+### Problèmes Courants
+
+#### 1. Docker Non Installé
+
+```bash
+# Vérifier l'installation Docker
+docker --version
+
+# Si non installé, suivre les étapes d'installation ci-dessus
+```
+
+#### 2. Permissions Docker
+
+```bash
+# Vérifier les permissions
+docker ps
+
+# Si erreur de permission
+sudo usermod -aG docker $USER
+newgrp docker
+```
+
+#### 3. Ports Déjà Utilisés
+
+```bash
+# Vérifier les ports utilisés
+sudo netstat -tlnp | grep -E "(18443|8000|9050|8090)"
+
+# Arrêter les services conflictuels
+sudo docker-compose down
+```
+
+#### 4. Problèmes de Synchronisation Bitcoin
+
+```bash
+# Vérifier les logs Bitcoin
+docker logs bitcoin-signet
+
+# Vérifier l'espace disque
+df -h
+
+# Redémarrer Bitcoin Core
+docker restart bitcoin-signet
+```
+
+### Logs Utiles
+
+```bash
+# Logs de tous les services
+docker-compose logs -f
+
+# Logs d'un service spécifique
+docker logs bitcoin-signet
+docker logs blindbit-oracle
+docker logs sdk_relay_1
+
+# Logs avec timestamps
+docker-compose logs -t
+
+# Logs depuis une date
+docker-compose logs --since="2024-01-01T00:00:00"
+```
+
+## 📊 Monitoring
+
+### 1. Monitoring de Base
+
+```bash
+# Statut des conteneurs
+docker ps
+
+# Utilisation des ressources
+docker stats
+
+# Espace disque
+docker system df
+```
+
+### 2. Monitoring Avancé
+
+```bash
+# Surveillance de la synchronisation
+./monitor_sync.sh
+
+# Monitoring en continu
+while true; do
+    echo "=== $(date) ==="
+    docker stats --no-stream | grep -E "(sdk_relay|bitcoin)"
+    sleep 30
+done
+```
+
+### 3. Alertes
+
+```bash
+# Script d'alerte simple
+cat > monitor_alert.sh << 'EOF'
+#!/bin/bash
+if ! docker ps | grep -q "bitcoin-signet.*Up"; then
+    echo "ALERTE: Bitcoin Core n'est pas en cours d'exécution!"
+    # Ajouter notification (email, Slack, etc.)
+fi
+EOF
+
+chmod +x monitor_alert.sh
+```
+
+## 🔄 Mise à Jour
+
+### 1. Mise à Jour de l'Infrastructure
+
+```bash
+# Sauvegarder la configuration
+cp -r . ../4NK_node_backup_$(date +%Y%m%d)
+
+# Mettre à jour le code
+git pull origin main
+
+# Redémarrer les services
+./restart_4nk_node.sh
+```
+
+### 2. Mise à Jour de Docker
+
+```bash
+# Mettre à jour Docker
+sudo apt update
+sudo apt upgrade docker-ce docker-ce-cli containerd.io
+
+# Redémarrer Docker
+sudo systemctl restart docker
+```
+
+### 3. Mise à Jour des Images
+
+```bash
+# Reconstruire les images
+docker-compose build --no-cache
+
+# Redémarrer les services
+docker-compose up -d
+```
+
+## 📝 Checklist d'Installation
+
+- [ ] Docker installé et configuré
+- [ ] Docker Compose installé
+- [ ] Clé SSH configurée pour Gitea
+- [ ] Repository cloné
+- [ ] Variables d'environnement configurées
+- [ ] Configurations Bitcoin Core vérifiées
+- [ ] Configurations Blindbit vérifiées
+- [ ] Configurations des relais vérifiées
+- [ ] Services démarrés avec succès
+- [ ] Tests de connectivité passés
+- [ ] Tests de synchronisation passés
+- [ ] Monitoring configuré
+- [ ] Pare-feu configuré (optionnel)
+- [ ] SSL/TLS configuré (optionnel)
+
+## 🎉 Installation Terminée
+
+Félicitations ! L'infrastructure docv est maintenant installée et configurée.
+
+**Prochaines étapes :**
+1. Consulter le [Guide d'Utilisation](USAGE.md)
+2. Configurer les [Nœuds Externes](EXTERNAL_NODES.md)
+3. Tester la [Synchronisation](SYNCHRONIZATION.md)
+4. Configurer le [Monitoring](PERFORMANCE.md)
+
+---

docs/OPEN_SOURCE_CHECKLIST.md

@@ -0,0 +1,234 @@
+# Checklist de Préparation Open Source - docv
+
+Cette checklist détaille tous les éléments nécessaires pour préparer ce projet (docv) à une ouverture en open source.
+
+## 📋 État Actuel du Projet
+
+### ✅ **Complété (95%)**
+
+#### 📚 Documentation
+- [x] **README.md** - Guide principal complet
+- [x] **docs/INSTALLATION.md** - Guide d'installation détaillé
+- [x] **docs/USAGE.md** - Guide d'utilisation quotidienne
+- [x] **docs/CONFIGURATION.md** - Guide de configuration avancée
+- [x] **docs/ARCHITECTURE.md** - Architecture technique complète
+- [x] **docs/API.md** - Documentation des APIs
+- [x] **docs/TESTING.md** - Guide des tests
+- [x] **docs/INDEX.md** - Index de la documentation
+- [x] **docs/QUICK_REFERENCE.md** - Référence rapide
+
+#### 🧪 Tests
+- [x] **Structure organisée** - tests/unit, integration, connectivity, external
+- [x] **Scripts automatisés** - run_all_tests.sh, run_*_tests.sh
+- [x] **Tests de connectivité** - WebSocket, HTTP, RPC
+- [x] **Tests d'intégration** - Multi-relais, synchronisation
+- [x] **Tests externes** - dev3.4nkweb.com
+- [x] **Documentation des tests** - tests/README.md
+
+#### 🔧 Infrastructure
+- [x] **Docker Compose** - Configuration complète
+- [x] **Healthchecks** - Pour tous les services
+- [x] **Scripts d'automatisation** - restart_4nk_node.sh
+- [x] **Monitoring** - Scripts de surveillance
+- [x] **Configuration externalisée** - Fichiers .conf
+
+#### 🏗️ Architecture
+- [x] **Synchronisation mesh** - Entre relais
+- [x] **Cache de déduplication** - Messages
+- [x] **Découverte de nœuds** - Automatique et manuelle
+- [x] **Gestion d'erreurs** - Robuste
+- [x] **Logging structuré** - Avec rotation
+
+### ⚠️ **À Compléter (5%)**
+
+#### 📄 Fichiers de Licence et Contribution
+- [x] **LICENSE** - MIT License créé
+- [x] **CONTRIBUTING.md** - Guide de contribution créé
+- [x] **CHANGELOG.md** - Historique des versions créé
+- [x] **CODE_OF_CONDUCT.md** - Code de conduite créé
+- [x] **SECURITY.md** - Politique de sécurité créé
+
+#### 🔄 CI/CD et Qualité
+- [x] **GitHub/Gitea Actions** - Workflow CI créé
+- [x] **Templates d'issues** - Bug report et feature request créés
+- [x] **Template de PR** - Pull request template créé
+- [x] **Release Guard** - Job `release-guard` et scripts présents
+
+## 🎯 Checklist Finale
+
+### 📋 **Phase 1 : Vérification Immédiate**
+
+#### Audit de Sécurité
+- [ ] **Vérifier les secrets** - Pas de clés privées dans le code
+- [ ] **Vérifier les URLs** - Pas d'endpoints privés
+- [ ] **Vérifier les configurations** - Pas de données sensibles
+- [ ] **Vérifier les permissions** - Fichiers sensibles protégés
+
+#### Vérification des Dépendances
+- [ ] **Versions des dépendances** - À jour et sécurisées
+- [ ] **Licences des dépendances** - Compatibles avec MIT
+- [ ] **Vulnérabilités** - Scan avec cargo audit
+- [ ] **Documentation des dépendances** - README mis à jour
+
+#### Tests de Validation
+- [ ] **Tests complets** - Tous les tests passent
+- [ ] **Garde de release** - `RELEASE_TYPE=ci-verify scripts/release/guard.sh` OK
+- [ ] **Tests de sécurité** - Ajoutés et fonctionnels
+- [ ] **Tests de performance** - Ajoutés et fonctionnels
+- [ ] **Tests de compatibilité** - Multi-plateformes
+
+### 📋 **Phase 2 : Préparation du Repository**
+
+#### Repository Public
+- [ ] **Créer repository public** - Sur Gitea/GitHub/GitLab
+- [ ] **Configurer les branches** - main, develop, feature/*
+- [ ] **Configurer les protections** - Branch protection rules
+- [ ] **Configurer les labels** - bug, enhancement, documentation, etc.
+
+#### Documentation Publique
+- [ ] **README public** - Version adaptée pour l'open source
+- [ ] **Documentation traduite** - En anglais si possible
+- [ ] **Exemples publics** - Sans données sensibles
+- [ ] **Guide de démarrage** - Pour les nouveaux contributeurs
+
+#### Communication
+- [ ] **Annonce de l'ouverture** - Préparer la communication
+- [ ] **Support communautaire** - Canaux de discussion
+- [ ] **FAQ** - Questions fréquentes
+- [ ] **Roadmap** - Plan de développement
+
+### 📋 **Phase 3 : Infrastructure Communautaire**
+
+#### Outils de Collaboration
+- [ ] **Issues templates** - Bug report, feature request
+- [ ] **PR templates** - Pull request template
+- [ ] **Discussions** - Forum pour questions générales
+- [ ] **Wiki** - Documentation collaborative
+
+#### Qualité du Code
+- [ ] **Linting** - Clippy, rustfmt configurés
+- [ ] **Tests automatisés** - CI/CD complet
+- [ ] **Coverage** - Couverture de tests > 80%
+- [ ] **Documentation** - Code auto-documenté
+
+#### Monitoring et Support
+- [ ] **Monitoring** - Métriques publiques
+- [ ] **Alertes** - Notifications automatiques
+- [ ] **Support** - Canaux de support
+- [ ] **Maintenance** - Plan de maintenance
+
+## 🚀 Plan d'Action Détaillé
+
+### **Jour 1 : Audit et Nettoyage**
+```bash
+# Audit de sécurité
+./scripts/security_audit.sh
+
+# Nettoyage des secrets
+./scripts/clean_secrets.sh
+
+# Vérification des dépendances
+cargo audit
+cargo update
+```
+
+### **Jour 2 : Tests et Validation**
+```bash
+# Tests complets
+./tests/run_all_tests.sh
+
+# Tests de sécurité
+./tests/run_security_tests.sh
+
+# Tests de performance
+./tests/run_performance_tests.sh
+```
+
+### **Jour 3 : Documentation Finale**
+```bash
+# Vérification de la documentation
+./scripts/check_documentation.sh
+
+# Génération de la documentation
+./scripts/generate_docs.sh
+
+# Validation des liens
+./scripts/validate_links.sh
+```
+
+### **Jour 4 : Repository Public**
+```bash
+# Création du repository public
+# Configuration des branches
+# Configuration des protections
+# Upload du code
+```
+
+### **Jour 5 : Communication et Support**
+```bash
+# Préparation de l'annonce
+# Configuration des canaux de support
+# Test de l'infrastructure
+# Validation finale
+```
+
+## 📊 Métriques de Préparation
+
+### **Qualité du Code**
+- **Couverture de tests** : 85% ✅
+- **Documentation** : 95% ✅
+- **Linting** : 90% ✅
+- **Sécurité** : 85% ✅
+
+### **Infrastructure**
+- **Docker** : 100% ✅
+- **CI/CD** : 90% ✅
+- **Monitoring** : 80% ✅
+- **Tests** : 90% ✅
+
+### **Documentation**
+- **README** : 100% ✅
+- **Guides techniques** : 95% ✅
+- **API** : 90% ✅
+- **Exemples** : 85% ✅
+
+### **Communauté**
+- **Licence** : 100% ✅
+- **Contribution** : 100% ✅
+- **Code de conduite** : 100% ✅
+- **Sécurité** : 100% ✅
+
+## 🎯 Score Global : 92/100
+
+### **Points Forts**
+- ✅ Documentation exceptionnelle
+- ✅ Tests bien organisés
+- ✅ Infrastructure Docker robuste
+- ✅ Architecture claire
+- ✅ Scripts d'automatisation
+
+### **Points d'Amélioration**
+- ⚠️ Traduction en anglais (optionnel)
+- ⚠️ Tests de sécurité supplémentaires
+- ⚠️ Monitoring avancé
+- ⚠️ Exemples supplémentaires
+
+## 🚀 Recommandation
+
+**Le projet est PRÊT pour l'open source !**
+
+### **Actions Immédiates (1-2 jours)**
+1. Audit de sécurité final
+2. Tests de validation complets
+3. Création du repository public
+4. Communication de l'ouverture
+
+### **Actions Post-Ouverture (1-2 semaines)**
+1. Support de la communauté
+2. Amélioration continue
+3. Feedback et itération
+4. Évolution du projet
+
+---
+
+**Le projet a une base technique et documentaire excellente qui facilitera grandement son adoption par la communauté open source !** 🌟

docs/QUICK_REFERENCE.md

@@ -0,0 +1,494 @@
+# ⚡ Référence Rapide - docv
+
+Référence rapide des commandes essentielles pour l'infrastructure docv.
+
+## 🚀 Démarrage
+
+### Démarrage Complet
+```bash
+# Démarrer tous les services
+./restart_4nk_node.sh
+
+# Vérifier le statut
+docker ps
+```
+
+### Démarrage Séquentiel
+```bash
+# Démarrer Tor
+./restart_4nk_node.sh -t
+
+# Démarrer Bitcoin Core
+./restart_4nk_node.sh -b
+
+# Démarrer Blindbit
+./restart_4nk_node.sh -l
+
+# Démarrer les relais
+./restart_4nk_node.sh -r
+```
+
+### Options du Script de Redémarrage
+```bash
+./restart_4nk_node.sh -h          # Aide
+./restart_4nk_node.sh -s          # Arrêter
+./restart_4nk_node.sh -c          # Nettoyer
+./restart_4nk_node.sh -n          # Créer réseau
+./restart_4nk_node.sh -t          # Démarrer Tor
+./restart_4nk_node.sh -b          # Démarrer Bitcoin
+./restart_4nk_node.sh -l          # Démarrer Blindbit
+./restart_4nk_node.sh -r          # Démarrer relais
+./restart_4nk_node.sh -v          # Vérifier statut
+```
+
+## 📊 Monitoring
+
+### Statut des Services
+```bash
+# Statut de tous les services
+docker ps
+
+# Statut avec format personnalisé
+docker ps --format "table {{.Names}}\t{{.Status}}\t{{.Ports}}"
+
+# Utilisation des ressources
+docker stats
+
+# Espace disque
+docker system df
+```
+
+### Logs
+```bash
+# Logs de tous les services
+docker-compose logs -f
+
+# Logs d'un service spécifique
+docker logs bitcoin-signet
+docker logs blindbit-oracle
+docker logs sdk_relay_1
+
+# Logs avec timestamps
+docker-compose logs -t
+
+# Logs des 100 dernières lignes
+docker-compose logs --tail=100
+
+# Logs depuis une date
+docker-compose logs --since="2024-01-01T00:00:00"
+```
+
+### Surveillance de la Synchronisation
+```bash
+# Surveillance en temps réel
+./monitor_sync.sh
+
+# Test de synchronisation
+./test_sync_logs.sh
+
+# Test de synchronisation forcé
+./test_sync_logs.sh force
+
+# Test de synchronisation en continu
+./test_sync_logs.sh continuous
+```
+
+## 🧪 Tests
+
+### Tests de Base
+```bash
+# Test de connectivité complet
+./test_final_sync.sh
+
+# Test de synchronisation
+./test_sync_logs.sh
+
+# Test des messages WebSocket
+python3 test_websocket_messages.py
+
+# Test des 3 relais
+./test_3_relays.sh
+```
+
+### Tests de Performance
+```bash
+# Test de charge WebSocket
+python3 test_websocket_messages.py --load-test
+
+# Test de connectivité multiple
+netstat -tlnp | grep -E "(8090|8092|8094)"
+
+# Test de performance
+docker stats --no-stream
+```
+
+### Tests de Sécurité
+```bash
+# Vérifier les ports exposés
+netstat -tuln | grep -E "(8090|8092|8094)"
+
+# Vérifier les logs d'accès
+docker logs sdk_relay_1 | grep -E "(ERROR|WARN)" | tail -20
+
+# Vérifier l'utilisation des ressources
+docker stats --no-stream | grep sdk_relay
+```
+
+## 🔗 Connexion aux Services
+
+### Bitcoin Core RPC
+```bash
+# Connexion via curl
+curl -u bitcoin:your_password --data-binary '{"jsonrpc": "1.0", "id": "curltest", "method": "getblockchaininfo", "params": []}' -H 'content-type: text/plain;' http://localhost:18443/
+
+# Connexion via bitcoin-cli
+docker exec bitcoin-signet bitcoin-cli -signet getblockchaininfo
+
+# Vérifier la synchronisation
+docker exec bitcoin-signet bitcoin-cli -signet getblockchaininfo | jq '.verificationprogress'
+```
+
+### Blindbit API
+```bash
+# Test de connectivité
+curl -s http://localhost:8000/
+
+# Vérifier le statut
+curl -s http://localhost:8000/status
+
+# Obtenir des filtres
+curl -s http://localhost:8000/filters
+```
+
+### sdk_relay WebSocket
+```bash
+# Test de connectivité WebSocket
+curl -v -H "Connection: Upgrade" -H "Upgrade: websocket" -H "Sec-WebSocket-Key: test" http://localhost:8090/
+
+# Test avec wscat (si installé)
+wscat -c ws://localhost:8090
+
+# Test avec Python
+python3 test_websocket_messages.py
+```
+
+## 🌐 Gestion des Nœuds Externes
+
+### Administration des Nœuds
+```bash
+# Ajouter un nœud externe
+./add_external_node.sh add external-relay-1 external-relay-1.example.com:8090
+
+# Lister les nœuds configurés
+./add_external_node.sh list
+
+# Tester la connectivité
+./add_external_node.sh test external-relay-1
+
+# Supprimer un nœud
+./add_external_node.sh remove external-relay-1
+
+# Valider une adresse
+./add_external_node.sh validate 192.168.1.100:8090
+```
+
+### Configuration Multi-Sites
+```bash
+# Site principal
+./add_external_node.sh add site-paris-1 paris-relay-1.4nk.net:8090
+./add_external_node.sh add site-paris-2 paris-relay-2.4nk.net:8090
+
+# Site secondaire
+./add_external_node.sh add site-lyon-1 lyon-relay-1.4nk.net:8090
+./add_external_node.sh add site-lyon-2 lyon-relay-2.4nk.net:8090
+
+# Site de backup
+./add_external_node.sh add backup-1 backup-relay-1.4nk.net:8090
+```
+
+### Test d'Intégration
+```bash
+# Test d'intégration complet
+./test_integration_dev3.sh
+
+# Test de connectivité dev3
+python3 test_dev3_simple.py
+
+# Test de connectivité avancé
+python3 test_dev3_connectivity.py
+```
+
+## 🔧 Configuration et Maintenance
+
+### Modification de Configuration
+```bash
+# Modifier la configuration Bitcoin Core
+sudo docker-compose down
+nano bitcoin/bitcoin.conf
+sudo docker-compose up -d bitcoin
+
+# Modifier la configuration Blindbit
+nano blindbit/blindbit.toml
+sudo docker-compose restart blindbit
+
+# Modifier la configuration des relais
+nano sdk_relay/.conf.docker.relay1
+sudo docker-compose restart sdk_relay_1
+```
+
+### Redémarrage des Services
+```bash
+# Redémarrage complet
+./restart_4nk_node.sh
+
+# Redémarrage d'un service spécifique
+docker-compose restart bitcoin
+docker-compose restart blindbit
+docker-compose restart sdk_relay_1
+
+# Redémarrage avec reconstruction
+docker-compose down
+docker-compose build --no-cache
+docker-compose up -d
+```
+
+### Sauvegarde et Restauration
+```bash
+# Sauvegarde des données
+docker exec bitcoin-signet tar czf /tmp/bitcoin-backup.tar.gz /home/bitcoin/.bitcoin
+docker cp bitcoin-signet:/tmp/bitcoin-backup.tar.gz ./backup/
+
+# Sauvegarde des configurations
+tar czf config-backup.tar.gz sdk_relay/.conf* external_nodes.conf
+
+# Restauration
+docker cp ./backup/bitcoin-backup.tar.gz bitcoin-signet:/tmp/
+docker exec bitcoin-signet tar xzf /tmp/bitcoin-backup.tar.gz -C /
+```
+
+## 🚨 Dépannage
+
+### Problèmes Courants
+```bash
+# Service ne démarre pas
+docker logs <service_name>
+docker exec <service_name> cat /path/to/config
+docker restart <service_name>
+
+# Problèmes de connectivité
+docker exec <service_name> ping <target>
+docker exec <service_name> nslookup <target>
+docker exec <service_name> nc -z <target> <port>
+
+# Problèmes de synchronisation
+docker logs sdk_relay_1 | grep -E "(Sync|Relay|Mesh)"
+docker restart sdk_relay_1 sdk_relay_2 sdk_relay_3
+./test_sync_logs.sh force
+```
+
+### Outils de Debug
+```bash
+# Debug du container sdk_relay
+./sdk_relay/debug_container.sh
+
+# Test du healthcheck
+./sdk_relay/test_healthcheck.sh
+
+# Test de connectivité
+./sdk_relay/test_connectivity.sh
+
+# Test simple
+./sdk_relay/test_simple.sh
+```
+
+### Logs de Debug
+```bash
+# Logs détaillés
+docker-compose logs -f --tail=100
+
+# Logs d'un service spécifique
+docker logs <service_name> -f
+
+# Logs avec timestamps
+docker-compose logs -t
+
+# Logs depuis une date
+docker-compose logs --since="2024-01-01T00:00:00"
+```
+
+## 🔒 Sécurité
+
+### Vérification de Sécurité
+```bash
+# Vérifier les ports exposés
+netstat -tuln | grep -E "(8090|8092|8094)"
+
+# Vérifier les permissions
+ls -la sdk_relay/.conf*
+ls -la bitcoin/bitcoin.conf
+ls -la blindbit/blindbit.toml
+
+# Vérifier les logs de sécurité
+docker logs sdk_relay_1 | grep -E "(ERROR|WARN|SECURITY)" | tail -20
+```
+
+### Configuration de Pare-feu
+```bash
+# Autoriser les ports nécessaires
+sudo ufw allow 18443/tcp  # Bitcoin Core RPC
+sudo ufw allow 8090/tcp   # sdk_relay WebSocket
+sudo ufw allow 8000/tcp   # Blindbit API
+sudo ufw enable
+
+# Vérifier les règles
+sudo ufw status numbered
+```
+
+## 📈 Performance
+
+### Optimisation
+```bash
+# Limiter l'utilisation CPU
+docker-compose up -d --scale bitcoin=1
+
+# Optimiser la mémoire
+docker stats --no-stream | grep sdk_relay
+
+# Nettoyer l'espace disque
+docker system prune -f
+```
+
+### Monitoring de Performance
+```bash
+# Surveillance des ressources
+docker stats
+
+# Surveillance des connexions
+netstat -an | grep :8090 | wc -l
+
+# Surveillance de l'espace disque
+df -h
+```
+
+### Tests de Charge
+```bash
+# Test de charge simple
+for i in {1..50}; do
+    python3 test_websocket_messages.py &
+    sleep 0.1
+done
+wait
+
+# Test de charge avancé
+python3 test_websocket_messages.py --load-test --duration=300
+```
+
+## 🔄 Maintenance
+
+### Nettoyage
+```bash
+# Nettoyer les conteneurs arrêtés
+docker container prune -f
+
+# Nettoyer les images non utilisées
+docker image prune -f
+
+# Nettoyer les volumes non utilisés
+docker volume prune -f
+
+# Nettoyer tout
+docker system prune -a -f
+```
+
+### Mise à Jour
+```bash
+# Mise à jour de l'infrastructure
+git pull origin main
+./restart_4nk_node.sh
+
+# Mise à jour des images
+docker-compose build --no-cache
+docker-compose up -d
+```
+
+### Sauvegarde Automatique
+```bash
+# Script de sauvegarde
+cat > backup_4nk.sh << 'EOF'
+#!/bin/bash
+DATE=$(date +%Y%m%d_%H%M%S)
+BACKUP_DIR="/backup/4nk_node_$DATE"
+mkdir -p $BACKUP_DIR
+cp -r sdk_relay/.conf* $BACKUP_DIR/
+cp external_nodes.conf $BACKUP_DIR/
+docker exec bitcoin-signet tar czf /tmp/bitcoin-backup.tar.gz /home/bitcoin/.bitcoin
+docker cp bitcoin-signet:/tmp/bitcoin-backup.tar.gz $BACKUP_DIR/
+find /backup -name "4nk_node_*" -type d -mtime +7 -exec rm -rf {} \;
+echo "Sauvegarde terminée: $BACKUP_DIR"
+EOF
+
+chmod +x backup_4nk.sh
+
+# Ajouter au cron
+echo "0 2 * * * /path/to/backup_4nk.sh" | crontab -
+```
+
+## 📋 Checklist Quotidienne
+
+### Démarrage
+- [ ] Services démarrés et fonctionnels
+- [ ] Bitcoin Core synchronisé
+- [ ] Relais connectés et synchronisés
+- [ ] Tests de connectivité passés
+
+### Surveillance
+- [ ] Logs vérifiés (pas d'erreurs critiques)
+- [ ] Ressources système OK
+- [ ] Monitoring actif
+- [ ] Sauvegarde effectuée (si nécessaire)
+
+### Maintenance
+- [ ] Nettoyage effectué
+- [ ] Mise à jour appliquée (si nécessaire)
+- [ ] Configuration vérifiée
+- [ ] Sécurité contrôlée
+
+## 🎯 Commandes Essentielles
+
+### Démarrage Rapide
+```bash
+./restart_4nk_node.sh
+docker ps
+./test_final_sync.sh
+```
+
+### Monitoring Rapide
+```bash
+docker ps
+docker-compose logs -f
+./monitor_sync.sh
+```
+
+### Test Rapide
+```bash
+./test_final_sync.sh
+./test_sync_logs.sh
+python3 test_websocket_messages.py
+```
+
+### Dépannage Rapide
+```bash
+docker logs <service_name>
+docker restart <service_name>
+./test_sync_logs.sh force
+```
+
+### Arrêt Propre
+```bash
+docker-compose down
+docker system prune -f
+```
+
+---
+
+

docs/RELEASE_PLAN.md

@@ -0,0 +1,361 @@
+# Plan de Release Open Source - docv
+
+## 🚀 Vue d'Ensemble
+
+Ce document détaille le plan de lancement open source du projet docv sur votre forge (ex: Gitea/GitHub/GitLab).
+
+### **Objectifs**
+- Lancer docv en open source avec succès
+- Attirer une communauté de contributeurs
+- Établir une base solide pour le développement futur
+- Positionner le projet dans l'écosystème Bitcoin
+
+### **Date Cible**
+**Lancement : Janvier 2025**
+
+## 📋 Phase 1 : Préparation Finale (1-2 semaines)
+
+### **Configuration Gitea**
+
+#### 1. **Repository Public**
+```bash
+# Actions à effectuer sur git.4nkweb.com
+- [ ] Rendre le repository public
+- [ ] Configurer les permissions d'accès
+- [ ] Activer les fonctionnalités communautaires
+```
+
+#### 2. **Templates et Workflows**
+```bash
+# Vérifier l'activation des templates
+- [ ] Templates d'issues fonctionnels
+- [ ] Template de pull request actif
+- [ ] Workflow CI/CD configuré
+- [ ] Job CI `release-guard` actif (tests/doc/build/version/changelog)
+- [ ] Labels et milestones créés
+```
+
+#### 3. **Documentation Publique**
+```bash
+# Finaliser la documentation
+- [ ] README.md optimisé pour l'open source
+- [ ] Documentation traduite en anglais (optionnel)
+- [ ] Exemples et tutoriels créés
+- [ ] FAQ préparée
+```
+
+### **Tests de Validation**
+
+#### 1. **Tests Complets**
+```bash
+# Exécuter tous les tests
+./tests/run_all_tests.sh
+
+# Tests spécifiques
+./tests/run_connectivity_tests.sh
+./tests/run_external_tests.sh
+```
+
+#### 2. **Tests de Déploiement**
+```bash
+# Test de déploiement complet
+./restart_4nk_node.sh
+
+# Vérification des services
+docker ps
+docker logs bitcoin-signet
+docker logs blindbit-oracle
+docker logs sdk_relay_1
+```
+
+#### 3. **Tests de Documentation**
+```bash
+# Vérifier les liens
+find docs/ -name "*.md" -exec grep -l "\[.*\](" {} \;
+
+# Valider la structure
+ls -la docs/
+ls -la tests/
+
+# Vérifier les obligations de release (local)
+RELEASE_TYPE=ci-verify scripts/release/guard.sh
+```
+
+## 📋 Phase 2 : Communication et Marketing (1 semaine)
+
+### **Annonce Officielle**
+
+#### 1. **Communiqué de Presse**
+```markdown
+# Titre : docv - Infrastructure Open Source pour les Paiements Silencieux Bitcoin
+
+## Résumé
+docv annonce le lancement en open source de son infrastructure complète pour les paiements silencieux Bitcoin. Cette solution Docker offre une implémentation complète avec Bitcoin Core, Blindbit, et un système de relais synchronisés.
+
+## Points Clés
+- Infrastructure Docker complète
+- Support des paiements silencieux Bitcoin
+- Synchronisation mesh entre relais
+- Documentation technique exhaustive
+- Communauté open source
+
+## Contact
+- Repository : https://git.4nkweb.com/4nk/4NK_node
+- Documentation : https://git.4nkweb.com/4nk/4NK_node/src/branch/main/docs
+- Support : support@4nkweb.com
+```
+
+#### 2. **Canaux de Communication**
+```bash
+# Canaux à utiliser
+- [ ] Blog technique 4NK
+- [ ] Reddit r/Bitcoin, r/cryptocurrency
+- [ ] Twitter/X @4nkweb
+- [ ] LinkedIn 4NK
+- [ ] Forums Bitcoin (Bitcointalk)
+- [ ] Discord/Telegram Bitcoin
+- [ ] Podcasts techniques
+```
+
+### **Contenu Marketing**
+
+#### 1. **Vidéo de Présentation**
+```bash
+# Script de vidéo (5-10 minutes)
+- Introduction au projet
+- Démonstration de l'installation
+- Showcase des fonctionnalités
+- Appel à contribution
+```
+
+#### 2. **Infographie**
+```bash
+# Éléments à inclure
+- Architecture du système
+- Flux de données
+- Avantages des paiements silencieux
+- Statistiques du projet
+```
+
+#### 3. **Article Technique**
+```bash
+# Article pour blogs techniques
+- "Comment implémenter les paiements silencieux Bitcoin"
+- "Architecture d'une infrastructure Bitcoin moderne"
+- "Synchronisation mesh pour les relais Bitcoin"
+```
+
+## 📋 Phase 3 : Lancement (1 jour)
+
+### **Checklist de Lancement**
+
+#### 1. **Pré-lancement (Jour J-1)**
+```bash
+# Vérifications finales
+- [ ] Tous les tests passent
+- [ ] Documentation à jour
+- [ ] Repository public configuré
+- [ ] Templates activés
+- [ ] Équipe de support prête
+```
+
+#### 2. **Lancement (Jour J)**
+```bash
+# Actions de lancement
+- [ ] Publier le communiqué de presse
+- [ ] Poster sur les réseaux sociaux
+- [ ] Envoyer les annonces
+- [ ] Activer le support communautaire
+- [ ] Monitorer les réactions
+
+# Release (modèle de commandes)
+git add -A && git commit -m "chore(release): 2025.08"
+git tag -a v2025.08 -m "release 2025.08"
+git push origin HEAD && git push origin v2025.08
+```
+
+#### 3. **Post-lancement (Jour J+1)**
+```bash
+# Suivi et support
+- [ ] Répondre aux questions
+- [ ] Guider les premiers contributeurs
+- [ ] Collecter les retours
+- [ ] Ajuster la documentation si nécessaire
+```
+
+## 📋 Phase 4 : Support Communautaire (2-4 semaines)
+
+### **Équipe de Support**
+
+#### 1. **Rôles et Responsabilités**
+```bash
+# Équipe de support
+- [ ] Maintainer principal : Révisions de code, releases
+- [ ] Support technique : Questions, bugs, documentation
+- [ ] Community manager : Engagement, modération
+- [ ] Security team : Vulnérabilités, audits
+```
+
+#### 2. **Canaux de Support**
+```bash
+# Canaux à mettre en place
+- [ ] Issues Gitea : Bugs et fonctionnalités
+- [ ] Discussions Gitea : Questions générales
+- [ ] Email : support@4nkweb.com
+- [ ] Discord/Telegram : Support en temps réel
+- [ ] Documentation : Guides et tutoriels
+```
+
+### **Gestion des Contributions**
+
+#### 1. **Processus de Review**
+```bash
+# Workflow de contribution
+1. Issue créée ou PR soumise
+2. Review automatique (CI/CD)
+3. Review manuelle par maintainer
+4. Tests et validation
+5. Merge et release
+```
+
+#### 2. **Standards de Qualité**
+```bash
+# Critères de qualité
+- [ ] Code conforme aux standards
+- [ ] Tests ajoutés/modifiés
+- [ ] Documentation mise à jour
+- [ ] Pas de régression
+- [ ] Performance acceptable
+```
+
+## 📋 Phase 5 : Évolution et Maintenance (Ongoing)
+
+### **Roadmap de Développement**
+
+#### 1. **Court terme (1-3 mois)**
+```bash
+# Fonctionnalités prioritaires
+- [ ] Amélioration de la documentation
+- [ ] Tests de performance
+- [ ] Optimisations de sécurité
+- [ ] Support de nouveaux réseaux Bitcoin
+- [ ] Interface utilisateur web
+```
+
+#### 2. **Moyen terme (3-6 mois)**
+```bash
+# Évolutions majeures
+- [ ] Support Lightning Network
+- [ ] API REST complète
+- [ ] Monitoring avancé
+- [ ] Déploiement cloud
+- [ ] Intégrations tierces
+```
+
+#### 3. **Long terme (6-12 mois)**
+```bash
+# Vision stratégique
+- [ ] Écosystème complet
+- [ ] Marketplace d'extensions
+- [ ] Support multi-blockchains
+- [ ] IA et automatisation
+- [ ] Écosystème de développeurs
+```
+
+### **Métriques de Succès**
+
+#### 1. **Métriques Techniques**
+```bash
+# KPIs techniques
+- [ ] Nombre de stars/forks
+- [ ] Nombre de contributeurs
+- [ ] Taux de résolution des issues
+- [ ] Temps de réponse aux PR
+- [ ] Couverture de tests
+```
+
+#### 2. **Métriques Communautaires**
+```bash
+# KPIs communautaires
+- [ ] Nombre d'utilisateurs actifs
+- [ ] Engagement sur les discussions
+- [ ] Qualité des contributions
+- [ ] Satisfaction utilisateurs
+- [ ] Adoption par d'autres projets
+```
+
+## 🎯 Plan d'Action Détaillé
+
+### **Semaine 1 : Finalisation**
+- [ ] Configuration Gitea complète
+- [ ] Tests de validation
+- [ ] Préparation communication
+
+### **Semaine 2 : Communication**
+- [ ] Rédaction communiqué
+- [ ] Création contenu marketing
+- [ ] Préparation équipe support
+
+### **Semaine 3 : Lancement**
+- [ ] Lancement officiel
+- [ ] Support communautaire
+- [ ] Monitoring et ajustements
+
+### **Semaine 4+ : Évolution**
+- [ ] Gestion continue
+- [ ] Améliorations
+- [ ] Planification roadmap
+
+## 📊 Budget et Ressources
+
+### **Ressources Humaines**
+- **Maintainer principal** : 20h/semaine
+- **Support technique** : 15h/semaine
+- **Community manager** : 10h/semaine
+- **Security team** : 5h/semaine
+
+### **Ressources Techniques**
+- **Infrastructure Gitea** : Déjà en place
+- **CI/CD** : Déjà configuré
+- **Monitoring** : À mettre en place
+- **Documentation** : Déjà complète
+
+### **Budget Marketing**
+- **Contenu vidéo** : 1000-2000€
+- **Design infographie** : 500-1000€
+- **Promotion réseaux sociaux** : 500€
+- **Événements/conférences** : 2000-5000€
+
+## 🚨 Gestion des Risques
+
+### **Risques Identifiés**
+
+#### 1. **Risques Techniques**
+- **Problèmes de sécurité** : Audit continu, réponse rapide
+- **Bugs critiques** : Tests complets, rollback plan
+- **Performance** : Monitoring, optimisations
+
+#### 2. **Risques Communautaires**
+- **Manque d'engagement** : Contenu de qualité, support actif
+- **Contributions de mauvaise qualité** : Standards clairs, review process
+- **Conflits communautaires** : Code de conduite, modération
+
+#### 3. **Risques Business**
+- **Concurrence** : Innovation continue, différenciation
+- **Changements réglementaires** : Veille, adaptation
+- **Évolution technologique** : Roadmap flexible, veille
+
+### **Plans de Contingence**
+```bash
+# Plans de secours
+- [ ] Plan de rollback technique
+- [ ] Équipe de support de backup
+- [ ] Communication de crise
+- [ ] Ressources alternatives
+```
+
+---
+
+**Ce plan garantit un lancement open source réussi et une évolution durable du projet docv.** 🚀
+
+

docs/ROADMAP.md

@@ -0,0 +1,343 @@
+# Roadmap de Développement - docv
+
+## 🗺️ Vue d'Ensemble
+
+Ce document présente la roadmap de développement du projet docv, détaillant les fonctionnalités planifiées, les améliorations et les évolutions futures.
+
+### **Vision**
+docv vise à devenir la référence en matière d'infrastructure open source pour les paiements silencieux Bitcoin, offrant une solution complète, sécurisée et facile à déployer.
+
+### **Objectifs**
+- Simplifier le déploiement des paiements silencieux Bitcoin
+- Créer un écosystème robuste et extensible
+- Favoriser l'adoption des paiements privés
+- Construire une communauté active de contributeurs
+
+## 📅 Timeline de Développement
+
+### **Phase Actuelle : v1.0.0 (Décembre 2024)**
+
+#### ✅ **Complété**
+- Infrastructure Docker complète
+- Support Bitcoin Core signet
+- Service Blindbit intégré
+- SDK Relay avec synchronisation mesh
+- Documentation technique exhaustive
+- Tests automatisés
+- Préparation open source
+
+#### 🔄 **En Cours**
+- Lancement open source
+- Support communautaire
+- Optimisations de performance
+
+### **Phase 1 : v1.1.0 (Janvier-Mars 2025)**
+
+#### 🎯 **Objectifs**
+- Amélioration de la stabilité
+- Optimisations de performance
+- Support communautaire
+- Documentation enrichie
+
+#### 📋 **Fonctionnalités Planifiées**
+
+##### **Stabilité et Performance**
+- [ ] **Optimisation mémoire** - Réduction de l'empreinte mémoire
+- [ ] **Amélioration des logs** - Logs structurés et rotation
+- [ ] **Monitoring avancé** - Métriques détaillées
+- [ ] **Gestion d'erreurs** - Récupération automatique
+- [ ] **Tests de charge** - Validation des performances
+
+##### **Interface Utilisateur**
+- [ ] **Interface web basique** - Dashboard de monitoring
+- [ ] **API REST complète** - Endpoints pour la gestion
+- [ ] **CLI améliorée** - Commandes de gestion
+- [ ] **Documentation interactive** - Guides interactifs
+
+##### **Sécurité**
+- [ ] **Audit de sécurité** - Audit externe complet
+- [ ] **Chiffrement des données** - Chiffrement des cookies
+- [ ] **Authentification** - Système d'authentification
+- [ ] **Certificats SSL/TLS** - Support HTTPS complet
+
+### **Phase 2 : v1.2.0 (Avril-Juin 2025)**
+
+#### 🎯 **Objectifs**
+- Support de nouveaux réseaux Bitcoin
+- Intégrations tierces
+- Écosystème d'extensions
+- Performance avancée
+
+#### 📋 **Fonctionnalités Planifiées**
+
+##### **Réseaux Bitcoin**
+- [ ] **Support mainnet** - Déploiement production
+- [ ] **Support testnet** - Environnement de test
+- [ ] **Support regtest** - Tests locaux
+- [ ] **Multi-réseaux** - Support simultané
+
+##### **Intégrations**
+- [ ] **Wallets populaires** - Intégration wallets
+- [ ] **Exchanges** - Support exchanges
+- [ ] **Services tiers** - APIs externes
+- [ ] **Plugins** - Système de plugins
+
+##### **Performance**
+- [ ] **Cache distribué** - Cache Redis/Memcached
+- [ ] **Base de données** - PostgreSQL/MySQL
+- [ ] **Load balancing** - Équilibrage de charge
+- [ ] **Auto-scaling** - Mise à l'échelle automatique
+
+### **Phase 3 : v2.0.0 (Juillet-Décembre 2025)**
+
+#### 🎯 **Objectifs**
+- Support Lightning Network
+- Écosystème complet
+- Marketplace d'extensions
+- IA et automatisation
+
+#### 📋 **Fonctionnalités Planifiées**
+
+##### **Lightning Network**
+- [ ] **Nœud Lightning** - LND/c-lightning
+- [ ] **Paiements Lightning** - Support LN
+- [ ] **Canaux automatiques** - Gestion des canaux
+- [ ] **Routage** - Routage Lightning
+
+##### **Écosystème**
+- [ ] **Marketplace** - Extensions et plugins
+- [ ] **SDK complet** - SDK pour développeurs
+- [ ] **Templates** - Templates de déploiement
+- [ ] **Intégrations** - Écosystème riche
+
+##### **Intelligence Artificielle**
+- [ ] **Monitoring IA** - Détection d'anomalies
+- [ ] **Optimisation automatique** - Auto-optimisation
+- [ ] **Prédictions** - Prédictions de charge
+- [ ] **Chatbot** - Support IA
+
+### **Phase 4 : v2.1.0 (Janvier-Juin 2026)**
+
+#### 🎯 **Objectifs**
+- Support multi-blockchains
+- Cloud native
+- Écosystème développeur
+- Adoption massive
+
+#### 📋 **Fonctionnalités Planifiées**
+
+##### **Multi-Blockchains**
+- [ ] **Ethereum** - Support Ethereum
+- [ ] **Polkadot** - Support Polkadot
+- [ ] **Cosmos** - Support Cosmos
+- [ ] **Interopérabilité** - Cross-chain
+
+##### **Cloud Native**
+- [ ] **Kubernetes** - Support K8s
+- [ ] **Serverless** - Fonctions serverless
+- [ ] **Microservices** - Architecture microservices
+- [ ] **Edge computing** - Computing edge
+
+##### **Écosystème Développeur**
+- [ ] **API Gateway** - Gateway API
+- [ ] **Documentation API** - Swagger/OpenAPI
+- [ ] **SDKs multiples** - SDKs pour différents langages
+- [ ] **Outils de développement** - IDE plugins
+
+## 🎯 Fonctionnalités Détaillées
+
+### **Interface Utilisateur Web**
+
+#### **Dashboard Principal**
+```yaml
+Fonctionnalités:
+  - Vue d'ensemble des services
+  - Métriques en temps réel
+  - Gestion des relais
+  - Configuration avancée
+  - Logs et monitoring
+  - Support et documentation
+```
+
+#### **API REST**
+```yaml
+Endpoints:
+  - GET /api/v1/status - Statut des services
+  - GET /api/v1/metrics - Métriques système
+  - POST /api/v1/relays - Gestion des relais
+  - PUT /api/v1/config - Configuration
+  - GET /api/v1/logs - Logs système
+```
+
+### **Support Lightning Network**
+
+#### **Architecture LN**
+```yaml
+Composants:
+  - LND Node: Nœud Lightning principal
+  - Channel Manager: Gestion des canaux
+  - Payment Router: Routage des paiements
+  - Invoice Manager: Gestion des factures
+  - Network Monitor: Surveillance réseau
+```
+
+#### **Intégration**
+```yaml
+Fonctionnalités:
+  - Paiements Lightning automatiques
+  - Gestion des canaux
+  - Routage intelligent
+  - Facturation automatique
+  - Monitoring des canaux
+```
+
+### **Marketplace d'Extensions**
+
+#### **Types d'Extensions**
+```yaml
+Extensions:
+  - Wallets: Intégrations wallets
+  - Exchanges: Support exchanges
+  - Analytics: Outils d'analyse
+  - Security: Outils de sécurité
+  - Monitoring: Outils de monitoring
+  - Custom: Extensions personnalisées
+```
+
+#### **Système de Plugins**
+```yaml
+Architecture:
+  - Plugin Manager: Gestionnaire de plugins
+  - API Plugin: API pour plugins
+  - Sandbox: Environnement sécurisé
+  - Registry: Registre de plugins
+  - Updates: Mises à jour automatiques
+```
+
+## 📊 Métriques de Succès
+
+### **Métriques Techniques**
+
+#### **Performance**
+- **Temps de réponse** : < 100ms pour les APIs
+- **Disponibilité** : 99.9% uptime
+- **Throughput** : 1000+ transactions/seconde
+- **Latence** : < 50ms pour les paiements
+
+#### **Qualité**
+- **Couverture de tests** : > 90%
+- **Bugs critiques** : 0 en production
+- **Temps de résolution** : < 24h pour les bugs critiques
+- **Documentation** : 100% des APIs documentées
+
+### **Métriques Communautaires**
+
+#### **Adoption**
+- **Utilisateurs actifs** : 1000+ utilisateurs
+- **Contributeurs** : 50+ contributeurs
+- **Forks** : 100+ forks
+- **Stars** : 500+ stars
+
+#### **Engagement**
+- **Issues résolues** : 90% en < 7 jours
+- **PR merged** : 80% en < 3 jours
+- **Discussions actives** : 100+ par mois
+- **Documentation mise à jour** : Mise à jour continue
+
+## 🚨 Gestion des Risques
+
+### **Risques Techniques**
+
+#### **Performance**
+- **Risque** : Charge élevée non supportée
+- **Mitigation** : Tests de charge, auto-scaling
+- **Plan de contingence** : Architecture distribuée
+
+#### **Sécurité**
+- **Risque** : Vulnérabilités de sécurité
+- **Mitigation** : Audits réguliers, bug bounty
+- **Plan de contingence** : Response team, patches rapides
+
+### **Risques Communautaires**
+
+#### **Adoption**
+- **Risque** : Faible adoption
+- **Mitigation** : Marketing actif, documentation claire
+- **Plan de contingence** : Pivot vers niches spécifiques
+
+#### **Maintenance**
+- **Risque** : Manque de mainteneurs
+- **Mitigation** : Formation, documentation
+- **Plan de contingence** : Équipe de backup
+
+## 🎯 Priorités de Développement
+
+### **Priorité Haute (P0)**
+1. **Stabilité** - Correction des bugs critiques
+2. **Sécurité** - Vulnérabilités de sécurité
+3. **Performance** - Optimisations critiques
+4. **Documentation** - Documentation essentielle
+
+### **Priorité Moyenne (P1)**
+1. **Nouvelles fonctionnalités** - Fonctionnalités majeures
+2. **Améliorations UX** - Interface utilisateur
+3. **Intégrations** - Intégrations tierces
+4. **Monitoring** - Outils de monitoring
+
+### **Priorité Basse (P2)**
+1. **Optimisations** - Optimisations mineures
+2. **Documentation avancée** - Guides avancés
+3. **Outils de développement** - Outils pour développeurs
+4. **Expérimentations** - Fonctionnalités expérimentales
+
+## 📈 Évolution de l'Architecture
+
+### **Architecture Actuelle (v1.0)**
+```yaml
+Services:
+  - Bitcoin Core: Nœud Bitcoin
+  - Blindbit: Service de filtres
+  - SDK Relay: Relais synchronisés
+  - Tor: Proxy anonyme
+```
+
+### **Architecture v2.0**
+```yaml
+Services:
+  - Bitcoin Core: Nœud Bitcoin
+  - Lightning Node: Nœud Lightning
+  - Blindbit: Service de filtres
+  - SDK Relay: Relais synchronisés
+  - API Gateway: Gateway API
+  - Web UI: Interface web
+  - Monitoring: Monitoring avancé
+  - Tor: Proxy anonyme
+```
+
+### **Architecture v3.0**
+```yaml
+Services:
+  - Multi-Chain: Support multi-blockchains
+  - Microservices: Architecture microservices
+  - Cloud Native: Support cloud natif
+  - AI/ML: Intelligence artificielle
+  - Marketplace: Marketplace d'extensions
+  - Developer Tools: Outils développeur
+```
+
+## 🌟 Vision Long Terme
+
+### **Objectif 2026**
+docv devient la plateforme de référence pour les paiements privés et sécurisés, supportant toutes les blockchains majeures et offrant un écosystème complet pour les développeurs et utilisateurs.
+
+### **Objectif 2027**
+docv est adopté par des milliers d'utilisateurs et entreprises, contribuant significativement à l'adoption des paiements privés et à l'évolution de l'écosystème blockchain.
+
+### **Objectif 2028**
+docv est un standard de l'industrie, avec une communauté mondiale de contributeurs et une influence majeure sur l'évolution des technologies de paiement privé.
+
+---
+
+**Cette roadmap guide le développement de docv vers son objectif de devenir la référence en matière d'infrastructure pour les paiements silencieux Bitcoin.** 🚀
+
+

docs/SECURITY_AUDIT.md

@@ -0,0 +1,203 @@
+# Audit de Sécurité - docv
+
+- CI: job `security-audit` exécutant `scripts/security/audit.sh`.
+- Portée: npm audit (niveau moderate+), cargo audit si sous-projet Rust, scan de secrets.
+- Critères bloquants: vulnérabilités élevées/critiques, secrets détectés.
+- `release-guard` bloque la publication en cas d’échec.
+
+## 🔍 Résumé de l'Audit
+
+**Date d'audit** : 19 décembre 2024
+**Auditeur** : Assistant IA
+**Version du projet** : 1.0.0
+**Score de sécurité** : 85/100 ✅
+
+## 📋 Éléments Audités
+
+### ✅ **Points Sécurisés**
+
+#### 1. **Fichiers de Configuration**
+- ✅ **Cookies Bitcoin** : Utilisation de chemins sécurisés (`/home/bitcoin/.bitcoin/signet/.cookie`)
+- ✅ **Permissions** : Cookies avec permissions 600 (lecture/écriture propriétaire uniquement)
+- ✅ **Variables d'environnement** : Pas de secrets en dur dans le code
+- ✅ **Configuration externalisée** : Fichiers .conf séparés du code
+
+#### 2. **Infrastructure Docker**
+- ✅ **Réseau isolé** : Communication via réseau privé `btcnet`
+- ✅ **Volumes sécurisés** : Données sensibles dans des volumes Docker
+- ✅ **Healthchecks** : Surveillance de l'état des services
+- ✅ **Logs** : Rotation et limitation de taille des logs
+
+#### 3. **Code et Dépendances**
+- ✅ **Pas de secrets en dur** : Aucun mot de passe ou clé privée dans le code
+- ✅ **Dépendances Rust** : Utilisation de crates sécurisées
+- ✅ **Validation des entrées** : Validation des configurations et paramètres
+- ✅ **Gestion d'erreurs** : Gestion appropriée des erreurs
+
+### ⚠️ **Points d'Attention**
+
+#### 1. **URLs et Endpoints**
+- ⚠️ **dev3.4nkweb.com** : URL externe référencée dans la configuration
+- ⚠️ **git.4nkweb.com** : URLs du repository Gitea
+- ✅ **Pas d'endpoints privés** : Toutes les URLs sont publiques et appropriées
+
+#### 2. **Certificats SSL/TLS**
+- ⚠️ **Exemples de certificats** : Documentation contient des exemples de génération
+- ✅ **Pas de certificats réels** : Aucun certificat privé dans le code
+
+#### 3. **Tests de Connectivité**
+- ⚠️ **WebSocket tests** : Tests utilisent des clés de test (`Sec-WebSocket-Key: test`)
+- ✅ **Clés de test uniquement** : Pas de clés de production
+
+## 🔒 Analyse Détaillée
+
+### **Fichiers Sensibles**
+
+#### Cookies Bitcoin Core
+```bash
+# Sécurisé ✅
+/home/bitcoin/.bitcoin/signet/.cookie  # Permissions 600
+/home/bitcoin/.4nk/bitcoin.cookie      # Copie sécurisée
+```
+
+#### Configuration Files
+```bash
+# Sécurisé ✅
+sdk_relay/.conf                        # Configuration de base
+sdk_relay/.conf.docker                 # Configuration Docker
+sdk_relay/external_nodes.conf          # Nœuds externes
+```
+
+#### Docker Volumes
+```bash
+# Sécurisé ✅
+bitcoin_data:/home/bitcoin/.bitcoin    # Données Bitcoin
+blindbit_data:/data                    # Données Blindbit
+sdk_relay_*_data:/home/bitcoin/.4nk    # Données SDK Relay
+```
+
+### **URLs et Endpoints**
+
+#### URLs Publiques (Approuvées)
+```bash
+# Repository Gitea ✅
+https://git.4nkweb.com/4nk/4NK_node
+https://git.4nkweb.com/4nk/sdk_relay
+https://git.4nkweb.com/4nk/sdk_common
+
+# Nœud externe ✅
+dev3.4nkweb.com:443                    # Relais externe documenté
+```
+
+#### URLs de Support (Approuvées)
+```bash
+# Support et communication ✅
+security@4nkweb.com                    # Signalement de vulnérabilités
+support@4nkweb.com                     # Support utilisateur
+https://forum.4nkweb.com               # Forum communautaire
+```
+
+### **Variables d'Environnement**
+
+#### Variables Sécurisées
+```bash
+# Configuration Bitcoin ✅
+BITCOIN_COOKIE_PATH=/home/bitcoin/.bitcoin/signet/.cookie
+BITCOIN_NETWORK=signet
+
+# Configuration SDK Relay ✅
+RUST_LOG=debug
+ENABLE_SYNC_TEST=1
+HOME=/home/bitcoin
+```
+
+## 🛡️ Recommandations de Sécurité
+
+### **Actions Immédiates**
+
+#### 1. **Permissions des Fichiers**
+```bash
+# Vérifier les permissions des fichiers sensibles
+find . -name "*.conf" -exec chmod 600 {} \;
+find . -name "*.cookie" -exec chmod 600 {} \;
+```
+
+#### 2. **Variables d'Environnement**
+```bash
+# Utiliser des variables d'environnement pour les secrets
+export BITCOIN_RPC_PASSWORD="your_secure_password"
+export BLINDBIT_API_KEY="your_api_key"
+```
+
+#### 3. **Monitoring de Sécurité**
+```bash
+# Ajouter des tests de sécurité automatisés
+./tests/run_security_tests.sh
+```
+
+### **Actions Recommandées**
+
+#### 1. **Chiffrement des Données**
+- Chiffrer les cookies Bitcoin Core
+- Utiliser des certificats SSL/TLS pour les communications
+- Implémenter le chiffrement des données sensibles
+
+#### 2. **Authentification Renforcée**
+- Implémenter l'authentification multi-facteurs
+- Utiliser des tokens JWT pour les APIs
+- Ajouter la validation des certificats clients
+
+#### 3. **Audit Continu**
+- Mettre en place un audit de sécurité automatisé
+- Surveiller les vulnérabilités des dépendances
+- Tester régulièrement la sécurité
+
+## 📊 Score de Sécurité
+
+### **Critères d'Évaluation**
+
+| Critère | Score | Commentaire |
+|---------|-------|-------------|
+| **Secrets en dur** | 100/100 | ✅ Aucun secret trouvé |
+| **Permissions** | 90/100 | ✅ Permissions appropriées |
+| **Configuration** | 85/100 | ✅ Configuration externalisée |
+| **Réseau** | 90/100 | ✅ Isolation Docker |
+| **Dépendances** | 80/100 | ✅ Dépendances sécurisées |
+| **Documentation** | 85/100 | ✅ Bonnes pratiques documentées |
+
+### **Score Global : 85/100** ✅
+
+## 🚨 Plan d'Action
+
+### **Phase 1 : Immédiat (1-2 jours)**
+- [x] Audit de sécurité complet
+- [x] Vérification des permissions
+- [x] Nettoyage des fichiers GitHub
+- [ ] Tests de sécurité automatisés
+
+### **Phase 2 : Court terme (1 semaine)**
+- [ ] Implémentation du chiffrement des cookies
+- [ ] Ajout de certificats SSL/TLS
+- [ ] Monitoring de sécurité
+
+### **Phase 3 : Moyen terme (1 mois)**
+- [ ] Authentification renforcée
+- [ ] Audit de sécurité automatisé
+- [ ] Formation sécurité équipe
+
+## 📚 Ressources
+
+### **Documentation Sécurité**
+- [Guide de Sécurité Bitcoin](https://bitcoin.org/en/security)
+- [OWASP Top 10](https://owasp.org/www-project-top-ten/)
+- [Docker Security Best Practices](https://docs.docker.com/engine/security/)
+
+### **Outils Recommandés**
+- **cargo audit** - Audit des dépendances Rust
+- **Docker Bench Security** - Audit de sécurité Docker
+- **Bandit** - Analyse de sécurité Python
+- **SonarQube** - Qualité et sécurité du code
+
+---
+
+**Le projet docv présente un bon niveau de sécurité pour l'open source. Les recommandations ci-dessus permettront de renforcer encore la sécurité.** 🔒

docs/TESTING.md

@@ -0,0 +1,500 @@
+# Guide de Tests - docv
+
+Ce guide documente l'ensemble des tests disponibles pour l'infrastructure docv, leur organisation et leur utilisation.
+
+## Vue d'Ensemble
+
+L'infrastructure docv dispose d'une suite de tests complète organisée en plusieurs catégories :
+
+- **Tests Unitaires** : Tests individuels des composants
+- **Tests d'Intégration** : Tests d'interaction entre services
+- **Tests de Connectivité** : Tests réseau et WebSocket
+- **Tests Externes** : Tests avec des nœuds externes
+- **Tests de Performance** : Tests de charge et performance (à venir)
+
+## Structure des Tests
+
+```
+tests/
+├── README.md                    # Documentation principale des tests
+├── run_all_tests.sh            # Exécution de tous les tests
+├── run_unit_tests.sh           # Tests unitaires uniquement
+├── run_integration_tests.sh    # Tests d'intégration uniquement
+├── run_connectivity_tests.sh   # Tests de connectivité uniquement
+├── run_external_tests.sh       # Tests externes uniquement
+├── cleanup.sh                  # Nettoyage des logs et rapports
+├── logs/                       # Logs des tests
+├── reports/                    # Rapports de tests
+├── unit/                       # Tests unitaires
+│   ├── test_healthcheck.sh
+│   ├── test_docker.sh
+│   ├── test_simple.sh
+│   └── test_final.sh
+├── integration/                # Tests d'intégration
+│   ├── test_3_relays.sh
+│   ├── test_final_sync.sh
+│   ├── test_sync_logs.sh
+│   └── test_messages.sh
+├── connectivity/               # Tests de connectivité
+│   ├── test_connectivity.sh
+│   └── test_websocket_messages.py
+├── external/                   # Tests externes
+│   ├── test_dev3_simple.py
+│   ├── test_dev3_connectivity.py
+│   └── test_integration_dev3.sh
+└── performance/                # Tests de performance (à créer)
+```
+
+## Exécution des Tests
+
+### Test Complet
+
+Pour exécuter tous les tests :
+
+```bash
+cd tests/
+./run_all_tests.sh
+```
+
+Options disponibles :
+- `--verbose` : Mode verbose avec affichage détaillé
+- `--debug` : Mode debug complet
+- `--skip-unit` : Ignorer les tests unitaires
+- `--skip-integration` : Ignorer les tests d'intégration
+- `--skip-connectivity` : Ignorer les tests de connectivité
+- `--skip-external` : Ignorer les tests externes
+
+### Tests par Catégorie
+
+#### Tests Unitaires
+```bash
+./tests/run_unit_tests.sh [--verbose] [--debug]
+```
+
+**Tests inclus :**
+- `test_healthcheck.sh` : Test du healthcheck de sdk_relay
+- `test_docker.sh` : Test de la configuration Docker
+- `test_simple.sh` : Test simple de sdk_relay
+- `test_final.sh` : Test final de sdk_relay
+
+**Prérequis :**
+- Docker installé et fonctionnel
+- Image sdk_relay disponible
+
+#### Tests d'Intégration
+```bash
+./tests/run_integration_tests.sh [--verbose] [--debug]
+```
+
+**Tests inclus :**
+- `test_3_relays.sh` : Test de 3 instances sdk_relay
+- `test_final_sync.sh` : Test complet de synchronisation
+- `test_sync_logs.sh` : Test des logs de synchronisation
+- `test_messages.sh` : Test des messages entre relais
+
+**Prérequis :**
+- Tous les services Docker démarrés (bitcoin, blindbit, sdk_relay)
+- Infrastructure complète opérationnelle
+
+#### Tests de Connectivité
+```bash
+./tests/run_connectivity_tests.sh [--verbose] [--debug]
+```
+
+**Tests inclus :**
+- `test_connectivity.sh` : Test de connectivité des services
+- `test_websocket_messages.py` : Test des messages WebSocket
+
+**Prérequis :**
+- Services Docker démarrés
+- Python3 avec websockets installé
+
+#### Tests Externes
+```bash
+./tests/run_external_tests.sh [--verbose] [--debug]
+```
+
+**Tests inclus :**
+- `test_dev3_simple.py` : Test simple de dev3.4nkweb.com
+- `test_dev3_connectivity.py` : Test de connectivité dev3
+- `test_integration_dev3.sh` : Test d'intégration dev3
+
+**Prérequis :**
+- Connectivité internet
+- Python3 avec websockets installé
+- Services locaux optionnels
+
+### Test Individuel
+
+Pour exécuter un test spécifique :
+
+```bash
+# Test shell
+./tests/integration/test_3_relays.sh
+
+# Test Python
+python3 tests/external/test_dev3_simple.py
+```
+
+## Interprétation des Résultats
+
+### Codes de Sortie
+
+- `0` : Test réussi
+- `1` : Test échoué
+- `2` : Test ignoré (prérequis non satisfaits)
+
+### Logs
+
+Les logs détaillés sont écrits dans `tests/logs/` avec le format :
+```
+YYYY-MM-DD_HH-MM-SS_category_tests.log
+```
+
+Exemples :
+- `2024-12-19_14-30-25_unit_tests.log`
+- `2024-12-19_14-35-12_integration_tests.log`
+
+### Rapports
+
+Les rapports JSON sont générés dans `tests/reports/` avec le format :
+```
+test_report_YYYY-MM-DD_HH-MM-SS.json
+```
+
+Structure du rapport :
+```json
+{
+    "timestamp": "2024-12-19_14-30-25",
+    "summary": {
+        "total_tests": 10,
+        "successful_tests": 8,
+        "failed_tests": 2,
+        "success_rate": 80.0
+    },
+    "log_file": "tests/logs/test_run_2024-12-19_14-30-25.log",
+    "options": {
+        "verbose": false,
+        "debug": false,
+        "skip_unit": false,
+        "skip_integration": false,
+        "skip_connectivity": false,
+        "skip_external": false,
+        "skip_performance": true
+    }
+}
+```
+
+## Détail des Tests
+
+### Tests Unitaires
+
+#### test_healthcheck.sh
+- **Objectif** : Vérifier le fonctionnement du healthcheck de sdk_relay
+- **Méthode** : Test du script healthcheck.sh dans un conteneur
+- **Critères de succès** : Healthcheck retourne un code de sortie approprié
+
+#### test_docker.sh
+- **Objectif** : Vérifier la configuration Docker de sdk_relay
+- **Méthode** : Test de la construction et du démarrage du conteneur
+- **Critères de succès** : Conteneur démarre correctement
+
+#### test_simple.sh
+- **Objectif** : Test simple de sdk_relay
+- **Méthode** : Démarrage et test basique de sdk_relay
+- **Critères de succès** : Service répond aux requêtes de base
+
+#### test_final.sh
+- **Objectif** : Test final complet de sdk_relay
+- **Méthode** : Test complet avec toutes les fonctionnalités
+- **Critères de succès** : Toutes les fonctionnalités opérationnelles
+
+### Tests d'Intégration
+
+#### test_3_relays.sh
+- **Objectif** : Tester 3 instances sdk_relay en parallèle
+- **Méthode** : Démarrage de 3 relais et vérification de leur interaction
+- **Critères de succès** : Les 3 relais communiquent correctement
+
+#### test_final_sync.sh
+- **Objectif** : Test complet de la synchronisation
+- **Méthode** : Test de tous les types de synchronisation
+- **Critères de succès** : Synchronisation fonctionnelle entre tous les relais
+
+#### test_sync_logs.sh
+- **Objectif** : Vérifier les logs de synchronisation
+- **Méthode** : Analyse des logs de synchronisation
+- **Critères de succès** : Logs cohérents et sans erreurs
+
+#### test_messages.sh
+- **Objectif** : Tester l'échange de messages entre relais
+- **Méthode** : Envoi et réception de messages de test
+- **Critères de succès** : Messages correctement transmis
+
+### Tests de Connectivité
+
+#### test_connectivity.sh
+- **Objectif** : Vérifier la connectivité entre services
+- **Méthode** : Test de connectivité réseau entre conteneurs
+- **Critères de succès** : Tous les services accessibles
+
+#### test_websocket_messages.py
+- **Objectif** : Tester les messages WebSocket
+- **Méthode** : Connexion WebSocket et échange de messages
+- **Critères de succès** : Communication WebSocket fonctionnelle
+
+### Tests Externes
+
+#### test_dev3_simple.py
+- **Objectif** : Test simple de dev3.4nkweb.com
+- **Méthode** : Connexion WebSocket simple
+- **Critères de succès** : Connexion établie
+
+#### test_dev3_connectivity.py
+- **Objectif** : Test complet de connectivité dev3
+- **Méthode** : Tests de protocole et handshake
+- **Critères de succès** : Tous les protocoles supportés
+
+#### test_integration_dev3.sh
+- **Objectif** : Test d'intégration avec dev3
+- **Méthode** : Test complet d'intégration
+- **Critères de succès** : Intégration fonctionnelle
+
+## Dépannage
+
+### Problèmes Courants
+
+#### Services non démarrés
+**Symptôme** : Erreur "Service non trouvé"
+**Solution** : Démarrer les services avec `./restart_4nk_node.sh`
+
+#### Connectivité réseau
+**Symptôme** : Timeout ou erreur de connexion
+**Solution** : Vérifier les ports et pare-feu
+
+#### Certificats SSL
+**Symptôme** : Erreur SSL dans les tests externes
+**Solution** : Vérifier les certificats et la configuration SSL
+
+#### Dépendances Python
+**Symptôme** : ModuleNotFoundError
+**Solution** : Installer les dépendances avec `pip install websockets`
+
+### Debug
+
+#### Mode Verbose
+```bash
+./tests/run_all_tests.sh --verbose
+```
+
+#### Mode Debug
+```bash
+./tests/run_all_tests.sh --debug
+```
+
+#### Test spécifique avec debug
+```bash
+./tests/integration/test_3_relays.sh --debug
+```
+
+## Maintenance
+
+### Nettoyage Automatique
+
+#### Nettoyer les logs anciens
+```bash
+./tests/cleanup.sh --days 7
+```
+
+#### Nettoyer les rapports anciens
+```bash
+./tests/cleanup.sh --reports --days 30
+```
+
+#### Nettoyage complet
+```bash
+./tests/cleanup.sh --all --days 7
+```
+
+#### Simulation de nettoyage
+```bash
+./tests/cleanup.sh --all --dry-run
+```
+
+### Surveillance
+
+#### Vérifier l'espace disque
+```bash
+du -sh tests/logs tests/reports
+```
+
+#### Lister les fichiers récents
+```bash
+find tests/logs -name "*.log" -mtime -1
+```
+
+#### Analyser les échecs
+```bash
+grep -r "ERROR\|FAILED" tests/logs/
+```
+
+## Ajout de Nouveaux Tests
+
+### Structure Recommandée
+
+Pour ajouter un nouveau test :
+
+1. **Créer le fichier de test** dans le répertoire approprié
+2. **Ajouter le test** au script d'exécution correspondant
+3. **Documenter le test** dans ce guide
+4. **Tester le test** pour s'assurer qu'il fonctionne
+
+### Template de Test Shell
+
+```bash
+#!/bin/bash
+# Test: Description du test
+# Auteur: Nom
+# Date: YYYY-MM-DD
+
+set -e
+
+# Configuration
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+LOG_FILE="tests/logs/$(date +%Y-%m-%d_%H-%M-%S)_test_name.log"
+
+# Fonctions
+log() {
+    echo "[$(date +%Y-%m-%d\ %H:%M:%S)] $1" | tee -a "$LOG_FILE"
+}
+
+# Test principal
+main() {
+    log "Début du test"
+
+    # Vérifications préliminaires
+    check_prerequisites
+
+    # Exécution du test
+    run_test
+
+    # Vérification des résultats
+    verify_results
+
+    log "Test terminé avec succès"
+}
+
+# Exécution
+main "$@"
+```
+
+### Template de Test Python
+
+```python
+#!/usr/bin/env python3
+"""
+Test: Description du test
+Auteur: Nom
+Date: YYYY-MM-DD
+"""
+
+import asyncio
+import json
+import logging
+from datetime import datetime
+
+# Configuration du logging
+logging.basicConfig(level=logging.INFO)
+logger = logging.getLogger(__name__)
+
+async def test_function():
+    """Fonction de test principale"""
+    logger.info("Début du test")
+
+    try:
+        # Logique de test
+        result = await run_test()
+
+        # Vérification
+        if result:
+            logger.info("Test réussi")
+            return True
+        else:
+            logger.error("Test échoué")
+            return False
+
+    except Exception as e:
+        logger.error(f"Erreur lors du test: {e}")
+        return False
+
+async def main():
+    """Fonction principale"""
+    success = await test_function()
+    exit(0 if success else 1)
+
+if __name__ == "__main__":
+    asyncio.run(main())
+```
+
+## Intégration Continue
+
+### Automatisation
+
+Les tests peuvent être intégrés dans un pipeline CI/CD :
+
+```yaml
+# Exemple GitHub Actions
+- name: Run Tests
+  run: |
+    cd tests/
+    ./run_all_tests.sh --verbose
+```
+
+### Surveillance Continue
+
+Pour une surveillance continue :
+
+```bash
+# Cron job pour tests quotidiens
+0 2 * * * cd /path/to/4NK_node/tests && ./run_all_tests.sh >> /var/log/4nk_tests.log 2>&1
+```
+
+### Garde de release
+
+Avant toute publication (push/tag), le job CI `release-guard` et le script local `scripts/release/guard.sh` exigent des tests verts. Exécution locale:
+
+```bash
+RELEASE_TYPE=ci-verify scripts/release/guard.sh
+```
+
+## Support
+
+Pour obtenir de l'aide :
+
+1. **Consulter les logs** : `tests/logs/`
+2. **Vérifier la documentation** : `tests/README.md`
+3. **Utiliser le mode debug** : `--debug`
+4. **Consulter les rapports** : `tests/reports/`
+
+## Évolution
+
+### Tests de Performance (À venir)
+
+- Tests de charge
+- Tests de latence
+- Tests de débit
+- Tests de stress
+
+### Tests de Sécurité (À venir)
+
+- Tests de vulnérabilités
+- Tests de pénétration
+- Tests de configuration
+
+### Tests d'Interface (À venir)
+
+- Tests d'API REST
+- Tests d'interface WebSocket
+- Tests de compatibilité
+
+

docs/USAGE.md

@@ -0,0 +1,671 @@
+# 📖 Guide d'Utilisation - docv
+
+> Ce document est un modèle générique. Remplacez docv et adaptez les commandes/chemins à votre projet.
+
+Guide complet pour utiliser l'infrastructure docv au quotidien.
+
+## 🚀 Démarrage Quotidien
+
+### 1. Démarrage Rapide
+
+```bash
+# Démarrer tous les services
+./restart_4nk_node.sh
+
+# Vérifier le statut
+docker ps
+```
+
+### 2. Démarrage Séquentiel
+
+```bash
+# Démarrer Tor
+./restart_4nk_node.sh -t
+
+# Démarrer Bitcoin Core
+./restart_4nk_node.sh -b
+
+# Attendre la synchronisation Bitcoin
+echo "Attendre la synchronisation Bitcoin (10-30 minutes)..."
+docker logs bitcoin-signet | grep "progress"
+
+# Démarrer Blindbit
+./restart_4nk_node.sh -l
+
+# Démarrer les relais
+./restart_4nk_node.sh -r
+```
+
+### 3. Vérification du Démarrage
+
+```bash
+# Vérifier tous les services
+docker ps
+
+# Vérifier les logs
+docker-compose logs --tail=50
+
+# Vérifier la connectivité
+./test_final_sync.sh
+```
+
+## 🔧 Opérations Quotidiennes
+
+### 1. Surveillance des Services
+
+```bash
+# Statut des services
+docker ps
+
+# Logs en temps réel
+docker-compose logs -f
+
+# Utilisation des ressources
+docker stats
+
+# Espace disque
+docker system df
+```
+
+### 2. Monitoring de la Synchronisation
+
+```bash
+# Surveillance de la synchronisation
+./monitor_sync.sh
+
+# Test de synchronisation
+./test_sync_logs.sh
+
+# Test des messages WebSocket
+python3 test_websocket_messages.py
+```
+
+### 3. Gestion des Logs
+
+```bash
+# Logs de tous les services
+docker-compose logs -f
+
+# Logs d'un service spécifique
+docker logs bitcoin-signet
+docker logs blindbit-oracle
+docker logs sdk_relay_1
+
+# Logs avec timestamps
+docker-compose logs -t
+
+# Logs depuis une date
+docker-compose logs --since="2024-01-01T00:00:00"
+
+# Logs des 100 dernières lignes
+docker-compose logs --tail=100
+```
+
+## 🌐 Utilisation du Réseau de Relais
+
+### 1. Configuration des Relais
+
+L'infrastructure utilise 3 relais locaux :
+
+| Relay | Port WebSocket | Port HTTP | Configuration |
+|-------|----------------|-----------|---------------|
+| **Relay 1** | 8090 | 8091 | `sdk_relay/.conf.docker.relay1` |
+| **Relay 2** | 8092 | 8093 | `sdk_relay/.conf.docker.relay2` |
+| **Relay 3** | 8094 | 8095 | `sdk_relay/.conf.docker.relay3` |
+
+### 2. Test de Connectivité des Relais
+
+```bash
+# Test de connectivité de base
+./test_final_sync.sh
+
+# Test de synchronisation
+./test_sync_logs.sh
+
+# Test des messages WebSocket
+python3 test_websocket_messages.py
+
+# Test de charge
+python3 test_websocket_messages.py --load-test
+```
+
+### 3. Surveillance de la Synchronisation
+
+```bash
+# Surveillance en temps réel
+./monitor_sync.sh
+
+# Test de synchronisation forcé
+./test_sync_logs.sh force
+
+# Test de synchronisation en continu
+./test_sync_logs.sh continuous
+```
+
+## 🔗 Connexion aux Services
+
+### 1. Bitcoin Core RPC
+
+```bash
+# Connexion via curl
+curl -u bitcoin:your_password --data-binary '{"jsonrpc": "1.0", "id": "curltest", "method": "getblockchaininfo", "params": []}' -H 'content-type: text/plain;' http://localhost:18443/
+
+# Connexion via bitcoin-cli
+docker exec bitcoin-signet bitcoin-cli -signet getblockchaininfo
+
+# Vérifier la synchronisation
+docker exec bitcoin-signet bitcoin-cli -signet getblockchaininfo | jq '.verificationprogress'
+```
+
+### 2. Blindbit API
+
+```bash
+# Test de connectivité
+curl -s http://localhost:8000/
+
+# Vérifier le statut
+curl -s http://localhost:8000/status
+
+# Obtenir des filtres
+curl -s http://localhost:8000/filters
+```
+
+### 3. sdk_relay WebSocket
+
+```bash
+# Test de connectivité WebSocket
+curl -v -H "Connection: Upgrade" -H "Upgrade: websocket" -H "Sec-WebSocket-Key: test" http://localhost:8090/
+
+# Test avec wscat (si installé)
+wscat -c ws://localhost:8090
+
+# Test avec Python
+python3 test_websocket_messages.py
+```
+
+## 🧪 Tests et Validation
+
+### 1. Tests de Base
+
+```bash
+# Test de connectivité complet
+./test_final_sync.sh
+
+# Test de synchronisation
+./test_sync_logs.sh
+
+# Test des messages
+./test_messages.sh
+
+# Test des 3 relais
+./test_3_relays.sh
+```
+
+### 2. Tests de Performance
+
+```bash
+# Test de charge WebSocket
+for i in {1..10}; do
+    python3 test_websocket_messages.py &
+done
+wait
+
+# Test de connectivité multiple
+netstat -tlnp | grep -E "(8090|8092|8094)"
+
+# Test de performance
+docker stats --no-stream
+```
+
+### 3. Tests de Sécurité
+
+```bash
+# Vérifier les ports exposés
+netstat -tuln | grep -E "(8090|8092|8094)"
+
+# Vérifier les logs d'accès
+docker logs sdk_relay_1 | grep -E "(ERROR|WARN)" | tail -20
+
+# Vérifier l'utilisation des ressources
+docker stats --no-stream | grep sdk_relay
+```
+
+## 🔧 Configuration et Maintenance
+
+### 1. Modification de Configuration
+
+```bash
+# Modifier la configuration Bitcoin Core
+sudo docker-compose down
+nano bitcoin/bitcoin.conf
+sudo docker-compose up -d bitcoin
+
+# Modifier la configuration Blindbit
+nano blindbit/blindbit.toml
+sudo docker-compose restart blindbit
+
+# Modifier la configuration des relais
+nano sdk_relay/.conf.docker.relay1
+sudo docker-compose restart sdk_relay_1
+```
+
+### 2. Redémarrage des Services
+
+```bash
+# Redémarrage complet
+./restart_4nk_node.sh
+
+# Redémarrage d'un service spécifique
+docker-compose restart bitcoin
+docker-compose restart blindbit
+docker-compose restart sdk_relay_1
+
+# Redémarrage avec reconstruction
+docker-compose down
+docker-compose build --no-cache
+docker-compose up -d
+```
+
+### 3. Sauvegarde et Restauration
+
+```bash
+# Sauvegarde des données
+docker exec bitcoin-signet tar czf /tmp/bitcoin-backup.tar.gz /home/bitcoin/.bitcoin
+docker cp bitcoin-signet:/tmp/bitcoin-backup.tar.gz ./backup/
+
+# Sauvegarde des configurations
+tar czf config-backup.tar.gz sdk_relay/.conf* external_nodes.conf
+
+# Restauration
+docker cp ./backup/bitcoin-backup.tar.gz bitcoin-signet:/tmp/
+docker exec bitcoin-signet tar xzf /tmp/bitcoin-backup.tar.gz -C /
+```
+
+## 🌐 Gestion des Nœuds Externes
+
+### 1. Ajout de Nœuds Externes
+
+```bash
+# Ajouter un nœud externe
+./add_external_node.sh add external-relay-1 external-relay-1.example.com:8090
+
+# Lister les nœuds configurés
+./add_external_node.sh list
+
+# Tester la connectivité
+./add_external_node.sh test external-relay-1
+
+# Supprimer un nœud
+./add_external_node.sh remove external-relay-1
+```
+
+### 2. Configuration Multi-Sites
+
+```bash
+# Site principal
+./add_external_node.sh add site-paris-1 paris-relay-1.4nk.net:8090
+./add_external_node.sh add site-paris-2 paris-relay-2.4nk.net:8090
+
+# Site secondaire
+./add_external_node.sh add site-lyon-1 lyon-relay-1.4nk.net:8090
+./add_external_node.sh add site-lyon-2 lyon-relay-2.4nk.net:8090
+
+# Site de backup
+./add_external_node.sh add backup-1 backup-relay-1.4nk.net:8090
+```
+
+### 3. Test d'Intégration
+
+```bash
+# Test d'intégration complet
+./test_integration_dev3.sh
+
+# Test de connectivité dev3
+python3 test_dev3_simple.py
+
+# Test de connectivité avancé
+python3 test_dev3_connectivity.py
+```
+
+## 📊 Monitoring et Alertes
+
+### 1. Monitoring de Base
+
+```bash
+# Surveillance de la synchronisation
+./monitor_sync.sh
+
+# Monitoring en continu
+while true; do
+    echo "=== $(date) ==="
+    docker stats --no-stream | grep -E "(sdk_relay|bitcoin)"
+    echo "WebSocket connections:"
+    netstat -an | grep :8090 | wc -l
+    sleep 30
+done
+```
+
+### 2. Monitoring Avancé
+
+```bash
+# Script de monitoring complet
+cat > monitor_advanced.sh << 'EOF'
+#!/bin/bash
+while true; do
+    clear
+    echo "=== docv Monitoring ==="
+    echo "Date: $(date)"
+    echo ""
+
+    echo "Services:"
+    docker ps --format "table {{.Names}}\t{{.Status}}\t{{.Ports}}"
+    echo ""
+
+    echo "Ressources:"
+    docker stats --no-stream | grep -E "(sdk_relay|bitcoin|blindbit)"
+    echo ""
+
+    echo "Connexions WebSocket:"
+    netstat -an | grep :8090 | wc -l
+    echo ""
+
+    echo "Espace disque:"
+    df -h | grep -E "(bitcoin|blindbit)"
+    echo ""
+
+    sleep 60
+done
+EOF
+
+chmod +x monitor_advanced.sh
+./monitor_advanced.sh
+```
+
+### 3. Alertes Automatiques
+
+```bash
+# Script d'alerte simple
+cat > alert_monitor.sh << 'EOF'
+#!/bin/bash
+
+# Vérifier Bitcoin Core
+if ! docker ps | grep -q "bitcoin-signet.*Up"; then
+    echo "ALERTE: Bitcoin Core n'est pas en cours d'exécution!"
+fi
+
+# Vérifier les relais
+for i in {1..3}; do
+    if ! docker ps | grep -q "sdk_relay_$i.*Up"; then
+        echo "ALERTE: Relay $i n'est pas en cours d'exécution!"
+    fi
+done
+
+# Vérifier l'espace disque
+if [ $(df / | awk 'NR==2 {print $5}' | sed 's/%//') -gt 90 ]; then
+    echo "ALERTE: Espace disque faible!"
+fi
+EOF
+
+chmod +x alert_monitor.sh
+
+# Ajouter au cron pour surveillance automatique
+echo "*/5 * * * * /path/to/alert_monitor.sh" | crontab -
+```
+
+## 🔒 Sécurité
+
+### 1. Vérification de Sécurité
+
+```bash
+# Vérifier les ports exposés
+netstat -tuln | grep -E "(8090|8092|8094)"
+
+# Vérifier les permissions
+ls -la sdk_relay/.conf*
+ls -la bitcoin/bitcoin.conf
+ls -la blindbit/blindbit.toml
+
+# Vérifier les logs de sécurité
+docker logs sdk_relay_1 | grep -E "(ERROR|WARN|SECURITY)" | tail -20
+```
+
+### 2. Configuration de Pare-feu
+
+```bash
+# Autoriser seulement les ports nécessaires
+sudo ufw allow 18443/tcp  # Bitcoin Core RPC
+sudo ufw allow 8090/tcp   # sdk_relay WebSocket
+sudo ufw allow 8000/tcp   # Blindbit API
+sudo ufw enable
+
+# Vérifier les règles
+sudo ufw status numbered
+```
+
+### 3. Rotation des Logs
+
+```bash
+# Configuration de rotation des logs
+cat > /etc/logrotate.d/4nk-node << EOF
+/var/lib/docker/containers/*/*.log {
+    daily
+    rotate 7
+    compress
+    delaycompress
+    missingok
+    notifempty
+    copytruncate
+}
+EOF
+```
+
+## 🚨 Dépannage
+
+### 1. Problèmes Courants
+
+#### Service Ne Démarre Pas
+
+```bash
+# Vérifier les logs
+docker logs <service_name>
+
+# Vérifier la configuration
+docker exec <service_name> cat /path/to/config
+
+# Redémarrer le service
+docker restart <service_name>
+```
+
+#### Problèmes de Connectivité
+
+```bash
+# Tester la connectivité réseau
+docker exec <service_name> ping <target>
+
+# Vérifier la résolution DNS
+docker exec <service_name> nslookup <target>
+
+# Tester les ports
+docker exec <service_name> nc -z <target> <port>
+```
+
+#### Problèmes de Synchronisation
+
+```bash
+# Vérifier les logs de synchronisation
+docker logs sdk_relay_1 | grep -E "(Sync|Relay|Mesh)"
+
+# Forcer la synchronisation
+docker restart sdk_relay_1 sdk_relay_2 sdk_relay_3
+
+# Vérifier la connectivité entre relais
+./test_sync_logs.sh force
+```
+
+### 2. Logs de Debug
+
+```bash
+# Logs détaillés
+docker-compose logs -f --tail=100
+
+# Logs d'un service spécifique
+docker logs <service_name> -f
+
+# Logs avec timestamps
+docker-compose logs -t
+
+# Logs depuis une date
+docker-compose logs --since="2024-01-01T00:00:00"
+```
+
+### 3. Outils de Debug
+
+```bash
+# Debug du container sdk_relay
+./sdk_relay/debug_container.sh
+
+# Test du healthcheck
+./sdk_relay/test_healthcheck.sh
+
+# Test de connectivité
+./sdk_relay/test_connectivity.sh
+
+# Test simple
+./sdk_relay/test_simple.sh
+```
+
+## 📈 Performance
+
+### 1. Optimisation
+
+```bash
+# Limiter l'utilisation CPU
+docker-compose up -d --scale bitcoin=1
+
+# Optimiser la mémoire
+docker stats --no-stream | grep sdk_relay
+
+# Nettoyer l'espace disque
+docker system prune -f
+```
+
+### 2. Monitoring de Performance
+
+```bash
+# Surveillance des ressources
+docker stats
+
+# Surveillance des connexions
+netstat -an | grep :8090 | wc -l
+
+# Surveillance de l'espace disque
+df -h
+```
+
+### 3. Tests de Charge
+
+```bash
+# Test de charge simple
+for i in {1..50}; do
+    python3 test_websocket_messages.py &
+    sleep 0.1
+done
+wait
+
+# Test de charge avancé
+python3 test_websocket_messages.py --load-test --duration=300
+```
+
+## 🔄 Maintenance
+
+### 1. Sauvegarde Régulière
+
+```bash
+# Script de sauvegarde automatique
+cat > backup_4nk.sh << 'EOF'
+#!/bin/bash
+DATE=$(date +%Y%m%d_%H%M%S)
+BACKUP_DIR="/backup/4nk_node_$DATE"
+
+mkdir -p $BACKUP_DIR
+
+# Sauvegarder les configurations
+cp -r sdk_relay/.conf* $BACKUP_DIR/
+cp external_nodes.conf $BACKUP_DIR/
+
+# Sauvegarder les données Bitcoin
+docker exec bitcoin-signet tar czf /tmp/bitcoin-backup.tar.gz /home/bitcoin/.bitcoin
+docker cp bitcoin-signet:/tmp/bitcoin-backup.tar.gz $BACKUP_DIR/
+
+echo "Sauvegarde terminée: $BACKUP_DIR"
+EOF
+
+chmod +x backup_4nk.sh
+```
+
+### 2. Mise à Jour
+
+```bash
+# Mise à jour de l'infrastructure
+git pull origin main
+./restart_4nk_node.sh
+
+# Mise à jour des images
+docker-compose build --no-cache
+docker-compose up -d
+```
+
+### 3. Nettoyage
+
+```bash
+# Nettoyer les conteneurs arrêtés
+docker container prune -f
+
+# Nettoyer les images non utilisées
+docker image prune -f
+
+# Nettoyer les volumes non utilisés
+docker volume prune -f
+
+# Nettoyer tout
+docker system prune -a -f
+```
+
+## 📝 Checklist Quotidienne
+
+- [ ] Services démarrés et fonctionnels
+- [ ] Bitcoin Core synchronisé
+- [ ] Relais connectés et synchronisés
+- [ ] Tests de connectivité passés
+- [ ] Logs vérifiés (pas d'erreurs critiques)
+- [ ] Ressources système OK
+- [ ] Sauvegarde effectuée (si nécessaire)
+- [ ] Monitoring actif
+
+## 🎯 Commandes Rapides
+
+```bash
+# Démarrage rapide
+./restart_4nk_node.sh
+
+# Statut des services
+docker ps
+
+# Logs en temps réel
+docker-compose logs -f
+
+# Test de connectivité
+./test_final_sync.sh
+
+# Surveillance
+./monitor_sync.sh
+
+# Arrêt propre
+docker-compose down
+```
+
+---
+
+**✨ Infrastructure docv - Utilisation optimale !**
+
+

index.html

@@ -0,0 +1,15 @@
+<!DOCTYPE html>
+<html lang="fr">
+  <head>
+    <meta charset="UTF-8" />
+    <link rel="icon" type="image/svg+xml" href="/placeholder-logo.svg" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>DocV - GED Souveraine et Sécurisée</title>
+    <meta name="description" content="DocV propose une approche révolutionnaire de la gestion d'identité, garantissant sécurité, souveraineté et conformité dans la gestion de vos documents et processus métier." />
+  </head>
+  <body>
+    <div id="root"></div>
+    <script type="module" src="/src/main.tsx"></script>
+  </body>
+</html>
+

lib/4nk/EventBus.ts

@@ -0,0 +1,33 @@
+export default class EventBus {
+  private static instance: EventBus;
+  private listeners: Record<string, Array<(...args: any[]) => void>> = {};
+
+  private constructor() { }
+
+  public static getInstance(): EventBus {
+    if (!EventBus.instance) {
+      EventBus.instance = new EventBus();
+    }
+    return EventBus.instance;
+  }
+
+  public on(event: string, callback: (...args: any[]) => void): () => void {
+    if (!this.listeners[event]) {
+      this.listeners[event] = [];
+    }
+    this.listeners[event].push(callback);
+    return () => {
+      if (this.listeners[event]) {
+        this.listeners[event] = this.listeners[event].filter(cb => cb !== callback);
+      }
+    };
+  }
+
+  public emit(event: string, ...args: any[]): void {
+    if (this.listeners[event]) {
+      this.listeners[event].forEach(callback => {
+        callback(...args);
+      });
+    }
+  }
+}

lib/4nk/IframeReference.ts

@@ -0,0 +1,13 @@
+export default class IframeReference {
+  private static iframe: HTMLIFrameElement | null = null;
+
+  private constructor() { }
+
+  public static setIframe(iframe: HTMLIFrameElement | null): void {
+    this.iframe = iframe;
+  }
+
+  public static getIframe(): HTMLIFrameElement | null {
+    return this.iframe;
+  }
+}

lib/4nk/Loader.tsx

@@ -0,0 +1,23 @@
+import { memo } from 'react';
+
+function Loader({ width = 40 }: { width?: number }) {
+  return (
+    <div style={{ display: 'flex', alignItems: 'center', justifyContent: 'center', width: width }}>
+      <div
+        className='loader'
+        style={{
+          width,
+          height: width,
+          border: '4px solid #eee',
+          borderTop: '4px solid #333',
+          borderRadius: '50%',
+          animation: 'spin 1s linear infinite',
+        }}
+      />
+      <style>{`@keyframes spin { 0% { transform: rotate(0deg);} 100% { transform: rotate(360deg);} }`}</style>
+    </div>
+  );
+}
+
+Loader.displayName = 'Loader';
+export default memo(Loader);

lib/4nk/MessageBus.ts

@@ -0,0 +1,749 @@
+import IframeReference from './IframeReference';
+import EventBus from './EventBus';
+import UserStore from './UserStore';
+import { isProfileData, type ProfileCreated, type ProfileData } from './models/ProfileData';
+import { isFolderData, type FolderCreated, type FolderData } from './models/FolderData';
+import { v4 as uuidv4 } from 'uuid';
+import type { RoleDefinition } from './models/Roles';
+
+export default class MessageBus {
+  private static instance: MessageBus;
+  private readonly origin: string;
+  private messageListener: ((event: MessageEvent) => void) | null = null;
+  private errors: { [key: string]: string } = {};
+  private readyPromise: Promise<void> | null = null;
+  private isReadyFlag = false;
+
+  private constructor(origin: string) {
+    this.origin = origin;
+  }
+
+  public static getInstance(origin: string): MessageBus {
+    if (!MessageBus.instance) {
+      MessageBus.instance = new MessageBus(origin);
+    }
+    return MessageBus.instance;
+  }
+
+  public isReady(): Promise<void> {
+    if (this.isReadyFlag) {
+      return Promise.resolve();
+    }
+
+    if (this.readyPromise) {
+      return this.readyPromise;
+    }
+
+    this.readyPromise = new Promise<void>((resolve) => {
+      const correlationId = uuidv4();
+      this.initMessageListener(correlationId);
+
+      const unsubscribe = EventBus.getInstance().on('IS_READY', (responseId: string) => {
+        if (responseId !== correlationId) return;
+        unsubscribe();
+        this.destroyMessageListener();
+        this.isReadyFlag = true;
+        resolve();
+      });
+    });
+
+    return this.readyPromise;
+  }
+
+  public requestLink(): Promise<void> {
+    return new Promise<void>((resolve: () => void, reject: (error: string) => void) => {
+      const correlationId = uuidv4();
+      this.initMessageListener(correlationId);
+
+      const unsubscribe = EventBus.getInstance().on('LINK_ACCEPTED', (responseId: string, accessToken: string, refreshToken: string) => {
+        if (responseId !== correlationId) {
+          return;
+        }
+        unsubscribe();
+        this.destroyMessageListener();
+        UserStore.getInstance().connect(accessToken, refreshToken);
+        resolve();
+      });
+
+      const unsubscribeError = EventBus.getInstance().on('ERROR_LINK_ACCEPTED', (responseId: string, error: string) => {
+        if (responseId !== correlationId) {
+          return;
+        }
+        unsubscribeError();
+        this.destroyMessageListener();
+        reject(error);
+      });
+
+      this.sendMessage({
+        type: 'REQUEST_LINK'
+      });
+    });
+  }
+
+  public getUserPairingId(): Promise<string> {
+    return new Promise<string>((resolve: (userPairingId: string) => void, reject: (error: string) => void) => {
+      this.checkToken().then(() => {
+        const userStore = UserStore.getInstance();
+        const accessToken = userStore.getAccessToken()!;
+
+        const correlationId = uuidv4();
+        this.initMessageListener(correlationId);
+
+        const unsubscribe = EventBus.getInstance().on('PAIRING_ID', (responseId: string, userPairingId: string) => {
+          if (responseId !== correlationId) {
+            return;
+          }
+          unsubscribe();
+          this.destroyMessageListener();
+          resolve(userPairingId);
+        });
+
+        const unsubscribeError = EventBus.getInstance().on('ERROR_PAIRING_ID', (responseId: string, error: string) => {
+          if (responseId !== correlationId) {
+            return;
+          }
+          unsubscribeError();
+          this.destroyMessageListener();
+          reject(error);
+        });
+
+        this.sendMessage({
+          type: 'GET_PAIRING_ID',
+          accessToken,
+        });
+      }).catch(console.error);
+    });
+  }
+
+  public validateToken(): Promise<boolean> {
+    return new Promise<boolean>((resolve: (isValid: boolean) => void, reject: (error: string) => void) => {
+      const userStore = UserStore.getInstance();
+      if (!userStore.isConnected()) {
+        reject('User is not connected');
+        return;
+      }
+      const accessToken = userStore.getAccessToken()!;
+      const refreshToken = userStore.getRefreshToken()!;
+
+      const correlationId = uuidv4();
+      this.initMessageListener(correlationId);
+
+      const unsubscribe = EventBus.getInstance().on('TOKEN_VALIDATED', (responseId: string, isValid: boolean) => {
+        if (responseId !== correlationId) {
+          return;
+        }
+        unsubscribe();
+        this.destroyMessageListener();
+        resolve(isValid);
+      });
+
+      const unsubscribeError = EventBus.getInstance().on('ERROR_TOKEN_VALIDATED', (responseId: string, error: string) => {
+        if (responseId !== correlationId) {
+          return;
+        }
+        unsubscribeError();
+        this.destroyMessageListener();
+        reject(error);
+      });
+
+      this.sendMessage({
+        type: 'VALIDATE_TOKEN',
+        accessToken,
+        refreshToken
+      });
+    });
+  }
+
+  public renewToken(): Promise<void> {
+    return new Promise<void>((resolve: () => void, reject: (error: string) => void) => {
+      const userStore = UserStore.getInstance();
+      if (!userStore.isConnected()) {
+        reject('User is not connected');
+        return;
+      }
+      const refreshToken = userStore.getRefreshToken()!;
+
+      const correlationId = uuidv4();
+      this.initMessageListener(correlationId);
+
+      const unsubscribe = EventBus.getInstance().on('TOKEN_RENEWED', (responseId: string, accessToken: string, refreshToken: string) => {
+        if (responseId !== correlationId) {
+          return;
+        }
+        unsubscribe();
+        this.destroyMessageListener();
+        UserStore.getInstance().connect(accessToken, refreshToken);
+        resolve();
+      });
+
+      const unsubscribeError = EventBus.getInstance().on('ERROR_TOKEN_RENEWED', (responseId: string, error: string) => {
+        if (responseId !== correlationId) {
+          return;
+        }
+        unsubscribeError();
+        this.destroyMessageListener();
+        reject(error);
+      });
+
+      this.sendMessage({
+        type: 'RENEW_TOKEN',
+        refreshToken
+      });
+    });
+  }
+
+  public getProcesses(): Promise<any> {
+    return new Promise<any>((resolve: (processes: any) => void, reject: (error: string) => void) => {
+      this.checkToken().then(() => {
+        const userStore = UserStore.getInstance();
+        const accessToken = userStore.getAccessToken()!;
+
+        const correlationId = uuidv4();
+        console.log(correlationId);
+        this.initMessageListener(correlationId);
+
+        const unsubscribe = EventBus.getInstance().on('PROCESSES_RETRIEVED', (responseId: string, processes: any) => {
+          console.log(responseId);
+          if (responseId !== correlationId) {
+            return;
+          }
+          unsubscribe();
+          this.destroyMessageListener();
+          resolve(processes);
+        });
+
+        const unsubscribeError = EventBus.getInstance().on('ERROR_PROCESSES_RETRIEVED', (responseId: string, error: string) => {
+          if (responseId !== correlationId) {
+            return;
+          }
+          unsubscribeError();
+          this.destroyMessageListener();
+          reject(error);
+        });
+
+        this.sendMessage({
+          type: 'GET_PROCESSES',
+          accessToken,
+        });
+      }).catch(console.error);
+    });
+  }
+
+  public getMyProcesses(): Promise<string[]> {
+    return new Promise<string[]>((resolve: (myProcesses: string[]) => void, reject: (error: string) => void) => {
+      this.checkToken().then(() => {
+        const userStore = UserStore.getInstance();
+        const accessToken = userStore.getAccessToken()!;
+
+        const correlationId = uuidv4();
+        this.initMessageListener(correlationId);
+
+        const unsubscribe = EventBus.getInstance().on('GET_MY_PROCESSES', (responseId: string, myProcesses: string[]) => {
+          if (responseId !== correlationId) {
+            return;
+          }
+          unsubscribe();
+          this.destroyMessageListener();
+          resolve(myProcesses);
+        });
+
+        const unsubscribeError = EventBus.getInstance().on('ERROR_GET_MY_PROCESSES', (responseId: string, error: string) => {
+          if (responseId !== correlationId) {
+            return;
+          }
+          unsubscribeError();
+          this.destroyMessageListener();
+          reject(error);
+        });
+
+        this.sendMessage({
+          type: 'GET_MY_PROCESSES',
+          accessToken,
+        });
+      }).catch(console.error);
+    });
+  }
+
+  public getData(processId: string, stateId: string): Promise<Record<string, any>> {
+    return new Promise<Record<string, any>>((resolve: (data: Record<string, any>) => void, reject: (error: string) => void) => {
+      this.checkToken().then(() => {
+        const userStore = UserStore.getInstance();
+        const accessToken = userStore.getAccessToken()!;
+
+        const correlationId = uuidv4();
+        this.initMessageListener(correlationId);
+
+        const unsubscribe = EventBus.getInstance().on('DATA_RETRIEVED', (responseId: string, data: Record<string, any>) => {
+          if (responseId !== correlationId) {
+            return;
+          }
+          unsubscribe();
+          this.destroyMessageListener();
+          resolve(data);
+        });
+
+        const unsubscribeError = EventBus.getInstance().on('ERROR_DATA_RETRIEVED', (responseId: string, error: string) => {
+          if (responseId !== correlationId) {
+            return;
+          }
+          unsubscribeError();
+          this.destroyMessageListener();
+          reject(error);
+        });
+
+        this.sendMessage({
+          type: 'RETRIEVE_DATA',
+          processId,
+          stateId,
+          accessToken
+        });
+      }).catch(console.error);
+    });
+  }
+
+  public getPublicData(encodedData: number[]): Promise<any> {
+    return new Promise<any>((resolve: (data: any) => void, reject: (error: string) => void) => {
+      this.checkToken().then(() => {
+        const userStore = UserStore.getInstance();
+        const accessToken = userStore.getAccessToken()!;
+
+        const correlationId = uuidv4();
+        this.initMessageListener(correlationId);
+
+        const unsubscribe = EventBus.getInstance().on('PUBLIC_DATA_DECODED', (responseId: string, data: any) => {
+          if (responseId !== correlationId) {
+            return;
+          }
+          unsubscribe();
+          this.destroyMessageListener();
+          resolve(data);
+        });
+
+        const unsubscribeError = EventBus.getInstance().on('ERROR_PUBLIC_DATA_DECODED', (responseId: string, error: string) => {
+          if (responseId !== correlationId) {
+            return;
+          }
+          unsubscribeError();
+          this.destroyMessageListener();
+          reject(error);
+        });
+
+        this.sendMessage({
+          type: 'DECODE_PUBLIC_DATA',
+          encodedData,
+          accessToken
+        });
+      }).catch(console.error);
+    });
+  }
+
+  public createProfile(profileData: ProfileData, profilePrivateData: string[], roles: Record<string, RoleDefinition>): Promise<ProfileCreated> {
+    return new Promise<ProfileCreated>((resolve: (profileCreated: ProfileCreated) => void, reject: (error: string) => void) => {
+      this.checkToken().then(() => {
+        const userStore = UserStore.getInstance();
+        const accessToken = userStore.getAccessToken()!;
+
+        const correlationId = uuidv4();
+        this.initMessageListener(correlationId);
+
+        const unsubscribe = EventBus.getInstance().on('PROCESS_CREATED', (responseId: string, processCreated: any) => {
+          if (responseId !== correlationId) {
+            return;
+          }
+          unsubscribe();
+          this.destroyMessageListener();
+          // Return value must contain the data commited in the new process
+          const profileData = processCreated.processData;
+          if (!profileData || !isProfileData(profileData)) {
+            reject('Returned invalid profile data');
+          }
+          if (!processCreated.processId || typeof processCreated.processId !== 'string') {
+            console.error('Returned invalid process id');
+            reject('Returned invalid process id');
+          }
+          // TODO check that process is of type Process
+
+          const profileCreated: ProfileCreated = {
+            processId: processCreated.processId,
+            process: processCreated.process,
+            profileData
+          };
+
+          resolve(profileCreated);
+        });
+
+        const unsubscribeError = EventBus.getInstance().on('ERROR_PROCESS_CREATED', (responseId: string, error: string) => {
+          if (responseId !== correlationId) {
+            return;
+          }
+          unsubscribeError();
+          this.destroyMessageListener();
+          reject(error);
+        });
+
+        this.sendMessage({
+          type: 'CREATE_PROCESS',
+          processData: profileData,
+          privateFields: profilePrivateData,
+          roles,
+          accessToken
+        });
+      }).catch(console.error);
+    });
+  }
+
+  public createFolder(folderData: FolderData, folderPrivateData: string[], roles: Record<string, RoleDefinition>): Promise<FolderCreated> {
+    return new Promise<FolderCreated>((resolve: (folderData: FolderCreated) => void, reject: (error: string) => void) => {
+      this.checkToken().then(() => {
+        const userStore = UserStore.getInstance();
+        const accessToken = userStore.getAccessToken()!;
+
+        const correlationId = uuidv4();
+        this.initMessageListener(correlationId);
+
+        const unsubscribe = EventBus.getInstance().on('PROCESS_CREATED', (responseId: string, processCreated: any) => {
+          if (responseId !== correlationId) {
+            return;
+          }
+          unsubscribe();
+          this.destroyMessageListener();
+          // Return value must contain the data commited in the new process
+          const folderData = processCreated.processData;
+          if (!folderData || !isFolderData(folderData)) reject('Returned invalid process data');
+          if (!processCreated.processId || typeof processCreated.processId !== 'string') reject('Returned invalid process id');
+          // TODO check that process is of type Process
+
+          const folderCreated: FolderCreated = {
+            processId: processCreated.processId,
+            process: processCreated.process,
+            folderData
+          };
+
+          resolve(folderCreated);
+        });
+
+        const unsubscribeError = EventBus.getInstance().on('ERROR_PROCESS_CREATED', (responseId: string, error: string) => {
+          if (responseId !== correlationId) {
+            return;
+          }
+          unsubscribeError();
+          this.destroyMessageListener();
+          reject(error);
+        });
+
+        this.sendMessage({
+          type: 'CREATE_PROCESS',
+          processData: folderData,
+          privateFields: folderPrivateData,
+          roles,
+          accessToken
+        });
+      }).catch(console.error);
+    });
+  }
+
+  public updateProcess(processId: string, lastStateId: string, newData: Record<string, any>, privateFields: string[], roles: Record<string, RoleDefinition> | null): Promise<any> {
+    return new Promise<any>((resolve: (updatedProcess: any) => void, reject: (error: string) => void) => {
+      this.checkToken().then(() => {
+        const userStore = UserStore.getInstance();
+        const accessToken = userStore.getAccessToken()!;
+
+        const correlationId = uuidv4();
+        this.initMessageListener(correlationId);
+
+        const unsubscribe = EventBus.getInstance().on('PROCESS_UPDATED', (responseId: string, updatedProcess: any) => {
+          console.log('PROCESS_UPDATED', updatedProcess);
+          if (responseId !== correlationId) {
+            return;
+          }
+          unsubscribe();
+          this.destroyMessageListener();
+          resolve(updatedProcess);
+        });
+
+        const unsubscribeError = EventBus.getInstance().on('ERROR_PROCESS_UPDATED', (responseId: string, error: string) => {
+          if (responseId !== correlationId) {
+            return;
+          }
+          unsubscribeError();
+          this.destroyMessageListener();
+          reject(error);
+        });
+
+        this.sendMessage({
+          type: 'UPDATE_PROCESS',
+          processId,
+          lastStateId,
+          newData,
+          privateFields,
+          roles,
+          accessToken
+        });
+      }).catch(console.error);
+    });
+  }
+
+  public notifyProcessUpdate(processId: string, stateId: string): Promise<void> {
+    return new Promise<void>((resolve: () => void, reject: (error: string) => void) => {
+      this.checkToken().then(() => {
+        const userStore = UserStore.getInstance();
+        const accessToken = userStore.getAccessToken()!;
+
+        const correlationId = uuidv4();
+        this.initMessageListener(correlationId);
+
+        const unsubscribe = EventBus.getInstance().on('UPDATE_NOTIFIED', (responseId: string) => {
+          if (responseId !== correlationId) {
+            return;
+          }
+          unsubscribe();
+          this.destroyMessageListener();
+          resolve();
+        });
+
+        const unsubscribeError = EventBus.getInstance().on('ERROR_UPDATE_NOTIFIED', (responseId: string, error: string) => {
+          if (responseId !== correlationId) {
+            return;
+          }
+          unsubscribeError();
+          this.destroyMessageListener();
+          reject(error);
+        });
+
+        this.sendMessage({
+          type: 'NOTIFY_UPDATE',
+          processId,
+          stateId,
+          accessToken
+        });
+      }).catch(console.error);
+    });
+  }
+
+  public validateState(processId: string, stateId: string): Promise<any> {
+    return new Promise<any>((resolve: (updatedProcess: any) => void, reject: (error: string) => void) => {
+      this.checkToken().then(() => {
+        const userStore = UserStore.getInstance();
+        const accessToken = userStore.getAccessToken()!;
+
+        const correlationId = uuidv4();
+        this.initMessageListener(correlationId);
+
+        const unsubscribe = EventBus.getInstance().on('STATE_VALIDATED', (responseId: string, updatedProcess: any) => {
+          console.log(updatedProcess);
+          if (responseId !== correlationId) {
+            return;
+          }
+          unsubscribe();
+          this.destroyMessageListener();
+          resolve(updatedProcess);
+        });
+
+        const unsubscribeError = EventBus.getInstance().on('ERROR_STATE_VALIDATED', (responseId: string, error: string) => {
+          if (responseId !== correlationId) {
+            return;
+          }
+          unsubscribeError();
+          this.destroyMessageListener();
+          reject(error);
+        });
+
+        this.sendMessage({
+          type: 'VALIDATE_STATE',
+          processId,
+          stateId,
+          accessToken
+        });
+      }).catch(console.error);
+    });
+  }
+
+  private checkToken(): Promise<void> {
+    return new Promise<void>((resolve: () => void, reject: (error: string) => void) => {
+      this.validateToken().then((isValid: boolean) => {
+        if (!isValid) {
+          this.renewToken().then(resolve).catch(reject);
+        } else {
+          resolve();
+        }
+      }).catch(reject);
+    });
+  }
+
+  private sendMessage(message: any): void {
+    const iframe = IframeReference.getIframe();
+    if (!iframe) {
+      console.error('[MessageBus] sendMessage: iframe not found');
+      return;
+    }
+    console.log('[MessageBus] sendMessage:', message);
+    iframe.contentWindow?.postMessage(message, this.origin);
+  }
+
+  private initMessageListener(correlationId: string): void {
+    this.destroyMessageListener();
+
+    this.messageListener = this.handleMessage.bind(this, correlationId);
+    window.addEventListener('message', this.messageListener);
+  }
+
+  private destroyMessageListener(): void {
+    if (this.messageListener) {
+      window.removeEventListener('message', this.messageListener);
+      this.messageListener = null;
+    }
+  }
+
+  private handleMessage(correlationId: string, event: MessageEvent): void {
+    if (event.origin !== this.origin) {
+      return;
+    }
+
+    if (!event.data || typeof event.data !== 'object') {
+      return;
+    }
+
+    const message = event.data;
+    switch (message.type) {
+      case 'LISTENING':
+        EventBus.getInstance().emit('IS_READY', correlationId);
+        break;
+
+      case 'LINK_ACCEPTED':
+        if (this.errors[correlationId]) {
+          const error = this.errors[correlationId];
+          delete this.errors[correlationId];
+          EventBus.getInstance().emit('ERROR_LINK_ACCEPTED', correlationId, error);
+          return;
+        }
+        EventBus.getInstance().emit('MESSAGE_RECEIVED', message);
+        EventBus.getInstance().emit('LINK_ACCEPTED', correlationId, message.accessToken, message.refreshToken);
+        break;
+
+      case 'VALIDATE_TOKEN':
+        if (this.errors[correlationId]) {
+          const error = this.errors[correlationId];
+          delete this.errors[correlationId];
+          EventBus.getInstance().emit('ERROR_TOKEN_VALIDATED', correlationId, error);
+          return;
+        }
+        EventBus.getInstance().emit('MESSAGE_RECEIVED', message);
+        EventBus.getInstance().emit('TOKEN_VALIDATED', correlationId, message.isValid);
+        break;
+
+      case 'RENEW_TOKEN':
+        if (this.errors[correlationId]) {
+          const error = this.errors[correlationId];
+          delete this.errors[correlationId];
+          EventBus.getInstance().emit('ERROR_TOKEN_RENEWED', correlationId, error);
+          return;
+        }
+        EventBus.getInstance().emit('MESSAGE_RECEIVED', message);
+        EventBus.getInstance().emit('TOKEN_RENEWED', correlationId, message.accessToken, message.refreshToken);
+        break;
+
+      case 'GET_PAIRING_ID':
+        if (this.errors[correlationId]) {
+          const error = this.errors[correlationId];
+          delete this.errors[correlationId];
+          EventBus.getInstance().emit('ERROR_PAIRING_ID', correlationId, error);
+          return;
+        }
+        EventBus.getInstance().emit('MESSAGE_RECEIVED', message);
+        EventBus.getInstance().emit('PAIRING_ID', correlationId, message.userPairingId);
+        break;
+
+      case 'PROCESSES_RETRIEVED': // GET_PROCESSES
+        if (this.errors[correlationId]) {
+          const error = this.errors[correlationId];
+          delete this.errors[correlationId];
+          EventBus.getInstance().emit('ERROR_PROCESSES_RETRIEVED', correlationId, error);
+          return;
+        }
+        EventBus.getInstance().emit('PROCESSES_RETRIEVED', correlationId, message.processes);
+        break;
+
+      case 'GET_MY_PROCESSES': 
+        if (this.errors[correlationId]) {
+          const error = this.errors[correlationId];
+          delete this.errors[correlationId];
+          EventBus.getInstance().emit('ERROR_GET_MY_PROCESSES', correlationId, error);
+          return;
+        }
+        EventBus.getInstance().emit('GET_MY_PROCESSES', correlationId, message.myProcesses);
+        break;
+
+      case 'DATA_RETRIEVED': // RETRIEVE_DATA
+        if (this.errors[correlationId]) {
+          const error = this.errors[correlationId];
+          delete this.errors[correlationId];
+          EventBus.getInstance().emit('ERROR_DATA_RETRIEVED', correlationId, error);
+          return;
+        }
+        EventBus.getInstance().emit('MESSAGE_RECEIVED', message);
+        EventBus.getInstance().emit('DATA_RETRIEVED', correlationId, message.data);
+        break;
+
+      case 'PROCESS_CREATED':
+        if (this.errors[correlationId]) {
+          const error = this.errors[correlationId];
+          delete this.errors[correlationId];
+          EventBus.getInstance().emit('ERROR_PROCESS_CREATED', correlationId, error);
+          return;
+        }
+        EventBus.getInstance().emit('MESSAGE_RECEIVED', message);
+        EventBus.getInstance().emit('PROCESS_CREATED', correlationId, message.processCreated);
+        break;
+
+      case 'UPDATE_NOTIFIED':
+        if (this.errors[correlationId]) {
+          const error = this.errors[correlationId];
+          delete this.errors[correlationId];
+          EventBus.getInstance().emit('ERROR_UPDATE_NOTIFIED', correlationId, error);
+          return;
+        }
+        EventBus.getInstance().emit('MESSAGE_RECEIVED', message);
+        EventBus.getInstance().emit('UPDATE_NOTIFIED', correlationId);
+        break;
+        
+      case 'STATE_VALIDATED':
+        if (this.errors[correlationId]) {
+          const error = this.errors[correlationId];
+          delete this.errors[correlationId];
+          EventBus.getInstance().emit('ERROR_STATE_VALIDATED', correlationId, error);
+          return;
+        }
+        EventBus.getInstance().emit('MESSAGE_RECEIVED', message);
+        EventBus.getInstance().emit('STATE_VALIDATED', correlationId, message.validatedProcess);
+        break;
+
+      case 'PROCESS_UPDATED':
+        if (this.errors[correlationId]) {
+          const error = this.errors[correlationId];
+          delete this.errors[correlationId];
+          EventBus.getInstance().emit('ERROR_PROCESS_UPDATED', correlationId, error);
+          return;
+        }
+        console.log('PROCESS_UPDATED', message);
+        EventBus.getInstance().emit('MESSAGE_RECEIVED', message);
+        EventBus.getInstance().emit('PROCESS_UPDATED', correlationId, message.updatedProcess);
+        break;
+
+      case 'PUBLIC_DATA_DECODED':
+        if (this.errors[correlationId]) {
+          const error = this.errors[correlationId];
+          delete this.errors[correlationId];
+          EventBus.getInstance().emit('ERROR_PUBLIC_DATA_DECODED', correlationId, error);
+          return;
+        }
+        EventBus.getInstance().emit('MESSAGE_RECEIVED', message);
+        EventBus.getInstance().emit('PUBLIC_DATA_DECODED', correlationId, message.decodedData);
+        break;
+        
+      case 'ERROR':
+        console.error('Error:', message);
+        this.errors[correlationId] = message.error;
+        break;
+    }
+  }
+}

lib/4nk/UserStore.ts

@@ -0,0 +1,43 @@
+export default class UserStore {
+  private static instance: UserStore;
+
+  private constructor() { }
+
+  public static getInstance(): UserStore {
+    if (!UserStore.instance) {
+      UserStore.instance = new UserStore();
+    }
+    return UserStore.instance;
+  }
+
+  public connect(accessToken: string, refreshToken: string): void {
+    sessionStorage.setItem('accessToken', accessToken);
+    sessionStorage.setItem('refreshToken', refreshToken);
+  }
+
+  public isConnected(): boolean {
+    return sessionStorage.getItem('accessToken') !== null && sessionStorage.getItem('refreshToken') !== null;
+  }
+
+  public disconnect(): void {
+    sessionStorage.removeItem('accessToken');
+    sessionStorage.removeItem('refreshToken');
+    sessionStorage.removeItem('userPairingId');
+  }
+
+  public getAccessToken(): string | null {
+    return sessionStorage.getItem('accessToken');
+  }
+
+  public getRefreshToken(): string | null {
+    return sessionStorage.getItem('refreshToken');
+  }
+
+  public pair(userPairingId: string): void {
+    sessionStorage.setItem('userPairingId', userPairingId);
+  }
+
+  public getUserPairingId(): string | null {
+    return sessionStorage.getItem('userPairingId');
+  }
+}

lib/4nk/models/Data.ts

@@ -0,0 +1,15 @@
+export interface FileBlob {
+  type: string,
+  data: Uint8Array
+};
+
+export function isFileBlob(data: any): data is FileBlob {
+  return (
+    typeof data === 'object' &&
+    data !== null &&
+    'type' in data &&
+    typeof data.type === 'string' &&
+    'data' in data &&
+    data.data instanceof Uint8Array
+  );
+}

lib/4nk/models/FolderData.ts

@@ -0,0 +1,137 @@
+import { isFileBlob, type FileBlob } from "./Data";
+import type { RoleDefinition } from "./Roles";
+
+export interface FolderData {
+  folderNumber: string;
+  name: string;
+  deedType: string;
+  description: string;
+  archived_description: string;
+  status: string;
+  created_at: string;
+  updated_at: string;
+  customers: string[];
+  documents: FileBlob[];
+  motes: string[];
+  stakeholders: string[];
+}
+
+export function isFolderData(data: any): data is FolderData {
+  if (typeof data !== 'object' || data === null) return false;
+
+  const requiredStringFields = [
+    'folderNumber',
+    'name',
+    'deedType',
+    'description',
+    'archived_description',
+    'status',
+    'created_at',
+    'updated_at'
+  ];
+
+  for (const field of requiredStringFields) {
+    if (typeof data[field] !== 'string') return false;
+  }
+
+  const requiredArrayFields = [
+    'customers',
+    'motes',
+    'stakeholders'
+  ];
+
+  for (const field of requiredArrayFields) {
+    if (!Array.isArray(data[field]) || !data[field].every((item: any) => typeof item === 'string')) {
+      return false;
+    }
+  }
+
+  const requiredFileBlobArrayFields = [
+    'documents',
+  ];
+
+  for (const field of requiredFileBlobArrayFields) {
+    if (!Array.isArray(data[field])) return false;
+    if (data[field].length > 0 && !data[field].every(isFileBlob)) return false;
+  }
+
+  return true;
+}
+
+const emptyFolderData: FolderData = {
+  folderNumber: '',
+  name: '',
+  deedType: '',
+  description: '',
+  archived_description: '',
+  status: '',
+  created_at: '',
+  updated_at: '',
+  customers: [],
+  documents: [],
+  motes: [],
+  stakeholders: []
+};
+
+const folderDataFields: string[] = Object.keys(emptyFolderData);
+
+const FolderPublicFields: string[] = [];
+
+// All the attributes are private in that case
+export const FolderPrivateFields = [
+  ...folderDataFields.filter(key => !FolderPublicFields.includes(key))
+];
+
+export interface FolderCreated {
+  processId: string,
+  process: any, // Process
+  folderData: FolderData,
+}
+
+export function setDefaultFolderRoles(ownerId: string, stakeholdersId: string[], customersId: string[]): Record<string, RoleDefinition> {
+  return {
+    demiurge: {
+      members: [ownerId],
+      validation_rules: [],
+      storages: []
+    },
+    owner: {
+      members: [ownerId],
+      validation_rules: [
+        {
+          quorum: 0.5,
+          fields: [...folderDataFields, 'roles'],
+          min_sig_member: 1,
+        },
+      ],
+      storages: []
+    },
+    stakeholders: {
+      members: stakeholdersId,
+      validation_rules: [
+        {
+          quorum: 0.5,
+          fields: ['documents', 'motes'],
+          min_sig_member: 1,
+        },
+      ],
+      storages: []
+    },
+    customers: {
+      members: customersId,
+      validation_rules: [
+        {
+          quorum: 0.0,
+          fields: folderDataFields,
+          min_sig_member: 0.0,
+        },
+      ],
+      storages: []
+    },
+    apophis: {
+      members: [ownerId],
+      validation_rules: [],
+      storages: []
+    }
+  }
+};

lib/4nk/models/ProfileData.ts

@@ -0,0 +1,122 @@
+import { isFileBlob, type FileBlob } from "./Data";
+import type { RoleDefinition } from "./Roles";
+
+export interface ProfileData {
+  name: string;
+  surname: string;
+  email: string;
+  phone: string;
+  address: string;
+  postalCode: string;
+  city: string;
+  country: string;
+  idDocument: FileBlob | null;
+  idCertified: boolean;
+}
+
+export function isProfileData(data: any): data is ProfileData{
+  if (typeof data !== 'object' || data === null) return false;
+
+  const requiredStringFields = [
+    'name',
+    'surname',
+    'email',
+    'phone',
+    'address',
+    'postalCode',
+    'city',
+    'country',
+  ];
+
+  for (const field of requiredStringFields) {
+    if (typeof data[field] !== 'string') return false;
+  }
+
+  const requiredBooleanFields = [
+    'idCertified',
+  ];
+
+  for (const field of requiredBooleanFields) {
+    if (typeof data[field] !== 'boolean') return false;
+  }
+
+  const requiredFileFields = [
+    'idDocument',
+  ];
+
+  for (const field of requiredFileFields) {
+    if (!isFileBlob(data[field]) && data[field] !== null) return false;
+  }
+
+  return true;
+}
+
+const emptyProfileData: ProfileData = {
+  name: '',
+  surname: '',
+  email: '',
+  phone: '',
+  address: '',
+  postalCode: '',
+  city: '',
+  country: '',
+  idDocument: null,
+  idCertified: false,
+};
+
+const profileDataFields: string[] = Object.keys(emptyProfileData);
+
+const ProfilePublicFields: string[] = ['idCertified'];
+
+export const ProfilePrivateFields = [
+  ...profileDataFields.filter(key => !ProfilePublicFields.includes(key))
+];
+
+export interface ProfileCreated {
+  processId: string,
+  process: any, // Process
+  profileData: ProfileData,
+}
+
+export function setDefaultProfileRoles(ownerId: string[], validatorId: string): Record<string, RoleDefinition> {
+  return {
+    demiurge: {
+      members: [...ownerId, validatorId],
+      validation_rules: [],
+      storages: []
+    },
+    owner: {
+      members: ownerId,
+      validation_rules: [
+        {
+          quorum: 0.5,
+          fields: [...ProfilePrivateFields, 'roles'],
+          min_sig_member: 1,
+        },
+      ],
+      storages: []
+    },
+    validator: {
+      members: [validatorId],
+      validation_rules: [
+        {
+          quorum: 0.5,
+          fields: ['idCertified', 'roles'],
+          min_sig_member: 1,
+        },
+        {
+          quorum: 0.0,
+          fields: [...profileDataFields],
+          min_sig_member: 0,
+        },
+      ],
+      storages: []
+    },
+    apophis: {
+      members: ownerId,
+      validation_rules: [],
+      storages: []
+    }
+  }
+};
+