Listing complet des écrans et pages
Application : dirCops
Projet : Suivi facturation / échéancier / paiement (EMGI)
Date : 2026-02-09
Usage : Liste exhaustive de toutes les pages/écrans pour le chiffrage et la conception
Vue d'ensemble
Type d'application : Multi-Page Application (MPA)
Architecture : HTML + JS vanilla + Tailwind CSS + API REST PHP
Nombre total de pages MVP complet : 7 pages principales + 1 page login + états variés
1. Authentification
1.1 Page de login
Fichier : login.html
Route : /login.html ou / (si non authentifié)
Objectif : Authentification utilisateur via MODX Livinweb
Contenu :
- Formulaire login (identifiant + mot de passe)
- Bouton "Se connecter"
- Message d'erreur si échec
- Redirection vers
/index.html si succès
États :
- État nominal : formulaire vide
- État en cours : bouton disabled, loader
- État erreur : message "Identifiant ou mot de passe incorrect"
- État succès : redirection automatique
Interactions :
- POST
/api/auth.php (login)
- Stockage session PHP
- Redirection si déjà authentifié
Wireframe/Maquette : Page simple centrée, logo EMGI, champs texte, bouton
2. Pages principales (après authentification)
2.1 Liste des clients (accueil)
Fichier : index.html
Route : / ou /index.html
Objectif : Liste et recherche des clients
Contenu :
- Barre de navigation (menu principal + bouton "Déconnexion")
- Champ de recherche (nom client)
- Liste des clients (nom, bouton "Voir détail")
- Bouton "Ajouter un client" (formulaire modal ou nouvelle page)
- Bouton "Supprimer" (confirmation)
États :
- État nominal : liste de tous les clients
- État recherche : liste filtrée
- État vide : message "Aucun client trouvé" + bouton "Ajouter un client"
- État chargement : skeleton ou loader
- État erreur : message "Erreur de chargement" + bouton "Réessayer"
Interactions :
- GET
/api/clients.php (liste)
- GET
/api/clients.php?q=nom (recherche)
- POST
/api/clients.php (ajout client)
- DELETE
/api/clients.php?id= (suppression)
- Clic client → navigation vers
/client.html?id=
Formulaire "Ajouter un client" (modal ou section) :
- Champ : Nom du client (obligatoire)
- Bouton "Enregistrer" + "Annuler"
- Validation : nom non vide
2.2 Fiche client (détail)
Fichier : client.html
Route : /client.html?id={client_id}
Objectif : Vue complète d'un client (factures, paiements, écheanciers, encours)
Contenu (page longue, plusieurs sections) :
En-tête client
- Nom du client
- Encours total (calculé dynamique)
- Bouton "Retour à la liste"
Section "Factures"
- Tableau des factures :
- Colonnes : N° facture, N° vente, Date, Type produit, Cycle, Quantités, Qté livrée, Montant HT, Encours, État (Payé/En attente)
- Boutons par ligne : "Modifier", "Supprimer"
- Bouton "Ajouter une facture" → formulaire
Formulaire "Ajouter/Modifier une facture" :
- Champs :
- N° facture (obligatoire)
- N° vente (optionnel)
- Date facture (obligatoire, date picker)
- Type produit (select : alevins, larves, vide)
- Cycle (texte libre, ex: 24-25, 25-26)
- Quantités facturées (nombre décimal)
- Quantité livrée (nombre décimal)
- Montant HT (obligatoire, nombre décimal, €)
- Boutons : "Enregistrer", "Annuler"
- Validation : champs obligatoires, montant > 0
Section "Paiements"
- Tableau des paiements :
- Colonnes : Date paiement, Montant, Facture associée, Bouton "Supprimer"
- Bouton "Enregistrer un paiement" → formulaire
Formulaire "Enregistrer un paiement" :
- Champs :
- Facture (select : liste des factures du client avec n° et encours)
- Montant (obligatoire, nombre décimal, €)
- Date paiement (obligatoire, date picker)
- Boutons : "Enregistrer", "Annuler"
- Validation : facture sélectionnée, montant > 0, date valide
Section "Écheanciers"
- Tableau des écheanciers :
- Colonnes : Facture associée, Nb échéances, Date début, Montant par échéance, Bouton "Supprimer"
- (Optionnel) Détail échéances (dates calculées + montants)
- Bouton "Ajouter un écheancier" → formulaire
Formulaire "Ajouter un écheancier" :
- Champs :
- Facture (select : factures avec encours > 0 et sans écheancier)
- Nombre d'échéances (obligatoire, entier > 0)
- Date de début (obligatoire, date picker)
- Montant par échéance : calculé et affiché (encours / nb échéances)
- Boutons : "Enregistrer", "Annuler"
- Validation : facture éligible, nb échéances > 0, date valide
États :
- État nominal : sections remplies avec données
- État vide (aucune facture) : message "Aucune facture pour ce client" + bouton "Ajouter une facture"
- État vide (aucun paiement) : message "Aucun paiement enregistré"
- État vide (aucun écheancier) : message "Aucun écheancier"
- État chargement : skeleton
- État erreur : message d'erreur + bouton "Réessayer"
- État après action (ajout/modification/suppression) : rechargement de la page ou mise à jour dynamique + message succès
Interactions :
- GET
/api/clients.php?id= (détail client)
- GET
/api/factures.php?client_id= (factures + encours)
- GET
/api/paiements.php?client_id= (paiements)
- GET
/api/echeanciers.php?client_id= (écheanciers)
- GET
/api/calculs.php?client_id= (encours client)
- POST/PUT/DELETE
/api/factures.php
- POST/DELETE
/api/paiements.php
- POST/DELETE
/api/echeanciers.php
2.3 Tableau de bord
Fichier : dashboard.html
Route : /dashboard.html
Objectif : Vue synthétique des encours et échéances
Contenu :
Indicateurs en haut (cards)
- Encours total (k€)
- Délai moyen de paiement (jours) — optionnel MVP
- Nombre de factures en attente
Tableau "Encours par client"
- Colonnes : Client, Encours (€), (Optionnel : Accord, J out, Situation)
- Tri : par encours croissant (ou boutons tri)
- Filtres : (optionnel) afficher uniquement encours > 0
Tableau "Échéances à venir"
- Colonnes : Client, N° facture, Date échéance, Montant échéance
- Filtre : date ≥ aujourd'hui
- Tri : par date croissante
Boutons d'export
- "Exporter encours CSV" → téléchargement
encours-clients-YYYY-MM-DD.csv
- "Exporter l'ensemble des factures (PJ)" → téléchargement
suivi-factures-YYYY-MM-DD.csv
États :
- État nominal : données affichées
- État vide (aucun encours) : message "Aucun encours en attente"
- État vide (aucune échéance) : message "Aucune échéance à venir"
- État chargement : skeleton
- État erreur : message d'erreur
Interactions :
- GET
/api/reporting.php (données tableau de bord)
- GET
/api/reporting.php?format=csv (export encours)
- GET
/api/reporting.php?format=factures_csv (export factures PJ)
2.4 Top clients
Fichier : top-clients.html
Route : /top-clients.html
Objectif : Classement des clients par type de produit et cycle
Contenu :
Filtres en haut
- Type de produit (select : Tous, Alevins, Larves)
- Cycle (select : Tous, 24-25, 25-26, etc.)
- Bouton "Filtrer" ou filtrage automatique
Tableau "Top clients"
- Colonnes : Client, Type, Cycle, Quantités facturées, CA HT (€), % Quantités, % CA
- Tri : par quantités ou CA décroissant
- (Optionnel) Limite Top 10/15 ou affichage complet selon décision client
États :
- État nominal : tableau avec données
- État après filtre : tableau mis à jour
- État vide (aucun résultat) : message "Aucun client pour ces critères"
- État chargement : skeleton
- État erreur : message d'erreur
Interactions :
- GET
/api/top-clients.php?type=&cycle= (données filtrées)
2.5 Quantités par client
Fichier : quantites-clients.html
Route : /quantites-clients.html
Objectif : Synthèse des quantités facturées et livrées par client
Contenu :
Filtre en haut
- Type de produit (select : Tous, Alevins, Larves)
- Bouton "Filtrer" ou filtrage automatique
Tableau "Quantités par client"
- Colonnes : Client, Type (si filtre "Tous"), Quantités facturées, Quantités livrées, Écart (qté facturée - qté livrée), % Livré
- Tri : par client ou quantités
États :
- État nominal : tableau avec données
- État après filtre : tableau mis à jour
- État vide (aucun résultat) : message "Aucune donnée pour ces critères"
- État chargement : skeleton
- État erreur : message d'erreur
Interactions :
- GET
/api/quantites-clients.php?type= (données filtrées)
3. Navigation / Menu principal
Présent sur toutes les pages après authentification :
Menu horizontal (barre de navigation) :
- Logo / Titre : "dirCops"
- Liens de navigation :
- "Clients" →
/index.html
- "Tableau de bord" →
/dashboard.html
- "Top clients" →
/top-clients.html
- "Quantités" →
/quantites-clients.html
- Bouton "Déconnexion" (à droite) → POST
/api/auth.php?logout=1 → redirection /login.html
4. Pages d'erreur / états spéciaux
4.1 Page 404 (non trouvé)
Fichier : 404.html (optionnel, ou gestion navigateur)
Contenu : Message "Page non trouvée" + lien "Retour à l'accueil"
4.2 Page 403 (non autorisé)
Cas : Tentative d'accès à une page sans authentification
Comportement : Redirection automatique vers /login.html
4.3 Page erreur serveur (500)
Comportement : Message "Erreur serveur, veuillez réessayer plus tard" + bouton "Retour"
5. Modals / Composants réutilisables
5.1 Modal de confirmation (suppression)
Déclencheurs : Suppression client, facture, paiement, écheancier
Contenu :
- Titre : "Confirmer la suppression"
- Message : détail de ce qui sera supprimé (+ cascade si applicable)
- Ex : "Supprimer le client [Nom] ? Cela supprimera aussi toutes ses factures, paiements et écheanciers."
- Boutons : "Confirmer" (rouge/danger), "Annuler"
5.2 Toast / Message de succès
Déclencheurs : Action réussie (ajout, modification, suppression)
Contenu :
- Message court : "Client ajouté avec succès", "Paiement enregistré", etc.
- Fermeture automatique après 3-5 secondes ou bouton "×"
- Couleur : vert (succès), rouge (erreur), orange (avertissement)
5.3 Loader / Skeleton
Déclencheurs : Chargement de données (GET API)
Contenu :
- Spinner ou skeleton screen (simulation structure du contenu)
- Texte : "Chargement..." (optionnel)
6. Récapitulatif des pages
| # |
Page |
Fichier |
Route |
Authentification requise |
| 1 |
Login |
login.html |
/login.html |
Non |
| 2 |
Liste clients |
index.html |
/ ou /index.html |
Oui |
| 3 |
Fiche client |
client.html |
/client.html?id= |
Oui |
| 4 |
Tableau de bord |
dashboard.html |
/dashboard.html |
Oui |
| 5 |
Top clients |
top-clients.html |
/top-clients.html |
Oui |
| 6 |
Quantités clients |
quantites-clients.html |
/quantites-clients.html |
Oui |
| 7 |
Page 404 |
404.html |
(erreur) |
Non |
Total MVP complet : 7 pages + navigation + modals
7. Variantes par package (selon options-reduction-perimetre-chiffrage.md)
Package A – MVP minimal
Pages incluses :
- Login (1)
- Liste clients (2)
- Fiche client (3) — version simplifiée : factures (lecture seule), paiements (ajout uniquement), pas d'écheanciers
- Tableau de bord (4) — version simplifiée : encours par client, export CSV encours uniquement
Pages exclues :
- Top clients (5)
- Quantités clients (6)
Total : 4 pages + navigation
Package B – MVP sans écheancier ni pages reporting
Pages incluses :
- Login (1)
- Liste clients (2) — avec ajout/suppression client
- Fiche client (3) — factures (ajout/modification/suppression), paiements (ajout/suppression), pas d'écheanciers
- Tableau de bord (4) — complet avec export
Pages exclues :
- Top clients (5)
- Quantités clients (6)
Total : 4 pages + navigation
Package C – MVP complet
Pages incluses : Toutes (1-6) + navigation + modals
Total : 7 pages + navigation
8. Wireframes / Maquettes recommandés
Priorité haute (à créer pour validation client) :
- Page login
- Liste clients (états : vide, rempli, recherche)
- Fiche client (sections factures, paiements, écheanciers)
- Tableau de bord (encours, échéances)
Priorité moyenne :
- Top clients (filtres + tableau)
- Quantités clients
Priorité basse :
- Pages d'erreur (404, 500)
- Modals (confirmation, succès)
Document de référence pour la conception et le développement. À compléter avec wireframes/maquettes si disponibles.