# 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 :** 5. Top clients (filtres + tableau) 6. Quantités clients **Priorité basse :** 7. Pages d'erreur (404, 500) 8. Modals (confirmation, succès) --- *Document de référence pour la conception et le développement. À compléter avec wireframes/maquettes si disponibles.*