Sparta Java 단기 심화과정 물류 & 배송 MSA 프로젝트 - 3TM

---

프로젝트 구성원

• 송형근
• 전민기
• 최현

---

프로젝트 목적/상세

MSA 프로젝트를 활용하여 물류 배송 시스템 구축, MSA의 복잡성을 이해하고, 팀원들과 함께 MSA를 구축하며 실무에서 발생할 수 있는 문제를 간접적으로 경험하고 해결해 보기

---

사전 준비

• Naver OpenAPI Client ID & Secret
• 기상청 예보 OpenAPI 사용신청 및 API Key 발급 (기상청 예보 OpenAPI)
• Gemini API Key 발급
• Slack App 생성
  • 오늘의-날씨 채널 생성
  • Incoming webhook 앱 추가
  • Incoming webhook URL 복사
• PostgreSQL 설치 (5432 포트)
• Redis 설치 (6379 포트)

---

서비스 구성 및 실행방법

Eureka Server

• 포트 : 19090
• 필요 환경변수 : X

Gateway Server

• 포트 : 19091
• 필요 환경변수 : X

Auth Server

• 포트 : 19092
• 필요 환경변수 : X

Hub Server

• 포트 : 19093
• 필요 환경변수
  • naver_map_client_id
  • naver_map_client_secret

Company Server

• 포트 : 19094
• 필요 환경변수
  • GEMINI_API_KEY

Order Server

• 포트 : 19095
• 필요 환경변수 : X

Chore Server

• 포트 : 19096
• 필요 환경변수
  • WEATHER_SERVICE_KEY
  • SLACK_URL
  • GEMINI_API_KEY

PostgreSQL

• 포트 : 5432
• DB : postgres
• username : postgres
• pw : 1234

Redis

• 포트 : 6379
• username : default
• pw : systempass

---

트러블 슈팅

• Gateway Multi Path 적용 X 이슈 - Gateway Predicate Multi Paths
• Multi Module 사용 간 의존성 - Multi Module 공통 모듈 Dependencies

---

ERD

---

기술 스택

• Spring Boot 3.3.3
• Spring Cloud
• JWT
• JPA
• Redis
• Spring Security
• PostgreSql
• Docker
• Swagger
• Slack

---

프로젝트 구조

.
├── auth-server
│   └── src
│       └── main
│           ├── java
│           │   └── com
│           │       └── sparta3tm
│           │           └── authserver
│           │               ├── application
│           │               │   └── dtos
│           │               │       ├── DM
│           │               │       ├── auth
│           │               │       └── user
│           │               ├── config
│           │               ├── controller
│           │               └── domain
│           │                   ├── DM
│           │                   └── user
│           └── resources
├── chore-server
│   └── src
│       └── main
│           ├── java
│           │   └── com
│           │       └── sparta3tm
│           │           └── choreserver
│           │               ├── application
│           │               │   └── dtos
│           │               │       ├── slack
│           │               │       └── weather
│           │               ├── config
│           │               ├── controller
│           │               └── domain
│           │                   └── slack
│           └── resources
├── common
│   └── src
│       └── main
│           └── java
│               └── com
│                   └── sparta3tm
│                       └── common
│                           ├── config
│                           ├── gemini
│                           └── support
│                               ├── error
│                               └── response
├── company-server
│   └── src
│       └── main
│           ├── java
│           │   └── com
│           │       └── sparta3tm
│           │           └── companyserver
│           │               ├── application
│           │               │   └── dtos
│           │               │       ├── company
│           │               │       └── product
│           │               ├── config
│           │               ├── controller
│           │               ├── domain
│           │               │   ├── company
│           │               │   └── product
│           │               └── infrastructure
│           └── resources
├── eureka-server
│   └── src
│       └── main
│           ├── java
│           │   └── com
│           │       └── sparta3tm
│           │           └── eurekaserver
│           └── resources
├── gateway-server
│   └── src
│       └── main
│           ├── java
│           │   └── com
│           │       └── sparta3tm
│           │           └── gatewayserver
│           │               ├── config
│           │               ├── dto
│           │               └── filter
│           └── resources
├── hub-server
│   └── src
│       └── main
│           ├── java
│           │   └── com
│           │       └── sparta3tm
│           │           └── hubserver
│           │               ├── application
│           │               │   ├── dto
│           │               │   │   ├── hmi
│           │               │   │   │   ├── request
│           │               │   │   │   └── response
│           │               │   │   └── hub
│           │               │   │       ├── request
│           │               │   │       └── response
│           │               │   └── service
│           │               ├── domain
│           │               │   ├── entity
│           │               │   └── repository
│           │               ├── infrastructure
│           │               │   ├── client
│           │               │   │   └── dto
│           │               │   ├── config
│           │               │   ├── data
│           │               │   └── naver
│           │               │       ├── dto
│           │               │       └── service
│           │               └── presentation
│           │                   ├── controller
│           │                   └── handler
│           └── resources
└── order-server
    └── src
        └── main
            ├── java
            │   └── com
            │       └── sparta3tm
            │           └── orderserver
            │               ├── application
            │               │   ├── dto
            │               │   │   ├── request
            │               │   │   │   ├── delivery
            │               │   │   │   └── order
            │               │   │   └── response
            │               │   │       ├── delivery
            │               │   │       └── order
            │               │   └── service
            │               ├── domain
            │               │   ├── entity
            │               │   │   ├── delivery
            │               │   │   ├── delivery_route
            │               │   │   └── order
            │               │   └── repository
            │               ├── infrastructure
            │               │   └── client
            │               │       └── dto
            │               │           ├── company
            │               │           └── hub
            │               └── presentation
            │                   └── controller
            └── resources