# esupportail/esup-pstage architecture

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

- Interactive diagram: https://gitdiagram.com/esupportail/esup-pstage
- Repository: https://github.com/esupportail/esup-pstage

## Overview

ESUP-PStage is a university internship-placement management application. Staff manage placement offers, conventions and amendments, evaluation, institutions and management centres; student and university reference data support convention entry. The visible workflow is convention entry and evaluation through JSF controllers, with domain services providing business operations and export services producing XML/PDF or spreadsheet outputs. The tree and excerpts establish the product’s main capabilities, but many service implementations and persistence details are unsampled; uncertain connections are therefore omitted or marked unverified.

Main entry points: [`esup-pstage-web-jsf-servlet/src/main/java/org/esupportail/pstage/web/controllers/ConventionController.java`](https://github.com/esupportail/esup-pstage/blob/master/esup-pstage-web-jsf-servlet/src/main/java/org/esupportail/pstage/web/controllers/ConventionController.java) (Conventions), [`esup-pstage-web-jsf-servlet/src/main/java/org/esupportail/pstage/web/controllers/EvaluationController.java`](https://github.com/esupportail/esup-pstage/blob/master/esup-pstage-web-jsf-servlet/src/main/java/org/esupportail/pstage/web/controllers/EvaluationController.java) (Evaluations), [`esup-pstage-web-jsf-servlet/src/main/java/org/esupportail/pstage/web/controllers/OffreController.java`](https://github.com/esupportail/esup-pstage/blob/master/esup-pstage-web-jsf-servlet/src/main/java/org/esupportail/pstage/web/controllers/OffreController.java) (Placement offers), [`esup-pstage-web-jsf-servlet/src/main/java/org/esupportail/pstage/web/controllers/CentreController.java`](https://github.com/esupportail/esup-pstage/blob/master/esup-pstage-web-jsf-servlet/src/main/java/org/esupportail/pstage/web/controllers/CentreController.java) (Management centres)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web application"]
  node_convention["Conventions"]
  node_offer["Placement offers"]
  node_centre["Management centres"]
  node_institution["Institutions"]
  node_evaluation["Evaluations"]
end

subgraph group_domain["Placement domain"]
  node_convention_service["Convention operations"]
  node_offer_service["Offer operations"]
  node_centre_service["Centre operations"]
  node_institution_service["Structure operations"]
  node_evaluation_service["Evaluation operations"]
  node_dao["User and version DAO<br/>[DaoService.java]"]
  node_user_version["User and version data"]
end

subgraph group_reference["University references"]
  node_student_data["Student records<br/>[EtudiantRef.java]"]
  node_university_data["University records"]
  node_reference_services["Reference access"]
end

subgraph group_export["Export and reporting"]
  node_xml_export["XML export<br/>[CastorService.java]"]
  node_pdf_export["PDF utilities<br/>[PDFUtils.java]"]
  node_stats["Convention statistics"]
end

node_staff(("Staff user"))

node_staff -.->|"uses"| node_convention
node_staff -.->|"uses"| node_offer
node_staff -.->|"uses"| node_centre
node_staff -.->|"uses"| node_institution
node_convention -.->|"requests"| node_convention_service
node_offer -.->|"requests"| node_offer_service
node_centre -.->|"requests"| node_centre_service
node_institution -.->|"requests"| node_institution_service
node_evaluation -->|"updates"| node_evaluation_service
node_evaluation -->|"uses state"| node_convention
node_convention -->|"exports XML"| node_xml_export
node_convention -->|"generates PDF"| node_pdf_export
node_evaluation -->|"exports XML"| node_xml_export
node_offer -->|"exports XML"| node_xml_export
node_centre -->|"loads components"| node_reference_services
node_convention -->|"uses records"| node_student_data
node_convention -->|"uses records"| node_university_data
node_stats -.->|"uses evaluations"| node_evaluation_service
node_dao -->|"reads and writes"| node_user_version

click node_convention "https://github.com/esupportail/esup-pstage/blob/master/esup-pstage-web-jsf-servlet/src/main/java/org/esupportail/pstage/web/controllers/ConventionController.java"
click node_offer "https://github.com/esupportail/esup-pstage/blob/master/esup-pstage-web-jsf-servlet/src/main/java/org/esupportail/pstage/web/controllers/OffreController.java"
click node_centre "https://github.com/esupportail/esup-pstage/blob/master/esup-pstage-web-jsf-servlet/src/main/java/org/esupportail/pstage/web/controllers/CentreController.java"
click node_institution "https://github.com/esupportail/esup-pstage/blob/master/esup-pstage-web-jsf-servlet/src/main/java/org/esupportail/pstage/web/controllers/EtablissementController.java"
click node_evaluation "https://github.com/esupportail/esup-pstage/blob/master/esup-pstage-web-jsf-servlet/src/main/java/org/esupportail/pstage/web/controllers/EvaluationController.java"
click node_convention_service "https://github.com/esupportail/esup-pstage/blob/master/esup-pstage-domain-services/src/main/java/org/esupportail/pstage/domain/ConventionDomainServiceImpl.java"
click node_offer_service "https://github.com/esupportail/esup-pstage/blob/master/esup-pstage-domain-services/src/main/java/org/esupportail/pstage/domain/OffreDomainServiceImpl.java"
click node_centre_service "https://github.com/esupportail/esup-pstage/blob/master/esup-pstage-domain-services/src/main/java/org/esupportail/pstage/domain/CentreGestionDomainServiceImpl.java"
click node_institution_service "https://github.com/esupportail/esup-pstage/blob/master/esup-pstage-domain-services/src/main/java/org/esupportail/pstage/domain/StructureDomainServiceImpl.java"
click node_evaluation_service "https://github.com/esupportail/esup-pstage/blob/master/esup-pstage-domain-services/src/main/java/org/esupportail/pstage/domain/FicheEvaluationDomainServiceImpl.java"
click node_student_data "https://github.com/esupportail/esup-pstage/blob/master/esup-pstage-domain-beans/src/main/java/org/esupportail/pstage/domain/beans/EtudiantRef.java"
click node_university_data "https://github.com/esupportail/esup-pstage/blob/master/esup-pstage-domain-beans/src/main/java/org/esupportail/pstage/domain/beans/AdministrationApogee.java"
click node_reference_services "https://github.com/esupportail/esup-pstage/tree/master/esup-pstage-domain-services/src/main/java/org/esupportail/pstage/domain/referentiel"
click node_xml_export "https://github.com/esupportail/esup-pstage/blob/master/esup-pstage-domain-services/src/main/java/org/esupportail/pstage/services/export/CastorService.java"
click node_pdf_export "https://github.com/esupportail/esup-pstage/blob/master/esup-pstage-web-jsf-servlet/src/main/java/org/esupportail/pstage/web/utils/PDFUtils.java"
click node_stats "https://github.com/esupportail/esup-pstage/blob/master/esup-pstage-domain-services/src/main/java/org/esupportail/pstage/domain/StatistiquesDomainServiceImpl.java"
click node_dao "https://github.com/esupportail/esup-pstage/blob/master/esup-pstage-dao/src/main/java/org/esupportail/pstage/dao/DaoService.java"
click node_user_version "https://github.com/esupportail/esup-pstage/blob/master/esup-pstage-domain-beans/src/main/java/org/esupportail/pstage/domain/beans/VersionManager.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_convention,node_offer,node_centre,node_institution,node_evaluation,node_staff toneBlue
class node_convention_service,node_offer_service,node_centre_service,node_institution_service,node_evaluation_service,node_dao,node_user_version toneAmber
class node_student_data,node_university_data,node_reference_services toneMint
class node_xml_export,node_pdf_export,node_stats toneRose
```

## Components

### Web application

- [Conventions](https://github.com/esupportail/esup-pstage/blob/master/esup-pstage-web-jsf-servlet/src/main/java/org/esupportail/pstage/web/controllers/ConventionController.java): `esup-pstage-web-jsf-servlet/src/main/java/org/esupportail/pstage/web/controllers/ConventionController.java`
- [Placement offers](https://github.com/esupportail/esup-pstage/blob/master/esup-pstage-web-jsf-servlet/src/main/java/org/esupportail/pstage/web/controllers/OffreController.java): `esup-pstage-web-jsf-servlet/src/main/java/org/esupportail/pstage/web/controllers/OffreController.java`
- [Management centres](https://github.com/esupportail/esup-pstage/blob/master/esup-pstage-web-jsf-servlet/src/main/java/org/esupportail/pstage/web/controllers/CentreController.java): `esup-pstage-web-jsf-servlet/src/main/java/org/esupportail/pstage/web/controllers/CentreController.java`
- [Institutions](https://github.com/esupportail/esup-pstage/blob/master/esup-pstage-web-jsf-servlet/src/main/java/org/esupportail/pstage/web/controllers/EtablissementController.java): `esup-pstage-web-jsf-servlet/src/main/java/org/esupportail/pstage/web/controllers/EtablissementController.java`
- [Evaluations](https://github.com/esupportail/esup-pstage/blob/master/esup-pstage-web-jsf-servlet/src/main/java/org/esupportail/pstage/web/controllers/EvaluationController.java): `esup-pstage-web-jsf-servlet/src/main/java/org/esupportail/pstage/web/controllers/EvaluationController.java`

### Placement domain

- [Convention operations](https://github.com/esupportail/esup-pstage/blob/master/esup-pstage-domain-services/src/main/java/org/esupportail/pstage/domain/ConventionDomainServiceImpl.java): `esup-pstage-domain-services/src/main/java/org/esupportail/pstage/domain/ConventionDomainServiceImpl.java`
- [Offer operations](https://github.com/esupportail/esup-pstage/blob/master/esup-pstage-domain-services/src/main/java/org/esupportail/pstage/domain/OffreDomainServiceImpl.java): `esup-pstage-domain-services/src/main/java/org/esupportail/pstage/domain/OffreDomainServiceImpl.java`
- [Centre operations](https://github.com/esupportail/esup-pstage/blob/master/esup-pstage-domain-services/src/main/java/org/esupportail/pstage/domain/CentreGestionDomainServiceImpl.java): `esup-pstage-domain-services/src/main/java/org/esupportail/pstage/domain/CentreGestionDomainServiceImpl.java`
- [Structure operations](https://github.com/esupportail/esup-pstage/blob/master/esup-pstage-domain-services/src/main/java/org/esupportail/pstage/domain/StructureDomainServiceImpl.java): `esup-pstage-domain-services/src/main/java/org/esupportail/pstage/domain/StructureDomainServiceImpl.java`
- [Evaluation operations](https://github.com/esupportail/esup-pstage/blob/master/esup-pstage-domain-services/src/main/java/org/esupportail/pstage/domain/FicheEvaluationDomainServiceImpl.java): `esup-pstage-domain-services/src/main/java/org/esupportail/pstage/domain/FicheEvaluationDomainServiceImpl.java`
- [User and version DAO](https://github.com/esupportail/esup-pstage/blob/master/esup-pstage-dao/src/main/java/org/esupportail/pstage/dao/DaoService.java): `esup-pstage-dao/src/main/java/org/esupportail/pstage/dao/DaoService.java`
- [User and version data](https://github.com/esupportail/esup-pstage/blob/master/esup-pstage-domain-beans/src/main/java/org/esupportail/pstage/domain/beans/VersionManager.java): `esup-pstage-domain-beans/src/main/java/org/esupportail/pstage/domain/beans/VersionManager.java`

### University references

- [Student records](https://github.com/esupportail/esup-pstage/blob/master/esup-pstage-domain-beans/src/main/java/org/esupportail/pstage/domain/beans/EtudiantRef.java): `esup-pstage-domain-beans/src/main/java/org/esupportail/pstage/domain/beans/EtudiantRef.java`
- [University records](https://github.com/esupportail/esup-pstage/blob/master/esup-pstage-domain-beans/src/main/java/org/esupportail/pstage/domain/beans/AdministrationApogee.java): `esup-pstage-domain-beans/src/main/java/org/esupportail/pstage/domain/beans/AdministrationApogee.java`
- [Reference access](https://github.com/esupportail/esup-pstage/tree/master/esup-pstage-domain-services/src/main/java/org/esupportail/pstage/domain/referentiel): `esup-pstage-domain-services/src/main/java/org/esupportail/pstage/domain/referentiel`

### Export and reporting

- [XML export](https://github.com/esupportail/esup-pstage/blob/master/esup-pstage-domain-services/src/main/java/org/esupportail/pstage/services/export/CastorService.java): `esup-pstage-domain-services/src/main/java/org/esupportail/pstage/services/export/CastorService.java`
- [PDF utilities](https://github.com/esupportail/esup-pstage/blob/master/esup-pstage-web-jsf-servlet/src/main/java/org/esupportail/pstage/web/utils/PDFUtils.java): `esup-pstage-web-jsf-servlet/src/main/java/org/esupportail/pstage/web/utils/PDFUtils.java`
- [Convention statistics](https://github.com/esupportail/esup-pstage/blob/master/esup-pstage-domain-services/src/main/java/org/esupportail/pstage/domain/StatistiquesDomainServiceImpl.java): `esup-pstage-domain-services/src/main/java/org/esupportail/pstage/domain/StatistiquesDomainServiceImpl.java`

### Other components

- **Staff user**

## Connections

- Staff user → Conventions: uses
- Staff user → Placement offers: uses
- Staff user → Management centres: uses
- Staff user → Institutions: uses
- Conventions → Convention operations: requests
- Placement offers → Offer operations: requests
- Management centres → Centre operations: requests
- Institutions → Structure operations: requests
- Evaluations → Evaluation operations: updates (evidence: `esup-pstage-web-jsf-servlet/src/main/java/org/esupportail/pstage/web/controllers/EvaluationController.java`)
- Evaluations → Conventions: uses state (evidence: `esup-pstage-web-jsf-servlet/src/main/java/org/esupportail/pstage/web/controllers/EvaluationController.java`)
- Conventions → XML export: exports XML (evidence: `esup-pstage-web-jsf-servlet/src/main/java/org/esupportail/pstage/web/controllers/ConventionController.java`)
- Conventions → PDF utilities: generates PDF (evidence: `esup-pstage-web-jsf-servlet/src/main/java/org/esupportail/pstage/web/controllers/ConventionController.java`)
- Evaluations → XML export: exports XML (evidence: `esup-pstage-web-jsf-servlet/src/main/java/org/esupportail/pstage/web/controllers/EvaluationController.java`)
- Placement offers → XML export: exports XML (evidence: `esup-pstage-web-jsf-servlet/src/main/java/org/esupportail/pstage/web/controllers/OffreController.java`)
- Management centres → Reference access: loads components (evidence: `esup-pstage-web-jsf-servlet/src/main/java/org/esupportail/pstage/web/controllers/CentreController.java`)
- Conventions → Student records: uses records (evidence: `esup-pstage-web-jsf-servlet/src/main/java/org/esupportail/pstage/web/controllers/ConventionController.java`)
- Conventions → University records: uses records (evidence: `esup-pstage-web-jsf-servlet/src/main/java/org/esupportail/pstage/web/controllers/ConventionController.java`)
- Convention statistics → Evaluation operations: uses evaluations
- User and version DAO → User and version data: reads and writes (evidence: `esup-pstage-dao/src/main/java/org/esupportail/pstage/dao/DaoService.java`)
