Document fonctionnel de référence pour les parcours de l’application. Les schémas détaillés, cas limites et références techniques restent dans
docs/workflows/.
| Rôle | Périmètre |
|---|---|
| Visiteur | Site public, demande d’expédition, suivi réduit, blog et contact. |
| Client | Pas de compte authentifié à ce jour ; suivi avec une référence publique. |
| Opérateur | Clients, commandes, conteneurs, inventaire, suivi, QR et contenu autorisé. |
| Administrateur | Tous les droits opérateur, plus collaborateurs, messages et analyses. |
| Administrateur technique | Données de démonstration et opérations d’exploitation contrôlées. |
- Les rôles sont contrôlés côté serveur ; une action masquée dans l’interface n’est jamais une autorisation.
- Les mutations métier doivent laisser une trace dans l’audit lorsqu’il est disponible ; une notification en erreur ne doit pas annuler une opération métier réussie.
- Les parcours publics ne retournent que les données nécessaires ; données personnelles, financières et secrets restent internes.
- Les procédures et vidéos utilisent un environnement de démonstration et des données fictives.
Acteurs : opérateur, administrateur.
- Le collaborateur se connecte sur
/admin/login. - NextAuth/Supabase Auth vérifie ses identifiants, puis l’application vérifie rôle et activation dans
employees. - Une session JWT est créée pour un compte actif cohérent ; le proxy et les routes API appliquent ensuite ses droits.
- La réinitialisation de mot de passe requiert une session de récupération Supabase.
Résultat attendu : accès au back-office correspondant au rôle, ou refus indifférencié.
Détail : 01 — Connexion et rôles.
Acteurs : opérateur, administrateur.
- À Bruxelles, l’équipe accueille le client, aide au déchargement et renseigne le formulaire ; elle conditionne les colis et confirme les informations d’envoi.
- Elle calcule puis valide le tarif, crée ou retrouve le client, enregistre la commande et imprime l’étiquette QR. La commande reçoit un numéro, un statut initial et peut être associée à un conteneur pour le fret maritime.
- Elle explique le suivi, transmet le numéro de colis et clôture la réception. Un problème est signalé au responsable et reste suivi jusqu’à résolution.
- Les règlements sont enregistrés au niveau client et la progression est calculée à partir des commandes et paiements ; la fiche client permet d’émettre une facture PDF et une facture récapitulative.
Résultat attendu : commande rattachée à son client, son conteneur éventuel et ses documents.
Détail : 02 — Client, commande et règlement.
Acteurs : opérateur, administrateur.
- L’équipe crée ou modifie le conteneur (code, navire, ports, ETD/ETA et statut).
- Les commandes de fret maritime et les articles d’inventaire peuvent y être associés.
- Un changement de statut inscrit un événement dans le suivi des commandes liées et tente une notification e-mail.
- Depuis la carte du conteneur, les exports Excel et Word produisent une entrée par commande/colis avec données client, destinataire et fret.
Résultat attendu : un conteneur rassemble les opérations, le suivi, les notifications et la liste exportable de ses colis.
Détail : 03 — Conteneur et changement de statut.
Acteurs : visiteur, opérateur, administrateur.
- Le visiteur recherche une référence, un QR ou un code conteneur et consulte le suivi réduit.
- L’équipe ajoute un événement avec statut, lieu, note, opérateur et date.
- Le scan QR résout une commande, peut en modifier le statut et ajoute un événement de suivi.
- L’étiquette imprimable associe le QR à la commande et à ses informations opérationnelles.
Résultat attendu : le suivi est consultable sans exposer les coordonnées ou données financières.
Détail : 04 — Suivi, QR et accès public.
Acteurs : visiteur, équipe interne.
- Le visiteur sélectionne prestations/articles et renseigne client, expédition et destinataire.
- L’API valide les données, crée un client et une commande
pending. - Une confirmation e-mail est tentée lorsque l’adresse est disponible ; elle ne bloque pas la création.
- L’équipe reprend ensuite la demande dans le back-office.
Résultat attendu : demande publique transformée en client et commande, sans compte client connecté.
Détail : 05 — Inscription et parcours public.
Acteurs : opérateur, administrateur.
- L’équipe recherche, crée ou modifie un article (
colis,vehicule,marchandise). - Elle renseigne statut, emplacement, poids, dimensions, valeur et conteneur éventuel.
- La suppression est actuellement physique : ses impacts doivent être confirmés avant utilisation.
Résultat attendu : inventaire localisable et associé au conteneur quand nécessaire.
Détail : 06 — Inventaire et suppression.
Acteurs : administrateur ; opérateur pour le contenu autorisé.
- L’administrateur gère comptes, rôles, activation et activités des collaborateurs.
- Il prévisualise et envoie des campagnes SMS/WhatsApp par client, conteneur, ville ou ensemble de clients, avec contrôle du consentement.
- Administrateur et opérateur gèrent les contenus Puck et historiques selon leurs droits ; les révisions protègent les articles Puck.
Résultat attendu : accès internes, communications et contenus administrés avec droits cohérents.
Détail : 07 — Collaborateurs, messagerie et blog.
Acteurs : administrateur, administrateur technique.
- L’administrateur choisit une période et consulte volumes, montants, statuts, services et tendances de commandes.
- Il exporte les données chargées au format CSV/PDF ; les exports de conteneur sont disponibles dans le workflow dédié.
- Les mutations métier alimentent l’audit lorsque disponible.
- Les routes de seed/reseed sont réservées à un environnement de démonstration explicitement validé.
Résultat attendu : pilotage de l’activité sans utiliser de données de production pour les démonstrations.
Détail : 08 — Analyses, exports et démonstration.
- Vérifier le rôle requis, les prérequis et le résultat métier de chaque scénario.
- Tester succès, données manquantes, droits insuffisants et échecs externes pertinents.
- Réaliser la recette sur données fictives, puis capturer les écrans et enregistrer la vidéo associée.
- Suivre les améliorations et critères de clôture dans la roadmap unique.