4NK_template/docs/ARCHITECTURE.md

Architecture Technique - <PROJECT_NAME>

Vue d'Ensemble de l'Architecture

Ce document sert de modèle générique. Il doit être adapté par chaque projet dérivé de ce template.

Architecture Générale

Composants majeurs et couplages:

• Bitcoin Core, Blindbit, Relais SDK, UI/clients
• Réseau privé Docker, ZMQ, WebSocket
• CI/CD Gitea Actions

Composants Principaux

Listez ici les composants avec responsabilités, entrées/sorties et SLA.

1. Environnements

2. Orchestration

3. CI/CD

• Gitea Actions avec jobs: qualité, tests, intégration, sécurité, docker-build, documentation, release-guard
• Release Guard impose: tests, documentation, compilation, alignement VERSION/TEMPLATE_VERSION ↔ CHANGELOG.md ↔ tag, choix latest vs wip
• Fichier version: TEMPLATE_VERSION (ou VERSION) est la source de vérité; CHANGELOG.md doit contenir l’entrée correspondante

Troubleshooting

1. Problèmes de Synchronisation

• Connexions perdues : Vérifier la connectivité réseau
• Messages dupliqués : Vérifier le cache de déduplication
• Latence élevée : Vérifier les ressources système

2. Problèmes de Performance

• Utilisation mémoire : Vérifier les fuites mémoire
• CPU élevé : Vérifier les boucles infinies
• Disque plein : Nettoyer les logs et données

3. Problèmes de Configuration

• Ports bloqués : Vérifier le pare-feu
• Volumes manquants : Vérifier les permissions
• Variables d'environnement : Vérifier la configuration

Évolution Future