# kwtriplanner/backend architecture

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

- Interactive diagram: https://gitdiagram.com/kwtriplanner/backend
- Repository: https://github.com/kwtriplanner/backend

## Overview

아래 지침은 TripPlanner Backend 프로젝트의 아키텍처 다이어그램을 그릴 때 따라야 할 구체적인 안내입니다. 주어진 사용자 지침을 우선 반영하여, 핵심 기능 중심, 비즈니스 도메인별 그룹화, 4개 레이어, 주요 흐름만 표시합니다.

##### 프로젝트 유형 및 목적 파악
- Spring Boot 기반의 RESTful 백엔드 서비스
- AI 기반 여행 일정 추천 기능을 포함한 여행 계획 관리 시스템
- JWT 인증, MySQL 데이터 저장, Docker 컨테이너화 지원

##### 주요 컴포넌트(비즈니스 도메인별 그룹화)
a. 회원(Member)
- MemberController ↔ AuthService, MemberService
- AuthService (로그인/로그아웃, JWT 생성)
- MemberService (회원 CRUD)
- MemberRepository (JPA)
b. 장소(Place)
- PlaceController
- PlaceService
- PlaceRepository
c. 리뷰(Review)
- ReviewController
- ReviewService
- ReviewRepository
d. 계획(Plan)
- PlanController
- PlanService
- PlanRepository
- PlanPlace 관계 객체
e. 그룹/초대(Group & Invite)
- GroupController, InviteController
- GroupService, InviteService
- GroupRepository, InviteRepository

##### 4개 레이어 구조
1) Client Layer
- 모바일/웹 애플리케이션 또는 API 호출자
- HTTP 요청 → 컨트롤러(API 엔드포인트)
2) Business Logic Layer
- Controllers (인증 필터 포함: AuthFilter)
- Services (MemberService, PlaceService, ReviewService, PlanService, GroupService, InviteService, AuthService)
- WebConfig, SecurityConfig (Spring Security 설정)
3) Data Access Layer
- Repositories (Spring Data JPA 인터페이스)
- Entity 클래스 (Member, Place, Review, Plan, Group, Invite, PlanPlace, MemberGroup)
4) Infrastructure Layer
- MySQL 데이터베이스
- JWT TokenProvider
- Docker / Docker-Compose, application-*.properties

##### 주요 데이터 흐름 및 상호작용
1) 인증 흐름
Client → AuthController → AuthService → TokenProvider → JWT 발급
JWT → AuthFilter → SecurityConfig → API 접근 제어
2) 회원/그룹/초대
MemberController → MemberService → MemberRepository → MySQL
GroupController/InviteController → 그룹·초대 처리
3) 장소/리뷰
PlaceController → PlaceService → PlaceRepository
ReviewController → ReviewService → ReviewRepository
4) 여행 계획
PlanController → PlanService → PlanRepository (+ PlanPlace 저장)
AI 추천은 PlanService 내부 로직(외부 AI 모듈 호출 or 내부 알고리즘)
5) 데이터 저장
모든 CRUD는 JPA Repository → MySQL

##### 다이어그램 구성 가이드
- 각 레이어를 수평(또는 수직)으로 구분:
[Client]
↓
[Business Logic] (컨트롤러·서비스)
↓
[Data Access] (리포지토리·엔티티)
↓
[Infra] (MySQL, JWT 모듈, Docker)
- 비즈니스 도메인별로 컴포넌트를 색상(혹은 형태)로 묶어서 Group, Member, Place, Review, Plan 도메인 강조
- 화살표로 호출 방향 및 데이터 흐름 명확히 표시
- 컨트롤러→서비스→리포지토리→DB 흐름 선으로 연결

##### 다이어그램 작성 시 필수 요소
- 컴포넌트 레이블: “PlanController”, “PlanService” 등
- 화살표: 단방향(→)으로 요청/응답 흐름 표시
- 색상·도형:
- Client: 파란색 클라이언트 아이콘
- Controller: 연두색 사각형
- Service: 노란색 사각형
- Repository: 주황색 사각형
- Infra: 회색(데이터베이스, JWT, Docker)
- 레이어별 구역 구분: 구분선 또는 배경색

- 세부 구현(메소드, DTO)은 생략
- 4개 레이어로 구분, 비즈니스 도메인별 그룹화
- 주요 흐름(인증, CRUD, AI 추천) 위주로 표현
- 명확한 레이블, 방향, 색상 활용으로 가독성 확보

이 지침에 따라 다이어그램을 그리면, TripPlanner Backend 전반의 아키텍처와 주요 상호작용을 명료하게 전달할 수 있습니다.

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Client Layer
    Client["Client\n(Web/Mobile)"]:::client

    %% Business Logic Layer
    subgraph "Business Logic Layer"
        direction TB
        subgraph "Authentication"
            direction TB
            AuthController["AuthController"]:::controller
            AuthService["AuthService"]:::service
            AuthController -->|"calls"| AuthService
            AuthService -->|"uses"| TokenProvider
        end

        subgraph "Member Domain"
            direction TB
            MemberController["MemberController"]:::controller
            MemberService["MemberService"]:::service
            MemberRepo["MemberRepository"]:::repository
            MemberController -->|"calls"| MemberService
            MemberService -->|"calls"| MemberRepo
        end

        subgraph "Place Domain"
            direction TB
            PlaceController["PlaceController"]:::controller
            PlaceService["PlaceService"]:::service
            PlaceRepo["PlaceRepository"]:::repository
            PlaceController -->|"calls"| PlaceService
            PlaceService -->|"calls"| PlaceRepo
        end

        subgraph "Review Domain"
            direction TB
            ReviewController["ReviewController"]:::controller
            ReviewService["ReviewService"]:::service
            ReviewRepo["ReviewRepository"]:::repository
            ReviewController -->|"calls"| ReviewService
            ReviewService -->|"calls"| ReviewRepo
        end

        subgraph "Plan Domain"
            direction TB
            PlanController["PlanController"]:::controller
            PlanService["PlanService"]:::service
            PlanRepo["PlanRepository"]:::repository
            PlanController -->|"calls"| PlanService
            PlanService -->|"calls"| PlanRepo
        end

        subgraph "Group & Invite Domain"
            direction TB
            GroupController["GroupController"]:::controller
            GroupService["GroupService"]:::service
            GroupRepo["GroupRepository"]:::repository
            InviteController["InviteController"]:::controller
            InviteService["InviteService"]:::service
            InviteRepo["InviteRepository"]:::repository

            GroupController -->|"calls"| GroupService
            GroupService -->|"calls"| GroupRepo

            InviteController -->|"calls"| InviteService
            InviteService -->|"calls"| InviteRepo
        end
    end

    %% Data Access Layer
    subgraph "Data Access Layer"
        direction TB
        MemberEntity["Member Entity"]:::repository
        PlaceEntity["Place Entity"]:::repository
        ReviewEntity["Review Entity"]:::repository
        PlanEntity["Plan Entity"]:::repository
        PlanPlace["PlanPlace"]:::repository
        GroupsEntity["Groups Entity"]:::repository
        InviteEntity["Invite Entity"]:::repository

        MemberRepo -->|"manages"| MemberEntity
        PlaceRepo -->|"manages"| PlaceEntity
        ReviewRepo -->|"manages"| ReviewEntity
        PlanRepo -->|"manages"| PlanEntity
        PlanRepo -->|"manages"| PlanPlace
        GroupRepo -->|"manages"| GroupsEntity
        InviteRepo -->|"manages"| InviteEntity
    end

    %% Infrastructure Layer
    subgraph "Infrastructure Layer"
        direction TB
        MySQL[(MySQL)]:::infra
        TokenProvider["TokenProvider"]:::infra
        Docker[(Docker / Compose)]:::infra
        AppProps["application-*.properties"]:::infra

        MemberRepo --> MySQL
        PlaceRepo --> MySQL
        ReviewRepo --> MySQL
        PlanRepo --> MySQL
        GroupRepo --> MySQL
        InviteRepo --> MySQL
        TokenProvider --> MySQL
    end

    %% Client to Controllers
    Client --> AuthController
    Client --> MemberController
    Client --> PlaceController
    Client --> ReviewController
    Client --> PlanController
    Client --> GroupController
    Client --> InviteController

    %% Click Events
    click MemberController "https://github.com/kwtriplanner/backend/blob/main/src/main/java/capstone/triplanner/member/MemberController.java"
    click AuthService "https://github.com/kwtriplanner/backend/blob/main/src/main/java/capstone/triplanner/member/AuthService.java"
    click MemberService "https://github.com/kwtriplanner/backend/blob/main/src/main/java/capstone/triplanner/member/MemberService.java"
    click MemberRepo "https://github.com/kwtriplanner/backend/blob/main/src/main/java/capstone/triplanner/member/MemberRepository.java"
    click MemberEntity "https://github.com/kwtriplanner/backend/blob/main/src/main/java/capstone/triplanner/member/Member.java"
    click PlaceController "https://github.com/kwtriplanner/backend/blob/main/src/main/java/capstone/triplanner/place/PlaceController.java"
    click PlaceService "https://github.com/kwtriplanner/backend/blob/main/src/main/java/capstone/triplanner/place/PlaceService.java"
    click PlaceRepo "https://github.com/kwtriplanner/backend/blob/main/src/main/java/capstone/triplanner/place/PlaceRepository.java"
    click PlaceEntity "https://github.com/kwtriplanner/backend/blob/main/src/main/java/capstone/triplanner/place/Place.java"
    click ReviewController "https://github.com/kwtriplanner/backend/blob/main/src/main/java/capstone/triplanner/review/ReviewController.java"
    click ReviewService "https://github.com/kwtriplanner/backend/blob/main/src/main/java/capstone/triplanner/review/ReviewService.java"
    click ReviewRepo "https://github.com/kwtriplanner/backend/blob/main/src/main/java/capstone/triplanner/review/ReviewRepository.java"
    click ReviewEntity "https://github.com/kwtriplanner/backend/blob/main/src/main/java/capstone/triplanner/review/Review.java"
    click PlanController "https://github.com/kwtriplanner/backend/blob/main/src/main/java/capstone/triplanner/plan/PlanController.java"
    click PlanService "https://github.com/kwtriplanner/backend/blob/main/src/main/java/capstone/triplanner/plan/PlanService.java"
    click PlanRepo "https://github.com/kwtriplanner/backend/blob/main/src/main/java/capstone/triplanner/plan/PlanRepository.java"
    click PlanEntity "https://github.com/kwtriplanner/backend/blob/main/src/main/java/capstone/triplanner/plan/Plan.java"
    click PlanPlace "https://github.com/kwtriplanner/backend/blob/main/src/main/java/capstone/triplanner/planPlace/PlanPlace.java"
    click GroupController "https://github.com/kwtriplanner/backend/blob/main/src/main/java/capstone/triplanner/group/GroupController.java"
    click GroupService "https://github.com/kwtriplanner/backend/blob/main/src/main/java/capstone/triplanner/group/GroupService.java"
    click GroupRepo "https://github.com/kwtriplanner/backend/blob/main/src/main/java/capstone/triplanner/group/GroupRepository.java"
    click GroupsEntity "https://github.com/kwtriplanner/backend/blob/main/src/main/java/capstone/triplanner/group/Groups.java"
    click InviteController "https://github.com/kwtriplanner/backend/blob/main/src/main/java/capstone/triplanner/invite/InviteController.java"
    click InviteService "https://github.com/kwtriplanner/backend/blob/main/src/main/java/capstone/triplanner/invite/InviteService.java"
    click InviteRepo "https://github.com/kwtriplanner/backend/blob/main/src/main/java/capstone/triplanner/invite/InviteRepository.java"
    click InviteEntity "https://github.com/kwtriplanner/backend/blob/main/src/main/java/capstone/triplanner/invite/Invite.java"
    click AuthController "https://github.com/kwtriplanner/backend/blob/main/src/main/java/capstone/triplanner/token/AuthController.java"
    click TokenProvider "https://github.com/kwtriplanner/backend/blob/main/src/main/java/capstone/triplanner/token/TokenProvider.java"
    click Docker "https://github.com/kwtriplanner/backend/tree/main/Dockerfile"
    click Docker "https://github.com/kwtriplanner/backend/blob/main/(docker-compose.yml)"
    click AppProps "https://github.com/kwtriplanner/backend/blob/main/src/main/resources/application-*.properties"

    %% Styles
    classDef client fill:#D0E7FF,stroke:#1070CA,color:#1070CA;
    classDef controller fill:#E6F5C9,stroke:#7FB800,color:#385E0B;
    classDef service fill:#FFF4B3,stroke:#F2C94C,color:#7A5901;
    classDef repository fill:#FFE5CC,stroke:#FB8C00,color:#7A4500;
    classDef infra fill:#E0E0E0,stroke:#949494,color:#333333;
```
