# Tloto Mobile — Tests E2E Guide pour exécuter les tests end-to-end de l'application mobile et des contrats API associés. ## Backend — contrats API mobile Les tests vérifient les endpoints utilisés par le client Flutter (`stakeAmount`, multi-bougies, auto, referral, FAQ, health). ### Tests mockés (CI, sans base de données) ```bash cd backend npm run test:e2e ``` Couvre : - `GET /health` - `GET /faq/entries` - `POST /auth/forgot-password` - `GET /referral/dashboard`, `GET /bonus/balances` - `GET /games/candle-predict/state` - `POST /games/candle-predict/bets` (avec `stakeAmount`) - `POST /games/candle-predict/bets/multi` - `PUT /games/candle-predict/auto` - Routes protégées → `401` sans token ### Tests avec base de données Nécessite `DATABASE_URL` et `RUN_DB_TESTS=1` : ```bash cd backend npm run test:e2e:db ``` Ou la suite DB complète : ```bash npm run test:db ``` ## Flutter — tests d'intégration UI Les tests E2E UI utilisent des **fakes** (pas de backend live) pour valider les parcours : - Splash → accueil public (`/welcome`) si non connecté - Welcome → Login → Dashboard (`/home`) - Navigation Predict → Profile (session authentifiée) ### Lancer les tests E2E UI (VM — recommandé) ```bash cd prediqo_mobile flutter pub get flutter test test/ ``` ### Tests sur appareil / émulateur (optionnel) ```bash flutter test integration_test/app_e2e_test.dart -d ``` Lister les appareils : `flutter devices` ## Flux démarrage (splash / public / dashboard) | Étape | Route | Qui | |-------|-------|-----| | Splash | `/` | Tout le monde au lancement (~1.2s + check session) | | Accueil public | `/welcome` | Visiteurs (marketing, FAQ, CTA login/register) | | Dashboard | `/home` | Utilisateurs authentifiés (données perso) | `GET /api/v1/games` et `GET /api/v1/advertisements` sont **publics** (lecture seule). Les routes de jeu/bets restent protégées. ## Connexion mobile → API Docker locale Docker expose l’API via nginx sur **9080** (le port 4000 n’est pas publié sur l’hôte). | Cible | Commande | |-------|----------| | **Émulateur Android** | launch config **prediqo (emulator)** ou `flutter run --dart-define=API_BASE_URL=http://10.0.2.2:9080` | | **Appareil physique** | mettre l’IP Wi‑Fi du PC dans `dart_defines.dev.json`, puis full restart (pas hot reload) | Fichier local (gitignored) : copier `dart_defines.dev.example.json` → `dart_defines.dev.json` : ```json { "API_BASE_URL": "http://10.10.16.78:9080" } ``` Ce fichier est lu via `--dart-define-from-file` (`.vscode/settings.json` à la racine du repo **et** dans `prediqo_mobile/.vscode/`). **Ne plus mettre d’IP en dur** dans `.vscode/settings.json` : les defines sont compilées au build — un hot restart / une réinstallation ne change rien si Flutter a été lancé avec l’ancienne IP. Après chaque changement d’`API_BASE_URL` : **Stop** puis **Run** (ou `flutter run` à neuf). Hot restart ne suffit pas. Par défaut (sans dart-define) : `http://10.0.2.2:9080`. ### APK release `flutter build apk --release` utilise par défaut `http://prediqo.redirectme.net:9080`. Les APKs plus anciens compilés avec `10.0.2.2` ne peuvent pas joindre le VPS — il faut reconstruire. ```bash cd prediqo_mobile flutter build apk --release --dart-define-from-file=dart_defines.dev.json # APK : build/app/outputs/flutter-apk/app-release.apk ``` L’écran login affiche une bannière d’erreur en cas d’échec (sans URL API ni détails d’infra). ## E2E contre un backend live (manuel) 1. Démarrer Docker : `npm run docker:local:up` (ou `npm run dev:testnet` hors Docker) 2. Lancer l’app avec l’URL ci-dessus 3. Suivre le guide [TESTING.md](../TESTING.md) pour dépôts / retraits testnet ## Clés de test (finders) | Clé | Écran | |-----|-------| | `splash_screen` | Splash de démarrage | | `welcome_screen`, `welcome_get_started`, `welcome_help`, `welcome_app_update`, `language_toggle` | Accueil public | | `login_screen` | Connexion | | `login_email`, `login_password`, `login_submit` | Formulaire login | | `forgot_password_link` | Lien mot de passe oublié | | `nav_home`, `nav_predict`, `nav_wallet`, `nav_profile` | Bottom nav (Dashboard / …) | | `prediction_games_screen`, `game_card_candle-predict` | Catalogue Predict | | `prediction_screen` | Page prédiction (Candle Predict) | ## Fichiers ``` backend/src/tests/mobileApiE2e.test.ts # API E2E mockée backend/src/tests/mobileApiE2e.db.test.ts # API E2E avec DB prediqo_mobile/test/ e2e_app_flow_test.dart # E2E UI (VM) support/e2e_fixtures.dart # Fakes + setup DI prediqo_mobile/integration_test/ app_e2e_test.dart # E2E sur appareil ```