핏터링(fittering) Back-end

핏터링은 체형 분석을 쉽게 하고, 나의 체형에 fit한 옷을 추천해주는 쇼핑몰 서비스입니다.
fittering-BE는 핏터링 서비스의 백엔드 코드를 관리하는 레포지토리입니다.

📆 개발 기간

• 2023.06 ~ 2023.11

프로젝트 구조

다음은 fittering-BE 구조입니다.
MVC 패턴에 맞게 디렉토리를 분리했으며, 각 레벨에서 DTO를 관리하도록 구성했습니다.

src
├─ main
│  ├─ java
│  │  └─ fittering
│  │     └─ mall
│  │        ├─ config
│  │        │  ├─ auth
│  │        │  │  └─ domain
│  │        │  ├─ cache
│  │        │  ├─ jwt
│  │        │  └─ kafka
│  │        │     └─ domain
│  │        │        └─ dto
│  │        ├─ controller
│  │        │  └─ dto
│  │        │     ├─ request
│  │        │     └─ response
│  │        ├─ domain
│  │        │  ├─ collection
│  │        │  ├─ entity
│  │        │  └─ mapper
│  │        ├─ repository
│  │        │  ├─ dto
│  │        │  └─ querydsl
│  │        ├─ scheduler
│  │        │  └─ dto
│  │        └─ service
│  │           └─ dto
│  └─ resources
└─ test

• collection : 일급 컬렉션 관리
• mapper : MapStruct Mapper 인터페이스 관리
• test : Service 내 각 함수에 대한 JUnit 테스트 코드 관리

아키텍처

전체

핏터링 서비스는 다음과 같은 아키텍처로 구성되어 있습니다.

백엔드

핏터링 서비스의 백엔드는 다음과 같은 아키텍처로 구성되어 있습니다.

다음은 각 기술을 사용한 이유와 블로그에 기록한 📄 기술 적용기, ➰ 관련 PR입니다.

• Spring Data JPA, Querydsl
  • 개발 생산성 향상을 위해 적용
  • 📄
    • [Spring] 스프링 데이터 JPA 설정 및 쿼리 메소드
    • [Spring] Querydsl를 활용한 Repository와 Controller 개발
• Redis
  • API 응답 속도 향상을 위한 캐싱 적용 및 Spring scheduler와 함께 배치 업데이트에 활용
  • 📄
    • [Spring] Redis로 캐시 적용하기
    • [Spring] Redis 캐시를 활용해 데이터 주기적으로 반영하기
  • ➰ Redis 캐시 : 조회수 배치 업데이트 설정 #39
• JWT + OAuth2
  • 사용자 인증/인가 처리 수단으로 JWT 활용 및 소셜 로그인 기능 지원
  • 📄
    • [Spring] JWT로 인증 구현하기
    • [Spring] 카카오, 구글 OAuth + JWT
    • [Spring] JWT 예외 처리 필터 설정하기
  • ➰
    • JWT 적용 및 일부 코드 수정 #2
    • OAuth : JWT 적용 및 Apple 로그인 구현 등 #48
• Grafana + Prometheus
  • 서버 자원 정보 수집 및 모니터링
  • 📄 [Spring] Grafana + Prometheus 연동해서 모니터링 하기
  • ➰ Grafana + Prometheus 적용 및 추천 기능 수정 #4
• ELK (Logstash + Elasticsearch + Kibana)
  • 서버에서 발생하는 로그 수집 및 모니터링
  • 📄 [Spring] 스프링 부트에 ELK 적용하기
  • ➰ ELK 설정 : 로그 분석 및 시각화 #78
• Kafka
  • 운영 DB와 크롤링 DB 간 데이터 동기화 수행
  • 📄
    • [Spring] Kafka 적용하기
    • [Spring] Kafka 세부 설정하기
  • ➰
    • Kafka 적용 : DB 간 데이터 동기화 #80
    • 버그 수정 : DB 간 동기화 시 모든 상품 데이터를 반영하지 못하는 문제 #120
• Docker
  • Redis, Grafana, Prometheus, ELK를 컨테이너 환경에서 관리
• GitHub Actions
  • 프로젝트 자동화 배포를 위해 CI/CD 적용
  • 📄 [Spring] Github Actions로 EC2에 자동화 배포 적용
  • ➰
    • TDD, CI/CD #8
    • CD : docker compose 등록 #14
    • Github Actions : 자동화 배포 설정 완료 #17

Swagger

팀 내 API 문서 공유를 위해 Swagger를 적용했습니다.
아래는 문서 내용 일부로, 전체 문서는 여기에서 확인하실 수 있습니다.

• URI에 /auth이 포함된 API는 사용 시 권한이 필요함을 의미
• 📄 [Swagger] API 문서 만들기
• ➰ 테이블 등록, 로그인/회원가입 구현, API 문서화 #1

ERD

• 생성 날짜 created_at, 최종 수정 날짜 updated_at은 모든 엔티티의 공통 필드

💻 개발환경

- IntelliJ IDEA Ultimate 2023.1.3
- Java 17
- Spring Boot 3.1.1
- Spring Security 6.1.1
- Gradle 7.6.1
- MySQL 8.0.33
- ELK 7.6.2

📑 트러블 슈팅

• [Spring Security] There is no PasswordEncoder mapped for the id “null”
• [Spring] ClassNotFoundException: javax.xml.bind.DatatypeConverter
• [Spring] cannot deserialize from Object value
• [Prometheus] Get “http://host.docker.internal:8080/login”: stopped after 10 redirects
• [OAuth2] This class supports client_secret_basic, client_secret_post, and none by default
• [Spring] TransientPropertyValueException: object references an unsaved transient instance
• [Spring] Cannot construct instance of org.springframework.data.domain.PageImpl
• [Spring] java.lang.NoSuchFieldError: Class com.sun.tools.javac.tree.JCTree
• [Spring] java.lang.UnsupportedOperationException
• [Spring] actual and formal argument lists differ in length
• [Spring] JWT를 적용하면서 발생한 에러 정리
• [Spring] IllegalStateException: Ambiguous handler methods
• [Spring] multipart.MultipartException: Current request is not a multipart request
• more details...