# prj-foody/foody-back architecture

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

- Interactive diagram: https://gitdiagram.com/prj-foody/foody-back
- Repository: https://github.com/prj-foody/foody-back

## Overview

##### Project type and purpose
- This is a full-stack monolithic web application: a food shopping mall named “Foody.”
- Backend: Java 11, Spring Boot, MVC pattern with Controllers → Services → Repositories.
- Frontend: server-side rendered Thymeleaf templates plus static assets (CSS/SCSS, JS, images).
- Database: H2 (TCP mode).

##### Key architectural layers and top-level directories
- src/main/java/com/prjfoody/foody/config  → configuration (MVC, QueryDSL).
- src/main/java/com/prjfoody/foody/controller  → HTTP request handlers (BasketController, ProductController, etc.).
- src/main/java/com/prjfoody/foody/service  → business logic services.
- src/main/java/com/prjfoody/foody/repository  → data access interfaces (Spring Data/JPA/QueryDSL).
- src/main/java/com/prjfoody/foody/domain  → JPA entities and value types.
- src/main/resources/templates & static  → Thymeleaf HTML templates and CSS/JS assets.

- Client / Web Browser (User)
- Embedded Web Server (Spring Boot on Tomcat)
- MVC Layers:
– Controllers
– Service Layer
– Repository Layer
– Domain Model (Entities)
- Template Engine (Thymeleaf) & Static Asset Handler
- Database (H2 TCP server)
- H2 Console (admin tool)
1. User → HTTP Request → Controllers
2. Controllers → invoke Service Layer → business rules
3. Service Layer → calls Repository Layer → CRUD on H2 DB
4. Repository returns Entity objects → Service → Controller
5. Controller → selects Thymeleaf template or JSON view → renders HTML + static assets → User
6. Admin Ad Hoc: Spring Boot serves H2 Console via web UI
c. Architectural patterns:
- Layered MVC (presentation, business, persistence)
- Dependency Injection (Spring @Autowired)
- Template-based rendering (Thymeleaf)
- Configuration separation (application.yml, MvcConfiguration, QueryDslConfig)
d. Major technologies on each component:
- Spring Boot (embedded Tomcat, Spring MVC)
- Thymeleaf templates
- SCSS/CSS/JavaScript (static resources)
- H2 Database (JDBC URL: tcp://localhost/~/test_foody)
- QueryDSL for type-safe queries

##### Final recommendations
- Cross-cutting concerns such as exception handling (ExceptionHandlerControllerAdvice) and initialization routines (InitSampleDB).
- Review with stakeholders to ensure all critical interactions (e.g., user → basket → order workflow) are covered.

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Client
    User["Web Browser (User)"]:::external

    %% Spring Boot Application Container
    subgraph "Spring Boot Application"
        FoodyApp["FoodyApplication"]:::external
        InitDB1["InitSampleDB"]:::config
        InitDBSD["InitSampleDBSD"]:::config

        subgraph "Configuration Layer"
            MvcConfig["MvcConfiguration"]:::config
            QueryDsl["QueryDslConfig"]:::config
            AppYml["application.yml"]:::config
        end

        subgraph "Presentation Layer"
            BasketCtrl["BasketController"]:::presentation
            ProdCtrl["ProductController"]:::presentation
            OrderCtrl["OrderController"]:::presentation
            NoticeCtrl["NoticeController"]:::presentation
            MtmCtrl["MtmController"]:::presentation
            EventCtrl["EventController"]:::presentation
            UserCtrl["UserController"]:::presentation
            MainCtrl["MainController"]:::presentation
            ExHandler["ExceptionHandlerControllerAdvice"]:::presentation
        end

        subgraph "Business Layer"
            BasketSvc["BasketServices"]:::business
            ProdSvc["ProductServices"]:::business
            OrderSvc["OrderServices"]:::business
            NoticeSvc["NoticeServices"]:::business
            MtmSvc["MtmServices"]:::business
            EventSvc["EventServices"]:::business
            UserSvc["UserServices"]:::business
            ServicesMarker["Services (marker)"]:::business
        end

        subgraph "Persistence Layer"
            BasketRepo["BasketRepository"]:::persistence
            ProdRepo["ProductRepository"]:::persistence
            OrderRepo["OrderRepository"]:::persistence
            NoticeRepo["NoticeRepository"]:::persistence
            MtmRepo["MtmRepository"]:::persistence
            EventRepo["EventRepository"]:::persistence
            UserRepo["UserRepository"]:::persistence
            ReposMarker["Repositories (marker)"]:::persistence
        end

        subgraph "Domain Model"
            Entities["Entities & Types"]:::persistence
        end

        subgraph "Template & Static"
            Templates["Thymeleaf Templates"]:::presentation
            StaticHandler["Static Assets (CSS/JS/Images)"]:::presentation
        end
    end

    %% H2 Server
    subgraph "H2 Server"
        H2Console["H2 Console"]:::external
        H2DB["H2 Database"]:::external
    end

    %% Flows
    User -->|"HTTP Request"| BasketCtrl
    User -->|"HTTP Request"| ProdCtrl
    User -->|"HTTP Request"| OrderCtrl
    User -->|"HTTP Request"| NoticeCtrl
    User -->|"HTTP Request"| MtmCtrl
    User -->|"HTTP Request"| EventCtrl
    User -->|"HTTP Request"| UserCtrl
    User -->|"HTTP Request"| MainCtrl

    BasketCtrl -->|"calls"| BasketSvc
    ProdCtrl -->|"calls"| ProdSvc
    OrderCtrl -->|"calls"| OrderSvc
    NoticeCtrl -->|"calls"| NoticeSvc
    MtmCtrl -->|"calls"| MtmSvc
    EventCtrl -->|"calls"| EventSvc
    UserCtrl -->|"calls"| UserSvc
    MainCtrl -->|"calls"| ServicesMarker

    BasketSvc -->|"uses"| BasketRepo
    ProdSvc -->|"uses"| ProdRepo
    OrderSvc -->|"uses"| OrderRepo
    NoticeSvc -->|"uses"| NoticeRepo
    MtmSvc -->|"uses"| MtmRepo
    EventSvc -->|"uses"| EventRepo
    UserSvc -->|"uses"| UserRepo

    BasketRepo -->|"manages"| Entities
    ProdRepo -->|"manages"| Entities
    OrderRepo -->|"manages"| Entities
    NoticeRepo -->|"manages"| Entities
    MtmRepo -->|"manages"| Entities
    EventRepo -->|"manages"| Entities
    UserRepo -->|"manages"| Entities

    Entities -->|"JDBC"| H2DB
    AppYml -->|"configures"| H2Console

    BasketCtrl -->|"renders"| Templates
    ProdCtrl -->|"renders"| Templates
    OrderCtrl -->|"renders"| Templates
    NoticeCtrl -->|"renders"| Templates
    MtmCtrl -->|"renders"| Templates
    EventCtrl -->|"renders"| Templates
    UserCtrl -->|"renders"| Templates
    MainCtrl -->|"renders"| Templates

    Templates -->|"includes"| StaticHandler

    User -->|"Access H2 Console"| H2Console

    %% Click Events
    click FoodyApp "https://github.com/prj-foody/foody-back/blob/main/src/main/java/com/prjfoody/foody/FoodyApplication.java"
    click InitDB1 "https://github.com/prj-foody/foody-back/blob/main/src/main/java/com/prjfoody/foody/InitSampleDB.java"
    click InitDBSD "https://github.com/prj-foody/foody-back/blob/main/src/main/java/com/prjfoody/foody/InitSampleDBSD.java"
    click MvcConfig "https://github.com/prj-foody/foody-back/blob/main/src/main/java/com/prjfoody/foody/config/MvcConfiguration.java"
    click QueryDsl "https://github.com/prj-foody/foody-back/blob/main/src/main/java/com/prjfoody/foody/config/QueryDslConfig.java"
    click AppYml "https://github.com/prj-foody/foody-back/blob/main/src/main/resources/application.yml"
    click BasketCtrl "https://github.com/prj-foody/foody-back/blob/main/src/main/java/com/prjfoody/foody/controller/BasketController.java"
    click ProdCtrl "https://github.com/prj-foody/foody-back/blob/main/src/main/java/com/prjfoody/foody/controller/ProductController.java"
    click OrderCtrl "https://github.com/prj-foody/foody-back/blob/main/src/main/java/com/prjfoody/foody/controller/OrderController.java"
    click NoticeCtrl "https://github.com/prj-foody/foody-back/blob/main/src/main/java/com/prjfoody/foody/controller/NoticeController.java"
    click MtmCtrl "https://github.com/prj-foody/foody-back/blob/main/src/main/java/com/prjfoody/foody/controller/MtmController.java"
    click EventCtrl "https://github.com/prj-foody/foody-back/blob/main/src/main/java/com/prjfoody/foody/controller/EventController.java"
    click UserCtrl "https://github.com/prj-foody/foody-back/blob/main/src/main/java/com/prjfoody/foody/controller/UserController.java"
    click MainCtrl "https://github.com/prj-foody/foody-back/blob/main/src/main/java/com/prjfoody/foody/controller/MainController.java"
    click ExHandler "https://github.com/prj-foody/foody-back/blob/main/src/main/java/com/prjfoody/foody/controller/ExceptionHandlerControllerAdvice.java"
    click BasketSvc "https://github.com/prj-foody/foody-back/blob/main/src/main/java/com/prjfoody/foody/service/BasketServices.java"
    click ProdSvc "https://github.com/prj-foody/foody-back/blob/main/src/main/java/com/prjfoody/foody/service/ProductServices.java"
    click OrderSvc "https://github.com/prj-foody/foody-back/blob/main/src/main/java/com/prjfoody/foody/service/OrderServices.java"
    click NoticeSvc "https://github.com/prj-foody/foody-back/blob/main/src/main/java/com/prjfoody/foody/service/NoticeServices.java"
    click MtmSvc "https://github.com/prj-foody/foody-back/blob/main/src/main/java/com/prjfoody/foody/service/MtmServices.java"
    click EventSvc "https://github.com/prj-foody/foody-back/blob/main/src/main/java/com/prjfoody/foody/service/EventServices.java"
    click UserSvc "https://github.com/prj-foody/foody-back/blob/main/src/main/java/com/prjfoody/foody/service/UserServices.java"
    click ServicesMarker "https://github.com/prj-foody/foody-back/blob/main/src/main/java/com/prjfoody/foody/service/Services.java"
    click BasketRepo "https://github.com/prj-foody/foody-back/blob/main/src/main/java/com/prjfoody/foody/repository/BasketRepository.java"
    click ProdRepo "https://github.com/prj-foody/foody-back/blob/main/src/main/java/com/prjfoody/foody/repository/ProductRepository.java"
    click OrderRepo "https://github.com/prj-foody/foody-back/blob/main/src/main/java/com/prjfoody/foody/repository/OrderRepository.java"
    click NoticeRepo "https://github.com/prj-foody/foody-back/blob/main/src/main/java/com/prjfoody/foody/repository/NoticeRepository.java"
    click MtmRepo "https://github.com/prj-foody/foody-back/blob/main/src/main/java/com/prjfoody/foody/repository/MtmRepository.java"
    click EventRepo "https://github.com/prj-foody/foody-back/blob/main/src/main/java/com/prjfoody/foody/repository/EventRepository.java"
    click UserRepo "https://github.com/prj-foody/foody-back/blob/main/src/main/java/com/prjfoody/foody/repository/UserRepository.java"
    click ReposMarker "https://github.com/prj-foody/foody-back/blob/main/src/main/java/com/prjfoody/foody/repository/Repositories.java"
    click Entities "https://github.com/prj-foody/foody-back/tree/main/src/main/java/com/prjfoody/foody/domain"
    click Templates "https://github.com/prj-foody/foody-back/tree/main/src/main/resources/templates"
    click StaticHandler "https://github.com/prj-foody/foody-back/tree/main/src/main/resources/static"

    %% Styles
    classDef presentation fill:#D6E9F8,stroke:#31708F
    classDef business fill:#DFF0D8,stroke:#3C763D
    classDef persistence fill:#FCF8E3,stroke:#8A6D3B
    classDef config fill:#F2DEDE,stroke:#A94442
    classDef external fill:#EEEEEE,stroke:#777777
```
