# 0-bober-0/library-spring-learning-project architecture

> Architecture diagram of the GitHub repository 0-bober-0/library-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/0-bober-0/library-spring-learning-project
- Repository: https://github.com/0-bober-0/library-spring-learning-project

## Overview

##### Main Components

a) Client Layer:
- Web Browser interface
- HTML views (located in /webapp/WEB-INF/views/)
- Separate sections for Books and People management

b) Application Layer:
- Spring MVC Components
- Controllers (PeopleController, BooksController)
- Controller Helpers
- DAO Layer (BookDAO, PersonDAO)
- Models (Book, Person)
- Configuration (SpringConfig)

c) Data Layer:
- PostgreSQL Database
- Adminer (Database Management Tool)

**[Client Tier]**

- ▼
**[Application Tier]**

- ▼
**[Data Tier]**

##### Detailed Component Breakdown

- Rectangles: Core components
- Rounded rectangles: External services/tools

- Blue: Client-side components
- Green: Application layer components
- Yellow: Data access components
- Gray: External tools/services

##### Component Relationships

Key interactions:
**Web Browser → Controllers → DAO → Database**
- ↓
- Views

##### Specific Elements

a) Client Tier:
- HTML Views (people/, books/)
- Browser Interface
- HTTP Requests

b) Application Tier:
- Spring MVC Dispatcher Servlet
- Controllers (PeopleController, BooksController)
- Controller Helpers
- Models (Person, Book)
- DAO Layer

c) Data Tier:
- PostgreSQL Database
- Adminer Interface
- Database Tables (people, books)

##### Implementation Details

- Model attributes (Person: name, etc.)
- Book attributes (title, author, etc.)
- Controller mappings (/people, /books)
- Database schema

## Diagram (Mermaid)

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

    subgraph App["Application Layer"]
        direction TB
        DispatcherServlet["Spring MVC Dispatcher Servlet"]:::config
        
        subgraph Controllers["Controllers"]
            direction TB
            BooksController["Books Controller"]:::controller
            PeopleController["People Controller"]:::controller
        end
        
        subgraph Helpers["Controller Helpers"]
            direction TB
            BooksHelper["Books Helper"]:::helper
            PeopleHelper["People Helper"]:::helper
        end
        
        subgraph Models["Domain Models"]
            direction TB
            Book["Book Model"]:::model
            Person["Person Model"]:::model
        end
        
        subgraph DAO["Data Access Layer"]
            direction TB
            BookDAO["Book DAO"]:::dao
            PersonDAO["Person DAO"]:::dao
        end
        
        SpringConfig["Spring Configuration"]:::config
    end

    subgraph Data["Data Layer"]
        PostgreSQL[(PostgreSQL Database)]:::db
        Adminer["Adminer Tool"]:::tool
    end

    %% Relationships
    Browser --> DispatcherServlet
    DispatcherServlet --> Controllers
    
    BooksController --> BooksHelper
    PeopleController --> PeopleHelper
    
    BooksHelper --> BookDAO
    PeopleHelper --> PersonDAO
    
    BookDAO --> PostgreSQL
    PersonDAO --> PostgreSQL
    
    Controllers --> BooksViews
    Controllers --> PeopleViews
    
    BookDAO --> Book
    PersonDAO --> Person
    
    Adminer --> PostgreSQL

    %% Click Events
    click SpringConfig "https://github.com/0-Bober-0/Library-Spring-Learning-Project/blob/main/src/main/java/ru/sasha/spring/config/SpringConfig.java"
    click DispatcherServlet "https://github.com/0-Bober-0/Library-Spring-Learning-Project/blob/main/src/main/java/ru/sasha/spring/config/MySpringMvcDispatcherSerlvetIntitializer.java"
    click BooksController "https://github.com/0-Bober-0/Library-Spring-Learning-Project/blob/main/src/main/java/ru/sasha/spring/controllers/BooksController.java"
    click PeopleController "https://github.com/0-Bober-0/Library-Spring-Learning-Project/blob/main/src/main/java/ru/sasha/spring/controllers/PeopleController.java"
    click BooksHelper "https://github.com/0-Bober-0/Library-Spring-Learning-Project/blob/main/src/main/java/ru/sasha/spring/controllers/data/BooksControllerHelper.java"
    click PeopleHelper "https://github.com/0-Bober-0/Library-Spring-Learning-Project/blob/main/src/main/java/ru/sasha/spring/controllers/data/PeopleControllerHelper.java"
    click BookDAO "https://github.com/0-Bober-0/Library-Spring-Learning-Project/blob/main/src/main/java/ru/sasha/spring/dao/BookDAO.java"
    click PersonDAO "https://github.com/0-Bober-0/Library-Spring-Learning-Project/blob/main/src/main/java/ru/sasha/spring/dao/PersonDAO.java"
    click Book "https://github.com/0-Bober-0/Library-Spring-Learning-Project/blob/main/src/main/java/ru/sasha/spring/models/Book.java"
    click Person "https://github.com/0-Bober-0/Library-Spring-Learning-Project/blob/main/src/main/java/ru/sasha/spring/models/Person.java"
    click BooksViews "https://github.com/0-Bober-0/Library-Spring-Learning-Project/tree/main/src/main/webapp/WEB-INF/views/books/"
    click PeopleViews "https://github.com/0-Bober-0/Library-Spring-Learning-Project/tree/main/src/main/webapp/WEB-INF/views/people/"
    click PostgreSQL "https://github.com/0-Bober-0/Library-Spring-Learning-Project/blob/main/src/main/resources/database.properties"

    %% Styling
    classDef default fill:#fff,stroke:#333,stroke-width:2px
    classDef controller fill:#90EE90,stroke:#333
    classDef helper fill:#98FB98,stroke:#333
    classDef model fill:#F0E68C,stroke:#333
    classDef dao fill:#DDA0DD,stroke:#333
    classDef db fill:#B0C4DE,stroke:#333
    classDef config fill:#FFB6C1,stroke:#333
    classDef view fill:#87CEEB,stroke:#333
    classDef tool fill:#D3D3D3,stroke:#333
```
