Initial: desk + ncantu placeholder + per-project cursor configs

**Motivations:**
- Centraliser les fichiers Cursor (rules, skills, agents, commands, hooks) par user et par projet

**Root causes:**
- N/A

**Correctifs:**
- N/A

**Evolutions:**
- desk: rules, skills-cursor, agents, commands, hooks, argv/hooks/mcp.json
- ncantu: README placeholder
- 4NK_node, algo, builazoo, ia_local, lecoffre_ng, lecoffre_ng_pprod, lecoffre_ng_test: .cursor contents

**Pages affectées:**
- cursor/desk/, cursor/ncantu/, cursor/<project>/

4NK_node/rules/00-foundations.mdc

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

4NK_node/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`.

4NK_node/rules/10-project-structure.mdc

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

4NK_node/rules/20-documentation.mdc

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

4NK_node/rules/30-testing.mdc

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

4NK_node/rules/40-dependencies-and-build.mdc

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

4NK_node/rules/41-ssh-automation.mdc

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

4NK_node/rules/42-template-sync.mdc

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

4NK_node/rules/4nkrules.mdc

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

4NK_node/rules/50-data-csv-models.mdc

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

4NK_node/rules/60-office-docs.mdc

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

4NK_node/rules/70-frontend-architecture.mdc

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

4NK_node/rules/80-versioning-and-release.mdc

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

4NK_node/rules/85-release-guard.mdc

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

4NK_node/rules/90-gitea-and-oss.mdc

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

4NK_node/rules/95-triage-and-problem-solving.mdc

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

4NK_node/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

4NK_node/rules/99-lint-markdow.mdc

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

4NK_node/rules/ruleset-index.md

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