Phase 4 · En cours Android + iOS natifs

Application Mobile

L'app mobile native iOS + Android. Parité fonctionnelle complète avec le portail web (mêmes endpoints, même flow OTP) + capacités natives : biométrie, caméra KYC, notifications push, fonctionnement offline.

Plateformes natives

100%

Code UI partagé Android/iOS

Natif

Pas de WebView, perf native

✨ Fonctionnalités

Parité avec le portail web (mêmes endpoints, même flow OTP) + spécifiques mobile :

📱 Login OTP

SMS 6 chiffres, identique au portail. Stockage du token chiffré dans le coffre-fort sécurisé du système.

🔐 Biométrie

Reconnexion silencieuse Face ID / Touch ID / empreinte après opt-in depuis le profil.

📷 Caméra KYC

Capture CIN recto/verso + selfie avec overlay. Liveness 3 photos (face, gauche, droite).

🔔 Push natif

Notifications push FCM (Android) et APNs (iOS). Deep links vers l'écran concerné.

💰 Demande de prêt

Wizard identique au portail web — signature OTP de consentement.

📄 Documents + reçus

Téléchargement PDF, partage natif via share sheet iOS / Intent Android.

📡 Offline

Lecture des données récentes sans connexion, mutations bloquées avec message clair.

🌐 Multilingue

FR / AR (avec RTL natif) / EN — basculable depuis les paramètres de l'app.

🔐 Authentification + biométrie

Premier login : OTP SMS (comme le portail web). Après le premier login, opt-in possible pour la biométrie depuis la page Profil > Sécurité.

Une fois la biométrie activée, les sessions suivantes sont silencieuses :

L'utilisateur ouvre l'app
Face ID / Touch ID / empreinte demandé
En cas de succès → token déchiffré et utilisateur connecté immédiatement
En cas d'échec → fallback OTP SMS

⚠️ Pour des raisons de sécurité, le PIN du téléphone n'est pas accepté comme alternative à la biométrie (la biométrie est la seule preuve).

📷 Caméra KYC

Capture native (qualité supérieure à un upload via la galerie) :

CIN recto/verso — overlay rectangulaire pour guider le cadrage
Selfie KYC — overlay circulaire pour le visage
Liveness 3 photos — séquence face → gauche → droite (anti-fraude minimal)

Les images sont uploadées directement au backend après capture, jamais stockées de manière permanente sur le téléphone.

🔔 Notifications push natives

L'app reçoit des notifications push pour les événements importants :

Prêt approuvé / rejeté / décaissé
Échéance de remboursement dans 3 jours
Paiement confirmé
Demande de complément KYC
Statut KYC changé

Un tap sur la notification ouvre directement l'écran concerné (deep link) au lieu de la home.

📡 Fonctionnement offline

L'app fonctionne même sans connexion pour :

Consulter son dashboard et son prêt actif
Voir l'historique des paiements
Voir ses documents déjà téléchargés
Voir ses notifications

Les mutations (signature, soumission demande, etc.) nécessitent un réseau actif. Un bandeau "Hors ligne" s'affiche automatiquement en cas de coupure.

📊 État actuel

Composant	Statut	Note
Structure du projet	DONE	Android + iOS + code partagé
Design system (theme, couleurs, composants)	DONE	Charte Émeraude/Cuivre native
Navigation entre écrans	DONE
Couche data + API	DONE	Consommation Portal API
Écrans (Login, Register, Home, Apply, Track, Profile)	DONE
Biométrie (Face ID / Touch ID / empreinte)	À FAIRE	Implémentation native en cours
Stockage sécurisé tokens	À FAIRE	Coffre-fort système
Caméra KYC (Android + iOS)	À FAIRE
Liveness 3 photos	À FAIRE
Push notifications (FCM + APNs)	À FAIRE	Backend déjà compatible
Multilingue + RTL Arabe	À FAIRE
Tests E2E automatisés	À FAIRE

📥 Installation pour test

L'app n'est pas encore publiée sur les stores. Pour tester sur un appareil :

Android

Recevoir le fichier APK debug par AirDrop / email / lien
Sur le téléphone Android : activer "Sources inconnues" dans les paramètres
Installer l'APK
Ouvrir Qredon → écran de login

iOS

Inscription du device dans le profil de provisioning (Apple Developer)
Installation via TestFlight ou directement via Xcode
Lancer l'app → écran de login

🧪 Tous les scénarios de test

Catalogue des scénarios pour l'app mobile. Les scénarios de base sont communs avec le portail web (même API).

A. Premier lancement & login OTP (8 scénarios)

1
Premier lancement — Ouvrir l'app pour la première fois → écran de bienvenue + sélection langue.
2
Login OTP standard — Saisir +216 55 101 001 → SMS reçu sur MailHog → saisir code → connecté.
3
Demande de permissions — L'app demande permissions Push notifications + Caméra à l'installation.
4
Refus permission caméra — L'utilisateur refuse → message explicatif quand on tente une action caméra.
5
Refus permission push — L'utilisateur refuse → l'app fonctionne mais sans push (toast au lieu de notif).
6
Code OTP incorrect — Saisir 6 chiffres faux → message "Code invalide".
7
Code OTP expiré (5 min) — Trop attendre → "Code expiré" + bouton "Recevoir un nouveau code".
8
Réseau coupé pendant le login — Désactiver wifi pendant la saisie du code → message "Connexion requise pour la vérification".

B. Biométrie (10 scénarios)

1
Activer Face ID (iOS) — Connecté → Profil → Sécurité → "Activer Face ID" → confirmation Face ID → activé.
2
Activer Touch ID (iOS ancien) — Idem Face ID mais avec empreinte.
3
Activer empreinte (Android) — Profil > Sécurité > "Activer biométrie" → empreinte → activé.
4
Reconnexion biométrique — Fermer l'app, la rouvrir → Face ID demandé → succès → connecté instantanément (pas d'OTP).
5
Échec biométrique — 3 échecs Face ID → bascule sur écran OTP (fallback).
6
Annulation biométrique — Bouton "Annuler" sur le prompt biométrique → écran OTP affiché.
7
Désactiver biométrie — Profil > Sécurité → "Désactiver" → confirmation biométrique requise → désactivé + token effacé du coffre.
8
Appareil sans biométrie — Téléphone sans Face ID / empreinte → option grisée avec message "Non disponible sur cet appareil".
9
PIN device refusé — Le PIN du téléphone n'est pas accepté comme fallback de la biométrie (volontaire).
10
Logout wipe — Logout depuis le profil → token effacé du coffre → prochaine ouverture demande OTP.

C. Caméra KYC (8 scénarios)

1
Capture CIN recto — Étape Documents lors de l'inscription → "Capturer CIN recto" → caméra ouverte avec overlay rectangulaire → capture → preview.
2
Capture CIN verso — Idem mais pour le verso.
3
Selfie KYC — Overlay circulaire centré sur le visage → capture → preview.
4
Liveness 3 photos — Séquence guidée : "Regardez devant" → photo. "Tournez à gauche" → photo. "Tournez à droite" → photo.
5
Reprendre la photo — Bouton "Reprendre" sur le preview → recapture.
6
Lumière insuffisante — Capture trop sombre → message d'avertissement, suggestion de reprendre.
7
Permission caméra refusée initialement — Si l'utilisateur a refusé, message explicatif + lien vers les paramètres système.
8
Upload après capture — Photos uploadées au backend après validation → progression visible.

D. Push notifications (8 scénarios)

1
Push "Prêt approuvé" — IMF approuve le prêt → push sur le téléphone avec son + vibration.
2
Push "Prêt décaissé" — IMF décaisse → push avec montant et date.
3
Push "Échéance dans 3 jours" — 3 jours avant l'échéance → push de rappel.
4
Push "Paiement confirmé" — Caissier enregistre le paiement → push immédiat à l'emprunteur.
5
Push "Complément KYC requis" — IMF demande un doc supplémentaire → push.
6
Deep link au tap — Tap sur la push "Prêt approuvé" → l'app s'ouvre directement sur la page du prêt concerné.
7
Push reçu app fermée — Push reçu alors que l'app n'est pas lancée → notification système → tap ouvre l'app au bon endroit.
8
Désactiver push — Paramètres iOS/Android → couper les notifs pour Qredon → plus de push reçues mais l'app fonctionne.

E. Demande de prêt depuis mobile (6 scénarios)

1
Demande complète depuis le mobile — Connecté → "Demander un prêt" → wizard 4 étapes → signature OTP → soumise (identique au portail web).
2
Sauvegarde brouillon — Quitter l'app au milieu du wizard → revenir → reprise où on en était.
3
Upload pièces via caméra — Étape Documents → "Capturer avec la caméra" au lieu d'upload galerie.
4
Signature OTP — À la soumission → OTP envoyé → saisie → demande soumise.
5
Continuer une demande commencée sur web — Brouillon créé sur le portail web → reprise dans l'app mobile (même compte).
6
Annuler une demande — Si statut DRAFT ou SUBMITTED → bouton "Annuler".

F. Fonctionnement offline (5 scénarios)

1
Mode avion activé — Ouvrir l'app sans réseau → bandeau "Hors ligne" → dashboard, prêt actif, historique consultables (depuis cache).
2
Mutation bloquée offline — Tenter une demande de prêt sans réseau → message "Connexion requise pour cette action".
3
Reconnexion auto — Désactiver mode avion → bandeau "Hors ligne" disparaît → données rafraîchies.
4
Push reçue en différé — Push envoyée pendant que le téléphone était offline → reçue dès le retour en ligne.
5
Cache expiré — Cache local de >24h → l'app force le refresh au retour en ligne.

G. Multilingue & RTL (4 scénarios)

1
Bascule en arabe — Paramètres > Langue > العربية → toute l'UI bascule + layout RTL.
2
Bascule en anglais — Choisir English → UI en anglais.
3
Persistance après redémarrage — Fermer l'app, rouvrir → langue conservée.
4
Langue système par défaut — Premier lancement → l'app détecte la langue du système et l'utilise par défaut.

H. Documents & partage natif (5 scénarios)

1
Voir mes documents — Documents → liste de tous mes docs uploadés.
2
Télécharger un reçu PDF — Reçu d'un paiement → "Télécharger" → PDF généré.
3
Partager via share sheet — Bouton "Partager" → share sheet natif (WhatsApp, email, AirDrop iOS, Intent Android).
4
Générer attestation — Documents > Générer > Bonne tenue → PDF généré + QR.
5
Ouvrir le PDF directement — Tap sur un PDF → ouverture dans le viewer natif iOS/Android.

I. Edge cases mobile (8 scénarios)

1
Mise en arrière-plan — App en background pendant un appel/SMS → reprise au même endroit.
2
Rotation de l'écran — Tourner le téléphone → l'app reste utilisable (portrait par défaut, paysage géré).
3
Faible mémoire — Système low-memory → l'app gère le redémarrage propre sans perte de données.
4
Batterie faible — L'app continue de fonctionner normalement (pas de mode dégradé).
5
Mise à jour de l'app — Update via store → ouverture après update → re-connexion biométrique ou OTP si nécessaire.
6
Désinstallation/réinstallation — Désinstaller l'app → token wipe automatique → réinstaller → premier login OTP requis.
7
Compte sur deux appareils — Même compte connecté sur 2 téléphones → les deux fonctionnent, les notifs arrivent sur les deux.
8
Tenant suspendu — L'IMF est suspendue → l'app affiche un message "Service indisponible, contactez votre conseiller".

J. Workflows complets bout-à-bout (3 scénarios)

1
Onboarding emprunteur 100% mobile
1. Installation de l'app Android/iOS
2. Premier lancement → Sélection langue (FR/AR/EN)
3. "Créer un compte" → saisie phone + email
4. Réception double OTP → validation
5. Saisie profil de base
6. Capture CIN recto/verso via caméra native
7. Selfie KYC + liveness 3 photos
8. Soumission → statut PENDING_REVIEW
9. Activation biométrie proposée pour les prochaines sessions
10. Validation par l'agent IMF → push reçue "KYC validé"
11. Tap sur la push → écran statut KYC affiché
2
Cycle prêt + remboursement sur mobile
1. Réouverture de l'app → Face ID → connecté instantanément
2. Tap "Demander un prêt" → wizard 4 étapes
3. Soumission + signature OTP → dossier créé
4. 3 jours plus tard → push "Prêt approuvé" → tap → écran du prêt
5. 2 jours plus tard → push "Prêt décaissé" + montant
6. 30 jours plus tard → push "Échéance dans 3 jours"
7. L'utilisateur se rend à l'agence et paie en cash
8. Push immédiate "Paiement confirmé" → reçu PDF téléchargeable
9. Partage du reçu via WhatsApp à son comptable (share sheet natif)
3
Utilisation offline en zone rurale
1. Emprunteur dans une zone sans réseau → ouvre l'app
2. Bandeau "Hors ligne" affiché
3. Il consulte son prêt actif et son échéancier (cache local)
4. Il télécharge ses derniers reçus pour les partager plus tard
5. De retour en ville avec réseau → bandeau "Hors ligne" disparaît
6. Les push en attente arrivent
7. Les données se rafraîchissent automatiquement

← Toutes plateformes