secubox-openwrt/docs-fr/index.md
CyberMind-FR ccfb58124c docs: Add trilingual documentation (French and Chinese translations)
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>
2026-03-20 10:00:18 +01:00

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émarrage Rapide

Guide de Développement

Référence complète de développement avec diagrammes d'architecture

Directives de Développement

Modèles de Code

Exemples fonctionnels et patterns d'implémentation

Modèles de Code

Validation

Workflows de validation et test des modules

Guide de Validation


📦 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

Voir le Statut des Modules →


🎨 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

  1. Guide de Démarrage Rapide - Règles et commandes essentielles
  2. Directives de Développement - Référence complète
  3. CLAUDE.md - Système de build et architecture
  4. Directives du Dépôt - Structure, workflows et attentes PR

Pour le Développement Assisté par IA

  1. Guide d'Implémentation de Module - Workflow étape par étape
  2. Prompts de Régénération de Fonctionnalités - Prompts IA pour tous les modules
  3. Modèles de Code - Patterns d'implémentation

📞 Support & Ressources


📝 Licence

Apache-2.0


Dernière mise à jour : 2025-12-28 | Mainteneur : CyberMind.fr