Glossaire

Termes d’infrastructure

Container Docker : Unité isolée qui fait tourner une application avec toutes ses dépendances. Comme une “boîte” indépendante. Sur le VPS, chaque service (n8n, kamctrl, kam, etc.) est dans son propre container.

Image Docker : Le “moule” à partir duquel on crée un container. Une image contient le code, les dépendances et la configuration.

Volume Docker : Espace de stockage persistant pour un container. Quand le container s’arrête, les données dans le volume sont conservées. Exemple : la BDD SQLite de kamctrl est dans un volume.

Réseau Docker : Canal de communication entre containers. Le réseau traefik-public permet à Traefik de router le trafic vers les autres containers.

Reverse Proxy : Service intermédiaire (Traefik chez nous) qui reçoit toutes les requêtes et les redirige vers le bon service selon le nom de domaine.

SSL/TLS : Protocole de chiffrement qui permet les connexions HTTPS. Let’s Encrypt fournit les certificats gratuitement, Traefik les génère et les renouvelle automatiquement.

Systemd : Gestionnaire de services Linux. Utilisé pour rclone-agent : garantit son démarrage au boot et sa relance automatique.

Termes d’automatisation

n8n : Plateforme d’automatisation open-source (comme Zapier mais hébergé chez soi). Les “workflows” définissent des enchaînements d’actions automatiques.

Workflow n8n : Séquence d’actions automatisées définie visuellement dans n8n. Exemple : WF-B lit le Google Sheets, appelle rclone-agent, met à jour le Sheets.

Nœud n8n : Chaque étape d’un workflow. Un nœud peut être : un trigger (déclencheur), une action (appel API, lecture Sheets), ou une transformation de données.

Webhook : URL qui déclenche une action quand elle est appelée. Le webhook Stats API retourne les statistiques de migration quand on fait un GET dessus.

MCP (Model Context Protocol) : Protocole qui permet à Claude Code d’utiliser des outils externes. Le serveur n8n-mcp permet à Claude de piloter n8n directement.

Trigger : Déclencheur d’un workflow. WF-B est déclenché par un trigger “toutes les 5 minutes”.

Termes applicatifs

Next.js : Framework React pour créer des applications web modernes avec rendu côté serveur (SSR) ou statique (SSG). Utilisé pour le site kam.

Laravel : Framework PHP pour créer des applications web. Utilisé pour kamctrl.

SQLite : Base de données légère stockée dans un seul fichier .sqlite. Utilisée par kamctrl (pas besoin d’un serveur de BDD séparé).

App Router (Next.js) : Système de routage moderne de Next.js (depuis la version 13) basé sur la structure des dossiers.

SSR (Server-Side Rendering) : Le HTML est généré côté serveur à chaque requête, pas dans le navigateur.

Standalone (Next.js) : Mode de build Next.js qui produit un dossier autonome pouvant tourner avec juste node server.js, sans les node_modules.

Termes Git/GitHub

Commit : Snapshot du code à un instant T. Chaque commit a un message qui décrit le changement.

Push : Envoyer les commits locaux vers le repo GitHub.

Post-commit hook : Script qui s’exécute automatiquement après chaque git commit. Chez Levell, il déclenche automatiquement un git push.

PAT (Personal Access Token) : Jeton d’accès GitHub qui remplace le mot de passe pour les opérations API et Git.

Termes Google Drive

Shared Drive (Drive partagé) : Espace de stockage Google Drive appartenant à une organisation (pas à un individu). Les fichiers restent même si le créateur part.

rclone : Outil en ligne de commande pour copier/synchroniser des fichiers entre services cloud (Google Drive, S3, etc.).

Compte A / Compte B : Convention interne — Compte A = source de la migration (ancien workspace), Compte B = destination (nouveau workspace).