games_app/prediqo_mobile/TESTING.md

4.7 KiB
Raw Blame History

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)

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 :

cd backend
npm run test:e2e:db

Ou la suite DB complète :

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é)

cd prediqo_mobile
flutter pub get
flutter test test/

Tests sur appareil / émulateur (optionnel)

flutter test integration_test/app_e2e_test.dart -d <device_id>

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 :

{ "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.

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