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
50 lines
1.5 KiB
Markdown
50 lines
1.5 KiB
Markdown
# 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_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
|