☕Coffee

커피 주문 시스템

커피 메뉴 추가

POST /coffee

새로운 커피 메뉴 추가 ADMIN 사용자만 사용 가능

Headers

Name	Value
Content-Type	application/json
Authorization	Bearer <token>

Body

Name	Type	Description
name	string	커피 이름
price	number	커피 가격
imageUrl	string	커피 이미지 URL

Response

201

{
  "coffeeId": 1,
  "name": "Americano",
  "price": 4500,
  "imageUrl": "https://images.unsplash.com/photo-xxx"
}

400

{
  "name": "커피 이름을 입력해주세요.",
  "price": "가격은 0 이상이어야 합니다.",
  "imageUrl": "이미지 URL 을 입력해주세요."
}

401

{
  "message": "유효하지 않은 사용자 정보입니다."
}

403

{
  "message": "Access Denied"
}

커피 메뉴 조회

GET /coffee

커피 메뉴를 관리자가 등록한 순서대로 조회

Response

200

{
  "totalCounts": 1,
  "coffeeList": [
    "coffeeId": 1,
    "name": "Americano",
    "price": 4500,
    "imageUrl": "https://images.unsplash.com/photo-xxx"
  ]
}

401

{
  "message": "유효하지 않은 사용자 정보입니다."
}

커피 주문

POST /coffee/{coffeeId}/order

포인트를 사용하여 커피 주문 단건 주문 방식 주문 내역(userId coffeeId price)은 데이터 수집 플랫폼으로 실시간 전송 (Mock API 활용)

Headers

Name	Value
Authorization	Bearer <token>

Path Parameters

Name	Description
coffeeId	주문할 커피의 ID

Response

201

{
  "orderid": 1,
  "coffeId": 1,
  "orderDate": "2025-02-22T12:34:56"
}

400

{
  "message": "보유 포인트가 부족합니다."
}

401

{
  "message": "유효하지 않은 사용자 정보입니다."
}

404

{
  "message": "$coffeeId 번 커피 메뉴를 찾을 수 없습니다."
}

커피 주간 인기 메뉴 조회

GET /coffee/weekly-popular

최근 7일 간 가장 인기 있는 커피 메뉴 3개 조회 동시성 및 데이터 일관성 고려할 것

Response

200

{
  "totalCounts": 3,
  "coffeeList": [
    {
      "coffeeId": 1,
      "name": "Americano",
      "price": 4500,
      "weeklySales": 200
    },
    {
      "coffeeId": 2,
      "name": "Latte",
      "price": 5000,
      "weeklySales": 180
    },
    {
      "coffeeId": 3,
      "name": "Cappuccino",
      "price": 5500,
      "weeklySales": 160
    }
  ]
}

401

{
  "message": "유효하지 않은 사용자 정보입니다."
}