# youth-talk-talk/be architecture

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

- Interactive diagram: https://gitdiagram.com/youth-talk-talk/be
- Repository: https://github.com/youth-talk-talk/be

## Overview

##### Project type and purpose
- This is the Java-based Spring Boot backend service for the YouthTalkTalk mobile application (iOS/Android).
- It exposes RESTful APIs for announcements, posts, comments, policies, images, likes, reporting, member management (OAuth2/Apple), scheduling, and error handling.

##### File structure
- Top level: Gradle build, Dockerfile, deploy scripts, submodule for seed data.
- src/main/java/com/server/youthtalktalk:
- domain/*: Entities, Repositories, Services, Controllers grouped per business domain (announcement, comment, image, likes, member, policy, post, report, scrap).
- global/config: Bean and infrastructure configuration (API paths, S3, QueryDSL, security, Feign clients, batch).
- global/jwt, global/login: Spring Security filters, providers, JWT support.
- global/batch: Scheduled and batch-job components.
- global/response: Standardized response wrapper and exception hierarchy.
- global/util: Helpers for date extraction, hashing, URL utils, etc.
- src/test: Unit and integration tests across layers.

##### README for additional insights
- ERD showing domain relationships.
- Tech stack: Java17, Spring Boot 3, MySQL/H2, Spring Data JPA/QueryDSL, OAuth2/Spring Security, AWS EC2/RDS/S3, Jenkins CI/CD.

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Clients
    iOS["iOS App"]:::client
    Android["Android App"]:::client

    %% Load Balancer / API Gateway
    LB["AWS ELB (API Gateway)"]:::gateway

    %% Application Tier
    subgraph "YouthTalkTalk API Servers (Blue/Green)" 
        direction TB
        AppEntry["YouthTalkTalkApplication"]:::service
        subgraph "Domain Modules"
            direction TB
            Announcement["Announcement Module"]:::service
            Post["Post Module"]:::service
            Comment["Comment Module"]:::service
            Policy["Policy Module"]:::service
            MemberDomain["Member Management"]:::service
            OAuthLogin["OAuth2 & Apple Sign-in"]:::security
            ImageDomain["Image Handling"]:::service
            Likes["Likes Feature"]:::service
            Reporting["Reporting Module"]:::service
            Scrap["Scrap Module"]:::service
        end
        subgraph "Config & Infrastructure"
            direction TB
            S3Cfg["S3Config"]:::config
            SecurityCfg["SecurityConfig"]:::security
            JwtFilters["JWT Filters"]:::security
            ApiPathCfg["ApiPathConfig"]:::config
            QueryDSLCfg["QueryDSLConfig"]:::config
            MsgConverter["MultipartJackson2HttpMessageConverter"]:::config
            BatchCfg["BatchConfig"]:::config
            AsyncCfg["AsyncConfig"]:::config
            SchedulerCfg["SchedulerConfiguration"]:::batch
            FeignCfg["FeignConfig"]:::config
            AppleClient["AppleClient (Feign)"]:::external
            ResponseWrap["Response Wrappers"]:::config
            ExceptionHandler["GlobalExceptionHandler"]:::config
            Util["Utility Classes"]:::util
        end
    end

    %% Data Tier
    DB["RDS MySQL"]:::database
    S3["AWS S3"]:::storage

    %% External OAuth Provider
    AppleExt["Apple Public Key API"]:::external

    %% Batch Scheduler
    Scheduler["Batch Scheduler & Jobs"]:::batch

    %% CI/CD Pipeline
    Jenkins["Jenkins CI/CD"]:::cicd
    BlueEco["EC2 Blue Instances"]:::service
    GreenEco["EC2 Green Instances"]:::service
    Submodule["BE-submodule-data"]:::external

    %% Connections
    iOS -->|"HTTPS"| LB
    Android -->|"HTTPS"| LB
    LB -->|"HTTPS"| AppEntry
    AppEntry -->|loads| AppEntry
    AppEntry -->|calls| Announcement
    AppEntry -->|calls| Post
    AppEntry -->|calls| Comment
    AppEntry -->|calls| Policy
    AppEntry -->|calls| MemberDomain
    AppEntry -->|calls| OAuthLogin
    AppEntry -->|calls| ImageDomain
    AppEntry -->|calls| Likes
    AppEntry -->|calls| Reporting
    AppEntry -->|calls| Scrap
    AppEntry -->|uses| S3Cfg
    AppEntry -->|uses| SecurityCfg
    AppEntry -->|uses| JwtFilters
    AppEntry -->|uses| ApiPathCfg
    AppEntry -->|uses| QueryDSLCfg
    AppEntry -->|uses| MsgConverter
    AppEntry -->|uses| BatchCfg
    AppEntry -->|uses| AsyncCfg
    AppEntry -->|uses| SchedulerCfg
    AppEntry -->|uses| FeignCfg
    AppEntry -->|uses| ResponseWrap
    AppEntry -->|uses| ExceptionHandler
    AppEntry -->|uses| Util

    Announcement -->|"JPA/QueryDSL"| DB
    Post -->|"JPA/QueryDSL"| DB
    Comment -->|"JPA/QueryDSL"| DB
    Policy -->|"JPA/QueryDSL"| DB
    MemberDomain -->|"JPA/QueryDSL"| DB
    OAuthLogin -->|"OAuth2 Flow"| AppleExt
    ImageDomain -->|"S3 API"| S3
    Likes -->|"JPA/QueryDSL"| DB
    Reporting -->|"JPA/QueryDSL"| DB
    Scrap -->|"JPA/QueryDSL"| DB

    Scheduler -->|"JDBC / S3 API"| DB
    Scheduler -->|"S3 API"| S3

    Jenkins -->|"Deploy"| BlueEco
    Jenkins -->|"Deploy"| GreenEco
    Submodule -->|"Seed Data"| DB

    %% Click Events
    click AppEntry "https://github.com/youth-talk-talk/be/blob/main/src/main/java/com/server/youthtalktalk/YouthTalkTalkApplication.java"
    click Announcement "https://github.com/youth-talk-talk/be/tree/main/src/main/java/com/server/youthtalktalk/domain/announcement"
    click Post "https://github.com/youth-talk-talk/be/tree/main/src/main/java/com/server/youthtalktalk/domain/post"
    click Comment "https://github.com/youth-talk-talk/be/tree/main/src/main/java/com/server/youthtalktalk/domain/comment"
    click Policy "https://github.com/youth-talk-talk/be/tree/main/src/main/java/com/server/youthtalktalk/domain/policy"
    click MemberDomain "https://github.com/youth-talk-talk/be/tree/main/src/main/java/com/server/youthtalktalk/domain/member"
    click OAuthLogin "https://github.com/youth-talk-talk/be/tree/main/src/main/java/com/server/youthtalktalk/global/login"
    click ImageDomain "https://github.com/youth-talk-talk/be/tree/main/src/main/java/com/server/youthtalktalk/domain/image"
    click S3Cfg "https://github.com/youth-talk-talk/be/blob/main/src/main/java/com/server/youthtalktalk/global/config/S3Config.java"
    click Likes "https://github.com/youth-talk-talk/be/tree/main/src/main/java/com/server/youthtalktalk/domain/likes"
    click Reporting "https://github.com/youth-talk-talk/be/tree/main/src/main/java/com/server/youthtalktalk/domain/report"
    click Scrap "https://github.com/youth-talk-talk/be/tree/main/src/main/java/com/server/youthtalktalk/domain/scrap"
    click JwtFilters "https://github.com/youth-talk-talk/be/tree/main/src/main/java/com/server/youthtalktalk/global/jwt"
    click SecurityCfg "https://github.com/youth-talk-talk/be/blob/main/src/main/java/com/server/youthtalktalk/global/config/SecurityConfig.java"
    click ExceptionHandler "https://github.com/youth-talk-talk/be/blob/main/src/main/java/com/server/youthtalktalk/global/response/exception/GlobalExceptionHandler.java"
    click ResponseWrap "https://github.com/youth-talk-talk/be/tree/main/src/main/java/com/server/youthtalktalk/global/response"
    click SchedulerCfg "https://github.com/youth-talk-talk/be/blob/main/src/main/java/com/server/youthtalktalk/global/config/SchedulerConfiguration.java"
    click AsyncCfg "https://github.com/youth-talk-talk/be/blob/main/src/main/java/com/server/youthtalktalk/global/config/AsyncConfig.java"
    click FeignCfg "https://github.com/youth-talk-talk/be/blob/main/src/main/java/com/server/youthtalktalk/global/config/FeignConfig.java"
    click AppleClient "https://github.com/youth-talk-talk/be/blob/main/src/main/java/com/server/youthtalktalk/domain/member/controller/AppleClient.java"
    click Util "https://github.com/youth-talk-talk/be/tree/main/src/main/java/com/server/youthtalktalk/global/util"
    click ApiPathCfg "https://github.com/youth-talk-talk/be/blob/main/src/main/java/com/server/youthtalktalk/global/config/ApiPathConfig.java"
    click QueryDSLCfg "https://github.com/youth-talk-talk/be/blob/main/src/main/java/com/server/youthtalktalk/global/config/QueryDSLConfig.java"
    click MsgConverter "https://github.com/youth-talk-talk/be/blob/main/src/main/java/com/server/youthtalktalk/global/config/MultipartJackson2HttpMessageConverter.java"
    click BatchCfg "https://github.com/youth-talk-talk/be/blob/main/src/main/java/com/server/youthtalktalk/global/config/BatchConfig.java"
    click Submodule "https://github.com/youth-talk-talk/be/tree/main/BE-submodule-data"
    click Jenkins "https://github.com/youth-talk-talk/be/tree/main/Dockerfile"
    click Jenkins "https://github.com/youth-talk-talk/be/blob/main/deploy.sh"
    click Jenkins "https://github.com/youth-talk-talk/be/blob/main/build.gradle"
    click Jenkins "https://github.com/youth-talk-talk/be/blob/main/settings.gradle"

    %% Styles
    classDef client fill:#ADD8E6,stroke:#000
    classDef gateway fill:#32CD32,stroke:#000
    classDef service fill:#87CEFA,stroke:#000
    classDef database fill:#98FB98,stroke:#000
    classDef storage fill:#90EE90,stroke:#000
    classDef external fill:#D3D3D3,stroke:#000
    classDef security fill:#FFA500,stroke:#000
    classDef batch fill:#DA70D6,stroke:#000
    classDef config fill:#F0E68C,stroke:#000
    classDef util fill:#E6E6FA,stroke:#000
    classDef cicd fill:#A9A9A9,stroke:#000
```
