📦 eleven-logistics

국내 B2B 물류 관리 및 배송 시스템을 위한 MSA 기반 플랫폼입니다. 도별 공급 허브를 통해 주문이 발생하면 물류 처리 및 재고 이동으로 주문한 업체가 최종 수령할 수 있습니다.

📌 팀원 역할분담

임승택	백승규	오연주	한석규
BE / Order / Product	BE / Slack / Company / Hub	BE / Delivery / D_Route / D_Person	BE / User / Hub_Route / Auth

📌 서비스 구성 및 실행 방법

• 서비스 구성

• 실행 방법

- GoogleAI(Gemini) token, Slack token, Naver OpenAPI secret key 발급이 필요합니다.

1. docker를 설치합니다.

2. 아래의 명령어로 git clone을 진행합니다.

3. 해당 프로젝트의 루트 폴더로 이동합니다.

git clone https://github.com/se7en-e11even/eleven-logistics.git

4. docker-compose.yml 파일을 알맞은 위치에 작성합니다.

• docker-compose.yml

version: "3.8"
services:

  db:
    image: "postgres:16.3"
    container_name: "postgres"
    ports:
      - 5432:5432
    environment:
      - POSTGRES_USER=eleven-logistics
      - POSTGRES_PASSWORD=1234
      - POSTGRES_DB=eleven-logistics
    volumes:
      - postgres_data:/var/lib/postgresql/data
      - ./init-scripts:/docker-entrypoint-initdb.d

  rabbitmq:
    image: rabbitmq:management
    container_name: "rabbitmq"
    ports:
      - "15672:15672"

  redis:
    image: redis/redis-stack
    container_name: "redis"
    ports:
      - "8001:8001"
      - "6379:6379"

  zipkin:
    image: openzipkin/zipkin
    container_name: "zipkin"
    ports:
      - "9411:9411"

volumes:
  postgres_data:

5. 아래의 명령어를 실행합니다.

docker-compose up -d

6. key와 token설정을 마친 뒤, 다음의 순서대로 애플리케이션을 실행합니다.

• eureka service 실행
• gateway service 실행
• auth service 실행
• delivery, hub, hub-route, order, product, slack 실행

7. Service EndPoint

8. http://localhost:19091/docs

📌 프로젝트 목적

• MSA(Microservices Architecture) 기반의 물류 관리 및 배송 시스템 설계 및 구현
• Spring Cloud & Spring Boot를 활용하여 MSA 기반 시스템 구축
• 클린 아키텍처 구성 및 DDD를 적용해 확장, 유지보수에 좋은 설계
• API 연동, 데이터 무결성 유지, 서비스 간 통신 안정성 확보
• Gemini API를 활용한 AI 기술 적용 경험
• Github의 이슈발행, 프로젝트 관리 기능 등을 활용한 실무 수준의 협업 경험
• MSA의 복잡성과 운영 이슈 해결 능력 배양

📌 System Architecture

📌 ERD

📌 메시징 시스템 아키텍처

메시지 시스템 도입에 관한 고민

📌 기술 스택

• 백엔드: Spring Boot 3.4.3
• 데이터베이스: PostgreSQL
• 빌드 툴: Gradle
• API 문서화: Swagger + RestDoc 통합
• API 게이트웨이: Spring Cloud Gateway
• 메시지 시스템: RabbitMQ
• 분산 추적: Zipkin
• Cache: Redis
• 서비스 디스커버리: Spring Cloud Eureka
• 버전 관리: Git / GitHub
• 컨테이너: Docker

📌 트러블 슈팅

• SQL을 동적으로 삽입해 NAVER API에 적용하기
• AuditorAware 구현 후 JpaAuditing 적용 문제
• 메시지 타입 문제
• Redis 캐싱을 통한 성능 개선
• JWT 인증 및 역할 확인 문제 해결
• RabbitMQ 성능 개선 분석

📌 API docs

Swagger 문서 자동화: Swagger + RestDocs

각 서비스의 Swagger 문서를 gateway로 통합하여 제공 http://localhost:19091/docs