# djatjs/kihibooks architecture

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

- Interactive diagram: https://gitdiagram.com/djatjs/kihibooks
- Repository: https://github.com/djatjs/kihibooks

## Overview

##### Project Type and Purpose
- KiHiBooks is a monolithic, server-rendered full-stack web application built with Spring Boot and Thymeleaf. It provides user management features—signup, login, profile editing—persisted to a relational database via MyBatis.

##### File-Structure Analysis
- Top-level:
- `kihibooks/` – Maven project root containing source, config, resources
- `DB/키히북스 DDL.sql` – database schema definition
- `package.json` & `package-lock.json` – client-side dependency manifest (e.g., for static asset build)
- Under `src/main/java`:
- `config/` – Spring and MyBatis configuration classes
- `controller/` – MVC controllers handling HTTP routes
- `service/` – business logic services
- `dao/` – data access objects using MyBatis mappers
- `model/vo/` – value objects for User and Email
- Under `src/main/resources`:
- `mappers/` – MyBatis XML mapping files
- `static/` – CSS/JS/images/banners served directly to the client
- `templates/` – Thymeleaf HTML views and layout fragments

##### Key Architectural Patterns
- Classic layered MVC: Presentation (Thymeleaf + static), Controller, Service, DAO, Database
- Dependency Injection via Spring
- Persistence abstraction via MyBatis
- Build & dependency management via Maven; optional front‐end tooling via npm

##### Main System Components
a. Client Browser
b. Spring Boot Application
1. Static Resource Handler (serves CSS/JS/images)
2. Thymeleaf View Resolver & Templates
3. Controllers (`UserController`, `MainController`)
4. Service Layer (`UserService`)
5. DAO Layer (`UserDAO`)
6. MyBatis Mapper (`UserMapper.xml`)
7. Configuration (MyBatisConfig, WebMvcConfig)
c. Database (e.g., MySQL with the schema in DDL.sql)
d. Optional External Tools (npm scripts for static builds)

##### Relationships and Data Flows
- Browser → HTTP Request → Controller
- Controller ↔ Service for business rules
- Service ↔ DAO for CRUD operations
- DAO ↔ MyBatis Mapper → SQL → Database
- On reads, data bubbles back up to Controller → Model → Thymeleaf view → Browser
- Static resources are fetched directly by the browser via Spring’s resource handler

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Presentation Layer
    subgraph "Presentation Layer"
        direction TB
        Browser["Client Browser"]:::gray
        StaticHandler["Static Resource Handler"]:::blue
        Templates["Thymeleaf View Resolver & Templates"]:::blue
    end

    %% Controller Layer
    subgraph "Controller Layer"
        direction TB
        MainController["MainController"]:::green
        UserController["UserController"]:::green
    end

    %% Business Logic Layer
    subgraph "Business Logic Layer"
        direction TB
        UserService["UserService"]:::green
    end

    %% DAO Layer
    subgraph "DAO Layer"
        direction TB
        UserDAO["UserDAO"]:::orange
    end

    %% Persistence Layer
    subgraph "Persistence Layer"
        direction TB
        Mapper["MyBatis Mapper XML"]:::orange
        DB["Database\n(DDL.sql)"]:::gray
    end

    %% Configuration
    subgraph "Configuration"
        direction TB
        MyBatisConfig["MyBatisConfig"]:::gray
        WebMvcConfig["WebMvcConfig"]:::gray
        AppEntry["KihibooksApplication"]:::gray
    end

    %% External Tools
    subgraph "External Tools"
        direction TB
        NPM["npm (package.json)"]:::gray
        Maven["Maven"]:::gray
    end

    %% Data Flows
    Browser -->|"HTTP Request"| MainController
    Browser -->|GET static assets| StaticHandler
    StaticHandler -->|serves CSS/JS/images| Browser
    MainController -->|"calls"| UserService
    UserController -->|"calls"| UserService
    UserService -->|"calls"| UserDAO
    UserDAO -->|"uses SQL via MyBatis"| Mapper
    Mapper -->|"SQL"| DB
    DB -->|"result set"| Mapper
    Mapper -->|"maps to VO"| UserDAO
    UserDAO -->|"returns data"| UserService
    UserService -->|"returns data"| MainController
    MainController -->|renders view via| Templates
    Templates -->|HTML| Browser

    %% Configurations injections
    MyBatisConfig -.->|configures| Mapper
    MyBatisConfig -.->|configures| UserDAO
    WebMvcConfig -.->|configures| StaticHandler
    WebMvcConfig -.->|configures| Templates
    AppEntry -.->|bootstraps| MainController
    AppEntry -.->|bootstraps| UserController
    AppEntry -.->|bootstraps| UserService
    AppEntry -.->|bootstraps| UserDAO

    %% Toolchain
    NPM ---|builds static| StaticHandler
    Maven ---|builds Java app| AppEntry

    %% Click Events
    click StaticHandler "https://github.com/djatjs/kihibooks/tree/main/kihibooks/src/main/resources/static/"
    click Templates "https://github.com/djatjs/kihibooks/tree/main/kihibooks/src/main/resources/templates/"
    click MainController "https://github.com/djatjs/kihibooks/blob/main/kihibooks/src/main/java/kr/kh/kihibooks/controller/MainController.java"
    click UserController "https://github.com/djatjs/kihibooks/blob/main/kihibooks/src/main/java/kr/kh/kihibooks/controller/UserController.java"
    click UserService "https://github.com/djatjs/kihibooks/blob/main/kihibooks/src/main/java/kr/kh/kihibooks/service/UserService.java"
    click UserDAO "https://github.com/djatjs/kihibooks/blob/main/kihibooks/src/main/java/kr/kh/kihibooks/dao/UserDAO.java"
    click Mapper "https://github.com/djatjs/kihibooks/blob/main/kihibooks/src/main/resources/mappers/UserMapper.xml"
    click MyBatisConfig "https://github.com/djatjs/kihibooks/blob/main/kihibooks/src/main/java/kr/kh/kihibooks/config/MyBatisConfig.java"
    click WebMvcConfig "https://github.com/djatjs/kihibooks/blob/main/kihibooks/src/main/java/kr/kh/kihibooks/config/WebMvcConfig.java"
    click AppEntry "https://github.com/djatjs/kihibooks/blob/main/kihibooks/src/main/java/kr/kh/kihibooks/KihibooksApplication.java"
    click DB "https://github.com/djatjs/kihibooks/blob/main/DB/키히북스 DDL.sql"
    click NPM "https://github.com/djatjs/kihibooks/blob/main/package.json"

    %% Styles
    classDef blue fill:#D0E8FF,stroke:#0366d6,stroke-width:2px
    classDef green fill:#DFFFE0,stroke:#28a745,stroke-width:2px
    classDef orange fill:#FFE8B0,stroke:#d73a49,stroke-width:2px
    classDef gray fill:#F0F0F0,stroke:#6a737d,stroke-width:2px
```
