✈️ Expedia Clone Coding

• Table of Contents
  • 프로젝트 사용 기술
  • 소개
  • 아키텍처
  • DB ERD
  • 팀 컨벤션
  • 구현 과정

🚀 프로젝트 사용 기술

• Kotlin, Java
• Spring Boot, Spring Security, Spring webflux, Spring Cloud
• Spring Data JPA
• PostgreSQL, MySQL
• Kafka, gRPC
• Docker
• GitHub Actions
• K6 + Grafana + InfluxDB

🚀 소개

• 익스피디아 클론 코딩
• 백엔드 설계에 집중하기 위해 프론트 UI 는 카카오 오븐을 이용한 프로토 타이핑으로 대체함
• 구현 방식: 각 단계가 끝나면 Tag 를 생성하여 보관
  • v1: Rest Call
    • 사용자 위주의 구현
    • 비지니스 로직의 깊이 최대한 가볍게
  • v2: Event Driven
    • 내부 서비스간의 호출은 gRPC 사용
    • Kafka 활용
  • v3: async
    • 동기 코드를 비동기 코드로 전환
    • Spring Webflux + Coroutines 사용
  • v4: Spring cloud
    • Spring Cloud 적용 하기

🚀 아키텍처

• Gradle Multi module
  • 루트 모듈은 expedia-server 와 platform-server 로 나뉘어져있으며 각 모듈 아래 서브 모듈들이 존재하는 형태

아키텍처 이미지를 넣어주세요.

🚀 DB ERD

DB ERD 이미지를 넣어주세요.

🚀 팀 컨벤션

• Style Guide
  • Kotlin - Coding conventions Kotlin
  • Java - Google Java Coding Style Guide
• Test(TDD + ATDD): 기본 틀은 아래와 같으며 본인이 편한 방향에 따라서 작업 가능
  • Kotlin: 인수테스트는 Feature Spec, 도메인 레이어 테스트는 Describe Spec 을 적용
  1. 시나리오를 기반으로 실패하는 인수테스트를 작성(fail-acceptance)
  2. 문서화 테스트를 작성(documentation)
  3. 실패하는 테스트 케이스 작성(fail-unittest)
  4. 테스트 케이스를 통과시키기 위한 도메인 로직 작성 (production)
  5. 테스트 케이스 성공 시키고(success-unittest)
  6. 인수테스트를 성공 시키기(success-acceptance)
• Package: Layered Architectures
  • 패키지간 의존성 방향을 한 곳으로 흐르게끔 설계
  • interfaces
    • 사용자에게 정보를 보여주고 사용자의 명령을 해석하는 일을 책임진다.
    • DTO, Mapper, Controller
  • application
    • 수행할 작업을 정의하고 표현력 있는 도메인 객체가 문제를 해결하게 한다. 이 계층에서 책임지는 작업은 업무상 중요하거나 다른 시스템의 응용 계층과 상호 작용하는 데 필요한 것들이다. 이 계층은 얇게 유지되고, 오직 작업을 조정하고 아래에 위치한 계층에 포함된 도메인 객체의 협력자에게 작업을 위임한다.
    • xxxFacade
  • domain
    • 업무 개념과 업무 상황에 대한 정보, 업무 규칙을 표현하는 일을 책임진다.
    • Service, Command, Query, Entity
  • infrastructure
    • 상위 계층을 지원하는 일반화된 기술적 기능을 제공한다.
    • Low level 구현체
• VCS
  • Git 전략은 Forking Workflow 방식을 채용한다.
    • Github Open Source Contribute 방식(Forking Workflow)을 채용한다.
    • 개인 저장소로 Fork 후 진행
    • 모든 작업을 진행하기 전에(브랜치 생성하기 전)에 이슈를 먼저 생성해야 한다.
  • Remote 저장소의 Merge 는 “반드시 코드 리뷰가 진행되어야 한다.”
    • 코드 리뷰 없이 Merge 는 없다.
  • 이슈 관리는 Github 기능을 활용한다.
    • 모든 작업을 진행하기 전에(브랜치 생성하기 전)에 이슈를 먼저 생성해야 한다.
    • Label
      • codereview: code review
      • hotfix: bug fix
      • docs: documentations
      • enhance: new feature or request
      • discussion: Discussion
  • Branch
    • feature/이슈번호
    • 모든 작업한 feature 브랜치는 Merge 후에도 삭제하지 않는다.
  • Commit Message Template
    • init
    • feature
    • hotfix
    • refactor
    • docs
    • chore

    • feature: 숙박 후기 기능
      line break
      내용 작성
      

🚀 구현 과정

✅ Version-1

Login

• Redis 에 RefreshToken

주문 생성 요청

• 결제 서비스 미적용