# chikashishirozu/springboot-gradle-blog architecture

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

- Interactive diagram: https://gitdiagram.com/chikashishirozu/springboot-gradle-blog
- Repository: https://github.com/chikashishirozu/springboot-gradle-blog

## Overview

##### File structure
- Top-level artifacts:
- build.gradle, gradle wrapper → build system (Gradle)
- h2-*.jar → embedded database drivers
- src/main/java/com/example/blog → application code
- src/main/resources → configuration, SQL migrations, static assets, and Thymeleaf templates
- src/test → unit and integration tests + test migrations
- Java packages under com.example.blog:
- Controllers (e.g. HomeController, BlogController, UserController, AdminController, AuthController, ErrorController, LoginController)
- Services (BlogService, UserService, CustomUserDetailsService)
- Repositories (BlogRepository, UserRepository, PostRepository, plus Spring Data JPA interfaces)
- Domain entities (User, Post, CustomUser, UserPrincipal, CustomUserDetails)
- Security (SecurityConfig, RestTemplateConfig, DataLoader, Auth code)
- Resources:
- application.properties → Spring Boot settings
- db/migration → Flyway scripts V1…V6
- static/css, static/images → front-end assets
- templates/… → Thymeleaf HTML pages
- Notable extras: RestTemplateExample for external HTTP calls, DataLoader to bootstrap sample data, migration scripts in test resources.

## Diagram (Mermaid)

```mermaid
flowchart TD
    subgraph "Client Layer"
        Browser["Browser"]:::external
    end

    subgraph "Presentation Layer"
        CSS["static/css"]:::presentation
        Images["static/images"]:::presentation
        Templates["Thymeleaf Templates"]:::presentation
        AdminTemplates["Admin Templates"]:::presentation
    end

    subgraph "Web/MVC Layer"
        SecurityChain["Spring Security Filter Chain"]:::security
        HomeC["HomeController"]:::controller
        BlogC["BlogController"]:::controller
        PostC["PostController"]:::controller
        UserC["UserController"]:::controller
        AuthC["AuthController"]:::controller
        LoginC["LoginController"]:::controller
        AdminC["AdminController"]:::controller
        ErrorC["ErrorController"]:::controller
    end

    subgraph "Service Layer"
        BlogS["BlogService"]:::service
        UserS["UserService"]:::service
        CustomUDS["CustomUserDetailsService"]:::service
    end

    subgraph "Data Access Layer"
        BlogR["BlogRepository"]:::repository
        PostR["PostRepository"]:::repository
        UserR["UserRepository"]:::repository
    end

    subgraph "Persistence"
        Flyway["Flyway Migrations"]:::database
        DataLoader["DataLoader"]:::database
        H2["H2 Database"]:::database
    end

    subgraph "Configuration & Boot"
        RestConfig["RestTemplateConfig"]:::config
        SpringApp["BlogApplication"]:::config
        AppProps["application.properties"]:::config
        Gradle["build.gradle"]:::config
    end

    subgraph "External Services"
        RestExample["RestTemplateExample"]:::external
        ExternalAPI["External REST API"]:::external
    end

    %% Connections
    Browser -->|"HTTP"| SecurityChain
    Browser -->|"GET CSS"| CSS
    Browser -->|"GET Images"| Images

    SecurityChain -->|authenticated| HomeC
    SecurityChain -->|authenticated| BlogC
    SecurityChain -->|authenticated| PostC
    SecurityChain -->|authenticated| UserC
    SecurityChain -->|authenticated| AuthC
    SecurityChain -->|authenticated| LoginC
    SecurityChain -->|authenticated| AdminC
    SecurityChain -->|authenticated| ErrorC

    HomeC -->|"render"| Templates
    BlogC -->|"render"| Templates
    PostC -->|"render"| Templates
    UserC -->|"render"| Templates
    AuthC -->|"render"| Templates
    LoginC -->|"render"| Templates
    AdminC -->|"render"| AdminTemplates
    ErrorC -->|"render"| Templates

    HomeC -->|uses| BlogS
    BlogC -->|uses| BlogS
    PostC -->|uses| BlogS
    UserC -->|uses| UserS
    AuthC -->|uses| CustomUDS
    LoginC -->|uses| CustomUDS
    AdminC -->|uses| BlogS
    AdminC -->|uses| UserS

    BlogS -->|CRUD| BlogR
    BlogS -->|CRUD| PostR
    UserS -->|CRUD| UserR
    CustomUDS -->|loadUser| UserR

    BlogR -->|JDBC| H2
    PostR -->|JDBC| H2
    UserR -->|JDBC| H2

    Flyway -->|migrate| H2
    SpringApp -->|bootstrap| Flyway
    SpringApp -->|bootstrap| DataLoader
    DataLoader -->|seed| H2

    RestConfig -->|provides| RestExample
    RestExample -->|calls| ExternalAPI

    SpringApp -->|runs| SecurityChain

    %% Click Events
    click CSS "https://github.com/chikashishirozu/springboot-gradle-blog/blob/main/src/main/resources/static/css/styles.css"
    click Images "https://github.com/chikashishirozu/springboot-gradle-blog/tree/main/src/main/resources/static/images"
    click Templates "https://github.com/chikashishirozu/springboot-gradle-blog/tree/main/src/main/resources/templates"
    click AdminTemplates "https://github.com/chikashishirozu/springboot-gradle-blog/tree/main/src/main/resources/templates/admin"
    click HomeC "https://github.com/chikashishirozu/springboot-gradle-blog/blob/main/src/main/java/com/example/blog/HomeController.java"
    click BlogC "https://github.com/chikashishirozu/springboot-gradle-blog/blob/main/src/main/java/com/example/blog/BlogController.java"
    click PostC "https://github.com/chikashishirozu/springboot-gradle-blog/blob/main/src/main/java/com/example/blog/PostController.java"
    click UserC "https://github.com/chikashishirozu/springboot-gradle-blog/blob/main/src/main/java/com/example/blog/UserController.java"
    click AuthC "https://github.com/chikashishirozu/springboot-gradle-blog/blob/main/src/main/java/com/example/blog/AuthController.java"
    click LoginC "https://github.com/chikashishirozu/springboot-gradle-blog/blob/main/src/main/java/com/example/blog/LoginController.java"
    click AdminC "https://github.com/chikashishirozu/springboot-gradle-blog/blob/main/src/main/java/com/example/blog/AdminController.java"
    click ErrorC "https://github.com/chikashishirozu/springboot-gradle-blog/blob/main/src/main/java/com/example/blog/ErrorController.java"
    click BlogS "https://github.com/chikashishirozu/springboot-gradle-blog/blob/main/src/main/java/com/example/blog/BlogService.java"
    click UserS "https://github.com/chikashishirozu/springboot-gradle-blog/blob/main/src/main/java/com/example/blog/UserService.java"
    click CustomUDS "https://github.com/chikashishirozu/springboot-gradle-blog/blob/main/src/main/java/com/example/blog/CustomUserDetailsService.java"
    click BlogR "https://github.com/chikashishirozu/springboot-gradle-blog/blob/main/src/main/java/com/example/blog/BlogRepository.java"
    click PostR "https://github.com/chikashishirozu/springboot-gradle-blog/blob/main/src/main/java/com/example/blog/PostRepository.java"
    click UserR "https://github.com/chikashishirozu/springboot-gradle-blog/blob/main/src/main/java/com/example/blog/UserRepository.java"
    click Flyway "https://github.com/chikashishirozu/springboot-gradle-blog/tree/main/src/main/resources/db/migration"
    click DataLoader "https://github.com/chikashishirozu/springboot-gradle-blog/blob/main/src/main/java/com/example/blog/DataLoader.java"
    click RestConfig "https://github.com/chikashishirozu/springboot-gradle-blog/blob/main/src/main/java/com/example/blog/RestTemplateConfig.java"
    click RestExample "https://github.com/chikashishirozu/springboot-gradle-blog/blob/main/src/main/java/com/example/blog/RestTemplateExample.java"
    click AppProps "https://github.com/chikashishirozu/springboot-gradle-blog/blob/main/src/main/resources/application.properties"
    click SpringApp "https://github.com/chikashishirozu/springboot-gradle-blog/blob/main/src/main/java/com/example/blog/BlogApplication.java"
    click Gradle "https://github.com/chikashishirozu/springboot-gradle-blog/blob/main/build.gradle"

    %% Styles
    classDef external fill:#e3f2fd,stroke:#90caf9
    classDef presentation fill:#ffecb3,stroke:#ffb300
    classDef controller fill:#c8e6c9,stroke:#66bb6a
    classDef service fill:#d1c4e9,stroke:#ab47bc
    classDef repository fill:#ffe0b2,stroke:#ffa726
    classDef database fill:#b3e5fc,stroke:#42a5f5
    classDef security fill:#ffcdd2,stroke:#ef5350
    classDef config fill:#f0f4c3,stroke:#c0ca33
```
