4NK_template/docs/ARCHITECTURE.md
Your Name 03fc255fdc
Some checks failed
CI - 4NK Node / Code Quality (push) Failing after 46s
CI - 4NK Node / Unit Tests (push) Failing after 29s
CI - 4NK Node / Integration Tests (push) Failing after 10s
CI - 4NK Node / Docker Build & Test (push) Failing after 8s
CI - 4NK Node / Documentation Tests (push) Failing after 4s
CI - 4NK Node / Security Tests (push) Failing after 27s
CI - 4NK Node / Release Guard (push) Has been skipped
CI - 4NK Node / Performance Tests (push) Failing after 27s
CI - 4NK Node / Notify (push) Failing after 1s
chore(template): update cursor rules, gitea templates, guards, ignores
2025-08-27 11:19:19 +02:00

1.5 KiB
Raw Blame History

Architecture Technique - 4NK Node

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_VERSIONCHANGELOG.md ↔ tag, choix latest vs wip
  • Fichier version: TEMPLATE_VERSION (ou VERSION) est la source de vérité; CHANGELOG.md doit contenir lentré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