# mirijamarc/eval_mai architecture

> Architecture diagram of the GitHub repository mirijamarc/eval_mai, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-07-25). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/mirijamarc/eval_mai
- Repository: https://github.com/mirijamarc/eval_mai

## Overview

##### Project type and purpose
- From the file tree and README, this is a Java Spring Boot monolithic web application (“Eval_Mai”) that manages “devis” (quotes), maisons, travaux, finitions, paiements, etc., with distinct admin and client roles. It uses server-side MVC rendering via Thymeleaf templates, static resources (JS/CSS), CSV/Excel import-export, and a relational database (populated via the utilitaire/sql scripts).

##### File structure
- Top‐level build: pom.xml, Maven wrapper.
- src/main/java/com/evaluation/Eval:
- controller/… – Spring MVC controllers (CSVImportController, DevisController, admin and client subpackages)
- dto/… – Data Transfer Objects for web layer
- entity/… – JPA/Hibernate entities & view‐mapping classes
- repository/… – Spring Data JPA repositories for CRUD and custom queries
- security/… – custom interceptor, role enum, WebMvcConfig, NoSession exception
- util/… – CSV/Excel import‐export utilities, constants, error handling
- src/main/resources:
- application.properties – configuration (e.g., DB connection)
- static/… – CSS, JS, vendor libs, uploads
- templates/… – Thymeleaf HTML views: layouts, pages (admin/client), error, PDF exports
- utilitaire/sql/… – SQL scripts for schema, data, views for different contexts (construction, cinepax, f1)

##### README
- The README only contains the project title. Use the file structure to infer architecture: classical Spring Boot MVC monolith with layered approach (Controller → DTO → Entity → Repository → DB) plus utilities and security.

##### Final advice
- Both synchronous flows (web requests) and asynchronous or batch flows (CSV import).
- Security interceptor sits on the incoming HTTP path before controllers.
- Don’t omit static resources and template engine—they form the client‐side rendering component.
- Important configuration points (application.properties for DB connection, utilitaire/sql for schema).

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Presentation Tier
    subgraph "Presentation Tier"
        direction TB
        Browser["Browser/User Interface"]:::frontend
        subgraph "Static Assets"
            direction TB
            CSS["style.css"]:::static
            HTML2PDF["html2pdf.js"]:::static
            MAINJS["main.js"]:::static
            VENDOR["vendor libs"]:::static
        end
        subgraph "Thymeleaf Templates"
            direction TB
            LAYOUT["layout.html"]:::frontend
            ADMIN_PAGE["dashboard.html"]:::frontend
            CLIENT_PAGE["nouveauDevis.html"]:::frontend
            PDF_TEMPLATE["export-Devis.html"]:::frontend
            ERROR_PAGE["erreurAuth.html"]:::frontend
        end
    end

    %% Application Tier
    subgraph "Application Tier"
        direction TB
        App["EvalMaiApplication"]:::biz

        subgraph "Security Layer"
            direction TB
            Interceptor["RoleInterceptor"]:::security
            WebConfig["WebMvcConfig"]:::security
            NoSession["NoSession"]:::security
            RoleEnum["Role"]:::security
        end

        subgraph "Web Layer - Controllers"
            direction TB
            DevisCtrl["DevisController"]:::frontend
            CSVCtrl["CSVImportController"]:::frontend
            AdminCtrl["AdminController"]:::frontend
            ClientCtrl["ClientController"]:::frontend
        end

        subgraph "DTO Layer"
            direction TB
            DevisDTO["DevisDTO"]:::biz
            MaisonDTO["MaisonDTO"]:::biz
            PayementDTO["PayementDevisDTO"]:::biz
            PageReqDTO["PageRequestDTO"]:::biz
        end

        subgraph "Persistence Layer"
            direction TB
            subgraph "Entities"
                DevisEnt["Devis"]:::biz
                MaisonEnt["Maison"]:::biz
                UserEnt["Utilisateur"]:::biz
                VDevisEnt["V_Devis"]:::biz
            end
            subgraph "Repositories"
                DevisRepo["DevisRepository"]:::biz
                MaisonRepo["MaisonRepository"]:::biz
                UserRepo["UserRepository"]:::biz
                VDevisRepo["V_DevisRepository"]:::biz
            end
        end

        subgraph "Utility Modules"
            direction TB
            CSVUtil["Csv"]:::util
            ExportCsv["ExportCsv"]:::util
            ExportExcel["ExportExcel"]:::util
            Constante["Constante"]:::util
        end
    end

    %% Database Tier
    subgraph "Database Tier"
        direction TB
        DB["Relational Database"]:::db
        subgraph "SQL Scripts"
            direction TB
            TableSQL["table.sql"]:::db
            DataSQL["data.sql"]:::db
            ViewF1["view.sql"]:::db
            BaseCPX["base.sql"]:::db
        end
    end

    %% Connections
    Browser -->|"loads static"| CSS
    Browser -->|"loads static"| HTML2PDF
    Browser -->|"loads static"| MAINJS
    Browser -->|"loads static"| VENDOR
    Browser -->|"requests page"| LAYOUT
    LAYOUT -->|"includes pages"| ADMIN_PAGE
    LAYOUT -->|"includes pages"| CLIENT_PAGE
    CLIENT_PAGE -->|"uses PDF template"| PDF_TEMPLATE
    Browser -->|"error view"| ERROR_PAGE

    Browser -->|"HTTP GET/POST"| Interceptor
    Interceptor -->|"validated"| DevisCtrl
    Interceptor -->|"validated"| CSVCtrl
    Interceptor -->|"validated"| AdminCtrl
    Interceptor -->|"validated"| ClientCtrl

    DevisCtrl -->|"uses DTO"| DevisDTO
    DevisCtrl -->|"uses DTO"| PageReqDTO
    DevisCtrl -->|"invokes repo"| DevisRepo

    CSVCtrl -->|"imports/exports"| CSVUtil
    CSVCtrl -->|"invokes util"| ExportCsv
    CSVCtrl -->|"invokes util"| ExportExcel
    CSVCtrl -->|"uses repo"| DevisRepo

    AdminCtrl -->|"uses DTO"| MaisonDTO
    AdminCtrl -->|"invokes repo"| MaisonRepo

    ClientCtrl -->|"uses DTO"| PayementDTO
    ClientCtrl -->|"invokes view entity"| VDevisEnt
    ClientCtrl -->|"invokes repo"| VDevisRepo

    DevisRepo -->|"JPA save/find"| DevisEnt
    MaisonRepo -->|"JPA save/find"| MaisonEnt
    UserRepo -->|"JPA save/find"| UserEnt
    VDevisRepo -->|"JPA query"| VDevisEnt

    DevisRepo -->|"connects"| DB
    MaisonRepo -->|"connects"| DB
    UserRepo -->|"connects"| DB
    VDevisRepo -->|"connects"| DB

    TableSQL --> DB
    DataSQL --> DB
    ViewF1 --> DB
    BaseCPX --> DB

    App -->|"bootstraps"| Interceptor
    App -->|"bootstraps"| WebConfig

    %% Click Events
    click CSS "https://github.com/mirijamarc/eval_mai/blob/main/src/main/resources/static/css/style.css"
    click HTML2PDF "https://github.com/mirijamarc/eval_mai/blob/main/src/main/resources/static/js/html2pdf.js"
    click MAINJS "https://github.com/mirijamarc/eval_mai/blob/main/src/main/resources/static/js/main.js"
    click LAYOUT "https://github.com/mirijamarc/eval_mai/blob/main/src/main/resources/templates/layouts/layout.html"
    click ADMIN_PAGE "https://github.com/mirijamarc/eval_mai/blob/main/src/main/resources/templates/pages/admin/dashboard.html"
    click CLIENT_PAGE "https://github.com/mirijamarc/eval_mai/blob/main/src/main/resources/templates/pages/client/nouveauDevis.html"
    click PDF_TEMPLATE "https://github.com/mirijamarc/eval_mai/blob/main/src/main/resources/templates/pdf/export-Devis.html"
    click ERROR_PAGE "https://github.com/mirijamarc/eval_mai/blob/main/src/main/resources/templates/errors/erreurAuth.html"
    click App "https://github.com/mirijamarc/eval_mai/blob/main/src/main/java/com/evaluation/Eval/EvalMaiApplication.java"
    click DevisCtrl "https://github.com/mirijamarc/eval_mai/blob/main/src/main/java/com/evaluation/Eval/controller/DevisController.java"
    click CSVCtrl "https://github.com/mirijamarc/eval_mai/blob/main/src/main/java/com/evaluation/Eval/controller/CSVImportController.java"
    click AdminCtrl "https://github.com/mirijamarc/eval_mai/blob/main/src/main/java/com/evaluation/Eval/controller/admin/AdminController.java"
    click ClientCtrl "https://github.com/mirijamarc/eval_mai/blob/main/src/main/java/com/evaluation/Eval/controller/client/ClientController.java"
    click DevisDTO "https://github.com/mirijamarc/eval_mai/blob/main/src/main/java/com/evaluation/Eval/dto/DevisDTO.java"
    click MaisonDTO "https://github.com/mirijamarc/eval_mai/blob/main/src/main/java/com/evaluation/Eval/dto/MaisonDTO.java"
    click PayementDTO "https://github.com/mirijamarc/eval_mai/blob/main/src/main/java/com/evaluation/Eval/dto/PayementDevisDTO.java"
    click PageReqDTO "https://github.com/mirijamarc/eval_mai/blob/main/src/main/java/com/evaluation/Eval/dto/PageRequestDTO.java"
    click DevisEnt "https://github.com/mirijamarc/eval_mai/blob/main/src/main/java/com/evaluation/Eval/entity/Devis.java"
    click MaisonEnt "https://github.com/mirijamarc/eval_mai/blob/main/src/main/java/com/evaluation/Eval/entity/Maison.java"
    click UserEnt "https://github.com/mirijamarc/eval_mai/blob/main/src/main/java/com/evaluation/Eval/entity/Utilisateur.java"
    click VDevisEnt "https://github.com/mirijamarc/eval_mai/blob/main/src/main/java/com/evaluation/Eval/entity/V_Devis.java"
    click DevisRepo "https://github.com/mirijamarc/eval_mai/blob/main/src/main/java/com/evaluation/Eval/repository/DevisRepository.java"
    click MaisonRepo "https://github.com/mirijamarc/eval_mai/blob/main/src/main/java/com/evaluation/Eval/repository/MaisonRepository.java"
    click UserRepo "https://github.com/mirijamarc/eval_mai/blob/main/src/main/java/com/evaluation/Eval/repository/UserRepository.java"
    click VDevisRepo "https://github.com/mirijamarc/eval_mai/blob/main/src/main/java/com/evaluation/Eval/repository/V_DevisRepository.java"
    click Interceptor "https://github.com/mirijamarc/eval_mai/blob/main/src/main/java/com/evaluation/Eval/security/RoleInterceptor.java"
    click WebConfig "https://github.com/mirijamarc/eval_mai/blob/main/src/main/java/com/evaluation/Eval/security/WebMvcConfig.java"
    click NoSession "https://github.com/mirijamarc/eval_mai/blob/main/src/main/java/com/evaluation/Eval/security/NoSession.java"
    click RoleEnum "https://github.com/mirijamarc/eval_mai/blob/main/src/main/java/com/evaluation/Eval/security/Role.java"
    click CSVUtil "https://github.com/mirijamarc/eval_mai/blob/main/src/main/java/com/evaluation/Eval/util/Csv.java"
    click ExportCsv "https://github.com/mirijamarc/eval_mai/blob/main/src/main/java/com/evaluation/Eval/util/ExportCsv.java"
    click ExportExcel "https://github.com/mirijamarc/eval_mai/blob/main/src/main/java/com/evaluation/Eval/util/ExportExcel.java"
    click Constante "https://github.com/mirijamarc/eval_mai/blob/main/src/main/java/com/evaluation/Eval/util/Constante.java"
    click TableSQL "https://github.com/mirijamarc/eval_mai/blob/main/utilitaire/sql/construction/table.sql"
    click DataSQL "https://github.com/mirijamarc/eval_mai/blob/main/utilitaire/sql/construction/data.sql"
    click ViewF1 "https://github.com/mirijamarc/eval_mai/blob/main/utilitaire/sql/f1/view.sql"
    click BaseCPX "https://github.com/mirijamarc/eval_mai/blob/main/utilitaire/sql/cinepax/base.sql"

    %% Styles
    classDef frontend fill:#AED6F1,stroke:#21618C,color:#17202A
    classDef biz fill:#ABEBC6,stroke:#1D8348,color:#17202A
    classDef util fill:#F9E79F,stroke:#B7950B,color:#17202A
    classDef security fill:#F5B7B1,stroke:#C0392B,color:#17202A
    classDef db fill:#D5DBDB,stroke:#424949,color:#17202A
    classDef static fill:#D6EAF8,stroke:#2874A6,color:#17202A
```
