Profile and system

These screens hold the délégué's account and the app's own health: the inbox and the supervisor's messages, the profile and zone, the settings with the location transparency page, the sync centre that makes the offline queue visible (cahier §7.3 « L'utilisateur voit l'état : synchronisé, en attente ou en erreur »), and the system states that can interrupt any screen.

DA-23 — Messages & notificationsCopy Anchor Link

Purpose. One inbox for the notifications the delegate receives (tours, follow-ups, invitations, orders, account validations) and the announcements sent by the back-office (Messages) (cahier §6 « Voir les objectifs du jour et les notifications », §6.1 « Accéder aux prospects, rapports et messages »; NOT-01, NOT-07).

Entry points & exits. Entry: bell of every tab root, quick access Messages on DA-05, Notifications on DA-24, push announcement.published (/messages/:announcementId). Exits: the target route of each notification (deep links), announcement detail.

Layout.

1. App bar « Messages », overflow « Tout marquer comme lu ».
2. Tabs Notifications (3) · Messages (1).
3. Notification rows: category icon, title, body (2 lines), relative time, unread dot; grouped Aujourd'hui, Hier, Plus ancien.
4. Message rows: sender (« Direction commerciale »), title, excerpt, date, unread dot; detail page with the full text, attachments and « J'ai lu ».

Data.

Actions. Tap a notification → mark read and open its route; notifications.markRead queued (idempotent by nature, sent with an Idempotency-Key). Tout marquer comme lu → notifications.markAllRead. Open a message → « J'ai lu » → announcements.markRead queued.

Rules. Only the delegate's own notifications and the announcements targeted to them. A notification whose target is gone or out of scope opens Home with « Élément introuvable ou retiré de votre périmètre ». Transactional and security notifications cannot be disabled (DA-26).

States. Empty (« Aucune notification » / « Aucun message ») · offline (cached, marking read queued) · loading (skeleton rows).

Copy. « Messages » · « Notifications » · « Tout marquer comme lu » · « J'ai lu » · « Aujourd'hui » · « Hier » · « Aucune notification ».

Acceptance criteria.

1. A message sent from the back-office (BO-57) reaches the delegate as a push and appears under Messages; « J'ai lu » is visible in the back-office.
2. Tapping a tour.updated notification opens the updated tour.
3. The bell badge equals the number of unread notifications and messages, offline included.

DA-24 — Profile hubCopy Anchor Link

Purpose. Show who the delegate is and what they cover — status, zone, wilayas, today's objective, unread notifications — and give access to their information, zone, objectives, notifications, settings, the sync centre and sign-out (cahier §6, FLD-01).

Entry points & exits. Entry: Compte tab. Exits: Mes informations (sub-page), DA-25, DA-22, DA-23, DA-27, DA-26, DA-02 after sign-out.

Layout.

1. Aperçu du profil card — avatar, name, « Délégué commercial », AccountStatus pill (« Actif »), then rows Zone attribuée (Oran), Wilayas couvertes (Oran, Aïn Témouchent, Mascara), Objectifs du jour (« 12 visites prévues »), Notifications (« 3 non lues »).
2. Menu (56 dp rows with chevrons) — Mes informations · Ma zone · Mes objectifs · Notifications (badge) · Synchronisation (state: « À jour », « 3 en attente », red « 1 erreur ») · Paramètres · Aide (« Appeler mon responsable », support contacts).
3. Se déconnecter (destructive text button), version line.
4. Mes informations (sub-page) — name, phone, email, delegate code (DLG-007), supervisor with a call button, « Depuis le 12 oct. 2026 »; « Modifier la photo » (me.update avatarFileId); « Changer le mot de passe » (auth.password.change); « Appareils connectés » (auth.sessions.list, revoke with auth.sessions.revoke).

Data.

Actions.

• Se déconnecter → if the outbox, upload queue or ping queue is not empty: dialog « 5 éléments ne sont pas encore synchronisés. Synchronisez avant de vous déconnecter. » with « Synchroniser » and a destructive « Se déconnecter et supprimer ces données » (second confirmation typing SUPPRIMER). Otherwise « Se déconnecter ? » → auth.logout (revokes the session and the push token) when online; the local database, photos and secure storage are wiped; sampling stops; → DA-02 with the phone prefilled.
• Password change: current + new + confirmation; other sessions revoked by the server; snackbar « Mot de passe modifié ».

Rules. The delegate cannot change their zone, code or status (back-office BO-18). Sign-out while a tour is IN_PROGRESS warns « Votre tournée est en cours : la localisation sera arrêtée. »

States. Offline (cached profile; password change and sessions unavailable) · avatar upload failing (retry).

Copy. « Aperçu du profil » · « Délégué commercial » · « Zone attribuée » · « Wilayas couvertes » · « Objectifs du jour » · « Mes informations » · « Ma zone » · « Mes objectifs » · « Synchronisation » · « Paramètres » · « Aide » · « Se déconnecter » · « Changer le mot de passe » · « Appareils connectés ».

Acceptance criteria.

1. The card shows the zone and wilayas configured in the back-office for the delegate.
2. Sign-out with pending items is refused unless the destructive path is confirmed; nothing is lost silently.
3. After sign-out, no data of the delegate remains readable on the phone.

DA-25 — My zoneCopy Anchor Link

Purpose. Show the zones, wilayas and communes the delegate covers, with the number of points of sale, prospects and active resellers per commune, to organise trips (cahier §6 « Consulter le profil et la zone attribuée »; GEO-02, FLD-01).

Entry points & exits. Entry: Ma zone on DA-24. Exit: DA-13 filtered by the chosen commune.

Layout. Map fitted to the zone bounds with commune markers sized by count; below, per zone (primary first) and wilaya, the communes with Total · Prospects · Revendeurs · Actifs · Non assignés.

Data.

Actions. Tap a commune → DA-13 with the commune filter. Read-only.

Rules. Counts cover only the delegate's scope. Zone geometry is a viewport hint, not a boundary drawn to the metre.

States. Offline (cached) · loading (skeleton) · no zone assigned (« Aucune zone ne vous est attribuée. Contactez votre responsable. »).

Copy. « Ma zone » · « Prospects » · « Revendeurs » · « Actifs » · « Non assignés ».

Acceptance criteria.

1. The communes listed equal the zone configured on BO-19.
2. Tapping a commune opens the prospects list filtered on it with the same count.

DA-26 — SettingsCopy Anchor Link

Purpose. Let the delegate set what they are allowed to set — language, notification preferences, photo upload on mobile data — and see, transparently, what the app records about their location (cahier §6 « Gérer les paramètres autorisés », §10; NOT-06, FLD-15).

Entry points & exits. Entry: Paramètres on DA-24; the location chip's explanation sheet; DA-28 states. Exits: DA-04 (« Revoir le consentement »), Android settings.

Layout.

1. Langue — Français; العربية and English listed as « Bientôt disponible » until settings.i18n.enabledLocales enables them.
2. Notifications — one switch per category: Commandes et compte and Sécurité (locked on), Activité terrain, Annonces; Android notification permission state with « Ouvrir les réglages ».
3. Localisation et transparence — status (« Autorisée — position exacte »), consent date and version, what is recorded, when, how often (« toutes les 5 min ou tous les 200 m pendant une tournée en cours »), retention (« 90 jours »), who sees it; « Politique de confidentialité »; « Revoir le consentement »; « Retirer mon consentement » (destructive).
4. Photos — « Envoyer les photos uniquement en Wi-Fi » (off by default; a warning explains it can delay the closing).
5. Stockage — space used by photos and data; « Libérer de l'espace » (deletes only synced photo files older than 7 days).
6. À propos — version, « Rechercher une mise à jour », device id (for support).

Data.

Actions. Language → me.update locale and immediate UI switch. Preference switch → notifications.preferences.update (online; offline the switch is disabled with « Connexion requise »). Retirer mon consentement → confirmation « La localisation sera arrêtée et vous ne pourrez plus démarrer de tournée ni enregistrer vos arrivées. » → me.update consents.locationTracking.accepted = false queued; sampling stops immediately.

Rules. Transactional and security notifications cannot be disabled. Transparency values come from the settings, never hard-coded. Withdrawing consent while a tour is IN_PROGRESS stops sampling but does not suspend the tour.

States. Offline (preferences read-only) · permission denied (status line in danger tone with « Ouvrir les réglages »).

Copy. « Paramètres » · « Langue » · « Notifications » · « Localisation et transparence » · « Revoir le consentement » · « Retirer mon consentement » · « Envoyer les photos uniquement en Wi-Fi » · « Libérer de l'espace » · « Rechercher une mise à jour ».

Acceptance criteria.

1. The transparency page shows the sampling frequency, distance and retention configured in the back-office.
2. Withdrawing consent stops location pings within one interval and disables « Commencer la tournée ».
3. The Commandes et compte and Sécurité switches cannot be turned off.

DA-27 — Sync centreCopy Anchor Link

Purpose. Make the offline queue visible and controllable: what is waiting, what failed and why, what the delegate must do, and how fresh the data on the phone is — so nothing recorded in the field is lost or silently duplicated (cahier §7.3, SYN-05, SYN-06).

Entry points & exits. Entry: the global sync indicator of every tab root, Synchronisation on DA-24, error badges, the blocking items of DA-20, the 48-hour local notification (/sync). Exits: the record behind an item (DA-10, DA-09, DA-15…), back.

Layout (top to bottom).

1. App bar — « Synchronisation ».
2. Status header — large icon and one of: « Tout est synchronisé » (success) · « 3 éléments en attente » (info) · « 1 erreur à traiter » (danger) · « Hors ligne depuis 10:12 — 5 éléments en attente » (neutral) · « Synchronisation en cours… 12 / 20 » (progress). Sub-lines « Envoi : il y a 2 min » and « Réception : il y a 5 min ».
3. Age warning (when the oldest pending item is 48 h old) — « Des données attendent depuis 2 jours. Elles seront refusées après 72 h : connectez-vous dès que possible. »
4. Primary button « Synchroniser maintenant » (disabled offline, with « Connexion requise »).
5. À traiter (errors, red section) — one card per item in error: icon, label, subject, time of the action, the server message, what to do, and the actions of the table below.
6. En attente — ordered list (oldest first): type icon, label (table below), subject (store name), action time, state (« En attente », « Envoi… », « Nouvel essai à 10:45 », « Bloqué par : Nouveau revendeur — Magasin X »), attempts.
7. Photos — per file: thumbnail, size (« 1,2 Mo »), progress bar, state; « 12 photos · 18,4 Mo ».
8. Positions — « 14 positions en attente » (one line, no detail).
9. Données reçues — freshness per scope: Tournée du jour (07:42), Points de vente (07:40), Relances (07:40), Listes de référence (hier), Catalogue (hier); « Tout recharger » (only when nothing is pending).
10. Diagnostic — app version, device id, last cursor time, clock offset (« Horloge du téléphone : +3 s »); « Envoyer un diagnostic » (logs and queue metadata — never the content of reports or photos — to Sentry with a reference given to support).

Item labels.

Data.

Value	UI label (fr)	Meaning
APPLIED	Synchronisé
REPLAYED	Déjà synchronisé	Same Idempotency-Key seen before; original result returned.
CONFLICT	Conflit	State changed on the server; the client must show it in the sync centre.
REJECTED	Rejeté	Validation or permission error; never retried automatically.
RETRY	À réessayer	Transient server error; retried with backoff.

Actions.

• Synchroniser maintenant → uploads first, then sync.batch in batches of 50 (new batch Idempotency-Key per request, items keep theirs), then sync.locationPings, then sync.delta for every scope; progress in the header.
• Réessayer maintenant (item waiting for a retry) → resends with the same key.
• Corriger (rejected item that the delegate can fix: duplicate phone, invalid field) → opens the record (DA-15 for a reseller, DA-12 for a report); saving rebuilds the item with the corrected body and a new key; dependants are released after it is applied.
• Réessayer (rejected item whose cause was external, e.g. scope restored by the back-office) → new key, same body.
• Garder la version du serveur (conflict) → drops the local item, reloads the record from the server, and drops dependants that no longer make sense (with a summary of what was discarded).
• Réappliquer ma modification (conflict on an editable record: reseller fields, checklist, note, report before lock) → new item on the current server version, new key.
• Abandonner (any error) → destructive confirmation « Cette action sera définitivement perdue. »; the local change is reverted to the server state.
• Contacter mon responsable (errors only the back-office can settle: OCCURRED_AT_OUT_OF_RANGE, check-in refused after replay, tour cancelled) → call the supervisor; the item stays until resolved or abandoned.
• Libérer / Tout recharger / Envoyer un diagnostic as described in the layout.

Rules.

• Automatic sync triggers: network regained, app foreground, 2 s after any recorded action, every 5 min in the foreground while online, every 15 min in the background (WorkManager) while a tour is IN_PROGRESS or items are pending, and on push data messages.
• Order and dependencies as on the overview; an item never jumps ahead of an earlier item of the same record.
• Results: APPLIED and REPLAYED remove the item (a replay proves the server already had it — never a duplicate); RETRY backs off 5 s, 10 s, 20 s… up to 10 min (±20 % jitter); REJECTED is never retried automatically; CONFLICT waits for a decision.
• What the delegate sees for each conflict family:

• The detailed protocol (batch format, cursors, conflict codes) is owned by the sync API and offline sync; this screen only displays it.
• Nothing is deleted from the phone without either a server acknowledgement or an explicit Abandonner by the delegate.

States.

Copy. « Synchronisation » · « Tout est synchronisé » · « éléments en attente » · « erreur à traiter » · « Hors ligne depuis » · « Synchroniser maintenant » · « À traiter » · « En attente » · « Nouvel essai à » · « Bloqué par » · « Corriger » · « Réessayer » · « Garder la version du serveur » · « Réappliquer ma modification » · « Abandonner » · « Contacter mon responsable » · « Données reçues » · « Envoyer un diagnostic ».

Acceptance criteria.

1. In airplane mode, a check-in, a photo and a note show three items « En attente » plus one photo; the global indicator shows « 3 en attente ».
2. When the network returns, the items are sent in order without any action, disappear one by one, and the server holds exactly one record per action; replaying the same batch returns REPLAYED for every item (cahier §12 Hors ligne).
3. A prospect with a duplicate phone appears under À traiter with Corriger; its photo item shows « Bloqué par » until the correction is applied.
4. An item pending for 48 h triggers the warning banner and a local notification.
5. « Synchroniser maintenant » is disabled offline and explains why.
6. Abandonner asks for confirmation and restores the server state of the record.

DA-28 — System statesCopy Anchor Link

Purpose. Define once how the app behaves when the network, the GPS, a permission, the version policy, the session, the clock or the storage gets in the way — so every screen reacts the same way and the delegate always knows what to do (SYN-06, FLD-07, ADM-07).

Entry points & exits. Raised by any screen or by the background services; each state names its exit below.

Rules.

• Offline is a normal state, not an error: no red, no blocking dialog; only actions that truly need the network are disabled, each with its reason.
• Blocking full-screen states are limited to forced update, suspended account and start-up error.
• Banners stack in order of severity and never hide the primary action of the screen.
• Every state is reachable in the widget gallery of MOB-04 for design QA (DQA-03).

Acceptance criteria.

1. Turning the network off on any screen shows the offline banner within 10 s and every offline-capable action keeps working.
2. With minVersion above the installed version the forced-update screen blocks the app, and the queued items are sent after updating.
3. With the phone clock set 15 min ahead, the wrong-clock banner appears and queued actions are not refused by the server.
4. A sampler stopped by the system during a tour is reported to the delegate on the next resume.
5. Every state above has a French message that tells the delegate what to do.