How madiou/gestion-commerciale-gn works
Gestion Commerciale is a browser-based, multi-shop business management app for small retailers in Guinea. The main workflow is account sign-in or shop creation, followed by live shop-data synchronization and navigation through sales, purchasing, inventory, customer, supplier, production, finance, and reporting tasks. Firebase provides authentication and Firestore; the shell coordinates views, while shared state and business rules support them. The README documents these major capabilities. Relationships below are limited to the excerpts, SOURCE INDEX references, and README; unsampled view-to-view or database interactions are not inferred.
Main entry points: app-shell.js App shell · auth.js Session and sync · view-login.js Sign-in and signup · view-utilisateurs.js User management
Components 31
Access and shell
- Sign-in and signup
public/js/view-login.js - Session and sync
public/js/auth.js - App shell
public/js/app-shell.js
Shop operations
- Sales
public/js/view-vente.js - Purchases
public/js/view-achat.js - Stock and products
public/js/view-stock.js - Customers
public/js/view-clients.js - Suppliers
public/js/view-fournisseurs.js - Production
public/js/view-production.js - Finance
public/js/view-finance.js - Reports
public/js/view-rapports.js - Dashboard
public/js/view-dashboard.js - Activity journal
public/js/view-journal.js
Administration
- Shop administration
public/js/view-admin.js - User management
public/js/view-utilisateurs.js - Admin overview
public/js/view-admin-apercu.js - Connection history
public/js/view-connexions.js - Admin journal
public/js/view-journal-admin.js - Shop settings
public/js/view-parametres.js - Audit view
public/js/view-audit.js
Shared services
- Business rules
public/js/business-logic.js - Shared shop state
public/js/state.js - Translations
public/js/i18n.js - UI and date helpers
public/js/helpers.js - Secure confirmation
public/js/confirmation-securisee.js - Error monitoring
public/js/monitoring.js
Firebase platform
- Firebase setup
public/js/firebase-config.js - Firebase Authentication
- Cloud Firestore
Other components
- Shop user
- Sentry
Connections 44
- Shop user → Sign-in and signup: signs in
README.md - Sign-in and signup → Firebase Authentication: authenticates
public/js/view-login.js - Sign-in and signup → Cloud Firestore: creates shop
public/js/view-login.js - Session and sync → Firebase Authentication: observes session
public/js/auth.js - Session and sync → Cloud Firestore: subscribes shop data
public/js/auth.js - Session and sync → App shell: renders
public/js/auth.js - Session and sync → Error monitoring: sets user
public/js/auth.js - App shell → Sign-in and signup: renders
public/js/app-shell.js - App shell → Sales: routes view
public/js/app-shell.js - App shell → Purchases: routes view
public/js/app-shell.js - App shell → Stock and products: routes view
public/js/app-shell.js - App shell → Customers: routes view
public/js/app-shell.js - App shell → Suppliers: routes view
public/js/app-shell.js - App shell → Production: routes view
public/js/app-shell.js - App shell → Finance: routes view
public/js/app-shell.js - App shell → Reports: routes view
public/js/app-shell.js - App shell → Dashboard: routes view
public/js/app-shell.js - App shell → Activity journal: routes view
public/js/app-shell.js - App shell → Shop administration: routes view
public/js/app-shell.js - App shell → User management: routes view
public/js/app-shell.js - App shell → Admin overview: routes view
public/js/app-shell.js - App shell → Connection history: routes view
public/js/app-shell.js - App shell → Admin journal: routes view
public/js/app-shell.js - App shell → Shop settings: routes view
public/js/app-shell.js - App shell → Audit view: routes view
public/js/app-shell.js - Stock and products → Cloud Firestore: writes batches
public/js/view-stock.js - User management → Firebase Authentication: creates account
public/js/view-utilisateurs.js - User management → Cloud Firestore: stores membership
public/js/view-utilisateurs.js - Customers → Business rules: uses credit and CSV rules
public/js/view-clients.js - Shop administration → User management: imports user actions
public/js/view-admin.js - Shop administration → Secure confirmation: uses confirmation
public/js/view-admin.js - Customers → Secure confirmation: uses confirmation
public/js/view-clients.js - Suppliers → Secure confirmation: uses confirmation
public/js/view-fournisseurs.js - App shell → Shared shop state: reads limits
public/js/app-shell.js - App shell → Translations: uses translations
public/js/app-shell.js - App shell → UI and date helpers: uses formatting
public/js/app-shell.js - Session and sync → Business rules: checks trial and duration
public/js/auth.js - Business rules → Shared shop state: reads plan limits
public/js/business-logic.js - Business rules → Translations: uses translations
public/js/business-logic.js - Firebase setup → Firebase Authentication: initializes
public/js/firebase-config.js - Firebase setup → Cloud Firestore: initializes
public/js/firebase-config.js - Secure confirmation → Firebase Authentication: reauthenticates
public/js/confirmation-securisee.js - Session and sync → Cloud Firestore: writes connection records
public/js/auth.js - Error monitoring → Sentry: reports errors