MSA 기반 국내 물류 및 배송 시스템 개발
스파르타 물류는 국내 B2B 기업 간 상품의 주문, 배송, 재고 관리를 위한 MSA 기반 물류 플랫폼입니다.
실제 택배 및 유통 시스템과 유사한 구조를 반영하여, 허브 간 배송, 업체 간 거래, AI 기반 발송 예측, Slack 연동 알림, 배송 경로 추적 등 다양한 기능을 구현합니다.
실무 환경에서 요구되는 MSA 설계, 서비스 간 통신, 도메인 설계(DDD), 권한 제어, 트랜잭션 처리, 캐싱 전략, Docker 기반 환경 구축을 학습하며 개발한 프로젝트입니다.
| 구성원 | 역할 |
|---|---|
| BE(L): 남정길 | Order, Product, Auth 도메인 담당 |
| BE: 최진영 | Delivery 도메인 담당 |
| BE: 노석준 | Hub, Company도메인 담당 |
| BE: 공희진 | User, Notification 도메인 담당 |
| 도메인 | 기능 요약 |
|---|---|
| 허브 관리 | 전국 17개 허브 CRUD, 캐싱, 논리 삭제 |
| 업체 관리 | 생산업체/수령업체 등록, 허브 연동 |
| 상품 관리 | 업체별 상품 등록, 허브 상품관리 연계 |
| 주문 관리 | 주문 생성/취소, 재고 반영, 배송 자동 생성 |
| 배송 관리 | 배송 경로 설정, 상태 추적, 담당자 순번 배정 |
| 배송 담당자 관리 | 허브/업체 담당자 구분, 순차 배정 로직 구현 |
| 사용자 인증/인가 | JWT + Spring Security, 권한 기반 제어 |
| Slack 알림 | 주문 발생 시 배송 담당자 Slack 알림 전송 |
| AI 연동 | Gemini API를 통한 발송 마감 시간 예측 |
| 논리 삭제 관리 | 모든 엔티티에 deleted_at, deleted_by 적용 |
| 서치 기능 | 검색/정렬/페이징 기능 적용 |
- Spring Cloud Gateway: API 진입 지점
- Spring Cloud Eureka: 서비스 디스커버리
- 각 마이크로서비스: 허브, 업체, 주문, 배송 등
- Slack API 연동: 배송 Slack 알림 처리
- Gemini API 연동: 배송 예측 생성형 AI 활용
- Zipkin: 분산 추적
| 항목 | 사용 기술 |
|---|---|
| Language | Java 17 |
| Framework | Spring Boot 3.x, Spring Cloud |
| Auth | Spring Security, JWT |
| Database | PostgreSQL (서비스별 스키마 분리) |
| Docs | Swagger (OpenAPI) |
| Service Comm | REST API + FeignClient |
| DevOps | Docker, Docker Compose |
| Monitoring | Zipkin |
| ETC | Slack API, Gemini API |
