Mẫu prompt tạo tài liệu code nguồn

Tạo tài liệu toàn diện cho: [DÁN CODE HOẶC HÀM] Bao gồm: - Mô tả hàm/lớp - Tài liệu tham số - Tài liệu giá trị trả về - Ví dụ sử dụng - Các trường hợp ngoại lệ và xử lý lỗi - Độ phức tạp về thời gian/không gian Định dạng: [JSDoc / Docstring / Chú thích XML]

Tạo tài liệu toàn diện cho: # services/order_service.py from typing import List from myapp.models import Order, OrderItem, Product class OrderService: """ Service xử lý logic liên quan đến đơn hàng """ def create_order(self, user, items: List[dict]) -> Order: """ Tạo đơn hàng mới :param user: User object :param items: List dict gồm product_id và quantity :return: Order """ order = Order.objects.create(user=user, status="PENDING") total_price = 0 for item in items: product = Product.objects.get(id=item["product_id"]) if product.stock < item["quantity"]: raise ValueError("Not enough stock") product.stock -= item["quantity"] product.save() OrderItem.objects.create( order=order, product=product, quantity=item["quantity"], price=product.price ) total_price += product.price * item["quantity"] order.total_price = total_price order.save() return order Bao gồm: - Mô tả hàm/lớp - Tài liệu tham số - Tài liệu giá trị trả về - Ví dụ sử dụng - Các trường hợp ngoại lệ và xử lý lỗi - Độ phức tạp về thời gian/không gian Định dạng: Chú thích XML