Guide utilisateur – Photos Experts Groupe (Android)

🚀 1. Démarrage rapide

Voici l'essentiel pour commencer à travailler en moins de deux minutes.

Ouvrez l'application Photos Experts Groupe. Un écran de chargement apparaît brièvement le temps que l'application vérifie votre session.
Si vous n'êtes pas encore connecté, vous êtes redirigé vers la page de connexion Keycloak (SSO Experts Groupe). Saisissez vos identifiants habituels. Un navigateur interne s'ouvre, puis l'application reprend automatiquement.
Au premier lancement, l'application vous redirige vers l'onglet Paramètres avec la mention « Paramètres (obligatoires) » dans la barre du haut. Vous devez remplir les trois champs obligatoires avant de pouvoir prendre des photos.
Une fois les paramètres enregistrés, l'onglet Prendre une photo devient accessible.

Bon à savoir La session est conservée d'une ouverture à l'autre. Un rafraîchissement automatique du jeton d'authentification se fait en arrière-plan : vous n'avez généralement pas besoin de vous reconnecter.

⚙️ 2. Paramètres obligatoires

Ces trois champs sont indispensables. Sans eux, l'application refuse l'accès à la caméra et à l'envoi.

Champ	Ce qu'il faut saisir	Remarque
Initiales Obligatoire	Vos initiales (ex. : `NB`)	Utilisées pour identifier l'auteur des photos dans les métadonnées.
Région de rattachement Obligatoire	Sélectionnez dans la liste : Nord Est, Ouest, Île-de-France, Sud Est, Sud Ouest, Centre Est, Experts Groupe	Détermine le code « plaque » transmis au serveur avec chaque photo. Un mauvais choix entraîne un rejet côté FTP.
URL de l'API Obligatoire	Laissez la valeur par défaut sauf instruction contraire de votre responsable.	Valeur par défaut : `https://interface.expertsgroupe.fr/v1/mobile`

Appuyez sur Enregistrer en bas de page. Un message de confirmation apparaît et vous êtes automatiquement renvoyé vers l'onglet de prise de vue.

Attention Si vous changez de région après avoir déjà pris des photos, les photos déjà enregistrées localement seront envoyées avec le nouveau code région. Vérifiez que vous êtes sur la bonne région avant de commencer.

📱 3. Paramètres recommandés sur Android

Ces réglages sont optionnels mais adaptez-les à votre situation terrain.

Paramètre	Valeur par défaut	Conseil
GPS (géolocalisation) Recommandé	Activé	Laissez activé. Chaque photo intègre les coordonnées GPS dans ses métadonnées EXIF. Désactivez uniquement si la batterie est critique.
Objectif préféré Optionnel	Standard (2e capteur)	Sur les appareils à plusieurs capteurs : Grand-angle pour les espaces restreints, Standard pour la plupart des cas, Zoom pour les dommages à distance. Ce choix sera mémorisé.
Redimensionnement des photos Optionnel	Ne pas retailler (original)	En zone 4G/5G stable, gardez « original ». Sur réseau faible, choisissez « Standard – 2048 px » pour accélérer l'envoi. La qualité JPEG est fixée à 80 % lors de l'envoi, quelle que soit l'option.
Nettoyage automatique Par défaut : actif	Activé, 30 jours	Supprime automatiquement les photos déjà envoyées après 30 ou 60 jours. Évite de saturer le stockage. Vous pouvez aussi déclencher le nettoyage manuellement avec le bouton prévu.
Scanner de plaque Optionnel	Désactivé	Activez-le si vous souhaitez scanner l'immatriculation du véhicule pour retrouver automatiquement le numéro de dossier. Nécessite une connexion réseau.
Verrouillage portrait Par défaut : actif	Activé	L'écran reste en mode portrait même si vous inclinez le téléphone. Désactivez uniquement si vous avez besoin du mode paysage dans la galerie.

Configuration minimale recommandée Android 8.0 ou supérieur · 2 Go de RAM · 500 Mo d'espace libre · Connexion 4G ou Wi-Fi pour l'envoi. L'application fonctionne hors ligne pour la prise de vue et sauvegarde localement les photos.

📷 4. Flux de prise de photo pas à pas

4.1 Préparer le dossier

Saisissez le numéro de dossier dans le champ en haut de l'écran. Si vous ne connaissez que l'immatriculation et que le scanner de plaque est activé, appuyez sur l'icône de scan à droite du champ pour déclencher la reconnaissance automatique.
Recherche par plaque : après scan ou saisie d'une immatriculation (format AB-123-CD), l'application interroge le serveur. Si un seul dossier correspond, il vous est proposé pour confirmation. Si plusieurs dossiers correspondent, une liste vous est présentée, sélectionnez le bon.
Sélectionnez le type de mission en bas du formulaire : Collision (720), PJ (760), Maritime (560) ou VEI (896). Ce code est intégré dans les métadonnées de la photo.

Dossier restauré automatiquement Si vous fermez l'application et la rouvrez, le dernier dossier utilisé et la dernière photo prise sont restaurés automatiquement. Vous pouvez reprendre sans ressaisir.

4.2 Prendre la photo

Appuyez sur Ouvrir la caméra. L'écran passe en mode plein écran. Si c'est la première ouverture, Android demande l'autorisation d'accès à la caméra — accordez-la.
La caméra s'ouvre en mode haute résolution sur le capteur arrière sélectionné dans les paramètres. Le flash est en mode automatique par défaut. Changez-le avec l'icône éclair en haut.
Mise au point : tapez sur la zone à mettre au point. Un carré apparaît brièvement. Si vous voyez l'indication « Tapez pour faire la mise au point » au premier lancement, c'est normal, elle disparaît après quelques secondes.
Zoom : pincez l'écran avec deux doigts pour zoomer ou dézoomer. Sur les appareils multi-capteurs, vous pouvez aussi changer d'objectif (grand-angle / standard / zoom) via le bouton dédié.
Appuyez sur le bouton de déclenchement (cercle central en bas). Un son d'obturateur confirme la prise. Un intervalle minimal de 350 ms entre deux prises évite les doublons accidentels.

4.3 Ce qui se passe immédiatement après la prise

L'application effectue ces opérations dans l'ordre :

Récupération GPS (si activé) : l'application attend jusqu'à 10 secondes pour obtenir une position précise. Si le GPS ne répond pas à temps, la photo est sauvegardée sans coordonnées. Aucune photo n'est perdue pour ce motif.
Horodatage visible : la date et l'heure (format JJ/MM/AAAA HH:MM) sont gravées en bas à droite de l'image, avec une ombre portée pour rester lisibles sur tout fond.
Écriture des métadonnées EXIF : date/heure, coordonnées GPS, initiales, type de mission — tout est inscrit dans le fichier.
Sauvegarde locale : la photo est enregistrée dans le dossier interne de l'application sous le nom Alphaexp.AAAAMMJJHHMMSS.{NUMERO_DOSSIER}.jpg. Elle est immédiatement visible dans la Galerie.

La photo est toujours sauvegardée, même sans réseau L'enregistrement local est indépendant du réseau. La connexion n'est nécessaire que pour l'envoi au serveur, qui peut se faire ultérieurement.

4.4 Après la prise

Vous restez sur l'écran caméra pour prendre d'autres photos du même dossier. Le compteur en haut indique le nombre de photos en attente d'envoi pour ce dossier. Pour terminer, appuyez sur la flèche retour : vous revenez à l'écran principal avec la dernière photo affichée en miniature.

4.5 Nouveau dossier

Appuyez sur le bouton Nouveau dossier (icône en haut à droite). Une confirmation vous est demandée. Cette action réinitialise uniquement l'interface (numéro de dossier et prévisualisation) — les photos déjà sauvegardées ne sont pas supprimées.

🗂️ 5. Galerie et gestion des photos/dossiers

L'onglet Galerie liste tous les dossiers présents sur le téléphone.

5.1 Lecture du résumé d'un dossier

Chaque carte de dossier affiche :

Le nombre de photos en attente d'envoi (non encore envoyées)
Le nombre de photos envoyées (statut « sent » confirmé)
La taille totale occupée sur le téléphone (photos en attente + envoyées)
Une miniature de prévisualisation de la photo la plus récente

5.2 Tri des dossiers

Par défaut, les dossiers sont affichés du plus récent au plus ancien. Vous pouvez trier par date (croissant/décroissant) ou par numéro de dossier (croissant/décroissant) via le menu de tri en haut de page.

5.3 Consultation d'un dossier

Appuyez sur un dossier pour le détailler. Vous voyez toutes les photos avec leur statut :

En attente : photo sauvegardée, pas encore envoyée
Envoyée : envoi confirmé par le serveur
Erreur (action requise) : l'envoi a échoué pour une raison non récupérable (ex. : accès FTP refusé). Vous devez contacter le support.
Erreur (réessayable) : l'envoi a échoué temporairement. Une nouvelle tentative depuis l'onglet Serveur peut suffire.

5.4 Actions disponibles sur un dossier

Partager : partage les photos via le menu Android (e-mail, Drive, etc.)
Exporter en ZIP : crée une archive ZIP du dossier, prête à partager ou archiver manuellement
Importer une photo existante : ajoute une photo depuis la galerie Android dans ce dossier (utile si vous avez une photo hors de l'application)
Supprimer : supprime définitivement le dossier et toutes ses photos (y compris les envoyées)

5.5 Suppression multi-dossiers

Cochez les cases à gauche des dossiers, puis appuyez sur Supprimer la sélection. Une confirmation est demandée. L'opération est irréversible.

Attention avant suppression L'application ne supprime pas les photos de la galerie Android système. Elle gère son propre stockage interne. Supprimer un dossier dans l'application n'affecte pas vos autres photos Android.

5.6 Nettoyage automatique

Si le nettoyage automatique est activé (paramètres), l'application supprime périodiquement les photos envoyées depuis plus de 30 ou 60 jours. Ce processus se déclenche au démarrage et en arrière-plan. Vous pouvez aussi le lancer manuellement depuis les Paramètres via le bouton Nettoyer maintenant.

☁️ 6. Envoi serveur et gestion des échecs

6.1 Lancer un envoi

Allez sur l'onglet Serveur. L'application liste tous les dossiers disponibles en attente d'envoi, tous cochés par défaut.
Décochez les dossiers que vous ne souhaitez pas envoyer maintenant, ou utilisez la case Tout sélectionner.
Appuyez sur Envoyer. Une confirmation vous est demandée avant le départ si l'option est activée. Confirmez pour démarrer.
Une barre de progression indique le dossier en cours, le fichier traité et la phase (préparation → envoi → analyse). Vous pouvez annuler à tout moment avec le bouton Annuler.

Envoi uniquement manuel Il n'y a pas d'envoi automatique en arrière-plan. L'envoi se déclenche uniquement quand vous appuyez sur le bouton. Pensez à envoyer régulièrement pour éviter d'accumuler.

6.2 Comment l'envoi fonctionne

Pour chaque dossier sélectionné :

Les photos sont regroupées en lots de 12 Mo maximum pour optimiser le réseau.
Chaque photo est recompressée à la qualité configurée avant envoi. Un fichier temporaire est créé puis supprimé automatiquement.
Le lot est envoyé au serveur avec le numéro de dossier, le code région et un identifiant d'envoi unique.
Le serveur répond photo par photo : chaque fichier est marqué envoyé ou en erreur individuellement.

6.3 Logique de réessai automatique

Si l'envoi échoue temporairement, l'application réessaie automatiquement :

Jusqu'à 6 tentatives par fichier
Délai entre tentatives : 3 secondes × numéro de tentative, plus un décalage aléatoire (0–600 ms) pour éviter la saturation
Timeout par tentative : 20 secondes (connexion + envoi + réponse)

Si le lot entier échoue, l'application bascule automatiquement en mode envoi fichier par fichier pour limiter les pertes.

6.4 Types d'erreurs et réactions

Code / Cause	Message affiché	Réessai auto ?	Action
401 / 403	Session expirée ou non autorisée	Oui (1 fois, après refresh du jeton)	Si répété : reconnectez-vous (menu > Déconnexion).
404	Dossier introuvable	Non	Vérifiez l'immatriculation ou le numéro de dossier saisi.
408	Serveur trop lent	Oui	Réessayez depuis l'onglet Serveur si ça persiste.
422	Fichier refusé (validation)	Non	Contactez le support avec le fichier debug.
429	Trop de requêtes	Oui	Attendez quelques minutes et relancez.
5xx	Serveur indisponible	Oui	Réessayez plus tard.
FTP 550	Accès FTP refusé (droits)	Non	Contactez le support — problème de configuration serveur.
Pas de réseau	L'indicateur affiche « Hors ligne »	—	Attendez d'avoir du réseau. Les photos restent en attente sans être perdues.
Timeout réseau	Serveur trop lent	Oui	Vérifiez la qualité du signal. Passez en Wi-Fi si possible.

6.5 Fin d'envoi

À la fin, une bannière indique le bilan : « X / Y envoyés ». En cas d'erreur sur certains fichiers, une boîte de dialogue propose de partager le fichier de debug pour faciliter le diagnostic par le support.

6.6 En cas d'absence de réseau

L'application détecte automatiquement l'état du réseau (Wi-Fi, 4G/5G, hors ligne). Si vous tentez d'envoyer sans connexion, le statut « Hors ligne » s'affiche. Les photos ne sont jamais perdues : elles restent dans le stockage local jusqu'à l'envoi réussi.

6.7 Rafraîchissement de la liste

La liste des dossiers se met à jour automatiquement quand vous revenez sur l'onglet Serveur (depuis la caméra par exemple). Un rafraîchissement automatique est également planifié à l'ouverture de l'écran.

🔒 7. Permissions Android et impacts

L'application demande les permissions suivantes. Voici ce qui se passe si vous les refusez.

Permission	Utilisation	Refus = impact
Appareil photo	Prise de vue. Demandée à la première ouverture de la caméra.	La caméra ne s'ouvre pas. L'application revient à l'écran précédent. Bloquant.
Localisation précise (ACCESS_FINE_LOCATION)	Intégration des coordonnées GPS dans les photos EXIF. Demandée 500 ms après l'ouverture de la caméra, sans bloquer la prise de vue.	Les photos ne contiennent pas de coordonnées GPS. L'avertissement « Permission GPS refusée » s'affiche en bas d'écran. Les photos sont quand même prises et sauvegardées.
Localisation approximative (ACCESS_COARSE_LOCATION)	Fallback si la localisation précise est indisponible.	Mêmes conséquences que ci-dessus si aucune permission de localisation n'est accordée.
Localisation en arrière-plan (ACCESS_BACKGROUND_LOCATION)	Déclarée dans le manifeste pour compatibilité future. Non utilisée activement pour l'instant.	Aucun impact immédiat sur l'usage terrain.
Internet	Connexion au serveur API pour l'envoi des photos et la recherche de dossiers.	Automatiquement accordée par Android, non demandable à l'utilisateur. Si absent : pas d'envoi possible, mode local uniquement.
WAKE_LOCK	Maintien du processeur actif lors des tâches planifiées (nettoyage automatique).	Le nettoyage automatique peut ne pas se déclencher si l'écran est éteint.
RECEIVE_BOOT_COMPLETED	Réinitialisation des tâches planifiées (nettoyage) après redémarrage du téléphone.	Le nettoyage planifié ne reprend pas après un redémarrage. Pas d'impact sur la prise de vue ou l'envoi.

Réactiver une permission refusée

Si vous avez refusé une permission et souhaitez la réactiver : allez dans Paramètres Android → Applications → Photos Experts Groupe → Autorisations et accordez la permission manuellement. Sur certains appareils Android, si vous avez refusé deux fois une permission, Android ne la redemandera plus — vous devrez l'activer depuis les Paramètres Android.

Localisation : activez « Pendant l'utilisation » Android 10+ vous propose trois niveaux pour la localisation : « Toujours », « Pendant l'utilisation » ou « Refuser ». Choisissez au minimum « Pendant l'utilisation » pour que le GPS fonctionne lors de la prise de photo.

🔍 8. Diagnostic express

Utilisez ce tableau si quelque chose ne fonctionne pas comme attendu.

Symptôme	Cause probable	Action recommandée
L'app redirige vers les Paramètres au démarrage	Initiales, région ou URL API manquantes	Remplissez les trois champs obligatoires et appuyez sur Enregistrer.
L'écran de connexion SSO réapparaît	Session expirée ou token corrompu	Reconnectez-vous normalement. Si ça revient souvent, signalez-le au support.
La caméra ne s'ouvre pas / l'app revient en arrière	Permission caméra refusée	Allez dans les Paramètres Android → Applications → Photos Experts Groupe → Autorisations → Appareils photo → Autoriser.
Pas de coordonnées GPS dans les photos	Permission GPS refusée ou service de localisation désactivé	Vérifiez que le GPS est activé dans les Paramètres Android et que la permission de localisation est accordée « Pendant l'utilisation ».
Le GPS met longtemps / timeout	Signal GPS faible (intérieur, zone dense)	Sortez ou attendez quelques secondes. La photo est quand même prise si le timeout (10 s) est dépassé.
Envoi bloqué, aucune progression	Pas de réseau, serveur hors ligne, ou token expiré	Vérifiez la connexion réseau. Attendez quelques minutes et réessayez. Si le statut est « Session expirée », déconnectez-vous et reconnectez-vous.
Erreur « Accès FTP refusé (droits) »	Mauvaise région sélectionnée ou droits FTP révoqués	Vérifiez la région dans les Paramètres. Contactez le support si le problème persiste.
Erreur « Dossier introuvable »	Numéro de dossier ou immatriculation incorrects	Vérifiez la saisie. Le numéro de dossier est sensible aux espaces et tirets.
La recherche par plaque ne trouve rien	Dossier non créé côté serveur, plaque mal reconnue, ou pas de réseau	Vérifiez la connexion. Saisissez manuellement le numéro de dossier en attendant.
Plusieurs dossiers trouvés pour une plaque	Plusieurs sinistres actifs pour ce véhicule	Une liste s'affiche — sélectionnez le bon dossier.
L'envoi réussit partiellement (certains fichiers en erreur)	Fichier corrompu, rejet serveur, ou timeout	Utilisez le bouton « Partager le debug » pour envoyer le log au support.
Le stockage sature	Accumulation de photos envoyées non nettoyées	Allez dans Paramètres → Nettoyer maintenant. Ou activez le nettoyage automatique.
L'application est très lente / freeze	Mémoire insuffisante, ou génération d'un grand ZIP en arrière-plan	Attendez la fin de l'opération en cours (export ZIP, envoi). Redémarrez l'app si ça persiste.

Partager le debug d'envoi Après un envoi en échec, l'application propose de partager un fichier debug_upload_XXXXXXXX.txt. Ce fichier contient le journal d'envoi sans données sensibles (les tokens sont masqués automatiquement). Partagez-le directement avec votre support technique.

✅ 9. Bonnes pratiques terrain

Envoyez régulièrement. Ne laissez pas s'accumuler des dizaines de dossiers en attente. Enviez à la fin de chaque intervention, ou au moins en fin de journée, de préférence en Wi-Fi.
Activez le GPS avant d'entrer sur site. Le GPS met quelques secondes à fixer sa position. Si vous déclenchez la caméra immédiatement après ouverture, les premières photos peuvent ne pas être géolocalisées. Accordez 10–15 secondes.
Vérifiez toujours le numéro de dossier avant de prendre la première photo. Un dossier mal saisi ne peut pas être renommé. Vous devrez déplacer manuellement les photos depuis la galerie.
Un dossier = un sinistre. Ne mélangez jamais plusieurs affaires dans un même dossier. Utilisez le bouton Nouveau dossier entre chaque mission.
En cas de doute sur un envoi, relancez. L'application détecte les fichiers déjà envoyés (statut « sent ») et les ignore lors des relances. Vous ne risquez pas d'envoyer en double.
Chargez votre téléphone avant une intervention longue. La caméra haute résolution, le GPS et la connexion réseau sollicitent la batterie. En dessous de 20 %, vous pouvez désactiver le GPS dans les paramètres pour économiser.
Préférez le Wi-Fi pour les envois volumineux. Si un dossier contient plus de 20 photos en qualité originale, passez en Wi-Fi pour éviter la consommation data et les timeouts 4G.
Activez le nettoyage automatique. Gardez l'option de nettoyage sur 30 jours. Cela évite de saturer le stockage interne sans effort de votre part.
Ne partagez pas vos identifiants SSO. Chaque connexion est nominative. Si vous changez de téléphone, déconnectez-vous d'abord sur l'ancien appareil.
Utilisez l'objectif grand-angle en intérieur. Dans les espaces restreints (caves, garages, couloirs), l'objectif grand-angle capture davantage de surface. Changez d'objectif depuis le sélecteur dans la vue caméra.