Add complete French (fr) and Chinese (zh) translations for all documentation: - Root files: README, CHANGELOG, SECURITY, BETA-RELEASE - docs/: All 16 core documentation files - DOCS/: All 19 deep-dive documents including embedded/ and archive/ - package/secubox/: All 123+ package READMEs - Misc: secubox-tools/, scripts/, EXAMPLES/, config-backups/, streamlit-apps/ Total: 346 translation files created Each file includes language switcher links for easy navigation between English, French, and Chinese versions. Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
5.5 KiB
Documentation SecuBox
🌐 Langues : English | Français | 中文
Version : 1.0.0 Dernière mise à jour : 2025-12-28 Projet : Suite de Sécurité et Gestion LuCI pour OpenWrt
Bienvenue dans la documentation SecuBox ! Ce guide complet couvre tous les aspects du développement, déploiement et maintenance des modules SecuBox.
🏗️ Qu'est-ce que SecuBox ?
SecuBox est une suite complète de sécurité et de gestion réseau pour OpenWrt composée de 15 modules d'application LuCI qui fournissent :
- Surveillance de Sécurité - Prévention d'intrusion CrowdSec, métriques Netdata
- Intelligence Réseau - Inspection profonde des paquets, classification du trafic
- Contrôle d'Accès - Portail captif, authentification, gestion VPN
- Optimisation des Performances - QoS, gestion de bande passante, cache
- Administration Système - Tableau de bord centralisé, gestion des services
🚀 Navigation Rapide
Démarrage Rapide
Nouveau sur SecuBox ? Commencez ici !
Guide de Développement
Référence complète de développement avec diagrammes d'architecture
Modèles de Code
Exemples fonctionnels et patterns d'implémentation
Validation
Workflows de validation et test des modules
📦 Suite de 15 Modules
Contrôle Central (2 modules)
- Hub Central SecuBox - Tableau de bord principal et gestion des modules
- Hub Système - Administration système (santé, services, logs, sauvegarde, etc.)
Sécurité & Surveillance (2 modules)
- Tableau de Bord CrowdSec - Prévention d'intrusion et renseignement sur les menaces
- Tableau de Bord Netdata - Surveillance système en temps réel
Intelligence Réseau (2 modules)
- Tableau de Bord Netifyd - Inspection et classification profonde des paquets
- Modes Réseau - Gestion des profils réseau
VPN & Contrôle d'Accès (3 modules)
- Tableau de Bord WireGuard - Gestion des tunnels VPN
- Gardien Client - Contrôle d'accès réseau et portail captif
- Gardien Auth - Système d'authentification
Bande Passante & Trafic (2 modules)
- Gestionnaire de Bande Passante - QoS et quotas de bande passante
- Mise en Forme du Trafic - Mise en forme avancée du trafic
Performance & Services (2 modules)
- Cache CDN - Cache proxy de réseau de diffusion de contenu
- Gestionnaire VHost - Configuration des hôtes virtuels
Optimisation Système (2 modules)
- Flux Média - Optimisation du trafic média
- Gestionnaire KSM - Fusion de pages mémoire identiques du noyau
🎨 Système de Design
SecuBox utilise un système de design moderne et cohérent :
- Palette de Couleurs : Dégradés Indigo/Violet avec support mode sombre
- Typographie : Inter (texte) + JetBrains Mono (code/valeurs)
- Composants : Cartes, badges, boutons avec effets de dégradé
- Mise en Page : Système de grille responsive
Voir la section Système de Design pour les spécifications complètes.
🔧 Workflow de Développement
!!! warning "Règles Critiques"
1. Nommage RPCD : Le nom du script doit correspondre à l'objet ubus (luci.module-name)
2. Chemins Menu : Doivent correspondre exactement aux emplacements des fichiers de vue
3. Permissions : 755 pour les scripts RPCD, 644 pour CSS/JS
4. Validation : Toujours exécuter ./secubox-tools/validate-modules.sh avant commit
Outils de Développement
# Valider tous les modules (7 vérifications automatisées)
./secubox-tools/validate-modules.sh
# Corriger automatiquement les permissions de fichiers
./secubox-tools/fix-permissions.sh --local
# Compiler les paquets localement
./secubox-tools/local-build.sh build luci-app-module-name
Workflow de Développement Complet →
🌐 Démo en Direct
Découvrez SecuBox en action :
Démo Production : https://secubox.cybermood.eu
- Tableau de bord principal :
/ - Hub Système :
/system-hub - CrowdSec :
/crowdsec - Les 15 modules accessibles
📚 Sections de Documentation
Pour les Nouveaux Contributeurs
- Guide de Démarrage Rapide - Règles et commandes essentielles
- Directives de Développement - Référence complète
- CLAUDE.md - Système de build et architecture
- Directives du Dépôt - Structure, workflows et attentes PR
Pour le Développement Assisté par IA
- Guide d'Implémentation de Module - Workflow étape par étape
- Prompts de Régénération de Fonctionnalités - Prompts IA pour tous les modules
- Modèles de Code - Patterns d'implémentation
📞 Support & Ressources
- Dépôt GitHub : gkerma/secubox-openwrt
- Problèmes Documentation : GitHub Issues
- Support Technique : support@cybermind.fr
- Entreprise : CyberMind.fr
📝 Licence
Apache-2.0
Dernière mise à jour : 2025-12-28 | Mainteneur : CyberMind.fr