- e-커머스 상품 주문 서비스를 구현한다.
- 상품 주문에 필요한 메뉴 정보들을 구성하고 조회가 가능하도록 구현한다.
- 사용자는 상품을 여러 개 선택해 주문할 수 있고, 미리 충전한 잔액을 이용한다.
- 상품 주문 내역을 통해 판매량이 가장 높은 상품을 추천한다.
- Kotlin: 1.9.25
- Spring Boot: 2.7.18
- JPA: 1.9.24
- DBMS: H2
- Testing: JUnit, Mockito, K6
- Caching: Redis
- Event Broker: Kafka
- Monitoring: Grafana
hhplusecommerce
├─application
│ └─src.main.kotlin.com.example.hhplus_ecommerce
│ ├─balance
│ ├─cart
│ ├─config
│ ├─consumer
│ ├─order
│ ├─outbox
│ ├─payment
│ ├─product
│ ├─scheduler
│ └─statistic
├─domain
│ └─src.main.kotlin.com.example.hhplus_ecommerce
│ ├─balance
│ ├─cart
│ ├─messaging
│ ├─order
│ ├─outbox
│ ├─payment
│ ├─product
│ ├─share
│ └─user
├─infrastructure
│ └─src.main.kotlin.com.example.hhplus_ecommerce
│ ├─balance
│ ├─cart
│ ├─config
│ ├─external
│ ├─kafka
│ ├─lock
│ ├─order
│ ├─outbox
│ ├─payment
│ ├─product
│ └─user
└─web
└─src.main.kotlin.com.example.hhplus_ecommerce
├─advice
├─balance
├─cart
├─config
├─filter
├─interceptor
├─order
├─payment
├─product
└─statistics
./gradlew bootRun
./gradlew clean build && java -jar build/libs/hhplus_ecommerce-1.0.0.jar
docker build -t ecommerce-api .
docker run -p 8080:8080 ecommerce-api
1️⃣ 잔액 충전 / 조회 API
- 결제에 사용될 금액을 충전하는 API 를 작성한다.
- 사용자 식별자 및 충전할 금액을 받아 잔액을 충전한다.
- 사용자 식별자를 통해 해당 사용자의 잔액을 조회한다.
2️⃣ 상품 조회 API
- 상품 정보 ( ID, 이름, 가격, 잔여수량 ) 을 조회하는 API 를 작성한다.
- (조회시점의 상품별 잔여수량이 정확하면 좋다.)
3️⃣ 주문 / 결제 API
- 사용자 식별자와 (상품 ID, 수량) 목록을 입력받아 주문하고 결제를 수행하는 API 를 작성한다.
- 결제는 기 충전된 잔액을 기반으로 수행하며 성공할 시 잔액을 차감해야 한다.
- 데이터 분석을 위해 결제 성공 시에 실시간으로 주문 정보를 데이터 플랫폼에 전송해야 한다.
4️⃣ 상위 상품 조회 API
- 최근 3일간 가장 많이 팔린 상위 5개 상품 정보를 제공하는 API 를 작성한다.
5️⃣ 장바구니 기능
- 사용자는 구매 이전에 관심 있는 상품들을 장바구니에 적재할 수 있다.
- 이 기능을 제공하기 위해
장바구니에 상품 추가/삭제API 와장바구니 조회API 가 필요하다. - 위 두 기능을 제공하기 위해 어떤 요구사항의 비즈니스 로직을 설계해야할 지 고민해본다.