Ajout documentation complète d'hébergement

Documentation du plan d'hébergement sur Scaleway Start-2-S-SATA : - Choix du serveur dédié (4.99€/mois, 4GB RAM, 1TB HDD) - Architecture multi-projets (ConfluentTranslator + autres apps) - Setup Gitea pour Git privé avec LFS (fini les .gitignore massifs) - Stack Docker complète (PostgreSQL, Redis, Nginx) - Plan de migration en 5 phases - Estimation performance et coûts réels 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
2025-12-03 11:20:35 +08:00 · 2025-12-03 11:20:35 +08:00 · 3a2d35c48f
commit 3a2d35c48f
parent 4b0f916d1c
1 changed files with 340 additions and 0 deletions
--- a/HEBERGEMENT.md
+++ b/HEBERGEMENT.md
@ -0,0 +1,340 @@
+# Hébergement ConfluentTranslator - Plan d'action
+
+## Décision : Scaleway Start-2-S-SATA
+
+**Offre choisie** : Serveur dédié Scaleway Start-2-S-SATA
+**Prix** : 4.99€/mois
+**Provider** : Scaleway (français, datacenter EU)
+
+### Spécifications
+- **CPU** : Intel C2350 (Avoton) - 2 cores / 2 threads @ 1.7 GHz
+- **RAM** : 4 GB DDR3 (dédiée, non partagée)
+- **Stockage** : 1 TB HDD SATA
+- **Réseau** : Up to 250 Mbps
+- **Type** : Bare-metal (hardware physique dédié)
+
+### Pourquoi ce choix ?
+
+#### Avantages
+✅ **Hardware dédié** : Pas d'overselling, performance stable et prévisible
+✅ **Multi-projets** : Peut héberger TOUS les projets du dossier parent
+✅ **Stockage massif** : 1 TB pour données volumineuses, backups, Git LFS
+✅ **RAM suffisante** : 4 GB pour faire tourner 5-7 services simultanés
+✅ **Prix raisonnable** : 4.99€/mois pour un dédié, c'est excellent
+✅ **Centralisation** : Tout au même endroit vs 3-4 VPS séparés à gérer
+✅ **Gitea possible** : Enfin un Git privé avec les données volumineuses !
+
+#### vs Alternatives considérées
+
+| Option | Prix | RAM | Disque | Verdict |
+|--------|------|-----|--------|---------|
+| Railway.app | 5$/mois | Variable | Éphémère | ❌ Pas de persistance facile |
+| Render.com | 7$/mois | Variable | Éphémère | ❌ Plus cher, pas adapté |
+| VPS Hizakura | 0.83€/mois | 1GB | 15GB | ✅ OK pour 1 projet seul |
+| VPS Netcup | 1€/mois | 512MB | 10GB | ✅ OK pour 1 projet seul |
+| VPS RackNerd | 0.80$/mois | 768MB | 15GB | ✅ OK pour 1 projet seul |
+| Hetzner VPS | 2.49€/mois | 2GB | 20GB | ✅ Bon mais limité multi-projets |
+| **Scaleway Dédié** | **4.99€/mois** | **4GB** | **1TB** | **✅ Meilleur pour multi-projets** |
+
+## Architecture prévue
+
+### Projets à héberger
+
+```
+/opt/
+├── gitea/                      # Git server privé (port 3000)
+│   └── data/
+│       ├── repositories/       # Repos Git
+│       └── lfs/               # Git LFS (gros fichiers)
+│
+├── data/                       # Données volumineuses (non-Git)
+│   ├── confluent/             # Lexiques, données linguistiques
+│   ├── chinese-class/         # Assets, datasets
+│   ├── seo-generator/         # Templates, caches
+│   ├── civjdr/                # Assets de jeu
+│   └── backups/               # Backups automatiques
+│
+├── apps/                       # Applications déployées
+│   ├── confluent-translator/  # Port 3001
+│   ├── chinese-class/         # Port 3002
+│   ├── seo-generator/         # Port 3003
+│   └── civjdr/                # Port 3004
+│
+├── databases/
+│   ├── postgres/              # PostgreSQL centralisée
+│   └── redis/                 # Cache & sessions
+│
+├── nginx/                      # Reverse proxy
+│   ├── nginx.conf
+│   └── ssl/                   # Certificats Let's Encrypt
+│
+└── docker-compose.yml         # Orchestration complète
+```
+
+### Services Docker prévus
+
+| Service | Port | RAM allouée | Rôle |
+|---------|------|-------------|------|
+| **Gitea** | 3000 | 512 MB | Git privé + LFS |
+| **PostgreSQL** | 5432 | 512 MB | Base de données centralisée |
+| **Redis** | 6379 | 128 MB | Cache & sessions |
+| **ConfluentTranslator** | 3001 | 512 MB | API de traduction |
+| **ChineseClass** | 3002 | 256 MB | App apprentissage chinois |
+| **SEOGenerator** | 3003 | 256 MB | Serveur génération SEO |
+| **CivJDR** | 3004 | 256 MB | Backend jeu de rôle |
+| **Nginx** | 80/443 | 128 MB | Reverse proxy + SSL |
+| **Portainer** | 9000 | 128 MB | Interface Docker (optionnel) |
+| **Système** | - | ~500 MB | Ubuntu/Debian base |
+| **TOTAL** | - | **~3.2 GB** | Reste 800 MB de marge |
+
+### Domaines/Sous-domaines (via Nginx)
+
+```
+git.votredomaine.fr       → Gitea (port 3000)
+confluent.votredomaine.fr → ConfluentTranslator (port 3001)
+chinese.votredomaine.fr   → ChineseClass (port 3002)
+seo.votredomaine.fr       → SEOGenerator (port 3003)
+civjdr.votredomaine.fr    → CivJDR (port 3004)
+portainer.votredomaine.fr → Portainer (port 9000)
+```
+
+## Avantages stratégiques
+
+### 1. Fini les .gitignore de l'enfer
+
+**Avant** (GitHub/Bitbucket avec limites) :
+```gitignore
+# .gitignore horrible actuel
+node_modules/
+data/
+*.json              # Lexiques trop volumineux
+lexiques/
+datasets/
+models/
+uploads/
+*.db
+backups/
+logs/
+assets/
+```
+
+**Après** (Gitea + stockage 1TB) :
+```gitignore
+# .gitignore minimaliste
+node_modules/
+.env
+```
+
+Tout le reste → **dans Git avec LFS** ou **dans /opt/data/** monté en volume
+
+### 2. Git LFS pour gros fichiers
+
+- Lexiques JSON volumineux : ✅ Dans Git avec LFS
+- Datasets ML/training : ✅ Dans Git avec LFS
+- Assets (images, vidéos) : ✅ Dans Git avec LFS ou /opt/data/
+- Backups de DB : ✅ Dans /opt/data/backups/
+
+### 3. Backups automatiques
+
+Avec 1 TB, possibilité de :
+- Backup quotidien de toutes les DBs
+- Backup hebdomadaire complet (repos + data)
+- Rotation sur 30 jours d'historique
+- Export vers stockage externe (Scaleway Object Storage, S3, etc.)
+
+### 4. Centralisation & simplicité
+
+Au lieu de gérer :
+- ❌ 1 compte Railway pour ConfluentTranslator
+- ❌ 1 VPS pour ChineseClass
+- ❌ 1 autre VPS pour SEOGenerator
+- ❌ GitHub pour le code (avec limites)
+- ❌ Dropbox/Drive pour les données
+
+Vous avez :
+- ✅ 1 serveur Scaleway pour TOUT
+- ✅ 1 Gitea pour tous les repos + données
+- ✅ 1 point d'administration (Portainer)
+- ✅ 1 facture de 4.99€/mois
+
+## Stack technique
+
+### OS & Base
+- **Ubuntu 22.04 LTS** ou **Debian 12**
+- **Docker** + **Docker Compose** (orchestration)
+- **Nginx** (reverse proxy + SSL)
+- **Let's Encrypt** (certificats HTTPS gratuits)
+
+### Services infrastructure
+- **Gitea** (Git server privé, alternative légère à GitLab)
+- **PostgreSQL 15** (DB centralisée pour toutes les apps)
+- **Redis 7** (cache, sessions, queues)
+- **Portainer** (interface web pour gérer Docker)
+
+### Monitoring (optionnel futur)
+- **Prometheus** + **Grafana** (métriques & dashboards)
+- **Loki** (logs centralisés)
+- **Uptime Kuma** (monitoring uptime)
+
+## Estimation de performance
+
+### ConfluentTranslator
+- **RAM utilisée** : ~100-200 MB au repos
+- **CPU** : Quasi 0% sauf pendant appels LLM (quelques secondes)
+- **Disque** : ~500 MB (code + node_modules + lexiques)
+- **Verdict** : ✅ Largement suffisant
+
+### Tous les projets combinés
+- **RAM totale** : ~2.5-3 GB utilisée / 4 GB disponibles
+- **CPU** : ~10-20% moyen (pics à 50-70% lors de requêtes)
+- **Disque** : ~50-100 GB utilisés / 1 TB disponibles
+- **Verdict** : ✅ Très confortable
+
+### Scalabilité
+- Peut gérer **100-500 requêtes/jour** par service sans problème
+- Peut monter à **1000-2000 req/jour** avec optimisation
+- Au-delà : besoin d'upgrade vers serveur plus puissant
+
+## Coûts réels
+
+### Scaleway
+- **Serveur** : 4.99€/mois
+- **Domaine** (optionnel) : ~10-15€/an (ex: .fr, .com)
+- **Backup externe** (optionnel) : ~1-2€/mois (Scaleway Object Storage 100GB)
+- **Total** : ~5-7€/mois
+
+### APIs externes (facturées séparément)
+- **Anthropic Claude** : Selon usage (~0.015$/1K tokens)
+- **OpenAI GPT** : Selon usage (~0.03$/1K tokens)
+
+Pour 100 traductions/jour de textes moyens (~500 tokens) :
+- Coût LLM : ~10-20$/mois
+- **Total global** : ~25-30€/mois (serveur + LLM)
+
+## Points d'attention
+
+### ⚠️ Limitations du hardware
+
+#### CPU ancien (Intel Avoton 2013)
+- ❌ Pas adapté pour : Compilation lourde, calcul intensif, ML training
+- ✅ Parfait pour : Services web, APIs, Node.js, Python, DBs légères
+
+#### HDD vs SSD
+- ❌ I/O plus lent qu'un SSD NVMe moderne
+- ✅ Suffisant pour : Serveurs web, stockage data, Git repos
+- ⚠️ Pour DB intensives : Utiliser Redis pour caching
+
+#### Bande passante 250 Mbps
+- ✅ Largement suffisant pour usage perso/PME
+- ⚠️ Limité pour : Streaming vidéo HD, téléchargements massifs
+
+### 🔒 Sécurité à prévoir
+
+- **Firewall** : UFW configuré (fermer tout sauf 80, 443, 22, 3000)
+- **SSH** : Désactiver password auth, utiliser clés SSH seulement
+- **Fail2ban** : Bloquer brute-force SSH/HTTP
+- **HTTPS** : Obligatoire sur tous les services (Let's Encrypt)
+- **Secrets** : Variables d'environnement, pas de hardcode
+- **Backups** : Automatisés et testés régulièrement
+
+### 📊 Monitoring recommandé
+
+- **Disk usage** : Surveiller le remplissage du 1TB
+- **RAM** : Alertes si > 90% utilisée
+- **CPU** : Identifier les process gourmands
+- **Uptime** : Monitoring externe (UptimeRobot gratuit)
+
+## Plan de migration
+
+### Phase 1 : Setup serveur (Jour 1)
+1. Commander Scaleway Start-2-S-SATA
+2. Installer Ubuntu 22.04 LTS
+3. Setup Docker + Docker Compose
+4. Configurer firewall (UFW)
+5. Setup SSH avec clés (désactiver password)
+
+### Phase 2 : Infrastructure (Jour 1-2)
+1. Déployer PostgreSQL + Redis
+2. Déployer Nginx avec config basique
+3. Déployer Gitea
+4. Configurer domaine(s) + DNS
+5. Setup Let's Encrypt (certbot)
+
+### Phase 3 : Migration ConfluentTranslator (Jour 2-3)
+1. Créer Dockerfile pour ConfluentTranslator
+2. Pusher sur Gitea
+3. Déployer via docker-compose
+4. Migrer data/lexique.json vers /opt/data/
+5. Tester traductions
+6. Configurer nginx reverse proxy
+
+### Phase 4 : Autres projets (Jour 3-7)
+1. Migrer ChineseClass
+2. Migrer SEOGenerator
+3. Migrer CivJDR
+4. Tester chaque service
+
+### Phase 5 : Finalisation (Jour 7+)
+1. Setup backups automatiques
+2. Déployer Portainer
+3. Documentation serveur
+4. Monitoring basique
+5. Tests de charge
+
+## Ressources & Liens
+
+### Scaleway
+- **Console** : https://console.scaleway.com/
+- **Docs Start** : https://www.scaleway.com/en/dedibox/start/
+
+### Gitea
+- **Docs** : https://docs.gitea.io/
+- **Git LFS Guide** : https://docs.gitea.io/en-us/git-lfs-support/
+
+### Docker
+- **Docker Compose Docs** : https://docs.docker.com/compose/
+- **Best practices** : https://docs.docker.com/develop/dev-best-practices/
+
+### Nginx
+- **Reverse proxy guide** : https://docs.nginx.com/nginx/admin-guide/web-server/reverse-proxy/
+- **Let's Encrypt** : https://certbot.eff.org/
+
+### Communauté VPS
+- **LowEndBox** : https://lowendbox.com/ (deals VPS)
+- **LowEndTalk** : https://lowendtalk.com/ (forum communautaire)
+
+## Alternatives futures
+
+Si le serveur devient insuffisant :
+
+### Upgrade Scaleway
+- **Start-2-L-SSD** : 8.99€/mois (4GB RAM, 2x250GB SSD RAID)
+- **Pro-1-S-SSD** : 13.99€/mois (8GB RAM, 2x2TB HDD RAID)
+
+### Migration vers cloud
+- **Hetzner Dedicated** : 39€/mois (Ryzen 5, 64GB RAM, 2x NVMe)
+- **Contabo Dedicated** : 50€/mois (specs similaires)
+
+### Scaling horizontal
+- Séparer Gitea sur serveur dédié
+- Apps sur Kubernetes (k3s sur Hetzner)
+- DB managée (Scaleway Managed PostgreSQL)
+
+## Conclusion
+
+Le **Scaleway Start-2-S-SATA à 4.99€/mois** est le choix optimal pour :
+
+✅ **Centraliser** tous vos projets perso
+✅ **Héberger** un Git privé avec données volumineuses
+✅ **Éliminer** les .gitignore cauchemars
+✅ **Performance** stable et prévisible (hardware dédié)
+✅ **Évolutivité** : Place pour 5-7 projets simultanés
+✅ **Prix** : Excellent rapport qualité/prix (vs 3-4 VPS séparés)
+
+**Prochaine étape** : Commander le serveur et commencer la Phase 1 du plan de migration.
+
+---
+
+**Document créé le** : 2025-12-03
+**Auteur** : Claude Code
+**Statut** : Plan validé, prêt pour mise en œuvre