# skatwoh/asbe architecture

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

- Interactive diagram: https://gitdiagram.com/skatwoh/asbe
- Repository: https://github.com/skatwoh/asbe

## Overview

##### Project type and purpose
- This is a monolithic, backend-only Spring Boot application exposing REST APIs for a book marketplace that supports both direct purchases and timed auctions.
- Core features: user registration/login with JWT, browsing/catalog management, cart & order processing, bidding & auction sessions, reviews, and Slack notifications.

##### File structure
­ • src/main/java/org/example/asbe/config – application configuration (MVC, security, OpenAPI, filters).
­ • src/main/java/org/example/asbe/controller – REST controllers that expose HTTP endpoints.
­ • src/main/java/org/example/asbe/filter & config – filter chain with DebugFilter, JwtAuthenticationFilter, JwtAuthFilter, JwtTokenProvider.
­ • src/main/java/org/example/asbe/service & impl – business logic layer.
­ • src/main/java/org/example/asbe/repository – Spring Data JPA repositories for persistence.
­ • src/main/java/org/example/asbe/model/entity & dto – JPA entities and DTOs for API I/O.
­ • src/main/java/org/example/asbe/mapper – mappings between entities and DTOs.
­ • src/main/java/org/example/asbe/util & response – exception handling, global error handler, ApiResponse, PagedResponse, MessageUtil, SlackNotifier under config/slack.
­ • src/main/resources/application.yml – runtime config for DB, JWT, Slack, etc.

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% External Layer
    ExternalClients["External Clients\n(Web, Mobile)"]:::external

    %% API Gateway / Infrastructure
    subgraph "API Gateway & Configuration"
        direction TB
        DebugFilter["DebugFilter"]:::filter
        JwtAuthenticationFilter["JwtAuthenticationFilter"]:::filter
        JwtAuthFilter["JwtAuthFilter"]:::filter
        JwtTokenProvider["JwtTokenProvider"]:::filter
        SecurityConfig["SecurityConfig"]:::filter
        WebMvcConfig["WebMvcConfig"]:::filter
        OpenApiConfig["OpenApiConfig"]:::filter
    end

    %% Presentation Layer
    subgraph "Controllers (Presentation Layer)"
        direction TB
        UserController["UserController"]:::controller
        BookController["BookController"]:::controller
        CartController["CartController"]:::controller
        OrderController["OrderController"]:::controller
        AuthorController["AuthorController"]:::controller
        CategoryController["CategoryController"]:::controller
    end

    %% Business Layer
    subgraph "Services (Business Layer)"
        direction TB
        UserService["UserService"]:::service
        BookService["BookService"]:::service
        CartService["CartService"]:::service
        OrderService["OrderService"]:::service
        AuthorService["AuthorService"]:::service
        CategoryService["CategoryService"]:::service
        JwtService["JwtService"]:::service
    end

    %% Data Access Layer
    subgraph "Repositories (Data Access Layer)"
        direction TB
        UserInfoRepository["UserInfoRepository"]:::repository
        BookRepository["BookRepository"]:::repository
        CartRepository["CartRepository"]:::repository
        OrderRepository["OrderRepository"]:::repository
        OrderItemRepository["OrderItemRepository"]:::repository
        AuthorRepository["AuthorRepository"]:::repository
        CategoryRepository["CategoryRepository"]:::repository
    end

    %% Domain Model & Mapping
    subgraph "Domain Model & Mapping"
        direction TB
        Entities["JPA Entities"]:::repository
        DTOs["DTOs"]:::repository
        Mapper["Mapper"]:::repository
    end

    %% Utilities & Error Handling
    subgraph "Utilities & Error Handling"
        direction TB
        GlobalExceptionHandler["GlobalExceptionHandler"]:::repository
        CustomException["CustomException"]:::repository
        MessageUtil["MessageUtil"]:::repository
        ResponseUtil["ResponseUtil"]:::repository
        ApiResponse["ApiResponse"]:::repository
        PagedResponse["PagedResponse"]:::repository
    end

    %% Persistence Store
    Database[(Relational Database\nPostgreSQL/MySQL)]:::database

    %% External Integrations
    SlackNotifier["SlackNotifier"]:::integration
    SlackAPI["Slack API"]:::integration

    %% Connections
    ExternalClients --> DebugFilter
    DebugFilter --> JwtAuthenticationFilter
    JwtAuthenticationFilter --> JwtAuthFilter
    JwtAuthFilter --> JwtTokenProvider
    JwtTokenProvider --> SecurityConfig
    SecurityConfig --> UserController
    SecurityConfig --> BookController
    SecurityConfig --> CartController
    SecurityConfig --> OrderController
    SecurityConfig --> AuthorController
    SecurityConfig --> CategoryController

    UserController --> UserService
    BookController --> BookService
    CartController --> CartService
    OrderController --> OrderService
    AuthorController --> AuthorService
    CategoryController --> CategoryService

    UserService --> UserInfoRepository
    BookService --> BookRepository
    CartService --> CartRepository
    OrderService --> OrderRepository
    OrderService --> OrderItemRepository
    AuthorService --> AuthorRepository
    CategoryService --> CategoryRepository

    UserInfoRepository --> Database
    BookRepository --> Database
    CartRepository --> Database
    OrderRepository --> Database
    OrderItemRepository --> Database
    AuthorRepository --> Database
    CategoryRepository --> Database

    UserService --> SlackNotifier
    OrderService --> SlackNotifier
    AuctionService["AuctionService"]:::service
    AuctionService --> BidRepository["BidRepository"]:::repository
    BidRepository["BidRepository"]:::repository --> Database
    AuctionService --> AuctionSessionRepository["AuctionSessionRepository"]:::repository
    AuctionSessionRepository --> Database
    AuctionService --> AuctionItemRepository["AuctionItemRepository"]:::repository
    AuctionItemRepository --> Database
    AuctionService --> AuctionWinnerRepository["AuctionWinnerRepository"]:::repository
    AuctionWinnerRepository --> Database
    AuctionService --> SlackNotifier

    SlackNotifier --> SlackAPI

    %% Click Events
    click DebugFilter "https://github.com/skatwoh/asbe/blob/master/src/main/java/org/example/asbe/config/DebugFilter.java"
    click JwtAuthenticationFilter "https://github.com/skatwoh/asbe/blob/master/src/main/java/org/example/asbe/config/JwtAuthenticationFilter.java"
    click JwtAuthFilter "https://github.com/skatwoh/asbe/blob/master/src/main/java/org/example/asbe/filter/JwtAuthFilter.java"
    click JwtTokenProvider "https://github.com/skatwoh/asbe/blob/master/src/main/java/org/example/asbe/config/JwtTokenProvider.java"
    click SecurityConfig "https://github.com/skatwoh/asbe/blob/master/src/main/java/org/example/asbe/config/SecurityConfig.java"
    click WebMvcConfig "https://github.com/skatwoh/asbe/blob/master/src/main/java/org/example/asbe/config/WebMvcConfig.java"
    click OpenApiConfig "https://github.com/skatwoh/asbe/blob/master/src/main/java/org/example/asbe/config/OpenApiConfig.java"
    click SlackNotifier "https://github.com/skatwoh/asbe/blob/master/src/main/java/org/example/asbe/config/slack/SlackNotifier.java"
    click ExternalClients "https://github.com/skatwoh/asbe/blob/master/src/main/java/org/example/asbe/AsbeApplication.java"
    click UserController "https://github.com/skatwoh/asbe/blob/master/src/main/java/org/example/asbe/controller/UserController.java"
    click BookController "https://github.com/skatwoh/asbe/blob/master/src/main/java/org/example/asbe/controller/BookController.java"
    click CartController "https://github.com/skatwoh/asbe/blob/master/src/main/java/org/example/asbe/controller/CartController.java"
    click OrderController "https://github.com/skatwoh/asbe/blob/master/src/main/java/org/example/asbe/controller/OrderController.java"
    click AuthorController "https://github.com/skatwoh/asbe/blob/master/src/main/java/org/example/asbe/controller/AuthorController.java"
    click CategoryController "https://github.com/skatwoh/asbe/blob/master/src/main/java/org/example/asbe/controller/CategoryController.java"
    click UserService "https://github.com/skatwoh/asbe/blob/master/src/main/java/org/example/asbe/service/UserService.java"
    click BookService "https://github.com/skatwoh/asbe/blob/master/src/main/java/org/example/asbe/service/BookService.java"
    click CartService "https://github.com/skatwoh/asbe/blob/master/src/main/java/org/example/asbe/service/CartService.java"
    click OrderService "https://github.com/skatwoh/asbe/blob/master/src/main/java/org/example/asbe/service/OrderService.java"
    click AuthorService "https://github.com/skatwoh/asbe/blob/master/src/main/java/org/example/asbe/service/AuthorService.java"
    click CategoryService "https://github.com/skatwoh/asbe/blob/master/src/main/java/org/example/asbe/service/CategoryService.java"
    click UserInfoRepository "https://github.com/skatwoh/asbe/blob/master/src/main/java/org/example/asbe/repository/UserInfoRepository.java"
    click BookRepository "https://github.com/skatwoh/asbe/blob/master/src/main/java/org/example/asbe/repository/BookRepository.java"
    click CartRepository "https://github.com/skatwoh/asbe/blob/master/src/main/java/org/example/asbe/repository/CartRepository.java"
    click OrderRepository "https://github.com/skatwoh/asbe/blob/master/src/main/java/org/example/asbe/repository/OrderRepository.java"
    click OrderItemRepository "https://github.com/skatwoh/asbe/blob/master/src/main/java/org/example/asbe/repository/OrderItemRepository.java"
    click AuthorRepository "https://github.com/skatwoh/asbe/blob/master/src/main/java/org/example/asbe/repository/AuthorRepository.java"
    click CategoryRepository "https://github.com/skatwoh/asbe/blob/master/src/main/java/org/example/asbe/repository/CategoryRepository.java"
    click Database "https://github.com/skatwoh/asbe/blob/master/src/main/resources/application.yml"

    %% Styles
    classDef external fill:#e0e0e0,stroke:#999
    classDef filter fill:#fde2e2,stroke:#d9534f
    classDef controller fill:#d0e1fd,stroke:#337ab7
    classDef service fill:#d7f0d7,stroke:#5cb85c
    classDef repository fill:#feedd7,stroke:#f0ad4e
    classDef database fill:#fff3cd,stroke:#f0ad4e,stroke-width:2px,shape:cylinder
    classDef integration fill:#d9edf7,stroke:#5bc0de,stroke-dasharray: 5 5
```
