How kwtriplanner/backend works
아래 지침은 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 전반의 아키텍처와 주요 상호작용을 명료하게 전달할 수 있습니다.