4.3 KiB
Prediqo 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 /healthGET /faq/entriesPOST /auth/forgot-passwordGET /referral/dashboard,GET /bonus/balancesGET /games/candle-predict/statePOST /games/candle-predict/bets(avecstakeAmount)POST /games/candle-predict/bets/multiPUT /games/candle-predict/auto- Routes protégées →
401sans 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.
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)
- Démarrer Docker :
npm run docker:local:up(ounpm run dev:testnethors Docker) - Lancer l’app avec l’URL ci-dessus
- 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