# walaaa80/gestion-pharmacie architecture

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

- Interactive diagram: https://gitdiagram.com/walaaa80/gestion-pharmacie
- Repository: https://github.com/walaaa80/gestion-pharmacie

## Overview

Gestion Pharmacie is a Java pharmacy-management application with JavaFX and console interfaces backed by Oracle. Pharmacists authenticate, record or cancel sales, and consult sales and stock; managers maintain medicines and stock, replenish inventory, review movement history, and report sales. Stock-changing operations are documented as transactional and journaled. The excerpts show role classes issuing SQL directly, while DAO provides limited catalog and sales access. Several GUI and manager methods are only partially shown; documented capabilities are retained without inferring unshown call paths.

Main entry points: [`src/main/java/pharmacie/Main.java`](https://github.com/walaaa80/gestion-pharmacie/blob/main/src/main/java/pharmacie/Main.java) (Console UI), [`src/main/java/pharmacie/PharmacieApp.java`](https://github.com/walaaa80/gestion-pharmacie/blob/main/src/main/java/pharmacie/PharmacieApp.java) (JavaFX UI), [`src/main/java/pharmacie/DAO.java`](https://github.com/walaaa80/gestion-pharmacie/blob/main/src/main/java/pharmacie/DAO.java) (DAO), [`src/main/java/pharmacie/Pharmacien.java`](https://github.com/walaaa80/gestion-pharmacie/blob/main/src/main/java/pharmacie/Pharmacien.java) (Sales and stock)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["User interfaces"]
  node_console["Console UI<br/>[Main.java]"]
  node_javafx["JavaFX UI<br/>[PharmacieApp.java]"]
end

subgraph group_operations["Pharmacy operations"]
  node_pharmacist_ops["Sales and stock<br/>[Pharmacien.java]"]
  node_manager_ops["Inventory management<br/>[Gestionnaire.java]"]
  node_replenishment["Replenishment<br/>[Gestionnaire.java]"]
  node_movement_history["Movement history<br/>[Gestionnaire.java]"]
  node_sales_report["Sales reporting<br/>[Main.java]"]
end

subgraph group_persistence["Persistence"]
  node_dao["DAO<br/>[DAO.java]"]
  node_connection["Connection setup"]
  node_oracle[("Oracle database")]
end

subgraph group_domain["Domain models"]
  node_user_model["User model<br/>[Utilisateur.java]"]
  node_medicine["Medicine<br/>[Medicament.java]"]
  node_sale["Sale<br/>[Vente.java]"]
  node_order["Order<br/>[Commande.java]"]
  node_stock_history["Stock movement"]
end

node_pharmacist(("Pharmacist"))
node_manager(("Manager"))

node_pharmacist -->|"uses console"| node_console
node_manager -->|"uses console"| node_console
node_pharmacist -->|"uses JavaFX"| node_javafx
node_manager -->|"uses JavaFX"| node_javafx
node_console -->|"opens connection"| node_connection
node_console -->|"dispatches actions"| node_pharmacist_ops
node_console -->|"dispatches actions"| node_manager_ops
node_console -->|"runs report"| node_sales_report
node_javafx -->|"authenticates role"| node_pharmacist_ops
node_javafx -->|"authenticates role"| node_manager_ops
node_javafx -->|"loads catalog"| node_dao
node_pharmacist_ops -->|"reads and writes"| node_oracle
node_manager_ops -->|"reads and writes"| node_oracle
node_replenishment -->|"records and updates"| node_oracle
node_movement_history -->|"reads movements"| node_oracle
node_sales_report -->|"queries sales"| node_oracle
node_dao -->|"queries catalog"| node_oracle
node_connection -->|"connects via JDBC"| node_oracle
node_dao -->|"constructs"| node_medicine
node_dao -->|"constructs"| node_sale
node_pharmacist_ops -->|"extends"| node_user_model
node_manager_ops -->|"extends"| node_user_model

click node_console "https://github.com/walaaa80/gestion-pharmacie/blob/main/src/main/java/pharmacie/Main.java"
click node_javafx "https://github.com/walaaa80/gestion-pharmacie/blob/main/src/main/java/pharmacie/PharmacieApp.java"
click node_pharmacist_ops "https://github.com/walaaa80/gestion-pharmacie/blob/main/src/main/java/pharmacie/Pharmacien.java"
click node_manager_ops "https://github.com/walaaa80/gestion-pharmacie/blob/main/src/main/java/pharmacie/Gestionnaire.java"
click node_replenishment "https://github.com/walaaa80/gestion-pharmacie/blob/main/src/main/java/pharmacie/Gestionnaire.java"
click node_movement_history "https://github.com/walaaa80/gestion-pharmacie/blob/main/src/main/java/pharmacie/Gestionnaire.java"
click node_sales_report "https://github.com/walaaa80/gestion-pharmacie/blob/main/src/main/java/pharmacie/Main.java"
click node_dao "https://github.com/walaaa80/gestion-pharmacie/blob/main/src/main/java/pharmacie/DAO.java"
click node_connection "https://github.com/walaaa80/gestion-pharmacie/blob/main/src/main/java/pharmacie/DatabaseConnection.java"
click node_user_model "https://github.com/walaaa80/gestion-pharmacie/blob/main/src/main/java/pharmacie/Utilisateur.java"
click node_medicine "https://github.com/walaaa80/gestion-pharmacie/blob/main/src/main/java/pharmacie/Medicament.java"
click node_sale "https://github.com/walaaa80/gestion-pharmacie/blob/main/src/main/java/pharmacie/Vente.java"
click node_order "https://github.com/walaaa80/gestion-pharmacie/blob/main/src/main/java/pharmacie/Commande.java"
click node_stock_history "https://github.com/walaaa80/gestion-pharmacie/blob/main/src/main/java/pharmacie/StockHistorique.java"

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_console,node_javafx toneBlue
class node_pharmacist_ops,node_manager_ops,node_replenishment,node_movement_history,node_sales_report toneAmber
class node_dao,node_connection,node_oracle toneMint
class node_user_model,node_medicine,node_sale,node_order,node_stock_history toneRose
class node_pharmacist,node_manager toneIndigo
```

## Components

### User interfaces

- [Console UI](https://github.com/walaaa80/gestion-pharmacie/blob/main/src/main/java/pharmacie/Main.java): `src/main/java/pharmacie/Main.java`
- [JavaFX UI](https://github.com/walaaa80/gestion-pharmacie/blob/main/src/main/java/pharmacie/PharmacieApp.java): `src/main/java/pharmacie/PharmacieApp.java`

### Pharmacy operations

- [Sales and stock](https://github.com/walaaa80/gestion-pharmacie/blob/main/src/main/java/pharmacie/Pharmacien.java): `src/main/java/pharmacie/Pharmacien.java`
- [Inventory management](https://github.com/walaaa80/gestion-pharmacie/blob/main/src/main/java/pharmacie/Gestionnaire.java): `src/main/java/pharmacie/Gestionnaire.java`
- [Replenishment](https://github.com/walaaa80/gestion-pharmacie/blob/main/src/main/java/pharmacie/Gestionnaire.java): `src/main/java/pharmacie/Gestionnaire.java`
- [Movement history](https://github.com/walaaa80/gestion-pharmacie/blob/main/src/main/java/pharmacie/Gestionnaire.java): `src/main/java/pharmacie/Gestionnaire.java`
- [Sales reporting](https://github.com/walaaa80/gestion-pharmacie/blob/main/src/main/java/pharmacie/Main.java): `src/main/java/pharmacie/Main.java`

### Persistence

- [DAO](https://github.com/walaaa80/gestion-pharmacie/blob/main/src/main/java/pharmacie/DAO.java): `src/main/java/pharmacie/DAO.java`
- [Connection setup](https://github.com/walaaa80/gestion-pharmacie/blob/main/src/main/java/pharmacie/DatabaseConnection.java): `src/main/java/pharmacie/DatabaseConnection.java`
- **Oracle database**

### Domain models

- [User model](https://github.com/walaaa80/gestion-pharmacie/blob/main/src/main/java/pharmacie/Utilisateur.java): `src/main/java/pharmacie/Utilisateur.java`
- [Medicine](https://github.com/walaaa80/gestion-pharmacie/blob/main/src/main/java/pharmacie/Medicament.java): `src/main/java/pharmacie/Medicament.java`
- [Sale](https://github.com/walaaa80/gestion-pharmacie/blob/main/src/main/java/pharmacie/Vente.java): `src/main/java/pharmacie/Vente.java`
- [Order](https://github.com/walaaa80/gestion-pharmacie/blob/main/src/main/java/pharmacie/Commande.java): `src/main/java/pharmacie/Commande.java`
- [Stock movement](https://github.com/walaaa80/gestion-pharmacie/blob/main/src/main/java/pharmacie/StockHistorique.java): `src/main/java/pharmacie/StockHistorique.java`

### Other components

- **Pharmacist**
- **Manager**

## Connections

- Pharmacist → Console UI: uses console (evidence: `README.md`)
- Manager → Console UI: uses console (evidence: `README.md`)
- Pharmacist → JavaFX UI: uses JavaFX (evidence: `README.md`)
- Manager → JavaFX UI: uses JavaFX (evidence: `README.md`)
- Console UI → Connection setup: opens connection (evidence: `src/main/java/pharmacie/Main.java`)
- Console UI → Sales and stock: dispatches actions (evidence: `src/main/java/pharmacie/Main.java`)
- Console UI → Inventory management: dispatches actions (evidence: `src/main/java/pharmacie/Main.java`)
- Console UI → Sales reporting: runs report (evidence: `src/main/java/pharmacie/Main.java`)
- JavaFX UI → Sales and stock: authenticates role (evidence: `src/main/java/pharmacie/PharmacieApp.java`)
- JavaFX UI → Inventory management: authenticates role (evidence: `src/main/java/pharmacie/PharmacieApp.java`)
- JavaFX UI → DAO: loads catalog (evidence: `src/main/java/pharmacie/PharmacieApp.java`)
- Sales and stock → Oracle database: reads and writes (evidence: `src/main/java/pharmacie/Pharmacien.java`)
- Inventory management → Oracle database: reads and writes (evidence: `src/main/java/pharmacie/Gestionnaire.java`)
- Replenishment → Oracle database: records and updates (evidence: `src/main/java/pharmacie/Gestionnaire.java`)
- Movement history → Oracle database: reads movements (evidence: `src/main/java/pharmacie/Gestionnaire.java`)
- Sales reporting → Oracle database: queries sales (evidence: `src/main/java/pharmacie/Main.java`)
- DAO → Oracle database: queries catalog (evidence: `src/main/java/pharmacie/DAO.java`)
- Connection setup → Oracle database: connects via JDBC (evidence: `src/main/java/pharmacie/DatabaseConnection.java`)
- DAO → Medicine: constructs (evidence: `src/main/java/pharmacie/DAO.java`)
- DAO → Sale: constructs (evidence: `src/main/java/pharmacie/DAO.java`)
- Sales and stock → User model: extends (evidence: `src/main/java/pharmacie/Pharmacien.java`)
- Inventory management → User model: extends (evidence: `src/main/java/pharmacie/Gestionnaire.java`)
