--- stepsCompleted: ['step-01-init', 'step-02-discovery', 'step-03-success', 'step-04-journeys', 'step-05-domain', 'step-06-innovation', 'step-07-project-type', 'step-08-scoping', 'step-09-functional', 'step-10-nonfunctional', 'step-11-polish'] inputDocuments: ['product-brief-bmad-2026-02-09.md'] briefCount: 1 researchCount: 0 brainstormingCount: 0 projectDocsCount: 0 workflowType: 'prd' classification: projectType: web_app domain: general complexity: medium projectContext: greenfield --- # Product Requirements Document - dirCops **Application :** dirCops (suivi facturation / échéancier – Écloserie marine Gravelines) **Author:** Livinweb **Date:** 2026-02-09 ## Success Criteria ### User Success L'équipe commerciale utilise l'application pour le suivi facturation / échéancier / paiement sans dépendre d'une seule personne ; consultation et reporting en quelques clics ; plus d'usage d'Excel pour ce périmètre. Application simple et efficace (~20 k€). ### Business Success Une seule source de vérité pour trésorerie et direction ; moins d'erreurs de suivi et de décisions sur des données fausses ; temps gagné et possibilité d'expliquer un encours à un client de façon fiable. ### Technical Success Application web simple, stable, facile à maintenir. ### Measurable Outcomes - Utilisation effective par les commerciaux (suivi et reporting faits dans l'appli). - Fin de la dépendance à une seule personne pour « faire tourner » le suivi. - Réduction des erreurs / incohérences constatées par trésorerie et direction (qualitatif ou via feedback). ## Product Scope ### MVP - Minimum Viable Product **Core Features:** - Suivi des factures : liste par client, n° facture, n° vente, date, quantités, montants (ex. CA HT). - Suivi des paiements / échéancier : ce qui est payé, ce qui reste dû (encours), échéances. - Vue par client : synthèse par client (factures, paiements, encours). - Données métier spécifiques : au minimum encours, échéances ; couverture / indicateurs type Excel si possible dans la limite du budget. - Reporting simple : exports ou vues synthétiques (tableaux de bord basiques) pour commercial, trésorerie, direction. - Données centralisées, remplacement du classeur Excel pour ce périmètre. **In Scope (clarification):** - **Ajout manuel de factures pour le suivi** : la facturation (document facture, PDF, édition) provient de **Pennylane** ; dans l'appli, le commercial **ajoute à la main** les factures pour en assurer le suivi (n° facture, n° vente, date, type produit, cycle, quantités, quantité livrée, montant HT). - **Type de produit et cycle** : alevins, larves ; cycles (ex. 24-25, 25-26) pour le reporting. - **Quantité livrée** : suivi de la quantité déjà livrée par facture (QTE FACT / QTE LIVREE). - **Top clients par catégorie** : vues « Top clients alevins », « Top clients larves » (quantités + CA), filtrable par cycle. - **Quantités vendues par client** : synthèse par client des quantités facturées et livrées (avec répartition par type si besoin). - **Écheancier de paiement** : pour une facture, le commercial peut ajouter un écheancier avec facture associée, nombre d’échéances et date de début d’écheancier. - **Clients** : les libellés « client » désignent les **noms de clients** (ex. AQUANARIA, PHILOSOFISH, AQN). EMGI est un **lieu de départ**, pas un nom de client (cf. référentiel Excel EMGI_FTI_Suivi des Ventes). - **Tableau de bord** : encours par client (tri croissant), synthèse (encours total en k€, délai moyen de paiement en jours), colonnes optionnelles accord / j out / situation (à alimenter si les données existent). Export encours CSV et **export de l’ensemble des factures en pièce jointe** (fichier téléchargeable). **Out of Scope for MVP:** - Génération ou édition du **document** facture (PDF, impression) — gérée par **Pennylane**. - Gestion complète trésorerie (bancaire, prévisionnel détaillé). - Parcours dédiés complexes pour trésorerie / direction (priorité au besoin commercial). - Fonctionnalités « nice to have » qui feraient dépasser le cadre coût / simplicité. **MVP Success Criteria:** - L'équipe commerciale utilise l'appli pour ce suivi et n'utilise plus Excel pour ce périmètre. - Plus de dépendance à une seule personne ; trésorerie et direction s'appuient sur les mêmes données. ### Growth Features (Post-MVP) Non défini à ce stade — focus sur l'adoption du MVP d'abord. ### Vision (Future) Évolutions possibles après adoption : indicateurs métier supplémentaires, intégrations (ERP, compta), extensions vers d'autres processus — sans engagement dans le MVP. ## User Journeys ### Journey 1: Commercial consulte le suivi d'un client **Opening Scene :** Marie, commerciale, reçoit un appel client demandant l'état des factures et ce qui reste à payer. Actuellement, elle doit ouvrir Excel, naviguer entre plusieurs onglets, chercher le client, vérifier manuellement les paiements et calculer l'encours — avec risque d'erreur ou de données obsolètes. **Rising Action :** Avec la nouvelle application, Marie ouvre l'appli, tape le nom du client, et voit immédiatement : liste des factures (n°, date, montant, quantités), état des paiements, encours calculé automatiquement, échéances à venir. **Climax :** Pendant l'appel, Marie peut expliquer précisément l'état, confirmer les paiements, donner l'encours exact, et rassurer le client avec des données fiables partagées par toute l'équipe. **Resolution :** Plus besoin d'Excel pour ce suivi, plus de dépendance à une seule personne, données fiables et à jour, confiance restaurée avec le client. ### Journey 2: Commercial met à jour un paiement **Opening Scene :** Thomas apprend qu'un client a effectué un paiement. Actuellement, il doit ouvrir Excel, trouver la bonne feuille et ligne, mettre à jour manuellement avec risque de casser une formule. **Rising Action :** Thomas ouvre l'appli, sélectionne le client, voit les factures en attente, clique sur "Enregistrer un paiement", saisit le montant et la date. L'encours se met à jour automatiquement. **Climax :** En quelques clics, le paiement est enregistré et visible par toute l'équipe. Plus besoin de modifier Excel ou de dépendre d'une seule personne. **Resolution :** Mise à jour rapide et simple, données à jour pour toute l'équipe, plus d'erreurs de formules Excel. ### Journey 3: Commercial génère un reporting rapide **Opening Scene :** Sophie doit préparer un rapport pour la direction sur les encours clients. Actuellement, elle doit ouvrir plusieurs onglets Excel, copier-coller des données, faire des calculs manuels avec risque d'erreurs. **Rising Action :** Sophie ouvre l'appli, va dans "Reporting" ou "Tableaux de bord", voit une vue synthétique : encours par client, factures en attente, échéances à venir. Elle peut exporter ou faire une capture d'écran. **Climax :** En quelques clics, elle a une vue claire et à jour pour la direction, sans manipulation Excel. **Resolution :** Reporting rapide et fiable, données cohérentes avec trésorerie/direction, gain de temps. ## Web App Specific Requirements ### Project-Type Overview Application web classique (Multi-Page Application) pour usage interne de l'équipe commerciale. ### Technical Architecture Considerations **Architecture :** Multi-Page Application (MPA) - approche traditionnelle adaptée à une application interne. **Browser Support :** Navigateurs modernes (Chrome, Firefox, Edge) - pas de support nécessaire pour navigateurs anciens. **SEO Strategy :** Non applicable - application interne, pas d'indexation par les moteurs de recherche nécessaire. **Real-time Updates :** Non requis - rafraîchissement manuel suffit pour les besoins de suivi facturation/paiement. **Accessibility Level :** Basique - conformité WCAG niveau A suffisante pour usage interne. ### Browser Matrix - Chrome (dernières 2 versions) : Support complet - Firefox (dernières 2 versions) : Support complet - Edge (dernières 2 versions) : Support complet - Safari : Support basique si nécessaire - Navigateurs anciens : Non supportés ### Responsive Design Interface responsive pour usage sur desktop principalement, avec support basique tablette si nécessaire. Pas de priorité mobile-first. ### Performance Targets - Temps de chargement initial : < 3 secondes - Temps de réponse aux interactions : < 1 seconde ### Implementation Considerations - Stack technique simple et maintenable - Architecture permettant évolution future si besoin ## Functional Requirements ### Client Management - FR1: Commercial peut rechercher un client par nom - FR2: Commercial peut voir la vue détaillée d'un client (factures, paiements, encours sur une seule page) - FR2b: Commercial peut ajouter un client (depuis la liste clients) - FR2c: Commercial peut supprimer un client (avec confirmation ; cascade factures, paiements, écheanciers) ### Invoice Tracking - FR3: Commercial peut voir la liste des factures d'un client avec détails (n° facture, n° vente, date, type produit, cycle, quantités, quantité livrée, montants CA HT, état payé/en attente) - FR3b: Commercial peut ajouter manuellement une facture pour le suivi (saisie des données de suivi ; la facturation provient de Pennylane) - FR3c: Commercial peut modifier une facture existante (correction de saisie) - FR3d: Commercial peut supprimer une facture (avec confirmation ; cascade paiements et écheancier) ### Payment Management - FR4: Commercial peut enregistrer un paiement (montant, date) pour une facture - FR4b: Commercial peut ajouter un écheancier de paiement à une facture (facture associée, nombre d’échéances, date de début d’écheancier) - FR5: Commercial peut voir l'historique des paiements d'un client - FR5b: Commercial peut voir l’écheancier associé à une facture (nombre d’échéances, date de début) - FR5c: Commercial peut supprimer un paiement (avec confirmation) - FR5d: Commercial peut supprimer un écheancier (avec confirmation) ### Financial Calculations - FR6: Le système calcule automatiquement l'encours (montant restant dû) par client - FR7: Le système calcule automatiquement l'encours total - FR8: Le système affiche les échéances à venir (dates ≥ aujourd’hui) : pour les factures avec écheancier, dates et montants sont calculés à partir de l’écheancier (date début + N mois, montant par échéance) ; pour les factures sans écheancier, date de facture et encours - FR9: Le système met à jour automatiquement les calculs après enregistrement d'un paiement ### Reporting & Analytics - FR10: Commercial peut voir un tableau de bord synthétique (encours par client, factures en attente, échéances) - FR10b: Commercial peut voir les top clients par type de produit (alevins, larves) avec quantités et CA, filtrable par cycle - FR10c: Commercial peut voir la synthèse des quantités vendues par client (quantités facturées, quantités livrées), avec répartition par type si pertinent - FR11: Commercial peut exporter les données ### Data Management - FR12: Le système maintient une seule source de vérité centralisée pour toutes les données de suivi - FR13: Les données sont accessibles par toute l'équipe commerciale ## Non-Functional Requirements ### Security - NFR1: Accès restreint à l'équipe commerciale autorisée uniquement