# f-lab-edu/daangn-market-used-trading architecture

> Architecture diagram of the GitHub repository f-lab-edu/daangn-market-used-trading, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-05-14). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/f-lab-edu/daangn-market-used-trading
- Repository: https://github.com/f-lab-edu/daangn-market-used-trading

## Overview

##### Project type and purpose
- This is a backend‐only monolithic API server modeled on “당근마켓” (Carrot Market).
- Built with Spring Boot (Java), it exposes REST endpoints for posts, members, and image uploads.
- It is designed to handle high traffic, session consistency in a distributed environment, caching, and file storage.

##### File structure
- Top-level artifacts:
– Dockerfile, Jenkinsfile/Jenkinsfile-ci → CI/CD and containerization
– pom.xml, mvnw → Maven Spring Boot build
- src/main/java/com/ssibongee/daangnmarket: package structure shows a layered architecture:
– commons: cross-cutting concerns (AOP, annotation, configuration, caching, security, data source routing)
– image: controllers → services → repositories → AWS S3 integration
– member: controllers → services → repositories (session/login, validation, exceptions)
– post: controllers → services → repositories (CRUD, search, trade status)
- src/main/resources/application.properties → externalized configuration
- tests under src/test/java → unit and integration tests
- config classes for DataSourceConfig (master/replica routing), RedisCacheConfig, RedisSessionConfig

##### README for additional insights
- Architecture goals: high availability, distributed sessions, cache no downtime, CI/CD with Jenkins & Docker
- Tech stack: Spring Boot, MySQL (or RDBMS), Redis (cache & session store), AWS S3, Jenkins, Docker, nGrinder for load testing

## Diagram (Mermaid)

```mermaid
flowchart TD
    subgraph Clients
        Client["Clients (Web/Mobile)"]:::external
    end
    Client -->|"HTTP"| LB["Load Balancer"]:::infra

    subgraph "Compute Layer"
        LB --> APICluster["API Server Cluster"]:::compute
        subgraph "API Server Cluster"
            APIServer["Spring Boot Application"]:::compute

            subgraph Controllers
                PC["PostController"]:::compute
                PSC["PostSearchController"]:::compute
                MC["MemberController"]:::compute
                PIC["PostImageController"]:::compute
            end

            subgraph Services
                PS["PostService"]:::compute
                PSS["PostSearchService"]:::compute
                TPS["TradePostService"]:::compute
                TPSS["TradePostSearchService"]:::compute
                MS["MemberService"]:::compute
                LS["LoginService"]:::compute
                SLS["SessionLoginService"]:::compute
                GMS["GeneralMemberService"]:::compute
                STS["StorageService"]:::compute
                IFUS["ImageFileUploadService"]:::compute
                AWS3S["AwsS3Service"]:::compute
            end

            subgraph Repositories
                PR["PostRepository"]:::storage
                PSR["PostSearchRepository"]:::storage
                CR["CategoryRepository"]:::storage
                MR["MemberRepository"]:::storage
                IR["ImageRepository"]:::storage
                IJR["ImageJdbcRepository"]:::storage
            end

            subgraph "Commons (Cross-cutting)"
                RDS["RoutingDataSource"]:::compute
                DSC["DataSourceConfig"]:::compute
                RDC["RedisCacheConfig"]:::storage
                RSC["RedisSessionConfig"]:::storage
                CKC["CacheKeyConfig"]:::storage
                CEC["CacheExpireConfig"]:::storage
                EC["ExceptionAdvice"]:::compute
                AIA["AreaInfoAspect"]:::compute
                SC["SecurityConfig"]:::compute
                WC["WebConfig"]:::compute
                LI["LoginInterceptor"]:::compute
                LMAR["LoginMemberArgumentResolver"]:::compute
                ASC["AmazonS3Config"]:::compute
                ASP["AwsS3Properties"]:::compute
            end
        end
    end

    APICluster -.->|"JDBC (write)"| DBPrimary["RDBMS Primary"]:::storage
    APICluster -.->|"JDBC (read)"| DBReplica["RDBMS Replica"]:::storage
    APICluster -->|"Redis GET/SET"| Redis["Redis Cluster"]:::storage
    APICluster -->|"S3 PUT/GET"| S3["AWS S3 Bucket"]:::storage

    subgraph "CI/CD & Containerization"
        Git["Git Repo"]:::infra
        Jenkins["Jenkins"]:::infra
        DockerReg["Docker Registry"]:::infra
        Git --> Jenkins -->|"build/test"| APIServer
        Jenkins -->|"push image"| DockerReg
        DockerReg -->|"deploy"| APICluster
    end

    classDef compute fill:#cce5ff,stroke:#007bff,color:#004085
    classDef storage fill:#d4edda,stroke:#28a745,color:#155724
    classDef infra fill:#fff3cd,stroke:#ffc107,color:#856404
    classDef external fill:#e2e3e5,stroke:#6c757d,color:#343a40

    click APIServer "https://github.com/f-lab-edu/daangn-market-used-trading/blob/develop/src/main/java/com/ssibongee/daangnmarket/DaangnmarketApplication.java"
    click PC "https://github.com/f-lab-edu/daangn-market-used-trading/blob/develop/src/main/java/com/ssibongee/daangnmarket/post/controller/PostController.java"
    click PSC "https://github.com/f-lab-edu/daangn-market-used-trading/blob/develop/src/main/java/com/ssibongee/daangnmarket/post/controller/PostSearchController.java"
    click MC "https://github.com/f-lab-edu/daangn-market-used-trading/blob/develop/src/main/java/com/ssibongee/daangnmarket/member/controller/MemberController.java"
    click PIC "https://github.com/f-lab-edu/daangn-market-used-trading/blob/develop/src/main/java/com/ssibongee/daangnmarket/image/controller/PostImageController.java"
    click PS "https://github.com/f-lab-edu/daangn-market-used-trading/blob/develop/src/main/java/com/ssibongee/daangnmarket/post/service/PostService.java"
    click PSS "https://github.com/f-lab-edu/daangn-market-used-trading/blob/develop/src/main/java/com/ssibongee/daangnmarket/post/service/PostSearchService.java"
    click TPS "https://github.com/f-lab-edu/daangn-market-used-trading/blob/develop/src/main/java/com/ssibongee/daangnmarket/post/service/TradePostService.java"
    click TPSS "https://github.com/f-lab-edu/daangn-market-used-trading/blob/develop/src/main/java/com/ssibongee/daangnmarket/post/service/TradePostSearchService.java"
    click MS "https://github.com/f-lab-edu/daangn-market-used-trading/blob/develop/src/main/java/com/ssibongee/daangnmarket/member/service/MemberService.java"
    click LS "https://github.com/f-lab-edu/daangn-market-used-trading/blob/develop/src/main/java/com/ssibongee/daangnmarket/member/service/LoginService.java"
    click SLS "https://github.com/f-lab-edu/daangn-market-used-trading/blob/develop/src/main/java/com/ssibongee/daangnmarket/member/service/SessionLoginService.java"
    click GMS "https://github.com/f-lab-edu/daangn-market-used-trading/blob/develop/src/main/java/com/ssibongee/daangnmarket/member/service/GeneralMemberService.java"
    click STS "https://github.com/f-lab-edu/daangn-market-used-trading/blob/develop/src/main/java/com/ssibongee/daangnmarket/image/service/StorageService.java"
    click IFUS "https://github.com/f-lab-edu/daangn-market-used-trading/blob/develop/src/main/java/com/ssibongee/daangnmarket/image/service/ImageFileUploadService.java"
    click AWS3S "https://github.com/f-lab-edu/daangn-market-used-trading/blob/develop/src/main/java/com/ssibongee/daangnmarket/image/service/AwsS3Service.java"
    click PR "https://github.com/f-lab-edu/daangn-market-used-trading/blob/develop/src/main/java/com/ssibongee/daangnmarket/post/domain/repository/PostRepository.java"
    click PSR "https://github.com/f-lab-edu/daangn-market-used-trading/blob/develop/src/main/java/com/ssibongee/daangnmarket/post/domain/repository/PostSearchRepository.java"
    click CR "https://github.com/f-lab-edu/daangn-market-used-trading/blob/develop/src/main/java/com/ssibongee/daangnmarket/post/domain/repository/CategoryRepository.java"
    click MR "https://github.com/f-lab-edu/daangn-market-used-trading/blob/develop/src/main/java/com/ssibongee/daangnmarket/member/domain/repository/MemberRepository.java"
    click IR "https://github.com/f-lab-edu/daangn-market-used-trading/blob/develop/src/main/java/com/ssibongee/daangnmarket/image/domain/repository/ImageRepository.java"
    click IJR "https://github.com/f-lab-edu/daangn-market-used-trading/blob/develop/src/main/java/com/ssibongee/daangnmarket/image/domain/repository/ImageJdbcRepository.java"
    click RDS "https://github.com/f-lab-edu/daangn-market-used-trading/blob/develop/src/main/java/com/ssibongee/daangnmarket/commons/util/RoutingDataSource.java"
    click DSC "https://github.com/f-lab-edu/daangn-market-used-trading/blob/develop/src/main/java/com/ssibongee/daangnmarket/commons/config/DataSourceConfig.java"
    click RDC "https://github.com/f-lab-edu/daangn-market-used-trading/blob/develop/src/main/java/com/ssibongee/daangnmarket/commons/config/RedisCacheConfig.java"
    click RSC "https://github.com/f-lab-edu/daangn-market-used-trading/blob/develop/src/main/java/com/ssibongee/daangnmarket/commons/config/RedisSessionConfig.java"
    click CKC "https://github.com/f-lab-edu/daangn-market-used-trading/blob/develop/src/main/java/com/ssibongee/daangnmarket/commons/config/CacheKeyConfig.java"
    click CEC "https://github.com/f-lab-edu/daangn-market-used-trading/blob/develop/src/main/java/com/ssibongee/daangnmarket/commons/config/CacheExpireConfig.java"
    click ASC "https://github.com/f-lab-edu/daangn-market-used-trading/blob/develop/src/main/java/com/ssibongee/daangnmarket/image/config/AmazonS3Config.java"
    click ASP "https://github.com/f-lab-edu/daangn-market-used-trading/blob/develop/src/main/java/com/ssibongee/daangnmarket/commons/properties/AwsS3Properties.java"
```
