Wallet, une application de paiement mobile

Une application de portefeuille électronique construite chapitre après chapitre, contre un petit backend local. Elle couvre ce qu'un entretien senior aborde : authentification, réseau, état, hors ligne, sécurité, tests et livraison.

Pourquoi ce projet

• Il ressemble aux missions des grands comptes. Un wallet combine argent, sécurité, API d'une gateway et exigences de fiabilité. Ce sont les sujets des entretiens dans la banque et les télécoms.
• Il force les bons réflexes. Montants en entiers, refresh token concurrent, idempotence des paiements, cache hors ligne : chaque étape correspond à une question d'entretien classique.
• Il vous laisse un code à montrer. Publiez-le sur GitHub. Quand le code de vos clients est confidentiel, un projet propre, testé et intégré en continu répond à la demande « avez-vous un exemple de code ? ».

Les écrans

Le contrat d'API

Le backend local est dans le dossier backend/ du dépôt (voir Lancer le backend). Pour les premiers chapitres, vous pouvez aussi simuler les réponses avec un faux repository : c'est une bonne pratique quand le back-end d'un client n'est pas prêt.

• Base : http://localhost:8080/api/v1. Depuis l'émulateur Android : http://10.0.2.2:8080/api/v1.
• Montants en entiers, en centimes, devise MAD. Jamais de double pour de l'argent.
• Dates en ISO 8601, UTC.
• Comptes de démo : 0600000001 / demo1234 (particulier), 0600000002 / demo1234 (pro).

Une transaction

{
  "id": "tx_01J9Z3",
  "type": "transfer_out",
  "amount": 15000,
  "direction": "debit",
  "counterparty": "Salma B.",
  "note": "Loyer octobre",
  "status": "completed",
  "createdAt": "2026-10-21T14:32:05Z"
}

Types : transfer_in, transfer_out, payment, cash_in, cash_out, bill. Statuts : completed, pending, failed. Votre modèle doit tolérer un type inconnu ajouté plus tard par le serveur.

Les erreurs

{ "error": { "code": "INSUFFICIENT_FUNDS", "message": "Solde insuffisant" } }

Pour VALIDATION_ERROR, un objet fields donne le message de chaque champ en erreur, à afficher sous le champ du formulaire :

{
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Certains champs sont invalides",
    "fields": { "amount": "Montant entre 1 et 500000 centimes" }
  }
}

Le mode chaos

Pour tester la résilience, le backend accepte deux en-têtes : X-Chaos-Latency: 2000 ajoute 2 secondes de latence, X-Chaos-Fail-Rate: 0.3 fait échouer 30 % des requêtes en 500.

Sur POST /transfers, l'échec simulé arrive après l'enregistrement : le débit a eu lieu mais la réponse est perdue, comme lors d'une coupure réseau au mauvais moment. Rejouer le transfert avec le même Idempotency-Key renvoie la même transaction, avec l'en-tête Idempotent-Replayed: true, sans débiter deux fois. La même clé avec un corps différent est refusée en 422.

Lancer le backend

Un serveur Dart (shelf) qui garde tout en mémoire : pas de base de données, pas de Docker. Chaque redémarrage remet les données de démo, et les tokens émis avant deviennent invalides.

cd backend
dart pub get
dart run bin/server.dart                    # port 8080, access token de 300 s
dart run bin/server.dart --port 8081        # si le port 8080 est déjà pris
dart run bin/server.dart --access-ttl 20    # pour tester le refresh sans attendre 5 min
dart test                                   # tests du contrat

• Le serveur écoute sur 0.0.0.0 : un téléphone sur le même réseau Wi-Fi l'atteint avec l'adresse IP de votre machine.
• Cinq mots de passe faux en une minute sur le même numéro déclenchent un 429 avec Retry-After.
• L'access token est un JWT : l'application peut lire exp pour rafraîchir à l'avance, mais seul le serveur fait foi.
• Un transfert vers Atelier Nour SARL crédite le compte pro : connectez-vous avec les deux comptes pour voir les deux côtés.
• POST /api/v1/dev/reset remet les données de départ, utile avant un test d'intégration.

L'arborescence cible

Les étapes

Les dépendances

Ajoutez-les au fil des chapitres, pas toutes au début. Prenez les dernières versions stables sur pub.dev au moment où vous les ajoutez.

# state, navigation, réseau
flutter pub add flutter_riverpod riverpod_annotation go_router dio
# modèles
flutter pub add freezed_annotation json_annotation
flutter pub add dev:build_runner dev:freezed dev:json_serializable dev:riverpod_generator
# stockage
flutter pub add flutter_secure_storage drift drift_flutter
flutter pub add dev:drift_dev
# tests
flutter pub add dev:mocktail
flutter pub add 'dev:integration_test:{"sdk":"flutter"}'