# RUNBOOK — Déploiement DauphinCraft en production

## Prérequis
- Accès réseau VM .86 (Gitea) et VM .89 (OpenClaw)
- Credentials : flagabat/SuperTeam2026! (ou floppyrj45)
- `sshpass` installé OU `plink`/`pscp` dans le PATH

## Ordre d'exécution

### Phase 1 — Push code Gitea (.86)
```bash
cd /c/Users/flopp/Nextcloud2/DauphinCraft
bash deploy/push_to_gitea.sh
```
Vérifier : `http://192.168.1.86:3000/flagabat/dauphincraft/releases/tag/v0.1.0`

---

### Phase 2 — Déploiement serveur dédié
```bash
bash deploy/deploy_server_ssh.sh
```
Vérifier sur la VM cible :
```bash
systemctl status dauphincraft
```
Test réseau :
```bash
nc -zvu <SERVER_IP> 7777
```

---

### Phase 3 — Landing page web
```bash
bash deploy/deploy_web_nginx.sh
```
Vérifier : `curl http://192.168.1.86/` répond 200.

---

### Phase 4 — Discord via OpenClaw
Suivre `deploy/openclaw_messages.md` dans l'ordre :
1. Message 1 — ping Silver Surfer
2. Message 4 — créer catégorie + channels Discord
3. Message 2 — VM si non existante
4. Message 3 — inbox deploy (après Phase 1 et 2)
5. Message 5 — webhook Gitea → #build-logs
6. Message 6 — description catégorie

---

### Phase 5 — Sphinx doc (optionnel)
Upload `docs/_build/html/*` vers nginx :
```bash
sshpass -p SuperTeam2026! scp -r docs/_build/html/* flagabat@192.168.1.86:/var/www/dauphincraft/docs/
```

---

## Variables d'environnement (override)
| Variable | Défaut | Usage |
|---|---|---|
| `GITEA_URL` | `http://192.168.1.86:3000` | URL Gitea |
| `GITEA_USER` | `flagabat` | User Gitea |
| `GITEA_PASS` | `SuperTeam2026!` | Password Gitea |
| `REPO_NAME` | `dauphincraft` | Nom repo |
| `SERVER_HOST` | `192.168.1.89` | IP serveur jeu |
| `SERVER_USER` | `flagabat` | User SSH serveur |
| `SERVER_PASS` | `SuperTeam2026!` | Password SSH |
| `WEB_HOST` | `192.168.1.86` | IP nginx |
| `WEB_ROOT` | `/var/www/dauphincraft` | Racine web |

Exemple override :
```bash
SERVER_HOST=192.168.1.95 bash deploy/deploy_server_ssh.sh
```

---

## Troubleshooting
| Symptôme | Solution |
|---|---|
| SSH timeout | Vérifier route IP et subnet |
| Gitea 401 | Vérifier password ou générer jeton API dans Gitea Settings |
| Port 7777 fermé | `ufw allow 7777/udp` ou `firewall-cmd --add-port=7777/udp` |
| systemd fail | `journalctl -u dauphincraft -n 50` |
| sshpass absent | `apt install sshpass` ou utiliser plink (PuTTY) |
| Release ID vide | Vérifier git tag `v0.1.0` existe sur master |