listing-complet-ecrans-pages.md 13 KB

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) :

  1. Page login
  2. Liste clients (états : vide, rempli, recherche)
  3. Fiche client (sections factures, paiements, écheanciers)
  4. Tableau de bord (encours, échéances)

Priorité moyenne :

  1. Top clients (filtres + tableau)
  2. Quantités clients

Priorité basse :

  1. Pages d'erreur (404, 500)
  2. Modals (confirmation, succès)

Document de référence pour la conception et le développement. À compléter avec wireframes/maquettes si disponibles.