# only1skill/spring-learning-project architecture

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

- Interactive diagram: https://gitdiagram.com/only1skill/spring-learning-project
- Repository: https://github.com/only1skill/spring-learning-project

## Overview

##### Project Type Analysis
This is a full-stack web application built with Spring MVC, following a traditional layered architecture pattern. It's a library management system with PostgreSQL database backend and Thymeleaf-based frontend.

##### Main Components

A. Client Layer:
- Web Browser
- HTML Views (located in /webapp/WEB-INF/views/)
- Separate sections for Books and People views

B. Application Layer:
- Spring MVC Components:
- DispatcherServlet (MySpringMvcDispatcherSerlvetIntitializer)
- Controllers (PeopleController, BooksController)
- Controller Helpers (PeopleControllerHelper, BooksControllerHelper)
- Configuration:
- SpringConfig
- Database Properties

C. Data Access Layer:
- DAO Layer (BookDAO, PersonDAO)
- Models (Book, Person)

D. Database Layer:
- PostgreSQL Database
- Adminer (Database Management Tool)

**┌─────────────────┐         ┌─────────────────┐**
- Web Browser   │         │     Adminer     │
- ┬────────┘         └────────┬────────┘

- ▼                           ▼
**┌─────────────────────────────────────────────┐**
- Docker Environment               │
- ┤

- ┌─────────────────┐    ┌───────────────┐  │
- Spring MVC    │    │   PostgreSQL  │  │
- Application   │◄──►│   Database    │  │
- ┬────────┘    └───────────────┘  │

- ┼─────────────────────────────────┘

**┌───────────┼─────────────┐**
- Internal Structure     │
- ┌─────────────────┐   │
- Controllers   │   │
- ┬────────┘   │
- ▼            │
- ┌─────────────────┐   │
- DAO        │   │
- ┬────────┘   │
- ▼            │
- ┌─────────────────┐   │
- Models      │   │
- ┘   │
- ┘

##### Key Elements to Highlight
- Docker containerization (show container boundaries)
- MVC pattern implementation
- Database interaction flow
- Controller-DAO-Model relationships
- View template organization

## Diagram (Mermaid)

```mermaid
flowchart TB
    subgraph Client["Client Layer"]
        Browser["Web Browser"]
        subgraph Views["Views"]
            direction TB
            BooksViews["Books Views"]:::view
            PeopleViews["People Views"]:::view
        end
    end

    subgraph Docker["Docker Environment"]
        direction TB
        subgraph AppServer["Application Server"]
            direction TB
            subgraph SpringMVC["Spring MVC Components"]
                direction TB
                Dispatcher["DispatcherServlet"]:::config
                SpringConfig["Spring Config"]:::config
                
                subgraph Controllers["Controllers Layer"]
                    direction TB
                    BooksController["Books Controller"]:::controller
                    PeopleController["People Controller"]:::controller
                    BooksHelper["Books Helper"]:::controller
                    PeopleHelper["People Helper"]:::controller
                end

                subgraph DAL["Data Access Layer"]
                    direction TB
                    BookDAO["Book DAO"]:::dao
                    PersonDAO["Person DAO"]:::dao
                end

                subgraph Models["Domain Models"]
                    direction TB
                    Book["Book Model"]:::model
                    Person["Person Model"]:::model
                end
            end
        end

        subgraph DB["Database Layer"]
            direction TB
            Postgres[("PostgreSQL")]:::database
            DBConfig["Database Config"]:::config
            Adminer["Adminer UI"]:::tool
        end
    end

    %% Relationships
    Browser --> Views
    Views --> Dispatcher
    Dispatcher --> Controllers
    
    BooksController --> BooksHelper
    PeopleController --> PeopleHelper
    
    BooksHelper --> BookDAO
    PeopleHelper --> PersonDAO
    
    BookDAO --> Book
    PersonDAO --> Person
    
    BookDAO --> Postgres
    PersonDAO --> Postgres
    
    Adminer --> Postgres

    %% Click Events
    click Views "https://github.com/Only1Skill/Spring-Learning-Project/tree/main/src/main/webapp/WEB-INF/views/"
    click BooksViews "https://github.com/Only1Skill/Spring-Learning-Project/tree/main/src/main/webapp/WEB-INF/views/books/"
    click PeopleViews "https://github.com/Only1Skill/Spring-Learning-Project/tree/main/src/main/webapp/WEB-INF/views/people/"
    click Dispatcher "https://github.com/Only1Skill/Spring-Learning-Project/blob/main/src/main/java/ru/leonid/spring/config/MySpringMvcDispatcherSerlvetIntitializer.java"
    click SpringConfig "https://github.com/Only1Skill/Spring-Learning-Project/blob/main/src/main/java/ru/leonid/spring/config/SpringConfig.java"
    click BooksController "https://github.com/Only1Skill/Spring-Learning-Project/blob/main/src/main/java/ru/leonid/spring/controllers/BooksController.java"
    click PeopleController "https://github.com/Only1Skill/Spring-Learning-Project/blob/main/src/main/java/ru/leonid/spring/controllers/PeopleController.java"
    click BooksHelper "https://github.com/Only1Skill/Spring-Learning-Project/blob/main/src/main/java/ru/leonid/spring/controllers/data/BooksControllerHelper.java"
    click PeopleHelper "https://github.com/Only1Skill/Spring-Learning-Project/blob/main/src/main/java/ru/leonid/spring/controllers/data/PeopleControllerHelper.java"
    click BookDAO "https://github.com/Only1Skill/Spring-Learning-Project/blob/main/src/main/java/ru/leonid/spring/dao/BookDAO.java"
    click PersonDAO "https://github.com/Only1Skill/Spring-Learning-Project/blob/main/src/main/java/ru/leonid/spring/dao/PersonDAO.java"
    click Book "https://github.com/Only1Skill/Spring-Learning-Project/blob/main/src/main/java/ru/leonid/spring/models/Book.java"
    click Person "https://github.com/Only1Skill/Spring-Learning-Project/blob/main/src/main/java/ru/leonid/spring/models/Person.java"
    click DBConfig "https://github.com/Only1Skill/Spring-Learning-Project/blob/main/src/main/resources/database.properties"
    click Docker "https://github.com/Only1Skill/Spring-Learning-Project/blob/main/docker-compose.yml"

    %% Styling
    classDef view fill:#2196F3,stroke:#1565C0,color:white
    classDef controller fill:#4CAF50,stroke:#2E7D32,color:white
    classDef dao fill:#FF9800,stroke:#EF6C00,color:white
    classDef model fill:#9C27B0,stroke:#6A1B9A,color:white
    classDef database fill:#F44336,stroke:#C62828,color:white
    classDef config fill:#607D8B,stroke:#37474F,color:white
    classDef tool fill:#795548,stroke:#3E2723,color:white
```
