feat: added pre sales order and pre purchase order models and crud

2026-01-31 23:26:01 +08:00
parent a093174913
commit f643b643b7
12 changed files with 1008 additions and 24 deletions
--- a/business/models.py
+++ b/business/models.py
@@ -3,6 +3,7 @@ from __future__ import annotations
 from decimal import Decimal
 from typing import List
 from django.db import models
+from django.conf import settings
 from django.core.exceptions import ValidationError
 from flower.common import ModelBase
 from basic_info import models as basic_info_models
@@ -386,12 +387,20 @@ class PreSalesOrder(ModelBase):
        verbose_name='客户',
    )
    created_by = models.ForeignKey(
-        basic_info_models.Employee,
-        on_delete=models.PROTECT,
-        related_name='created_pre_sales_orders',
+        settings.AUTH_USER_MODEL,
+        on_delete=models.SET_NULL,
        null=True,
        blank=True,
-        verbose_name='创建者',
+        related_name='created_pre_sales_orders',
+        verbose_name='创建者用户',
+    )
+    operator = models.ForeignKey(
+        basic_info_models.Employee,
+        on_delete=models.PROTECT,
+        related_name='operated_pre_sales_orders',
+        null=True,
+        blank=True,
+        verbose_name='经办人',
    )
    warehouse = models.ForeignKey(
        basic_info_models.WareHouse,
@@ -422,9 +431,9 @@ class PreSalesOrder(ModelBase):
            if self.warehouse.merchant_id != self.merchant_id:
                errors['warehouse'] = '仓库所属商户与预销售单所属商户不一致'

-        if getattr(self, 'created_by_id', None) and getattr(self, 'merchant_id', None):
-            if self.created_by.merchant_id != self.merchant_id:
-                errors['created_by'] = '创建者所属商户与预销售单所属商户不一致'
+        if getattr(self, 'operator_id', None) and getattr(self, 'merchant_id', None):
+            if self.operator.merchant_id != self.merchant_id:
+                errors['operator'] = '经办人所属商户与预销售单所属商户不一致'

        if errors:
            raise ValidationError(errors)
@@ -442,9 +451,15 @@ class PreSalesOrder(ModelBase):
        return ''

    @property
-    def created_by_name(self) -> str:
+    def created_by_username(self) -> str:
        if getattr(self, 'created_by_id', None):
-            return self.created_by.name
+            return getattr(self.created_by, 'username', '') or ''
+        return ''
+
+    @property
+    def operator_name(self) -> str:
+        if getattr(self, 'operator_id', None):
+            return self.operator.name
        return ''

    @property
@@ -501,6 +516,160 @@ class PreSalesOrderItem(ModelBase):
        verbose_name_plural = '预销售单明细'


+class PrePurchaseOrder(ModelBase):
+    """预采购单
+
+    预采购单用于在向供应商下达正式采购单之前，用于沟通与确认货品、数量、仓库等信息。
+
+    当前阶段：仅定义 PrePurchaseOrder 与 PrePurchaseOrderItem 的一对多关系，
+    并关联 supplier / warehouse / created_by。
+    """
+
+    id = models.BigAutoField(primary_key=True)
+
+    merchant = models.ForeignKey(
+        basic_info_models.Merchant,
+        on_delete=models.PROTECT,
+        related_name='pre_purchase_orders',
+        verbose_name='所属商户',
+    )
+    supplier = models.ForeignKey(
+        basic_info_models.Supplier,
+        on_delete=models.PROTECT,
+        related_name='pre_purchase_orders',
+        verbose_name='供应商',
+    )
+    created_by = models.ForeignKey(
+        settings.AUTH_USER_MODEL,
+        on_delete=models.SET_NULL,
+        null=True,
+        blank=True,
+        related_name='created_pre_purchase_orders',
+        verbose_name='创建者用户',
+    )
+    operator = models.ForeignKey(
+        basic_info_models.Employee,
+        on_delete=models.PROTECT,
+        related_name='operated_pre_purchase_orders',
+        null=True,
+        blank=True,
+        verbose_name='经办人',
+    )
+    warehouse = models.ForeignKey(
+        basic_info_models.WareHouse,
+        on_delete=models.PROTECT,
+        related_name='pre_purchase_orders',
+        verbose_name='仓库',
+    )
+    kind = models.IntegerField(
+        choices=PurchaseOrderKindEnum.choices,
+        default=PurchaseOrderKindEnum.WHOLESALE,
+        verbose_name='预采购单类型',
+    )
+    remarks = models.TextField(blank=True, null=True, verbose_name='备注')
+
+    def __str__(self):
+        return f'预采购单 {self.human_id or self.id}'
+
+    def clean(self):
+        super().clean()
+
+        errors = {}
+
+        if getattr(self, 'merchant_id', None) and getattr(self, 'supplier_id', None):
+            if self.supplier.merchant_id != self.merchant_id:
+                errors['supplier'] = '供应商所属商户与预采购单所属商户不一致'
+
+        if getattr(self, 'merchant_id', None) and getattr(self, 'warehouse_id', None):
+            if self.warehouse.merchant_id != self.merchant_id:
+                errors['warehouse'] = '仓库所属商户与预采购单所属商户不一致'
+
+        if getattr(self, 'operator_id', None) and getattr(self, 'merchant_id', None):
+            if self.operator.merchant_id != self.merchant_id:
+                errors['operator'] = '经办人所属商户与预采购单所属商户不一致'
+
+        if errors:
+            raise ValidationError(errors)
+
+    @property
+    def supplier_name(self) -> str:
+        if getattr(self, 'supplier_id', None):
+            return self.supplier.name
+        return ''
+
+    @property
+    def merchant_name(self) -> str:
+        if getattr(self, 'merchant_id', None):
+            return self.merchant.name
+        return ''
+
+    @property
+    def created_by_username(self) -> str:
+        if getattr(self, 'created_by_id', None):
+            return getattr(self.created_by, 'username', '') or ''
+        return ''
+
+    @property
+    def operator_name(self) -> str:
+        if getattr(self, 'operator_id', None):
+            return self.operator.name
+        return ''
+
+    @property
+    def warehouse_name(self) -> str:
+        if getattr(self, 'warehouse_id', None):
+            return self.warehouse.name
+        return ''
+
+    @property
+    def human_id(self) -> str:
+        """人类可读编号（虚拟编号，不落库）。
+
+        规则：YC + YYYYMMDD{6位id}
+        """
+
+        if self.id is None or self.created_at is None:
+            return ''
+        return f"YC{self.created_at.year}{self.created_at.month:02d}{self.created_at.day:02d}{self.id:06d}"
+
+    class Meta:
+        verbose_name = '预采购单'
+        verbose_name_plural = '预采购单'
+
+
+class PrePurchaseOrderItem(ModelBase):
+    """预采购单明细"""
+
+    id = models.BigAutoField(primary_key=True)
+    pre_purchase_order = models.ForeignKey(
+        PrePurchaseOrder,
+        on_delete=models.CASCADE,
+        related_name='items',
+        verbose_name='预采购单',
+    )
+
+    # 暂不与 Product 建立外键，先用弱关联字段承载。
+    product_id = models.BigIntegerField(null=True, blank=True, verbose_name='产品ID')
+    product_name = models.CharField(max_length=100, blank=True, default='', verbose_name='产品名称')
+
+    color = models.CharField(max_length=50, null=True, blank=True, verbose_name='颜色')
+    quantity = models.DecimalField(max_digits=10, decimal_places=2, null=True, blank=True, verbose_name='数量')
+    unit = models.CharField(max_length=50, blank=True, default='', verbose_name='单位')
+    spec = models.CharField(max_length=100, null=True, blank=True, verbose_name='规格')
+    quantity_of_rolls = models.TextField(
+        null=True,
+        blank=True,
+        verbose_name='各条数数量',
+    )
+    num_of_rolls = models.PositiveIntegerField(default=1, verbose_name='条数')
+    order_quantity = models.IntegerField(null=True, blank=True, verbose_name='下单数量')
+    remarks = models.TextField(blank=True, null=True, verbose_name='备注')
+
+    class Meta:
+        verbose_name = '预采购单明细'
+        verbose_name_plural = '预采购单明细'
+
+
 class PurchaseReturnStatusEnum(models.IntegerChoices):
    PENDING = 1, '审批中'
    APPROVED = 2, '审批通过'