feat: added fields into shipment and support external order system

shipment/models.py

@@ -3,6 +3,7 @@ from typing import TYPE_CHECKING
 
 from django.db import models
 from django.contrib.auth import get_user_model
+from django.utils import timezone
 from flower.common import ModelBase
 from basic_info import models as basic_models
 
@@ -20,12 +21,88 @@ class UnitChoices(models.IntegerChoices):
     UNIT = 4, '个'
 
 
+class ShipmentStatus(models.IntegerChoices):
+    """出货单状态"""
+    PENDING_DELIVERY = 1, '待送货'
+    DELIVERED = 2, '已交付'
+    CANCELLED = 3, '已取消'
+
+
+class ExternalFinishedProduct(ModelBase):
+    """
+    外部成品表
+    
+    用于兼容外部遗留系统的数据映射（可被多个出货单引用）。
+    """
+    style_name = models.CharField(
+        max_length=200,
+        verbose_name='款式名称',
+    )
+    num_of_rolls = models.PositiveIntegerField(
+        verbose_name='卷数',
+    )
+    created_by = models.ForeignKey(
+        User,
+        on_delete=models.SET_NULL,
+        null=True,
+        related_name='created_external_finished_products',
+        verbose_name='创建人',
+    )
+    shipment = models.ForeignKey(
+        'Shipment',
+        on_delete=models.CASCADE,
+        null=True,
+        blank=True,
+        related_name='external_finished_products',
+        verbose_name='出货单',
+        help_text='关联的出货单（可空，兼容历史数据/逐步迁移）',
+    )
+
+    class Meta:
+        db_table = 'external_finished_product'
+        verbose_name = '外部成品表'
+        verbose_name_plural = '外部成品表'
+        ordering = ['-created_at']
+
+    def __str__(self) -> str:
+        return f'{self.style_name} ({self.num_of_rolls}卷)'
+
+
 class Shipment(ModelBase):
     """
     出货单
     
     记录一次出货操作，包含多个销售品。
     """
+    status = models.IntegerField(
+        choices=ShipmentStatus.choices,
+        default=ShipmentStatus.PENDING_DELIVERY,
+        verbose_name='状态',
+    )
+
+    cancelled_at = models.DateTimeField(
+        null=True,
+        blank=True,
+        verbose_name='取消时间',
+    )
+
+    cancelled_by = models.ForeignKey(
+        User,
+        on_delete=models.SET_NULL,
+        null=True,
+        blank=True,
+        related_name='cancelled_shipments',
+        verbose_name='取消人',
+    )
+
+    external_id = models.CharField(
+        max_length=120,
+        null=True,
+        blank=True,
+        verbose_name='外部订单号',
+        help_text='用于兼容外部遗留系统的订单号（可空）',
+    )
+
     customer = models.ForeignKey(
         basic_models.Customer,
         on_delete=models.PROTECT,
@@ -61,6 +138,18 @@ class Shipment(ModelBase):
     def __str__(self):
         return f'出货单 #{self.id} - {self.customer.name}'
 
+    def cancel(self, operator: User | None) -> None:
+        """
+        取消出货单（记录取消时间与操作者）
+        
+        Args:
+            operator: 操作者（通常为 request.user，可为空）
+        """
+        self.status = ShipmentStatus.CANCELLED
+        self.cancelled_at = timezone.now()
+        self.cancelled_by = operator
+        self.save(update_fields=['status', 'cancelled_at', 'cancelled_by', 'updated_at'])
+
 
 class SalesItem(ModelBase):
     """