Architecture Globale

Schéma général

┌─────────────────────────────────────────────────────────────┐
│                       VPS Levell                            │
│                                                             │
│  ┌──────────────────────────────────────────────────────┐   │
│  │              Docker (réseau traefik-public)          │   │
│  │                                                      │   │
│  │  ┌─────────┐  ┌──────┐  ┌─────────┐  ┌──────────┐  │   │
│  │  │ Traefik │  │ n8n  │  │  n8n-   │  │  Beszel  │  │   │
│  │  │ 80/443  │  │      │  │   mcp   │  │  hub+    │  │   │
│  │  └────┬────┘  └──────┘  └─────────┘  │  agent   │  │   │
│  │       │                              └──────────┘  │   │
│  │       ├── kam (Next.js)                            │   │
│  │       ├── kamctrl (Laravel/nginx)                  │   │
│  │       ├── diary (nginx statique)                   │   │
│  │       ├── suivi (nginx statique)                   │   │
│  │       └── docs (nginx statique)                    │   │
│  └──────────────────────────────────────────────────────┘   │
│                                                             │
│  ┌──────────────────────────────────────────────────────┐   │
│  │           Services hôte (hors Docker)                │   │
│  │  rclone-agent (systemd)                              │   │
│  └──────────────────────────────────────────────────────┘   │
└─────────────────────────────────────────────────────────────┘

Composants principaux

Composant	Rôle	Technologie
Traefik	Reverse proxy — distribue le trafic vers chaque container, gère SSL	Traefik
n8n	Plateforme d’automatisation — exécute les workflows Google Drive	n8n
n8n-mcp	Serveur MCP — permet à Claude Code de piloter n8n	n8n-mcp
rclone-agent	Service HTTP Python — exécute rclone sur ordre de n8n	Python / systemd
Beszel	Monitoring — surveille CPU, RAM, disque, réseau	Beszel
kam	Site Keur Adja Maye	Next.js standalone
kamctrl	Interface admin réservations	Laravel / PHP
diary	Journal de bord Levell	HTML/CSS statique
suivi	Dashboard monitoring transferts Google Drive	HTML/JS statique
docs	Cette documentation	Astro Starlight

Flux de communication

Requêtes web (utilisateurs)

Navigateur → Traefik (HTTPS) → Container approprié

Traefik lit les labels Docker pour savoir quel domaine envoyer vers quel container.

Automatisation Google Drive

n8n (schedule 5 min)
  → Google Sheets API (lire les tâches)
  → rclone-agent /transfer (lancer une copie)
    → rclone (copier fichier/dossier entre deux Google Drive)
  → Google Sheets API (mettre à jour le statut)

Claude Code ↔ n8n

Claude Code (terminal)
  → n8n-mcp (MCP server HTTPS)
    → n8n API interne

Réseau Docker

Tous les containers exposés au web sont sur le réseau traefik-public (réseau bridge externe). Traefik est le seul à avoir les ports 80 et 443 ouverts sur le VPS.

# Voir les containers sur le réseau traefik-public
docker network inspect traefik-public

Volumes persistants

Volume	Contenu	Container
`n8n-rkaf_n8n_data`	BDD n8n, credentials, workflows	n8n
`traefik-lr9j_traefik-letsencrypt`	Certificats SSL Let’s Encrypt	traefik
`kamctrl_db`	BDD de kamctrl	kamctrl
`kamctrl_storage`	Fichiers uploadés (kamctrl)	kamctrl