feat: Mise à jour de l'index de documentation et suppression des templates génériques

.cursor/rules/05-template-governance.mdc

@@ -0,0 +1,17 @@
+---
+alwaysApply: true
+---
+
+# Gouvernance du template 4NK
+
+[portée]
+Assurer que chaque projet adapte intelligemment le template et que les améliorations génériques reviennent dans `4NK_template`.
+
+[directives]
+- Conserver `security-audit` et `release-guard` dans tous projets.
+- Adapter la CI, les docs et `AGENTS.md` au contexte local.
+- En cas d'amélioration générique : ouvrir une issue "Template Feedback", prototyper, valider CI, mettre à jour `CHANGELOG.md`/`TEMPLATE_VERSION`.
+
+[validation]
+- Refuser un push/tag si l'adaptation a retiré les vérifications minimales (sécurité, tests, build, version/changelog/tag).
+- Exiger une documentation claire dans `docs/TEMPLATE_ADAPTATION.md` et `docs/TEMPLATE_FEEDBACK.md`.

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

@@ -1,3 +1,8 @@
+# Règles SSH & Automatisation — Flux local
+
+- Interdiction de secrets en clair; secrets via `~/.4nk_template/.env` ou variables CI
+- Scripts SSH conservés exécutables, journaux non sensibles
+- Le flux local prime: agents exécutés avant merge/push/release; CI neutralisable via `CI_SKIP=true` et `[skip ci]`
 ---
 alwaysApply: true
 ---

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

@@ -25,6 +25,9 @@ Tous les projets issus de 4NK_project_template. Contrôle de l’alignement sur
 - 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.
 
+[note]
+Les validations CI peuvent être remplacées par l’exécution locale des agents (AUTO_FIX/SCOPE) lorsque `CI_SKIP=true` est activé. Conserver une PR de synthèse et la traçabilité dans le changelog.
+
 [artefacts concernés]
 - .4nk-sync.yml, TEMPLATE_VERSION, .cursor/**, .gitea/**, AGENTS.md, scripts/**, docs/SSH_UPDATE.md, CHANGELOG.md.
 # Synchronisation de template (4NK)
@@ -49,5 +52,8 @@ Tous les projets issus de 4NK_project_template. Contrôle de l’alignement sur
 - 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.
 
+[note]
+Les validations CI peuvent être remplacées par l’exécution locale des agents (AUTO_FIX/SCOPE) lorsque `CI_SKIP=true` est activé. Conserver une PR de synthèse et la traçabilité dans le changelog.
+
 [artefacts concernés]
 - .4nk-sync.yml, TEMPLATE_VERSION, .cursor/**, .gitea/**, AGENTS.md, scripts/**, docs/SSH_UPDATE.md, CHANGELOG.md.

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

@@ -2,10 +2,10 @@
 alwaysApply: true
 ---
 
-# Garde de release: tests, documentation, compilation, version, changelog, tag
+# Garde de release: tests, documentation, compilation, sécurité, 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).
+Contrôler systématiquement avant push/tag: tests verts, docs mises à jour, build OK, audit de sécurité OK, alignement numéro de version ↔ changelog ↔ tag git, mise à jour de déploiement, confirmation utilisateur (latest vs wip).
 
 [objectifs]
 
@@ -15,7 +15,7 @@ Contrôler systématiquement avant push/tag: tests verts, docs mises à jour, bu
 
 [directives]
 
-- Avant push/tag, exécuter: tests, compilation, lints (si configurés).
+- Avant push/tag, exécuter: tests, compilation, lints (si configurés), audit de sécurité (npm audit/cargo audit + scan secrets).
 - 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).
@@ -27,6 +27,7 @@ Contrôler systématiquement avant push/tag: tests verts, docs mises à jour, bu
 
 - Refuser push/tag si:
   - tests/compilation échouent,
+  - audit de sécurité échoue (vulnérabilités bloquantes ou secrets détectés),
   - CHANGELOG non mis à jour,
   - VERSION/TEMPLATE_VERSION absent ou incohérent,
   - release type non fourni (ni latest, ni wip).
@@ -34,4 +35,3 @@ Contrôler systématiquement avant push/tag: tests verts, docs mises à jour, bu
 [artefacts concernés]
 
 - CHANGELOG.md, VERSION ou TEMPLATE_VERSION, docs/**, .gitea/workflows/**, scripts/**.
-

.cursor/rules/98-explain-complex-commands

@@ -0,0 +1,5 @@
+---
+alwaysApply: true
+---
+
+quand tu fais une commande ou un requète complexe, explique là avant de la lancer

.cursor/rules/99-lint-markdow.mdc

@@ -0,0 +1,9 @@
+---
+description:
+globs:
+alwaysApply: true
+---
+
+# Lint
+
+respecter strictement les règles de lint du markdown

.cursor/rules/ruleset-index.md

@@ -9,7 +9,8 @@
 - 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).
+- 85-release-guard.mdc : garde de release (tests/doc/build/sécurité/version/changelog/tag; latest vs wip).
+- 05-template-governance.mdc : adaptation locale et feedback vers `4NK_template`.
 - 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.
 

.cursorignore

@@ -20,3 +20,5 @@ tests/reports/
 # Ne pas ignorer .cursor ni AGENTS.md
 !/.cursor
 !/AGENTS.md
+
+

.gitea/ISSUE_TEMPLATE/bug_report.md

@@ -40,11 +40,13 @@ Si applicable, ajoutez une capture d'écran pour expliquer votre problème.
 ## 📋 Configuration
 
 ### Services Actifs
+
 ```bash
 docker ps
 ```
 
 ### Variables d'Environnement
+
 ```bash
 # Bitcoin Core
 BITCOIN_NETWORK=signet
@@ -60,17 +62,20 @@ SDK_RELAY_PORTS=8090-8095
 ## 📝 Logs
 
 ### Logs Pertinents
-```
+
+```txt
 Logs pertinents ici
 ```
 
 ### Logs d'Erreur
-```
+
+```txt
 Logs d'erreur ici
 ```
 
 ### Logs de Debug
-```
+
+```txt
 Logs de debug ici (si RUST_LOG=debug)
 ```
 

.gitea/workflows/ci.yml

@@ -3,18 +3,22 @@ name: CI - 4NK Node
 on:
   push:
     branches: [ main, develop ]
+    tags:
+      - 'v*'
   pull_request:
     branches: [ main, develop ]
 
 env:
   RUST_VERSION: '1.70'
   DOCKER_COMPOSE_VERSION: '2.20.0'
+  CI_SKIP: 'true'
 
 jobs:
   # Job de vérification du code
   code-quality:
     name: Code Quality
-    runs-on: ubuntu-latest
+    runs-on: [self-hosted, linux]
+    if: ${{ env.CI_SKIP != 'true' }}
 
     steps:
     - name: Checkout code
@@ -62,7 +66,8 @@ jobs:
   # Job de tests unitaires
   unit-tests:
     name: Unit Tests
-    runs-on: ubuntu-latest
+    runs-on: [self-hosted, linux]
+    if: ${{ env.CI_SKIP != 'true' }}
 
     steps:
     - name: Checkout code
@@ -98,7 +103,8 @@ jobs:
   # Job de tests d'intégration
   integration-tests:
     name: Integration Tests
-    runs-on: ubuntu-latest
+    runs-on: [self-hosted, linux]
+    if: ${{ env.CI_SKIP != 'true' }}
 
     services:
       docker:
@@ -145,7 +151,8 @@ jobs:
   # Job de tests de sécurité
   security-tests:
     name: Security Tests
-    runs-on: ubuntu-latest
+    runs-on: [self-hosted, linux]
+    if: ${{ env.CI_SKIP != 'true' }}
 
     steps:
     - name: Checkout code
@@ -182,7 +189,8 @@ jobs:
   # Job de build et test Docker
   docker-build:
     name: Docker Build & Test
-    runs-on: ubuntu-latest
+    runs-on: [self-hosted, linux]
+    if: ${{ env.CI_SKIP != 'true' }}
 
     services:
       docker:
@@ -225,7 +233,8 @@ jobs:
   # Job de tests de documentation
   documentation-tests:
     name: Documentation Tests
-    runs-on: ubuntu-latest
+    runs-on: [self-hosted, linux]
+    if: ${{ env.CI_SKIP != 'true' }}
 
     steps:
     - name: Checkout code
@@ -238,6 +247,18 @@ jobs:
           echo "Checking links in $file"
         done
 
+  markdownlint:
+    name: Markdown Lint
+    runs-on: [self-hosted, linux]
+    if: ${{ env.CI_SKIP != 'true' }}
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v3
+      - name: Run markdownlint
+        run: |
+          npm --version || (curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash - && sudo apt-get install -y nodejs)
+          npx -y markdownlint-cli@0.42.0 "**/*.md" --ignore "archive/**"
+
     - name: Check documentation structure
       run: |
         # Vérifier la présence des fichiers de documentation essentiels
@@ -248,9 +269,6 @@ jobs:
           "CHANGELOG.md"
           "CODE_OF_CONDUCT.md"
           "SECURITY.md"
-          "docs/INDEX.md"
-          "docs/INSTALLATION.md"
-          "docs/USAGE.md"
         )
 
         for file in "${required_files[@]}"; do
@@ -260,19 +278,111 @@ jobs:
           fi
         done
 
-    - name: Validate documentation
-      run: |
-        # Vérifier la cohérence de la documentation
-        if ! grep -q "4NK Node" README.md; then
-          echo "README.md should mention '4NK Node'"
-          exit 1
-        fi
+  bash-required:
+    name: Bash Requirement
+    runs-on: [self-hosted, linux]
+    if: ${{ env.CI_SKIP != 'true' }}
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v3
+      - name: Verify bash availability
+        run: |
+          if ! command -v bash >/dev/null 2>&1; then
+            echo "bash is required for agents and scripts"; exit 1;
+          fi
+      - name: Verify agents runner exists
+        run: |
+          if [ ! -f scripts/agents/run.sh ]; then
+            echo "scripts/agents/run.sh is missing"; exit 1;
+          fi
+
+  agents-smoke:
+    name: Agents Smoke (no AI)
+    runs-on: [self-hosted, linux]
+    if: ${{ env.CI_SKIP != 'true' }}
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v3
+      - name: Ensure agents scripts executable
+        run: |
+          chmod +x scripts/agents/*.sh || true
+      - name: Run agents without AI
+        env:
+          OPENAI_API_KEY: ""
+        run: |
+          scripts/agents/run.sh
+      - name: Upload agents reports
+        uses: actions/upload-artifact@v3
+        with:
+          name: agents-reports
+          path: tests/reports/agents
+
+  openia-agents:
+    name: Agents with OpenIA
+    runs-on: [self-hosted, linux]
+    if: ${{ env.CI_SKIP != 'true' && secrets.OPENAI_API_KEY != '' }}
+    env:
+      OPENAI_API_KEY: ${{ secrets.OPENAI_API_KEY }}
+      OPENAI_MODEL: ${{ vars.OPENAI_MODEL }}
+      OPENAI_API_BASE: ${{ vars.OPENAI_API_BASE }}
+      OPENAI_TEMPERATURE: ${{ vars.OPENAI_TEMPERATURE }}
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v3
+      - name: Ensure agents scripts executable
+        run: |
+          chmod +x scripts/agents/*.sh || true
+      - name: Run agents with AI
+        run: |
+          scripts/agents/run.sh
+      - name: Upload agents reports
+        uses: actions/upload-artifact@v3
+        with:
+          name: agents-reports-ai
+          path: tests/reports/agents
+
+  deployment-checks:
+    name: Deployment Checks
+    runs-on: [self-hosted, linux]
+    if: ${{ env.CI_SKIP != 'true' }}
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v3
+      - name: Validate deployment documentation
+        run: |
+          if [ ! -f docs/DEPLOYMENT.md ]; then
+            echo "Missing docs/DEPLOYMENT.md"; exit 1; fi
+          if [ ! -f docs/SSH_UPDATE.md ]; then
+            echo "Missing docs/SSH_UPDATE.md"; exit 1; fi
+      - name: Ensure tests directories exist
+        run: |
+          mkdir -p tests/logs tests/reports || true
+          echo "OK"
+
+  security-audit:
+    name: Security Audit
+    runs-on: [self-hosted, linux]
+    if: ${{ env.CI_SKIP != 'true' }}
+    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]
+    runs-on: [self-hosted, linux]
+    needs: [code-quality, unit-tests, documentation-tests, markdownlint, security-audit, deployment-checks, bash-required]
+    if: ${{ env.CI_SKIP != 'true' }}
     steps:
     - name: Checkout code
       uses: actions/checkout@v3
@@ -300,10 +410,41 @@ jobs:
           echo "No guard script (ok)"
         fi
 
+  release-create:
+    name: Create Release (Gitea API)
+    runs-on: ubuntu-latest
+    needs: [release-guard]
+    if: ${{ env.CI_SKIP != 'true' && startsWith(github.ref, 'refs/tags/') }}
+    env:
+      RELEASE_TOKEN: ${{ secrets.RELEASE_TOKEN }}
+      BASE_URL: ${{ vars.BASE_URL }}
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v3
+      - name: Validate token and publish release
+        run: |
+          set -e
+          if [ -z "${RELEASE_TOKEN}" ]; then
+            echo "RELEASE_TOKEN secret is missing" >&2; exit 1; fi
+          if [ -z "${BASE_URL}" ]; then
+            BASE_URL="https://git.4nkweb.com"; fi
+          TAG="${GITHUB_REF##*/}"
+          REPO="${GITHUB_REPOSITORY}"
+          OWNER="${REPO%%/*}"
+          NAME="${REPO##*/}"
+          echo "Publishing release ${TAG} to ${BASE_URL}/${OWNER}/${NAME}"
+          curl -sSf -X POST \
+            -H "Authorization: token ${RELEASE_TOKEN}" \
+            -H "Content-Type: application/json" \
+            -d "{\"tag_name\":\"${TAG}\",\"name\":\"${TAG}\",\"draft\":false,\"prerelease\":false}" \
+            "${BASE_URL}/api/v1/repos/${OWNER}/${NAME}/releases" >/dev/null
+          echo "Release created"
+
   # Job de tests de performance
   performance-tests:
     name: Performance Tests
-    runs-on: ubuntu-latest
+    runs-on: [self-hosted, linux]
+    if: ${{ env.CI_SKIP != 'true' }}
 
     steps:
     - name: Checkout code
@@ -328,9 +469,9 @@ jobs:
   # Job de notification
   notify:
     name: Notify
-    runs-on: ubuntu-latest
+    runs-on: [self-hosted, linux]
     needs: [code-quality, unit-tests, integration-tests, security-tests, docker-build, documentation-tests]
-    if: always()
+    if: ${{ env.CI_SKIP != 'true' && always() }}
 
     steps:
     - name: Notify success

.gitea/workflows/template-sync.yml

@@ -7,7 +7,7 @@ on:
 
 jobs:
   check-and-sync:
-    runs-on: linux
+    runs-on: [self-hosted, linux]
     steps:
       - name: Lire TEMPLATE_VERSION et .4nk-sync.yml
         # Doit charger ref courant, source_repo et périmètre paths

.gitea_template/ISSUE_TEMPLATE/bug_report.md

@@ -6,6 +6,8 @@ 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.

.gitea_template/ISSUE_TEMPLATE/feature_request.md

@@ -6,6 +6,8 @@ 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.

.gitea_template/workflows/LOCAL_OVERRIDES.yml

@@ -1,10 +1,10 @@
-# LOCAL_OVERRIDES.yml — dérogations locales contrôlées
+# 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/auto-ssh-push.sh"
+  - path: "scripts/scripts/auto-ssh-push.sh"
     reason: "flux particulier temporaire"
     owner: "@maintainer_handle"
     expires: "2025-10-01"

.gitea_template/workflows/template-sync.yml

@@ -1,4 +1,4 @@
-# .gitea/workflows/template-sync.yml — synchronisation et contrôles d’intégrité
+# .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
@@ -7,7 +7,7 @@ on:
 
 jobs:
   check-and-sync:
-    runs-on: linux
+    runs-on: ubuntu-latest
     steps:
       - name: Lire TEMPLATE_VERSION et .4nk-sync.yml
         # Doit charger ref courant, source_repo et périmètre paths

.gitignore

@@ -28,4 +28,10 @@ pnpm-debug.log*
 tests/logs/
 tests/reports/
 
+# Binaires/installeurs temporaires
+PortableGit-64-bit.7z.exe
+git-installer.exe
+
 # Ne pas ignorer .cursor ni AGENTS.md
+
+

.markdownlint.json

@@ -0,0 +1,14 @@
+{
+  "MD013": {
+    "line_length": 200,
+    "code_blocks": false,
+    "tables": false,
+    "headings": false
+  },
+  "MD007": {
+    "indent": 2
+  },
+  "MD024": {
+    "siblings_only": true
+  }
+}

AGENTS.md

@@ -1,21 +1,23 @@
 # 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 spécialisés documentation] (#agents-specialises-documentation)
+- [Agents spécialisés tests] (#agents-specialises-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)
+- [Agents de synchronisation et dérogations] (#agents-de-synchronisation-et-derogations)
+- [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`).
@@ -23,35 +25,42 @@ Les règles opérationnelles détaillées sont précisées dans `.cursor/rules/`
 ---
 
 ## 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).
+- 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**
+
+#### Missions
+
 - Garantir la conformité éditoriale : français, pas d’exemples applicatifs, introduction/conclusion.
 - Vérifier la cohérence terminologique.
 
-**Artefacts**
+#### Artefacts
+
 - Tous fichiers.
 
 ---
 
 ### Agent Structure  (Responsable)
-**Missions**
+
+#### 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**
+#### Artefacts
+
 - `archive/`, `docs/**`, `tests/**`, `.cursor/**`, `.gitea/**`, `scripts/**`, `CHANGELOG.md`.
 
 ---
@@ -59,33 +68,42 @@ Les règles opérationnelles détaillées sont précisées dans `.cursor/rules/`
 ## Agents spécialisés documentation
 
 ### Agent Documentation  (Responsable)
-**Missions**
+
+#### 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**
+#### Artefacts
+
 - `docs/**`, `README.md`, `archive/**`.
 
 ---
 
 ### Agent Données CSV  (Responsable)
-**Missions**
+
+#### 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**
+#### Artefacts
+
 - `docs/API.md`, `docs/ARCHITECTURE.md`, `docs/USAGE.md`.
 
 ---
 
 ### Agent Documents bureautiques  (Consulté)
-**Missions**
+
+#### Missions
+
 - Lire `.docx` via `docx2txt`; proposer des alternatives en cas d’échec.
 - Documenter les imports dans `docs/INDEX.md`.
 
-**Artefacts**
+#### Artefacts
+
 - `docs/**`, `archive/**`.
 
 ---
@@ -93,67 +111,99 @@ Les règles opérationnelles détaillées sont précisées dans `.cursor/rules/`
 ## Agents spécialisés tests
 
 ### Agent Tests  (Responsable)
-**Missions**
+
+#### Missions
+
 - Couvrir `unit`, `integration`, `connectivity`, `performance`, `external`.
 - Gérer `tests/logs` et `tests/reports`.
 - Exiger des tests verts avant commit.
 
-**Artefacts**
+#### Artefacts
+
 - `tests/**`, `docs/TESTING.md`.
 
 ---
 
 ### Agent Performance  (Consulté)
-**Missions**
+
+#### Missions
+
 - Réaliser des benchmarks reproductibles.
 - Valider l’impact performance avant fusion.
 
-**Artefacts**
+#### Artefacts
+
 - `tests/performance/`, `tests/reports/`, `docs/TESTING.md`.
 
 ---
 
 ## Agents techniques
 
+### Agent Qualité technique  (Responsable)
+
+#### Missions
+
+- Définir et faire respecter les standards de qualité: lint, formatage, conventions de code, revues.
+- Superviser l’analyse statique (types, duplication, complexité, sécurité basique) et corriger les écarts.
+- Assurer l’exécution automatique des contrôles qualité dans la CI et bloquer en cas d’échec.
+
+#### Artefacts
+
+- `.gitea/workflows/ci.yml` (jobs de lint/format/type-check), `CHANGELOG.md`, `docs/ARCHITECTURE.md` (section standards).
+
+---
+
 ### Agent Dépendances  (Responsable)
-**Missions**
+
+#### 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**
+#### Artefacts
+
 - `docs/ARCHITECTURE.md`, `docs/CONFIGURATION.md`, `CHANGELOG.md`.
 
 ---
 
 ### Agent Compilation  (Responsable)
-**Missions**
+
+#### Missions
+
 - Compiler très régulièrement et aux étapes critiques.
 - Bloquer toute progression en cas d’erreurs de build/runtime.
 
-**Artefacts**
+#### Artefacts
+
 - Artefacts de build, scripts d’outillage.
 
 ---
 
 ### Agent Résolution  (Responsable)
-**Missions**
+
+#### 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**
+#### Artefacts
+
 - `tests/**`, `archive/**`
 
 ---
 
 ### Agent SSH & scripts  (Responsable)
-**Missions**
+
+#### 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**
+#### Artefacts
+
 - `scripts/**`, `.gitea/workflows/ci.yml`, `docs/SSH_UPDATE.md`, `docs/CONFIGURATION.md`, `CHANGELOG.md`.
 
 ---
@@ -161,12 +211,15 @@ Les règles opérationnelles détaillées sont précisées dans `.cursor/rules/`
 ## Agents frontend
 
 ### Agent Frontend  (Responsable)
-**Missions**
+
+#### Missions
+
 - Mettre en place `React.lazy`/`Suspense` (code splitting).
 - Centraliser l’état (Redux ou Context API).
 - Abstraire les services de données.
 
-**Artefacts**
+#### Artefacts
+
 - `docs/ARCHITECTURE.md`, `docs/TESTING.md`.
 
 ---
@@ -174,67 +227,143 @@ Les règles opérationnelles détaillées sont précisées dans `.cursor/rules/`
 ## Agents open source et CI
 
 ### Agent Open Source  (Responsable)
-**Missions**
+
+#### Missions
+
 - Maintenir : `LICENSE`, `CONTRIBUTING.md`, `CODE_OF_CONDUCT.md`, `docs/OPEN_SOURCE_CHECKLIST.md`.
 - Vérifier l’alignement continu avec `4NK_node`.
 
-**Artefacts**
+#### Artefacts
+
 - Fichiers de gouvernance cités ci-dessus.
 
 ---
 
 ### Agent Gitea  (Responsable)
-**Missions**
+
+#### 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**
+#### Artefacts
+
 - `.gitea/**`, `docs/GITEA_SETUP.md`.
 
 ---
 
 ### Agent Versionnage  (Responsable)
-**Missions**
+
+#### 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.
+- Orchestrer le `release-guard` (CI + scripts) et consigner latest vs wip.
+
+#### Artefacts
 
-**Artefacts**
 - `CHANGELOG.md`, `docs/RELEASE_PLAN.md`, `docs/ROADMAP.md`.
 
 ---
 
+### Agent Sécurité  (Responsable)
+
+#### Missions
+
+- Assurer une vigilance continue sécurité sur le code, la config et la CI.
+- Orchestrer l’audit de sécurité automatisé: `scripts/security/audit.sh` (cargo audit, npm audit, scan secrets).
+- Interdire l’introduction de secrets en clair et exiger la rotation des secrets CI.
+- Valider les permissions sensibles (clés, cookies, conf) et la non-exposition d’endpoints privés.
+- Bloquer toute release si l’audit de sécurité échoue (intégré au `release-guard`).
+
+#### Artefacts
+
+- `scripts/security/audit.sh`, `.gitea/workflows/ci.yml` (job `security-audit`), `docs/SECURITY_AUDIT.md`, `docs/CONFIGURATION.md`.
+
+---
+
+### Agent Déploiement  (Responsable)
+
+#### Missions
+
+- Définir et documenter la stratégie de déploiement (environnements, prérequis, secrets, rollbacks).
+- Vérifier la présence et la cohérence des artefacts de déploiement et des variables d’environnement requises.
+- Intégrer des contrôles CI « deployment-checks » avant toute release; coordonner avec `release-guard`.
+
+#### Artefacts
+
+- `docs/DEPLOYMENT.md`, `.gitea/workflows/ci.yml` (job `deployment-checks`), `CHANGELOG.md`, `docs/RELEASE_PLAN.md`.
+
+---
+
+### Agent Gouvernance du Template  (Accountable)
+
+#### Missions
+
+- Garantir la cohérence d’ensemble du template (règles Cursor, CI, scripts, docs).
+- Examiner les issues « Template Feedback », arbitrer et prioriser.
+- Orchestrer la montée de version du template (`TEMPLATE_VERSION`) et le `CHANGELOG.md`.
+- Communiquer les changements aux projets consommateurs.
+
+#### Artefacts
+
+- `.cursor/rules/**`, `.gitea_template/**`, `docs/TEMPLATE_*`, `TEMPLATE_VERSION`, `CHANGELOG.md`.
+
+---
+
+### Agent Adaptation Projet  (Responsable)
+
+#### Missions
+
+- Accompagner l’adaptation locale du template (CI, docs, `AGENTS.md`).
+- S’assurer que `security-audit` et `release-guard` ne sont pas retirés.
+- Remonter en feedback toute amélioration générique.
+
+#### Artefacts
+
+- `.gitea/workflows/ci.yml`, `docs/INDEX.md`, `docs/SECURITY_AUDIT.md`, `AGENTS.md`, `LOCAL_OVERRIDES.yml` (si utilisé).
+
+---
+
 ## Agents de synchronisation et dérogations
 
 ### Agent Synchronisation de template  (Accountable)
-**Références**
+
+#### 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**
+#### 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**
+#### 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**
+
+#### Références
+
 - `LOCAL_OVERRIDES.yml` (facultatif, mais recommandé).
 
-**Missions**
+#### 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**
+#### Artefacts
+
 - `LOCAL_OVERRIDES.yml`, `CHANGELOG.md` (mentionner les dérogations significatives).
 
 ---
@@ -254,10 +383,30 @@ Les règles opérationnelles détaillées sont précisées dans `.cursor/rules/`
 | 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 |
+| Déploiement                      | Déploiement, Versionnage, Sécurité, Documentation                                                                     | `docs/DEPLOYMENT.md`, `.gitea/workflows/ci.yml` (deployment-checks), `CHANGELOG.md` (*Deployment*)                                   | 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 |
 
 ---
 
+## Requetes complexes
+
+Quand tu fais une commande ou un requète complexe, explique là avant de la lancer.
+
 ## 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`.
+
+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é.
+Ainsi que la stabilité à long terme sur tous les projets issus de `4NK_project_template`.
+
+---
+
+## Exécution locale et neutralisation de la CI
+
+- Les contrôles CI peuvent être remplacés par l’exécution locale des agents: `scripts/agents/run.sh` avec `AUTO_FIX=1`, `SCOPE=changed|all`.
+- La CI peut être neutralisée par défaut via `CI_SKIP=true` dans le workflow; ponctuellement via des commits `[skip ci]`.
+- Des hooks sont fournis pour automatiser le flux local:
+  - `scripts/local/precommit.sh` et `scripts/local/prepush.sh`
+  - installation: `bash scripts/local/install_hooks.sh`
+- Un conteneur unifié (runner+agents) permet une exécution reproductible: `docker-compose.ci.yml`.

CHANGELOG.md

@@ -7,17 +7,74 @@ et ce projet adhère au [Semantic Versioning](https://semver.org/spec/v2.0.0.htm
 
 ## [Unreleased]
 
+### Added
+
+- Nouveaux agents: Qualité technique, Déploiement (AGENTS.md)
+- Documentation de déploiement `docs/DEPLOYMENT.md`
+- Documentation `docs/SSH_UPDATE.md` pour scripts SSH
+- Job CI `deployment-checks` et intégration au `release-guard`
+- Scripts agents activables sans Cursor (`scripts/agents/*`), doc `docs/AGENTS_RUNTIME.md`, jobs CI `agents-smoke` et `openia-agents`
+- Support multi‑langages pour les agents (Shell bash/Pwsh, Node.js/TS, Go, Rust, Python)
+- Nouvelle signature `scripts/agents/run.sh [target_dir] [output_dir] [agent]` et wrapper Windows `run.ps1`
+- Séparation documentaire: `docs/templates/**` (squelettes) et `docs/project/**` (docs du template)
+- Standards: `docs/QUALITY_STANDARDS.md`, `docs/OPEN_SOURCE_GUIDE.md`
+- Fallback PowerShell pour tous les agents (`scripts/agents/run.ps1`) et normalisation: bash recommandé, PS en secours
+- CI: contrôle `bash-required` et prérequis `scripts/agents/run.sh` avant release-guard
+- CI: job `markdownlint` pour contrôler les lints Markdown (MD013/MD024/MD036)
+- CI: job `release-create` pour publier une release via l’API Gitea (secret `RELEASE_TOKEN`)
+- Script de déploiement: `scripts/deploy/setup.sh` (provisionnement `~/.4nk_template/.env` sécurisé)
+- Déploiement: copie étendue (.cursor, AGENTS.md, LICENSE, CONTRIBUTING.md, CODE_OF_CONDUCT.md, SECURITY.md, TEMPLATE_VERSION, .markdownlint.json, .cursorignore, .gitignore, security/, scripts/)
+
+### Changed
+
+## [2025.08.3] - 2025-08-27
+
+### Changed
+
+- README refondu (ludique) avec Quickstart Debian, exécution agents sans arguments, secrets et CI
+- Workflows Gitea configurés pour runners `self-hosted, linux` (docs mises à jour)
+
+## [2025.08.2] - 2025-08-27
+
+### Changed
+
+- Renommage variable CI/Docs `GITEA_BASE_URL` → `BASE_URL`
+- Exécution des agents simplifiée: `scripts/agents/run.sh` sans arguments par défaut
+- CI mise à jour pour utiliser l’exécution sans paramètres
+
+## [2025.08.1] - 2025-08-27
+
+### Added
+
+- CI: markdownlint (MD013/MD024/MD036), release-create (API Gitea via RELEASE_TOKEN)
+- Script de déploiement étendu: `scripts/deploy/setup.sh` (copie .cursor, gouvernance, ignores, scripts, security, docs/templates)
+- Gestion env locale: `scripts/env/ensure_env.sh`; agents sourcent `~/.4nk_template/.env`
+
+### Changed
+
+- Normalisation MD005/MD007/MD051 dans la documentation
+- Ancrages ASCII dans `AGENTS.md`, correction des titres emphase (MD036)
+
+- Documentation projet réécrite à partir des modèles `docs/templates/**` (générique, non applicative)
+- `docs/INDEX.md` mis à jour (liens Déploiement et SSH)
+- Alignement documentaire sur 4NK_template (titres, liens Gitea, wording) dans docs/**
+- Raccourcissement guides: `docs/SECURITY_AUDIT.md`, `docs/RELEASE_PLAN.md`, `docs/ROADMAP.md` (versions génériques concises)
+- CI: déclenchement sur tags `v*` pour la publication de release
+
 ## [2025.08] - 2025-08-27
 
 ### Added
+
 - Garde de release (règle Cursor + scripts) imposant tests/doc/build/cohérence version/changelog/tag
 
 ### Changed
+
 - CI Gitea: ajout du job `release-guard` (contrôles pré‑push/tag)
 
 ### Fixed
 
-### Added
+### Added (suite)
+
 - Infrastructure de tests complète avec organisation par catégorie
 - Scripts d'exécution automatisés pour les tests
 - Documentation technique complète (Architecture, API)
@@ -25,13 +82,15 @@ et ce projet adhère au [Semantic Versioning](https://semver.org/spec/v2.0.0.htm
 - Scripts de maintenance et nettoyage automatique
 - Garde de release (Cursor rule + scripts) imposant tests/doc/build/cohérence version/changelog/tag
 
-### Changed
+### Changed (suite)
+
 - Réorganisation complète de la structure des tests
 - Amélioration de la documentation avec guides détaillés
 - Optimisation des scripts de démarrage et redémarrage
 - CI Gitea: ajout d’un job release-guard (contrôles pré‑push/tag)
 
-### Fixed
+### Fixed (suite)
+
 - Correction des problèmes de connectivité entre services
 - Amélioration de la gestion des erreurs dans les tests
 - Correction des configurations Docker
@@ -39,6 +98,7 @@ et ce projet adhère au [Semantic Versioning](https://semver.org/spec/v2.0.0.htm
 ## [1.0.0] - 2024-12-19
 
 ### Added
+
 - Infrastructure Docker complète pour 4NK Node
 - Support des paiements silencieux (Silent Payments) Bitcoin
 - Nœud Bitcoin Core configuré en mode signet
@@ -54,6 +114,7 @@ et ce projet adhère au [Semantic Versioning](https://semver.org/spec/v2.0.0.htm
 - Documentation complète en français
 
 ### Features
+
 - **Bitcoin Core** : Nœud signet avec RPC et ZMQ
 - **Blindbit** : Service de filtres pour les paiements silencieux
 - **SDK Relay** : Relais avec interface WebSocket et synchronisation mesh
@@ -63,6 +124,7 @@ et ce projet adhère au [Semantic Versioning](https://semver.org/spec/v2.0.0.htm
 - **Tests** : Suite de tests complète
 
 ### Technical
+
 - Architecture Docker avec orchestration via Docker Compose
 - Réseau privé `btcnet` pour la communication inter-services
 - Volumes persistants pour les données
@@ -73,134 +135,159 @@ et ce projet adhère au [Semantic Versioning](https://semver.org/spec/v2.0.0.htm
 ## [0.9.0] - 2024-12-15
 
 ### Added
+
 - Version initiale de l'infrastructure
 - Configuration de base des services
 - Tests de connectivité simples
 - Documentation de base
 
 ### Changed
+
 - Configuration initiale des services Docker
 - Premiers tests d'intégration
 
 ### Fixed
+
 - Problèmes de connectivité initiale
 - Configuration des ports et réseaux
 
 ## [0.8.0] - 2024-12-10
 
 ### Added
+
 - Support de la synchronisation entre relais
 - Implémentation du cache de déduplication
 - Types de messages de synchronisation
 - Gestionnaire de synchronisation (SyncManager)
 
 ### Changed
+
 - Amélioration de l'architecture de synchronisation
 - Optimisation des performances de synchronisation
 
 ### Fixed
+
 - Correction des problèmes de synchronisation
 - Amélioration de la stabilité des connexions mesh
 
 ## [0.7.0] - 2024-12-05
 
 ### Added
+
 - Support des paiements silencieux
 - Intégration avec le service Blindbit
 - Tests de paiements silencieux
 - Documentation des APIs
 
 ### Changed
+
 - Amélioration de l'intégration Bitcoin Core
 - Optimisation du scan des blocs
 
 ### Fixed
+
 - Correction des problèmes de détection des paiements
 - Amélioration de la performance du scan
 
 ## [0.6.0] - 2024-11-30
 
 ### Added
+
 - Interface WebSocket pour SDK Relay
 - Support des messages temps réel
 - Tests WebSocket
 - Documentation de l'API WebSocket
 
 ### Changed
+
 - Amélioration de l'interface WebSocket
 - Optimisation des performances de communication
 
 ### Fixed
+
 - Correction des problèmes de connexion WebSocket
 - Amélioration de la gestion des erreurs
 
 ## [0.5.0] - 2024-11-25
 
 ### Added
+
 - Support de Tor pour l'anonymat
 - Configuration du proxy Tor
 - Tests de connectivité Tor
 - Documentation de la configuration Tor
 
 ### Changed
+
 - Amélioration de la configuration réseau
 - Optimisation de la connectivité anonyme
 
 ### Fixed
+
 - Correction des problèmes de connectivité Tor
 - Amélioration de la stabilité du proxy
 
 ## [0.4.0] - 2024-11-20
 
 ### Added
+
 - Configuration multi-relais
 - Support de 3 instances SDK Relay
 - Tests multi-relais
 - Documentation de la configuration multi-relais
 
 ### Changed
+
 - Amélioration de l'orchestration Docker
 - Optimisation de la configuration multi-relais
 
 ### Fixed
+
 - Correction des problèmes de configuration multi-relais
 - Amélioration de la stabilité des instances multiples
 
 ## [0.3.0] - 2024-11-15
 
 ### Added
+
 - Healthchecks pour tous les services
 - Scripts de monitoring
 - Tests de santé des services
 - Documentation des healthchecks
 
 ### Changed
+
 - Amélioration de la surveillance des services
 - Optimisation des healthchecks
 
 ### Fixed
+
 - Correction des problèmes de healthchecks
 - Amélioration de la détection des problèmes
 
 ## [0.2.0] - 2024-11-10
 
 ### Added
+
 - Service Blindbit
 - Intégration avec Bitcoin Core
 - Tests d'intégration Blindbit
 - Documentation du service Blindbit
 
 ### Changed
+
 - Amélioration de l'intégration des services
 - Optimisation de la communication inter-services
 
 ### Fixed
+
 - Correction des problèmes d'intégration
 - Amélioration de la stabilité des services
 
 ## [0.1.0] - 2024-11-05
 
 ### Added
+
 - Infrastructure Docker de base
 - Service Bitcoin Core
 - Configuration de base
@@ -208,10 +295,12 @@ et ce projet adhère au [Semantic Versioning](https://semver.org/spec/v2.0.0.htm
 - Documentation initiale
 
 ### Changed
+
 - Configuration initiale des services
 - Premiers tests d'intégration
 
 ### Fixed
+
 - Problèmes de configuration initiale
 - Correction des problèmes de connectivité de base
 

CONTRIBUTING.md

@@ -4,16 +4,16 @@ Merci de votre intérêt pour contribuer au projet 4NK Node ! Ce guide vous aide
 
 ## 📋 Table des Matières
 
-- [🎯 Comment Contribuer](#-comment-contribuer)
-- [🚀 Premiers Pas](#-premiers-pas)
-- [🔧 Environnement de Développement](#️-environnement-de-développement)
-- [📝 Processus de Contribution](#-processus-de-contribution)
-- [🧪 Tests](#-tests)
-- [📚 Documentation](#-documentation)
-- [🐛 Signaler un Bug](#-signaler-un-bug)
-- [💡 Proposer une Fonctionnalité](#-proposer-une-fonctionnalité)
-- [🔍 Code Review](#-code-review)
-- [📦 Release](#-release)
+- [🎯 Comment Contribuer] (#comment-contribuer)
+- [🚀 Premiers Pas] (#premiers-pas)
+- [🔧 Environnement de Développement] (#environnement-de-developpement)
+- [📝 Processus de Contribution] (#processus-de-contribution)
+- [🧪 Tests] (#tests)
+- [📚 Documentation] (#documentation)
+- [🐛 Signaler un Bug] (#signaler-un-bug)
+- [💡 Proposer une Fonctionnalité] (#proposer-une-fonctionnalite)
+- [🔍 Code Review] (#code-review)
+- [📦 Release] (#release)
 
 ## 🎯 Comment Contribuer
 
@@ -145,7 +145,8 @@ docs(api): update WebSocket message format
 test(integration): add multi-relay sync tests
 ```
 
-**Types :**
+#### Types
+
 - `feat` - Nouvelle fonctionnalité
 - `fix` - Correction de bug
 - `docs` - Documentation
@@ -247,7 +248,7 @@ Description de ce qui se passe actuellement.
 
 ## Logs
 
-```
+```text
 Logs pertinents ici
 ```
 
@@ -258,7 +259,6 @@ Si applicable, ajoutez une capture d'écran.
 ## Contexte Supplémentaire
 
 Toute autre information pertinente.
-```
 
 ## 💡 Proposer une Fonctionnalité
 
@@ -288,7 +288,6 @@ Impact sur les utilisateurs et l'architecture.
 ## Exemples d'Utilisation
 
 Comment cette fonctionnalité serait-elle utilisée ?
-```
 
 ## 🔍 Code Review
 

README.md

@@ -1,123 +1,99 @@
-# 🚀 title
+# 4NK Project Template — Qualité, Sécurité, Open Source ✨
 
-desc
+Bienvenue dans le template 4NK. Objectifs: démarrer vite, rester propre, publier serein. Vous y trouverez des règles, des workflows CI, des scripts d’agents et une documentation prête à adapter.
 
-## 📋 Table des Matières
+## 📦 Ce que vous obtenez
 
+- Standards de qualité et sécurité (lint, audit, release‑guard)
+- Agents automatisés (qualité, docs, tests, sécurité, déploiement)
+- CI Gitea prête à l’emploi (self‑hosted, linux)
+- Documentation structurée: `docs/project/**` (ce dépôt) et `docs/templates/**` (modèles pour vos projets)
 
-## 🏗️ Architecture
+## 🐧 Linux (Debian) — Prérequis rapides
 
-### 🔄 Flux de Données
+```bash
+sudo apt update
+sudo apt install -y bash git curl jq ca-certificates
+# Lint Markdown
+curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
+sudo apt install -y nodejs
+```
 
+## ⚙️ Configuration locale (secrets)
 
-## 🚀 Démarrage Rapide
+```bash
+bash scripts/deploy/setup.sh   # crée ~/.4nk_template/.env (chmod 600)
+```
 
-### Prérequis
+À renseigner ensuite dans `~/.4nk_template/.env` (extraits):
 
+- OPENAI_API_KEY, OPENAI_MODEL (si agents IA)
+- RELEASE_TOKEN (release via API Gitea)
+- BASE_URL (optionnel, par défaut `https://git.4nkweb.com`)
 
-### Installation
+Plus d’infos: `docs/project/CONFIGURATION.md` et `docs/project/GITEA_SETUP.md`.
 
+## 🤖 Exécuter les agents
 
-### Configuration SSH (Recommandé)
+```bash
+scripts/agents/run.sh              # exécution complète, rapports dans tests/reports/agents
+scripts/agents/run.sh . . documentation  # exécution ciblée (facultatif)
+```
 
+Fallback Windows: `scripts/agents/run.ps1`.
+
+Guide complet: `docs/project/AGENTS_RUNTIME.md`.
+
+## 🐳 Conteneur unifié (runner + agents)
+
+```bash
+# Build
+docker compose -f docker-compose.ci.yml build
+
+# Exécuter les agents sur le dépôt courant
+docker compose -f docker-compose.ci.yml up --abort-on-container-exit
+# Rapports: tests/reports/agents/*.md
+
+# Lancer le runner dans ce conteneur
+RUNNER_MODE=runner BASE_URL="https://git.4nkweb.com" REGISTRATION_TOKEN="<token>" \
+  docker compose -f docker-compose.ci.yml up -d
+```
+
+## 🔁 CI/CD (Gitea Actions)
+
+- Runners: labels requis `self-hosted,linux` (voir `docs/project/GITEA_SETUP.md`)
+- Jobs clés: `markdownlint`, `agents-smoke`, `release-guard`, `release-create`
+- Secrets/Variables: `RELEASE_TOKEN`, `OPENAI_API_KEY`, `BASE_URL`, `OPENAI_*`
+
+## 🚀 Release
+
+```bash
+# Vérifier/mettre à jour la version
+cat TEMPLATE_VERSION
+
+# Tagger (déclenche la release via API si RELEASE_TOKEN existe côté dépôt)
+git tag -a vYYYY.MM.P -m 'release: vYYYY.MM.P (latest)'
+git push origin vYYYY.MM.P
+```
+
+Changelog: `CHANGELOG.md`. Gardien de release: `release-guard` en CI.
 
 ## 📚 Documentation
 
-### 📖 Guides Principaux
-
-
-### 🔧 Guides Techniques
-
-
-### 🧪 Guides de Test
-
-### 🌐 Guides Réseau
-
-
-## 🔧 Configuration
-
-### Services Disponibles
-
-
-### Variables d'Environnement
-
-
-## 🧪 Tests et Monitoring
-
-### Tests de Base
-
-### Monitoring
-
-
-### Tests de Performance
-
-
-## 🌐 Réseau de Relais
-
-### Architecture Mesh
-
-
-### Ajout de Nœuds Externes
-
-
-### Configuration Externe
-
-
-## 🛠️ Développement
-
-### Structure du Projet
-
-
-### Ajout d'un Nouveau Service
-
-
-### Modification de la Configuration
-
-
-## 🚨 Dépannage
-
-### Problèmes Courants
-
-#### 1. Ports Déjà Utilisés
-
-
-#### 2. Problèmes de Synchronisation
-
-
-#### 3. Problèmes de Connectivité
-
-### Logs Détaillés
-
-
-### Healthchecks
-
-
-## 📈 Performance
-
-### Ressources Recommandées
-
-### Optimisations
-
+- Projet (ce dépôt): `docs/project/`
+- Modèles à réutiliser: `docs/templates/`
+- Standards de qualité: `docs/project/QUALITY_STANDARDS.md`
 
 ## 🤝 Contribution
 
-1. Fork le repository
-2. Créer une branche feature (`git checkout -b feature/nouvelle-fonctionnalite`)
-3. Commit les changements (`git commit -am 'Ajout de nouvelle fonctionnalité'`)
-4. Push la branche (`git push origin feature/nouvelle-fonctionnalite`)
-5. Créer une Pull Request
+- Fork → branche → PR (CI verte, docs/changelog à jour)
+- Respect des règles éditoriales (français, pas de secrets, pas d’exemples applicatifs)
 
 ## 📄 Licence
 
-Ce projet est sous licence MIT. Voir le fichier LICENSE pour plus de détails.
+MIT — voir `LICENSE`.
 
 ## 🆘 Support
 
-Pour obtenir de l'aide :
-
-1. Consulter la [documentation](docs/)
-2. Vérifier les [issues existantes](https://git.4nkweb.com/4nk/4NK_node/issues)
-3. Créer une nouvelle issue avec les détails du problème
-4. Inclure les logs et la configuration utilisée
-
----
+- Lire `docs/project/INDEX.md`
+- Ouvrir une issue si besoin

SECURITY.md

@@ -8,7 +8,8 @@ Nous prenons la sécurité très au sérieux. Si vous découvrez une vulnérabil
 
 **NE PAS** créer d'issue publique pour les vulnérabilités de sécurité.
 
-**À la place :**
+#### À la place
+
 1. Envoyez un email à [security@4nkweb.com](mailto:security@4nkweb.com)
 2. Incluez "SECURITY VULNERABILITY" dans l'objet
 3. Décrivez la vulnérabilité de manière détaillée
@@ -34,6 +35,7 @@ Nous prenons la sécurité très au sérieux. Si vous découvrez une vulnérabil
 ### Pour les Contributeurs
 
 #### Code
+
 - Validez toutes les entrées utilisateur
 - Utilisez des requêtes préparées pour les bases de données
 - Évitez les injections de code
@@ -41,12 +43,14 @@ Nous prenons la sécurité très au sérieux. Si vous découvrez une vulnérabil
 - Utilisez HTTPS pour toutes les communications
 
 #### Configuration
+
 - Ne committez jamais de secrets
 - Utilisez des variables d'environnement pour les données sensibles
 - Vérifiez les permissions des fichiers
 - Maintenez les dépendances à jour
 
 #### Tests
+
 - Incluez des tests de sécurité
 - Testez les cas limites
 - Validez les entrées malveillantes
@@ -55,18 +59,21 @@ Nous prenons la sécurité très au sérieux. Si vous découvrez une vulnérabil
 ### Pour les Utilisateurs
 
 #### Installation
+
 - Utilisez des sources officielles
 - Vérifiez les checksums
 - Maintenez le système à jour
 - Utilisez un pare-feu
 
 #### Configuration
+
 - Changez les mots de passe par défaut
 - Utilisez des clés SSH fortes
 - Limitez l'accès réseau
 - Surveillez les logs
 
 #### Opération
+
 - Surveillez les connexions
 - Sauvegardez régulièrement
 - Testez les sauvegardes
@@ -77,24 +84,28 @@ Nous prenons la sécurité très au sérieux. Si vous découvrez une vulnérabil
 ### Composants Principaux
 
 #### Bitcoin Core
+
 - **RPC Interface** : Authentification requise
 - **ZMQ** : Communication locale uniquement
 - **P2P** : Validation des blocs
 - **Wallet** : Chiffrement des clés
 
 #### Blindbit
+
 - **API HTTP** : Validation des entrées
 - **Filtres** : Vérification des signatures
 - **Cache** : Protection contre les attaques DoS
 - **Logs** : Pas d'informations sensibles
 
 #### SDK Relay
+
 - **WebSocket** : Validation des messages
 - **Synchronisation** : Authentification des pairs
 - **Cache** : Protection contre les attaques
 - **Configuration** : Validation des paramètres
 
 #### Tor
+
 - **Proxy** : Configuration sécurisée
 - **Contrôle** : Accès restreint
 - **Logs** : Anonymisation
@@ -103,6 +114,7 @@ Nous prenons la sécurité très au sérieux. Si vous découvrez une vulnérabil
 ### Tests de Sécurité
 
 #### Tests Automatisés
+
 ```bash
 # Tests de sécurité
 ./tests/run_security_tests.sh
@@ -115,6 +127,7 @@ Nous prenons la sécurité très au sérieux. Si vous découvrez une vulnérabil
 ```
 
 #### Tests Manuels
+
 - Tests de pénétration
 - Audit de code
 - Tests de configuration
@@ -147,6 +160,7 @@ Nous prenons la sécurité très au sérieux. Si vous découvrez une vulnérabil
 ## 📋 Checklist de Sécurité
 
 ### Avant le Déploiement
+
 - [ ] Audit de code de sécurité
 - [ ] Tests de vulnérabilités
 - [ ] Vérification des dépendances
@@ -154,6 +168,7 @@ Nous prenons la sécurité très au sérieux. Si vous découvrez une vulnérabil
 - [ ] Tests de charge
 
 ### Pendant l'Opération
+
 - [ ] Monitoring de sécurité
 - [ ] Surveillance des logs
 - [ ] Mise à jour des composants
@@ -161,6 +176,7 @@ Nous prenons la sécurité très au sérieux. Si vous découvrez une vulnérabil
 - [ ] Tests de récupération
 
 ### Après un Incident
+
 - [ ] Analyse post-mortem
 - [ ] Mise à jour des procédures
 - [ ] Formation de l'équipe
@@ -170,18 +186,21 @@ Nous prenons la sécurité très au sérieux. Si vous découvrez une vulnérabil
 ## 🔧 Outils de Sécurité
 
 ### Monitoring
+
 - **Logs** : Centralisation et analyse
 - **Métriques** : Surveillance en temps réel
 - **Alertes** : Notification automatique
 - **Tableaux de bord** : Vue d'ensemble
 
 ### Tests
+
 - **SAST** : Analyse statique
 - **DAST** : Tests dynamiques
 - **IAST** : Tests interactifs
 - **Fuzzing** : Tests de robustesse
 
 ### Protection
+
 - **WAF** : Pare-feu applicatif
 - **IDS/IPS** : Détection d'intrusion
 - **Antivirus** : Protection des endpoints
@@ -190,18 +209,21 @@ Nous prenons la sécurité très au sérieux. Si vous découvrez une vulnérabil
 ## 📚 Ressources
 
 ### Documentation
+
 - [Guide de Sécurité Bitcoin](https://bitcoin.org/en/security)
 - [OWASP Top 10](https://owasp.org/www-project-top-ten/)
 - [CWE/SANS Top 25](https://cwe.mitre.org/top25/)
 - [NIST Cybersecurity Framework](https://www.nist.gov/cyberframework)
 
 ### Outils
+
 - [Bandit](https://bandit.readthedocs.io/) - Analyse Python
 - [Clang Static Analyzer](https://clang-analyzer.llvm.org/) - Analyse C/C++
 - [SonarQube](https://www.sonarqube.org/) - Qualité du code
 - [OpenVAS](https://www.openvas.org/) - Scan de vulnérabilités
 
 ### Formation
+
 - Cours de sécurité applicative
 - Formation aux tests de pénétration
 - Certification en cybersécurité
@@ -210,18 +232,21 @@ Nous prenons la sécurité très au sérieux. Si vous découvrez une vulnérabil
 ## 🤝 Collaboration
 
 ### Bug Bounty
+
 - Programme de récompenses pour les vulnérabilités
 - Critères d'éligibilité
 - Montants des récompenses
 - Processus de validation
 
 ### Responsible Disclosure
+
 - Timeline de divulgation
 - Coordination avec les chercheurs
 - Communication publique
 - Remerciements
 
 ### Communauté
+
 - Groupe de sécurité
 - Discussions techniques
 - Partage d'informations

TEMPLATE_VERSION

@@ -1 +1 @@
-v2025.08
+v2025.08.6

docker-compose.ci.yml

@@ -0,0 +1,19 @@
+services:
+  project-ci:
+    build:
+      context: .
+      dockerfile: docker/Dockerfile.ci
+    image: 4nk-template-ci:latest
+    environment:
+      - RUNNER_MODE=${RUNNER_MODE:-agents}
+      - TARGET_DIR=/work
+      - OUTPUT_DIR=/work/tests/reports/agents
+      - BASE_URL
+      - REGISTRATION_TOKEN
+    volumes:
+      - ./:/work
+      - ${HOME}/.4nk_template/.env:/root/.4nk_template/.env:ro
+    tty: true
+    labels:
+      - "com.4nk.template=ci"
+

docker/Dockerfile.ci

@@ -0,0 +1,26 @@
+FROM gitea/act_runner:nightly
+
+USER root
+
+RUN apk update || true && \
+    (apk add --no-cache bash curl jq git coreutils dos2unix || \
+     (apt-get update && apt-get install -y bash curl jq git coreutils dos2unix)) && \
+    mkdir -p /app /work /root/.4nk_template && chmod 700 /root/.4nk_template
+
+WORKDIR /app
+
+# Copier les scripts agents
+COPY scripts /work/scripts
+
+# Normaliser les fins de ligne et permissions
+RUN find /work/scripts -type f -name "*.sh" -print0 | xargs -0 -r dos2unix -f && \
+    find /work/scripts -type f -name "*.sh" -exec chmod +x {} +
+
+# Entrypoint unifié: lance le runner si variables présentes, sinon agents
+COPY docker/entrypoint.ci.sh /entrypoint.sh
+RUN dos2unix -f /entrypoint.sh && chmod +x /entrypoint.sh
+
+WORKDIR /work
+
+ENTRYPOINT ["/entrypoint.sh"]
+

docker/Dockerfile.debian

@@ -0,0 +1,10 @@
+FROM debian:12-slim
+
+ENV DEBIAN_FRONTEND=noninteractive
+RUN apt-get update \
+ && apt-get install -y --no-install-recommends \
+    bash curl jq ca-certificates git docker.io docker-compose-plugin \
+ && rm -rf /var/lib/apt/lists/*
+
+WORKDIR /work
+ENTRYPOINT ["/bin/bash","-lc"]

docker/entrypoint.ci.sh

@@ -0,0 +1,55 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+# Charge l'env utilisateur si monté
+if [[ -f "/root/.4nk_template/.env" ]]; then
+  set -a
+  . "/root/.4nk_template/.env"
+  set +a
+fi
+
+MODE="${RUNNER_MODE:-agents}"
+TARGET_DIR="${TARGET_DIR:-/work}"
+OUTPUT_DIR="${OUTPUT_DIR:-/work/tests/reports/agents}"
+
+# Rendre le dépôt monté sûr pour Git (propriétaire différent dans le conteneur)
+git config --global --add safe.directory "/work" || true
+git config --global --add safe.directory "${TARGET_DIR}" || true
+
+normalize_scripts() {
+  if command -v dos2unix >/dev/null 2>&1; then
+    find /work/scripts -type f -name "*.sh" -print0 | xargs -0 -r dos2unix -f || true
+  fi
+  find /work/scripts -type f -name "*.sh" -exec chmod +x {} + || true
+}
+
+start_runner() {
+  # Démarre le runner gitea/act_runner (processus au premier plan)
+  # Requiert : GITEA_INSTANCE_URL (BASE_URL), REGISTRATION_TOKEN ou config existante
+  if [[ -n "${BASE_URL:-}" && -n "${REGISTRATION_TOKEN:-}" ]]; then
+    act_runner register --no-interactive \
+      --instance "$BASE_URL" \
+      --token "$REGISTRATION_TOKEN" \
+      --labels "self-hosted,linux" || true
+  fi
+  exec act_runner daemon
+}
+
+run_agents() {
+  normalize_scripts
+  mkdir -p "$OUTPUT_DIR"
+  cd "$TARGET_DIR"
+  /work/scripts/agents/run.sh "$TARGET_DIR" "$OUTPUT_DIR" all || true
+  echo "Rapports disponibles dans $OUTPUT_DIR" >&2
+}
+
+case "$MODE" in
+  runner) start_runner ;;
+  agents) run_agents ;;
+  both)
+    start_runner &
+    run_agents
+    wait -n || true
+    ;;
+  *) run_agents ;;
+esac

docs/API.md

@@ -1,763 +0,0 @@
-# Référence API - 4NK Node
-
-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 4NK Node 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

@@ -1,49 +1,2 @@
-# Architecture Technique - 4NK Node
+# Architecture
 
-
-## Vue d'Ensemble de l'Architecture
-
-Ce document sert de modèle. Il doit être complété par chaque projet dérivé du template 4NK.
-
-### 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

@@ -1,236 +0,0 @@
-# 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

@@ -1,401 +0,0 @@
-# Guide de la Communauté - 4NK Node
-
-## 🌟 Bienvenue dans la Communauté 4NK Node !
-
-Ce guide vous accompagne dans votre participation à la communauté open source de 4NK Node, une infrastructure complète pour les paiements silencieux Bitcoin.
-
-## 🎯 À Propos de 4NK Node
-
-### **Qu'est-ce que 4NK Node ?**
-
-4NK Node 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 4NK Node ?**
-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é 4NK Node ! Votre contribution aide à construire l'avenir des paiements Bitcoin privés et sécurisés.** 🌟

docs/CONFIGURATION.md

@@ -1,212 +0,0 @@
-# ⚙️ Guide de Configuration - 4NK Node
-
-Guide complet pour configurer l'infrastructure 4NK Node 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/DEPLOYMENT.md

@@ -0,0 +1,2 @@
+# Déploiement
+

docs/GITEA_SETUP.md

@@ -1,286 +0,0 @@
-# Configuration Gitea - 4NK Node
-
-Ce guide explique comment configurer le projet 4NK Node spécifiquement pour Gitea (git.4nkweb.com).
-
-## 🎯 Configuration Gitea
-
-### Repository Configuration
-
-Le projet est hébergé sur : **https://git.4nkweb.com/4nk/4NK_node**
-
-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 - 4NK Node
-
-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://git.4nkweb.com/api/v1/repos/4nk/<project>/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://git.4nkweb.com/votre-username/<project>.git
-cd 4NK_node
-
-# Ajouter l'upstream
-git remote add upstream https://git.4nkweb.com/4nk/<project>.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 git.4nkweb.com** 🚀

docs/INDEX.md

@@ -1,304 +1,156 @@
-# 📚 Index de Documentation - 4NK Node
+# 📚 Index de Documentation - 4NK_template
 
-Index complet de la documentation de l'infrastructure 4NK Node.
+Index complet de la documentation du template 4NK pour la création de nouveaux projets.
+
+## 🚀 Vue d'Ensemble
+
+4NK_template est un template complet pour créer de nouveaux projets dans l'écosystème 4NK. Il fournit une structure standardisée avec tous les éléments nécessaires pour un projet open source moderne.
 
 ## 📖 Guides Principaux
 
 ### 🚀 [Guide d'Installation](INSTALLATION.md)
-
+Guide complet pour installer et configurer un nouveau projet basé sur 4NK_template.
+- **Prérequis système et logiciels**
+- **Installation du template**
+- **Configuration initiale**
+- **Personnalisation du projet**
+- **Tests post-installation**
 
 ### 📖 [Guide d'Utilisation](USAGE.md)
-
+Guide complet pour utiliser le template et créer de nouveaux projets.
+- **Création d'un nouveau projet**
+- **Personnalisation de la structure**
+- **Configuration des scripts**
+- **Adaptation de la documentation**
+- **Tests et validation**
 
 ### ⚙️ [Guide de Configuration](CONFIGURATION.md)
+Guide complet pour configurer le template selon vos besoins.
+- **Configuration générale**
+- **Personnalisation des scripts**
+- **Configuration CI/CD**
+- **Configuration Docker**
+- **Configuration de sécurité**
 
 ## 🔧 Guides Techniques
 
 ### 🏗️ [Architecture Technique](ARCHITECTURE.md)
-
+Documentation technique détaillée de l'architecture du template.
+- **Structure générale du template**
+- **Composants principaux**
+- **Scripts et utilitaires**
+- **Configuration Docker**
+- **Intégration CI/CD**
+- **Sécurité et bonnes pratiques**
 
 ### 📡 [API Reference](API.md)
-
+Documentation des APIs et interfaces du template.
+- **Scripts disponibles**
+- **Configuration des hooks Git**
+- **Variables d'environnement**
+- **Format des fichiers de configuration**
 
 ### 🔒 [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é**
+- **Audit 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**
+- **Configuration sécurisée**
+- **Tests de sécurité**
 
 ## 🧪 Guides de Test
 
-### 🧪 [Guide de Tests](TESTING.md)
-Guide complet des tests de l'infrastructure 4NK Node.
-- **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**
+### 🧪 [Guide des Tests](TESTING.md)
+Guide complet pour les tests du template.
+- **Tests unitaires**
+- **Tests d'intégration**
+- **Tests de sécurité**
+- **Tests de configuration**
 
-### 🔄 [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**
+### 🔍 [Audit de Sécurité](SECURITY_AUDIT.md)
+Audit de sécurité détaillé du template.
+- **Vulnérabilités connues**
+- **Tests de pénétration**
+- **Audit de code**
+- **Recommandations de sécurité**
 
-### 📊 [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 de Développement
 
-## 🌐 Guides Réseau
+### 🔧 [Guide de Développement](DEVELOPMENT.md)
+Guide complet pour le développement avec le template.
+- **Environnement de développement**
+- **Workflow de développement**
+- **Standards de code**
+- **Debugging et profiling**
+- **Optimisation des performances**
 
-### 🌐 [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**
+## 📊 Déploiement
 
-### 🌍 [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**
+### 🚀 [Guide de Déploiement](DEPLOYMENT.md)
+Guide complet pour déployer des projets basés sur le template.
+- **Configuration de production**
+- **Déploiement Docker**
+- **Intégration CI/CD**
+- **Monitoring et observabilité**
 
-### 🔄 [Synchronisation](SYNCHRONIZATION.md)
-Guide du protocole de synchronisation.
-- **Protocole de synchronisation**
-- **Types de messages**
-- **Cache de déduplication**
-- **Métriques de synchronisation**
-- **Troubleshooting**
+## 🎯 Navigation Rapide
 
-## 📋 Guides de Référence
+### 🚀 Démarrage Rapide
+1. [Installation](INSTALLATION.md) - Installer le template
+2. [Configuration](CONFIGURATION.md) - Configurer le projet
+3. [Utilisation](USAGE.md) - Créer un nouveau projet
 
-### 📋 [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**
+### 🔧 Développement
+1. [Architecture](ARCHITECTURE.md) - Comprendre l'architecture
+2. [API](API.md) - Consulter les APIs
+3. [Tests](TESTING.md) - Exécuter les tests
 
-### 📋 [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** : [GitLab 4NK Node](https://git.4nkweb.com/4nk/4NK_node)
-- **Issues** : [Issues GitLab](https://git.4nkweb.com/4nk/4NK_node/issues)
-- **Wiki** : [Wiki GitLab](https://git.4nkweb.com/4nk/4NK_node/wikis)
-
-### Contact
-- **Email** : support@4nkweb.com
-- **Chat** : [Discord 4NK](https://discord.gg/4nk)
-- **Forum** : [Forum 4NK](https://forum.4nkweb.com)
-
-## 🔄 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** : Équipe 4NK
-
-### 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
+### 📚 Documentation
+1. [Index](INDEX.md) - Cet index
+2. [Déploiement](DEPLOYMENT.md) - Guide de déploiement
 
 ---
+
+## 🧪 Tests et Validation
+
+### Tests Automatisés
+```bash
+# Tests du template
+./scripts/test-template.sh
+
+# Tests de configuration
+./scripts/test-config.sh
+
+# Tests de sécurité
+./scripts/security-audit.sh
+```
+
+---
+
+## 🚀 Développement
+
+### Commandes Essentielles
+```bash
+# Créer un nouveau projet
+./scripts/create-project.sh my-new-project
+
+# Configurer un projet existant
+./scripts/setup-project.sh
+
+# Tests du template
+./scripts/test-template.sh
+```
+
+---
+
+## 📊 Métriques
+
+### Fonctionnalités
+- **Structure standardisée** : ✅ Complète
+- **Scripts automatisés** : ✅ Disponibles
+- **Configuration CI/CD** : ✅ Intégrée
+- **Documentation** : ✅ Template complet
+- **Tests** : ✅ Automatisés
+
+---
+
+**📚 Documentation complète pour 4NK_template - Template pour nouveaux projets 4NK** 🚀

docs/INSTALLATION.md

@@ -1,533 +0,0 @@
-# 📦 Guide d'Installation - 4NK Node
-
-Guide complet pour installer et configurer l'infrastructure 4NK Node.
-
-## 📋 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 GitLab
-cat ~/.ssh/id_ed25519_4nk.pub
-```
-
-**Ajouter la clé publique à GitLab :**
-1. Aller sur GitLab > Settings > SSH Keys
-2. Coller la clé publique
-3. Cliquer sur "Add key"
-
-### 3. Clonage du Repository
-
-```bash
-# Cloner avec SSH (recommandé)
-git clone git@git.4nkweb.com:4nk/4NK_node.git
-cd 4NK_node
-
-# Ou avec HTTPS (si SSH non configuré)
-# git clone https://git.4nkweb.com/4nk/4NK_node.git
-# cd 4NK_node
-```
-
-### 4. Vérification de l'Installation
-
-```bash
-# Vérifier Docker
-docker --version
-docker-compose --version
-
-# Vérifier la connectivité GitLab
-ssh -T git@git.4nkweb.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 4NK Node
-PROJECT_NAME=4NK Node
-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 GitLab
-- [ ] 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 4NK Node 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/MIGRATION.md

@@ -1,378 +0,0 @@
-# 🔄 Guide de Migration - Documentation 4NK Node
-
-Guide pour migrer et organiser la documentation existante vers la nouvelle structure.
-
-## 📋 État Actuel
-
-### Fichiers de Documentation Existants
-
-#### Documentation Principale
-- `README.md` - Documentation principale (mis à jour)
-- `EXEMPLES_PRATIQUES.md` - Exemples d'utilisation (à migrer)
-
-#### Documentation Technique
-- `specs/spec-technique.md` - Spécification technique (à conserver)
-- `specs/spec-fonctionnel.md` - Spécification fonctionnelle (à conserver)
-- `specs/spec-technical.md` - Spécification technique (à fusionner)
-
-#### Documentation de Configuration
-- `CONFIGURATION_DEV3.md` - Configuration dev3.4nkweb.com (à migrer)
-- `INTEGRATION_DEV3_FINAL.md` - Intégration dev3.4nkweb.com (à migrer)
-
-#### Documentation de Processus
-- `COMMANDES_REDEMARRAGE.md` - Commandes de redémarrage (à migrer)
-- `RESUME_AJOUT_DEV3.md` - Résumé ajout dev3 (à migrer)
-- `RESUME_DECOUVERTE_NOEUDS.md` - Découverte des nœuds (à migrer)
-- `RESUME_SCRIPT_RESTART.md` - Script de redémarrage (à migrer)
-- `RESUME_TEST_3_RELAIS.md` - Test 3 relais (à migrer)
-
-#### Documentation de Scripts
-- `README_RESTART_SCRIPT.md` - Documentation script redémarrage (à migrer)
-- `explain_node_discovery.md` - Explication découverte nœuds (à migrer)
-
-## 🎯 Plan de Migration
-
-### 1. Structure de Documentation
-
-```
-4NK_node/
-├── README.md                    # ✅ Mis à jour
-├── docs/                        # ✅ Nouvelle structure
-│   ├── INDEX.md                 # ✅ Créé
-│   ├── INSTALLATION.md          # ✅ Créé
-│   ├── USAGE.md                 # ✅ Créé
-│   ├── CONFIGURATION.md         # ✅ Créé
-│   ├── QUICK_REFERENCE.md       # ✅ Créé
-│   ├── MIGRATION.md             # ✅ Ce fichier
-│   ├── ARCHITECTURE.md          # 🔄 À créer
-│   ├── API.md                   # 🔄 À créer
-│   ├── SECURITY.md              # 🔄 À créer
-│   ├── PERFORMANCE.md           # 🔄 À créer
-│   ├── TESTING.md               # 🔄 À créer
-│   ├── SYNC_TESTING.md          # 🔄 À créer
-│   ├── PERFORMANCE_TESTING.md   # 🔄 À créer
-│   ├── RELAY_NETWORK.md         # 🔄 À créer
-│   ├── EXTERNAL_NODES.md        # 🔄 À créer
-│   ├── SYNCHRONIZATION.md       # 🔄 À créer
-│   ├── TROUBLESHOOTING.md       # 🔄 À créer
-│   └── FAQ.md                   # 🔄 À créer
-├── specs/                       # ✅ À conserver
-│   ├── spec-technique.md        # ✅ Conserver
-│   └── spec-fonctionnel.md      # ✅ Conserver
-├── archive/                     # 🔄 À créer
-│   ├── docs/                    # 🔄 Anciens fichiers
-│   └── README.md                # 🔄 Documentation archive
-└── examples/                    # 🔄 À créer
-    ├── configuration/           # 🔄 Exemples de config
-    ├── scripts/                 # 🔄 Scripts d'exemple
-    └── tests/                   # 🔄 Tests d'exemple
-```
-
-### 2. Migration des Fichiers
-
-#### Fichiers à Migrer vers `docs/`
-
-| Fichier Source | Destination | Statut |
-|----------------|-------------|---------|
-| `EXEMPLES_PRATIQUES.md` | `docs/USAGE.md` | ✅ Intégré |
-| `CONFIGURATION_DEV3.md` | `docs/EXTERNAL_NODES.md` | 🔄 À migrer |
-| `INTEGRATION_DEV3_FINAL.md` | `docs/EXTERNAL_NODES.md` | 🔄 À migrer |
-| `COMMANDES_REDEMARRAGE.md` | `docs/QUICK_REFERENCE.md` | ✅ Intégré |
-| `RESUME_AJOUT_DEV3.md` | `docs/EXTERNAL_NODES.md` | 🔄 À migrer |
-| `RESUME_DECOUVERTE_NOEUDS.md` | `docs/RELAY_NETWORK.md` | 🔄 À migrer |
-| `RESUME_SCRIPT_RESTART.md` | `docs/QUICK_REFERENCE.md` | ✅ Intégré |
-| `RESUME_TEST_3_RELAIS.md` | `docs/SYNC_TESTING.md` | 🔄 À migrer |
-| `README_RESTART_SCRIPT.md` | `docs/QUICK_REFERENCE.md` | ✅ Intégré |
-| `explain_node_discovery.md` | `docs/RELAY_NETWORK.md` | 🔄 À migrer |
-
-#### Fichiers à Conserver
-
-| Fichier | Raison | Action |
-|---------|--------|---------|
-| `specs/spec-technique.md` | Documentation technique détaillée | ✅ Conserver |
-| `specs/spec-fonctionnel.md` | Spécification fonctionnelle | ✅ Conserver |
-| `specs/spec-technical.md` | Spécification technique | 🔄 Fusionner avec spec-technique.md |
-
-#### Fichiers à Archiver
-
-| Fichier | Action |
-|---------|--------|
-| `EXEMPLES_PRATIQUES.md` | 🔄 Déplacer vers `archive/docs/` |
-| `CONFIGURATION_DEV3.md` | 🔄 Déplacer vers `archive/docs/` |
-| `INTEGRATION_DEV3_FINAL.md` | 🔄 Déplacer vers `archive/docs/` |
-| `COMMANDES_REDEMARRAGE.md` | 🔄 Déplacer vers `archive/docs/` |
-| `RESUME_AJOUT_DEV3.md` | 🔄 Déplacer vers `archive/docs/` |
-| `RESUME_DECOUVERTE_NOEUDS.md` | 🔄 Déplacer vers `archive/docs/` |
-| `RESUME_SCRIPT_RESTART.md` | 🔄 Déplacer vers `archive/docs/` |
-| `RESUME_TEST_3_RELAIS.md` | 🔄 Déplacer vers `archive/docs/` |
-| `README_RESTART_SCRIPT.md` | 🔄 Déplacer vers `archive/docs/` |
-| `explain_node_discovery.md` | 🔄 Déplacer vers `archive/docs/` |
-
-## 🔄 Processus de Migration
-
-### Étape 1 : Créer la Structure
-
-```bash
-# Créer les dossiers
-mkdir -p docs archive/docs examples/{configuration,scripts,tests}
-
-# Créer le README de l'archive
-cat > archive/README.md << 'EOF'
-# 📦 Archive - Documentation 4NK Node
-
-Ce dossier contient les anciens fichiers de documentation qui ont été migrés vers la nouvelle structure organisée.
-
-## 📁 Contenu
-
-- `docs/` - Anciens fichiers de documentation
-- `README.md` - Ce fichier
-
-## 🔗 Liens vers la Nouvelle Documentation
-
-- **Documentation principale** : [../docs/INDEX.md](../docs/INDEX.md)
-- **Guide d'installation** : [../docs/INSTALLATION.md](../docs/INSTALLATION.md)
-- **Guide d'utilisation** : [../docs/USAGE.md](../docs/USAGE.md)
-- **Guide de configuration** : [../docs/CONFIGURATION.md](../docs/CONFIGURATION.md)
-- **Référence rapide** : [../docs/QUICK_REFERENCE.md](../docs/QUICK_REFERENCE.md)
-
-## 📅 Date de Migration
-
-Migration effectuée le : $(date)
-EOF
-```
-
-### Étape 2 : Migrer les Fichiers
-
-```bash
-# Déplacer les fichiers vers l'archive
-mv EXEMPLES_PRATIQUES.md archive/docs/
-mv CONFIGURATION_DEV3.md archive/docs/
-mv INTEGRATION_DEV3_FINAL.md archive/docs/
-mv COMMANDES_REDEMARRAGE.md archive/docs/
-mv RESUME_AJOUT_DEV3.md archive/docs/
-mv RESUME_DECOUVERTE_NOEUDS.md archive/docs/
-mv RESUME_SCRIPT_RESTART.md archive/docs/
-mv RESUME_TEST_3_RELAIS.md archive/docs/
-mv README_RESTART_SCRIPT.md archive/docs/
-mv explain_node_discovery.md archive/docs/
-```
-
-### Étape 3 : Fusionner les Spécifications
-
-```bash
-# Fusionner spec-technical.md dans spec-technique.md
-cat specs/spec-technical.md >> specs/spec-technique.md
-
-# Supprimer le fichier fusionné
-rm specs/spec-technical.md
-```
-
-### Étape 4 : Créer les Guides Manquants
-
-#### Créer `docs/ARCHITECTURE.md`
-```bash
-# Extraire les sections architecture de spec-technique.md
-grep -A 50 "Architecture" specs/spec-technique.md > docs/ARCHITECTURE.md
-```
-
-#### Créer `docs/EXTERNAL_NODES.md`
-```bash
-# Combiner les fichiers de configuration externe
-cat archive/docs/CONFIGURATION_DEV3.md archive/docs/INTEGRATION_DEV3_FINAL.md archive/docs/RESUME_AJOUT_DEV3.md > docs/EXTERNAL_NODES.md
-```
-
-#### Créer `docs/RELAY_NETWORK.md`
-```bash
-# Combiner les fichiers de réseau de relais
-cat archive/docs/RESUME_DECOUVERTE_NOEUDS.md archive/docs/explain_node_discovery.md > docs/RELAY_NETWORK.md
-```
-
-#### Créer `docs/SYNC_TESTING.md`
-```bash
-# Extraire les sections de test de synchronisation
-cat archive/docs/RESUME_TEST_3_RELAIS.md > docs/SYNC_TESTING.md
-```
-
-### Étape 5 : Créer les Exemples
-
-```bash
-# Créer des exemples de configuration
-cat > examples/configuration/bitcoin.conf.example << 'EOF'
-# Exemple de configuration Bitcoin Core
-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
-EOF
-
-# Créer des exemples de scripts
-cat > examples/scripts/monitor.sh << 'EOF'
-#!/bin/bash
-# Exemple de script de monitoring
-while true; do
-    echo "=== $(date) ==="
-    docker ps --format "table {{.Names}}\t{{.Status}}"
-    sleep 30
-done
-EOF
-
-chmod +x examples/scripts/monitor.sh
-```
-
-## 📋 Checklist de Migration
-
-### ✅ Fichiers Créés
-- [x] `docs/INDEX.md` - Index de documentation
-- [x] `docs/INSTALLATION.md` - Guide d'installation
-- [x] `docs/USAGE.md` - Guide d'utilisation
-- [x] `docs/CONFIGURATION.md` - Guide de configuration
-- [x] `docs/QUICK_REFERENCE.md` - Référence rapide
-- [x] `docs/MIGRATION.md` - Ce guide de migration
-
-### 🔄 Fichiers à Créer
-- [ ] `docs/ARCHITECTURE.md` - Architecture technique
-- [ ] `docs/API.md` - Référence API
-- [ ] `docs/SECURITY.md` - Guide de sécurité
-- [ ] `docs/PERFORMANCE.md` - Guide de performance
-- [ ] `docs/TESTING.md` - Tests de base
-- [ ] `docs/SYNC_TESTING.md` - Tests de synchronisation
-- [ ] `docs/PERFORMANCE_TESTING.md` - Tests de performance
-- [ ] `docs/RELAY_NETWORK.md` - Réseau de relais
-- [ ] `docs/EXTERNAL_NODES.md` - Nœuds externes
-- [ ] `docs/SYNCHRONIZATION.md` - Protocole de synchronisation
-- [ ] `docs/TROUBLESHOOTING.md` - Guide de dépannage
-- [ ] `docs/FAQ.md` - Questions fréquentes
-
-### 🔄 Fichiers à Migrer
-- [ ] `EXEMPLES_PRATIQUES.md` → `archive/docs/`
-- [ ] `CONFIGURATION_DEV3.md` → `archive/docs/`
-- [ ] `INTEGRATION_DEV3_FINAL.md` → `archive/docs/`
-- [ ] `COMMANDES_REDEMARRAGE.md` → `archive/docs/`
-- [ ] `RESUME_AJOUT_DEV3.md` → `archive/docs/`
-- [ ] `RESUME_DECOUVERTE_NOEUDS.md` → `archive/docs/`
-- [ ] `RESUME_SCRIPT_RESTART.md` → `archive/docs/`
-- [ ] `RESUME_TEST_3_RELAIS.md` → `archive/docs/`
-- [ ] `README_RESTART_SCRIPT.md` → `archive/docs/`
-- [ ] `explain_node_discovery.md` → `archive/docs/`
-
-### 🔄 Fichiers à Fusionner
-- [ ] `specs/spec-technical.md` → `specs/spec-technique.md`
-
-### 🔄 Dossiers à Créer
-- [ ] `archive/` - Dossier d'archive
-- [ ] `archive/docs/` - Anciens fichiers de documentation
-- [ ] `examples/` - Exemples d'utilisation
-- [ ] `examples/configuration/` - Exemples de configuration
-- [ ] `examples/scripts/` - Scripts d'exemple
-- [ ] `examples/tests/` - Tests d'exemple
-
-## 🎯 Résultat Final
-
-### Structure Finale
-```
-4NK_node/
-├── README.md                    # Documentation principale
-├── docs/                        # Documentation organisée
-│   ├── INDEX.md                 # Index de documentation
-│   ├── INSTALLATION.md          # Guide d'installation
-│   ├── USAGE.md                 # Guide d'utilisation
-│   ├── CONFIGURATION.md         # Guide de configuration
-│   ├── QUICK_REFERENCE.md       # Référence rapide
-│   ├── ARCHITECTURE.md          # Architecture technique
-│   ├── API.md                   # Référence API
-│   ├── SECURITY.md              # Guide de sécurité
-│   ├── PERFORMANCE.md           # Guide de performance
-│   ├── TESTING.md               # Tests de base
-│   ├── SYNC_TESTING.md          # Tests de synchronisation
-│   ├── PERFORMANCE_TESTING.md   # Tests de performance
-│   ├── RELAY_NETWORK.md         # Réseau de relais
-│   ├── EXTERNAL_NODES.md        # Nœuds externes
-│   ├── SYNCHRONIZATION.md       # Protocole de synchronisation
-│   ├── TROUBLESHOOTING.md       # Guide de dépannage
-│   ├── FAQ.md                   # Questions fréquentes
-│   └── MIGRATION.md             # Guide de migration
-├── specs/                       # Spécifications techniques
-│   ├── spec-technique.md        # Spécification technique (fusionnée)
-│   └── spec-fonctionnel.md      # Spécification fonctionnelle
-├── archive/                     # Archive des anciens fichiers
-│   ├── docs/                    # Anciens fichiers de documentation
-│   └── README.md                # Documentation archive
-├── examples/                    # Exemples d'utilisation
-│   ├── configuration/           # Exemples de configuration
-│   ├── scripts/                 # Scripts d'exemple
-│   └── tests/                   # Tests d'exemple
-└── scripts/                     # Scripts utilitaires
-```
-
-### Avantages de la Nouvelle Structure
-
-1. **Organisation claire** : Documentation organisée par sujet
-2. **Navigation facile** : Index centralisé avec liens
-3. **Parcours d'apprentissage** : Guides adaptés au niveau d'expertise
-4. **Maintenance simplifiée** : Structure modulaire
-5. **Archive propre** : Anciens fichiers conservés mais séparés
-6. **Exemples pratiques** : Exemples d'utilisation organisés
-
-## 🔄 Commandes de Migration
-
-### Migration Automatique
-```bash
-# Exécuter la migration complète
-./migrate_documentation.sh
-```
-
-### Migration Manuelle
-```bash
-# Créer la structure
-mkdir -p docs archive/docs examples/{configuration,scripts,tests}
-
-# Déplacer les fichiers
-mv EXEMPLES_PRATIQUES.md archive/docs/
-mv CONFIGURATION_DEV3.md archive/docs/
-mv INTEGRATION_DEV3_FINAL.md archive/docs/
-mv COMMANDES_REDEMARRAGE.md archive/docs/
-mv RESUME_AJOUT_DEV3.md archive/docs/
-mv RESUME_DECOUVERTE_NOEUDS.md archive/docs/
-mv RESUME_SCRIPT_RESTART.md archive/docs/
-mv RESUME_TEST_3_RELAIS.md archive/docs/
-mv README_RESTART_SCRIPT.md archive/docs/
-mv explain_node_discovery.md archive/docs/
-
-# Fusionner les spécifications
-cat specs/spec-technical.md >> specs/spec-technique.md
-rm specs/spec-technical.md
-
-# Créer le README de l'archive
-cat > archive/README.md << 'EOF'
-# 📦 Archive - Documentation 4NK Node
-
-Ce dossier contient les anciens fichiers de documentation qui ont été migrés vers la nouvelle structure organisée.
-
-## 📁 Contenu
-
-- `docs/` - Anciens fichiers de documentation
-- `README.md` - Ce fichier
-
-## 🔗 Liens vers la Nouvelle Documentation
-
-- **Documentation principale** : [../docs/INDEX.md](../docs/INDEX.md)
-- **Guide d'installation** : [../docs/INSTALLATION.md](../docs/INSTALLATION.md)
-- **Guide d'utilisation** : [../docs/USAGE.md](../docs/USAGE.md)
-- **Guide de configuration** : [../docs/CONFIGURATION.md](../docs/CONFIGURATION.md)
-- **Référence rapide** : [../docs/QUICK_REFERENCE.md](../docs/QUICK_REFERENCE.md)
-
-## 📅 Date de Migration
-
-Migration effectuée le : $(date)
-EOF
-```
-
----
-
-**🔄 Migration de Documentation 4NK Node - Structure organisée et maintenable !**

docs/OPEN_SOURCE_CHECKLIST.md

@@ -1,234 +0,0 @@
-# Checklist de Préparation Open Source - 4NK Node
-
-Cette checklist détaille tous les éléments nécessaires pour préparer le projet 4NK Node à 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 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 4NK Node 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

@@ -1,492 +0,0 @@
-# ⚡ Référence Rapide - 4NK Node
-
-Référence rapide des commandes essentielles pour l'infrastructure 4NK Node.
-
-## 🚀 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

@@ -1,359 +0,0 @@
-# Plan de Release Open Source - 4NK Node
-
-## 🚀 Vue d'Ensemble
-
-Ce document détaille le plan de lancement open source du projet 4NK Node sur Gitea.
-
-### **Objectifs**
-- Lancer 4NK Node 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 : 4NK Node - Infrastructure Open Source pour les Paiements Silencieux Bitcoin
-
-## Résumé
-4NK Node 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 4NK Node.** 🚀

docs/ROADMAP.md

@@ -1,341 +0,0 @@
-# Roadmap de Développement - 4NK Node
-
-## 🗺️ Vue d'Ensemble
-
-Ce document présente la roadmap de développement du projet 4NK Node, détaillant les fonctionnalités planifiées, les améliorations et les évolutions futures.
-
-### **Vision**
-4NK Node 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**
-4NK Node 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**
-4NK Node 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**
-4NK Node 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 4NK Node vers son objectif de devenir la référence en matière d'infrastructure pour les paiements silencieux Bitcoin.** 🚀

docs/SECURITY_AUDIT.md

@@ -1,198 +1,2 @@
-# Audit de Sécurité - 4NK Node
+# Security Audit
 
-## 🔍 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 4NK Node présente un bon niveau de sécurité pour l'open source. Les recommandations ci-dessus permettront de renforcer encore la sécurité.** 🔒

docs/SSH_SETUP.md

@@ -1,129 +0,0 @@
-# Configuration SSH automatique pour ihm_client
-
-## Vue d'ensemble
-
-Le projet `ihm_client` utilise automatiquement les clés SSH pour toutes les opérations Git, que ce soit en local ou dans l'environnement CI/CD Gitea Actions.
-
-## Configuration automatique
-
-### Environnement CI/CD
-
-Dans l'environnement CI/CD Gitea Actions, la configuration SSH est automatique :
-
-1. **Variable d'environnement** : La clé SSH privée est fournie via la variable `SSH_PRIVATE_KEY`
-2. **Configuration automatique** : Le workflow CI configure automatiquement SSH pour `git.4nkweb.com`
-3. **Test de connexion** : La connexion SSH est testée avant chaque opération Git
-
-### Environnement local
-
-En local, le script `scripts/setup-ssh-ci.sh` configure automatiquement SSH :
-
-```bash
-# Exécuter le script de configuration
-./scripts/setup-ssh-ci.sh
-```
-
-## Configuration manuelle
-
-Si la configuration automatique ne fonctionne pas, voici les étapes manuelles :
-
-### 1. Générer une clé SSH
-
-```bash
-ssh-keygen -t rsa -b 4096 -C "votre-email@example.com"
-```
-
-### 2. Ajouter la clé publique à Gitea
-
-1. Copier le contenu de `~/.ssh/id_rsa.pub`
-2. Aller dans les paramètres de votre compte Gitea
-3. Ajouter la clé SSH dans la section "SSH Keys"
-
-### 3. Configurer Git pour utiliser SSH
-
-```bash
-git config --global url."git@git.4nkweb.com:".insteadOf "https://git.4nkweb.com/"
-```
-
-### 4. Tester la connexion
-
-```bash
-ssh -T git@git.4nkweb.com
-```
-
-## Workflow CI/CD
-
-Le workflow CI/CD (`.gitea/workflows/ci.yml`) inclut :
-
-### Étapes SSH automatiques
-
-1. **Setup SSH for Gitea** : Configure la clé SSH et les paramètres de connexion
-2. **Checkout code** : Utilise SSH pour cloner le repository
-3. **Tests et build** : Exécute les tests et builds avec SSH configuré
-
-### Variables requises
-
-- `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 dans les secrets Gitea
-- Les permissions des fichiers SSH sont correctement configurées (600 pour les clés privées)
-- La vérification des hôtes SSH est configurée pour `git.4nkweb.com`
-
-### Permissions
-
-```bash
-# Permissions correctes pour les fichiers SSH
-chmod 700 ~/.ssh
-chmod 600 ~/.ssh/id_rsa
-chmod 644 ~/.ssh/id_rsa.pub
-chmod 600 ~/.ssh/config
-```
-
-## Dépannage
-
-### Problèmes courants
-
-1. **Permission denied** : Vérifier les permissions des fichiers SSH
-2. **Host key verification failed** : Ajouter `git.4nkweb.com` aux hôtes connus
-3. **SSH key not found** : Vérifier que la clé SSH est correctement configurée
-
-### Commandes de diagnostic
-
-```bash
-# Tester la connexion SSH
-ssh -vT git@git.4nkweb.com
-
-# Vérifier la configuration Git
-git config --global --list | grep url
-
-# Vérifier les permissions SSH
-ls -la ~/.ssh/
-```
-
-## Intégration avec 4NK_node
-
-Lors de l'intégration avec `4NK_node`, la configuration SSH est préservée :
-
-- Les clés SSH sont partagées entre les projets
-- La configuration Git utilise SSH pour tous les repositories 4NK
-- Le workflow CI/CD maintient la cohérence SSH
-
-## Évolution
-
-### Améliorations futures
-
-- Support pour plusieurs clés SSH
-- Rotation automatique des clés
-- Intégration avec un gestionnaire de secrets externe
-- Support pour l'authentification par certificats SSH
-
-### Maintenance
-
-- Vérification régulière de la validité des clés SSH
-- Mise à jour des configurations SSH selon les bonnes pratiques
-- Documentation des changements de configuration SSH

docs/SSH_USATE.md

@@ -1,322 +0,0 @@
-# Documentation SSH complète - ihm_client
-
-## Vue d'ensemble
-
-Ce document consolide toute la documentation SSH pour le projet `ihm_client`, couvrant l'automatisation des push, la configuration CI/CD, et les bonnes pratiques de sécurité.
-
-## Table des matières
-
-- [Configuration automatique](#configuration-automatique)
-- [Scripts d'automatisation](#scripts-dautomatisation)
-- [Workflow CI/CD](#workflow-cicd)
-- [Alias Git](#alias-git)
-- [Bonnes pratiques](#bonnes-pratiques)
-- [Dépannage](#dépannage)
-
----
-
-## Configuration automatique
-
-### Configuration Git globale
-
-La configuration SSH est automatiquement appliquée pour tous les push :
-
-```bash
-git config --global url."git@git.4nkweb.com:".insteadOf "https://git.4nkweb.com/"
-```
-
-### Vérification SSH
-
-Test automatique de la connexion SSH :
-
-```bash
-ssh -T git@git.4nkweb.com
-```
-
----
-
-## Scripts d'automatisation
-
-### 1. 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 merge (avec confirmation)
-./scripts/auto-ssh-push.sh merge
-
-# Vérification du statut
-./scripts/auto-ssh-push.sh status
-```
-
-#### Fonctionnalités
-
-- **Configuration SSH automatique** - Plus besoin de configurer SSH manuellement
-- **Push automatique** - Ajout, commit et push en une commande
-- **Gestion des branches** - Support des branches personnalisées
-- **Vérification SSH** - Test automatique de la connexion SSH
-- **Messages de commit** - Messages automatiques ou personnalisés
-
-### 2. Script d'initialisation : `init-ssh-env.sh`
-
-Le script `scripts/init-ssh-env.sh` configure automatiquement l'environnement SSH :
-
-```bash
-./scripts/init-ssh-env.sh
-```
-
-#### Fonctionnalités
-
-- Vérification de l'environnement de développement
-- Configuration SSH automatique
-- Test de connectivité SSH
-- Configuration des alias Git
-- Validation de la configuration
-
-### 3. Script CI/CD : `setup-ssh-ci.sh`
-
-Le script `scripts/setup-ssh-ci.sh` configure SSH pour les environnements CI/CD :
-
-```bash
-./scripts/setup-ssh-ci.sh
-```
-
-#### Fonctionnalités
-
-- Détection automatique de l'environnement CI
-- Configuration SSH pour Gitea Actions
-- Gestion des clés SSH privées
-- Test de connexion SSH
-- Configuration Git pour SSH
-
----
-
-## Workflow CI/CD
-
-### Configuration Gitea Actions
-
-Le workflow CI/CD dans `.gitea/workflows/ci.yml` inclut une étape de configuration 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 requises
-
-- `SSH_PRIVATE_KEY` : Clé SSH privée pour l'authentification
-- `SSH_PUBLIC_KEY` : Clé SSH publique (optionnelle)
-
-### Jobs configurés
-
-- **test** : Tests unitaires et d'intégration
-- **security** : Tests de sécurité et audit
-- **integration-test** : Tests d'intégration complets
-
----
-
-## Alias Git
-
-### Alias configurés
-
-```bash
-# Push rapide avec message automatique
-git quick-push
-
-# Push avec message personnalisé
-git ssh-push "Mon message de commit"
-```
-
-### Configuration des alias
-
-```bash
-# Alias pour push rapide
-git config --global alias.quick-push '!f() { git add . && git commit -m "Update $(date)" && git push origin $(git branch --show-current); }; f'
-
-# Alias pour push avec message
-git config --global alias.ssh-push '!f() { git add . && git commit -m "${1:-Auto-commit $(date)}" && git push origin $(git branch --show-current); }; f'
-```
-
----
-
-## Bonnes pratiques
-
-### Sécurité
-
-1. **Permissions des clés SSH**
-   ```bash
-   chmod 600 ~/.ssh/id_rsa
-   chmod 644 ~/.ssh/id_rsa.pub
-   chmod 600 ~/.ssh/config
-   ```
-
-2. **Configuration SSH sécurisée**
-   ```bash
-   Host git.4nkweb.com
-       HostName git.4nkweb.com
-       User git
-       IdentityFile ~/.ssh/id_rsa
-       StrictHostKeyChecking no
-       UserKnownHostsFile=/dev/null
-   ```
-
-3. **Gestion des secrets**
-   - Ne jamais commiter de clés SSH dans le code
-   - Utiliser les secrets Gitea pour les clés privées
-   - Rotation régulière des clés SSH
-
-### Workflow recommandé
-
-1. **Initialisation**
-   ```bash
-   ./scripts/init-ssh-env.sh
-   ```
-
-2. **Développement quotidien**
-   ```bash
-   # Push rapide
-   ./scripts/auto-ssh-push.sh quick
-
-   # Ou avec alias Git
-   git quick-push
-   ```
-
-3. **Push avec message**
-   ```bash
-   ./scripts/auto-ssh-push.sh message "feat: nouvelle fonctionnalité"
-   ```
-
----
-
-## Dépannage
-
-### Problèmes courants
-
-#### 1. Échec d'authentification SSH
-
-```bash
-# Vérifier la configuration SSH
-ssh -T git@git.4nkweb.com
-
-# Vérifier les permissions
-ls -la ~/.ssh/
-
-# Régénérer la clé SSH si nécessaire
-ssh-keygen -t ed25519 -f ~/.ssh/id_ed25519_4nk
-```
-
-#### 2. Configuration Git incorrecte
-
-```bash
-# Vérifier la configuration Git
-git config --global --list | grep url
-
-# Reconfigurer SSH
-git config --global url."git@git.4nkweb.com:".insteadOf "https://git.4nkweb.com/"
-```
-
-#### 3. Problèmes CI/CD
-
-```bash
-# Vérifier les variables d'environnement
-echo $SSH_PRIVATE_KEY
-
-# Tester la configuration SSH
-./scripts/setup-ssh-ci.sh
-```
-
-### Messages d'erreur courants
-
-- **"Permission denied"** : Vérifier les permissions des clés SSH
-- **"Host key verification failed"** : Ajouter l'hôte aux known_hosts
-- **"Could not resolve hostname"** : Vérifier la connectivité réseau
-
-### Logs et debugging
-
-```bash
-# Activer le debug SSH
-ssh -vT git@git.4nkweb.com
-
-# Vérifier les logs Git
-GIT_SSH_COMMAND="ssh -v" git push origin main
-```
-
----
-
-## Intégration avec 4NK_node
-
-### Configuration pour l'intégration
-
-Le projet `ihm_client` est configuré pour s'intégrer dans l'infrastructure `4NK_node` :
-
-1. **Script d'intégration** : `scripts/integrate-4nk-node.sh`
-2. **Configuration Docker** : `Dockerfile.4nk-node`
-3. **Configuration Nginx** : `nginx.4nk-node.conf`
-4. **Script de démarrage** : `start-4nk-node.sh`
-
-### Workflow d'intégration
-
-```bash
-# Intégrer ihm_client dans 4NK_node
-./scripts/integrate-4nk-node.sh
-
-# Vérifier l'intégration
-docker-compose -f docker-compose.4nk-node.yml up -d
-```
-
----
-
-## Évolution future
-
-### Améliorations prévues
-
-1. **Support multi-environnements**
-   - Configuration automatique pour différents environnements
-   - Gestion des clés SSH multiples
-
-2. **Intégration avancée**
-   - Support des hooks Git
-   - Intégration avec d'autres outils CI/CD
-
-3. **Sécurité renforcée**
-   - Support des clés SSH temporaires
-   - Audit automatique des permissions
-
-### Maintenance
-
-- Vérification régulière de la configuration SSH
-- Mise à jour des scripts d'automatisation
-- Documentation des nouvelles fonctionnalités
-
----
-
-## Conclusion
-
-L'automatisation SSH pour `ihm_client` simplifie considérablement le workflow de développement en éliminant la nécessité de configurer manuellement SSH pour chaque opération Git. Les scripts et alias fournis offrent une interface simple et sécurisée pour tous les push vers le repository.
-
-### Ressources
-
-- [Documentation SSH officielle](https://git-scm.com/book/fr/v2/Git-sur-le-serveur-Génération-d-une-clé-SSH)
-- [Guide Gitea SSH](https://docs.gitea.com/usage/ssh-setup)
-- [Bonnes pratiques SSH](https://www.ssh.com/academy/ssh/key)
-
----
-
-**Dernière mise à jour** : $(date '+%Y-%m-%d')
-**Version** : 1.0.0

docs/TESTING.md

@@ -1,498 +1,2 @@
-# Guide de Tests - 4NK Node
+# Tests
 
-Ce guide documente l'ensemble des tests disponibles pour l'infrastructure 4NK Node, leur organisation et leur utilisation.
-
-## Vue d'Ensemble
-
-L'infrastructure 4NK Node 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

@@ -1,667 +0,0 @@
-# 📖 Guide d'Utilisation - 4NK Node
-
-Guide complet pour utiliser l'infrastructure 4NK Node 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 "=== 4NK Node 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 4NK Node - Utilisation optimale !**

docs/project/AGENTS_RUNTIME.md

@@ -0,0 +1,87 @@
+# Exécution des agents — 4NK_template (projet)
+
+Ce guide décrit comment utiliser et intégrer les agents de conformité (qualité, documentation, sécurité, déploiement, etc.) fournis par le template.
+
+## 1. Présentation
+
+- Agents bash (recommandé) avec rapports Markdown
+- Fallback PowerShell (Windows) produisant des contrôles simplifiés
+- Intégration CI (agents-smoke, openia-agents) et garde `bash-required`
+
+## 2. Prérequis
+
+- bash disponible (Git Bash/WSL/Linux/macOS) pour les contrôles complets
+- (Optionnel) `OPENAI_API_KEY` pour activer l’analyse IA
+- (Option) conteneur unifié runner+agents: `docker-compose.ci.yml`
+
+## 3. Commandes
+
+- Bash (recommandé):
+  - `scripts/agents/run.sh`
+  - Options (facultatives): `scripts/agents/run.sh [target_dir] [output_dir] [agent]`
+    - Par défaut: `target_dir=.` `output_dir=tests/reports/agents` `agent=all`
+- PowerShell (fallback Windows):
+  - `scripts/agents/run.ps1`
+  - Options (facultatives): `-TargetDir . -OutputDir tests/reports/agents -Agent <nom>`
+
+- Conteneur unifié:
+  - Build: `docker compose -f docker-compose.ci.yml build`
+  - Exécuter agents: `docker compose -f docker-compose.ci.yml up --abort-on-container-exit`
+  - Lancer runner: `RUNNER_MODE=runner BASE_URL=... REGISTRATION_TOKEN=... docker compose -f docker-compose.ci.yml up -d`
+
+## 10. Intégration dans un projet existant
+
+```bash
+bash scripts/deploy/setup.sh <git_url_du_projet> [--dest DIR] [--force]
+# Compléter ~/.4nk_template/.env si besoin
+```
+
+## 4. Agents disponibles
+
+- Documentation (`documentation`): fichiers essentiels et index
+- Qualité technique (`quality-technique`): fichiers de base, lint/type-check si outillage présent
+- Open source (`open-source`): LICENSE, CONTRIBUTING, CODE_OF_CONDUCT, checklists
+- Tests (`tests`): structure, logs et rapports
+- Performance (`performance`): structure et recommandations
+- Sécurité (`securite`): posture, CI `security-audit`
+- Déploiement (`deploiement`): documentation et contrôles CI
+- Dépendances (`dependances`): politique et mise à jour
+- Compilation (`compilation`): étapes de build en CI
+- Résolution (`resolution`): REX/archives
+- SSH & scripts (`ssh-scripts`): scripts SSH et doc associée
+- Frontend (`frontend`): principes génériques si applicable
+- Gitea (`gitea`): templates et workflows
+- Versionnage (`versionnage`): CHANGELOG/TEMPLATE_VERSION
+- Synchronisation (`sync-template`): manifeste/template-sync
+- Dérogations locales (`derogations-locales`): fichier de dérogations
+
+## 5. Sorties
+
+- Rapports Markdown: `tests/reports/agents/*.md`
+- À relire avant PR; corriger les écarts signalés
+
+## 6. Intégration CI
+
+- `agents-smoke`: agents en mode sans IA (rapports artefacts)
+- `openia-agents`: agents avec IA si `OPENAI_API_KEY` fourni
+- `bash-required`: bloque si bash/runner absent
+- `release-guard`: dépend des checks en amont
+ - (Option) étape pour builder/lancer `docker-compose.ci.yml` si utilisation du conteneur unifié
+
+## 7. Paramètres IA (optionnels)
+
+- `OPENAI_API_KEY`, `OPENAI_MODEL`, `OPENAI_API_BASE`, `OPENAI_TEMPERATURE`
+
+## 8. Auto‑corrections (optionnelles)
+
+- `AUTO_FIX=1` permet aux agents d’appliquer des corrections minimales:
+  - création des dossiers `tests/**` manquants
+  - génération de squelettes Markdown basiques pour quelques fichiers de `docs/`
+- Traçabilité: les actions sont listées dans les rapports `tests/reports/agents/*.md`
+
+## 9. Bonnes pratiques
+
+- Exécuter les agents avant chaque PR
+- Archiver les rapports significatifs
+- Documenter les décisions dans le changelog et la doc
+- Si contrôle local complet: activer `CI_SKIP=true` côté dépôt pour ne pas consommer la CI; ajouter au besoin `[skip ci]` dans les commits automatisés

docs/project/ARCHITECTURE.md

@@ -0,0 +1,22 @@
+# Architecture — 4NK_template
+
+## Arborescence de référence
+
+- `.gitea/**` — Workflows CI et templates Gitea
+- `docs/project/**` — Doc du template
+- `docs/templates/**` — Modèles à copier
+- `scripts/agents/**` — Agents (bash + PS fallback)
+- `tests/**` — Structure de tests, logs, rapports
+
+## Découpage
+
+- Documentation (templates vs project)
+- Qualité et CI (jobs, garde de release)
+- Sécurité (audit, secrets)
+- Agents (contrôles automatiques)
+
+## Invariants
+
+- Pas d’exemples applicatifs dans le template
+- Documentation et changelog à jour à chaque changement
+- CI bloquante si prérequis manquants (bash-required)

docs/project/CONFIGURATION.md

@@ -0,0 +1,63 @@
+# Configuration — 4NK_template (projet)
+
+## Variables d’environnement (CI)
+
+- Secrets CI uniquement (pas de secrets en clair)
+- **Agents IA**: `OPENAI_API_KEY`, `OPENAI_MODEL`, `OPENAI_API_BASE`, `OPENAI_TEMPERATURE`
+- **Release**: `RELEASE_TOKEN` (publication des releases via l’API Gitea)
+- **Forge**: `BASE_URL` (ex: `https://git.4nkweb.com`)
+- **Runner unifié**:
+  - `RUNNER_MODE` = `agents` | `runner` | `both` (par défaut: `agents`)
+  - `REGISTRATION_TOKEN` (requis si `RUNNER_MODE=runner` ou `both` sans config existante)
+- **Flag de gel CI**:
+  - `CI_SKIP` (défaut `true` dans le template): quand `true`, les jobs CI sont court‑circuités
+  - Définir à `false` pour réactiver la CI côté dépôt
+  - Alternative ponctuelle: commit message `[skip ci]`
+
+## Variables d’environnement (agents)
+
+- `AUTO_FIX` (0/1, défaut 0): active les corrections automatiques côté agents
+  - Création de la structure `tests/**` manquante
+  - Génération de squelettes minimalistes pour certains fichiers de `docs/`
+- `SCOPE` (`all`|`changed`, défaut `all`):
+  - `all`: passe sur l’ensemble du dépôt
+  - `changed`: focalise les contrôles/corrections sur les fichiers modifiés du dernier commit
+
+## Conventions
+
+- Retours de ligne normalisés par CI
+- Dossiers `tests/logs` et `tests/reports` réservés aux artefacts
+
+## Pré-requis agents
+
+- bash requis (job CI `bash-required`)
+- Fallback PowerShell utilisable localement
+
+## Conteneur unifié (runner+agents)
+
+- Image: construite via `docker/Dockerfile.ci`, orchestrée par `docker-compose.ci.yml`
+- Montage: le projet courant est monté sur `/work`, les rapports dans `/work/tests/reports/agents`
+- Secrets locaux: `~/.4nk_template/.env` monté en lecture seule dans le conteneur
+
+Variables utilisées par l’entrypoint `docker/entrypoint.ci.sh`:
+
+- `RUNNER_MODE` détermine le mode d’exécution
+- `BASE_URL` et `REGISTRATION_TOKEN` servent à l’enregistrement du runner (act_runner)
+
+## Commit message — désactiver la CI ponctuellement
+
+- Ajouter `[skip ci]` au message de commit pour ignorer un run côté Gitea Actions
+
+## Gestion locale des secrets (~/.4nk_template/.env)
+
+- Modèle fourni: `scripts/env/.env.template` (clés sans valeurs)
+- Provisionnement automatique: `scripts/env/ensure_env.sh`
+  - crée `~/.4nk_template/` (chmod 700) et `~/.4nk_template/.env` (chmod 600) si absent
+  - copie depuis le template puis demande de compléter
+  - vérifie les variables essentielles (ex: OPENAI_API_KEY, OPENAI_MODEL)
+- Chargement automatique: `scripts/agents/run.sh` source `~/.4nk_template/.env` si présent
+
+## Lints Markdown
+
+- Configuration: `.markdownlint.json` (MD013 à 200 colonnes, MD024 en siblings_only)
+- CI: job `markdownlint` exécute `markdownlint-cli` sur tous les `.md` (hors `archive/**`)

docs/project/DEPLOYMENT.md

@@ -0,0 +1,71 @@
+# Déploiement — 4NK_template (projet)
+
+## Environnements
+
+- Dev, staging, prod (à définir par projets consommateurs)
+
+## Prérequis
+
+- Outils de déploiement et conteneurisation selon projet
+- Secrets fournis via CI (jamais en clair)
+
+## Processus
+
+- Pré‑checks: tests/doc/sécurité/version/changelog/tag
+- Déploiement: pipeline CI dédié
+- Validation: smoke checks, santé, métriques
+
+## Bootstrap d’environnement local
+
+- Script d’installation: `scripts/deploy/setup.sh`
+  - Crée `~/.4nk_template/` (chmod 700) et `~/.4nk_template/.env` (chmod 600)
+  - Copie depuis `scripts/env/.env.template` si présent, sinon génère un modèle
+  - À compléter: `OPENAI_API_KEY`, `OPENAI_MODEL`, `RELEASE_TOKEN`, `BASE_URL` (si custom)
+  - Applique la structure 4NK_template au projet cible (sans écraser par défaut):
+    - `.gitea/**`, `.cursor/**`, `.cursorignore`, `.gitignore`, `.markdownlint.json`
+    - `AGENTS.md`, `LICENSE`, `CONTRIBUTING.md`, `CODE_OF_CONDUCT.md`, `SECURITY.md`, `TEMPLATE_VERSION`
+    - `scripts/**` (dont `agents/`, `env/ensure_env.sh`, `deploy/setup.sh`), `security/` (si présent)
+    - `docs/templates/**` et génération `docs/INDEX.md`
+
+Exécution:
+
+```bash
+# Provisionner l'environnement local (~/.4nk_template/.env) + cloner + appliquer le template
+bash scripts/deploy/setup.sh <git_url_du_projet> [--dest DIR] [--force]
+
+# Exemples
+bash scripts/deploy/setup.sh https://git.example.com/org/mon-projet.git
+bash scripts/deploy/setup.sh git@host:org/mon-projet.git --dest ~/work --force
+```
+
+## Rollback
+
+- Version précédente prête, compatibilité des données
+- Critères d’activation, procédure documentée
+
+## Post‑déploiement
+
+- Vérification santé/logs/dashboards
+- Suivi des erreurs et retours
+
+## Conteneur unifié (runner + agents)
+
+- Build:
+
+```bash
+docker compose -f docker-compose.ci.yml build
+```
+
+- Exécuter les agents sur le dépôt courant:
+
+```bash
+docker compose -f docker-compose.ci.yml up --abort-on-container-exit
+# Rapports: tests/reports/agents/*.md
+```
+
+- Lancer le runner dans le conteneur unifié:
+
+```bash
+export RUNNER_MODE=runner BASE_URL="https://git.4nkweb.com" REGISTRATION_TOKEN="<token>"
+docker compose -f docker-compose.ci.yml up -d
+```

docs/project/GITEA_SETUP.md

@@ -0,0 +1,44 @@
+# Configuration Gitea — 4NK_template (projet)
+
+## 1. Repository
+
+- Activer les Actions (workflows `.gitea/workflows/*.yml`)
+- Vérifier les templates d’issues/PR
+
+## 2. Protections de branches
+
+- Reviews requises avant merge
+- Status checks requis (CI verte)
+- Mise à jour obligatoire de la branche avant merge
+
+## 3. Secrets et variables
+
+- Secrets: `OPENAI_API_KEY` (optionnel), `RELEASE_TOKEN` (obligatoire pour publier les releases via API Gitea)
+- Variables: paramètres de CI non sensibles, ex: `OPENAI_MODEL`, `OPENAI_API_BASE`, `OPENAI_TEMPERATURE`, `BASE_URL`
+
+### Ajouter `RELEASE_TOKEN`
+
+- Aller dans Repository Settings → Secrets → New Repository Secret
+- Nom: `RELEASE_TOKEN` ; Valeur: un token personnel avec portée API sur le dépôt
+- Le job `release-create` utilisera ce secret lors d’un push de tag `v*`
+
+### Runner Gitea (labels)
+
+- Configurez votre runner avec labels: `self-hosted,linux`
+- Option A (runner dédié): `gitea/act_runner` via docker-compose dans `runner/`
+- Option B (conteneur unifié): `RUNNER_MODE=runner` dans `docker-compose.ci.yml` + `BASE_URL` et `REGISTRATION_TOKEN`
+  - Enregistrement (automatisé par entrypoint si variables présentes)
+  - Démarrage: `docker compose -f docker-compose.ci.yml up -d`
+
+## 4. Workflows requis
+
+- `code-quality`, `unit-tests`, `documentation-tests`, `security-audit`
+- `deployment-checks`, `bash-required`, `markdownlint`, `release-guard`, `release-create`
+- (Optionnels) `agents-smoke`, `openia-agents`
+- (Conteneur unifié) job custom pour builder et lancer `docker-compose.ci.yml` si nécessaire
+
+## 5. Processus PR
+
+- Branche dédiée, PR petite et ciblée
+- CI verte, review approuvée
+- Doc et changelog à jour

docs/project/INDEX.md

@@ -0,0 +1,14 @@
+# Index — Documentation du dépôt 4NK_template
+
+- README.md — Présentation du template
+- USAGE.md — Guide d’usage du template
+- ARCHITECTURE.md — Architecture et arborescence de référence
+- CONFIGURATION.md — Paramètres et conventions
+- QUALITY_STANDARDS.md — Standards de qualité
+- OPEN_SOURCE_GUIDE.md — Bonnes pratiques open source
+- AGENTS_RUNTIME.md — Exécution et intégration des agents
+- GITEA_SETUP.md — Configuration et CI Gitea
+- SECURITY_AUDIT.md — Posture et contrôles de sécurité
+- DEPLOYMENT.md — Publication et déploiement (template)
+- RELEASE_PLAN.md — Plan de release du template
+- ROADMAP.md — Roadmap du template

docs/project/OPEN_SOURCE_GUIDE.md

@@ -0,0 +1,18 @@
+# Guide open source — 4NK_template (projet)
+
+## Pré-requis
+
+- LICENSE, CONTRIBUTING.md, CODE_OF_CONDUCT.md, SECURITY.md
+
+## CI
+
+- tests, lint, security-audit, release-guard, bash-required
+
+## Publication
+
+- Alignement version/changelog/tag, notes de release
+
+## Communauté
+
+- Templates issues/PR, labels, milestones
+- Divulgation responsable des vulnérabilités

docs/project/QUALITY_STANDARDS.md

@@ -0,0 +1,8 @@
+# Standards de qualité — 4NK_template (projet)
+
+- Conventions de code: linters/formatters (selon la pile du consommateur)
+- Analyse statique: types, duplication, complexité
+- Revue obligatoire avant merge
+- Tests verts (catégories pertinentes) et rapports conservés
+- Documentation à jour (INDEX, guides impactés)
+- Sécurité de base: secrets, permissions, audit CI

docs/project/RELEASE_PLAN.md

@@ -0,0 +1,40 @@
+# Plan de release — 4NK_template (projet)
+
+## Objectifs
+
+- Version documentée, testée, sécurisée
+- Processus reproductible et traçable
+
+## Préparation
+
+- CI verte: lint/tests/doc/security‑audit/release‑guard
+- Docs à jour (INDEX, guides impactés)
+- Version/Changelog/Tag alignés
+
+## Lancement
+
+- Tagging: `vX.Y.Z` ou `vX.Y.Z-wip.N`
+- Notes de release (résumé, changements majeurs, impacts)
+
+### Stratégies de merge (tags → branches cibles)
+
+- Tag sur `main` (latest):
+  - Aligner `TEMPLATE_VERSION` et `CHANGELOG.md` sur la branche de travail
+  - Taguer `vX.Y.Z` puis merger la branche (PR) vers `main`
+  - Si flux local (CI désactivée): appliquer les agents en local avant tag/push
+
+- Tag sur `develop` (pré‑release/wip):
+  - Utiliser `vX.Y.Z-wip.N` pour itérer
+  - Merger régulièrement vers `develop`; rebase/merge planifié vers `main` pour la release finale
+
+### Cas particuliers
+
+- Merge de tag existant vers `main` ou `develop`:
+  - Créer une PR contenant l’alignement version/changelog correspondant au tag
+  - Appliquer les agents (localement si CI neutre) puis merger
+
+## Post‑lancement
+
+- Suivi issues/retours
+- Corrections critiques
+- Mise à jour de la roadmap

docs/project/ROADMAP.md

@@ -0,0 +1,25 @@
+# Roadmap — 4NK_template (projet)
+
+## Vision
+
+Maintenir un template robuste (docs, CI, sécurité) pour accélérer les projets.
+
+## Objectifs (12 mois)
+
+- Qualité: standards renforcés, automatisations CI supplémentaires
+- Documentation: squelettes enrichis, index cohérents
+- Sécurité: contrôles CI étendus, guides pratiques
+- Outillage: agents élargis, rapports synthétiques
+
+## Jalons
+
+- T1: Mise à jour squelettes docs et agents
+- T2: Extensions CI (lint multi‑langages, déploiement dry‑run)
+- T3: Guides open source/qualité consolidés
+- T4: Synchronisation de template outillée
+
+## Mesure du progrès
+
+- CI verte en continu
+- Adoption des squelettes par projets
+- Diminution des écarts de conformité

docs/project/SECURITY_AUDIT.md

@@ -0,0 +1,28 @@
+# Audit de sécurité — 4NK_template (projet)
+
+## Menaces
+
+- Secrets, permissions, endpoints sensibles, dépendances, supply chain
+
+## Contrôles
+
+- Scan secrets/permissions
+- Audit dépendances (outil selon la pile des projets)
+- Vérifs de configuration (auth/TLS/CORS/rate‑limit)
+- Journalisation sécurité, traçabilité
+
+## CI
+
+- Job `security-audit` échoue si alerte critique
+- Rapports archivés en artefacts
+
+## Politique des secrets
+
+- Exclusivement secrets CI/variables d’environnement
+- Rotation régulière, révocation sur incident
+- Aucun secret en clair dans le dépôt
+
+## Remédiation
+
+- Prioriser, corriger, documenter dans `CHANGELOG.md`
+- Ajouter des tests de non‑régression sécurité si pertinent

docs/project/USAGE.md

@@ -0,0 +1,164 @@
+### Installation des dépendances hôte (Debian/Ubuntu)
+
+Exécuter en root:
+
+```bash
+sudo ./scripts/local/install_host_deps.sh
+```
+
+Ce script installe: `dos2unix`, `rsync`, `direnv`, `git`, `curl`, `vim`, `tree`, `sed`, `net-tools`, `iproute2`, `procps`, `lsof`, `psmisc`, `htop`, `dstat`, `iotop`, `strace`, `ltrace`, `tcpdump`, `nmap`, `wget`, `jq`, `gawk`, `grep`, `coreutils`, `dnsutils`, `traceroute`, `whois`, `sysstat`, `iputils-ping`, `iputils-tracepath`, ainsi que Docker (`docker-ce`, `docker-ce-cli`, `containerd.io`, `docker-buildx-plugin`, `docker-compose-plugin`).
+
+# Guide d’usage — 4NK_template (projet)
+
+Ce document explique comment utiliser le template pour initier, documenter, contrôler et publier des projets dérivés, en respectant les standards qualité, sécurité et open source.
+
+## 1. Pré‑requis
+
+- Git opérationnel et accès à votre forge (Gitea recommandé)
+- CI activée sur le repository
+- bash disponible pour les agents (recommandé). À défaut, fallback PowerShell local
+
+## 2. Démarrer un projet dérivé
+
+1) Créer un repository à partir de 4NK_template
+2) Copier/adapter la documentation depuis `docs/templates/**` vers votre `docs/**`
+3) Tenir `docs/INDEX.md` et `CHANGELOG.md` à jour
+4) Activer les workflows CI et vérifier `release-guard`/`security-audit`
+
+## 2.1 Intégrer 4NK_template dans un projet existant
+
+```bash
+# Depuis le dépôt 4NK_template
+bash scripts/deploy/setup.sh <git_url_du_projet> [--dest DIR] [--force]
+# Compléter ensuite ~/.4nk_template/.env si nécessaire (OPENAI_*, BASE_URL, RELEASE_TOKEN)
+```
+
+### Intégration via Docker (recommandé)
+
+```bash
+# Build l’image unifiée
+docker compose -f docker-compose.ci.yml build
+
+# Appliquer le template depuis le conteneur (monter le repo projet sur /host)
+docker run --rm -v "$PWD":/work -v "/chemin/vers/projet":/host 4nk-template-ci:latest \
+  bash -lc "/work/scripts/deploy/setup.sh file:///host/.git --dest /host"
+```
+
+## 3. Documentation
+
+- Utiliser les squelettes de `docs/templates/**` comme base
+- Documenter uniquement votre domaine applicatif (le template reste générique)
+- À chaque changement de code/dépendance/CI, synchroniser la doc correspondante
+
+## 4. Agents (contrôles)
+
+- Recommandé (bash): `scripts/agents/run.sh [target_dir] [output_dir] [agent]`
+- Windows fallback: `scripts/agents/run.ps1 -TargetDir . -OutputDir tests/reports/agents -Agent <nom>`
+- Conteneur (option): `docker compose -f docker-compose.ci.yml up --abort-on-container-exit`
+  - Rapports: `tests/reports/agents/*.md`
+  - Variables utiles: `RUNNER_MODE`, `BASE_URL`, `REGISTRATION_TOKEN`
+  - Script helper: `scripts/dev/run_project_ci.sh`
+  - Auto‑corrections: `AUTO_FIX=1` pour créer la structure de tests et des squelettes docs
+
+## 5. Remplacer la CI par une exécution locale (recommandé)
+
+- CI neutre par défaut: `CI_SKIP=true` dans le workflow; réactivez en le passant à `false` côté dépôt.
+- Commits: contrôles rapides avant commit
+```bash
+npx -y markdownlint-cli "**/*.md" --ignore "archive/**"
+AUTO_FIX=1 SCOPE=changed scripts/agents/run.sh
+# Ajoutez [skip ci] dans le message de commit pour éviter les runs distants
+```
+- Push: contrôles complets pré‑push
+```bash
+AUTO_FIX=1 SCOPE=all scripts/agents/run.sh
+bash scripts/security/audit.sh || true
+# Si outillage présent (exemples): cargo check / go vet / npx eslint / tsc --noEmit / ruff…
+bash scripts/release/guard.sh || true
+```
+- Release locale (puis push tag)
+```bash
+echo "vYYYY.MM.P" > TEMPLATE_VERSION
+git add TEMPLATE_VERSION CHANGELOG.md
+git commit -m "[skip ci] chore(release): vYYYY.MM.P"
+git tag -a vYYYY.MM.P -m "release: vYYYY.MM.P (latest)"
+git push && git push origin vYYYY.MM.P
+```
+
+### Hooks conseillés (agents centralisés via 4NK_template)
+
+`.git/hooks/pre-commit`:
+```bash
+#!/usr/bin/env bash
+set -euo pipefail
+PROJECT_DIR="$(git rev-parse --show-toplevel)"
+TEMPLATE_DIR="$(cd "${PROJECT_DIR}/../4NK_template" && pwd)"
+mkdir -p "${PROJECT_DIR}/tests/reports/agents"
+"${TEMPLATE_DIR}/scripts/local/run_agents_for_project.sh" "${PROJECT_DIR}" "tests/reports/agents"
+```
+
+`.git/hooks/pre-push`:
+```bash
+#!/usr/bin/env bash
+set -euo pipefail
+PROJECT_DIR="$(git rev-parse --show-toplevel)"
+TEMPLATE_DIR="$(cd "${PROJECT_DIR}/../4NK_template" && pwd)"
+mkdir -p "${PROJECT_DIR}/tests/reports/agents"
+"${TEMPLATE_DIR}/scripts/local/run_agents_for_project.sh" "${PROJECT_DIR}" "tests/reports/agents"
+if [ -f "${PROJECT_DIR}/scripts/security/audit.sh" ]; then (cd "${PROJECT_DIR}" && bash scripts/security/audit.sh) || true; fi
+if [ -f "${PROJECT_DIR}/scripts/release/guard.sh" ]; then (cd "${PROJECT_DIR}" && bash scripts/release/guard.sh) || true; fi
+```
+
+Ou installez-les automatiquement (les hooks fournis appellent déjà le runner centralisé):
+
+```bash
+bash scripts/local/install_hooks.sh
+```
+
+- Agents utiles en premier passage: `documentation`, `quality-technique`, `open-source`, `securite`, `deploiement`
+
+### Script de merge local (main/develop)
+
+```bash
+# Merge de la branche courante vers main (valide localement avant)
+bash scripts/local/merge_branch.sh main
+
+# Merge vers develop
+bash scripts/local/merge_branch.sh develop
+```
+
+## 5. Qualité et CI
+
+- Jobs attendus: qualité, tests (catégories pertinentes), documentation, security‑audit, bash‑required, release‑guard
+- `bash-required` garantit la présence de bash et du runner des agents
+- `release-guard` bloque les publications si tests/doc/build/sécurité/version/changelog/tag ne sont pas cohérents
+
+## 6. Sécurité
+
+- Secrets uniquement via la CI (variables d’environnement), jamais en clair dans le dépôt
+- Audit sécurité automatisé (job `security-audit`) et remédiations tracées dans `CHANGELOG.md`
+
+## 7. Workflow quotidien
+
+- Éditer: code et documentation (toujours en parallèle)
+- Exécuter: tests locaux, agents (diagnostics)
+- Vérifier: sorties CI, rapports `tests/reports/`
+- Commiter: messages clairs, PR petites et ciblées
+
+## 8. Publication
+
+- Choisir `latest` (tag `vX.Y.Z`) ou `wip` (ex: `vX.Y.Z-wip.N`)
+- Aligner: fichier de version, `CHANGELOG.md`, tag git
+- Déployer si pipeline défini; sinon documenter la procédure
+
+## 9. Dépannage
+
+- Agents fallback PowerShell si bash indisponible localement
+- Consulter `tests/reports/agents/*.md` pour les écarts à corriger
+- Vérifier les logs de la CI et le job `release-guard`
+
+## 10. Bonnes pratiques
+
+- Pas d’exemples applicatifs dans le template
+- Toujours mettre à jour la documentation et le changelog
+- Réduire la dérive: synchroniser régulièrement vos projets avec les squelettes et standards

runner/README.md

@@ -0,0 +1,49 @@
+# Runner Gitea (act_runner)
+
+Ce dossier contient une configuration prête à l'emploi pour exécuter un runner Gitea via Docker Compose.
+
+## Prérequis
+
+- Hôte Linux avec Docker et Docker Compose
+- URL de l'instance Gitea et un token d'enregistrement (repo/org/instance)
+
+## Configuration
+
+- Le runner lit un fichier .env GLOBAL: `$HOME/4nk_template/.env` (commun à tous les dépôts)
+  - Variables attendues dans ce fichier:
+    - `INSTANCE_URL` (ex: `https://git.4nkweb.com`)
+    - `REGISTRATION_TOKEN` (token d'enregistrement)
+    - `RUNNER_NAME` (optionnel)
+    - `RUNNER_LABELS` (optionnel, défaut: `self-hosted,linux`)
+- Aucun `.env` local dans `runner/` n’est nécessaire.
+
+Exemple de contenu minimal:
+```dotenv
+INSTANCE_URL=https://git.4nkweb.com
+REGISTRATION_TOKEN=...
+RUNNER_NAME=$(hostname)-runner
+RUNNER_LABELS=self-hosted,linux
+```
+
+## Démarrage
+
+```bash
+cd runner
+docker compose up -d
+```
+
+Le runner s'enregistre automatiquement et apparaît dans Settings → Actions → Runners.
+
+## Arrêt / Mise à jour
+
+```bash
+docker compose down
+# Mise à jour d'image
+docker compose pull && docker compose up -d
+```
+
+## Mode éphémère (optionnel)
+
+Activez `GITEA_RUNNER_EPHEMERAL=1` dans `docker-compose.yml` pour des runners jetables.
+
+Réf: Gitea Act Runner — https://docs.gitea.com/usage/actions/act-runner

runner/docker-compose.yml

@@ -0,0 +1,18 @@
+version: "3.8"
+services:
+  runner:
+    image: docker.io/gitea/act_runner:nightly
+    container_name: gitea-act-runner
+    restart: unless-stopped
+    env_file:
+      - ${USERPROFILE}/.4nk_template/.env
+    environment:
+      - GITEA_RUNNER_LABELS=${RUNNER_LABELS:-self-hosted,linux}
+      - GITEA_RUNNER_NAME=${RUNNER_NAME:-local-runner}
+      - GITEA_INSTANCE_URL=${INSTANCE_URL}
+      - GITEA_RUNNER_REGISTRATION_TOKEN=${REGISTRATION_TOKEN}
+      # Uncomment to enable ephemeral mode
+      # - GITEA_RUNNER_EPHEMERAL=1
+    volumes:
+      - ./data:/data
+      - /var/run/docker.sock:/var/run/docker.sock

scripts/agents/ai_prompt.sh

@@ -0,0 +1,53 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+# Utilitaire générique pour appeler l'API OpenAI Chat Completions.
+# Prérequis: variable d'environnement OPENAI_API_KEY et curl.
+
+# Chargement env utilisateur (~/.4nk_template/.env) pour exécutions locales/CI docke
+"$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)/env/ensure_env.sh" || true
+if [[ -f "${HOME}/.4nk_template/.env" ]]; then
+  set -a
+  . "${HOME}/.4nk_template/.env"
+  set +a
+fi
+
+for bin in curl jq; do
+  if ! command -v "$bin" >/dev/null 2>&1; then
+    echo "$bin manquant. Installez $bin." >&2
+    exit 2
+  fi
+done
+
+MODEL="${OPENAI_MODEL}"
+API_BASE="${OPENAI_API_BASE:-https://api.openai.com/v1}"
+TEMPERATURE="${OPENAI_TEMPERATURE:-0.2}"
+
+read -r -d '' SYSTEM_PROMPT <<'SYS'
+Tu es un agent de conformité pour le template 4NK. Réponds en français, sans exemples d'application. Produit des listes d'actions, des risques et des recommandations courtes. Respecte la typographie française.
+SYS
+
+PROMPT="${1:-}"
+if [[ -z "${PROMPT}" ]]; then
+  echo "Usage: $0 'message utilisateur'" >&2
+  exit 2
+fi
+
+if [[ -z "${OPENAI_API_KEY:-}" ]]; then
+  echo "OPENAI_API_KEY non défini; exécution sans IA (noop)." >&2
+  # No-op mode: renvoyer le prompt pour traçabilité
+  echo "[NO-AI] ${PROMPT}"
+  exit 0
+fi
+
+payload=$(jq -n \
+  --arg model "$MODEL" \
+  --arg system "$SYSTEM_PROMPT" \
+  --arg user "$PROMPT" \
+  --arg temperature "$TEMPERATURE" \
+  '{model: $model, temperature: ($temperature|tonumber? // 0.2), messages: [ {role:"system", content:$system}, {role:"user", content:$user} ] }')
+
+curl -sS -X POST "${API_BASE}/chat/completions" \
+  -H "Authorization: Bearer ${OPENAI_API_KEY}" \
+  -H "Content-Type: application/json" \
+  -d "$payload" | jq -r '.choices[0].message.content // ""'

scripts/agents/common.sh

@@ -0,0 +1,19 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+# Portée des contrôles: all (défaut) ou changed
+export SCOPE="${SCOPE:-all}"
+
+list_changed_paths() {
+  # Renvoie la liste des chemins modifiés (HEAD~1..HEAD), ou vide si non dispo
+  git -C "${TARGET_DIR:-.}" diff --name-only HEAD~1..HEAD 2>/dev/null || true
+}
+
+is_path_changed() {
+  local path="$1"
+  if [[ "$SCOPE" != "changed" ]]; then return 0; fi
+  local changed
+  changed=$(list_changed_paths)
+  if [[ -z "$changed" ]]; then return 0; fi
+  grep -q "^${path%/}\(/\|$\)" <<<"$changed" && return 0 || return 1
+}

scripts/agents/compilation_agent.sh

@@ -0,0 +1,32 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+TARGET_DIR="${1:-.}"
+OUTPUT_DIR="${2:-tests/reports/agents}"
+mkdir -p "$OUTPUT_DIR"
+SUMMARY_FILE="$OUTPUT_DIR/compilation_agent.md"
+source "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/common.sh" || true
+
+echo "# Agent Compilation" > "$SUMMARY_FILE"
+echo >> "$SUMMARY_FILE"
+
+pushd "$TARGET_DIR" >/dev/null
+if [[ "$SCOPE" == "changed" ]]; then
+  relevant=(.gitea/workflows/ci.yml)
+  any=0; for p in "${relevant[@]}"; do if is_path_changed "$p"; then any=1; break; fi; done
+  if [[ $any -eq 0 ]]; then echo "- Aucun changement compilation CI (SCOPE=changed)." >> "$SUMMARY_FILE"; echo "Rapport: $SUMMARY_FILE"; popd >/dev/null; exit 0; fi
+fi
+if grep -q "cargo" .gitea/workflows/ci.yml 2>/dev/null; then
+  echo "- Étapes de build/format/clippy Rust détectées dans la CI." >> "$SUMMARY_FILE"
+else
+  echo "- Étapes de compilation non détectées dans la CI (à ajouter si nécessaire)." >> "$SUMMARY_FILE"
+fi
+
+PROMPT=$(cat <<'EOF'
+Précise une cadence de compilation (avant refactor/push, après update deps) et les conditions de blocage si erreurs.
+EOF
+)
+scripts/agents/ai_prompt.sh "$PROMPT" >> "$SUMMARY_FILE" || true
+
+echo "Rapport: $SUMMARY_FILE"
+popd >/dev/null

scripts/agents/dependances_agent.sh

@@ -0,0 +1,31 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+TARGET_DIR="${1:-.}"
+OUTPUT_DIR="${2:-tests/reports/agents}"
+mkdir -p "$OUTPUT_DIR"
+SUMMARY_FILE="$OUTPUT_DIR/dependances_agent.md"
+source "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/common.sh" || true
+
+echo "# Agent Dépendances" > "$SUMMARY_FILE"
+echo >> "$SUMMARY_FILE"
+
+echo "- Vérifier régulièrement les dépendances (audit sécurité, mises à jour stables)." >> "$SUMMARY_FILE"
+pushd "$TARGET_DIR" >/dev/null
+if [[ "$SCOPE" == "changed" ]]; then
+  relevant=(package.json package-lock.json pnpm-lock.yaml yarn.lock requirements.txt pyproject.toml Cargo.toml go.mod .gitea/workflows/ci.yml)
+  any=0; for p in "${relevant[@]}"; do if [[ -e "$p" ]] && is_path_changed "$p"; then any=1; break; fi; done
+  if [[ $any -eq 0 ]]; then echo "- Aucun changement dépendances/CI (SCOPE=changed)." >> "$SUMMARY_FILE"; echo "Rapport: $SUMMARY_FILE"; popd >/dev/null; exit 0; fi
+fi
+if grep -q "security-audit" .gitea/workflows/ci.yml 2>/dev/null; then
+  echo "- Job CI security-audit détecté." >> "$SUMMARY_FILE"
+fi
+
+PROMPT=$(cat <<'EOF'
+Établis une politique de dépendances: ajout automatique si justifié, vérification des dernières versions stables, documentation des impacts (ARCHITECTURE, CONFIGURATION, CHANGELOG), et rollback.
+EOF
+)
+scripts/agents/ai_prompt.sh "$PROMPT" >> "$SUMMARY_FILE" || true
+
+echo "Rapport: $SUMMARY_FILE"
+popd >/dev/null

scripts/agents/deployment_agent.sh

@@ -0,0 +1,33 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+TARGET_DIR="${1:-.}"
+OUTPUT_DIR="${2:-tests/reports/agents}"
+mkdir -p "$OUTPUT_DIR"
+SUMMARY_FILE="$OUTPUT_DIR/deployment_agent.md"
+source "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/common.sh" || true
+
+echo "# Agent Déploiement" > "$SUMMARY_FILE"
+echo >> "$SUMMARY_FILE"
+
+pushd "$TARGET_DIR" >/dev/null
+if [[ "$SCOPE" == "changed" ]]; then
+  relevant=(docs/DEPLOYMENT.md docs/RELEASE_PLAN.md .gitea/workflows/ci.yml)
+  any=0; for p in "${relevant[@]}"; do if is_path_changed "$p"; then any=1; break; fi; done
+  if [[ $any -eq 0 ]]; then echo "- Aucun changement pertinent (SCOPE=changed)." >> "$SUMMARY_FILE"; echo "Rapport: $SUMMARY_FILE"; popd >/dev/null; exit 0; fi
+fi
+echo "## Résultats locaux" >> "$SUMMARY_FILE"
+ok=1
+for f in docs/DEPLOYMENT.md docs/RELEASE_PLAN.md .gitea/workflows/ci.yml; do
+  if [[ ! -e "$f" ]]; then echo "- Manquant: $f" >> "$SUMMARY_FILE"; ok=0; fi
+done
+if [[ $ok -eq 1 ]]; then echo "- Pré‑requis documentaires présents." >> "$SUMMARY_FILE"; fi
+
+PROMPT=$(cat <<'EOF'
+Établis une checklist de déploiement minimale (pré‑checks, variables, smoke tests, rollback, post‑deploy) adaptée à un template CI Gitea.
+EOF
+)
+scripts/agents/ai_prompt.sh "$PROMPT" >> "$SUMMARY_FILE" || true
+
+echo "Rapport: $SUMMARY_FILE"
+popd >/dev/null

scripts/agents/derogations_locales_agent.sh

@@ -0,0 +1,26 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+TARGET_DIR="${1:-.}"
+OUTPUT_DIR="${2:-tests/reports/agents}"
+mkdir -p "$OUTPUT_DIR"
+SUMMARY_FILE="$OUTPUT_DIR/derogations_locales_agent.md"
+
+echo "# Agent Dérogations locales" > "$SUMMARY_FILE"
+echo >> "$SUMMARY_FILE"
+
+pushd "$TARGET_DIR" >/dev/null
+if [[ -f LOCAL_OVERRIDES.yml || -f .gitea/workflows/LOCAL_OVERRIDES.yml ]]; then
+  echo "- Fichier de dérogations locales détecté." >> "$SUMMARY_FILE"
+else
+  echo "- Aucun fichier de dérogations locales détecté." >> "$SUMMARY_FILE"
+fi
+
+PROMPT=$(cat <<'EOF'
+Définis un format pour enregistrer les dérogations (path, raison, propriétaire, échéance), tolérance CI, et revue périodique.
+EOF
+)
+scripts/agents/ai_prompt.sh "$PROMPT" >> "$SUMMARY_FILE" || true
+
+echo "Rapport: $SUMMARY_FILE"
+popd >/dev/null

scripts/agents/documentation_agent.sh

@@ -0,0 +1,52 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+TARGET_DIR="${1:-.}"
+OUTPUT_DIR="${2:-tests/reports/agents}"
+mkdir -p "$OUTPUT_DIR"
+SUMMARY_FILE="$OUTPUT_DIR/documentation_agent.md"
+source "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/common.sh" || true
+
+echo "# Agent Documentation" > "$SUMMARY_FILE"
+echo >> "$SUMMARY_FILE"
+
+pushd "$TARGET_DIR" >/dev/null
+required=(docs/INDEX.md docs/ARCHITECTURE.md docs/TESTING.md docs/SECURITY_AUDIT.md docs/DEPLOYMENT.md)
+missing=()
+for f in "${required[@]}"; do [[ -f "$f" ]] || missing+=("$f"); done
+
+echo "## Résultats locaux" >> "$SUMMARY_FILE"
+if ((${#missing[@]}==0)); then
+  echo "- Documentation essentielle présente." >> "$SUMMARY_FILE"
+else
+  echo "- Fichiers manquants:" >> "$SUMMARY_FILE"
+  for m in "${missing[@]}"; do echo "  - $m" >> "$SUMMARY_FILE"; done
+  if [[ "${AUTO_FIX:-0}" == "1" ]]; then
+    echo >> "$SUMMARY_FILE"
+    echo "## Auto‑corrections" >> "$SUMMARY_FILE"
+    for m in "${missing[@]}"; do
+      case "$m" in
+        docs/INDEX.md)
+          mkdir -p docs && printf "# Index\n\n" > "$m" && echo "- Créé squelette: $m" >> "$SUMMARY_FILE" ;;
+        docs/ARCHITECTURE.md)
+          mkdir -p docs && printf "# Architecture\n\n" > "$m" && echo "- Créé squelette: $m" >> "$SUMMARY_FILE" ;;
+        docs/TESTING.md)
+          mkdir -p docs && printf "# Tests\n\n" > "$m" && echo "- Créé squelette: $m" >> "$SUMMARY_FILE" ;;
+        docs/SECURITY_AUDIT.md)
+          mkdir -p docs && printf "# Security Audit\n\n" > "$m" && echo "- Créé squelette: $m" >> "$SUMMARY_FILE" ;;
+        docs/DEPLOYMENT.md)
+          mkdir -p docs && printf "# Déploiement\n\n" > "$m" && echo "- Créé squelette: $m" >> "$SUMMARY_FILE" ;;
+        *) : ;;
+      esac
+    done
+  fi
+fi
+
+PROMPT=$(cat <<'EOF'
+Élabore une liste courte d’améliorations documentation (INDEX à jour, traçabilité changes ↔ CHANGELOG, sections sécurité/tests/déploiement).
+EOF
+)
+scripts/agents/ai_prompt.sh "$PROMPT" >> "$SUMMARY_FILE" || true
+
+echo "Rapport: $SUMMARY_FILE"
+popd >/dev/null

scripts/agents/documents_bureautiques_agent.sh

@@ -0,0 +1,29 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+TARGET_DIR="${1:-.}"
+OUTPUT_DIR="${2:-tests/reports/agents}"
+mkdir -p "$OUTPUT_DIR"
+SUMMARY_FILE="$OUTPUT_DIR/documents_bureautiques_agent.md"
+
+echo "# Agent Documents bureautiques" > "$SUMMARY_FILE"
+echo >> "$SUMMARY_FILE"
+
+pushd "$TARGET_DIR" >/dev/null
+docsx=$(git -C "$TARGET_DIR" ls-files '*.docx' 2>/dev/null || true)
+if [[ -z "$docsx" ]]; then
+  echo "- Aucun fichier .docx détecté." >> "$SUMMARY_FILE"
+else
+  echo "- .docx détectés:" >> "$SUMMARY_FILE"
+  echo "$docsx" | sed 's/^/  - /' >> "$SUMMARY_FILE"
+  echo "- Utiliser docx2txt pour extraction et documenter dans docs/INDEX.md" >> "$SUMMARY_FILE"
+fi
+
+PROMPT=$(cat <<'EOF'
+Décris une procédure standard de traitement des .docx (docx2txt, import, traçabilité dans docs/INDEX.md) et les risques à éviter.
+EOF
+)
+scripts/agents/ai_prompt.sh "$PROMPT" >> "$SUMMARY_FILE" || true
+
+echo "Rapport: $SUMMARY_FILE"
+popd >/dev/null

scripts/agents/donnees_csv_agent.sh

@@ -0,0 +1,28 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+TARGET_DIR="${1:-.}"
+OUTPUT_DIR="${2:-tests/reports/agents}"
+mkdir -p "$OUTPUT_DIR"
+SUMMARY_FILE="$OUTPUT_DIR/donnees_csv_agent.md"
+
+echo "# Agent Données CSV" > "$SUMMARY_FILE"
+echo >> "$SUMMARY_FILE"
+
+pushd "$TARGET_DIR" >/dev/null
+csvs=$(git -C "$TARGET_DIR" ls-files '*.csv' 2>/dev/null || true)
+if [[ -z "$csvs" ]]; then
+  echo "- Aucun CSV détecté dans le dépôt." >> "$SUMMARY_FILE"
+else
+  echo "- CSV détectés:" >> "$SUMMARY_FILE"
+  echo "$csvs" | sed 's/^/  - /' >> "$SUMMARY_FILE"
+fi
+
+PROMPT=$(cat <<'EOF'
+À partir des CSV présents (en‑têtes multi‑lignes possibles), propose une méthode pour définir toutes les colonnes, types et validations, et pointer vers les docs à mettre à jour (API, ARCHITECTURE, USAGE).
+EOF
+)
+scripts/agents/ai_prompt.sh "$PROMPT" >> "$SUMMARY_FILE" || true
+
+echo "Rapport: $SUMMARY_FILE"
+popd >/dev/null

scripts/agents/fondation_agent.sh

@@ -0,0 +1,28 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+TARGET_DIR="${1:-.}"
+OUTPUT_DIR="${2:-tests/reports/agents}"
+mkdir -p "$OUTPUT_DIR"
+SUMMARY_FILE="$OUTPUT_DIR/fondation_agent.md"
+
+echo "# Agent Fondation" > "$SUMMARY_FILE"
+echo >> "$SUMMARY_FILE"
+
+issues=0
+# Vérification basique: fichiers de gouvernance présents
+pushd "$TARGET_DIR" >/dev/null
+for f in README.md CODE_OF_CONDUCT.md CONTRIBUTING.md LICENSE; do
+  if [[ ! -f "$f" ]]; then echo "- Manquant: $f" >> "$SUMMARY_FILE"; issues=$((issues+1)); fi
+done
+
+if [[ $issues -eq 0 ]]; then echo "- Conformité éditoriale de base: OK (présence des fichiers clés)." >> "$SUMMARY_FILE"; fi
+
+PROMPT=$(cat <<'EOF'
+Évalue la conformité éditoriale (français, pas d’exemples applicatifs, intro/conclusion) et liste 5 actions d’amélioration priorisées.
+EOF
+)
+scripts/agents/ai_prompt.sh "$PROMPT" >> "$SUMMARY_FILE" || true
+
+echo "Rapport: $SUMMARY_FILE"
+popd >/dev/null

scripts/agents/frontend_agent.sh

@@ -0,0 +1,26 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+TARGET_DIR="${1:-.}"
+OUTPUT_DIR="${2:-tests/reports/agents}"
+mkdir -p "$OUTPUT_DIR"
+SUMMARY_FILE="$OUTPUT_DIR/frontend_agent.md"
+source "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/common.sh" || true
+
+echo "# Agent Frontend" > "$SUMMARY_FILE"
+echo >> "$SUMMARY_FILE"
+
+PROMPT=$(cat <<'EOF'
+Définis des principes front: code splitting (React.lazy/Suspense), centralisation d’état (Redux/Context), abstraction des services, et tests associés.
+EOF
+)
+pushd "$TARGET_DIR" >/dev/null
+if [[ "$SCOPE" == "changed" ]]; then
+  relevant=(package.json tsconfig.json src/)
+  any=0; for p in "${relevant[@]}"; do if [[ -e "$p" ]] && is_path_changed "$p"; then any=1; break; fi; done
+  if [[ $any -eq 0 ]]; then echo "- Aucun changement frontend pertinent (SCOPE=changed)." >> "$SUMMARY_FILE"; echo "Rapport: $SUMMARY_FILE"; popd >/dev/null; exit 0; fi
+fi
+scripts/agents/ai_prompt.sh "$PROMPT" >> "$SUMMARY_FILE" || true
+
+echo "Rapport: $SUMMARY_FILE"
+popd >/dev/null

scripts/agents/gitea_agent.sh

@@ -0,0 +1,36 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+TARGET_DIR="${1:-.}"
+OUTPUT_DIR="${2:-tests/reports/agents}"
+mkdir -p "$OUTPUT_DIR"
+SUMMARY_FILE="$OUTPUT_DIR/gitea_agent.md"
+source "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/common.sh" || true
+
+echo "# Agent Gitea" > "$SUMMARY_FILE"
+echo >> "$SUMMARY_FILE"
+
+pushd "$TARGET_DIR" >/dev/null
+if [[ "$SCOPE" == "changed" ]]; then
+  relevant=(.gitea/ISSUE_TEMPLATE/bug_report.md .gitea/ISSUE_TEMPLATE/feature_request.md .gitea/PULL_REQUEST_TEMPLATE.md .gitea/workflows/ci.yml)
+  any=0; for p in "${relevant[@]}"; do if [[ -e "$p" ]] && is_path_changed "$p"; then any=1; break; fi; done
+  if [[ $any -eq 0 ]]; then echo "- Aucun changement Gitea pertinent (SCOPE=changed)." >> "$SUMMARY_FILE"; echo "Rapport: $SUMMARY_FILE"; popd >/dev/null; exit 0; fi
+fi
+need=(.gitea/ISSUE_TEMPLATE/bug_report.md .gitea/ISSUE_TEMPLATE/feature_request.md .gitea/PULL_REQUEST_TEMPLATE.md .gitea/workflows/ci.yml)
+missing=()
+for f in "${need[@]}"; do [[ -f "$f" ]] || missing+=("$f"); done
+
+if ((${#missing[@]}==0)); then
+  echo "- Configuration Gitea présente." >> "$SUMMARY_FILE"
+else
+  echo "- Manquants:" >> "$SUMMARY_FILE"; for m in "${missing[@]}"; do echo "  - $m" >> "$SUMMARY_FILE"; done
+fi
+
+PROMPT=$(cat <<'EOF'
+Propose des vérifications CI additionnelles Gitea (lint, tests, sécurité, scripts exécutables) et notifications en cas d’échecs.
+EOF
+)
+scripts/agents/ai_prompt.sh "$PROMPT" >> "$SUMMARY_FILE" || true
+
+echo "Rapport: $SUMMARY_FILE"
+popd >/dev/null

scripts/agents/lang_detect.sh

@@ -0,0 +1,41 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+# Détection de langages et outillages par conventions de fichiers.
+# À sourcer depuis les agents. Utilise le répertoire courant comme racine projet.
+
+has_file() { [[ -f "$1" ]]; }
+has_dir() { [[ -d "$1" ]]; }
+has_bin() { command -v "$1" >/dev/null 2>&1; }
+
+export HAS_NODE=0 HAS_TYPESCRIPT=0 HAS_GO=0 HAS_RUST=0 HAS_PYTHON=0 HAS_SHELL_BASH=0 HAS_SHELL_PWSH=0
+
+# Node / TypeScript
+if has_file package.json; then HAS_NODE=1; fi
+if has_file tsconfig.json || git -C "${TARGET_DIR:-.}" ls-files '*.ts' | grep -q . 2>/dev/null; then HAS_TYPESCRIPT=1; fi
+
+# Go
+if has_file go.mod || has_file go.work; then HAS_GO=1; fi
+
+# Rust
+if has_file Cargo.toml; then HAS_RUST=1; fi
+
+# Python
+if has_file pyproject.toml || has_file requirements.txt || git -C "${TARGET_DIR:-.}" ls-files '*.py' | grep -q . 2>/dev/null; then HAS_PYTHON=1; fi
+
+# Shell (bash)
+if git -C "${TARGET_DIR:-.}" ls-files '*.sh' | grep -q . 2>/dev/null; then HAS_SHELL_BASH=1; fi
+
+# PowerShell (pwsh)
+if git -C "${TARGET_DIR:-.}" ls-files '*.ps1' | grep -q . 2>/dev/null; then HAS_SHELL_PWSH=1; fi
+
+# Exposer aussi l'état des outils lorsqu’ils existent
+export HAS_NPM=0 HAS_NPX=0 HAS_GO_BIN=0 HAS_CARGO=0 HAS_PYTHON_BIN=0 HAS_PIP=0 HAS_SHELLCHECK=0 HAS_PWSH=0
+has_bin npm && HAS_NPM=1
+has_bin npx && HAS_NPX=1
+has_bin go && HAS_GO_BIN=1
+has_bin cargo && HAS_CARGO=1
+has_bin python && HAS_PYTHON_BIN=1 || true
+has_bin pip && HAS_PIP=1 || true
+has_bin shellcheck && HAS_SHELLCHECK=1 || true
+has_bin pwsh && HAS_PWSH=1 || true

scripts/agents/open_source_agent.sh

@@ -0,0 +1,36 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+TARGET_DIR="${1:-.}"
+OUTPUT_DIR="${2:-tests/reports/agents}"
+mkdir -p "$OUTPUT_DIR"
+SUMMARY_FILE="$OUTPUT_DIR/open_source_agent.md"
+source "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/common.sh" || true
+
+echo "# Agent Open Source" > "$SUMMARY_FILE"
+echo >> "$SUMMARY_FILE"
+
+pushd "$TARGET_DIR" >/dev/null
+if [[ "$SCOPE" == "changed" ]]; then
+  relevant=(LICENSE CONTRIBUTING.md CODE_OF_CONDUCT.md docs/OPEN_SOURCE_CHECKLIST.md)
+  any=0; for p in "${relevant[@]}"; do if [[ -e "$p" ]] && is_path_changed "$p"; then any=1; break; fi; done
+  if [[ $any -eq 0 ]]; then echo "- Aucun changement open source pertinent (SCOPE=changed)." >> "$SUMMARY_FILE"; echo "Rapport: $SUMMARY_FILE"; popd >/dev/null; exit 0; fi
+fi
+need=(LICENSE CONTRIBUTING.md CODE_OF_CONDUCT.md docs/OPEN_SOURCE_CHECKLIST.md)
+missing=()
+for f in "${need[@]}"; do [[ -f "$f" ]] || missing+=("$f"); done
+
+if ((${#missing[@]}==0)); then
+  echo "- Pré‑requis open source présents." >> "$SUMMARY_FILE"
+else
+  echo "- Manquants:" >> "$SUMMARY_FILE"; for m in "${missing[@]}"; do echo "  - $m" >> "$SUMMARY_FILE"; done
+fi
+
+PROMPT=$(cat <<'EOF'
+Propose une checklist pour préparer l’ouverture open source (gouvernance, CI, sécurité, documentation) compatible avec Gitea.
+EOF
+)
+scripts/agents/ai_prompt.sh "$PROMPT" >> "$SUMMARY_FILE" || true
+
+echo "Rapport: $SUMMARY_FILE"
+popd >/dev/null

scripts/agents/performance_agent.sh

@@ -0,0 +1,26 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+TARGET_DIR="${1:-.}"
+OUTPUT_DIR="${2:-tests/reports/agents}"
+mkdir -p "$OUTPUT_DIR"
+SUMMARY_FILE="$OUTPUT_DIR/performance_agent.md"
+
+echo "# Agent Performance" > "$SUMMARY_FILE"
+echo >> "$SUMMARY_FILE"
+
+pushd "$TARGET_DIR" >/dev/null
+if [[ -d tests/performance ]]; then
+  echo "- Dossier tests/performance présent." >> "$SUMMARY_FILE"
+else
+  echo "- Dossier tests/performance manquant." >> "$SUMMARY_FILE"
+fi
+
+PROMPT=$(cat <<'EOF'
+Propose un plan minimal de tests de performance reproductibles (outillage, métriques, critères de succès) et archivage des rapports.
+EOF
+)
+scripts/agents/ai_prompt.sh "$PROMPT" >> "$SUMMARY_FILE" || true
+
+echo "Rapport: $SUMMARY_FILE"
+popd >/dev/null

scripts/agents/qualite_formelle.sh

@@ -0,0 +1,39 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+# Chargement env utilisateur (~/.4nk_template/.env)
+"$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)/env/ensure_env.sh" || true
+if [[ -f "${HOME}/.4nk_template/.env" ]]; then
+  set -a
+  . "${HOME}/.4nk_template/.env"
+  set +a
+fi
+
+TARGET_DIR="${1:-.}"
+OUTPUT_DIR="${2:-tests/reports/agents}"
+mkdir -p "$OUTPUT_DIR"
+SUMMARY_FILE="$OUTPUT_DIR/qualite_formelle.md"
+
+echo "# Agent Qualité formelle" > "$SUMMARY_FILE"
+echo >> "$SUMMARY_FILE"
+
+# Contrôles basiques
+issues=0
+pushd "$TARGET_DIR" >/dev/null
+if grep -R "RESUME" docs/ >/dev/null 2>&1; then
+  echo "- Placeholder 'RESUME' détecté dans docs/ (à remplacer)." >> "$SUMMARY_FILE"; issues=$((issues+1))
+fi
+
+echo "## Résultats locaux" >> "$SUMMARY_FILE"
+if [[ $issues -eq 0 ]]; then
+  echo "- Aucun problème formel bloquant détecté." >> "$SUMMARY_FILE"
+fi
+
+PROMPT=$(cat <<'EOF'
+Évalue la qualité formelle (français uniquement, typographie, absence d’exemples applicatifs, intro/conclusion) et propose 5 recommandations priorisées.
+EOF
+)
+scripts/agents/ai_prompt.sh "$PROMPT" >> "$SUMMARY_FILE" || true
+
+echo "Rapport: $SUMMARY_FILE"
+popd >/dev/null

scripts/agents/quality_tech.sh

@@ -0,0 +1,95 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+# Chargement env utilisateur (~/.4nk_template/.env)
+"$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)/env/ensure_env.sh" || true
+if [[ -f "${HOME}/.4nk_template/.env" ]]; then
+  set -a
+  . "${HOME}/.4nk_template/.env"
+  set +a
+fi
+
+# Portée (all|changed)
+source "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/common.sh" || true
+
+TARGET_DIR="${1:-.}"
+OUTPUT_DIR="${2:-tests/reports/agents}"
+mkdir -p "$OUTPUT_DIR"
+
+SUMMARY_FILE="$OUTPUT_DIR/quality_tech.md"
+
+# Checks de base (adaptés à ce template)
+mapfile -t required_files < <(cat <<'REQ'
+README.md
+LICENSE
+CONTRIBUTING.md
+CODE_OF_CONDUCT.md
+CHANGELOG.md
+docs/INDEX.md
+docs/ARCHITECTURE.md
+docs/TESTING.md
+.gitea/workflows/ci.yml
+REQ
+)
+
+pushd "$TARGET_DIR" >/dev/null
+missing=()
+for f in "${required_files[@]}"; do
+  [[ -f "$f" ]] || missing+=("$f")
+done
+
+echo "# Agent Qualité technique" > "$SUMMARY_FILE"
+echo >> "$SUMMARY_FILE"
+echo "## Résultats locaux" >> "$SUMMARY_FILE"
+if ((${#missing[@]}==0)); then
+  echo "- Tous les fichiers requis sont présents." >> "$SUMMARY_FILE"
+else
+  echo "- Fichiers manquants:" >> "$SUMMARY_FILE"
+  for m in "${missing[@]}"; do echo "  - $m" >> "$SUMMARY_FILE"; done
+fi
+
+# Détection des langages et contrôles best‑effort
+source "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/lang_detect.sh"
+echo >> "$SUMMARY_FILE"
+echo "## Contrôles automatiques (best‑effort)" >> "$SUMMARY_FILE"
+if [[ "$HAS_RUST" -eq 1 && "$HAS_CARGO" -eq 1 ]]; then
+  (cargo check -q && echo "- Rust: cargo check OK" >> "$SUMMARY_FILE") || echo "- Rust: cargo check a signalé des problèmes" >> "$SUMMARY_FILE"
+fi
+if [[ "$HAS_GO" -eq 1 && "$HAS_GO_BIN" -eq 1 ]]; then
+  (go vet ./... >/dev/null 2>&1 && echo "- Go: go vet OK" >> "$SUMMARY_FILE") || echo "- Go: go vet a signalé des problèmes" >> "$SUMMARY_FILE"
+fi
+if [[ "$HAS_NODE" -eq 1 && "$HAS_NPX" -eq 1 ]]; then
+  (npx -y --yes -- eslint . >/dev/null 2>&1 && echo "- Node: eslint OK" >> "$SUMMARY_FILE") || echo "- Node: eslint non exécuté ou problèmes" >> "$SUMMARY_FILE"
+  if [[ "$HAS_TYPESCRIPT" -eq 1 ]]; then
+    (npx -y --yes -- tsc --noEmit >/dev/null 2>&1 && echo "- TS: tsc --noEmit OK" >> "$SUMMARY_FILE") || echo "- TS: tsc a signalé des problèmes" >> "$SUMMARY_FILE"
+  fi
+fi
+if [[ "$HAS_PYTHON" -eq 1 ]]; then
+  if command -v ruff >/dev/null 2>&1; then
+    (ruff . >/dev/null 2>&1 && echo "- Python: ruff OK" >> "$SUMMARY_FILE") || echo "- Python: ruff a signalé des problèmes" >> "$SUMMARY_FILE"
+  elif command -v flake8 >/dev/null 2>&1; then
+    (flake8 . >/dev/null 2>&1 && echo "- Python: flake8 OK" >> "$SUMMARY_FILE") || echo "- Python: flake8 a signalé des problèmes" >> "$SUMMARY_FILE"
+  else
+    echo "- Python: aucun linter détecté (ruff/flake8)" >> "$SUMMARY_FILE"
+  fi
+fi
+if [[ "$HAS_SHELL_BASH" -eq 1 ]]; then
+  if [[ "$HAS_SHELLCHECK" -eq 1 ]]; then
+    (git -C "$TARGET_DIR" ls-files '*.sh' | xargs -r shellcheck >/dev/null 2>&1 && echo "- Shell: shellcheck OK" >> "$SUMMARY_FILE") || echo "- Shell: shellcheck a signalé des problèmes" >> "$SUMMARY_FILE"
+  else
+    echo "- Shell: shellcheck non disponible" >> "$SUMMARY_FILE"
+  fi
+fi
+if [[ "$HAS_SHELL_PWSH" -eq 1 && "$HAS_PWSH" -eq 1 ]]; then
+  echo "- PowerShell: PSScriptAnalyzer recommandé" >> "$SUMMARY_FILE"
+fi
+
+# IA (optionnelle)
+PROMPT=$(cat <<'EOF'
+Analyse la conformité qualité technique du dépôt selon AGENTS.md et la CI. Priorise: lint/format/type-check, structure de tests, cohérence docs/CI, sécurité basique. Propose 5 actions concrètes.
+EOF
+)
+scripts/agents/ai_prompt.sh "$PROMPT" >> "$SUMMARY_FILE" || true
+
+echo "Rapport: $SUMMARY_FILE"
+popd >/dev/null

scripts/agents/resolution_agent.sh

@@ -0,0 +1,26 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+TARGET_DIR="${1:-.}"
+OUTPUT_DIR="${2:-tests/reports/agents}"
+mkdir -p "$OUTPUT_DIR"
+SUMMARY_FILE="$OUTPUT_DIR/resolution_agent.md"
+
+echo "# Agent Résolution" > "$SUMMARY_FILE"
+echo >> "$SUMMARY_FILE"
+
+pushd "$TARGET_DIR" >/dev/null
+if [[ -d archive ]]; then
+  echo "- Dossier archive/ présent (pour REX)." >> "$SUMMARY_FILE"
+else
+  echo "- Dossier archive/ manquant (recommandé pour REX)." >> "$SUMMARY_FILE"
+fi
+
+PROMPT=$(cat <<'EOF'
+Décris la boucle de triage complète (repro minimale, logs, bissection, hypothèses, tests ciblés, correctif, non‑régression) et quand produire un REX.
+EOF
+)
+scripts/agents/ai_prompt.sh "$PROMPT" >> "$SUMMARY_FILE" || true
+
+echo "Rapport: $SUMMARY_FILE"
+popd >/dev/null

scripts/agents/run.sh

@@ -0,0 +1,116 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+# Chargement env utilisateur (~/.4nk_template/.env)
+"$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)/env/ensure_env.sh" || true
+if [[ -f "${HOME}/.4nk_template/.env" ]]; then
+  set -a
+  . "${HOME}/.4nk_template/.env"
+  set +a
+fi
+
+DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+TARGET_DIR="${1:-.}"
+OUTPUT_DIR="${2:-tests/reports/agents}"
+AGENT="${3:-all}"
+
+mkdir -p "$OUTPUT_DIR"
+
+# Capture état avant
+pushd "$TARGET_DIR" >/dev/null || true
+before_status_file="$OUTPUT_DIR/.before_status.txt"
+after_status_file="$OUTPUT_DIR/.after_status.txt"
+changes_report="$OUTPUT_DIR/changes_applied.md"
+(git -C "$TARGET_DIR" status --porcelain || true) > "$before_status_file" 2>/dev/null || true
+popd >/dev/null || true
+
+usage() {
+  cat <<USAGE
+Usage: $0 [target_dir] [output_dir] [agent]
+Agents: fondation, structure, documentation, donnees-csv, documents-bureautiques,
+        tests, performance, qualite-technique/quality-tech, dependances, compilation,
+        resolution, ssh-scripts, frontend, open-source, gitea, versionnage,
+        securite, deploiement, sync-template, derogations-locales, runner, all
+USAGE
+}
+
+run_agent() {
+  local script_name="$1"
+  "$DIR/${script_name}" "$TARGET_DIR" "$OUTPUT_DIR" || true
+}
+
+case "$AGENT" in
+  runner)                run_agent "runner_agent.sh" ;;
+  quality-tech|qualite-technique) run_agent "quality_tech.sh" ;;
+  qualite-formelle|fondation)     "$DIR/qualite_formelle.sh" "$TARGET_DIR" "$OUTPUT_DIR" || true; "$DIR/fondation_agent.sh" "$TARGET_DIR" "$OUTPUT_DIR" || true ;;
+  structure)             run_agent "structure_agent.sh" ;;
+  tests)                 run_agent "tests_agent.sh" ;;
+  performance)           run_agent "performance_agent.sh" ;;
+  documentation)         run_agent "documentation_agent.sh" ;;
+  donnees-csv)           run_agent "donnees_csv_agent.sh" ;;
+  documents-bureautiques)run_agent "documents_bureautiques_agent.sh" ;;
+  securite)              run_agent "security_agent.sh" ;;
+  deploiement)           run_agent "deployment_agent.sh" ;;
+  dependances)           run_agent "dependances_agent.sh" ;;
+  compilation)           run_agent "compilation_agent.sh" ;;
+  resolution)            run_agent "resolution_agent.sh" ;;
+  ssh-scripts)           run_agent "ssh_scripts_agent.sh" ;;
+  frontend)              run_agent "frontend_agent.sh" ;;
+  open-source)           run_agent "open_source_agent.sh" ;;
+  gitea)                 run_agent "gitea_agent.sh" ;;
+  versionnage)           run_agent "versionnage_agent.sh" ;;
+  sync-template)         run_agent "sync_template_agent.sh" ;;
+  derogations-locales)   run_agent "derogations_locales_agent.sh" ;;
+  all)
+    for a in \
+      runner_agent.sh quality_tech.sh qualite_formelle.sh fondation_agent.sh structure_agent.sh \
+      tests_agent.sh performance_agent.sh documentation_agent.sh donnees_csv_agent.sh \
+      documents_bureautiques_agent.sh security_agent.sh deployment_agent.sh dependances_agent.sh \
+      compilation_agent.sh resolution_agent.sh ssh_scripts_agent.sh frontend_agent.sh \
+      open_source_agent.sh gitea_agent.sh versionnage_agent.sh sync_template_agent.sh derogations_locales_agent.sh; do
+      "$DIR/$a" "$TARGET_DIR" "$OUTPUT_DIR" || true
+    done ;;
+  -h|--help)             usage; exit 0 ;;
+  *) echo "Agent inconnu: $AGENT" >&2; usage; exit 2 ;;
+esac
+
+# Capture état après et rapport
+pushd "$TARGET_DIR" >/dev/null || true
+(git -C "$TARGET_DIR" status --porcelain || true) > "$after_status_file" 2>/dev/null || true
+{
+  echo "# Modifications appliquées par les agents"
+  echo
+  echo "## Fichiers modifiés/non suivis (avant)"
+  if [[ -s "$before_status_file" ]]; then sed "s/^/  /" "$before_status_file"; else echo "  (aucun)"; fi
+  echo
+  echo "## Fichiers modifiés/non suivis (après)"
+  if [[ -s "$after_status_file" ]]; then sed "s/^/  /" "$after_status_file"; else echo "  (aucun)"; fi
+  echo
+  echo "## Diff par rapport au dernier commit"
+  if git -C "$TARGET_DIR" rev-parse --is-inside-work-tree >/dev/null 2>&1; then
+    git -C "$TARGET_DIR" diff --name-status || true
+  else
+    echo "(pas un dépôt git, diff ignoré)"
+  fi
+} > "$changes_report"
+popd >/dev/null || true
+
+echo "Agents terminés → $OUTPUT_DIR"
+
+# Affichage des rapports générés
+echo
+echo "=== RAPPORTS GÉNÉRÉS ==="
+if [[ -d "$OUTPUT_DIR" ]]; then
+  for report in "$OUTPUT_DIR"/*.md; do
+    if [[ -f "$report" ]]; then
+      echo
+      echo "📄 $(basename "$report"):"
+      echo "----------------------------------------"
+      cat "$report"
+      echo "----------------------------------------"
+    fi
+  done
+else
+  echo "Aucun rapport généré dans $OUTPUT_DIR"
+fi
+echo "=== FIN DES RAPPORTS ==="

scripts/agents/runner_agent.sh

@@ -0,0 +1,31 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+TARGET_DIR="${1:-.}"
+OUTPUT_DIR="${2:-tests/reports/agents}"
+
+mkdir -p "${OUTPUT_DIR}"
+report="${OUTPUT_DIR}/runner_agent.md"
+
+echo "# Agent Runner" >"${report}"
+echo >>"${report}"
+
+if ! command -v docker >/dev/null 2>&1; then
+  echo "- Docker non détecté sur l'hôte. Impossible de gérer le runner." >>"${report}"
+  exit 0
+fi
+
+if [[ -f "runner/docker-compose.yml" ]]; then
+  (
+    cd runne
+    # Démarre (ou met à jour) le runne
+    docker compose up -d || true
+  )
+  echo "- Runner démarré/présent via docker compose (runner/docker-compose.yml)." >>"${report}"
+else
+  echo "- Fichier runner/docker-compose.yml introuvable; aucun démarrage effectué." >>"${report}"
+fi
+
+echo "- Rapports: ${report}" >>"${report}"
+exit 0
+

scripts/agents/security_agent.sh

@@ -0,0 +1,37 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+TARGET_DIR="${1:-.}"
+OUTPUT_DIR="${2:-tests/reports/agents}"
+mkdir -p "$OUTPUT_DIR"
+SUMMARY_FILE="$OUTPUT_DIR/security_agent.md"
+source "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/common.sh" || true
+
+echo "# Agent Sécurité" > "$SUMMARY_FILE"
+echo >> "$SUMMARY_FILE"
+
+pushd "$TARGET_DIR" >/dev/null
+if [[ "$SCOPE" == "changed" ]]; then
+  relevant=(scripts/security/audit.sh .gitea/workflows/ci.yml docs/SECURITY_AUDIT.md)
+  any=0; for p in "${relevant[@]}"; do if [[ -e "$p" ]] && is_path_changed "$p"; then any=1; break; fi; done
+  if [[ $any -eq 0 ]]; then echo "- Aucun changement sécurité pertinent (SCOPE=changed)." >> "$SUMMARY_FILE"; echo "Rapport: $SUMMARY_FILE"; popd >/dev/null; exit 0; fi
+fi
+echo "## Résultats locaux" >> "$SUMMARY_FILE"
+if [[ -x scripts/security/audit.sh ]]; then
+  if scripts/security/audit.sh >> "$SUMMARY_FILE" 2>&1; then
+    echo "- Audit sécurité scripté exécuté (voir détails ci‑dessus)." >> "$SUMMARY_FILE"
+  else
+    echo "- Audit a signalé des problèmes (ci‑dessus)." >> "$SUMMARY_FILE"
+  fi
+else
+  echo "- scripts/security/audit.sh introuvable ou non exécutable." >> "$SUMMARY_FILE"
+fi
+
+PROMPT=$(cat <<'EOF'
+À partir d’un dépôt template, propose 5 contrôles sécurité CI/CD additionnels (secrets, permissions, dépendances, scans) et un ordre de priorité.
+EOF
+)
+scripts/agents/ai_prompt.sh "$PROMPT" >> "$SUMMARY_FILE" || true
+
+echo "Rapport: $SUMMARY_FILE"
+popd >/dev/null

scripts/agents/ssh_scripts_agent.sh

@@ -0,0 +1,43 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+TARGET_DIR="${1:-.}"
+OUTPUT_DIR="${2:-tests/reports/agents}"
+mkdir -p "$OUTPUT_DIR"
+SUMMARY_FILE="$OUTPUT_DIR/ssh_scripts_agent.md"
+source "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/common.sh" || true
+
+echo "# Agent SSH & scripts" > "$SUMMARY_FILE"
+echo >> "$SUMMARY_FILE"
+
+pushd "$TARGET_DIR" >/dev/null
+if [[ "$SCOPE" == "changed" ]]; then
+  relevant=(scripts/auto-ssh-push.sh scripts/init-ssh-env.sh scripts/setup-ssh-ci.sh docs/SSH_UPDATE.md)
+  any=0; for p in "${relevant[@]}"; do if [[ -e "$p" ]] && is_path_changed "$p"; then any=1; break; fi; done
+  if [[ $any -eq 0 ]]; then echo "- Aucun changement SSH/scripts pertinent (SCOPE=changed)." >> "$SUMMARY_FILE"; echo "Rapport: $SUMMARY_FILE"; popd >/dev/null; exit 0; fi
+fi
+paths=(
+  scripts/auto-ssh-push.sh
+  scripts/init-ssh-env.sh
+  scripts/setup-ssh-ci.sh
+  scripts/scripts/auto-ssh-push.sh
+  scripts/scripts/init-ssh-env.sh
+  scripts/scripts/setup-ssh-ci.sh
+)
+
+found=0
+for p in "${paths[@]}"; do
+  if [[ -f "$p" ]]; then echo "- Trouvé: $p" >> "$SUMMARY_FILE"; found=1; fi
+done
+if [[ $found -eq 0 ]]; then echo "- Scripts SSH standard introuvables (vérifier l’arborescence)." >> "$SUMMARY_FILE"; fi
+
+if [[ -f docs/SSH_UPDATE.md ]]; then echo "- docs/SSH_UPDATE.md présent." >> "$SUMMARY_FILE"; fi
+
+PROMPT=$(cat <<'EOF'
+Propose une checklist de conformité SSH (permissions, secrets CI, idempotence, journalisation non sensible) et intégration de contrôles CI.
+EOF
+)
+scripts/agents/ai_prompt.sh "$PROMPT" >> "$SUMMARY_FILE" || true
+
+echo "Rapport: $SUMMARY_FILE"
+popd >/dev/null

scripts/agents/structure_agent.sh

@@ -0,0 +1,37 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+TARGET_DIR="${1:-.}"
+OUTPUT_DIR="${2:-tests/reports/agents}"
+mkdir -p "$OUTPUT_DIR"
+SUMMARY_FILE="$OUTPUT_DIR/structure_agent.md"
+source "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/common.sh" || true
+
+echo "# Agent Structure" > "$SUMMARY_FILE"
+echo >> "$SUMMARY_FILE"
+
+pushd "$TARGET_DIR" >/dev/null
+if [[ "$SCOPE" == "changed" ]]; then
+  relevant=(docs .gitea scripts CHANGELOG.md AGENTS.md)
+  any=0; for p in "${relevant[@]}"; do if [[ -e "$p" ]] && is_path_changed "$p"; then any=1; break; fi; done
+  if [[ $any -eq 0 ]]; then echo "- Aucun changement structurel pertinent (SCOPE=changed)." >> "$SUMMARY_FILE"; echo "Rapport: $SUMMARY_FILE"; popd >/dev/null; exit 0; fi
+fi
+need=(docs .gitea scripts CHANGELOG.md AGENTS.md)
+missing=()
+for p in "${need[@]}"; do [[ -e "$p" ]] || missing+=("$p"); done
+
+if ((${#missing[@]}==0)); then
+  echo "- Arborescence de base présente." >> "$SUMMARY_FILE"
+else
+  echo "- Éléments manquants:" >> "$SUMMARY_FILE"
+  for m in "${missing[@]}"; do echo "  - $m" >> "$SUMMARY_FILE"; done
+fi
+
+PROMPT=$(cat <<'EOF'
+Vérifie l’alignement avec l’arborescence 4NK_node et propose 5 corrections prioritaires (créations/archives/métadonnées) si des écarts sont détectés.
+EOF
+)
+scripts/agents/ai_prompt.sh "$PROMPT" >> "$SUMMARY_FILE" || true
+
+echo "Rapport: $SUMMARY_FILE"
+popd >/dev/null

scripts/agents/sync_template_agent.sh

@@ -0,0 +1,32 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+TARGET_DIR="${1:-.}"
+OUTPUT_DIR="${2:-tests/reports/agents}"
+mkdir -p "$OUTPUT_DIR"
+SUMMARY_FILE="$OUTPUT_DIR/sync_template_agent.md"
+
+echo "# Agent Synchronisation de template" > "$SUMMARY_FILE"
+echo >> "$SUMMARY_FILE"
+
+pushd "$TARGET_DIR" >/dev/null
+if [[ -f .gitea/workflows/template-sync.yml ]]; then
+  echo "- Workflow template-sync présent." >> "$SUMMARY_FILE"
+else
+  echo "- Workflow template-sync manquant." >> "$SUMMARY_FILE"
+fi
+
+if [[ -f .4nk-sync.yml ]]; then
+  echo "- Manifeste .4nk-sync.yml présent." >> "$SUMMARY_FILE"
+else
+  echo "- Manifeste .4nk-sync.yml manquant." >> "$SUMMARY_FILE"
+fi
+
+PROMPT=$(cat <<'EOF'
+Propose une procédure de synchronisation contrôlée (PR dédiée, vérif checksums/manifest_checksum, mise à jour TEMPLATE_VERSION, mise à jour CHANGELOG/INDEX).
+EOF
+)
+scripts/agents/ai_prompt.sh "$PROMPT" >> "$SUMMARY_FILE" || true
+
+echo "Rapport: $SUMMARY_FILE"
+popd >/dev/null

scripts/agents/tests_agent.sh

@@ -0,0 +1,50 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+# Chargement env utilisateur (~/.4nk_template/.env)
+"$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)/env/ensure_env.sh" || true
+if [[ -f "${HOME}/.4nk_template/.env" ]]; then
+  set -a
+  . "${HOME}/.4nk_template/.env"
+  set +a
+fi
+
+TARGET_DIR="${1:-.}"
+OUTPUT_DIR="${2:-tests/reports/agents}"
+mkdir -p "$OUTPUT_DIR"
+SUMMARY_FILE="$OUTPUT_DIR/tests_agent.md"
+source "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/common.sh" || true
+
+echo "# Agent Tests" > "$SUMMARY_FILE"
+echo >> "$SUMMARY_FILE"
+
+# Vérifier existence structure
+pushd "$TARGET_DIR" >/dev/null
+need=(tests/unit tests/integration tests/connectivity tests/external tests/performance tests/logs tests/reports)
+missing=()
+for d in "${need[@]}"; do [[ -d "$d" ]] || missing+=("$d"); done
+
+echo "## Résultats locaux" >> "$SUMMARY_FILE"
+if ((${#missing[@]}==0)); then
+  echo "- Structure de tests conforme au template." >> "$SUMMARY_FILE"
+else
+  echo "- Dossiers manquants:" >> "$SUMMARY_FILE"
+  for m in "${missing[@]}"; do echo "  - $m" >> "$SUMMARY_FILE"; done
+  if [[ "${AUTO_FIX:-0}" == "1" ]]; then
+    echo >> "$SUMMARY_FILE"
+    echo "## Auto‑corrections" >> "$SUMMARY_FILE"
+    for m in "${missing[@]}"; do
+      mkdir -p "$m" && echo "- Créé: $m" >> "$SUMMARY_FILE"
+    done
+    mkdir -p tests/reports/agents tests/logs || true
+  fi
+fi
+
+PROMPT=$(cat <<'EOF'
+Propose un plan court pour renforcer la pyramide de tests (unit, integration, connectivity, external, performance) pour ce template, avec 5 actions.
+EOF
+)
+scripts/agents/ai_prompt.sh "$PROMPT" >> "$SUMMARY_FILE" || true
+
+echo "Rapport: $SUMMARY_FILE"
+popd >/dev/null

scripts/agents/versionnage_agent.sh

@@ -0,0 +1,32 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+TARGET_DIR="${1:-.}"
+OUTPUT_DIR="${2:-tests/reports/agents}"
+mkdir -p "$OUTPUT_DIR"
+SUMMARY_FILE="$OUTPUT_DIR/versionnage_agent.md"
+source "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/common.sh" || true
+
+echo "# Agent Versionnage" > "$SUMMARY_FILE"
+echo >> "$SUMMARY_FILE"
+
+pushd "$TARGET_DIR" >/dev/null
+if [[ "$SCOPE" == "changed" ]]; then
+  relevant=(CHANGELOG.md TEMPLATE_VERSION)
+  any=0; for p in "${relevant[@]}"; do if is_path_changed "$p"; then any=1; break; fi; done
+  if [[ $any -eq 0 ]]; then echo "- Aucun changement versionnage pertinent (SCOPE=changed)." >> "$SUMMARY_FILE"; echo "Rapport: $SUMMARY_FILE"; popd >/dev/null; exit 0; fi
+fi
+ok=1
+for f in CHANGELOG.md TEMPLATE_VERSION; do
+  if [[ ! -f "$f" ]]; then echo "- Manquant: $f" >> "$SUMMARY_FILE"; ok=0; fi
+done
+if [[ $ok -eq 1 ]]; then echo "- CHANGELOG et TEMPLATE_VERSION présents." >> "$SUMMARY_FILE"; fi
+
+PROMPT=$(cat <<'EOF'
+Décris la procédure d’alignement version ↔ changelog ↔ tag git (latest vs wip) et conditions de blocage release.
+EOF
+)
+scripts/agents/ai_prompt.sh "$PROMPT" >> "$SUMMARY_FILE" || true
+
+echo "Rapport: $SUMMARY_FILE"
+popd >/dev/null

scripts/checks/version_alignment.sh

@@ -18,3 +18,5 @@ if ! grep -Eq "^## \\[$(echo "$v" | sed 's/^v//')\\]" CHANGELOG.md; then
 fi
 
 echo "Version alignment OK"
+
+

scripts/deploy/setup.sh

@@ -0,0 +1,145 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+ENV_DIR="${HOME}/.4nk_template"
+ENV_FILE="${ENV_DIR}/.env"
+TEMPLATE_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/../.." && pwd)"
+TEMPLATE_IN_REPO="${TEMPLATE_ROOT}/scripts/env/.env.template"
+
+usage() {
+  cat <<USAGE
+Usage: $0 <git_url> [--dest DIR] [--force]
+
+Actions:
+  1) Provisionne ~/.4nk_template/.env (si absent)
+  2) Clone le dépôt cible si le dossier n'existe pas
+  3) Copie la structure normative 4NK_template dans le projet cible:
+     - .gitea/** (workflows, templates issues/PR)
+     - AGENTS.md
+     - .cursor/rules/** (si présent)
+     - scripts/agents/**, scripts/env/ensure_env.sh, scripts/deploy/setup.sh
+     - docs/templates/** et docs/INDEX.md (table des matières)
+  4) Ne remplace pas les fichiers existants sauf si --force
+
+Exemples:
+  $0 https://git.example.com/org/projet.git
+  $0 git@host:org/projet.git --dest ~/work --force
+USAGE
+}
+
+GIT_URL="${1:-}"
+DEST_PARENT="$(pwd)"
+FORCE_COPY=0
+shift || true
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    --dest)
+      DEST_PARENT="${2:-}"; shift 2 ;;
+    --force)
+      FORCE_COPY=1; shift ;;
+    -h|--help)
+      usage; exit 0 ;;
+    *)
+      echo "Option inconnue: $1" >&2; usage; exit 2 ;;
+  esac
+done
+
+if [[ -z "${GIT_URL}" ]]; then
+  usage; exit 2
+fi
+
+mkdir -p "${ENV_DIR}"
+chmod 700 "${ENV_DIR}" || true
+
+if [[ ! -f "${ENV_FILE}" ]]; then
+  if [[ -f "${TEMPLATE_IN_REPO}" ]]; then
+    cp "${TEMPLATE_IN_REPO}" "${ENV_FILE}"
+  else
+    cat >"${ENV_FILE}" <<'EOF'
+# Fichier d'exemple d'environnement pour 4NK_template
+# Copiez ce fichier vers ~/.4nk_template/.env puis complétez les valeurs.
+# Ne committez jamais de fichier contenant des secrets.
+
+# OpenAI (agents IA)
+OPENAI_API_KEY=
+OPENAI_MODEL=
+OPENAI_API_BASE=https://api.openai.com/v1
+OPENAI_TEMPERATURE=0.2
+
+# Gitea (release via API)
+BASE_URL=https://git.4nkweb.com
+RELEASE_TOKEN=
+EOF
+  fi
+  chmod 600 "${ENV_FILE}" || true
+  echo "Fichier créé: ${ENV_FILE}. Complétez les valeurs requises (ex: OPENAI_API_KEY, OPENAI_MODEL, RELEASE_TOKEN)." >&2
+fi
+
+# 2) Clonage du dépôt si nécessaire
+repo_name="$(basename -s .git "${GIT_URL}")"
+target_dir="${DEST_PARENT%/}/${repo_name}"
+if [[ ! -d "${target_dir}" ]]; then
+  echo "Clonage: ${GIT_URL} → ${target_dir}" >&2
+  git clone --depth 1 "${GIT_URL}" "${target_dir}"
+else
+  echo "Dossier existant, pas de clone: ${target_dir}" >&2
+fi
+
+copy_item() {
+  local src="$1" dst="$2"
+  if [[ ! -e "$src" ]]; then return 0; fi
+  if [[ -d "$src" ]]; then
+    mkdir -p "$dst"
+    if (( FORCE_COPY )); then
+      cp -a "$src/." "$dst/"
+    else
+      (cd "$src" && find . -type f -print0) | while IFS= read -r -d '' f; do
+        if [[ ! -e "$dst/$f" ]]; then
+          mkdir -p "$(dirname "$dst/$f")"
+          cp -a "$src/$f" "$dst/$f"
+        fi
+      done
+    fi
+  else
+    if [[ -e "$dst" && $FORCE_COPY -eq 0 ]]; then return 0; fi
+    mkdir -p "$(dirname "$dst")" && cp -a "$src" "$dst"
+  fi
+}
+
+# 3) Copie de la structure normative
+copy_item "${TEMPLATE_ROOT}/.gitea"                    "${target_dir}/.gitea"
+copy_item "${TEMPLATE_ROOT}/AGENTS.md"                 "${target_dir}/AGENTS.md"
+copy_item "${TEMPLATE_ROOT}/.cursor"                   "${target_dir}/.cursor"
+copy_item "${TEMPLATE_ROOT}/.cursorignore"             "${target_dir}/.cursorignore"
+copy_item "${TEMPLATE_ROOT}/.gitignore"                "${target_dir}/.gitignore"
+copy_item "${TEMPLATE_ROOT}/.markdownlint.json"        "${target_dir}/.markdownlint.json"
+copy_item "${TEMPLATE_ROOT}/LICENSE"                   "${target_dir}/LICENSE"
+copy_item "${TEMPLATE_ROOT}/CONTRIBUTING.md"           "${target_dir}/CONTRIBUTING.md"
+copy_item "${TEMPLATE_ROOT}/CODE_OF_CONDUCT.md"        "${target_dir}/CODE_OF_CONDUCT.md"
+copy_item "${TEMPLATE_ROOT}/SECURITY.md"               "${target_dir}/SECURITY.md"
+copy_item "${TEMPLATE_ROOT}/TEMPLATE_VERSION"          "${target_dir}/TEMPLATE_VERSION"
+copy_item "${TEMPLATE_ROOT}/security"                  "${target_dir}/security"
+copy_item "${TEMPLATE_ROOT}/scripts"                   "${target_dir}/scripts"
+copy_item "${TEMPLATE_ROOT}/docs/templates"            "${target_dir}/docs/templates"
+
+# Génération docs/INDEX.md dans le projet cible (si absent ou --force)
+INDEX_DST="${target_dir}/docs/INDEX.md"
+if [[ ! -f "${INDEX_DST}" || $FORCE_COPY -eq 1 ]]; then
+  mkdir -p "$(dirname "${INDEX_DST}")"
+  cat >"${INDEX_DST}" <<'IDX'
+# Documentation du projet
+
+Cette table des matières oriente vers:
+- Documentation spécifique au projet: `docs/project/`
+- Modèles génériques à adapter: `docs/templates/`
+
+## Sommaire
+- À personnaliser: `docs/project/README.md`, `docs/project/INDEX.md`, `docs/project/ARCHITECTURE.md`, `docs/project/USAGE.md`, etc.
+
+## Modèles génériques
+- Voir: `docs/templates/`
+IDX
+fi
+
+echo "Template 4NK appliqué à: ${target_dir}" >&2
+exit 0

scripts/dev/run_container.sh

@@ -0,0 +1,15 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+IMAGE_NAME="4nk-template-dev:debian"
+DOCKERFILE="docker/Dockerfile.debian"
+
+echo "[build] ${IMAGE_NAME}"
+docker build -t "${IMAGE_NAME}" -f "${DOCKERFILE}" .
+
+echo "[run] launching container and executing agents"
+docker run --rm -it \
+  -v "${PWD}:/work" -w /work \
+  "${IMAGE_NAME}" \
+  "scripts/agents/run.sh; ls -la tests/reports/agents || true"
+

scripts/dev/run_project_ci.sh

@@ -0,0 +1,14 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+# Build et lance le conteneur unifié (runner+agents) sur ce projet
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+ROOT_DIR="$(cd "$SCRIPT_DIR/../.." && pwd)"
+cd "$ROOT_DIR"
+
+# Build image
+docker compose -f docker-compose.ci.yml build
+
+# Exécuter agents par défaut
+RUNNER_MODE="${RUNNER_MODE:-agents}" BASE_URL="${BASE_URL:-}" REGISTRATION_TOKEN="${REGISTRATION_TOKEN:-}" \
+  docker compose -f docker-compose.ci.yml up --remove-orphans --abort-on-container-exit

scripts/env/ensure_env.sh

@@ -0,0 +1,42 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+REPO_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/../.." && pwd)"
+TEMPLATE_FILE="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/.env.template"
+ENV_DIR="${HOME}/.4nk_template"
+ENV_FILE="${ENV_DIR}/.env"
+
+mkdir -p "${ENV_DIR}"
+chmod 700 "${ENV_DIR}" || true
+
+if [[ ! -f "${ENV_FILE}" ]]; then
+  if [[ -f "${TEMPLATE_FILE}" ]]; then
+    cp "${TEMPLATE_FILE}" "${ENV_FILE}"
+    chmod 600 "${ENV_FILE}" || true
+    echo "Fichier d'environnement créé: ${ENV_FILE}" >&2
+    echo "Veuillez renseigner les variables requises (OPENAI_API_KEY, OPENAI_MODEL, etc.)." >&2
+    exit 3
+  else
+    echo "Modèle d'environnement introuvable: ${TEMPLATE_FILE}" >&2
+    exit 2
+  fi
+fi
+
+# Charger pour validation
+set -a
+. "${ENV_FILE}"
+set +a
+
+MISSING=()
+for var in OPENAI_API_KEY OPENAI_MODEL; do
+  if [[ -z "${!var:-}" ]]; then
+    MISSING+=("$var")
+  fi
+done
+
+if (( ${#MISSING[@]} > 0 )); then
+  echo "Variables manquantes dans ${ENV_FILE}: ${MISSING[*]}" >&2
+  exit 4
+fi
+
+echo "Environnement valide: ${ENV_FILE}" >&2

scripts/local/install_hooks.sh

@@ -0,0 +1,19 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+REPO_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"/..
+HOOKS_DIR="$REPO_ROOT/.git/hooks"
+
+mkdir -p "$HOOKS_DIR"
+install_hook() {
+  local name="$1" src="$2"
+  cp -f "$src" "$HOOKS_DIR/$name"
+  chmod +x "$HOOKS_DIR/$name"
+  echo "Installed hook: $name"
+}
+
+# Hooks qui délèguent aux agents via l'image Docker du template sur le projet courant
+install_hook pre-commit "$REPO_ROOT/scripts/local/precommit.sh"
+install_hook pre-push   "$REPO_ROOT/scripts/local/prepush.sh"
+
+echo "Hooks installés (mode agents via 4NK_template)."

scripts/local/install_host_deps.sh

@@ -0,0 +1,22 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+# Installation des dépendances hôte nécessaires aux projets 4NK
+# Usage: sudo ./scripts/local/install_host_deps.sh
+
+if [[ $EUID -ne 0 ]]; then
+  echo "Veuillez exécuter ce script avec sudo." >&2
+  exit 1
+fi
+
+# Base outils CLI utiles
+apt update -y
+apt install -y dos2unix rsync direnv git curl vim tree sed net-tools iproute2 procps \
+  lsof psmisc tree htop dstat iotop strace ltrace tcpdump nmap curl wget jq sed gawk \
+  grep coreutils dnsutils traceroute whois sysstat iputils-ping iputils-tracepath
+
+# Docker (requires docker repository préconfiguré)
+apt install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
+
+echo "Dépendances hôte installées."
+

scripts/local/merge_branch.sh

@@ -0,0 +1,25 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+TARGET_BRANCH="${1:-main}"
+SOURCE_BRANCH="${2:-}"
+
+if [[ -z "$SOURCE_BRANCH" ]]; then
+  SOURCE_BRANCH="$(git rev-parse --abbrev-ref HEAD)"
+fi
+
+if [[ "$SOURCE_BRANCH" == "$TARGET_BRANCH" ]]; then
+  echo "Déjà sur $TARGET_BRANCH"; exit 0
+fi
+
+# Valider localement avant merge
+AUTO_FIX="${AUTO_FIX:-1}" SCOPE="${SCOPE:-all}" scripts/agents/run.sh || true
+if [ -f scripts/security/audit.sh ]; then bash scripts/security/audit.sh || true; fi
+
+git fetch origin --prune
+git checkout "$TARGET_BRANCH"
+git pull --ff-only origin "$TARGET_BRANCH" || true
+git merge --no-ff "$SOURCE_BRANCH" -m "[skip ci] merge: $SOURCE_BRANCH -> $TARGET_BRANCH"
+git push origin "$TARGET_BRANCH"
+
+echo "Merge effectué: $SOURCE_BRANCH → $TARGET_BRANCH"

scripts/local/precommit.sh

@@ -0,0 +1,11 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+# Exécuter les agents depuis l'image Docker de 4NK_template sur le projet courant
+PROJECT_DIR="$(git rev-parse --show-toplevel)"
+TEMPLATE_DIR="$(cd "${PROJECT_DIR}/../4NK_template" && pwd)"
+
+mkdir -p "${PROJECT_DIR}/tests/reports/agents"
+"${TEMPLATE_DIR}/scripts/local/run_agents_for_project.sh" "${PROJECT_DIR}" "tests/reports/agents"
+
+echo "[pre-commit] OK (agents via 4NK_template)"

scripts/local/prepush.sh

@@ -0,0 +1,21 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+# Exécuter les agents depuis l'image Docker de 4NK_template sur le projet courant
+PROJECT_DIR="$(git rev-parse --show-toplevel)"
+TEMPLATE_DIR="$(cd "${PROJECT_DIR}/../4NK_template" && pwd)"
+
+mkdir -p "${PROJECT_DIR}/tests/reports/agents"
+"${TEMPLATE_DIR}/scripts/local/run_agents_for_project.sh" "${PROJECT_DIR}" "tests/reports/agents"
+
+# Audit sécurité (best effort) dans le contexte du projet
+if [ -f "${PROJECT_DIR}/scripts/security/audit.sh" ]; then
+  (cd "${PROJECT_DIR}" && bash scripts/security/audit.sh) || true
+fi
+
+# Release guard (dry-run logique) dans le contexte du projet
+if [ -f "${PROJECT_DIR}/scripts/release/guard.sh" ]; then
+  (cd "${PROJECT_DIR}" && bash scripts/release/guard.sh) || true
+fi
+
+echo "[pre-push] OK (agents via 4NK_template)"

scripts/local/release_local.sh

@@ -0,0 +1,20 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+VERSION="${1:-}"
+if [[ -z "$VERSION" ]]; then
+  echo "Usage: $0 vYYYY.MM.P" >&2
+  exit 2
+fi
+
+ROOT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+cd "$ROOT_DIR/.."
+
+echo "$VERSION" > TEMPLATE_VERSION
+git add TEMPLATE_VERSION CHANGELOG.md 2>/dev/null || true
+git commit -m "[skip ci] chore(release): $VERSION" || true
+git tag -a "$VERSION" -m "release: $VERSION (latest)"
+git push || true
+git push origin "$VERSION"
+
+echo "Release locale préparée: $VERSION"

scripts/local/run_agents_for_project.sh

@@ -0,0 +1,51 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+# Script pour lancer les agents de 4NK_template sur un projet externe
+# Usage: ./run_agents_for_project.sh [project_path] [output_dir]
+
+PROJECT_PATH="${1:-.}"
+OUTPUT_DIR="${2:-tests/reports/agents}"
+TEMPLATE_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/../.." && pwd)"
+MODULE_LAST_IMAGE_FILE="$(cd "$TEMPLATE_DIR/.." && pwd)/modules/4NK_template/.last_image"
+
+if [[ ! -d "$PROJECT_PATH" ]]; then
+  echo "Erreur: Le projet '$PROJECT_PATH' n'existe pas" >&2
+  exit 1
+fi
+
+mkdir -p "$PROJECT_PATH/$OUTPUT_DIR"
+
+echo "=== Lancement des agents 4NK_template sur: $PROJECT_PATH ==="
+
+if ! command -v docker >/dev/null 2>&1; then
+  echo "Docker requis pour exécuter les agents via conteneur." >&2
+  exit 2
+fi
+
+# Si une image du module existe, l'utiliser en priorité
+if [[ -f "$MODULE_LAST_IMAGE_FILE" ]]; then
+  IMAGE_NAME="$(cat "$MODULE_LAST_IMAGE_FILE" | tr -d '\r\n')"
+  echo "Utilisation de l'image du module: $IMAGE_NAME"
+  # Préparer montage du fichier d'env si présent
+  ENV_MOUNT=""
+  if [[ -f "$HOME/.4nk_template/.env" ]]; then
+    ENV_MOUNT="-v $HOME/.4nk_template/.env:/root/.4nk_template/.env:ro"
+  fi
+  # Lancer le conteneur en utilisant l'ENTRYPOINT qui configure safe.directory
+  docker run --rm \
+    -e RUNNER_MODE=agents \
+    -e TARGET_DIR=/work \
+    -e OUTPUT_DIR=/work/$OUTPUT_DIR \
+    -v "$(realpath "$PROJECT_PATH"):/work" \
+    $ENV_MOUNT \
+    "$IMAGE_NAME" || true
+else
+  echo "Aucune image de module détectée, fallback docker compose dans 4NK_template"
+  cd "$TEMPLATE_DIR"
+  docker compose -f docker-compose.ci.yml build
+  RUNNER_MODE="agents" TARGET_DIR="/work" OUTPUT_DIR="/work/$OUTPUT_DIR" \
+    docker compose -f docker-compose.ci.yml run --rm project-ci || true
+fi
+
+echo "=== Agents terminés → $PROJECT_PATH/$OUTPUT_DIR ==="

scripts/release/guard.sh

@@ -63,3 +63,5 @@ case "$mode" in
 esac
 
 echo "[release-guard] OK"
+
+