# nourayengui/projet_tp_java architecture

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

- Interactive diagram: https://gitdiagram.com/nourayengui/projet_tp_java
- Repository: https://github.com/nourayengui/projet_tp_java

## Overview

This is a French maintenance-management web application: users manage equipment and maintenance requests, managers plan and assign interventions, and technicians carry them through status changes and reporting. The clearest demonstrated workflow is intervention planning through REST endpoints, a scheduling service, and persistence; equipment has a separate servlet/service/DAO workflow. The tree also shows authentication, statistics, competencies, unavailability, and reports, but their implementations and wiring are not evidenced in the excerpts, so those are represented as capabilities without guessed connections. Evidence is limited to the supplied excerpts and source index.

Main entry points: [`src/main/java/com/maintenance/service/PlanificationService.java`](https://github.com/nourayengui/projet_tp_java/blob/main/src/main/java/com/maintenance/service/PlanificationService.java) (Scheduling algorithms), [`src/main/java/com/maintenance/controller/InterventionController.java`](https://github.com/nourayengui/projet_tp_java/blob/main/src/main/java/com/maintenance/controller/InterventionController.java) (Intervention API), [`src/main/java/com/maintenance/controller/EquipementServlet.java`](https://github.com/nourayengui/projet_tp_java/blob/main/src/main/java/com/maintenance/controller/EquipementServlet.java) (Equipment API), [`src/main/java/com/maintenance/model/Intervention.java`](https://github.com/nourayengui/projet_tp_java/blob/main/src/main/java/com/maintenance/model/Intervention.java) (Intervention lifecycle)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web and API"]
  node_equipment_api["Equipment API"]
  node_other_endpoints["Other API endpoints"]
  node_equipment_ui["Equipment interface<br/>[equipements.html]"]
  node_intervention_ui["Intervention interface<br/>[intervention.js]"]
  node_planning_ui["Planning interface<br/>[planification.html]"]
  node_authentication["Authentication<br/>[AuthService.java]"]
end

subgraph group_planning["Planning and interventions"]
  node_planning_api["Intervention API"]
  node_planner["Scheduling algorithms"]
  node_intervention_rules["Intervention lifecycle<br/>[Intervention.java]"]
  node_statistics["Maintenance statistics"]
end

subgraph group_equipment["Equipment management"]
  node_equipment_service["Equipment rules"]
  node_equipment_store[("Equipment DAO<br/>[EquipementDAO.java]")]
  node_equipment_model["Equipment records<br/>[Equipement.java]"]
end

subgraph group_persistence["Persistence and domain"]
  node_requests["Maintenance requests<br/>[Demande.java]"]
  node_users["Users and roles<br/>[Utilisateur.java]"]
  node_competencies["Competencies<br/>[Competence.java]"]
  node_reports["Work reports<br/>[CompteRendu.java]"]
  node_availability["Technician availability"]
  node_intervention_store[("Intervention repository")]
  node_request_store[("Request repository<br/>[DemandeDAO.java]")]
  node_user_store[("User repository")]
  node_availability_store[("Availability repository")]
  node_competence_store[("Technician skills")]
  node_report_store[("Report repository")]
end

node_manager(("Manager / user"))

node_manager -->|"manages equipment"| node_equipment_api
node_equipment_api -->|"delegates CRUD"| node_equipment_service
node_equipment_service -->|"validates and persists"| node_equipment_store
node_equipment_store -->|"loads and saves"| node_equipment_model
node_manager -.->|"requests planning"| node_planning_api
node_planning_api -->|"requests proposals"| node_planner
node_planning_api -->|"lists and finds"| node_intervention_store
node_planning_api -->|"validates assignments"| node_planner
node_planner -->|"loads open requests"| node_request_store
node_planner -->|"loads technicians"| node_user_store
node_planner -->|"checks availability"| node_availability_store
node_planner -->|"checks skills"| node_competence_store
node_planner -->|"reads load and saves"| node_intervention_store
node_intervention_rules -->|"updates request status"| node_requests
node_intervention_rules -->|"requires for completion"| node_reports
node_equipment_ui -.->|"uses API"| node_equipment_api
node_intervention_ui -.->|"uses API"| node_planning_api

click node_equipment_api "https://github.com/nourayengui/projet_tp_java/blob/main/src/main/java/com/maintenance/controller/EquipementServlet.java"
click node_other_endpoints "https://github.com/nourayengui/projet_tp_java/tree/main/src/main/java/com/maintenance/controller"
click node_equipment_ui "https://github.com/nourayengui/projet_tp_java/blob/main/src/main/webapp/WEB-INF/equipements.html"
click node_intervention_ui "https://github.com/nourayengui/projet_tp_java/blob/main/src/main/webapp/WEB-INF/intervention.js"
click node_planning_ui "https://github.com/nourayengui/projet_tp_java/blob/main/src/main/webapp/WEB-INF/planification.html"
click node_planning_api "https://github.com/nourayengui/projet_tp_java/blob/main/src/main/java/com/maintenance/controller/InterventionController.java"
click node_planner "https://github.com/nourayengui/projet_tp_java/blob/main/src/main/java/com/maintenance/service/PlanificationService.java"
click node_intervention_rules "https://github.com/nourayengui/projet_tp_java/blob/main/src/main/java/com/maintenance/model/Intervention.java"
click node_requests "https://github.com/nourayengui/projet_tp_java/blob/main/src/main/java/com/maintenance/model/Demande.java"
click node_users "https://github.com/nourayengui/projet_tp_java/blob/main/src/main/java/com/maintenance/model/Utilisateur.java"
click node_competencies "https://github.com/nourayengui/projet_tp_java/blob/main/src/main/java/com/maintenance/model/Competence.java"
click node_reports "https://github.com/nourayengui/projet_tp_java/blob/main/src/main/java/com/maintenance/model/CompteRendu.java"
click node_availability "https://github.com/nourayengui/projet_tp_java/blob/main/src/main/java/com/maintenance/model/Indisponibilite.java"
click node_intervention_store "https://github.com/nourayengui/projet_tp_java/blob/main/src/main/java/com/maintenance/dao/InterventionDAO.java"
click node_request_store "https://github.com/nourayengui/projet_tp_java/blob/main/src/main/java/com/maintenance/dao/DemandeDAO.java"
click node_user_store "https://github.com/nourayengui/projet_tp_java/blob/main/src/main/java/com/maintenance/dao/UtilisateurDAO.java"
click node_availability_store "https://github.com/nourayengui/projet_tp_java/blob/main/src/main/java/com/maintenance/dao/IndisponibiliteDAO.java"
click node_competence_store "https://github.com/nourayengui/projet_tp_java/blob/main/src/main/java/com/maintenance/dao/TechnicienCompetenceDAO.java"
click node_report_store "https://github.com/nourayengui/projet_tp_java/blob/main/src/main/java/com/maintenance/dao/CompteRenduDAO.java"
click node_equipment_service "https://github.com/nourayengui/projet_tp_java/blob/main/src/main/java/com/maintenance/service/EquipementService.java"
click node_equipment_store "https://github.com/nourayengui/projet_tp_java/blob/main/src/main/java/com/maintenance/dao/EquipementDAO.java"
click node_equipment_model "https://github.com/nourayengui/projet_tp_java/blob/main/src/main/java/com/maintenance/model/Equipement.java"
click node_authentication "https://github.com/nourayengui/projet_tp_java/blob/main/src/main/java/com/maintenance/service/AuthService.java"
click node_statistics "https://github.com/nourayengui/projet_tp_java/blob/main/src/main/java/com/maintenance/service/StatistiqueService.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_equipment_api,node_other_endpoints,node_equipment_ui,node_intervention_ui,node_planning_ui,node_authentication,node_manager toneBlue
class node_planning_api,node_planner,node_intervention_rules,node_statistics toneAmber
class node_equipment_service,node_equipment_store,node_equipment_model toneMint
class node_requests,node_users,node_competencies,node_reports,node_availability,node_intervention_store,node_request_store,node_user_store,node_availability_store,node_competence_store,node_report_store toneRose
```

## Components

### Web and API

- [Equipment API](https://github.com/nourayengui/projet_tp_java/blob/main/src/main/java/com/maintenance/controller/EquipementServlet.java): `src/main/java/com/maintenance/controller/EquipementServlet.java`
- [Other API endpoints](https://github.com/nourayengui/projet_tp_java/tree/main/src/main/java/com/maintenance/controller): `src/main/java/com/maintenance/controller`
- [Equipment interface](https://github.com/nourayengui/projet_tp_java/blob/main/src/main/webapp/WEB-INF/equipements.html): `src/main/webapp/WEB-INF/equipements.html`
- [Intervention interface](https://github.com/nourayengui/projet_tp_java/blob/main/src/main/webapp/WEB-INF/intervention.js): `src/main/webapp/WEB-INF/intervention.js`
- [Planning interface](https://github.com/nourayengui/projet_tp_java/blob/main/src/main/webapp/WEB-INF/planification.html): `src/main/webapp/WEB-INF/planification.html`
- [Authentication](https://github.com/nourayengui/projet_tp_java/blob/main/src/main/java/com/maintenance/service/AuthService.java): `src/main/java/com/maintenance/service/AuthService.java`

### Planning and interventions

- [Intervention API](https://github.com/nourayengui/projet_tp_java/blob/main/src/main/java/com/maintenance/controller/InterventionController.java): `src/main/java/com/maintenance/controller/InterventionController.java`
- [Scheduling algorithms](https://github.com/nourayengui/projet_tp_java/blob/main/src/main/java/com/maintenance/service/PlanificationService.java): `src/main/java/com/maintenance/service/PlanificationService.java`
- [Intervention lifecycle](https://github.com/nourayengui/projet_tp_java/blob/main/src/main/java/com/maintenance/model/Intervention.java): `src/main/java/com/maintenance/model/Intervention.java`
- [Maintenance statistics](https://github.com/nourayengui/projet_tp_java/blob/main/src/main/java/com/maintenance/service/StatistiqueService.java): `src/main/java/com/maintenance/service/StatistiqueService.java`

### Equipment management

- [Equipment rules](https://github.com/nourayengui/projet_tp_java/blob/main/src/main/java/com/maintenance/service/EquipementService.java): `src/main/java/com/maintenance/service/EquipementService.java`
- [Equipment DAO](https://github.com/nourayengui/projet_tp_java/blob/main/src/main/java/com/maintenance/dao/EquipementDAO.java): `src/main/java/com/maintenance/dao/EquipementDAO.java`
- [Equipment records](https://github.com/nourayengui/projet_tp_java/blob/main/src/main/java/com/maintenance/model/Equipement.java): `src/main/java/com/maintenance/model/Equipement.java`

### Persistence and domain

- [Maintenance requests](https://github.com/nourayengui/projet_tp_java/blob/main/src/main/java/com/maintenance/model/Demande.java): `src/main/java/com/maintenance/model/Demande.java`
- [Users and roles](https://github.com/nourayengui/projet_tp_java/blob/main/src/main/java/com/maintenance/model/Utilisateur.java): `src/main/java/com/maintenance/model/Utilisateur.java`
- [Competencies](https://github.com/nourayengui/projet_tp_java/blob/main/src/main/java/com/maintenance/model/Competence.java): `src/main/java/com/maintenance/model/Competence.java`
- [Work reports](https://github.com/nourayengui/projet_tp_java/blob/main/src/main/java/com/maintenance/model/CompteRendu.java): `src/main/java/com/maintenance/model/CompteRendu.java`
- [Technician availability](https://github.com/nourayengui/projet_tp_java/blob/main/src/main/java/com/maintenance/model/Indisponibilite.java): `src/main/java/com/maintenance/model/Indisponibilite.java`
- [Intervention repository](https://github.com/nourayengui/projet_tp_java/blob/main/src/main/java/com/maintenance/dao/InterventionDAO.java): `src/main/java/com/maintenance/dao/InterventionDAO.java`
- [Request repository](https://github.com/nourayengui/projet_tp_java/blob/main/src/main/java/com/maintenance/dao/DemandeDAO.java): `src/main/java/com/maintenance/dao/DemandeDAO.java`
- [User repository](https://github.com/nourayengui/projet_tp_java/blob/main/src/main/java/com/maintenance/dao/UtilisateurDAO.java): `src/main/java/com/maintenance/dao/UtilisateurDAO.java`
- [Availability repository](https://github.com/nourayengui/projet_tp_java/blob/main/src/main/java/com/maintenance/dao/IndisponibiliteDAO.java): `src/main/java/com/maintenance/dao/IndisponibiliteDAO.java`
- [Technician skills](https://github.com/nourayengui/projet_tp_java/blob/main/src/main/java/com/maintenance/dao/TechnicienCompetenceDAO.java): `src/main/java/com/maintenance/dao/TechnicienCompetenceDAO.java`
- [Report repository](https://github.com/nourayengui/projet_tp_java/blob/main/src/main/java/com/maintenance/dao/CompteRenduDAO.java): `src/main/java/com/maintenance/dao/CompteRenduDAO.java`

### Other components

- **Manager / user**

## Connections

- Manager / user → Equipment API: manages equipment (evidence: `src/main/java/com/maintenance/controller/EquipementServlet.java`)
- Equipment API → Equipment rules: delegates CRUD (evidence: `src/main/java/com/maintenance/controller/EquipementServlet.java`)
- Equipment rules → Equipment DAO: validates and persists (evidence: `src/main/java/com/maintenance/service/EquipementService.java`)
- Equipment DAO → Equipment records: loads and saves (evidence: `src/main/java/com/maintenance/dao/EquipementDAO.java`)
- Manager / user → Intervention API: requests planning
- Intervention API → Scheduling algorithms: requests proposals (evidence: `src/main/java/com/maintenance/controller/InterventionController.java`)
- Intervention API → Intervention repository: lists and finds (evidence: `src/main/java/com/maintenance/controller/InterventionController.java`)
- Intervention API → Scheduling algorithms: validates assignments (evidence: `src/main/java/com/maintenance/controller/InterventionController.java`)
- Scheduling algorithms → Request repository: loads open requests (evidence: `src/main/java/com/maintenance/service/PlanificationService.java`)
- Scheduling algorithms → User repository: loads technicians (evidence: `src/main/java/com/maintenance/service/PlanificationService.java`)
- Scheduling algorithms → Availability repository: checks availability (evidence: `src/main/java/com/maintenance/service/PlanificationService.java`)
- Scheduling algorithms → Technician skills: checks skills (evidence: `src/main/java/com/maintenance/service/PlanificationService.java`)
- Scheduling algorithms → Intervention repository: reads load and saves (evidence: `src/main/java/com/maintenance/service/PlanificationService.java`)
- Intervention lifecycle → Maintenance requests: updates request status (evidence: `src/main/java/com/maintenance/model/Intervention.java`)
- Intervention lifecycle → Work reports: requires for completion (evidence: `src/main/java/com/maintenance/model/Intervention.java`)
- Equipment interface → Equipment API: uses API
- Intervention interface → Intervention API: uses API
