# iseddik/lab-management-app architecture

> Architecture diagram of the GitHub repository iseddik/lab-management-app, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-02-12). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/iseddik/lab-management-app
- Repository: https://github.com/iseddik/lab-management-app

## Overview

##### Project Type and Purpose
- This is a full-stack, monolithic Spring Boot web application (“Lab Management App”) that uses Thymeleaf for server-side rendering, Spring MVC for request handling, Spring Data JPA (Hibernate) for persistence, MySQL as the database, and Spring Security for authentication/authorization.
- Its purpose is to manage lab members, projects, publications, and resources, offering role-based dashboards to administrators, researchers, students, etc.

##### File Structure
- Top-level folders:
- src/main/java/com/example/labmanagement
– controller (MVC controllers for each entity)
– service & serviceImpl (business logic)
– repository (Spring Data JPA interfaces)
– model (JPA entity classes)
– security (Spring Security config & CustomUserDetails)
– main application entrypoint (LabmanagementApplication, ServletInitializer)
- src/main/resources
– static (CSS files)
– templates (Thymeleaf HTML views)
– application.properties (DB, security, port settings)
- Tests under src/test validate the application context.

##### Extract Insights from README
- Technology stack: Java, Spring Boot, Spring MVC, Spring Data JPA, Hibernate, MySQL, Thymeleaf, Spring Security.
- Emphasis on secure, role-based access and dynamic HTML rendering.

##### Main Components & Their Relationships
a. Client Browser (UI Layer)
- Sends HTTP(S) requests and receives HTML/CSS responses.
- Static assets (CSS) & Thymeleaf templates live on the server.

b. Web Layer (Spring MVC + Security)
- Security Filter Chain (Spring SecurityConfig → CustomUserDetailsService)
- Controllers (UserController, MemberController, ProjectController, PublicationController, ResourceController)
- Each controller handles URL endpoints, invokes the Service layer.

c. Service Layer
- Business logic classes (e.g., ProjectServiceImpl implements ProjectService)
- Transactional boundaries and inter-entity orchestration

d. Data Access Layer
- Repositories (MemberRepository, ProjectRepository, etc.)
- Spring Data JPA auto-implemented interfaces
- Hibernate ORM maps Entities (model package) to MySQL tables

e. Database
- MySQL instance (application.properties config)
- Tables: users, roles, members, projects, publications, resources, join tables for associations

##### Architectural Patterns & Principles
- MVC pattern: clear separation between Controllers (C), Services (B), Repositories/Entities (M).
- Layered Architecture: Presentation → Security → Business → Persistence → Database.
- Dependency Injection: Spring manages wiring of controllers, services, repos.
- Transaction management: Spring @Transactional on service methods.
- Role-based Access Control: Spring Security with custom UserDetails and Role entities.

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Client Browser
    Browser["Browser/Client"]:::ui

    %% Main Application
    subgraph "Spring Boot App"
        direction TB

        %% Security & MVC Layer
        subgraph "Security & MVC Layer"
            direction TB
            SecurityConfig["SecurityConfig"]:::security
            CustomUserDetails["CustomUserDetails"]:::security
            UserController["UserController"]:::security
            MemberController["MemberController"]:::security
            ProjectController["ProjectController"]:::security
            PublicationController["PublicationController"]:::security
            ResourceController["ResourceController"]:::security
        end

        %% Service Layer
        subgraph "Service Layer"
            direction TB
            UserService["UserService"]:::service
            RoleService["RoleService"]:::service
            ProjectService["ProjectService"]:::service
            ProjectServiceImpl["ProjectServiceImpl"]:::service
            PublicationService["PublicationService"]:::service
            ResourceService["ResourceService"]:::service
        end

        %% Data Access Layer
        subgraph "Data Access Layer"
            direction TB
            MemberRepository["MemberRepository"]:::data
            ProjectRepository["ProjectRepository"]:::data
            PublicationRepository["PublicationRepository"]:::data
            ResourceRepository["ResourceRepository"]:::data
            RoleRepository["RoleRepository"]:::data
            Member["Member Entity"]:::data
            Project["Project Entity"]:::data
            Publication["Publication Entity"]:::data
            Resource["Resource Entity"]:::data
            Role["Role Entity"]:::data
        end

        %% Static Assets & Templates
        subgraph "UI Layer (Static & Templates)"
            direction TB
            StaticAssets["static (CSS) & templates"]:::ui
        end
    end

    %% External Database
    MySQL["MySQL Database"]:::db

    %% Connections
    Browser -->|"HTTP GET/POST"| SecurityConfig
    SecurityConfig -->|"auth filter"| CustomUserDetails
    SecurityConfig -->|"filter chain"| UserController
    SecurityConfig -->|"filter chain"| MemberController
    SecurityConfig -->|"filter chain"| ProjectController
    SecurityConfig -->|"filter chain"| PublicationController
    SecurityConfig -->|"filter chain"| ResourceController

    UserController -->|"calls"| UserService
    MemberController -->|"calls"| RoleService
    MemberController -->|"calls"| MemberService
    ProjectController -->|"calls"| ProjectService
    PublicationController -->|"calls"| PublicationService
    ResourceController -->|"calls"| ResourceService

    ProjectService -->|"uses"| ProjectServiceImpl
    UserService -->|"CRUD"| MemberRepository
    RoleService -->|"CRUD"| RoleRepository
    ProjectServiceImpl -->|"CRUD"| ProjectRepository
    PublicationService -->|"CRUD"| PublicationRepository
    ResourceService -->|"CRUD"| ResourceRepository

    MemberRepository -->|"JPA SQL"| MySQL
    ProjectRepository -->|"JPA SQL"| MySQL
    PublicationRepository -->|"JPA SQL"| MySQL
    ResourceRepository -->|"JPA SQL"| MySQL
    RoleRepository -->|"JPA SQL"| MySQL

    MySQL -->|"ResultSets"| MemberRepository
    MySQL -->|"ResultSets"| ProjectRepository
    MySQL -->|"ResultSets"| PublicationRepository
    MySQL -->|"ResultSets"| ResourceRepository
    MySQL -->|"ResultSets"| RoleRepository

    StaticAssets --> UserController

    %% Click Events
    click StaticAssets "https://github.com/iseddik/lab-management-app/tree/main/labmanagement/src/main/resources/static"
    click StaticAssets "https://github.com/iseddik/lab-management-app/tree/main/labmanagement/src/main/resources/templates"
    click SecurityConfig "https://github.com/iseddik/lab-management-app/blob/main/labmanagement/src/main/java/com/example/labmanagement/security/SecurityConfig.java"
    click CustomUserDetails "https://github.com/iseddik/lab-management-app/blob/main/labmanagement/src/main/java/com/example/labmanagement/security/CustomUserDetails.java"
    click UserController "https://github.com/iseddik/lab-management-app/blob/main/labmanagement/src/main/java/com/example/labmanagement/controller/UserController.java"
    click MemberController "https://github.com/iseddik/lab-management-app/blob/main/labmanagement/src/main/java/com/example/labmanagement/controller/MemberController.java"
    click ProjectController "https://github.com/iseddik/lab-management-app/blob/main/labmanagement/src/main/java/com/example/labmanagement/controller/ProjectController.java"
    click PublicationController "https://github.com/iseddik/lab-management-app/blob/main/labmanagement/src/main/java/com/example/labmanagement/controller/PublicationController.java"
    click ResourceController "https://github.com/iseddik/lab-management-app/blob/main/labmanagement/src/main/java/com/example/labmanagement/controller/ResourceController.java"
    click UserService "https://github.com/iseddik/lab-management-app/blob/main/labmanagement/src/main/java/com/example/labmanagement/service/UserService.java"
    click RoleService "https://github.com/iseddik/lab-management-app/blob/main/labmanagement/src/main/java/com/example/labmanagement/service/RoleService.java"
    click ProjectService "https://github.com/iseddik/lab-management-app/blob/main/labmanagement/src/main/java/com/example/labmanagement/service/ProjectService.java"
    click ProjectServiceImpl "https://github.com/iseddik/lab-management-app/blob/main/labmanagement/src/main/java/com/example/labmanagement/service/ProjectServiceImpl.java"
    click PublicationService "https://github.com/iseddik/lab-management-app/blob/main/labmanagement/src/main/java/com/example/labmanagement/service/PublicationService.java"
    click ResourceService "https://github.com/iseddik/lab-management-app/blob/main/labmanagement/src/main/java/com/example/labmanagement/service/ResourceService.java"
    click MemberRepository "https://github.com/iseddik/lab-management-app/blob/main/labmanagement/src/main/java/com/example/labmanagement/repository/MemberRepository.java"
    click ProjectRepository "https://github.com/iseddik/lab-management-app/blob/main/labmanagement/src/main/java/com/example/labmanagement/repository/ProjectRepository.java"
    click PublicationRepository "https://github.com/iseddik/lab-management-app/blob/main/labmanagement/src/main/java/com/example/labmanagement/repository/PublicationRepository.java"
    click ResourceRepository "https://github.com/iseddik/lab-management-app/blob/main/labmanagement/src/main/java/com/example/labmanagement/repository/ResourceRepository.java"
    click RoleRepository "https://github.com/iseddik/lab-management-app/blob/main/labmanagement/src/main/java/com/example/labmanagement/repository/RoleRepository.java"
    click Member "https://github.com/iseddik/lab-management-app/blob/main/labmanagement/src/main/java/com/example/labmanagement/model/Member.java"
    click Project "https://github.com/iseddik/lab-management-app/blob/main/labmanagement/src/main/java/com/example/labmanagement/model/Project.java"
    click Publication "https://github.com/iseddik/lab-management-app/blob/main/labmanagement/src/main/java/com/example/labmanagement/model/Publication.java"
    click Resource "https://github.com/iseddik/lab-management-app/blob/main/labmanagement/src/main/java/com/example/labmanagement/model/Resource.java"
    click Role "https://github.com/iseddik/lab-management-app/blob/main/labmanagement/src/main/java/com/example/labmanagement/model/Role.java"
    click LabmanagementApplication "https://github.com/iseddik/lab-management-app/blob/main/labmanagement/src/main/java/com/example/labmanagement/LabmanagementApplication.java"
    click ServletInitializer "https://github.com/iseddik/lab-management-app/blob/main/labmanagement/src/main/java/com/example/labmanagement/ServletInitializer.java"
    click ApplicationProperties "https://github.com/iseddik/lab-management-app/blob/main/labmanagement/src/main/resources/application.properties"
    click LabmanagementApplicationTests "https://github.com/iseddik/lab-management-app/blob/main/labmanagement/src/test/java/com/example/labmanagement/LabmanagementApplicationTests.java"

    %% Styles
    classDef ui fill:#ADD8E6,stroke:#000
    classDef security fill:#9f6,stroke:#000
    classDef service fill:#FFA500,stroke:#000
    classDef data fill:#9370DB,stroke:#000
    classDef db fill:#D3D3D3,stroke:#000
```
