Workspace — gestionnaire

Le workspace (/admin/org) regroupe l'ensemble des outils d'administration d'une organisation. Les modules visibles dépendent des permissions du rôle.

Tableau de bord

Le tableau de bord synthétise l'activité :

Indicateur	Description
Cartes actives	Cartes totales / actives
Transactions	Volume et montant du jour
Produits	Nombre de produits, dont stock bas
Réservations	Réservations en attente

Deux actions rapides sont proposées : Recharger (vers les cartes) et Nouvelle vente (vers les transactions).

Cartes et titulaires

Cartes

Rechercher par code, numéro ou titulaire, filtrer par statut.
Créer une carte, attribuer/réattribuer, désactiver, marquer perdue, réactiver.
Exporter la liste et générer les QR codes / cartes formatées.

Création d'une carte : sélection d'un titulaire existant.

Créer une carte :

Touchez Nouvelle carte.
Sélectionner un titulaire (recherche par code, numéro ou nom).
Créer.

Titulaires

Consulter et modifier les titulaires.
Importer des élèves (avec parents associés) ou du personnel depuis un fichier Excel.
Gérer les liens parent-enfant.
Réinitialiser un mot de passe de titulaire.

Création d'un titulaire : prénom, nom, établissement, téléphone, email et type.

Import de titulaires depuis un fichier Excel.

Import Excel

Les imports de titulaires sont en multipart/form-data (fichier .xlsx), contrairement à l'import produits qui est en JSON.

Produits et stock

Produits

Créer/modifier/supprimer des produits, définir le prix, les jours disponibles et les délais de réservation.
Importer des produits en lot (JSON).
Exporter le catalogue.

Stock

Consulter l'historique des mouvements (achat, production, transfert, vente, rebut, correction).
Enregistrer un ajustement, un réapprovisionnement, une production ou un transfert.

Ventes et transactions

Transactions : liste filtrable et détail des ventes.

Rechercher et filtrer par type et par date.
Consulter le détail d'une transaction (articles, soldes avant/après).
Annuler ou modifier une vente selon les permissions.

Les actions Recharge, Achat, Correction et Remboursement ouvrent chacune un formulaire dédié :

Formulaire de recharge (espèces ou Mobile Money).

Formulaire d'achat (panier multi-articles).

Formulaire de correction (crédit/débit, motif).

Opérations agent

Opérations par agent : ventes et recharges du jour.

Le module « Opérations agent » présente, pour un agent donné et une date, le récapitulatif de ses ventes et recharges, avec les totaux de la journée.

Réservations

Suivre les réservations (pending, ready, collected, cancelled).
Ouvrir le détail et changer le statut.
Exporter les réservations.

Création d'une réservation : porteur, date et articles.

Menus

Le dashboard web ne comporte pas de module de gestion des menus. Les menus du jour se gèrent depuis l'application mobile (espace agent) ou via l'API (/admin/org/menus). Le dashboard permet de consulter les réservations qui en dépendent.

Sites, points de vente et caisses

Sites

Chaque site porte ses horaires et son fuseau. Les sites structurent les points de vente et les caisses.

Création d'un site : nom, code, adresse, ville, pays et contacts.

Points de vente

Créer un point de vente rattaché à un site.
Ouvrir/fermer un point de vente.

Création d'un point de vente : nom, code, site et type.

Caisses

Sessions de caisse du point de vente sélectionné.

Ouvrir/fermer une session de caisse.
Consulter l'arrêté : espèces attendues, comptées et écart.

Utilisateurs et rôles

Utilisateurs

Créer des comptes, assigner des rôles (éventuellement scoping par site).
Désactiver/réactiver, réinitialiser un mot de passe.

Création d'un utilisateur : login, nom, mot de passe et coordonnées.

Rôles

Lister les rôles (système et personnalisés) et leurs permissions.
Créer un rôle, assigner/retirer des permissions.

Rôles système

Les rôles système (gestionnaire, superviseur, caissier, vendeur, porteur) ne peuvent pas être modifiés ni supprimés. Créez des rôles personnalisés pour des besoins spécifiques.

Statistiques

Tableau de bord chiffré et séries par période.
Comparaisons de périodes via les endpoints analytics.
Export des statistiques.

Anomalies, logs et audit

Anomalies

Les anomalies (balance_low, stock_inconsistency, expired_product) sont générées par les jobs. L'écran permet de les filtrer, les acquitter et les résoudre.

Logs techniques

Journal d'audit

Notifications

Modèles de notification

Notifications programmées

Canaux

Seul l'email est réellement envoyé ; SMS et WhatsApp sont des stubs. Voir Configuration des notifications.

Support

Suivre les tickets, changer priorité/statut et assigner.
Répondre via la messagerie du ticket.

Paramètres

Le module Paramètres centralise : devise, fuseau, horaires, règles de réservation, plafonds, fonctionnalités parent-enfant, auto-clôture des caisses, rapports quotidiens et configuration des notifications.

Portée des paramètres

Les paramètres sont fusionnés côté serveur : seules les clés modifiées sont écrasées. La notification_config est, elle, remplacée en bloc.

Tableau de bord​

Cartes et titulaires​

Cartes​

Titulaires​

Produits et stock​

Produits​

Stock​

Ventes et transactions​

Opérations agent​

Réservations​

Sites, points de vente et caisses​

Sites​

Points de vente​

Caisses​

Utilisateurs et rôles​

Utilisateurs​

Rôles​

Statistiques​

Anomalies, logs et audit​

Anomalies​

Logs techniques​

Journal d'audit​

Notifications​

Modèles de notification​

Notifications programmées​

Support​

Paramètres​