GitHub - Mini-Team-6/Mini-Team-6-Backend: 미니프로젝트 백엔드 repo

개요

■ 프로젝트명

YA 어때

■ 기간

2023.11.17 ~ 2023.12.01

■ 목적

협업 및 팀워크 증진을 통하여 동일한 목표 달성 및 성취

Backend


현	성수	재욱	민정
- 숙소 및 객실 조회 - 예외처리 및 validation Biz - 테스트 코드(Junit,Mockito) - Flyway	- 예약 - 예외처리 및 validation Biz - 테스트 코드(Junit,Mockito) - 도메인 설계	회원 - TourAPI 가공 - Security - 예외처리 밒 validation 공통 - 인프라 및 배포 - 테스트 코드(Junit,Mockito)	장바구니 - 예외처리 및 validation Biz - 테스트 코드(Junit,Mockito) - CI - Flyway

진행 방식

Agile - Scrum XP - PairProgramming(Intellij codewithme)

구현 환경

Java 17
Spring Boot 3.x
Spring security 6.x
Docker
intellij
gradle
github action(CI)
PaaS(railway)
- 자동으로 Dockerfile을 수행하도록 설정
- 개발환경에서만 docker-compose 사용
Flyway
JPA
querydsl
jwt(refresh +access, Redis)
- rfc 문서 참고하여 구현

브랜치 전략

Git-flow 사용

사용

Docker 로 DB를 활성화 할 수 있습니다 docker-compose up
SpringBoot 를 실행합니다
test/Http 내 작성해둔 http 테스트 파일이 있습니다
테스트 코드도 작성하여 확인하실 수 있습니다

기능

회원

회원에 대한 가입, 로그인, 조회, 수정, 삭제를 할 수 있다.

회원 가입
로그인
회원 정보 조회
회원 정보 수정
회원 삭제

TourAPI

공공 데이터로부터 숙박 및 객실 정보를 받아온다.

숙소 다건 조회
숙소 단건 조회
객실 다건 조회
객실 단건 조회

숙소 검색

사용자가 숙소 및 객실 정보를 조회할 수 있다.

키워드 검색
키워드 + 지역 코드 검색
지역 코드 검색
검색 조건 없이 전체 조회 (페이징 구현)
숙소 상세 조회
숙소 ID에 해당하는 객실 전체 조회

장바구니

사용자가 원하는 객실을 장바구니에 추가, 조회, 삭제할 수 있다.

장바구니 전체 조회
장바구니 추가
장바구니 삭제

예약

사용자는 원하는 객실을 예약할 수 있다.

날짜 별 잔여 재고 동기화
객실 예약
장바구니 상품 묶음 예약
예약 내역 조회
예약 취소

API

Notion 참고

ERD

DB Diagram

흐름도

숙소

sequenceDiagram
actor User
User ->> AccommodationService : bringAccommodations
activate AccommodationService
AccommodationService ->> TourAPIService : bringAccommodations
activate TourAPIService
TourAPIService ->> TourAPIUtils : bringAccommodations
activate TourAPIUtils
TourAPIUtils ->> TourAPIUtils : buildCommonUrl
activate TourAPIUtils
TourAPIUtils -->> TourAPIUtils : #32; 
deactivate TourAPIUtils
TourAPIUtils ->> TourAPIUtils : fetchDataFromAPI
activate TourAPIUtils
TourAPIUtils -->> TourAPIUtils : #32; 
deactivate TourAPIUtils
TourAPIUtils -->> TourAPIService : #32; 
deactivate TourAPIUtils
TourAPIService ->> AccommodationTourAPIResponse : response
activate AccommodationTourAPIResponse
AccommodationTourAPIResponse -->> TourAPIService : #32; 
deactivate AccommodationTourAPIResponse
TourAPIService ->> TourAPIService : generateAccommodation
activate TourAPIService
TourAPIService ->> Accommodation : builder
activate Accommodation
Accommodation -->> TourAPIService : #32; 
deactivate Accommodation
TourAPIService ->> Location : builder
activate Location
Location -->> TourAPIService : #32; 
deactivate Location
TourAPIService -->> TourAPIService : #32; 
deactivate TourAPIService
TourAPIService ->> AccommodationGetResponse : AccommodationGetResponse::fromEntity
activate AccommodationGetResponse
AccommodationGetResponse ->> AccommodationGetResponse : new
activate AccommodationGetResponse
AccommodationGetResponse -->> AccommodationGetResponse : #32; 
deactivate AccommodationGetResponse
AccommodationGetResponse -->> TourAPIService : #32; 
deactivate AccommodationGetResponse
TourAPIService -->> AccommodationService : #32; 
deactivate TourAPIService
deactivate AccommodationService

객실

sequenceDiagram
actor User
User ->> RoomService : bringRoomsFromAPI
activate RoomService
RoomService ->> TourAPIService : bringRooms
activate TourAPIService
TourAPIService ->> TourAPIUtils : bringRoom
activate TourAPIUtils
TourAPIUtils ->> TourAPIUtils : buildCommonUrl
activate TourAPIUtils
TourAPIUtils -->> TourAPIUtils : #32; 
deactivate TourAPIUtils
TourAPIUtils ->> TourAPIUtils : fetchDataFromAPI
activate TourAPIUtils
TourAPIUtils -->> TourAPIUtils : #32; 
deactivate TourAPIUtils
TourAPIUtils -->> TourAPIService : #32; 
deactivate TourAPIUtils
TourAPIService ->> RoomTourAPIResponse : response
activate RoomTourAPIResponse
RoomTourAPIResponse -->> TourAPIService : #32; 
deactivate RoomTourAPIResponse
TourAPIService ->> Room : builder
activate Room
Room -->> TourAPIService : #32; 
deactivate Room
TourAPIService ->> Accommodation : builder
activate Accommodation
Accommodation -->> TourAPIService : #32; 
deactivate Accommodation
TourAPIService ->> RoomService : room -&gt;
activate RoomService
RoomService ->> Validation : validateDateFormat
activate Validation
Validation -->> RoomService : #32; 
deactivate Validation
RoomService ->> Validation : validateDateFormat
activate Validation
Validation -->> RoomService : #32; 
deactivate Validation
RoomService ->> RoomService : getRestStock
activate RoomService
RoomService ->> RoomRepository : findByRoomTypeId
activate RoomRepository
RoomRepository -->> RoomService : #32; 
deactivate RoomRepository
RoomService ->> ReservationRoomRepository : findAllByRoomAndCheckInBetweenAndCheckOutBetween
activate ReservationRoomRepository
ReservationRoomRepository -->> RoomService : #32; 
deactivate ReservationRoomRepository
RoomService -->> RoomService : #32; 
deactivate RoomService
RoomService ->> RoomGetResponseFromAPI : fromEntity
activate RoomGetResponseFromAPI
RoomGetResponseFromAPI ->> RoomGetResponseFromAPI : new
activate RoomGetResponseFromAPI
RoomGetResponseFromAPI -->> RoomGetResponseFromAPI : #32; 
deactivate RoomGetResponseFromAPI
RoomGetResponseFromAPI -->> RoomService : #32; 
deactivate RoomGetResponseFromAPI
RoomService -->> TourAPIService : #32; 
deactivate RoomService
TourAPIService -->> RoomService : #32; 
deactivate TourAPIService
deactivate RoomService

장바구니

sequenceDiagram
actor User
User ->> CartService : createCart
activate CartService
CartService ->> CartService : getMemberById
activate CartService
CartService -->> CartService : #32; 
deactivate CartService
CartService ->> CartCreateRequest : keyword
activate CartCreateRequest
CartCreateRequest -->> CartService : #32; 
deactivate CartCreateRequest
CartService ->> CartCreateRequest : areaCode
activate CartCreateRequest
CartCreateRequest -->> CartService : #32; 
deactivate CartCreateRequest
CartService ->> CartService : createAccommodationById
activate CartService
CartService ->> TourAPIService : bringAccommodation
activate TourAPIService
TourAPIService ->> TourAPIUtils : bringAccommodation
activate TourAPIUtils
TourAPIUtils ->> TourAPIUtils : bringAccommodations
activate TourAPIUtils
TourAPIUtils ->> TourAPIUtils : buildCommonUrl
activate TourAPIUtils
TourAPIUtils -->> TourAPIUtils : #32; 
deactivate TourAPIUtils
TourAPIUtils ->> TourAPIUtils : fetchDataFromAPI
activate TourAPIUtils
TourAPIUtils -->> TourAPIUtils : #32; 
deactivate TourAPIUtils
TourAPIUtils -->> TourAPIUtils : #32; 
deactivate TourAPIUtils
TourAPIUtils -->> TourAPIService : #32; 
deactivate TourAPIUtils
TourAPIService ->> AccommodationTourAPIResponse : response
activate AccommodationTourAPIResponse
AccommodationTourAPIResponse -->> TourAPIService : #32; 
deactivate AccommodationTourAPIResponse
TourAPIService ->> TourAPIService : generateAccommodation
activate TourAPIService
TourAPIService ->> Accommodation : builder
activate Accommodation
Accommodation -->> TourAPIService : #32; 
deactivate Accommodation
TourAPIService ->> Location : builder
activate Location
Location -->> TourAPIService : #32; 
deactivate Location
TourAPIService -->> TourAPIService : #32; 
deactivate TourAPIService
TourAPIService -->> CartService : #32; 
deactivate TourAPIService
CartService ->> CartService : getOrSaveAccommodation
activate CartService
CartService ->> CartService : () -&gt;
activate CartService
CartService -->> CartService : #32; 
deactivate CartService
CartService -->> CartService : #32; 
deactivate CartService
CartService -->> CartService : #32; 
deactivate CartService
CartService ->> CartCreateRequest : roomTypeId
activate CartCreateRequest
CartCreateRequest -->> CartService : #32; 
deactivate CartCreateRequest
CartService ->> CartService : createRoomByRoomTypeId
activate CartService
CartService ->> TourAPIService : bringRoom
activate TourAPIService
TourAPIService ->> TourAPIService : bringRooms
activate TourAPIService
TourAPIService ->> TourAPIUtils : bringRoom
activate TourAPIUtils
TourAPIUtils ->> TourAPIUtils : buildCommonUrl
activate TourAPIUtils
TourAPIUtils -->> TourAPIUtils : #32; 
deactivate TourAPIUtils
TourAPIUtils ->> TourAPIUtils : fetchDataFromAPI
activate TourAPIUtils
TourAPIUtils -->> TourAPIUtils : #32; 
deactivate TourAPIUtils
TourAPIUtils -->> TourAPIService : #32; 
deactivate TourAPIUtils
TourAPIService ->> RoomTourAPIResponse : response
activate RoomTourAPIResponse
RoomTourAPIResponse -->> TourAPIService : #32; 
deactivate RoomTourAPIResponse
TourAPIService ->> Room : builder
activate Room
Room -->> TourAPIService : #32; 
deactivate Room
TourAPIService ->> Accommodation : builder
activate Accommodation
Accommodation -->> TourAPIService : #32; 
deactivate Accommodation
TourAPIService -->> TourAPIService : #32; 
deactivate TourAPIService
TourAPIService -->> CartService : #32; 
deactivate TourAPIService
CartService ->> CartService : getOrSaveRoom
activate CartService
CartService ->> RoomRepository : findByRoomTypeId
activate RoomRepository
RoomRepository ->> CartService : () -&gt;
activate CartService
CartService -->> RoomRepository : #32; 
deactivate CartService
RoomRepository -->> CartService : #32; 
deactivate RoomRepository
CartService -->> CartService : #32; 
deactivate CartService
CartService -->> CartService : #32; 
deactivate CartService
CartService ->> CartService : createCart
activate CartService
CartService ->> CartCreateRequest : checkIn
activate CartCreateRequest
CartCreateRequest -->> CartService : #32; 
deactivate CartCreateRequest
CartService ->> Validation : validateDateFormat
activate Validation
Validation -->> CartService : #32; 
deactivate Validation
CartService ->> CartCreateRequest : checkOut
activate CartCreateRequest
CartCreateRequest -->> CartService : #32; 
deactivate CartCreateRequest
CartService ->> Validation : validateDateFormat
activate Validation
Validation -->> CartService : #32; 
deactivate Validation
CartService ->> Cart : builder
activate Cart
Cart -->> CartService : #32; 
deactivate Cart
CartService ->> CartCreateRequest : guestNumber
activate CartCreateRequest
CartCreateRequest -->> CartService : #32; 
deactivate CartCreateRequest
CartService -->> CartService : #32; 
deactivate CartService
CartService ->> CartCreateResponse : new
activate CartCreateResponse
CartCreateResponse -->> CartService : #32; 
deactivate CartCreateResponse
deactivate CartService

예약

sequenceDiagram
actor User
User ->> ReservationService : createReservation
activate ReservationService
ReservationService ->> ReservationCreateRequest : reservationRooms
activate ReservationCreateRequest
ReservationCreateRequest -->> ReservationService : #32; 
deactivate ReservationCreateRequest
ReservationService ->> ReservationService : reservationRoomDtosToEntityList
activate ReservationService
ReservationService ->> ReservationService : reservationRoomDtoToEntity
activate ReservationService
ReservationService ->> ReservationRoomCreateRequest : areaCode
activate ReservationRoomCreateRequest
ReservationRoomCreateRequest -->> ReservationService : #32; 
deactivate ReservationRoomCreateRequest
ReservationService ->> ReservationRoomCreateRequest : areaCode
activate ReservationRoomCreateRequest
ReservationRoomCreateRequest -->> ReservationService : #32; 
deactivate ReservationRoomCreateRequest
ReservationService ->> ReservationRoomCreateRequest : accommodationName
activate ReservationRoomCreateRequest
ReservationRoomCreateRequest -->> ReservationService : #32; 
deactivate ReservationRoomCreateRequest
ReservationService ->> TourAPIService : bringAccommodation
activate TourAPIService
TourAPIService ->> TourAPIUtils : bringAccommodation
activate TourAPIUtils
TourAPIUtils ->> TourAPIUtils : bringAccommodations
activate TourAPIUtils
TourAPIUtils ->> TourAPIUtils : buildCommonUrl
activate TourAPIUtils
TourAPIUtils -->> TourAPIUtils : #32; 
deactivate TourAPIUtils
TourAPIUtils ->> TourAPIUtils : fetchDataFromAPI
activate TourAPIUtils
TourAPIUtils -->> TourAPIUtils : #32; 
deactivate TourAPIUtils
TourAPIUtils -->> TourAPIUtils : #32; 
deactivate TourAPIUtils
TourAPIUtils -->> TourAPIService : #32; 
deactivate TourAPIUtils
TourAPIService ->> AccommodationTourAPIResponse : response
activate AccommodationTourAPIResponse
AccommodationTourAPIResponse -->> TourAPIService : #32; 
deactivate AccommodationTourAPIResponse
TourAPIService ->> TourAPIService : generateAccommodation
activate TourAPIService
TourAPIService ->> Accommodation : builder
activate Accommodation
Accommodation -->> TourAPIService : #32; 
deactivate Accommodation
TourAPIService ->> Location : builder
activate Location
Location -->> TourAPIService : #32; 
deactivate Location
TourAPIService -->> TourAPIService : #32; 
deactivate TourAPIService
TourAPIService -->> ReservationService : #32; 
deactivate TourAPIService
ReservationService ->> ReservationRoomCreateRequest : accommodationId
activate ReservationRoomCreateRequest
ReservationRoomCreateRequest -->> ReservationService : #32; 
deactivate ReservationRoomCreateRequest
ReservationService ->> ReservationRoomCreateRequest : roomTypeId
activate ReservationRoomCreateRequest
ReservationRoomCreateRequest -->> ReservationService : #32; 
deactivate ReservationRoomCreateRequest
ReservationService ->> TourAPIService : bringRoom
activate TourAPIService
TourAPIService ->> TourAPIService : bringRooms
activate TourAPIService
TourAPIService ->> TourAPIUtils : bringRoom
activate TourAPIUtils
TourAPIUtils ->> TourAPIUtils : buildCommonUrl
activate TourAPIUtils
TourAPIUtils -->> TourAPIUtils : #32; 
deactivate TourAPIUtils
TourAPIUtils ->> TourAPIUtils : fetchDataFromAPI
activate TourAPIUtils
TourAPIUtils -->> TourAPIUtils : #32; 
deactivate TourAPIUtils
TourAPIUtils -->> TourAPIService : #32; 
deactivate TourAPIUtils
TourAPIService ->> RoomTourAPIResponse : response
activate RoomTourAPIResponse
RoomTourAPIResponse -->> TourAPIService : #32; 
deactivate RoomTourAPIResponse
TourAPIService ->> Room : builder
activate Room
Room -->> TourAPIService : #32; 
deactivate Room
TourAPIService ->> Accommodation : builder
activate Accommodation
Accommodation -->> TourAPIService : #32; 
deactivate Accommodation
TourAPIService -->> TourAPIService : #32; 
deactivate TourAPIService
TourAPIService -->> ReservationService : #32; 
deactivate TourAPIService
ReservationService ->> ReservationService : getOrSaveAccommodation
activate ReservationService
ReservationService ->> ReservationService : () -&gt;
activate ReservationService
ReservationService -->> ReservationService : #32; 
deactivate ReservationService
ReservationService -->> ReservationService : #32; 
deactivate ReservationService
ReservationService ->> ReservationService : getOrSaveRoom
activate ReservationService
ReservationService ->> RoomRepository : findByRoomTypeId
activate RoomRepository
RoomRepository ->> ReservationService : () -&gt;
activate ReservationService
ReservationService -->> RoomRepository : #32; 
deactivate ReservationService
RoomRepository -->> ReservationService : #32; 
deactivate RoomRepository
ReservationService -->> ReservationService : #32; 
deactivate ReservationService
ReservationService ->> ReservationRoomCreateRequest : checkIn
activate ReservationRoomCreateRequest
ReservationRoomCreateRequest -->> ReservationService : #32; 
deactivate ReservationRoomCreateRequest
ReservationService ->> Validation : validateDateFormat
activate Validation
Validation -->> ReservationService : #32; 
deactivate Validation
ReservationService ->> ReservationRoomCreateRequest : checkOut
activate ReservationRoomCreateRequest
ReservationRoomCreateRequest -->> ReservationService : #32; 
deactivate ReservationRoomCreateRequest
ReservationService ->> Validation : validateDateFormat
activate Validation
Validation -->> ReservationService : #32; 
deactivate Validation
ReservationService ->> ReservationRoomCreateRequest : guestNumber
activate ReservationRoomCreateRequest
ReservationRoomCreateRequest -->> ReservationService : #32; 
deactivate ReservationRoomCreateRequest
ReservationService ->> ReservationRoom : createReservationRoom
activate ReservationRoom
ReservationRoom ->> ReservationRoom : builder
activate ReservationRoom
ReservationRoom -->> ReservationRoom : #32; 
deactivate ReservationRoom
ReservationRoom -->> ReservationService : #32; 
deactivate ReservationRoom
ReservationService -->> ReservationService : #32; 
deactivate ReservationService
ReservationService ->> ReservationService : this::isEnableReservation
activate ReservationService
ReservationService ->> ReservationService : getRestStock
activate ReservationService
ReservationService ->> ReservationRoomRepository : findAllByRoomAndCheckInBetweenAndCheckOutBetween
activate ReservationRoomRepository
ReservationRoomRepository -->> ReservationService : #32; 
deactivate ReservationRoomRepository
ReservationService -->> ReservationService : #32; 
deactivate ReservationService
ReservationService -->> ReservationService : #32; 
deactivate ReservationService
ReservationService -->> ReservationService : #32; 
deactivate ReservationService
ReservationService ->> ReservationService : getMemberByEmail
activate ReservationService
ReservationService ->> MemberRepository : findByEmail
activate MemberRepository
MemberRepository -->> ReservationService : #32; 
deactivate MemberRepository
ReservationService -->> ReservationService : #32; 
deactivate ReservationService
ReservationService ->> ReservationCreateRequest : paymentType
activate ReservationCreateRequest
ReservationCreateRequest -->> ReservationService : #32; 
deactivate ReservationCreateRequest
ReservationService ->> Reservation : createReservation
activate Reservation
Reservation ->> Reservation : builder
activate Reservation
Reservation ->> Reservation : reservation::addReservationRoom
activate Reservation
Reservation -->> Reservation : #32; 
deactivate Reservation
Reservation -->> Reservation : #32; 
deactivate Reservation
Reservation -->> ReservationService : #32; 
deactivate Reservation
ReservationService ->> ReservationCreateResponse : fromEntity
activate ReservationCreateResponse
ReservationCreateResponse ->> ReservationCreateResponse : builder
activate ReservationCreateResponse
ReservationCreateResponse -->> ReservationCreateResponse : #32; 
deactivate ReservationCreateResponse
ReservationCreateResponse -->> ReservationService : #32; 
deactivate ReservationCreateResponse
deactivate ReservationService

회원

sequenceDiagram
actor User
User ->> MemberService : createMember
activate MemberService
MemberService ->> SignupRequest : email
activate SignupRequest
SignupRequest -->> MemberService : #32; 
deactivate SignupRequest
MemberService ->> MemberRepository : existsByEmail
activate MemberRepository
MemberRepository -->> MemberService : #32; 
deactivate MemberRepository
MemberService ->> SignupRequest : email
activate SignupRequest
SignupRequest -->> MemberService : #32; 
deactivate SignupRequest
MemberService ->> SignupRequest : password
activate SignupRequest
SignupRequest -->> MemberService : #32; 
deactivate SignupRequest
MemberService ->> SignupRequest : name
activate SignupRequest
SignupRequest -->> MemberService : #32; 
deactivate SignupRequest
MemberService ->> SignupRequest : new
activate SignupRequest
SignupRequest -->> MemberService : #32; 
deactivate SignupRequest
MemberService ->> SignupRequest : toEntity
activate SignupRequest
SignupRequest ->> Member : builder
activate Member
Member -->> SignupRequest : #32; 
deactivate Member
SignupRequest -->> MemberService : #32; 
deactivate SignupRequest
MemberService ->> SignupResponse : fromEntity
activate SignupResponse
SignupResponse ->> SignupResponse : new
activate SignupResponse
SignupResponse -->> SignupResponse : #32; 
deactivate SignupResponse
SignupResponse -->> MemberService : #32; 
deactivate SignupResponse
deactivate MemberService

Name		Name	Last commit message	Last commit date
Latest commit History 344 Commits
.github		.github
database		database
gradle/wrapper		gradle/wrapper
src		src
.gitignore		.gitignore
Dockerfile		Dockerfile
README.md		README.md
build.gradle		build.gradle
docker-compose.yml		docker-compose.yml
gradlew		gradlew
gradlew.bat		gradlew.bat
settings.gradle		settings.gradle

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Repository files navigation

개요

Backend

진행 방식

구현 환경

브랜치 전략

사용

기능

회원

TourAPI

숙소 검색

장바구니

예약

API

ERD

DB Diagram

흐름도

숙소

객실

장바구니

예약

회원

About

Releases

Contributors 4

Languages

Mini-Team-6/Mini-Team-6-Backend

Folders and files

Latest commit

History

Repository files navigation

개요

Backend

진행 방식

구현 환경

브랜치 전략

사용

기능

회원

TourAPI

숙소 검색

장바구니

예약

API

ERD

DB Diagram

흐름도

숙소

객실

장바구니

예약

회원

About

Resources

Stars

Watchers

Forks

Releases

Contributors 4

Languages