# dnd-side-project/dnd-8th-5-backend architecture

> Architecture diagram of the GitHub repository dnd-side-project/dnd-8th-5-backend, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-01-20). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/dnd-side-project/dnd-8th-5-backend
- Repository: https://github.com/dnd-side-project/dnd-8th-5-backend

## Overview

##### High-Level Components

a) API Layer
- REST Controllers (found in */controller directories)
- Controllers by domain: Room, TimeBlock, TimeTable, Participant, Auth, AdjustmentResult

b) Application Layer
- Service components for each domain
- Services like:
- RoomService
- TimeBlockService
- TimeTableService
- AdjustmentResultService
- AuthService

c) Domain Layer
- Core domain entities:
- Room
- TimeBlock
- TimeTable
- Participant
- AdjustmentResult

d) Infrastructure Layer
- Repositories
- Configuration
- Docker container

##### Component Relationships

- Client requests → Controllers
- Controllers → Services
- Services → Repositories
- Services → Domain Models
- Cross-cutting concerns (advice, configuration)

##### Specific Architectural Elements

Important components:
**[Client] → [API Layer]**
- ↓
**[Application Services]**
- ↓
**[Domain Layer] ←→ [Repositories]**
- ↓
**[Infrastructure] → [Database]**

##### Integration Points

Show:
- Docker container boundaries
- External service connections
- Database interactions

##### Key Design Patterns

Emphasize:
- Factory Pattern usage
- Event-driven architecture elements
- Domain-Driven Design structure
- Repository pattern implementation

## Diagram (Mermaid)

```mermaid
graph TB
    subgraph Client
        CL[Client Application]
    end

    subgraph "API Layer"
        RC["Room Controller"]:::controller
        TC["TimeBlock Controller"]:::controller
        TTC["TimeTable Controller"]:::controller
        ARC["AdjustmentResult Controller"]:::controller
        AC["Auth Controller"]:::controller
        PC["Participant Controller"]:::controller
    end

    subgraph "Application Layer"
        RS["Room Service"]:::service
        TS["TimeBlock Service"]:::service
        TTS["TimeTable Service"]:::service
        ARS["AdjustmentResult Service"]:::service
        AS["Auth Service"]:::service
        PS["Participant Service"]:::service
        RTV["RoomTimeValidator"]:::validator
        ADTV["AvailableDateTimeValidator"]:::validator
    end

    subgraph "Domain Layer"
        RD["Room"]:::domain
        TD["TimeBlock"]:::domain
        TTD["TimeTable"]:::domain
        ARD["AdjustmentResult"]:::domain
        PD["Participant"]:::domain
    end

    subgraph "Infrastructure Layer"
        RR["Room Repository"]:::repo
        TR["TimeBlock Repository"]:::repo
        TTR["TimeTable Repository"]:::repo
        ARR["AdjustmentResult Repository"]:::repo
        WC["Web Configuration"]:::config
        DB[(Database)]:::db
    end

    subgraph "Cross-cutting Concerns"
        GEH["Global Exception Handler"]:::util
        TP["Time Provider"]:::util
        TM["Timer"]:::util
    end

    subgraph "Factories"
        AREF["AdjustmentResult Executor Factory"]:::factory
        CDCF["CandidateDateTime Convertor Factory"]:::factory
    end

    %% Connections
    CL --> RC & TC & TTC & ARC & AC & PC
    RC --> RS
    TC --> TS
    TTC --> TTS
    ARC --> ARS
    AC --> AS
    PC --> PS

    RS --> RD
    TS --> TD
    TTS --> TTD
    ARS --> ARD
    PS --> PD

    RS & TS & TTS & ARS & PS --> RR & TR & TTR & ARR
    RR & TR & TTR & ARR --> DB

    RS --> RTV
    TS --> ADTV
    ARS --> AREF
    RS --> CDCF

    %% Click events
    click RC "https://github.com/dnd-side-project/dnd-8th-5-backend/blob/main/src/main/java/com/dnd/modutime/core/room/controller/RoomController.java"
    click TC "https://github.com/dnd-side-project/dnd-8th-5-backend/blob/main/src/main/java/com/dnd/modutime/core/timeblock/controller/TimeBlockController.java"
    click TTC "https://github.com/dnd-side-project/dnd-8th-5-backend/blob/main/src/main/java/com/dnd/modutime/core/timetable/controller/TimeTableController.java"
    click ARC "https://github.com/dnd-side-project/dnd-8th-5-backend/blob/main/src/main/java/com/dnd/modutime/core/adjustresult/controller/AdjustmentResultController.java"
    click AC "https://github.com/dnd-side-project/dnd-8th-5-backend/blob/main/src/main/java/com/dnd/modutime/core/auth/controller/AuthController.java"
    click PC "https://github.com/dnd-side-project/dnd-8th-5-backend/blob/main/src/main/java/com/dnd/modutime/core/participant/controller/ParticipantController.java"
    
    click RS "https://github.com/dnd-side-project/dnd-8th-5-backend/blob/main/src/main/java/com/dnd/modutime/core/room/application/RoomService.java"
    click TS "https://github.com/dnd-side-project/dnd-8th-5-backend/blob/main/src/main/java/com/dnd/modutime/core/timeblock/application/TimeBlockService.java"
    click TTS "https://github.com/dnd-side-project/dnd-8th-5-backend/blob/main/src/main/java/com/dnd/modutime/core/timetable/application/TimeTableService.java"
    click ARS "https://github.com/dnd-side-project/dnd-8th-5-backend/blob/main/src/main/java/com/dnd/modutime/core/adjustresult/application/AdjustmentResultService.java"
    click AS "https://github.com/dnd-side-project/dnd-8th-5-backend/blob/main/src/main/java/com/dnd/modutime/core/auth/application/AuthService.java"
    click PS "https://github.com/dnd-side-project/dnd-8th-5-backend/blob/main/src/main/java/com/dnd/modutime/core/participant/application/ParticipantService.java"
    
    click RD "https://github.com/dnd-side-project/dnd-8th-5-backend/blob/main/src/main/java/com/dnd/modutime/core/room/domain/Room.java"
    click TD "https://github.com/dnd-side-project/dnd-8th-5-backend/blob/main/src/main/java/com/dnd/modutime/core/timeblock/domain/TimeBlock.java"
    click TTD "https://github.com/dnd-side-project/dnd-8th-5-backend/blob/main/src/main/java/com/dnd/modutime/core/timetable/domain/TimeTable.java"
    click ARD "https://github.com/dnd-side-project/dnd-8th-5-backend/blob/main/src/main/java/com/dnd/modutime/core/adjustresult/domain/AdjustmentResult.java"
    click PD "https://github.com/dnd-side-project/dnd-8th-5-backend/blob/main/src/main/java/com/dnd/modutime/core/participant/domain/Participant.java"
    
    click RR "https://github.com/dnd-side-project/dnd-8th-5-backend/blob/main/src/main/java/com/dnd/modutime/core/room/repository/RoomRepository.java"
    click TR "https://github.com/dnd-side-project/dnd-8th-5-backend/blob/main/src/main/java/com/dnd/modutime/core/timeblock/repository/TimeBlockRepository.java"
    click TTR "https://github.com/dnd-side-project/dnd-8th-5-backend/blob/main/src/main/java/com/dnd/modutime/core/timetable/repository/TimeTableRepository.java"
    click ARR "https://github.com/dnd-side-project/dnd-8th-5-backend/blob/main/src/main/java/com/dnd/modutime/core/adjustresult/repository/AdjustmentResultRepository.java"
    click WC "https://github.com/dnd-side-project/dnd-8th-5-backend/blob/main/src/main/java/com/dnd/modutime/config/WebConfig.java"
    
    click GEH "https://github.com/dnd-side-project/dnd-8th-5-backend/blob/main/src/main/java/com/dnd/modutime/advice/GlobalControllerAdvice.java"
    click TP "https://github.com/dnd-side-project/dnd-8th-5-backend/blob/main/src/main/java/com/dnd/modutime/util/TimeProvider.java"
    click TM "https://github.com/dnd-side-project/dnd-8th-5-backend/blob/main/src/main/java/com/dnd/modutime/util/Timer.java"
    
    click AREF "https://github.com/dnd-side-project/dnd-8th-5-backend/blob/main/src/main/java/com/dnd/modutime/core/adjustresult/util/executor/AdjustmentResultExecutorFactory.java"
    click CDCF "https://github.com/dnd-side-project/dnd-8th-5-backend/blob/main/src/main/java/com/dnd/modutime/core/room/util/CandidateDateTimeConvertorFactory.java"
    
    click RTV "https://github.com/dnd-side-project/dnd-8th-5-backend/blob/main/src/main/java/com/dnd/modutime/core/room/application/RoomTimeValidator.java"
    click ADTV "https://github.com/dnd-side-project/dnd-8th-5-backend/blob/main/src/main/java/com/dnd/modutime/core/timeblock/domain/AvailableDateTimeValidator.java"

    %% Styles
    classDef controller fill:#2196F3,stroke:#1565C0,color:white
    classDef service fill:#4CAF50,stroke:#2E7D32,color:white
    classDef domain fill:#FFC107,stroke:#FFA000,color:black
    classDef repo fill:#9E9E9E,stroke:#616161,color:white
    classDef config fill:#607D8B,stroke:#455A64,color:white
    classDef util fill:#F44336,stroke:#C62828,color:white
    classDef factory fill:#9C27B0,stroke:#6A1B9A,color:white
    classDef validator fill:#FF5722,stroke:#D84315,color:white
    classDef db fill:#795548,stroke:#4E342E,color:white
```
