Mô hình Pydantic Lồng nhau & Tính toán Tổng Hóa đơn (Nested Pydantic Models & Order Calculation)

Mục tiêu kiến thức

• Khai báo cấu trúc dữ liệu phân cấp (Hierarchical / Nested Schemas) trong Pydantic.
• Xác thực danh sách phần tử con không rỗng (min_length=1) và tính toán hóa đơn.

Mô tả bài toán

Hãy xây dựng:

• OrderItem(BaseModel):
• item_name: str (min_length=1)
• quantity: int (gt=0)
• unit_price: float (gt=0.0)
• OrderCreate(BaseModel):
• order_id: str
• items: list[OrderItem] (yêu cầu ít nhất 1 item, min_length=1)
• discount_pct: float (ge=0.0, le=100.0, mặc định 0.0)
• Viết hàm create_order_billing_app() -> FastAPI:

Endpoint POST /orders/calculate nhận body là OrderCreate. Tính toán:

• subtotal = sum(item.quantity * item.unit_price for item in order.items)
• discount_amount = subtotal * (order.discount_pct / 100.0)
• total = subtotal - discount_amount

Trả về:

   {
       "order_id": order.order_id,
       "subtotal": round(subtotal, 2),
       "discount_amount": round(discount_amount, 2),
       "total": round(total, 2)
   }

Ràng buộc

• Thời gian chạy tối đa: 1000ms.
• Giới hạn bộ nhớ: 256MB.
• Dữ liệu đầu vào tuân thủ đúng kiểu dữ liệu và miền giá trị được mô tả.