# zlorgoncho1/gestion-etudiant architecture

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

- Interactive diagram: https://gitdiagram.com/zlorgoncho1/gestion-etudiant
- Repository: https://github.com/zlorgoncho1/gestion-etudiant

## Overview

Gestion Etudiant is a Java EE student-management CRUD application: users access a JSF page to create, list, edit, or delete students, with StudentBean coordinating those actions through StudentService and JPA. The README documents PostgreSQL and SQL initialization, while the sampled Java source confirms the bean-to-service and service-to-entity/JPA responsibilities. The JSF page bindings, persistence configuration, and database wiring were not sampled, so those links are shown only where documented or marked unverified.

Main entry points: [`app/src/main/java/services/StudentService.java`](https://github.com/zlorgoncho1/gestion-etudiant/blob/main/app/src/main/java/services/StudentService.java) (CRUD service), [`app/src/main/webapp/views/students.xhtml`](https://github.com/zlorgoncho1/gestion-etudiant/blob/main/app/src/main/webapp/views/students.xhtml) (Student page), [`app/src/main/java/beans/StudentBean.java`](https://github.com/zlorgoncho1/gestion-etudiant/blob/main/app/src/main/java/beans/StudentBean.java) (Student actions), [`app/src/main/java/services/JPAUtil.java`](https://github.com/zlorgoncho1/gestion-etudiant/blob/main/app/src/main/java/services/JPAUtil.java) (JPA access)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web interface"]
  node_students_view["Student page<br/>[students.xhtml]"]
  node_student_bean["Student actions<br/>[StudentBean.java]"]
end

subgraph group_domain["Student domain"]
  node_student_service["CRUD service"]
  node_student_entity["Student entity<br/>[Student.java]"]
end

subgraph group_persistence["Persistence"]
  node_jpa_util["JPA access<br/>[JPAUtil.java]"]
  node_postgres[("PostgreSQL")]
  node_sql_init["Database schema"]
end

node_user(("User"))

node_user -->|"uses"| node_students_view
node_students_view -.->|"submits actions"| node_student_bean
node_student_bean -->|"delegates CRUD"| node_student_service
node_student_service -->|"persists and queries"| node_student_entity
node_student_service -->|"gets manager"| node_jpa_util
node_jpa_util -.->|"connects via JPA"| node_postgres
node_sql_init -->|"initializes schema"| node_postgres

click node_students_view "https://github.com/zlorgoncho1/gestion-etudiant/blob/main/app/src/main/webapp/views/students.xhtml"
click node_student_bean "https://github.com/zlorgoncho1/gestion-etudiant/blob/main/app/src/main/java/beans/StudentBean.java"
click node_student_service "https://github.com/zlorgoncho1/gestion-etudiant/blob/main/app/src/main/java/services/StudentService.java"
click node_student_entity "https://github.com/zlorgoncho1/gestion-etudiant/blob/main/app/src/main/java/entities/Student.java"
click node_jpa_util "https://github.com/zlorgoncho1/gestion-etudiant/blob/main/app/src/main/java/services/JPAUtil.java"
click node_sql_init "https://github.com/zlorgoncho1/gestion-etudiant/blob/main/database/sql/gestion-etudiant.sql"

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_students_view,node_student_bean,node_user toneBlue
class node_student_service,node_student_entity toneAmber
class node_jpa_util,node_postgres,node_sql_init toneMint
```

## Components

### Web interface

- [Student page](https://github.com/zlorgoncho1/gestion-etudiant/blob/main/app/src/main/webapp/views/students.xhtml): `app/src/main/webapp/views/students.xhtml`
- [Student actions](https://github.com/zlorgoncho1/gestion-etudiant/blob/main/app/src/main/java/beans/StudentBean.java): `app/src/main/java/beans/StudentBean.java`

### Student domain

- [CRUD service](https://github.com/zlorgoncho1/gestion-etudiant/blob/main/app/src/main/java/services/StudentService.java): `app/src/main/java/services/StudentService.java`
- [Student entity](https://github.com/zlorgoncho1/gestion-etudiant/blob/main/app/src/main/java/entities/Student.java): `app/src/main/java/entities/Student.java`

### Persistence

- [JPA access](https://github.com/zlorgoncho1/gestion-etudiant/blob/main/app/src/main/java/services/JPAUtil.java): `app/src/main/java/services/JPAUtil.java`
- **PostgreSQL**
- [Database schema](https://github.com/zlorgoncho1/gestion-etudiant/blob/main/database/sql/gestion-etudiant.sql): `database/sql/gestion-etudiant.sql`

### Other components

- **User**

## Connections

- User → Student page: uses (evidence: `README.md`)
- Student page → Student actions: submits actions
- Student actions → CRUD service: delegates CRUD (evidence: `app/src/main/java/beans/StudentBean.java`)
- CRUD service → Student entity: persists and queries (evidence: `app/src/main/java/services/StudentService.java`)
- CRUD service → JPA access: gets manager (evidence: `app/src/main/java/services/StudentService.java`)
- JPA access → PostgreSQL: connects via JPA
- Database schema → PostgreSQL: initializes schema (evidence: `README.md`)
