API - [Shelf] Thêm, xóa, sửa Shelf

[PhucHoangVan]

• Tạo mới kệ
• Sửa thông tin kệ
• Xóa kệ (kiểm tra kệ trống trước khi xóa)

[PhucHoangVan]

[API Description]

API create shelf

description: API Tạo mới kệ Base URL: [POST] api/shelfs/create Used By: STAFF

Parameters Request:

Parameters	Description
Không	Không

Body request:

{ "categoryId": "int", "shelfCode": "string" }

Expected Response:

{
    "statusCode": 200,
    "data": {
        "id": "int",
        "categoryId": "int",
        "shelfCode": "string",
        "createdAt": "string",
        "updatedAt": "string"
    }
}

NOTE:

API Update tương tự, cho phép update CategoryId, shelfCode API Delete by Id => Kiểm tra kệ rỗng thì được xóa => nếu xóa kệ không rỗng thì trả về status: 400 (Bad Request)

[PhucHoangVan]

Điều chỉnh api Create Shelf

Mô tả sự thay đổi: Khi tạo kệ (Shelf), phải kèm theo số tầng (Tier) thuộc kệ, và số Ngăn (Compartment) thuộc mỗi tầng.

• Trong body bổ sung field:

  • tiers: là những tầng thuộc kệ được tạo
  • NumberOfCompartment: là số ngăn thuộc tần được tạo

Body:

{
    "shelfCode": "string",
    "categoryId": "int",
    "tiers": [
        {
            "NumberOfCompartment": "int"
        },
        {
            "NumberOfCompartment": "int"
        }
    ]
}

Xử lý:

• [1] - Tạo Shelf với thông tin:

  "shelfCode": "string",
  "categoryId": "int",

• [2] Tạo tier dựa vào số lượng phần tử trong field tires

  "shelfId": "lấy từ id của shelf tạo ở bước [1]",
  "tierCode": "int - là số tự tăng, bắt đầu từ 1",

• [3] Tạo compartment cho mỗi tier dựa vào field NumberOfCompartment

  "tierId": "lấy từ id của mỗi tier tương ứng ở bước [2]",
  "compartmentCode": "int - là số tự tăng, bắt đầu từ 1",

  Lưu ý:

• Số lượng compartment được tạo cho mỗi Tier, dựa vào field NumberOfCompartment của mỗi Tier.