Before reset the plateforme

This commit is contained in:
Your Name 2026-08-24 09:36:32 +02:00
parent b826b05ce3
commit efae596a97

View File

@ -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 :