docs/DEPLOY_QUICK.md

# 🚀 Quick Deploy to Hugging Face Spaces

**Temps estimé: 5 minutes** ⚡

---

## Méthode 1: Script Automatique (Recommandé)

```bash
cd /home/luigi/rts/web
./tools/deploy_hf_spaces.sh
```

Le script va :
1. ✅ Vérifier tous les fichiers requis
2. ✅ Tester le build Docker (optionnel)
3. ✅ Configurer Git avec le remote HF
4. ✅ Push vers Hugging Face Spaces
5. ✅ Vous donner l'URL du jeu déployé

---

## Méthode 2: Manuel (3 commandes)

### 1. Créer un Space sur Hugging Face

Aller sur https://huggingface.co/new-space

- **Space name**: `rts-commander`
- **SDK**: **Docker** ⚠️ Important !
- **Hardware**: CPU basic (gratuit)
- Cliquer **Create Space**

### 2. Configurer Git et Push

```bash
cd /home/luigi/rts/web

# Ajouter le remote (remplacer USERNAME)
git remote add space https://huggingface.co/spaces/USERNAME/rts-commander

# Push
git add .
git commit -m "Deploy RTS Commander v2.0"
git push space main
```

### 3. Attendre le Build

Aller sur votre Space : `https://huggingface.co/spaces/USERNAME/rts-commander`

Le build Docker prend **2-5 minutes** ⏱️

---

## Méthode 3: Via Interface Web

1. Créer un Space (SDK=Docker)
2. Cliquer **"Files"** → **"Add file"** → **"Upload files"**
3. Glisser-déposer TOUS les fichiers de `web/`
4. Cliquer **"Commit changes to main"**
5. Attendre le build automatique

---

## ⚙️ Configuration Requise

Le projet est **déjà configuré** ! ✅

**Fichiers essentiels présents** :
- ✅ `Dockerfile` (port 7860)
- ✅ `README.md` (avec `sdk: docker`)
- ✅ `requirements.txt`
- ✅ `app.py` (FastAPI + WebSocket)
- ✅ `static/` (assets)
- ✅ `backend/` (game logic)

**Aucune modification nécessaire !**

---

## 🔐 Authentification

Si le push demande une authentification :

```bash
# Installer huggingface_hub
pip install huggingface_hub

# Login (va ouvrir le navigateur)
huggingface-cli login

# Ou avec un token
huggingface-cli login --token YOUR_TOKEN
```

**Token** : https://huggingface.co/settings/tokens

---

## 🎮 Résultat Attendu

Après le build réussi :

**URL** : `https://USERNAME-rts-commander.hf.space`

**Features actives** :
- ✅ Jeu RTS complet
- ✅ WebSocket temps réel
- ✅ Sons (fire, explosion, build, ready)
- ✅ Control groups 1-9
- ✅ Multi-langue (EN/FR/繁中)
- ✅ Superweapon nuke (touche N)
- ✅ Responsive UI
- ✅ 60 FPS gameplay

---

## 📊 Monitoring

### Voir les logs

```bash
huggingface-cli space logs USERNAME/rts-commander --follow
```

### Redéployer après modifications

```bash
cd /home/luigi/rts/web
git add .
git commit -m "Update: description des changements"
git push space main
```

HF va automatiquement rebuild !

---

## 🐛 Problèmes Courants

### Build Failed

```bash
# Tester localement d'abord
cd /home/luigi/rts/web
docker build -t rts-test .
docker run -p 7860:7860 rts-test
```

### WebSocket ne connecte pas

Vérifier dans `game.js` que l'URL est dynamique :
```javascript
const wsUrl = `${window.location.protocol === 'https:' ? 'wss:' : 'ws:'}//${window.location.host}/ws`;
```

### 404 sur les assets

Vérifier que `static/` est bien copié dans le Dockerfile (déjà ok).

---

## 📚 Documentation Complète

Voir : `web/docs/DEPLOYMENT_HF_SPACES.md`

---

## ✅ Checklist Rapide

Avant de déployer :
- [ ] Compte HF créé
- [ ] `Dockerfile` présent (port 7860)
- [ ] `README.md` avec `sdk: docker`
- [ ] Test local réussi (optionnel)
- [ ] Space créé sur HF avec SDK=Docker

**Ready to deploy!** 🚀