129 lines
4.3 KiB
Markdown
129 lines
4.3 KiB
Markdown
# 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)
|
||
|
||
```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 <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` :
|
||
|
||
```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)
|
||
|
||
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
|
||
```
|