stations-service-naftomanager

byReal Pets

Crée une application SaaS moderne appelée « NaftoManager » pour la gestion des stations-service en Algérie. L’interface doit être entièrement en français, responsive et adaptée aux ordinateurs, tablettes et mobiles. OBJECTIF Permettre aux propriétaires et gérants de gérer une ou plusieurs stations-service : ventes de carburant, pompes, cuves, stocks, livraisons, fournisseurs, dépenses, caisses, employés, maintenance et rapports. DESIGN - Style professionnel, simple et facile à utiliser par un personnel non technique. - Couleurs : bleu foncé pour la navigation, jaune/orange pour les actions, vert pour les revenus et validations, rouge pour les alertes. - Mode clair et mode sombre. - Interface responsive. - Devise : DZD / DA. - Date : DD/MM/YYYY. - Prévoir les wilayas et communes d’Algérie. - Utiliser une navigation latérale, des cartes KPI, tableaux filtrables, graphiques et fenêtres modales. - Ajouter des états de chargement, erreurs, succès et écrans vides explicatifs. ARCHITECTURE SAAS - Application multi-tenant. - Une entreprise peut gérer plusieurs stations. - Isolation stricte des données entre entreprises. - Authentification sécurisée par email et mot de passe. - Gestion des rôles et permissions. - Journal d’audit pour les actions importantes. - Prévoir une architecture évolutive pour une future application mobile. RÔLES - Super administrateur : gestion de la plateforme, entreprises et abonnements. - Propriétaire : accès à toutes les stations, rapports, utilisateurs et paramètres. - Gérant : gestion opérationnelle d’une station. - Caissier : ventes, paiements et clôture de caisse. - Employé de piste : opérations liées aux pompes et signalement des problèmes. - Responsable stock : stocks, cuves, livraisons et ajustements. - Comptable : revenus, dépenses, factures et rapports financiers. PAGES PRINCIPALES 1. Connexion : email, mot de passe, mot de passe oublié. 2. Tableau de bord : chiffre d’affaires, litres vendus, transactions, stocks, dépenses, marges estimées et alertes. 3. Stations : liste, ajout, modification, adresse, localisation, statut et contacts. 4. Détail d’une station : pompes, cuves, employés, ventes, stocks, dépenses et activité. 5. Ventes : création, historique, filtres par période, produit, pompe et employé. 6. Pompes : compteur initial, compteur final, volume distribué, état et anomalies. 7. Cuves et stocks : capacité, niveau actuel, seuil minimum, entrées et sorties. 8. Fournisseurs : coordonnées, produits, livraisons et historique des achats. 9. Livraisons : fournisseur, produit, quantité, prix d’achat, date et document. 10. Dépenses : catégorie, montant, date, justificatif et commentaire. 11. Caisse : ouverture, mouvements, paiements, clôture et rapprochement. 12. Clients : particuliers, entreprises, historique et crédit éventuel. 13. Employés : utilisateurs, rôles, horaires, station et statut. 14. Maintenance : incidents, équipements, interventions, coûts et statut. 15. Rapports : ventes, stocks, dépenses, caisse, livraisons et performances. 16. Paramètres : entreprise, stations, produits, taxes, utilisateurs et permissions. 17. Abonnement : plan actuel, utilisateurs, stations, factures et renouvellement. CARBURANTS Inclure par défaut : - Essence sans plomb - Gasoil - GPL carburant Chaque produit doit contenir : - Nom et code - Prix de vente - Prix d’achat - Unité en litre - Stock minimum - Couleur - Statut actif/inactif Les prix doivent être configurables par station. Ne jamais coder les prix ou les taxes en dur. Les taxes doivent être configurables. VENTES Une vente doit contenir : - Station et pompe - Produit - Quantité en litres - Prix unitaire - Montant total en DA - Mode de paiement - Employé - Date et heure Modes de paiement : - Espèces - Carte bancaire - Paiement électronique - Crédit client, si activé Calculer automatiquement le montant total. Prévoir la validation, l’annulation, les corrections et un journal d’audit. STOCKS - Suivre les stocks par cuve et par produit. - Enregistrer automatiquement les entrées et sorties. - Afficher le stock actuel, la capacité, le pourcentage de remplissage, le seuil minimum et la dernière livraison. - Déclencher une alerte en cas de stock faible. - Autoriser les ajustements manuels avec motif obligatoire. - Afficher l’historique complet des mouvements. TABLEAU DE BORD Afficher : - Chiffre d’affaires du jour et du mois - Litres vendus - Nombre de transactions - Stock disponible - Produit le plus vendu - Meilleure station - Dépenses du mois - Marge estimée - Alertes de stock - Pompes hors service - Livraisons récentes Créer des graphiques pour : - Ventes par jour - Ventes par carburant - Évolution du chiffre d’affaires - Comparaison des stations - Dépenses par catégorie - Niveau des stocks RAPPORTS Ajouter des filtres par station, période, produit, pompe, employé et mode de paiement. Prévoir : - Rapport journalier des ventes - Rapport mensuel - Rapport de caisse - Rapport des stocks - Rapport des livraisons - Rapport des dépenses - Rapport de marge estimée - Rapport de performance par station Permettre l’export en PDF et Excel avec le logo, le nom de l’entreprise, la station, la période et la date de génération. CONTEXTE ALGÉRIEN Utiliser les champs suivants : - Wilaya - Commune - Adresse - Téléphone algérien - Numéro d’identification fiscale - Registre de commerce Afficher les montants en « DA ». Ne pas imposer un taux de TVA fixe. Prévoir des horaires d’ouverture configurables par station. L’interface initiale est en français LTR. NOTIFICATIONS Créer des notifications pour : - Stock faible - Livraison reçue - Pompe hors service - Dépense importante - Écart de caisse - Création d’utilisateur - Clôture de caisse réussie ou échouée ABONNEMENTS Prévoir trois plans : - Essentiel : une station, ventes, stocks et rapports de base. - Professionnel : plusieurs stations, employés, dépenses, maintenance et rapports avancés. - Entreprise : stations et utilisateurs illimités, permissions avancées, exports, API et support prioritaire. Afficher le plan actuel, les limites utilisées, la date de renouvellement, les factures et le changement de plan. BASE DE DONNÉES Créer les entités suivantes : Entreprises, stations, utilisateurs, rôles, permissions, pompes, cuves, produits, ventes, lignes de vente, mouvements de stock, fournisseurs, livraisons, dépenses, caisses, mouvements de caisse, clients, employés, incidents, interventions, notifications et journal d’audit. SÉCURITÉ - Hashage des mots de passe. - Gestion sécurisée des sessions. - Contrôle d’accès par rôle. - Protection contre l’accès aux données d’une autre entreprise. - Confirmation avant suppression. - Archivage lorsque nécessaire. - Sauvegardes régulières. - Variables d’environnement pour les données sensibles. - Ne jamais exposer de données sensibles dans le frontend. DONNÉES DE DÉMONSTRATION Créer des données réalistes pour une entreprise algérienne avec trois stations situées dans différentes wilayas, plusieurs pompes, cuves, ventes, livraisons, dépenses, employés et alertes de stock. CONTRAINTES TECHNIQUES - Séparer clairement frontend, backend et base de données. - Utiliser des composants réutilisables. - Ne pas utiliser de données statiques dans les écrans finaux. - Prévoir des API sécurisées. - Optimiser les tableaux pour un grand volume de données. - Ajouter recherche, filtres, pagination et tri. - Prévoir une future compatibilité RTL, mais garder l’interface initiale en français LTR. COMMENCER PAR 1. L’architecture fonctionnelle. 2. Le schéma de base de données. 3. La structure des pages. 4. Les parcours utilisateurs. 5. Les composants UI réutilisables. Ensuite, développer progressivement : authentification, tableau de bord, stations, pompes, carburants, ventes, stocks, livraisons, dépenses, rapports, utilisateurs et abonnements.