# madiou/gestion-commerciale-gn architecture

> Architecture diagram of the GitHub repository madiou/gestion-commerciale-gn, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-03). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/madiou/gestion-commerciale-gn
- Repository: https://github.com/madiou/gestion-commerciale-gn

## Overview

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: [`public/js/app-shell.js`](https://github.com/madiou/gestion-commerciale-gn/blob/main/public/js/app-shell.js) (App shell), [`public/js/auth.js`](https://github.com/madiou/gestion-commerciale-gn/blob/main/public/js/auth.js) (Session and sync), [`public/js/view-login.js`](https://github.com/madiou/gestion-commerciale-gn/blob/main/public/js/view-login.js) (Sign-in and signup), [`public/js/view-utilisateurs.js`](https://github.com/madiou/gestion-commerciale-gn/blob/main/public/js/view-utilisateurs.js) (User management)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Access and shell"]
  node_login["Sign-in and signup<br/>[view-login.js]"]
  node_auth["Session and sync<br/>[auth.js]"]
  node_shell["App shell<br/>[app-shell.js]"]
end

subgraph group_operations["Shop operations"]
  node_sales["Sales<br/>[view-vente.js]"]
  node_purchases["Purchases<br/>[view-achat.js]"]
  node_inventory["Stock and products<br/>[view-stock.js]"]
  node_customers["Customers<br/>[view-clients.js]"]
  node_suppliers["Suppliers"]
  node_production["Production<br/>[view-production.js]"]
  node_finance["Finance<br/>[view-finance.js]"]
  node_reports["Reports<br/>[view-rapports.js]"]
  node_dashboard["Dashboard<br/>[view-dashboard.js]"]
  node_journal["Activity journal<br/>[view-journal.js]"]
end

subgraph group_admin["Administration"]
  node_admin["Shop administration<br/>[view-admin.js]"]
  node_users["User management"]
  node_adminoverview["Admin overview"]
  node_connections["Connection history<br/>[view-connexions.js]"]
  node_adminjournal["Admin journal"]
  node_settings["Shop settings<br/>[view-parametres.js]"]
  node_audit["Audit view<br/>[view-audit.js]"]
end

subgraph group_shared["Shared services"]
  node_business["Business rules<br/>[business-logic.js]"]
  node_state["Shared shop state<br/>[state.js]"]
  node_i18n["Translations<br/>[i18n.js]"]
  node_helpers["UI and date helpers<br/>[helpers.js]"]
  node_confirm["Secure confirmation"]
  node_monitoring["Error monitoring<br/>[monitoring.js]"]
end

subgraph group_platform["Firebase platform"]
  node_firebaseconfig["Firebase setup<br/>[firebase-config.js]"]
  node_authservice["Firebase Authentication"]
  node_firestore[("Cloud Firestore")]
end

node_retailer(("Shop user"))
node_sentry["Sentry"]

node_retailer -->|"signs in"| node_login
node_login -->|"authenticates"| node_authservice
node_login -->|"creates shop"| node_firestore
node_auth -->|"observes session"| node_authservice
node_auth -->|"subscribes shop data"| node_firestore
node_auth -->|"renders"| node_shell
node_auth -->|"sets user"| node_monitoring
node_shell -->|"renders"| node_login
node_shell -->|"routes view"| node_sales
node_shell -->|"routes view"| node_purchases
node_shell -->|"routes view"| node_inventory
node_shell -->|"routes view"| node_customers
node_shell -->|"routes view"| node_suppliers
node_shell -->|"routes view"| node_production
node_shell -->|"routes view"| node_finance
node_shell -->|"routes view"| node_reports
node_shell -->|"routes view"| node_dashboard
node_shell -->|"routes view"| node_journal
node_shell -->|"routes view"| node_admin
node_shell -->|"routes view"| node_users
node_shell -->|"routes view"| node_adminoverview
node_shell -->|"routes view"| node_connections
node_shell -->|"routes view"| node_adminjournal
node_shell -.->|"routes view"| node_settings
node_shell -.->|"routes view"| node_audit
node_inventory -->|"writes batches"| node_firestore
node_users -->|"creates account"| node_authservice
node_users -->|"stores membership"| node_firestore
node_customers -->|"uses credit and CSV rules"| node_business
node_admin -->|"imports user actions"| node_users
node_admin -->|"uses confirmation"| node_confirm
node_customers -.->|"uses confirmation"| node_confirm
node_suppliers -.->|"uses confirmation"| node_confirm
node_shell -->|"reads limits"| node_state
node_shell -->|"uses translations"| node_i18n
node_shell -->|"uses formatting"| node_helpers
node_auth -->|"checks trial and duration"| node_business
node_business -->|"reads plan limits"| node_state
node_business -->|"uses translations"| node_i18n
node_firebaseconfig -->|"initializes"| node_authservice
node_firebaseconfig -->|"initializes"| node_firestore
node_confirm -->|"reauthenticates"| node_authservice
node_auth -->|"writes connection records"| node_firestore
node_monitoring -.->|"reports errors"| node_sentry

click node_login "https://github.com/madiou/gestion-commerciale-gn/blob/main/public/js/view-login.js"
click node_auth "https://github.com/madiou/gestion-commerciale-gn/blob/main/public/js/auth.js"
click node_shell "https://github.com/madiou/gestion-commerciale-gn/blob/main/public/js/app-shell.js"
click node_sales "https://github.com/madiou/gestion-commerciale-gn/blob/main/public/js/view-vente.js"
click node_purchases "https://github.com/madiou/gestion-commerciale-gn/blob/main/public/js/view-achat.js"
click node_inventory "https://github.com/madiou/gestion-commerciale-gn/blob/main/public/js/view-stock.js"
click node_customers "https://github.com/madiou/gestion-commerciale-gn/blob/main/public/js/view-clients.js"
click node_suppliers "https://github.com/madiou/gestion-commerciale-gn/blob/main/public/js/view-fournisseurs.js"
click node_production "https://github.com/madiou/gestion-commerciale-gn/blob/main/public/js/view-production.js"
click node_finance "https://github.com/madiou/gestion-commerciale-gn/blob/main/public/js/view-finance.js"
click node_reports "https://github.com/madiou/gestion-commerciale-gn/blob/main/public/js/view-rapports.js"
click node_dashboard "https://github.com/madiou/gestion-commerciale-gn/blob/main/public/js/view-dashboard.js"
click node_journal "https://github.com/madiou/gestion-commerciale-gn/blob/main/public/js/view-journal.js"
click node_admin "https://github.com/madiou/gestion-commerciale-gn/blob/main/public/js/view-admin.js"
click node_users "https://github.com/madiou/gestion-commerciale-gn/blob/main/public/js/view-utilisateurs.js"
click node_adminoverview "https://github.com/madiou/gestion-commerciale-gn/blob/main/public/js/view-admin-apercu.js"
click node_connections "https://github.com/madiou/gestion-commerciale-gn/blob/main/public/js/view-connexions.js"
click node_adminjournal "https://github.com/madiou/gestion-commerciale-gn/blob/main/public/js/view-journal-admin.js"
click node_settings "https://github.com/madiou/gestion-commerciale-gn/blob/main/public/js/view-parametres.js"
click node_audit "https://github.com/madiou/gestion-commerciale-gn/blob/main/public/js/view-audit.js"
click node_business "https://github.com/madiou/gestion-commerciale-gn/blob/main/public/js/business-logic.js"
click node_state "https://github.com/madiou/gestion-commerciale-gn/blob/main/public/js/state.js"
click node_i18n "https://github.com/madiou/gestion-commerciale-gn/blob/main/public/js/i18n.js"
click node_helpers "https://github.com/madiou/gestion-commerciale-gn/blob/main/public/js/helpers.js"
click node_confirm "https://github.com/madiou/gestion-commerciale-gn/blob/main/public/js/confirmation-securisee.js"
click node_monitoring "https://github.com/madiou/gestion-commerciale-gn/blob/main/public/js/monitoring.js"
click node_firebaseconfig "https://github.com/madiou/gestion-commerciale-gn/blob/main/public/js/firebase-config.js"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_login,node_auth,node_shell,node_retailer toneBlue
class node_sales,node_purchases,node_inventory,node_customers,node_suppliers,node_production,node_finance,node_reports,node_dashboard,node_journal toneAmber
class node_admin,node_users,node_adminoverview,node_connections,node_adminjournal,node_settings,node_audit toneMint
class node_business,node_state,node_i18n,node_helpers,node_confirm,node_monitoring toneRose
class node_firebaseconfig,node_authservice,node_firestore,node_sentry toneIndigo
```

## Components

### Access and shell

- [Sign-in and signup](https://github.com/madiou/gestion-commerciale-gn/blob/main/public/js/view-login.js): `public/js/view-login.js`
- [Session and sync](https://github.com/madiou/gestion-commerciale-gn/blob/main/public/js/auth.js): `public/js/auth.js`
- [App shell](https://github.com/madiou/gestion-commerciale-gn/blob/main/public/js/app-shell.js): `public/js/app-shell.js`

### Shop operations

- [Sales](https://github.com/madiou/gestion-commerciale-gn/blob/main/public/js/view-vente.js): `public/js/view-vente.js`
- [Purchases](https://github.com/madiou/gestion-commerciale-gn/blob/main/public/js/view-achat.js): `public/js/view-achat.js`
- [Stock and products](https://github.com/madiou/gestion-commerciale-gn/blob/main/public/js/view-stock.js): `public/js/view-stock.js`
- [Customers](https://github.com/madiou/gestion-commerciale-gn/blob/main/public/js/view-clients.js): `public/js/view-clients.js`
- [Suppliers](https://github.com/madiou/gestion-commerciale-gn/blob/main/public/js/view-fournisseurs.js): `public/js/view-fournisseurs.js`
- [Production](https://github.com/madiou/gestion-commerciale-gn/blob/main/public/js/view-production.js): `public/js/view-production.js`
- [Finance](https://github.com/madiou/gestion-commerciale-gn/blob/main/public/js/view-finance.js): `public/js/view-finance.js`
- [Reports](https://github.com/madiou/gestion-commerciale-gn/blob/main/public/js/view-rapports.js): `public/js/view-rapports.js`
- [Dashboard](https://github.com/madiou/gestion-commerciale-gn/blob/main/public/js/view-dashboard.js): `public/js/view-dashboard.js`
- [Activity journal](https://github.com/madiou/gestion-commerciale-gn/blob/main/public/js/view-journal.js): `public/js/view-journal.js`

### Administration

- [Shop administration](https://github.com/madiou/gestion-commerciale-gn/blob/main/public/js/view-admin.js): `public/js/view-admin.js`
- [User management](https://github.com/madiou/gestion-commerciale-gn/blob/main/public/js/view-utilisateurs.js): `public/js/view-utilisateurs.js`
- [Admin overview](https://github.com/madiou/gestion-commerciale-gn/blob/main/public/js/view-admin-apercu.js): `public/js/view-admin-apercu.js`
- [Connection history](https://github.com/madiou/gestion-commerciale-gn/blob/main/public/js/view-connexions.js): `public/js/view-connexions.js`
- [Admin journal](https://github.com/madiou/gestion-commerciale-gn/blob/main/public/js/view-journal-admin.js): `public/js/view-journal-admin.js`
- [Shop settings](https://github.com/madiou/gestion-commerciale-gn/blob/main/public/js/view-parametres.js): `public/js/view-parametres.js`
- [Audit view](https://github.com/madiou/gestion-commerciale-gn/blob/main/public/js/view-audit.js): `public/js/view-audit.js`

### Shared services

- [Business rules](https://github.com/madiou/gestion-commerciale-gn/blob/main/public/js/business-logic.js): `public/js/business-logic.js`
- [Shared shop state](https://github.com/madiou/gestion-commerciale-gn/blob/main/public/js/state.js): `public/js/state.js`
- [Translations](https://github.com/madiou/gestion-commerciale-gn/blob/main/public/js/i18n.js): `public/js/i18n.js`
- [UI and date helpers](https://github.com/madiou/gestion-commerciale-gn/blob/main/public/js/helpers.js): `public/js/helpers.js`
- [Secure confirmation](https://github.com/madiou/gestion-commerciale-gn/blob/main/public/js/confirmation-securisee.js): `public/js/confirmation-securisee.js`
- [Error monitoring](https://github.com/madiou/gestion-commerciale-gn/blob/main/public/js/monitoring.js): `public/js/monitoring.js`

### Firebase platform

- [Firebase setup](https://github.com/madiou/gestion-commerciale-gn/blob/main/public/js/firebase-config.js): `public/js/firebase-config.js`
- **Firebase Authentication**
- **Cloud Firestore**

### Other components

- **Shop user**
- **Sentry**

## Connections

- Shop user → Sign-in and signup: signs in (evidence: `README.md`)
- Sign-in and signup → Firebase Authentication: authenticates (evidence: `public/js/view-login.js`)
- Sign-in and signup → Cloud Firestore: creates shop (evidence: `public/js/view-login.js`)
- Session and sync → Firebase Authentication: observes session (evidence: `public/js/auth.js`)
- Session and sync → Cloud Firestore: subscribes shop data (evidence: `public/js/auth.js`)
- Session and sync → App shell: renders (evidence: `public/js/auth.js`)
- Session and sync → Error monitoring: sets user (evidence: `public/js/auth.js`)
- App shell → Sign-in and signup: renders (evidence: `public/js/app-shell.js`)
- App shell → Sales: routes view (evidence: `public/js/app-shell.js`)
- App shell → Purchases: routes view (evidence: `public/js/app-shell.js`)
- App shell → Stock and products: routes view (evidence: `public/js/app-shell.js`)
- App shell → Customers: routes view (evidence: `public/js/app-shell.js`)
- App shell → Suppliers: routes view (evidence: `public/js/app-shell.js`)
- App shell → Production: routes view (evidence: `public/js/app-shell.js`)
- App shell → Finance: routes view (evidence: `public/js/app-shell.js`)
- App shell → Reports: routes view (evidence: `public/js/app-shell.js`)
- App shell → Dashboard: routes view (evidence: `public/js/app-shell.js`)
- App shell → Activity journal: routes view (evidence: `public/js/app-shell.js`)
- App shell → Shop administration: routes view (evidence: `public/js/app-shell.js`)
- App shell → User management: routes view (evidence: `public/js/app-shell.js`)
- App shell → Admin overview: routes view (evidence: `public/js/app-shell.js`)
- App shell → Connection history: routes view (evidence: `public/js/app-shell.js`)
- App shell → Admin journal: routes view (evidence: `public/js/app-shell.js`)
- App shell → Shop settings: routes view (evidence: `public/js/app-shell.js`)
- App shell → Audit view: routes view (evidence: `public/js/app-shell.js`)
- Stock and products → Cloud Firestore: writes batches (evidence: `public/js/view-stock.js`)
- User management → Firebase Authentication: creates account (evidence: `public/js/view-utilisateurs.js`)
- User management → Cloud Firestore: stores membership (evidence: `public/js/view-utilisateurs.js`)
- Customers → Business rules: uses credit and CSV rules (evidence: `public/js/view-clients.js`)
- Shop administration → User management: imports user actions (evidence: `public/js/view-admin.js`)
- Shop administration → Secure confirmation: uses confirmation (evidence: `public/js/view-admin.js`)
- Customers → Secure confirmation: uses confirmation (evidence: `public/js/view-clients.js`)
- Suppliers → Secure confirmation: uses confirmation (evidence: `public/js/view-fournisseurs.js`)
- App shell → Shared shop state: reads limits (evidence: `public/js/app-shell.js`)
- App shell → Translations: uses translations (evidence: `public/js/app-shell.js`)
- App shell → UI and date helpers: uses formatting (evidence: `public/js/app-shell.js`)
- Session and sync → Business rules: checks trial and duration (evidence: `public/js/auth.js`)
- Business rules → Shared shop state: reads plan limits (evidence: `public/js/business-logic.js`)
- Business rules → Translations: uses translations (evidence: `public/js/business-logic.js`)
- Firebase setup → Firebase Authentication: initializes (evidence: `public/js/firebase-config.js`)
- Firebase setup → Cloud Firestore: initializes (evidence: `public/js/firebase-config.js`)
- Secure confirmation → Firebase Authentication: reauthenticates (evidence: `public/js/confirmation-securisee.js`)
- Session and sync → Cloud Firestore: writes connection records (evidence: `public/js/auth.js`)
- Error monitoring → Sentry: reports errors
