diff --git a/docs/DEPLOY-VPS.md b/docs/DEPLOY-VPS.md index 37d711d9..d9158a99 100644 --- a/docs/DEPLOY-VPS.md +++ b/docs/DEPLOY-VPS.md @@ -4,6 +4,8 @@ Ce guide décrit comment lancer Prediqo sur un serveur Linux (VPS) **sans pertur **Démarrage sur base vierge (VPS + local) :** voir la [section 4](#4-démarrage-sur-base-de-données-vierge-vps-et-local). +**Remise à zéro (supprimer / recréer la base) avant tests dépôt/retrait :** voir [section 4.1](#41-remise-à-zéro--supprimer-et-recréer-la-base-avant-tests-réels). + --- ## 1. Prérequis sur le VPS @@ -57,18 +59,24 @@ nano .env # ou vim | Variable | Description | |----------|-------------| -| `POSTGRES_USER` / `POSTGRES_PASSWORD` / `POSTGRES_DB` | Compte PostgreSQL sur l’hôte | +| `POSTGRES_USER` / `POSTGRES_PASSWORD` / `POSTGRES_DB` | Compte PostgreSQL sur l’hôte (défaut DB : `games_platform_db`) | +| `DATABASE_URL` / `DATABASE_PASSWORD` | Connexion Docker via `host.docker.internal` (mot de passe encodé si caractères spéciaux) | | `JWT_SECRET` | Secret JWT (32+ caractères aléatoires) | -| `ENCRYPTION_KEY` | 64 caractères hex (32 octets AES-256) | +| `ENCRYPTION_KEY` | 64 caractères hex (32 octets AES-256) — **générer une fois**, backup hors git | | `PLATFORM_MNEMONIC` | Phrase BIP39 24 mots (générer une fois, garder secrète) | | `INITIAL_SETUP_TOKEN` | Jeton pour créer le 1er admin (`/setup`) | -| `BREAK_GLASS_TOKEN` | Jeton d’urgence pour reset 2FA Super Admin (CLI Docker uniquement, min 32 car.) | -| `APP_PUBLIC_URL` | `https://prediqo.redirectme.net:9443` | -| `VITE_API_BASE_URL` | même URL de base (sans `/api`) | -| `VITE_WS_URL` | `wss://prediqo.redirectme.net:9443/ws/v1/games/candle-predict` | -| `CERTBOT_EMAIL` | Email pour Let’s Encrypt | -| `CERTBOT_DOMAIN1` | `prediqo.redirectme.net` | -| `SMTP_*` / `EMAIL_FROM` | Envoi d’emails (vérification compte, reset mot de passe) | +| `BREAK_GLASS_TOKEN` | Jeton d’urgence reset 2FA Super Admin (CLI Docker, min 32 car. ; vide = désactivé) | +| `TRON_NODE_URL` | Mainnet : `https://api.trongrid.io` | +| `TRON_API_KEY` | Clé TronGrid (recommandée en prod) | +| `TRON_CONFIRMATIONS` | Ex. `20` | +| `USDT_TRC20_CONTRACT` | Laisser **vide** en mainnet (contrat Tether par défaut en DB) | +| `ALLOW_WITHDRAWALS` | `false` jusqu’à validation des dépôts (le kill-switch admin Settings prime aussi) | +| `APP_PUBLIC_URL` | Ex. HTTP test : `http://prediqo.redirectme.net:9080` · HTTPS : `https://…:9443` | +| `CORS_ORIGINS` | Même origine que le front (schéma + hôte + port) | +| `VITE_API_BASE_URL` | Même URL de base que `APP_PUBLIC_URL` (sans `/api`) — **rebuild** front après changement | +| `VITE_WS_URL` | `ws://…:9080/ws/v1/games/candle-predict` ou `wss://…:9443/…` | +| `CERTBOT_EMAIL` / `CERTBOT_DOMAIN1` | Let’s Encrypt (parcours HTTPS) | +| `SMTP_*` / `EMAIL_FROM` | E-mails (vérification, reset mot de passe) | ### Générer ou régénérer les secrets @@ -273,23 +281,25 @@ sudo npm run phase-b:up ### Base de données PostgreSQL (sur l’hôte) — **obligatoire avant le 1er démarrage** +Utilisez **le même nom** que `POSTGRES_DB` dans `.env` (recommandé : `games_platform_db`). + Créez la base si nécessaire : ```bash -sudo -u postgres psql -c "CREATE DATABASE crypto_wallet;" +sudo -u postgres psql -c "CREATE DATABASE games_platform_db;" ``` Si votre utilisateur PostgreSQL n’est pas `postgres`, adaptez : ```bash sudo -u postgres psql -c "CREATE USER votre_user WITH PASSWORD 'votre_mot_de_passe';" -sudo -u postgres psql -c "CREATE DATABASE crypto_wallet OWNER votre_user;" +sudo -u postgres psql -c "CREATE DATABASE games_platform_db OWNER votre_user;" ``` Vérifiez la connexion : ```bash -psql -U postgres -h localhost -d crypto_wallet -c "SELECT 1;" +psql -U postgres -h localhost -d games_platform_db -c "SELECT 1;" ``` Les identifiants doivent correspondre à `POSTGRES_USER`, `POSTGRES_PASSWORD` et `POSTGRES_DB` dans `.env`. @@ -300,6 +310,7 @@ Les identifiants doivent correspondre à `POSTGRES_USER`, `POSTGRES_PASSWORD` et POSTGRES_DB=games_platform_db POSTGRES_USER=postgres POSTGRES_PASSWORD=votre_mot_de_passe +DATABASE_PASSWORD=votre_mot_de_passe # Les conteneurs ne peuvent PAS utiliser localhost — utiliser host.docker.internal : DATABASE_URL=postgresql://postgres:votre_mot_de_passe@host.docker.internal:5432/games_platform_db @@ -346,7 +357,7 @@ Les conteneurs Docker se connectent via `host.docker.internal` (configuré dans **Erreur typique si cette étape est oubliée :** ``` -error: database "crypto_wallet" does not exist +error: database "games_platform_db" does not exist ``` → le backend et nginx redémarrent en boucle, le port **9080** ne répond pas. @@ -355,21 +366,30 @@ error: database "crypto_wallet" does not exist ## 4. Démarrage sur base de données vierge (VPS et local) -Cette section regroupe les commandes à exécuter lorsque PostgreSQL est **vide** (base créée, mais **sans schéma**). L’ordre est toujours le même : +Cette section regroupe les commandes lorsque PostgreSQL est **vide** (base créée, **sans schéma**) ou après une [remise à zéro](#41-remise-à-zéro--supprimer-et-recréer-la-base-avant-tests-réels). -1. **Créer la base** PostgreSQL (voir section 3). -2. **Configurer** les secrets et `INITIAL_SETUP_TOKEN` dans le fichier d’environnement. -3. **Appliquer les migrations** (création des tables). -4. **Démarrer la stack** (API, frontend, Redis, workers…). -5. **Configurer la plateforme** via la page **`/setup`** (premier super administrateur). +### Checklist configuration initiale (ordre recommandé) -> Les scripts `*:init` enchaînent automatiquement **migrations + démarrage** en une seule commande. +| # | Étape | Détail | +|---|--------|--------| +| 1 | `.env` complet | Secrets générés **une fois** + backup hors git · TRON mainnet · URLs HTTP ou HTTPS cohérentes · `ALLOW_WITHDRAWALS=false` | +| 2 | Base Postgres | Créée (ou DROP + CREATE) avec le nom `POSTGRES_DB` | +| 3 | Migrations + stack | `phase-b:init` (HTTP) ou `phase-b:init:https` | +| 4 | Santé | `curl` `/health` → `network: mainnet`, `asset: USDT_TRC20` · `/setup/status` → `needsSetup: true` | +| 5 | Premier Super Admin | Page `/setup` + `INITIAL_SETUP_TOKEN` | +| 6 | 2FA + recovery codes | Profil → activer 2FA · sauvegarder les codes hors ligne | +| 7 | (Recommandé) 2ᵉ admin | Ne pas dépendre d’un seul Super Admin | +| 8 | Hot wallet | `seedHotWallets.js` **une fois** · noter l’adresse | +| 9 | Vérifier HD | `verifyDepositAddresses.js` → 0 mismatch | +| 10 | Prêt dépôt test | Micro USDT **TRC20** seulement · retraits encore **off** | + +> **Ne changez plus** `ENCRYPTION_KEY` ni `PLATFORM_MNEMONIC` après l’étape 8 sans procédure de rotation (sinon PII / hot wallet / adresses orphelines). ### Prérequis communs | Étape | Détail | |-------|--------| -| Base PostgreSQL | Base vide créée (`games_platform_db` ou `crypto_wallet` selon `.env`) | +| Base PostgreSQL | Base vide créée (`games_platform_db` selon `.env`) | | Jeton setup | `INITIAL_SETUP_TOKEN` — min. 16 caractères, **32+ aléatoires recommandés** | | Fichier env | VPS → `.env` · Local Docker → `.env.docker` | | Connexion Docker → Postgres | `DATABASE_URL` avec **`host.docker.internal`**, pas `localhost` | @@ -379,8 +399,59 @@ Vérifier que l’API répond avant `/setup` : ```bash curl -s http://127.0.0.1:9080/api/v1/setup/status # attendu : {"needsSetup":true,"setupEnabled":true} + +curl -s http://127.0.0.1:9080/health +# attendu : "network":"mainnet", "asset":"USDT_TRC20", "withdrawalsEnabled": false (ou selon Settings) ``` +### 4.1 Remise à zéro — supprimer et recréer la base (avant tests réels) + +Utilisez cette procédure pour repartir **depuis zéro** (users / ledger / hot wallet DB effacés). +**Attention :** toute donnée applicative dans Postgres est perdue. Les USDT **déjà** envoyés on-chain vers d’anciennes adresses ne sont **pas** effacés par un DROP DB — ne le faites que si ces adresses sont vides ou si vous acceptez de les abandonner. + +```bash +cd ~/projects_repository/games-project # adaptez le chemin + +# 1) Arrêter la stack Prediqo (ne touche pas aux autres apps du VPS) +sudo docker compose --profile http down +# si vous étiez en HTTPS : sudo docker compose --profile https-dns down + +# 2) Couper les sessions Postgres sur la base, puis DROP + CREATE +# Remplacez games_platform_db si POSTGRES_DB est différent dans .env +sudo -u postgres psql -v ON_ERROR_STOP=1 <<'SQL' +SELECT pg_terminate_backend(pid) +FROM pg_stat_activity +WHERE datname = 'games_platform_db' AND pid <> pg_backend_pid(); +DROP DATABASE IF EXISTS games_platform_db; +CREATE DATABASE games_platform_db OWNER postgres; +SQL + +# 3) (Recommandé avant argent réel) régénérer ENCRYPTION_KEY, PLATFORM_MNEMONIC, +# JWT_SECRET, INITIAL_SETUP_TOKEN — une seule fois — et les sauvegarder hors git. +# Ne pas réutiliser un mnémonique / ENCRYPTION_KEY déjà exposés dans un chat. + +# 4) Vérifier .env : TRON mainnet, TRON_API_KEY, ALLOW_WITHDRAWALS=false, +# APP_PUBLIC_URL / VITE_* / CORS_ORIGINS alignés (http://…:9080 ou https://…:9443) + +# 5) Migrations + démarrage HTTP +sudo npm run phase-b:init +# sans Node sur le VPS : +# sudo docker compose run --rm --no-deps --build backend node dist/db/migrate.js +# sudo docker compose --profile http up -d --build + +# 6) Setup navigateur → /setup → premier Super Admin → login → 2FA + recovery codes + +# 7) Hot wallet (une fois) +sudo docker compose run --rm --no-deps --build backend \ + node dist/scripts/seedHotWallets.js + +# 8) Vérifier les adresses HD +sudo docker compose run --rm --no-deps --build backend \ + node dist/scripts/verifyDepositAddresses.js +``` + +Ensuite seulement : créer un user de test → Dépôt → micro USDT TRC20 → (plus tard) financer le hot puis activer les retraits dans Admin Settings. + ### Sur le VPS À la racine du projet (`games_app/`) : @@ -585,6 +656,19 @@ Le port **9080** redirige automatiquement vers **9443**. 5. Connectez-vous sur **`/login`**. 6. Activez le **2FA** (Profil) et **sauvegardez les recovery codes hors ligne** (coffre / impression). Sans ces codes, une perte du téléphone bloque le login admin. 7. **Recommandé :** créez ou promouvez un **second** administrateur / Super Admin dès que possible, pour ne pas dépendre d’un seul compte. +8. **Hot wallet (une fois)** — depuis la racine du dépôt : + +```bash +sudo docker compose run --rm --no-deps --build backend \ + node dist/scripts/seedHotWallets.js +``` + +Notez l’adresse TRON affichée (à financer plus tard pour les retraits). Puis : + +```bash +sudo docker compose run --rm --no-deps --build backend \ + node dist/scripts/verifyDepositAddresses.js +``` | Contexte | URL setup | |----------|-----------| @@ -689,7 +773,10 @@ Local Docker : `npm run docker:local:break-glass-reset-2fa -- …` (fichier `.en | Logs en direct | `npm run phase-b:logs` | | Redémarrer | `npm run phase-b:restart` | | Arrêter | `npm run phase-b:down` | -| Reconstruire après changement `VITE_*` | `npm run phase-b:up:https` | +| Remise à zéro DB | [§4.1](#41-remise-à-zéro--supprimer-et-recréer-la-base-avant-tests-réels) | +| Seed hot wallet | `docker compose run --rm --no-deps backend node dist/scripts/seedHotWallets.js` | +| Vérifier adresses HD | `npm run phase-b:verify-deposit-addresses` | +| Reconstruire après changement `VITE_*` | `npm run phase-b:up` (HTTP) ou `phase-b:up:https` | Logs d’un service précis : @@ -745,17 +832,19 @@ PostgreSQL tourne **sur l’hôte**, pas dans Docker (sauf profil `docker-db` op ## 11. Dépannage -### `database "crypto_wallet" does not exist` +### `database "…" does not exist` -La base PostgreSQL n’a pas été créée sur l’hôte. +La base PostgreSQL n’a pas été créée sur l’hôte (le nom doit être celui de `POSTGRES_DB`, en général `games_platform_db`). ```bash -sudo -u postgres psql -c "CREATE DATABASE crypto_wallet;" +sudo -u postgres psql -c "CREATE DATABASE games_platform_db;" sudo docker compose --profile http up -d sudo docker compose logs backend --tail 20 curl http://127.0.0.1:9080/api/v1/setup/status ``` +Remise à zéro complète : [§4.1](#41-remise-à-zéro--supprimer-et-recréer-la-base-avant-tests-réels). + ### Migration échoue : `relation "users" does not exist` Sur une **base vierge**, une version antérieure de `schema.sql` créait `user_roles` avant la table `users`. Mettez à jour le dépôt puis relancez :