# mohamedazizelhamrouni/geststage-enterprise architecture

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

- Interactive diagram: https://gitdiagram.com/mohamedazizelhamrouni/geststage-enterprise
- Repository: https://github.com/mohamedazizelhamrouni/geststage-enterprise

## Overview

GestStage is a console application for managing academic internships, from role-based access and offer publication through applications, placement tracking, and supervision. The README describes a UI/service/DAO architecture backed by a relational database and also documents administration and PDF reporting. Sampled source confirms the startup path, several service-to-DAO interactions, and JDBC configuration; many role-menu and domain links are documented at layer level rather than verified in sampled implementations.

Main entry points: [`src/main/java/com/gestion/stages/service`](https://github.com/mohamedazizelhamrouni/geststage-enterprise/tree/main/src/main/java/com/gestion/stages/service) (Business services), [`src/main/java/com/gestion/stages/ui`](https://github.com/mohamedazizelhamrouni/geststage-enterprise/tree/main/src/main/java/com/gestion/stages/ui) (Role menus), [`src/main/java/com/gestion/stages/ui/MenuPrincipal.java`](https://github.com/mohamedazizelhamrouni/geststage-enterprise/blob/main/src/main/java/com/gestion/stages/ui/MenuPrincipal.java) (Principal menu), [`src/main/java/com/gestion/stages/dao`](https://github.com/mohamedazizelhamrouni/geststage-enterprise/tree/main/src/main/java/com/gestion/stages/dao) (JDBC data access)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Console access"]
  node_main["Application startup<br/>[Main.java]"]
  node_menus["Principal menu<br/>[MenuPrincipal.java]"]
  node_rolemenus["Role menus"]
end

subgraph group_workflow["Internship workflows"]
  node_auth["Authentication<br/>[AuthService.java]"]
  node_student["Student profiles"]
  node_offers["Internship offers"]
  node_applications["Applications"]
  node_placements["Internship tracking<br/>[StageService.java]"]
  node_companies["Company management"]
  node_services["Business services"]
end

subgraph group_data["Persistence"]
  node_daos["JDBC data access"]
  node_dbconfig["Database connection"]
  node_mysql[("Relational database")]
end

subgraph group_support["Administration and reports"]
  node_accounts["Account administration"]
  node_exports["PDF reports<br/>[ExportUtils.java]"]
end

node_users(("Role-based users"))

node_main -->|"starts"| node_menus
node_users -->|"interact with"| node_menus
node_menus -->|"dispatches to"| node_rolemenus
node_rolemenus -->|"invoke business logic"| node_services
node_services -->|"access data through"| node_daos
node_daos -->|"obtain connections"| node_dbconfig
node_dbconfig -->|"opens JDBC connection"| node_mysql
node_services -.->|"includes"| node_auth
node_services -.->|"includes"| node_student
node_services -.->|"includes"| node_offers
node_services -.->|"includes"| node_applications
node_services -.->|"includes"| node_placements
node_services -.->|"includes"| node_companies
node_rolemenus -.->|"administers accounts"| node_accounts
node_rolemenus -.->|"requests reports"| node_exports

click node_main "https://github.com/mohamedazizelhamrouni/geststage-enterprise/blob/main/src/main/java/com/gestion/stages/Main.java"
click node_menus "https://github.com/mohamedazizelhamrouni/geststage-enterprise/blob/main/src/main/java/com/gestion/stages/ui/MenuPrincipal.java"
click node_rolemenus "https://github.com/mohamedazizelhamrouni/geststage-enterprise/tree/main/src/main/java/com/gestion/stages/ui"
click node_auth "https://github.com/mohamedazizelhamrouni/geststage-enterprise/blob/main/src/main/java/com/gestion/stages/service/AuthService.java"
click node_student "https://github.com/mohamedazizelhamrouni/geststage-enterprise/blob/main/src/main/java/com/gestion/stages/service/EtudiantService.java"
click node_offers "https://github.com/mohamedazizelhamrouni/geststage-enterprise/blob/main/src/main/java/com/gestion/stages/service/OffreStageService.java"
click node_applications "https://github.com/mohamedazizelhamrouni/geststage-enterprise/blob/main/src/main/java/com/gestion/stages/service/CandidatureService.java"
click node_placements "https://github.com/mohamedazizelhamrouni/geststage-enterprise/blob/main/src/main/java/com/gestion/stages/service/StageService.java"
click node_companies "https://github.com/mohamedazizelhamrouni/geststage-enterprise/blob/main/src/main/java/com/gestion/stages/service/EntrepriseService.java"
click node_accounts "https://github.com/mohamedazizelhamrouni/geststage-enterprise/blob/main/src/main/java/com/gestion/stages/service/UtilisateurService.java"
click node_exports "https://github.com/mohamedazizelhamrouni/geststage-enterprise/blob/main/src/main/java/com/gestion/stages/util/ExportUtils.java"
click node_services "https://github.com/mohamedazizelhamrouni/geststage-enterprise/tree/main/src/main/java/com/gestion/stages/service"
click node_daos "https://github.com/mohamedazizelhamrouni/geststage-enterprise/tree/main/src/main/java/com/gestion/stages/dao"
click node_dbconfig "https://github.com/mohamedazizelhamrouni/geststage-enterprise/blob/main/src/main/java/com/gestion/stages/config/DatabaseConfig.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_main,node_menus,node_rolemenus,node_users toneBlue
class node_auth,node_student,node_offers,node_applications,node_placements,node_companies,node_services toneAmber
class node_daos,node_dbconfig,node_mysql toneMint
class node_accounts,node_exports toneRose
```

## Components

### Console access

- [Application startup](https://github.com/mohamedazizelhamrouni/geststage-enterprise/blob/main/src/main/java/com/gestion/stages/Main.java): `src/main/java/com/gestion/stages/Main.java`
- [Principal menu](https://github.com/mohamedazizelhamrouni/geststage-enterprise/blob/main/src/main/java/com/gestion/stages/ui/MenuPrincipal.java): `src/main/java/com/gestion/stages/ui/MenuPrincipal.java`
- [Role menus](https://github.com/mohamedazizelhamrouni/geststage-enterprise/tree/main/src/main/java/com/gestion/stages/ui): `src/main/java/com/gestion/stages/ui`

### Internship workflows

- [Authentication](https://github.com/mohamedazizelhamrouni/geststage-enterprise/blob/main/src/main/java/com/gestion/stages/service/AuthService.java): `src/main/java/com/gestion/stages/service/AuthService.java`
- [Student profiles](https://github.com/mohamedazizelhamrouni/geststage-enterprise/blob/main/src/main/java/com/gestion/stages/service/EtudiantService.java): `src/main/java/com/gestion/stages/service/EtudiantService.java`
- [Internship offers](https://github.com/mohamedazizelhamrouni/geststage-enterprise/blob/main/src/main/java/com/gestion/stages/service/OffreStageService.java): `src/main/java/com/gestion/stages/service/OffreStageService.java`
- [Applications](https://github.com/mohamedazizelhamrouni/geststage-enterprise/blob/main/src/main/java/com/gestion/stages/service/CandidatureService.java): `src/main/java/com/gestion/stages/service/CandidatureService.java`
- [Internship tracking](https://github.com/mohamedazizelhamrouni/geststage-enterprise/blob/main/src/main/java/com/gestion/stages/service/StageService.java): `src/main/java/com/gestion/stages/service/StageService.java`
- [Company management](https://github.com/mohamedazizelhamrouni/geststage-enterprise/blob/main/src/main/java/com/gestion/stages/service/EntrepriseService.java): `src/main/java/com/gestion/stages/service/EntrepriseService.java`
- [Business services](https://github.com/mohamedazizelhamrouni/geststage-enterprise/tree/main/src/main/java/com/gestion/stages/service): `src/main/java/com/gestion/stages/service`

### Persistence

- [JDBC data access](https://github.com/mohamedazizelhamrouni/geststage-enterprise/tree/main/src/main/java/com/gestion/stages/dao): `src/main/java/com/gestion/stages/dao`
- [Database connection](https://github.com/mohamedazizelhamrouni/geststage-enterprise/blob/main/src/main/java/com/gestion/stages/config/DatabaseConfig.java): `src/main/java/com/gestion/stages/config/DatabaseConfig.java`
- **Relational database**

### Administration and reports

- [Account administration](https://github.com/mohamedazizelhamrouni/geststage-enterprise/blob/main/src/main/java/com/gestion/stages/service/UtilisateurService.java): `src/main/java/com/gestion/stages/service/UtilisateurService.java`
- [PDF reports](https://github.com/mohamedazizelhamrouni/geststage-enterprise/blob/main/src/main/java/com/gestion/stages/util/ExportUtils.java): `src/main/java/com/gestion/stages/util/ExportUtils.java`

### Other components

- **Role-based users**

## Connections

- Application startup → Principal menu: starts (evidence: `src/main/java/com/gestion/stages/Main.java`)
- Role-based users → Principal menu: interact with
- Principal menu → Role menus: dispatches to
- Role menus → Business services: invoke business logic (evidence: `src/main/java/com/gestion/stages/ui/MenuAdmin.java`)
- Business services → JDBC data access: access data through (evidence: `src/main/java/com/gestion/stages/service/AuthService.java`)
- JDBC data access → Database connection: obtain connections (evidence: `src/main/java/com/gestion/stages/dao/EtudiantDAO.java`)
- Database connection → Relational database: opens JDBC connection (evidence: `src/main/java/com/gestion/stages/config/DatabaseConfig.java`)
- Business services → Authentication: includes (evidence: `src/main/java/com/gestion/stages/service/AuthService.java`)
- Business services → Student profiles: includes (evidence: `src/main/java/com/gestion/stages/service/EtudiantService.java`)
- Business services → Internship offers: includes (evidence: `src/main/java/com/gestion/stages/service/OffreStageService.java`)
- Business services → Applications: includes (evidence: `src/main/java/com/gestion/stages/service/CandidatureService.java`)
- Business services → Internship tracking: includes (evidence: `src/main/java/com/gestion/stages/service/StageService.java`)
- Business services → Company management: includes (evidence: `src/main/java/com/gestion/stages/service/EntrepriseService.java`)
- Role menus → Account administration: administers accounts (evidence: `src/main/java/com/gestion/stages/ui/MenuAdmin.java`)
- Role menus → PDF reports: requests reports (evidence: `src/main/java/com/gestion/stages/ui/MenuAdmin.java`)
