# esupportail/esup-mdw architecture

> Architecture diagram of the GitHub repository esupportail/esup-mdw, 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/esupportail/esup-mdw
- Repository: https://github.com/esupportail/esup-mdw

## Overview

Esup MonDossierWeb is a university student-record portal. Users enter through the Vaadin interface and access student information, registrations, grades and results, calendars, and enrolled-student lists; administrative preferences and role-based access govern what is available. The source index supports links from controllers to student/session state and academic services, and from authentication to user and configuration data. The README names no specific integrations or workflow, and several UI and service implementations were not sampled, so those connections are omitted rather than inferred.

Main entry points: [`src/main/java/fr/univlorraine/mondossierweb/controllers/EtudiantController.java`](https://github.com/esupportail/esup-mdw/blob/master/src/main/java/fr/univlorraine/mondossierweb/controllers/EtudiantController.java) (Student records), [`src/main/java/fr/univlorraine/mondossierweb/views`](https://github.com/esupportail/esup-mdw/tree/master/src/main/java/fr/univlorraine/mondossierweb/views) (Student views), [`src/main/java/fr/univlorraine/mondossierweb/controllers/ResultatController.java`](https://github.com/esupportail/esup-mdw/blob/master/src/main/java/fr/univlorraine/mondossierweb/controllers/ResultatController.java) (Results), [`src/main/java/fr/univlorraine/mondossierweb/MainUI.java`](https://github.com/esupportail/esup-mdw/blob/master/src/main/java/fr/univlorraine/mondossierweb/MainUI.java) (Main UI)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Portal interface"]
  node_mainui["Main UI<br/>[MainUI.java]"]
  node_genericui["Session UI state<br/>[GenericUI.java]"]
  node_studentview["Student views"]
  node_roster["Enrolled-student view"]
end

subgraph group_domain["Student records"]
  node_studentcontroller["Student records"]
  node_student["Student profile<br/>[Etudiant.java]"]
  node_registration["Registration data<br/>[Inscription.java]"]
  node_results["Results"]
  node_grades["Grades and notes"]
end

subgraph group_academic["Academic services"]
  node_academicservices["Academic services"]
  node_multipleapo["Apogée queries"]
  node_inscrit["Enrolled entity<br/>[Inscrit.java]"]
  node_versionetape["Program version<br/>[VersionEtape.java]"]
end

subgraph group_access["Identity and settings"]
  node_auth["User authentication"]
  node_config["Application settings"]
  node_preferences[("Preference storage")]
  node_properties["Runtime properties<br/>[PropertyUtils.java]"]
end

node_user(("Portal user"))

node_user -.->|"opens portal"| node_mainui
node_mainui -.->|"uses session state"| node_genericui
node_mainui -.->|"navigates views"| node_studentview
node_studentview -.->|"requests records"| node_studentcontroller
node_studentcontroller -->|"updates session"| node_genericui
node_studentcontroller -->|"populates profile"| node_student
node_studentcontroller -->|"builds registrations"| node_registration
node_studentcontroller -->|"queries studies"| node_academicservices
node_studentview -.->|"requests results"| node_results
node_results -->|"queries results"| node_multipleapo
node_results -->|"updates results"| node_student
node_studentview -.->|"requests grades"| node_grades
node_grades -->|"queries academic data"| node_multipleapo
node_grades -->|"uses results"| node_results
node_user -.->|"opens roster"| node_roster
node_roster -.->|"displays enrollees"| node_inscrit
node_roster -.->|"filters programs"| node_versionetape
node_user -.->|"authenticates"| node_auth
node_auth -->|"checks access settings"| node_config
node_auth -->|"reads properties"| node_properties
node_config -.->|"reads preferences"| node_preferences

click node_mainui "https://github.com/esupportail/esup-mdw/blob/master/src/main/java/fr/univlorraine/mondossierweb/MainUI.java"
click node_genericui "https://github.com/esupportail/esup-mdw/blob/master/src/main/java/fr/univlorraine/mondossierweb/GenericUI.java"
click node_studentview "https://github.com/esupportail/esup-mdw/tree/master/src/main/java/fr/univlorraine/mondossierweb/views"
click node_roster "https://github.com/esupportail/esup-mdw/blob/master/src/main/java/fr/univlorraine/mondossierweb/views/ListeInscritsView.java"
click node_studentcontroller "https://github.com/esupportail/esup-mdw/blob/master/src/main/java/fr/univlorraine/mondossierweb/controllers/EtudiantController.java"
click node_student "https://github.com/esupportail/esup-mdw/blob/master/src/main/java/fr/univlorraine/mondossierweb/beans/Etudiant.java"
click node_registration "https://github.com/esupportail/esup-mdw/blob/master/src/main/java/fr/univlorraine/mondossierweb/beans/Inscription.java"
click node_results "https://github.com/esupportail/esup-mdw/blob/master/src/main/java/fr/univlorraine/mondossierweb/controllers/ResultatController.java"
click node_grades "https://github.com/esupportail/esup-mdw/blob/master/src/main/java/fr/univlorraine/mondossierweb/controllers/NoteController.java"
click node_academicservices "https://github.com/esupportail/esup-mdw/tree/master/src/main/java/fr/univlorraine/mondossierweb/services/apogee"
click node_multipleapo "https://github.com/esupportail/esup-mdw/blob/master/src/main/java/fr/univlorraine/mondossierweb/services/apogee/MultipleApogeeService.java"
click node_inscrit "https://github.com/esupportail/esup-mdw/blob/master/src/main/java/fr/univlorraine/mondossierweb/entities/apogee/Inscrit.java"
click node_versionetape "https://github.com/esupportail/esup-mdw/blob/master/src/main/java/fr/univlorraine/mondossierweb/entities/apogee/VersionEtape.java"
click node_auth "https://github.com/esupportail/esup-mdw/blob/master/src/main/java/fr/univlorraine/mondossierweb/security/MdwUserDetailsService.java"
click node_config "https://github.com/esupportail/esup-mdw/blob/master/src/main/java/fr/univlorraine/mondossierweb/controllers/ConfigController.java"
click node_preferences "https://github.com/esupportail/esup-mdw/blob/master/src/main/java/fr/univlorraine/mondossierweb/repositories/mdw/PreferencesApplicationValeursRepository.java"
click node_properties "https://github.com/esupportail/esup-mdw/blob/master/src/main/java/fr/univlorraine/mondossierweb/utils/PropertyUtils.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_mainui,node_genericui,node_studentview,node_roster,node_user toneBlue
class node_studentcontroller,node_student,node_registration,node_results,node_grades toneAmber
class node_academicservices,node_multipleapo,node_inscrit,node_versionetape toneMint
class node_auth,node_config,node_preferences,node_properties toneRose
```

## Components

### Portal interface

- [Main UI](https://github.com/esupportail/esup-mdw/blob/master/src/main/java/fr/univlorraine/mondossierweb/MainUI.java): `src/main/java/fr/univlorraine/mondossierweb/MainUI.java`
- [Session UI state](https://github.com/esupportail/esup-mdw/blob/master/src/main/java/fr/univlorraine/mondossierweb/GenericUI.java): `src/main/java/fr/univlorraine/mondossierweb/GenericUI.java`
- [Student views](https://github.com/esupportail/esup-mdw/tree/master/src/main/java/fr/univlorraine/mondossierweb/views): `src/main/java/fr/univlorraine/mondossierweb/views`
- [Enrolled-student view](https://github.com/esupportail/esup-mdw/blob/master/src/main/java/fr/univlorraine/mondossierweb/views/ListeInscritsView.java): `src/main/java/fr/univlorraine/mondossierweb/views/ListeInscritsView.java`

### Student records

- [Student records](https://github.com/esupportail/esup-mdw/blob/master/src/main/java/fr/univlorraine/mondossierweb/controllers/EtudiantController.java): `src/main/java/fr/univlorraine/mondossierweb/controllers/EtudiantController.java`
- [Student profile](https://github.com/esupportail/esup-mdw/blob/master/src/main/java/fr/univlorraine/mondossierweb/beans/Etudiant.java): `src/main/java/fr/univlorraine/mondossierweb/beans/Etudiant.java`
- [Registration data](https://github.com/esupportail/esup-mdw/blob/master/src/main/java/fr/univlorraine/mondossierweb/beans/Inscription.java): `src/main/java/fr/univlorraine/mondossierweb/beans/Inscription.java`
- [Results](https://github.com/esupportail/esup-mdw/blob/master/src/main/java/fr/univlorraine/mondossierweb/controllers/ResultatController.java): `src/main/java/fr/univlorraine/mondossierweb/controllers/ResultatController.java`
- [Grades and notes](https://github.com/esupportail/esup-mdw/blob/master/src/main/java/fr/univlorraine/mondossierweb/controllers/NoteController.java): `src/main/java/fr/univlorraine/mondossierweb/controllers/NoteController.java`

### Academic services

- [Academic services](https://github.com/esupportail/esup-mdw/tree/master/src/main/java/fr/univlorraine/mondossierweb/services/apogee): `src/main/java/fr/univlorraine/mondossierweb/services/apogee`
- [Apogée queries](https://github.com/esupportail/esup-mdw/blob/master/src/main/java/fr/univlorraine/mondossierweb/services/apogee/MultipleApogeeService.java): `src/main/java/fr/univlorraine/mondossierweb/services/apogee/MultipleApogeeService.java`
- [Enrolled entity](https://github.com/esupportail/esup-mdw/blob/master/src/main/java/fr/univlorraine/mondossierweb/entities/apogee/Inscrit.java): `src/main/java/fr/univlorraine/mondossierweb/entities/apogee/Inscrit.java`
- [Program version](https://github.com/esupportail/esup-mdw/blob/master/src/main/java/fr/univlorraine/mondossierweb/entities/apogee/VersionEtape.java): `src/main/java/fr/univlorraine/mondossierweb/entities/apogee/VersionEtape.java`

### Identity and settings

- [User authentication](https://github.com/esupportail/esup-mdw/blob/master/src/main/java/fr/univlorraine/mondossierweb/security/MdwUserDetailsService.java): `src/main/java/fr/univlorraine/mondossierweb/security/MdwUserDetailsService.java`
- [Application settings](https://github.com/esupportail/esup-mdw/blob/master/src/main/java/fr/univlorraine/mondossierweb/controllers/ConfigController.java): `src/main/java/fr/univlorraine/mondossierweb/controllers/ConfigController.java`
- [Preference storage](https://github.com/esupportail/esup-mdw/blob/master/src/main/java/fr/univlorraine/mondossierweb/repositories/mdw/PreferencesApplicationValeursRepository.java): `src/main/java/fr/univlorraine/mondossierweb/repositories/mdw/PreferencesApplicationValeursRepository.java`
- [Runtime properties](https://github.com/esupportail/esup-mdw/blob/master/src/main/java/fr/univlorraine/mondossierweb/utils/PropertyUtils.java): `src/main/java/fr/univlorraine/mondossierweb/utils/PropertyUtils.java`

### Other components

- **Portal user**

## Connections

- Portal user → Main UI: opens portal
- Main UI → Session UI state: uses session state (evidence: `src/main/java/fr/univlorraine/mondossierweb/MainUI.java`)
- Main UI → Student views: navigates views (evidence: `src/main/java/fr/univlorraine/mondossierweb/MainUI.java`)
- Student views → Student records: requests records
- Student records → Session UI state: updates session (evidence: `src/main/java/fr/univlorraine/mondossierweb/controllers/EtudiantController.java`)
- Student records → Student profile: populates profile (evidence: `src/main/java/fr/univlorraine/mondossierweb/controllers/EtudiantController.java`)
- Student records → Registration data: builds registrations (evidence: `src/main/java/fr/univlorraine/mondossierweb/controllers/EtudiantController.java`)
- Student records → Academic services: queries studies (evidence: `src/main/java/fr/univlorraine/mondossierweb/controllers/EtudiantController.java`)
- Student views → Results: requests results
- Results → Apogée queries: queries results (evidence: `src/main/java/fr/univlorraine/mondossierweb/controllers/ResultatController.java`)
- Results → Student profile: updates results (evidence: `src/main/java/fr/univlorraine/mondossierweb/controllers/ResultatController.java`)
- Student views → Grades and notes: requests grades
- Grades and notes → Apogée queries: queries academic data (evidence: `src/main/java/fr/univlorraine/mondossierweb/controllers/NoteController.java`)
- Grades and notes → Results: uses results (evidence: `src/main/java/fr/univlorraine/mondossierweb/controllers/NoteController.java`)
- Portal user → Enrolled-student view: opens roster
- Enrolled-student view → Enrolled entity: displays enrollees
- Enrolled-student view → Program version: filters programs
- Portal user → User authentication: authenticates
- User authentication → Application settings: checks access settings (evidence: `src/main/java/fr/univlorraine/mondossierweb/security/MdwUserDetailsService.java`)
- User authentication → Runtime properties: reads properties (evidence: `src/main/java/fr/univlorraine/mondossierweb/security/MdwUserDetailsService.java`)
- Application settings → Preference storage: reads preferences (evidence: `src/main/java/fr/univlorraine/mondossierweb/controllers/ConfigController.java`)
