313 lines
11 KiB
Markdown
313 lines
11 KiB
Markdown
# 📚 Index de Documentation - 4NK Node
|
|
|
|
Index complet de la documentation de l'infrastructure 4NK Node.
|
|
|
|
## 📖 Guides Principaux
|
|
|
|
### 🚀 [Guide d'Installation](INSTALLATION.md)
|
|
Guide complet pour installer et configurer l'infrastructure 4NK Node.
|
|
- **Prérequis système et logiciels**
|
|
- **Installation de Docker et dépendances**
|
|
- **Configuration SSH et GitLab**
|
|
- **Configuration initiale des services**
|
|
- **Tests post-installation**
|
|
- **Dépannage et monitoring**
|
|
|
|
### 📖 [Guide d'Utilisation](USAGE.md)
|
|
Guide complet pour utiliser l'infrastructure 4NK Node au quotidien.
|
|
- **Démarrage quotidien des services**
|
|
- **Opérations de surveillance et monitoring**
|
|
- **Utilisation du réseau de relais**
|
|
- **Connexion aux services (Bitcoin Core, Blindbit, sdk_relay)**
|
|
- **Tests et validation**
|
|
- **Configuration et maintenance**
|
|
- **Gestion des nœuds externes**
|
|
|
|
### ⚙️ [Guide de Configuration](CONFIGURATION.md)
|
|
Guide complet pour configurer l'infrastructure selon vos besoins.
|
|
- **Configuration générale et variables d'environnement**
|
|
- **Configuration Bitcoin Core (base et avancée)**
|
|
- **Configuration Blindbit (base et avancée)**
|
|
- **Configuration des relais (base et avancée)**
|
|
- **Configuration des nœuds externes**
|
|
- **Configuration Tor**
|
|
- **Configuration Docker Compose**
|
|
- **Configuration SSL/TLS**
|
|
- **Configuration de monitoring et sauvegarde**
|
|
|
|
## 🔧 Guides Techniques
|
|
|
|
### 🏗️ [Architecture Technique](ARCHITECTURE.md)
|
|
Documentation technique détaillée de l'architecture.
|
|
- **Architecture générale du système**
|
|
- **Composants principaux (Bitcoin Core, Blindbit, SDK Relay)**
|
|
- **Architecture de synchronisation mesh**
|
|
- **Flux de données entre services**
|
|
- **Configuration multi-relais**
|
|
- **Sécurité et isolation**
|
|
- **Performance et optimisations**
|
|
- **Monitoring et observabilité**
|
|
|
|
### 📡 [API Reference](API.md)
|
|
Documentation complète des APIs disponibles.
|
|
- **API Bitcoin Core RPC** : Interface JSON-RPC pour Bitcoin
|
|
- **API Blindbit HTTP** : API REST pour les paiements silencieux
|
|
- **API SDK Relay WebSocket** : Interface temps réel pour les clients
|
|
- **API SDK Relay HTTP** : API REST pour les opérations de gestion
|
|
- **Format des messages et payloads**
|
|
- **Gestion des erreurs**
|
|
- **Exemples d'utilisation**
|
|
- **Limites et quotas**
|
|
|
|
### 🔒 [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é**
|
|
- **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**
|
|
|
|
### 🌟 [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**
|
|
|
|
## 🧪 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**
|
|
|
|
### 🔄 [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**
|
|
|
|
### 📊 [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 Réseau
|
|
|
|
### 🌐 [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**
|
|
|
|
### 🌍 [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**
|
|
|
|
### 🔄 [Synchronisation](SYNCHRONIZATION.md)
|
|
Guide du protocole de synchronisation.
|
|
- **Protocole de synchronisation**
|
|
- **Types de messages**
|
|
- **Cache de déduplication**
|
|
- **Métriques de synchronisation**
|
|
- **Troubleshooting**
|
|
|
|
## 📋 Guides de Référence
|
|
|
|
### 📋 [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**
|
|
|
|
### 📋 [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/
|
|
├── README.md # Documentation principale
|
|
├── docs/ # Documentation organisée
|
|
│ ├── INDEX.md # Cet index
|
|
│ ├── INSTALLATION.md # Guide d'installation
|
|
│ ├── USAGE.md # Guide d'utilisation
|
|
│ ├── CONFIGURATION.md # Guide de configuration
|
|
│ ├── 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
|
|
│ ├── QUICK_REFERENCE.md # Commandes rapides
|
|
│ ├── TROUBLESHOOTING.md # Guide de dépannage
|
|
│ └── FAQ.md # Questions fréquentes
|
|
├── specs/ # Spécifications techniques
|
|
│ ├── spec-technique.md # Spécification technique
|
|
│ └── spec-fonctionnel.md # Spécification fonctionnelle
|
|
├── scripts/ # Scripts utilitaires
|
|
├── tests/ # Scripts de test
|
|
└── examples/ # Exemples d'utilisation
|
|
```
|
|
|
|
## 🎯 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** : $(date)
|
|
- **Version** : 1.0.0
|
|
- **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
|
|
|
|
---
|