games_app/prediqo_mobile/TESTING.md

140 lines
4.7 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 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 <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`.
### 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
```