/jwp-shopping-order

우아한테크코스 레벨 2 장바구니 협업 미션 레파지토리

Primary LanguageJava

🧺 장바구니 협업 미션

Pair: 져니 ⛄️, 라온 😊, 쥬니 😎

✔ 기능 요구사항

사용자

  • 사용자를 추가할 수 있다.
    • 사용자는 처음 가입하면 신규 가입 쿠폰을 받는다.
  • 특정 사용자의 정보를 받을 수 있다.
  • 모든 사용자의 정보를 받을 수 있다.
  • 사용자는 본인이 가지고 있는 쿠폰 목록을 조회할 수 있다.
  • 사용자는 로그인할 수 있다.

장바구니

  • 특정 사용자의 장바구니 리스트를 조회할 수 있다.
  • 특정 사용자의 장바구니에 상품을 추가할 수 있다.
  • 이미 추가된 장바구니 상품의 수량을 변경할 수 있다.
    • 수량을 0으로 변경하면 장바구니에서 상품이 제거된다.
  • 장바구니의 상품을 제거할 수 있다.
  • 장바구니의 상품을 여러 개 제거할 수 있다.

상품

  • 상품 리스트를 반환한다.
  • 상품 리스트에 대해서 페이지 단위로 조회한다.
  • 상품의 아이디로 상품을 조회한다.
  • 상품을 생성한다.
  • 상품 정보를 업데이트한다.
  • 상품을 삭제한다.
    • 실제로 삭제하는 것이 아닌, 삭제 필드만 변경한다.

상품 주문

  • 상품을 주문할 수 있다.
    • 상품은 최대 100,000개까지 주문할 수 있다.
    • 장바구니에 있는 상품만 주문할 수 있다.
    • 쿠폰은 최대 1장만 사용할 수 있다.
    • 첫 주문 시 '첫 주문 감사 쿠폰'을 발급한다.
    • 상품 주문이 완료되면 장바구니에 담긴 아이템을 제거한다.
    • 제거된 상품은 주문할 수 없다.
  • 사용자의 전체 주문 내역을 조회할 수 있다.
  • 사용자의 특정 주문 번호에 대한 내역을 조회할 수 있다.
  • 주문을 취소할 수 있다.
    • 주문한 지 3일 이내면 전액, 7일 이내면 반액을 환불하고, 그 이후는 불가능하다.
    • 쿠폰의 유효기간이 지나지 않았다면, 쿠폰을 사용 가능한 상태로 변경한다.

쿠폰

  • 쿠폰을 추가할 수 있다.
  • 쿠폰 정보를 삭제할 수 있다.
  • 전체 쿠폰 정보를 조회할 수 있다.
  • 특정 쿠폰 정보를 조회할 수 있다.
  • 인터셉터를 붙일까 고민했는데, 우선 미션 요구사항에 맞게 개발하는 게 우선인 것 같아서 패스하였습니다 😶

DB 다이어그램

도커 구동 방법 (Local)

  • Active Profile을 local로 하고 실행해 주세요!
cd ./docker
docker-compose up -d

HTTP 요청 가이드

  • http 디렉터리를 http client를 활용하여 실행하시면 더 편하게 API 요청을 진행하실 수 있습니다!
  • Run With 옵션을 local로 설정해 주세요.

상품 API (ProductController)

  • product.http
HTTP method 요청 URI
상품 추가 POST /products
상품 수정 PUT /products
상품 단일 조회 GET /products/{id}
상품 전체 조회 GET /products
상품 페이지 조회 GET /products/pages?page=1&size=10
상품 삭제 DELETE /products/{id}

사용자 API (MemberController)

  • member.http
HTTP method 요청 URI
사용자 추가 POST /users/join
사용자 로그인 POST /users/login
사용자 단일 조회 GET /users/{id}
사용자 전체 조회 GET /users
사용자 쿠폰 전체 조회 GET /users/me/coupons

장바구니 API (CartItemController)

  • cart-item.http
HTTP method 요청 URI
장바구니 추가 POST /cart-items
장바구니 상품 수량 수정 PATCH /cart-items/{id}
장바구니 상품 조회 GET /cart-items
장바구니 상품 삭제 DELETE /cart-items/{id}
장바구니 상품 다중 삭제 DELETE /cart-items?ids=1,2

쿠폰 API (CouponController)

  • coupon.http
HTTP method 요청 URI
쿠폰 추가 POST /coupons
쿠폰 단일 조회 GET /coupons/{id}
쿠폰 전체 조회 GET /coupons
쿠폰 삭제 DELETE /coupons/{id}

주문 API (OrderController)

  • order.http
HTTP method 요청 URI
주문 추가 POST /orders
주문 단일 조회 GET /orders/1
주문 단일 조회 GET /orders
주문 취소 POST /orders/cancel/1