# anasaeq10/pfa-4iir-project architecture

> Architecture diagram of the GitHub repository anasaeq10/pfa-4iir-project, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-08-17). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/anasaeq10/pfa-4iir-project
- Repository: https://github.com/anasaeq10/pfa-4iir-project

## Overview

##### Project Type and Purpose
- This is a monolithic, full-stack Spring Boot web application for an “Association des étudiants” platform.
- It follows an MVC pattern: browser-based UI (Thymeleaf + static assets), Spring MVC controllers, business services, JPA repositories, and a MySQL database.
- It also integrates Spring Security for auth and an EmailService for outbound SMTP notifications.

##### High-Level Container Identification
- User’s Browser (Client)
- Spring Boot Application
- Static Resource Server (CSS/JS under /static)
- Thymeleaf Template Engine (renders HTML under /templates)
- Spring MVC DispatcherServlet + SecurityFilterChain
- Controllers (/controller)
- Services (/service, including EmailService)
- Repositories (/repository)
- Configuration (/config: SecurityConfig, MvcConfig)
- MySQL Database (persistent store)
- External SMTP Mail Server (Mailtrap or similar)

##### Relationships and Data Flow
- Browser → HTTP(S) → DispatcherServlet
- DispatcherServlet → SecurityFilterChain (auth checks)
- DispatcherServlet → Controller (e.g., AuthController, DocumentController)
- Controller → Service → Repository → MySQL
- Service (EmailService) → External SMTP
- Repository → JPA EntityManager → MySQL
- Controller returns Model + View → Thymeleaf → HTML → Browser
- Static assets (CSS) served directly by Spring Boot’s resource handler

##### Architectural Patterns and Principles
- Layered Architecture (Presentation → Controller → Service → Repository → Database)
- Dependency Injection (Spring @Autowired)
- Separation of Concerns (each layer has a distinct responsibility)
- Security as a cross-cutting concern (Spring Security filters)
- Template-based MVC (Thymeleaf)

## Diagram (Mermaid)

```mermaid
flowchart TB
    Client["User Browser"]:::client
    subgraph "Spring Boot App (Java17, Maven)" 
        EP["Pfaapp4iirApplication"]:::appcomp
        StaticHandler["Static Resource Handler<br/>(CSS/JS)"]:::appcomp
        Templates["Thymeleaf Engine"]:::appcomp
        Dispatcher["DispatcherServlet"]:::appcomp
        Security["SecurityFilterChain<br/>(Spring Security)"]:::appcomp
        subgraph "Controllers" 
            AuthController["AuthController"]:::controller
            DocumentController["DocumentController"]:::controller
            EventController["EventController"]:::controller
            OffreEmploiController["OffreEmploiController"]:::controller
            ProfileController["ProfileController"]:::controller
            DashboardController["DashboardController"]:::controller
            LayoutController["LayoutController"]:::controller
            MainController["MainController"]:::controller
            StatsController["StatsController"]:::controller
        end
        subgraph "Service Layer"
            UserService["UserService"]:::service
            DocumentService["DocumentService"]:::service
            EventService["EventService"]:::service
            OffreEmploiService["OffreEmploiService"]:::service
            EmailService["EmailService"]:::service
        end
        subgraph "Repository Layer"
            UserRepository["UserRepository"]:::repo
            UserLoginRepository["UserLoginRepository"]:::repo
            DocumentRepository["DocumentRepository"]:::repo
            EventRepository["EventRepository"]:::repo
            OffreEmploiRepository["OffreEmploiRepository"]:::repo
        end
        ConfigMvc["MvcConfig"]:::config
        ConfigSecurity["SecurityConfig"]:::config
    end
    DB["MySQL Database"]:::db
    Mail["SMTP Mail Server"]:::cloud

    Client -->|"HTTP request"| Dispatcher
    Dispatcher -->|"auth check"| Security
    Security --> Dispatcher
    Dispatcher -->|"dispatch"| AuthController
    Dispatcher -->|"dispatch"| DocumentController
    Dispatcher -->|"dispatch"| EventController
    Dispatcher -->|"dispatch"| OffreEmploiController
    Dispatcher -->|"dispatch"| ProfileController
    Dispatcher -->|"dispatch"| DashboardController
    Dispatcher -->|"dispatch"| LayoutController
    Dispatcher -->|"dispatch"| MainController
    Dispatcher -->|"dispatch"| StatsController

    AuthController -->|"uses"| UserService
    DocumentController -->|"uses"| DocumentService
    EventController -->|"uses"| EventService
    OffreEmploiController -->|"uses"| OffreEmploiService
    ProfileController -->|"uses"| UserService
    DashboardController -->|"uses"| UserService
    MainController -->|"uses"| EventService
    StatsController -->|"uses"| UserService

    UserService -->|"calls"| UserRepository
    DocumentService -->|"calls"| DocumentRepository
    EventService -->|"calls"| EventRepository
    OffreEmploiService -->|"calls"| OffreEmploiRepository
    EmailService -->|"SMTP send()"| Mail

    UserRepository -->|"JPA EntityManager JDBC"| DB
    UserLoginRepository -->|"JPA EntityManager JDBC"| DB
    DocumentRepository -->|"JPA EntityManager JDBC"| DB
    EventRepository -->|"JPA EntityManager JDBC"| DB
    OffreEmploiRepository -->|"JPA EntityManager JDBC"| DB

    AuthController -->|"returns view"| Templates
    Templates -->|"HTML"| Client
    StaticHandler -->|"serves CSS/HTML"| Client

    click EP "https://github.com/anasaeq10/pfa-4iir-project/blob/main/pfaapp4iir/src/main/java/com/apppfa/pfaapp4iir/Pfaapp4iirApplication.java"
    click ConfigSecurity "https://github.com/anasaeq10/pfa-4iir-project/blob/main/pfaapp4iir/src/main/java/com/apppfa/pfaapp4iir/config/SecurityConfig.java"
    click ConfigMvc "https://github.com/anasaeq10/pfa-4iir-project/blob/main/pfaapp4iir/src/main/java/com/apppfa/pfaapp4iir/config/MvcConfig.java"
    click AuthController "https://github.com/anasaeq10/pfa-4iir-project/blob/main/pfaapp4iir/src/main/java/com/apppfa/pfaapp4iir/controller/AuthController.java"
    click DocumentController "https://github.com/anasaeq10/pfa-4iir-project/blob/main/pfaapp4iir/src/main/java/com/apppfa/pfaapp4iir/controller/DocumentController.java"
    click EventController "https://github.com/anasaeq10/pfa-4iir-project/blob/main/pfaapp4iir/src/main/java/com/apppfa/pfaapp4iir/controller/EventController.java"
    click OffreEmploiController "https://github.com/anasaeq10/pfa-4iir-project/blob/main/pfaapp4iir/src/main/java/com/apppfa/pfaapp4iir/controller/OffreEmploiController.java"
    click ProfileController "https://github.com/anasaeq10/pfa-4iir-project/blob/main/pfaapp4iir/src/main/java/com/apppfa/pfaapp4iir/controller/ProfileController.java"
    click DashboardController "https://github.com/anasaeq10/pfa-4iir-project/blob/main/pfaapp4iir/src/main/java/com/apppfa/pfaapp4iir/controller/DashboardController.java"
    click LayoutController "https://github.com/anasaeq10/pfa-4iir-project/blob/main/pfaapp4iir/src/main/java/com/apppfa/pfaapp4iir/controller/LayoutController.java"
    click MainController "https://github.com/anasaeq10/pfa-4iir-project/blob/main/pfaapp4iir/src/main/java/com/apppfa/pfaapp4iir/controller/MainController.java"
    click StatsController "https://github.com/anasaeq10/pfa-4iir-project/blob/main/pfaapp4iir/src/main/java/com/apppfa/pfaapp4iir/controller/StatsController.java"
    click UserService "https://github.com/anasaeq10/pfa-4iir-project/blob/main/pfaapp4iir/src/main/java/com/apppfa/pfaapp4iir/service/UserService.java"
    click DocumentService "https://github.com/anasaeq10/pfa-4iir-project/blob/main/pfaapp4iir/src/main/java/com/apppfa/pfaapp4iir/service/DocumentService.java"
    click EventService "https://github.com/anasaeq10/pfa-4iir-project/blob/main/pfaapp4iir/src/main/java/com/apppfa/pfaapp4iir/service/EventService.java"
    click OffreEmploiService "https://github.com/anasaeq10/pfa-4iir-project/blob/main/pfaapp4iir/src/main/java/com/apppfa/pfaapp4iir/service/OffreEmploiService.java"
    click EmailService "https://github.com/anasaeq10/pfa-4iir-project/blob/main/pfaapp4iir/src/main/java/com/apppfa/pfaapp4iir/service/EmailService.java"
    click UserRepository "https://github.com/anasaeq10/pfa-4iir-project/blob/main/pfaapp4iir/src/main/java/com/apppfa/pfaapp4iir/repository/UserRepository.java"
    click UserLoginRepository "https://github.com/anasaeq10/pfa-4iir-project/blob/main/pfaapp4iir/src/main/java/com/apppfa/pfaapp4iir/repository/UserLoginRepository.java"
    click DocumentRepository "https://github.com/anasaeq10/pfa-4iir-project/blob/main/pfaapp4iir/src/main/java/com/apppfa/pfaapp4iir/repository/DocumentRepository.java"
    click EventRepository "https://github.com/anasaeq10/pfa-4iir-project/blob/main/pfaapp4iir/src/main/java/com/apppfa/pfaapp4iir/repository/EventRepository.java"
    click OffreEmploiRepository "https://github.com/anasaeq10/pfa-4iir-project/blob/main/pfaapp4iir/src/main/java/com/apppfa/pfaapp4iir/repository/OffreEmploiRepository.java"

    classDef client fill:#a4de02,stroke:#000,stroke-width:1px
    classDef appcomp fill:#cce5ff,stroke:#004085,stroke-width:1px
    classDef controller fill:#bee5eb,stroke:#0c5460,stroke-width:1px
    classDef service fill:#d4edda,stroke:#155724,stroke-width:1px
    classDef repo fill:#fff3cd,stroke:#856404,stroke-width:1px
    classDef config fill:#e2e3e5,stroke:#6c757d,stroke-width:1px
    classDef db fill:#ffeeba,stroke:#856404,stroke-width:1px
    classDef cloud fill:#d6d8db,stroke:#1b1e21,stroke-width:1px
```
