MSA 기반 물류 관리 시스템 "물류ON"

1. About Project

• 프로젝트명: MSA 기반 국내 물류 관리 및 배송 시스템 개발
• 프로젝트 목표:
  • 기존 모놀리식 시스템의 한계를 극복하기 위해 MSA 구조 도입, 각 도메인을 독립적으로 설계
  • DDD 관점 적용하여 물류 시스템을 체계적으로 모델링 및 개발
  • 실제 운영 환경에서도 활용 가능한 구조를 갖춘 시스템 구현
• 진행 기간: 2025년 3월 11일 ~ 3월 25일 (총 15일간)
• 시연 스크립트:

2. Team7 Chill Guys

김소진	박소해	오혜민	조규성	주소연
Lead	BE	BE	Tech	BE
GitHub	GitHub	GitHub	GitHub	GitHub

3. Tasks & Responsibilities (작업 및 역할 분담)

[조규성]

• Eureka Server:

  • 마이크로 서비스 등록 및 서비스 간 위치 탐색을 위한 등록 서버 구축

• API Gateway:

  • Spring Cloud Gateway 기반 API 게이트웨이 구성
  • 경로 기반 라우팅 설정 및 인증 필터
  • JWT 기반 토큰 검증
  • Redis 토큰 블랙리스트 검증
  • Eureka 연동을 통한 라우팅 자동화 구현

• User Service

  • 사용자 정보 등록, 조회, 수정, 권한 변경 등 사용자 기능 구현
  • JPA 기반 도메인 모델 설계 및 구현 (User, UserRole 등)
  • FeignClient를 통한 외부 마이크로서비스 통신 구조 설계

• Auth Service

  • 로그인 및 회원가입 기능 구현
  • JWT 기반 토큰 발급, 재발급 기능
  • Redis 화이트, 블랙리스트 토큰 설정

• Docker 환경 구성

  • 각 서비스 Dockerfile 작성
  • Docker Compose 3단계 설정. Dockerfile build, app, database
  • 하드웨어 리소스가 부족한 인원을 위해 Docker Hub로 이미지 관리 병행

[오혜민]

• Hub Service
  • 허브 등록, 조회, 수정, 삭제 기능 구현
  • 허브 등록/수정/삭제 시, 허브 루트 자동 생성/수정/삭제 기능 연동
  • FeignClient를 이용해 외부 서비스와의 통신 처리
• HubRoute Service
  • 허브 루트 등록, 조회, 수정, 삭제 기능 구현
  • 카카오 API를 활용하여 허브 간 이동 거리 및 시간 계산 기능 구현
  • Redis를 활용한 캐싱 처리로 데이터 조회 속도 향상
  • 허브/루트 정보 변경 시, 관련 캐시 데이터 자동 삭제 처리
  • FeignClient를 이용한 외부 서비스 통신

[주소연]

• Product Service

  • 상품 등록, 조회, 수정, 삭제, 검색 기능 구현
  • FeignClient를 이용해 다양한 외부 서비스와의 통신 처리

• Slack Service

  • Slack API 연동
  • FeignClient를 이용해 다양한 외부 서비스와의 통신 처리

• AI Service

  • Gemini API 연동
  • FeignClient를 이용해 슬랙 서비스와의 통신 처리

[김소진]

• Company Service

  • 업체 등록, 조회, 수정, 삭제, 검색 기능 구현
  • FeignClient를 활용한 외부 마이크로서비스 통신 구조 설계

• Order Service

  • 주문 등록, 조회, 수정, 삭제, 검색 기능 구현
  • JWT 기반 사용자 인증 및 권한 검증 로직 구현으로 보안 강화
  • FeignClient를 활용한 외부 마이크로서비스(배송, 상품 등) 연동 구조 설계
  • 주문 상태에 따른 로직 분기 처리 및 주문 이력 관리 기능 구현

[박소해]

• Delivery Service

  • 배송 등록, 조회, 수정, 삭제 기능 구현
  • FeignClient를 활용한 외부 마이크로서비스 통신 구조 설계

• DeliveryManager Service

  • 배송 담당자 등록, 조회, 수정, 삭제 기능 구현
  • 담당자 선정 시 관련 배송 정보 자동 연동 처리
  • Kafka를 활용한 이벤트 기반 아키텍처 설계로 서비스 간 비동기 처리 구현
  • Slack 연동을 통해 배송담당자 알림 자동화 처리

4. ERD

erdcloud : https://www.erdcloud.com/d/sT8WDsAXXqfbB9Gay

5. Infra

6. Technology Stack (기술 스택)

Spring Boot		3.4.3
Java		17
Spring Data JPA		5.0.0
Spring Security		3.4.2
Kafka		3.4.2
Redis		7.0.3