# seung-zedd/sbb_board architecture

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

- Interactive diagram: https://gitdiagram.com/seung-zedd/sbb_board
- Repository: https://github.com/seung-zedd/sbb_board

## Overview

##### Project type and purpose
- This is a monolithic, full-stack web application built with Spring Boot (Java), following the MVC pattern.
- Purpose: a simple bulletin-board Q&A site (“Do it! Jump to Spring Boot 3” tutorial).

##### File structure
- src/main/java/com/mysite/sbb
– Controller layer: HelloController, MainController, QuestionController, AnswerController, UserController
– Service layer: QuestionService, AnswerService, UserService
– Repository layer: QuestionRepository, AnswerRepository, UserRepository, plus Voters repositories
– Domain entities: Question, Answer, SiteUser, Book (demo)
– Common utilities & exception handling: DataNotFoundException, FieldErrorHandler, CommonUtil
– Configuration: SecurityConfig (Spring Security), SQL formatter, naming strategy
- src/main/resources
– templates (Thymeleaf HTML views), static assets (CSS/JS), application.properties/yml
- Tests: SbbApplicationTests

##### README
- Confirms it’s a learning project to build a bulletin board and grasp Spring Web MVC.
- No other external integrations or microservices.

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Client Layer
    Browser["Browser"]:::frontend

    %% Presentation Layer
    subgraph "Presentation Layer"
        Templates["Thymeleaf Templates"]:::frontend
        Static["Static Assets"]:::frontend
    end

    %% Backend Layers
    SbbApp["SbbApplication"]:::bootstrap

    subgraph "Controller Layer"
        HelloC["HelloController"]:::controller
        MainC["MainController"]:::controller
        QuestC["QuestionController"]:::controller
        AnsC["AnswerController"]:::controller
        UserC["UserController"]:::controller
        Security["SecurityConfig & FilterChain"]:::crosscut
        ErrorH["Exception Handlers"]:::crosscut
    end

    subgraph "Service Layer"
        QuestS["QuestionService"]:::service
        AnsS["AnswerService"]:::service
        UserS["UserService"]:::service
        UserSecS["UserSecurityService"]:::service
    end

    subgraph "Repository Layer"
        QuestR["QuestionRepository"]:::repository
        AnsR["AnswerRepository"]:::repository
        UserR["UserRepository"]:::repository
        QVoterR["QuestionVotersRepository"]:::repository
        AVoterR["AnswerVotersRepository"]:::repository
    end

    subgraph "Domain Entities"
        QEnt["Question"]:::entity
        AEnt["Answer"]:::entity
        UEnt["SiteUser"]:::entity
        BookEnt["Book"]:::entity
        QVEnt["QuestionVoter"]:::entity
        AVEnt["AnswerVoter"]:::entity
    end

    Configuration["Configuration Modules"]:::crosscut

    DB["Database (H2/MySQL)"]:::database

    %% Flow
    Browser -->|"HTTP GET/POST"| HelloC
    Browser -->|"HTTP GET/POST"| MainC
    Browser -->|"HTTP GET/POST"| QuestC
    Browser -->|"HTTP GET/POST"| AnsC
    Browser -->|"HTTP GET/POST"| UserC

    Templates --> HelloC
    Static --> HelloC

    SbbApp --> HelloC

    Security -.-> HelloC
    Security -.-> MainC
    Security -.-> QuestC
    Security -.-> AnsC
    Security -.-> UserC

    ErrorH -.-> HelloC
    ErrorH -.-> QuestC
    ErrorH -.-> AnsC

    HelloC -->|"calls"| QuestS
    MainC -->|"calls"| QuestS
    QuestC -->|"calls"| QuestS
    AnsC -->|"calls"| AnsS
    UserC -->|"calls"| UserS
    UserSecS -->|"used by Auth"| Security

    QuestS -->|"uses"| QuestR
    AnsS -->|"uses"| AnsR
    UserS -->|"uses"| UserR
    QuestS -->|"uses"| QVoterR
    AnsS -->|"uses"| AVoterR

    QuestR -->|"JPA Query"| DB
    AnsR -->|"JPA Query"| DB
    UserR -->|"JPA Query"| DB
    QVoterR -->|"JPA Query"| DB
    AVoterR -->|"JPA Query"| DB

    QuestR --> QEnt
    AnsR --> AEnt
    UserR --> UEnt
    QVoterR --> QVEnt
    AVoterR --> AVEnt
    BookEnt --> DB

    Configuration --> Security
    Configuration --> QuestR

    %% Click Events
    click Templates "https://github.com/seung-zedd/sbb_board/tree/main/src/main/resources/templates/"
    click Static "https://github.com/seung-zedd/sbb_board/tree/main/src/main/resources/static/"
    click SbbApp "https://github.com/seung-zedd/sbb_board/blob/main/src/main/java/com/mysite/sbb/SbbApplication.java"
    click HelloC "https://github.com/seung-zedd/sbb_board/blob/main/src/main/java/com/mysite/sbb/HelloController.java"
    click MainC "https://github.com/seung-zedd/sbb_board/blob/main/src/main/java/com/mysite/sbb/MainController.java"
    click QuestC "https://github.com/seung-zedd/sbb_board/blob/main/src/main/java/com/mysite/sbb/question/QuestionController.java"
    click AnsC "https://github.com/seung-zedd/sbb_board/blob/main/src/main/java/com/mysite/sbb/answer/AnswerController.java"
    click UserC "https://github.com/seung-zedd/sbb_board/blob/main/src/main/java/com/mysite/sbb/user/UserController.java"
    click QuestS "https://github.com/seung-zedd/sbb_board/blob/main/src/main/java/com/mysite/sbb/question/QuestionService.java"
    click AnsS "https://github.com/seung-zedd/sbb_board/blob/main/src/main/java/com/mysite/sbb/answer/AnswerService.java"
    click UserS "https://github.com/seung-zedd/sbb_board/blob/main/src/main/java/com/mysite/sbb/user/UserService.java"
    click UserSecS "https://github.com/seung-zedd/sbb_board/blob/main/src/main/java/com/mysite/sbb/user/UserSecurityService.java"
    click QuestR "https://github.com/seung-zedd/sbb_board/blob/main/src/main/java/com/mysite/sbb/question/QuestionRepository.java"
    click AnsR "https://github.com/seung-zedd/sbb_board/blob/main/src/main/java/com/mysite/sbb/answer/AnswerRepository.java"
    click UserR "https://github.com/seung-zedd/sbb_board/blob/main/src/main/java/com/mysite/sbb/user/UserRepository.java"
    click QVoterR "https://github.com/seung-zedd/sbb_board/blob/main/src/main/java/com/mysite/sbb/question/QuestionVotersRepository.java"
    click AVoterR "https://github.com/seung-zedd/sbb_board/blob/main/src/main/java/com/mysite/sbb/answer/AnswerVotersRepository.java"

    %% Styles
    classDef frontend fill:#cce5ff,stroke:#004085,color:#004085
    classDef controller fill:#d4edda,stroke:#155724,color:#155724
    classDef service fill:#fff3cd,stroke:#856404,color:#856404
    classDef repository fill:#ffe5b4,stroke:#cc8400,color:#cc8400
    classDef entity fill:#ffd1dc,stroke:#c71585,color:#c71585
    classDef database fill:#e2e3e5,stroke:#6c757d,color:#6c757d
    classDef crosscut fill:#f8d7da,stroke:#721c24,color:#721c24,stroke-width:2px
    classDef bootstrap fill:#d1ecf1,stroke:#0c5460,color:#0c5460
```
