forked from erp-dev/erp
1753 lines
64 KiB
Python
1753 lines
64 KiB
Python
"""
|
||
Shipment API 测试
|
||
"""
|
||
|
||
from decimal import Decimal
|
||
|
||
from django.test import TestCase
|
||
from django.conf import settings
|
||
from rest_framework.test import APIClient, APITestCase
|
||
from rest_framework import status
|
||
from django.contrib.auth import get_user_model
|
||
|
||
from basic_info import models as basic_models
|
||
from printing import models as printing_models
|
||
from shipment import models as shipment_models
|
||
from stateflow import models as stateflow_models
|
||
|
||
User = get_user_model()
|
||
|
||
|
||
class SalesItemByPrintingOrderAPITestCase(TestCase):
|
||
"""测试通过生产订单查询销售品 API"""
|
||
|
||
def setUp(self):
|
||
self.client = APIClient()
|
||
|
||
# 创建商户
|
||
self.merchant = basic_models.Merchant.objects.create(
|
||
name="测试印花厂", type=basic_models.MerchantTypeEnum.FACTORY
|
||
)
|
||
|
||
# 创建用户
|
||
self.user = User.objects.create_user(
|
||
username="testuser", password="testpass123", email="test@example.com"
|
||
)
|
||
|
||
# 创建员工并关联商户
|
||
self.employee = basic_models.Employee.objects.create(
|
||
sys_user=self.user,
|
||
merchant=self.merchant,
|
||
name="测试员工",
|
||
mobile="13800138000",
|
||
status=basic_models.EmployeeStatusEnum.ACTIVE,
|
||
)
|
||
|
||
# 创建客户
|
||
self.customer = basic_models.Customer.objects.create(
|
||
merchant=self.merchant,
|
||
name="测试客户",
|
||
mobile="13900139000",
|
||
area="测试地区",
|
||
)
|
||
|
||
# 创建流程
|
||
self.state1 = stateflow_models.State.objects.create(name="待印染")
|
||
self.state2 = stateflow_models.State.objects.create(name="印染中")
|
||
self.state3 = stateflow_models.State.objects.create(name="已完成")
|
||
|
||
self.process = stateflow_models.Process.objects.create(name="印染流程")
|
||
self.process.replace_nodes([self.state1, self.state2, self.state3])
|
||
|
||
# 创建产品分类
|
||
self.category = basic_models.ProductCategory.objects.create(
|
||
merchant=self.merchant,
|
||
name="测试分类",
|
||
)
|
||
|
||
# 创建产品
|
||
self.product = basic_models.Product.objects.create(
|
||
merchant=self.merchant,
|
||
category=self.category,
|
||
name="测试产品",
|
||
human_id="TEST001",
|
||
)
|
||
|
||
# 创建印染订单
|
||
self.printing_order = printing_models.PrintingOrder.objects.create(
|
||
merchant=self.merchant,
|
||
customer=self.customer,
|
||
fabric="测试面料",
|
||
width="150cm",
|
||
process=self.process,
|
||
created_by=self.user,
|
||
external_order_id="EXT-PO-001",
|
||
)
|
||
|
||
# 创建印染任务
|
||
self.printing_job1 = printing_models.PrintingJob.objects.create(
|
||
merchant=self.merchant,
|
||
printing_order=self.printing_order,
|
||
product=self.product,
|
||
quantity=100,
|
||
unit="米",
|
||
created_by=self.user,
|
||
)
|
||
|
||
self.printing_job2 = printing_models.PrintingJob.objects.create(
|
||
merchant=self.merchant,
|
||
printing_order=self.printing_order,
|
||
product=self.product,
|
||
quantity=200,
|
||
unit="米",
|
||
created_by=self.user,
|
||
)
|
||
|
||
# 创建出货单
|
||
self.shipment = shipment_models.Shipment.objects.create(
|
||
merchant=self.merchant,
|
||
customer=self.customer,
|
||
shipment_date="2026-01-14",
|
||
created_by=self.user,
|
||
)
|
||
|
||
# 创建销售品 - 未关联出货单
|
||
self.sales_item1 = shipment_models.SalesItem.objects.create(
|
||
merchant=self.merchant,
|
||
name="销售品1",
|
||
quantity=Decimal("50.00"),
|
||
unit=shipment_models.UnitChoices.METER,
|
||
printing_job_id=self.printing_job1.id,
|
||
created_by=self.user,
|
||
)
|
||
|
||
self.sales_item2 = shipment_models.SalesItem.objects.create(
|
||
merchant=self.merchant,
|
||
name="销售品2",
|
||
quantity=Decimal("30.00"),
|
||
unit=shipment_models.UnitChoices.METER,
|
||
printing_job_id=self.printing_job1.id,
|
||
position="A1-01",
|
||
remark="备注信息",
|
||
created_by=self.user,
|
||
)
|
||
|
||
# 创建销售品 - 已关联出货单
|
||
self.sales_item3 = shipment_models.SalesItem.objects.create(
|
||
merchant=self.merchant,
|
||
name="销售品3（已出货）",
|
||
quantity=Decimal("100.00"),
|
||
unit=shipment_models.UnitChoices.METER,
|
||
printing_job_id=self.printing_job2.id,
|
||
shipment=self.shipment,
|
||
created_by=self.user,
|
||
)
|
||
|
||
# 创建与该订单无关的销售品
|
||
self.sales_item_other = shipment_models.SalesItem.objects.create(
|
||
merchant=self.merchant,
|
||
name="其它销售品",
|
||
quantity=Decimal("999.00"),
|
||
unit=shipment_models.UnitChoices.PIECE,
|
||
printing_job_id=99999, # 不存在的 job
|
||
created_by=self.user,
|
||
)
|
||
|
||
# 认证用户
|
||
self.client.force_authenticate(user=self.user)
|
||
|
||
def test_get_sales_items_by_printing_order_exclude_shipped(self):
|
||
"""测试查询销售品 - 默认不包含已出货的"""
|
||
url = (
|
||
f"/api/v1/shipment/sales-items/by-printing-order/{self.printing_order.id}/"
|
||
)
|
||
response = self.client.get(url)
|
||
|
||
self.assertEqual(response.status_code, status.HTTP_200_OK)
|
||
data = response.json()
|
||
|
||
# 应该只返回2个未出货的销售品
|
||
self.assertEqual(data["count"], 2)
|
||
|
||
# 检查返回的销售品
|
||
item_ids = [item["id"] for item in data["results"]]
|
||
self.assertIn(self.sales_item1.id, item_ids)
|
||
self.assertIn(self.sales_item2.id, item_ids)
|
||
self.assertNotIn(self.sales_item3.id, item_ids) # 已出货的不应该在列表中
|
||
self.assertNotIn(self.sales_item_other.id, item_ids) # 其它订单的也不在
|
||
|
||
def test_get_sales_items_by_printing_order_include_shipped(self):
|
||
"""测试查询销售品 - 包含已出货的"""
|
||
url = f"/api/v1/shipment/sales-items/by-printing-order/{self.printing_order.id}/?include_already_has_shipment=true"
|
||
response = self.client.get(url)
|
||
|
||
self.assertEqual(response.status_code, status.HTTP_200_OK)
|
||
data = response.json()
|
||
|
||
# 应该返回3个销售品（包含已出货的）
|
||
self.assertEqual(data["count"], 3)
|
||
|
||
# 检查返回的销售品
|
||
item_ids = [item["id"] for item in data["results"]]
|
||
self.assertIn(self.sales_item1.id, item_ids)
|
||
self.assertIn(self.sales_item2.id, item_ids)
|
||
self.assertIn(self.sales_item3.id, item_ids) # 已出货的也应该在列表中
|
||
self.assertNotIn(self.sales_item_other.id, item_ids) # 其它订单的依然不在
|
||
|
||
def test_get_sales_items_response_format(self):
|
||
"""测试返回数据格式"""
|
||
url = (
|
||
f"/api/v1/shipment/sales-items/by-printing-order/{self.printing_order.id}/"
|
||
)
|
||
response = self.client.get(url)
|
||
|
||
self.assertEqual(response.status_code, status.HTTP_200_OK)
|
||
data = response.json()
|
||
|
||
# 找到 sales_item2（包含 position 和 remark）
|
||
item = next(
|
||
item for item in data["results"] if item["id"] == self.sales_item2.id
|
||
)
|
||
|
||
# 检查所有字段
|
||
self.assertEqual(item["name"], "销售品2")
|
||
self.assertEqual(Decimal(item["quantity"]), Decimal("30.00"))
|
||
self.assertEqual(item["unit"], shipment_models.UnitChoices.METER)
|
||
self.assertEqual(item["unit_display"], "米")
|
||
self.assertEqual(item["position"], "A1-01")
|
||
self.assertEqual(item["remark"], "备注信息")
|
||
self.assertEqual(item["printing_job_id"], self.printing_job1.id)
|
||
self.assertEqual(item["printing_order_id"], self.printing_order.id)
|
||
self.assertEqual(item["external_order_id"], "EXT-PO-001")
|
||
self.assertIsNone(item["shipment_id"])
|
||
self.assertIsNone(item["shipment_date"])
|
||
self.assertIsNotNone(item["created_at"])
|
||
self.assertEqual(item["created_by_id"], self.user.id)
|
||
|
||
def test_get_sales_items_shipped_item_format(self):
|
||
"""测试已出货的销售品返回格式"""
|
||
url = f"/api/v1/shipment/sales-items/by-printing-order/{self.printing_order.id}/?include_already_has_shipment=true"
|
||
response = self.client.get(url)
|
||
|
||
self.assertEqual(response.status_code, status.HTTP_200_OK)
|
||
data = response.json()
|
||
|
||
# 找到已出货的销售品
|
||
item = next(
|
||
item for item in data["results"] if item["id"] == self.sales_item3.id
|
||
)
|
||
|
||
# 检查出货单信息
|
||
self.assertEqual(item["shipment_id"], self.shipment.id)
|
||
self.assertEqual(item["shipment_date"], "2026-01-14")
|
||
|
||
def test_get_sales_items_by_external_order_id(self):
|
||
"""测试通过 external_order_id 查询销售品"""
|
||
url = "/api/v1/shipment/sales-items/by-printing-order/EXT-PO-001/"
|
||
response = self.client.get(url)
|
||
|
||
self.assertEqual(response.status_code, status.HTTP_200_OK)
|
||
data = response.json()
|
||
|
||
self.assertEqual(data["count"], 2)
|
||
item_ids = [item["id"] for item in data["results"]]
|
||
self.assertIn(self.sales_item1.id, item_ids)
|
||
self.assertIn(self.sales_item2.id, item_ids)
|
||
self.assertNotIn(self.sales_item3.id, item_ids)
|
||
|
||
def test_get_sales_items_by_external_order_id_multiple_matches(self):
|
||
"""测试 external_order_id 匹配多个生产订单时报错"""
|
||
other_order = printing_models.PrintingOrder.objects.create(
|
||
merchant=self.merchant,
|
||
customer=self.customer,
|
||
fabric="测试面料3",
|
||
width="160cm",
|
||
process=self.process,
|
||
created_by=self.user,
|
||
external_order_id="EXT-DUPLICATED",
|
||
)
|
||
printing_models.PrintingOrder.objects.create(
|
||
merchant=self.merchant,
|
||
customer=self.customer,
|
||
fabric="测试面料4",
|
||
width="170cm",
|
||
process=self.process,
|
||
created_by=self.user,
|
||
external_order_id="EXT-DUPLICATED",
|
||
)
|
||
printing_models.PrintingJob.objects.create(
|
||
merchant=self.merchant,
|
||
printing_order=other_order,
|
||
product=self.product,
|
||
quantity=50,
|
||
unit="米",
|
||
created_by=self.user,
|
||
)
|
||
|
||
response = self.client.get(
|
||
"/api/v1/shipment/sales-items/by-printing-order/EXT-DUPLICATED/"
|
||
)
|
||
|
||
self.assertEqual(response.status_code, status.HTTP_400_BAD_REQUEST)
|
||
self.assertIn("匹配到多个生产订单", response.json()["detail"])
|
||
|
||
def test_get_sales_items_printing_order_not_found(self):
|
||
"""测试生产订单不存在"""
|
||
url = "/api/v1/shipment/sales-items/by-printing-order/99999/"
|
||
response = self.client.get(url)
|
||
|
||
self.assertEqual(response.status_code, status.HTTP_404_NOT_FOUND)
|
||
self.assertIn("不存在", response.json()["detail"])
|
||
|
||
def test_get_sales_items_empty_result(self):
|
||
"""测试生产订单没有关联销售品"""
|
||
# 创建一个没有销售品的订单
|
||
empty_order = printing_models.PrintingOrder.objects.create(
|
||
merchant=self.merchant,
|
||
customer=self.customer,
|
||
fabric="测试面料2",
|
||
width="150cm",
|
||
process=self.process,
|
||
created_by=self.user,
|
||
)
|
||
|
||
url = f"/api/v1/shipment/sales-items/by-printing-order/{empty_order.id}/"
|
||
response = self.client.get(url)
|
||
|
||
self.assertEqual(response.status_code, status.HTTP_200_OK)
|
||
data = response.json()
|
||
|
||
self.assertEqual(data["count"], 0)
|
||
self.assertEqual(data["results"], [])
|
||
|
||
def test_get_sales_items_unauthenticated(self):
|
||
"""测试未认证用户"""
|
||
self.client.logout()
|
||
|
||
url = (
|
||
f"/api/v1/shipment/sales-items/by-printing-order/{self.printing_order.id}/"
|
||
)
|
||
response = self.client.get(url)
|
||
|
||
self.assertEqual(response.status_code, status.HTTP_401_UNAUTHORIZED)
|
||
|
||
|
||
class ShipmentSalesItemCustomersAPITestCase(TestCase):
|
||
"""测试由未出货销售品汇总客户 API"""
|
||
|
||
def setUp(self):
|
||
self.client = APIClient()
|
||
|
||
self.merchant = basic_models.Merchant.objects.create(
|
||
name="测试印花厂", type=basic_models.MerchantTypeEnum.FACTORY
|
||
)
|
||
self.other_merchant = basic_models.Merchant.objects.create(
|
||
name="其它商户", type=basic_models.MerchantTypeEnum.FACTORY
|
||
)
|
||
|
||
self.user = User.objects.create_user(
|
||
username="shipment_customer_user",
|
||
password="testpass123",
|
||
email="shipment_customer@example.com",
|
||
)
|
||
self.employee = basic_models.Employee.objects.create(
|
||
sys_user=self.user,
|
||
merchant=self.merchant,
|
||
name="测试员工",
|
||
mobile="13800138020",
|
||
status=basic_models.EmployeeStatusEnum.ACTIVE,
|
||
)
|
||
|
||
self.customer1 = basic_models.Customer.objects.create(
|
||
merchant=self.merchant,
|
||
name="客户A",
|
||
mobile="13900139020",
|
||
area="杭州",
|
||
)
|
||
self.customer2 = basic_models.Customer.objects.create(
|
||
merchant=self.merchant,
|
||
name="客户B",
|
||
mobile="13900139021",
|
||
area="绍兴",
|
||
)
|
||
self.other_customer = basic_models.Customer.objects.create(
|
||
merchant=self.other_merchant,
|
||
name="客户C",
|
||
mobile="13900139022",
|
||
area="苏州",
|
||
)
|
||
|
||
shipment_models.SalesItem.objects.create(
|
||
merchant=self.merchant,
|
||
name="客户A销售品1",
|
||
quantity=Decimal("10.00"),
|
||
unit=shipment_models.UnitChoices.METER,
|
||
customer_id=self.customer1.id,
|
||
created_by=self.user,
|
||
)
|
||
shipment_models.SalesItem.objects.create(
|
||
merchant=self.merchant,
|
||
name="客户A销售品2",
|
||
quantity=Decimal("20.00"),
|
||
unit=shipment_models.UnitChoices.METER,
|
||
customer_id=self.customer1.id,
|
||
created_by=self.user,
|
||
)
|
||
shipment_models.SalesItem.objects.create(
|
||
merchant=self.merchant,
|
||
name="客户B销售品1",
|
||
quantity=Decimal("30.00"),
|
||
unit=shipment_models.UnitChoices.METER,
|
||
customer_id=self.customer2.id,
|
||
created_by=self.user,
|
||
)
|
||
|
||
shipped = shipment_models.Shipment.objects.create(
|
||
merchant=self.merchant,
|
||
customer=self.customer1,
|
||
shipment_date="2026-01-14",
|
||
created_by=self.user,
|
||
)
|
||
shipment_models.SalesItem.objects.create(
|
||
merchant=self.merchant,
|
||
name="客户A已出货销售品",
|
||
quantity=Decimal("40.00"),
|
||
unit=shipment_models.UnitChoices.METER,
|
||
customer_id=self.customer1.id,
|
||
shipment=shipped,
|
||
created_by=self.user,
|
||
)
|
||
shipment_models.SalesItem.objects.create(
|
||
merchant=self.merchant,
|
||
name="无客户销售品",
|
||
quantity=Decimal("50.00"),
|
||
unit=shipment_models.UnitChoices.METER,
|
||
created_by=self.user,
|
||
)
|
||
shipment_models.SalesItem.objects.create(
|
||
merchant=self.other_merchant,
|
||
name="其它商户销售品",
|
||
quantity=Decimal("60.00"),
|
||
unit=shipment_models.UnitChoices.METER,
|
||
customer_id=self.other_customer.id,
|
||
created_by=self.user,
|
||
)
|
||
|
||
self.client.force_authenticate(user=self.user)
|
||
|
||
def test_list_customers_with_unshipped_sales_items(self):
|
||
resp = self.client.get("/api/v1/shipment/sales-items/customers/")
|
||
|
||
self.assertEqual(resp.status_code, status.HTTP_200_OK)
|
||
data = resp.json()
|
||
|
||
self.assertEqual(data["count"], 2)
|
||
self.assertIn("next", data)
|
||
self.assertIn("previous", data)
|
||
|
||
by_customer_id = {
|
||
item["customer_id"]: item
|
||
for item in data["results"]
|
||
}
|
||
self.assertEqual(set(by_customer_id.keys()), {self.customer1.id, self.customer2.id})
|
||
self.assertEqual(by_customer_id[self.customer1.id]["customer_name"], "客户A")
|
||
self.assertEqual(by_customer_id[self.customer1.id]["unshipped_sales_items_count"], 2)
|
||
self.assertEqual(by_customer_id[self.customer2.id]["unshipped_sales_items_count"], 1)
|
||
|
||
def test_list_customers_with_unshipped_sales_items_supports_limit_offset(self):
|
||
resp = self.client.get("/api/v1/shipment/sales-items/customers/?limit=1&offset=1")
|
||
|
||
self.assertEqual(resp.status_code, status.HTTP_200_OK)
|
||
data = resp.json()
|
||
|
||
self.assertEqual(data["count"], 2)
|
||
self.assertEqual(len(data["results"]), 1)
|
||
self.assertEqual(data["results"][0]["customer_id"], self.customer2.id)
|
||
|
||
def test_list_customers_with_unshipped_sales_items_unauthenticated(self):
|
||
self.client.logout()
|
||
|
||
resp = self.client.get("/api/v1/shipment/sales-items/customers/")
|
||
|
||
self.assertEqual(resp.status_code, status.HTTP_401_UNAUTHORIZED)
|
||
|
||
|
||
class SalesItemByCustomerAPITestCase(TestCase):
|
||
"""测试按客户查询销售品 API"""
|
||
|
||
def setUp(self):
|
||
self.client = APIClient()
|
||
|
||
self.merchant = basic_models.Merchant.objects.create(
|
||
name="测试印花厂", type=basic_models.MerchantTypeEnum.FACTORY
|
||
)
|
||
self.other_merchant = basic_models.Merchant.objects.create(
|
||
name="其它印花厂", type=basic_models.MerchantTypeEnum.FACTORY
|
||
)
|
||
|
||
self.user = User.objects.create_user(
|
||
username="sales_item_by_customer_user",
|
||
password="testpass123",
|
||
email="sales_item_by_customer@example.com",
|
||
)
|
||
self.employee = basic_models.Employee.objects.create(
|
||
sys_user=self.user,
|
||
merchant=self.merchant,
|
||
name="测试员工",
|
||
mobile="13800138030",
|
||
status=basic_models.EmployeeStatusEnum.ACTIVE,
|
||
)
|
||
|
||
self.customer = basic_models.Customer.objects.create(
|
||
merchant=self.merchant,
|
||
name="测试客户",
|
||
mobile="13900139030",
|
||
area="杭州",
|
||
)
|
||
self.other_customer = basic_models.Customer.objects.create(
|
||
merchant=self.merchant,
|
||
name="其它客户",
|
||
mobile="13900139031",
|
||
area="绍兴",
|
||
)
|
||
self.foreign_customer = basic_models.Customer.objects.create(
|
||
merchant=self.other_merchant,
|
||
name="外部客户",
|
||
mobile="13900139032",
|
||
area="苏州",
|
||
)
|
||
|
||
self.state = stateflow_models.State.objects.create(name="待生产")
|
||
self.process = stateflow_models.Process.objects.create(name="生产流程")
|
||
self.process.replace_nodes([self.state])
|
||
self.category = basic_models.ProductCategory.objects.create(
|
||
merchant=self.merchant,
|
||
name="测试分类",
|
||
)
|
||
self.product = basic_models.Product.objects.create(
|
||
merchant=self.merchant,
|
||
category=self.category,
|
||
name="测试产品",
|
||
human_id="PROD001",
|
||
)
|
||
self.printing_order = printing_models.PrintingOrder.objects.create(
|
||
merchant=self.merchant,
|
||
customer=self.customer,
|
||
fabric="测试面料",
|
||
width="150cm",
|
||
process=self.process,
|
||
created_by=self.user,
|
||
external_order_id="EXT-CUST-001",
|
||
)
|
||
self.printing_job = printing_models.PrintingJob.objects.create(
|
||
merchant=self.merchant,
|
||
printing_order=self.printing_order,
|
||
product=self.product,
|
||
quantity=100,
|
||
unit="米",
|
||
created_by=self.user,
|
||
)
|
||
|
||
self.sales_item1 = shipment_models.SalesItem.objects.create(
|
||
merchant=self.merchant,
|
||
name="销售品1",
|
||
quantity=Decimal("10.00"),
|
||
unit=shipment_models.UnitChoices.METER,
|
||
printing_job_id=self.printing_job.id,
|
||
customer_id=self.customer.id,
|
||
position="A1-01",
|
||
created_by=self.user,
|
||
)
|
||
self.sales_item2 = shipment_models.SalesItem.objects.create(
|
||
merchant=self.merchant,
|
||
name="销售品2",
|
||
quantity=Decimal("20.00"),
|
||
unit=shipment_models.UnitChoices.PIECE,
|
||
printing_job_id=self.printing_job.id,
|
||
customer_id=self.customer.id,
|
||
created_by=self.user,
|
||
)
|
||
self.shipment = shipment_models.Shipment.objects.create(
|
||
merchant=self.merchant,
|
||
customer=self.customer,
|
||
shipment_date="2026-01-14",
|
||
created_by=self.user,
|
||
)
|
||
self.sales_item_shipped = shipment_models.SalesItem.objects.create(
|
||
merchant=self.merchant,
|
||
name="已出货销售品",
|
||
quantity=Decimal("30.00"),
|
||
unit=shipment_models.UnitChoices.METER,
|
||
printing_job_id=self.printing_job.id,
|
||
customer_id=self.customer.id,
|
||
shipment=self.shipment,
|
||
created_by=self.user,
|
||
)
|
||
shipment_models.SalesItem.objects.create(
|
||
merchant=self.merchant,
|
||
name="其它客户销售品",
|
||
quantity=Decimal("40.00"),
|
||
unit=shipment_models.UnitChoices.METER,
|
||
customer_id=self.other_customer.id,
|
||
created_by=self.user,
|
||
)
|
||
|
||
self.client.force_authenticate(user=self.user)
|
||
|
||
def test_get_sales_items_by_customer_exclude_shipped(self):
|
||
resp = self.client.get(
|
||
f"/api/v1/shipment/sales-items/by-customer/{self.customer.id}/"
|
||
)
|
||
|
||
self.assertEqual(resp.status_code, status.HTTP_200_OK)
|
||
data = resp.json()
|
||
|
||
self.assertEqual(data["count"], 2)
|
||
self.assertEqual(len(data["results"]), 2)
|
||
item = next(it for it in data["results"] if it["id"] == self.sales_item1.id)
|
||
self.assertEqual(item["customer_id"], self.customer.id)
|
||
self.assertEqual(item["customer_name"], self.customer.name)
|
||
self.assertEqual(item["printing_job_id"], self.printing_job.id)
|
||
self.assertEqual(item["printing_order_id"], self.printing_order.id)
|
||
self.assertEqual(item["external_order_id"], "EXT-CUST-001")
|
||
self.assertEqual(item["position"], "A1-01")
|
||
|
||
def test_get_sales_items_by_customer_include_shipped_and_paginate(self):
|
||
resp = self.client.get(
|
||
f"/api/v1/shipment/sales-items/by-customer/{self.customer.id}/"
|
||
"?include_already_has_shipment=true&limit=2&offset=1"
|
||
)
|
||
|
||
self.assertEqual(resp.status_code, status.HTTP_200_OK)
|
||
data = resp.json()
|
||
|
||
self.assertEqual(data["count"], 3)
|
||
self.assertEqual(len(data["results"]), 2)
|
||
result_ids = [item["id"] for item in data["results"]]
|
||
self.assertEqual(result_ids, [self.sales_item2.id, self.sales_item_shipped.id])
|
||
|
||
def test_get_sales_items_by_customer_supports_external_order_id_filter(self):
|
||
other_printing_order = printing_models.PrintingOrder.objects.create(
|
||
merchant=self.merchant,
|
||
customer=self.customer,
|
||
fabric="其它面料",
|
||
width="160cm",
|
||
process=self.process,
|
||
created_by=self.user,
|
||
external_order_id="EXT-CUST-OTHER",
|
||
)
|
||
other_printing_job = printing_models.PrintingJob.objects.create(
|
||
merchant=self.merchant,
|
||
printing_order=other_printing_order,
|
||
product=self.product,
|
||
quantity=50,
|
||
unit="米",
|
||
created_by=self.user,
|
||
)
|
||
other_sales_item = shipment_models.SalesItem.objects.create(
|
||
merchant=self.merchant,
|
||
name="其它外部订单销售品",
|
||
quantity=Decimal("66.00"),
|
||
unit=shipment_models.UnitChoices.METER,
|
||
printing_job_id=other_printing_job.id,
|
||
customer_id=self.customer.id,
|
||
created_by=self.user,
|
||
)
|
||
|
||
resp = self.client.get(
|
||
f"/api/v1/shipment/sales-items/by-customer/{self.customer.id}/"
|
||
"?external_order_id=EXT-CUST-001"
|
||
)
|
||
|
||
self.assertEqual(resp.status_code, status.HTTP_200_OK)
|
||
data = resp.json()
|
||
result_ids = [item["id"] for item in data["results"]]
|
||
self.assertEqual(set(result_ids), {self.sales_item1.id, self.sales_item2.id})
|
||
self.assertNotIn(other_sales_item.id, result_ids)
|
||
|
||
def test_get_sales_items_by_customer_not_found(self):
|
||
resp = self.client.get("/api/v1/shipment/sales-items/by-customer/99999/")
|
||
|
||
self.assertEqual(resp.status_code, status.HTTP_404_NOT_FOUND)
|
||
|
||
def test_get_sales_items_by_customer_other_merchant_404(self):
|
||
resp = self.client.get(
|
||
f"/api/v1/shipment/sales-items/by-customer/{self.foreign_customer.id}/"
|
||
)
|
||
|
||
self.assertEqual(resp.status_code, status.HTTP_404_NOT_FOUND)
|
||
|
||
|
||
class SalesItemDetailAPITestCase(APITestCase):
|
||
"""销售品详情 API 测试"""
|
||
|
||
def setUp(self):
|
||
self.merchant = basic_models.Merchant.objects.create(
|
||
name="详情测试商户", type=basic_models.MerchantTypeEnum.FACTORY
|
||
)
|
||
self.other_merchant = basic_models.Merchant.objects.create(
|
||
name="其它详情测试商户", type=basic_models.MerchantTypeEnum.FACTORY
|
||
)
|
||
|
||
self.user = User.objects.create_user(
|
||
username="sales_item_detail_user",
|
||
password="testpass123",
|
||
email="sales_item_detail@example.com",
|
||
)
|
||
self.employee = basic_models.Employee.objects.create(
|
||
sys_user=self.user,
|
||
merchant=self.merchant,
|
||
name="详情测试员工",
|
||
mobile="13800138031",
|
||
status=basic_models.EmployeeStatusEnum.ACTIVE,
|
||
)
|
||
|
||
self.other_user = User.objects.create_user(
|
||
username="sales_item_detail_other_user",
|
||
password="testpass123",
|
||
email="sales_item_detail_other@example.com",
|
||
)
|
||
self.other_employee = basic_models.Employee.objects.create(
|
||
sys_user=self.other_user,
|
||
merchant=self.other_merchant,
|
||
name="其它详情测试员工",
|
||
mobile="13800138032",
|
||
status=basic_models.EmployeeStatusEnum.ACTIVE,
|
||
)
|
||
|
||
self.customer = basic_models.Customer.objects.create(
|
||
merchant=self.merchant,
|
||
name="详情测试客户",
|
||
mobile="13900139033",
|
||
area="杭州",
|
||
)
|
||
self.category = basic_models.ProductCategory.objects.create(
|
||
merchant=self.merchant,
|
||
name="详情分类",
|
||
)
|
||
self.product = basic_models.Product.objects.create(
|
||
merchant=self.merchant,
|
||
category=self.category,
|
||
name="详情产品",
|
||
human_id="DETAIL001",
|
||
mdy_image_url="https://example.com/product-image.jpg",
|
||
)
|
||
self.state = stateflow_models.State.objects.create(name="详情状态")
|
||
self.process = stateflow_models.Process.objects.create(name="详情流程")
|
||
self.process.replace_nodes([self.state])
|
||
self.printing_order = printing_models.PrintingOrder.objects.create(
|
||
merchant=self.merchant,
|
||
customer=self.customer,
|
||
fabric="详情面料",
|
||
width="150cm",
|
||
process=self.process,
|
||
created_by=self.user,
|
||
external_order_id="EXT-DETAIL-001",
|
||
)
|
||
self.printing_job = printing_models.PrintingJob.objects.create(
|
||
merchant=self.merchant,
|
||
printing_order=self.printing_order,
|
||
product=self.product,
|
||
quantity=20,
|
||
unit="米",
|
||
created_by=self.user,
|
||
)
|
||
self.sales_item = shipment_models.SalesItem.objects.create(
|
||
merchant=self.merchant,
|
||
name="详情销售品",
|
||
quantity=Decimal("88.00"),
|
||
unit=shipment_models.UnitChoices.METER,
|
||
printing_job_id=self.printing_job.id,
|
||
customer_id=self.customer.id,
|
||
position="B2-03",
|
||
created_by=self.user,
|
||
)
|
||
|
||
self.client.force_authenticate(user=self.user)
|
||
|
||
def test_get_sales_item_detail_success(self):
|
||
resp = self.client.get(f"/api/v1/shipment/sales-items/{self.sales_item.id}/")
|
||
|
||
self.assertEqual(resp.status_code, status.HTTP_200_OK)
|
||
data = resp.json()
|
||
self.assertEqual(data["id"], self.sales_item.id)
|
||
self.assertEqual(data["printing_order_id"], self.printing_order.id)
|
||
self.assertEqual(data["external_order_id"], "EXT-DETAIL-001")
|
||
self.assertEqual(data["customer_name"], self.customer.name)
|
||
self.assertEqual(data["product_image_url"], "https://example.com/product-image.jpg")
|
||
|
||
def test_get_sales_item_detail_other_merchant_404(self):
|
||
self.client.force_authenticate(user=self.other_user)
|
||
|
||
resp = self.client.get(f"/api/v1/shipment/sales-items/{self.sales_item.id}/")
|
||
|
||
self.assertEqual(resp.status_code, status.HTTP_404_NOT_FOUND)
|
||
|
||
|
||
class ShipmentCreateAPITestCase(TestCase):
|
||
"""测试创建出货单 API"""
|
||
|
||
def setUp(self):
|
||
self.client = APIClient()
|
||
|
||
# 创建商户
|
||
self.merchant = basic_models.Merchant.objects.create(
|
||
name="测试印花厂", type=basic_models.MerchantTypeEnum.FACTORY
|
||
)
|
||
|
||
# 创建用户
|
||
self.user = User.objects.create_user(
|
||
username="testuser", password="testpass123", email="test@example.com"
|
||
)
|
||
|
||
# 创建员工并关联商户
|
||
self.employee = basic_models.Employee.objects.create(
|
||
sys_user=self.user,
|
||
merchant=self.merchant,
|
||
name="测试员工",
|
||
mobile="13800138000",
|
||
status=basic_models.EmployeeStatusEnum.ACTIVE,
|
||
)
|
||
|
||
# 创建客户
|
||
self.customer = basic_models.Customer.objects.create(
|
||
merchant=self.merchant,
|
||
name="测试客户",
|
||
mobile="13900139000",
|
||
area="测试地区",
|
||
)
|
||
|
||
self.state1 = stateflow_models.State.objects.create(name="待印染")
|
||
self.state2 = stateflow_models.State.objects.create(name="印染中")
|
||
self.process = stateflow_models.Process.objects.create(name="印染流程")
|
||
self.process.replace_nodes([self.state1, self.state2])
|
||
|
||
self.category = basic_models.ProductCategory.objects.create(
|
||
merchant=self.merchant,
|
||
name="测试分类",
|
||
)
|
||
self.product = basic_models.Product.objects.create(
|
||
merchant=self.merchant,
|
||
category=self.category,
|
||
name="测试产品",
|
||
human_id="SHIPTEST001",
|
||
)
|
||
|
||
self.printing_order = printing_models.PrintingOrder.objects.create(
|
||
merchant=self.merchant,
|
||
customer=self.customer,
|
||
fabric="测试面料",
|
||
width="150cm",
|
||
process=self.process,
|
||
created_by=self.user,
|
||
)
|
||
self.other_printing_order = printing_models.PrintingOrder.objects.create(
|
||
merchant=self.merchant,
|
||
customer=self.customer,
|
||
fabric="测试面料2",
|
||
width="160cm",
|
||
process=self.process,
|
||
created_by=self.user,
|
||
)
|
||
self.printing_job1 = printing_models.PrintingJob.objects.create(
|
||
merchant=self.merchant,
|
||
printing_order=self.printing_order,
|
||
product=self.product,
|
||
quantity=100,
|
||
unit="米",
|
||
created_by=self.user,
|
||
)
|
||
self.printing_job2 = printing_models.PrintingJob.objects.create(
|
||
merchant=self.merchant,
|
||
printing_order=self.printing_order,
|
||
product=self.product,
|
||
quantity=80,
|
||
unit="米",
|
||
created_by=self.user,
|
||
)
|
||
self.printing_job_other = printing_models.PrintingJob.objects.create(
|
||
merchant=self.merchant,
|
||
printing_order=self.other_printing_order,
|
||
product=self.product,
|
||
quantity=60,
|
||
unit="米",
|
||
created_by=self.user,
|
||
)
|
||
|
||
# 创建销售品（未关联出货单）
|
||
self.sales_item1 = shipment_models.SalesItem.objects.create(
|
||
merchant=self.merchant,
|
||
name="销售品1",
|
||
quantity=Decimal("50.00"),
|
||
unit=shipment_models.UnitChoices.METER,
|
||
printing_job_id=self.printing_job1.id,
|
||
created_by=self.user,
|
||
)
|
||
|
||
self.sales_item2 = shipment_models.SalesItem.objects.create(
|
||
merchant=self.merchant,
|
||
name="销售品2",
|
||
quantity=Decimal("30.00"),
|
||
unit=shipment_models.UnitChoices.METER,
|
||
printing_job_id=self.printing_job2.id,
|
||
created_by=self.user,
|
||
)
|
||
|
||
self.sales_item_other_order = shipment_models.SalesItem.objects.create(
|
||
merchant=self.merchant,
|
||
name="销售品4（不同生产单）",
|
||
quantity=Decimal("20.00"),
|
||
unit=shipment_models.UnitChoices.METER,
|
||
printing_job_id=self.printing_job_other.id,
|
||
created_by=self.user,
|
||
)
|
||
|
||
self.sales_item_missing_job = shipment_models.SalesItem.objects.create(
|
||
merchant=self.merchant,
|
||
name="销售品5（缺少生产任务）",
|
||
quantity=Decimal("10.00"),
|
||
unit=shipment_models.UnitChoices.METER,
|
||
created_by=self.user,
|
||
)
|
||
|
||
# 创建已关联出货单的销售品
|
||
self.existing_shipment = shipment_models.Shipment.objects.create(
|
||
merchant=self.merchant,
|
||
customer=self.customer,
|
||
shipment_date="2026-01-13",
|
||
created_by=self.user,
|
||
)
|
||
self.sales_item_shipped = shipment_models.SalesItem.objects.create(
|
||
merchant=self.merchant,
|
||
name="销售品3（已出货）",
|
||
quantity=Decimal("100.00"),
|
||
unit=shipment_models.UnitChoices.METER,
|
||
printing_job_id=self.printing_job1.id,
|
||
shipment=self.existing_shipment,
|
||
created_by=self.user,
|
||
)
|
||
|
||
# 认证用户
|
||
self.client.force_authenticate(user=self.user)
|
||
|
||
def test_create_shipment_success(self):
|
||
"""测试成功创建出货单"""
|
||
data = {
|
||
"customer": self.customer.id,
|
||
"shipment_date": "2026-01-14",
|
||
"area": "华东",
|
||
"remark": "测试备注",
|
||
"sales_items": [self.sales_item1.id, self.sales_item2.id],
|
||
}
|
||
|
||
response = self.client.post("/api/v1/shipment/shipments/", data, format="json")
|
||
|
||
self.assertEqual(response.status_code, status.HTTP_201_CREATED)
|
||
result = response.json()
|
||
|
||
# 验证返回数据
|
||
self.assertIn("id", result)
|
||
self.assertEqual(result["customer"], self.customer.id)
|
||
self.assertEqual(result["customer_name"], self.customer.name)
|
||
self.assertEqual(result["shipment_date"], "2026-01-14")
|
||
self.assertEqual(result.get("area", ""), "华东")
|
||
self.assertEqual(result["remark"], "测试备注")
|
||
self.assertEqual(result["status"], shipment_models.ShipmentStatus.DRAFT)
|
||
self.assertEqual(result["status_display"], "草稿(未发布)")
|
||
self.assertEqual(result["items_count"], 2)
|
||
self.assertEqual(result["created_by_id"], self.user.id)
|
||
|
||
# 验证销售品已关联到出货单
|
||
self.sales_item1.refresh_from_db()
|
||
self.sales_item2.refresh_from_db()
|
||
self.assertEqual(self.sales_item1.shipment_id, result["id"])
|
||
self.assertEqual(self.sales_item2.shipment_id, result["id"])
|
||
|
||
def test_create_shipment_without_sales_items(self):
|
||
"""测试创建出货单但不关联销售品"""
|
||
data = {
|
||
"customer": self.customer.id,
|
||
"shipment_date": "2026-01-14",
|
||
}
|
||
|
||
response = self.client.post("/api/v1/shipment/shipments/", data, format="json")
|
||
|
||
self.assertEqual(response.status_code, status.HTTP_201_CREATED)
|
||
result = response.json()
|
||
self.assertEqual(result["items_count"], 0)
|
||
self.assertEqual(result["status"], shipment_models.ShipmentStatus.DRAFT)
|
||
self.assertEqual(result["status_display"], "草稿(未发布)")
|
||
|
||
def test_create_shipment_customer_not_found(self):
|
||
"""测试客户不存在"""
|
||
data = {
|
||
"customer": 99999,
|
||
"shipment_date": "2026-01-14",
|
||
}
|
||
|
||
response = self.client.post("/api/v1/shipment/shipments/", data, format="json")
|
||
|
||
self.assertEqual(response.status_code, status.HTTP_400_BAD_REQUEST)
|
||
self.assertIn("不存在", response.json()["detail"])
|
||
|
||
def test_create_shipment_sales_item_not_found(self):
|
||
"""测试销售品不存在"""
|
||
data = {
|
||
"customer": self.customer.id,
|
||
"shipment_date": "2026-01-14",
|
||
"sales_items": [99999],
|
||
}
|
||
|
||
response = self.client.post("/api/v1/shipment/shipments/", data, format="json")
|
||
|
||
self.assertEqual(response.status_code, status.HTTP_400_BAD_REQUEST)
|
||
self.assertIn("不存在", response.json()["detail"])
|
||
|
||
def test_create_shipment_sales_item_already_shipped(self):
|
||
"""测试销售品已关联到其他出货单"""
|
||
data = {
|
||
"customer": self.customer.id,
|
||
"shipment_date": "2026-01-14",
|
||
"sales_items": [self.sales_item_shipped.id],
|
||
}
|
||
|
||
response = self.client.post("/api/v1/shipment/shipments/", data, format="json")
|
||
|
||
self.assertEqual(response.status_code, status.HTTP_400_BAD_REQUEST)
|
||
self.assertIn("已关联", response.json()["detail"])
|
||
|
||
def test_create_shipment_rejects_sales_items_from_different_printing_orders(self):
|
||
"""测试销售品来自不同生产订单时拒绝创建"""
|
||
data = {
|
||
"customer": self.customer.id,
|
||
"shipment_date": "2026-01-14",
|
||
"sales_items": [self.sales_item1.id, self.sales_item_other_order.id],
|
||
}
|
||
|
||
response = self.client.post("/api/v1/shipment/shipments/", data, format="json")
|
||
|
||
self.assertEqual(response.status_code, status.HTTP_400_BAD_REQUEST)
|
||
self.assertIn("同一个生产订单", response.json()["detail"])
|
||
|
||
def test_create_shipment_rejects_sales_item_without_printing_job(self):
|
||
"""测试销售品缺少生产任务时拒绝创建"""
|
||
data = {
|
||
"customer": self.customer.id,
|
||
"shipment_date": "2026-01-14",
|
||
"sales_items": [self.sales_item_missing_job.id],
|
||
}
|
||
|
||
response = self.client.post("/api/v1/shipment/shipments/", data, format="json")
|
||
|
||
self.assertEqual(response.status_code, status.HTTP_400_BAD_REQUEST)
|
||
self.assertIn("缺少关联生产任务", response.json()["detail"])
|
||
|
||
def test_create_shipment_unauthenticated(self):
|
||
"""测试未认证用户"""
|
||
self.client.logout()
|
||
|
||
data = {
|
||
"customer": self.customer.id,
|
||
"shipment_date": "2026-01-14",
|
||
}
|
||
|
||
response = self.client.post("/api/v1/shipment/shipments/", data, format="json")
|
||
|
||
self.assertEqual(response.status_code, status.HTTP_401_UNAUTHORIZED)
|
||
|
||
|
||
class ShipmentExternalCreateAPITestCase(TestCase):
|
||
"""测试创建出货单 external 版 API"""
|
||
|
||
def setUp(self):
|
||
self.client = APIClient()
|
||
|
||
# 创建商户
|
||
self.merchant = basic_models.Merchant.objects.create(
|
||
name="测试印花厂", type=basic_models.MerchantTypeEnum.FACTORY
|
||
)
|
||
|
||
# 创建用户
|
||
self.user = User.objects.create_user(
|
||
username="testuser_ext",
|
||
password="testpass123",
|
||
email="test_ext@example.com",
|
||
)
|
||
|
||
# 创建员工并关联商户
|
||
self.employee = basic_models.Employee.objects.create(
|
||
sys_user=self.user,
|
||
merchant=self.merchant,
|
||
name="测试员工Ext",
|
||
mobile="13800138002",
|
||
status=basic_models.EmployeeStatusEnum.ACTIVE,
|
||
)
|
||
|
||
# 创建客户（需要同 merchant）
|
||
self.customer = basic_models.Customer.objects.create(
|
||
merchant=self.merchant,
|
||
name="测试客户Ext",
|
||
mobile="13900139002",
|
||
area="测试地区Ext",
|
||
)
|
||
|
||
# 创建一个销售品（用于验证 external 版不会绑定任何销售品）
|
||
self.sales_item = shipment_models.SalesItem.objects.create(
|
||
merchant=self.merchant,
|
||
name="销售品-不应被绑定",
|
||
quantity=Decimal("10.00"),
|
||
unit=shipment_models.UnitChoices.METER,
|
||
created_by=self.user,
|
||
)
|
||
|
||
self.client.force_authenticate(user=self.user)
|
||
|
||
def test_create_external_shipment_success(self):
|
||
data = {
|
||
"customer": self.customer.id,
|
||
"shipment_date": "2026-01-14",
|
||
"area": "华南",
|
||
"remark": "external 备注",
|
||
"external_id": "EXT-ORDER-001",
|
||
"external_finished_products": [
|
||
{"style_name": "款式A", "num_of_rolls": 2, "remark": "A备注"},
|
||
{"style_name": "款式B", "num_of_rolls": 5},
|
||
],
|
||
}
|
||
|
||
response = self.client.post(
|
||
"/api/v1/shipment/shipments/external/", data, format="json"
|
||
)
|
||
self.assertEqual(response.status_code, status.HTTP_201_CREATED)
|
||
result = response.json()
|
||
|
||
self.assertEqual(result["customer"], self.customer.id)
|
||
self.assertEqual(result["external_id"], "EXT-ORDER-001")
|
||
self.assertEqual(result.get("area", ""), "华南")
|
||
self.assertEqual(result["status"], shipment_models.ShipmentStatus.DRAFT)
|
||
self.assertEqual(result["status_display"], "草稿(未发布)")
|
||
self.assertEqual(result["items_count"], 0)
|
||
self.assertEqual(result["external_finished_products_count"], 2)
|
||
|
||
shipment_id = result["id"]
|
||
|
||
# 验证外部成品表写入并关联
|
||
self.assertEqual(
|
||
shipment_models.ExternalFinishedProduct.objects.filter(
|
||
shipment_id=shipment_id
|
||
).count(),
|
||
2,
|
||
)
|
||
efp_a = shipment_models.ExternalFinishedProduct.objects.filter(
|
||
shipment_id=shipment_id, style_name="款式A"
|
||
).first()
|
||
self.assertIsNotNone(efp_a)
|
||
self.assertEqual(getattr(efp_a, "remark", None) or "", "A备注")
|
||
|
||
# 验证不会绑定任何销售品
|
||
self.sales_item.refresh_from_db()
|
||
self.assertIsNone(self.sales_item.shipment_id)
|
||
|
||
def test_create_external_shipment_external_id_required(self):
|
||
data = {
|
||
"customer": self.customer.id,
|
||
"shipment_date": "2026-01-14",
|
||
"external_id": " ",
|
||
"external_finished_products": [
|
||
{"style_name": "款式A", "num_of_rolls": 1},
|
||
],
|
||
}
|
||
response = self.client.post(
|
||
"/api/v1/shipment/shipments/external/", data, format="json"
|
||
)
|
||
self.assertEqual(response.status_code, status.HTTP_400_BAD_REQUEST)
|
||
self.assertIn("external_id", response.json())
|
||
|
||
def test_create_external_shipment_products_required(self):
|
||
data = {
|
||
"customer": self.customer.id,
|
||
"shipment_date": "2026-01-14",
|
||
"external_id": "EXT-ORDER-002",
|
||
"external_finished_products": [],
|
||
}
|
||
response = self.client.post(
|
||
"/api/v1/shipment/shipments/external/", data, format="json"
|
||
)
|
||
self.assertEqual(response.status_code, status.HTTP_400_BAD_REQUEST)
|
||
self.assertIn("external_finished_products", response.json())
|
||
|
||
def test_create_external_shipment_unauthenticated(self):
|
||
self.client.logout()
|
||
data = {
|
||
"customer": self.customer.id,
|
||
"shipment_date": "2026-01-14",
|
||
"external_id": "EXT-ORDER-003",
|
||
"external_finished_products": [
|
||
{"style_name": "款式A", "num_of_rolls": 1},
|
||
],
|
||
}
|
||
response = self.client.post(
|
||
"/api/v1/shipment/shipments/external/", data, format="json"
|
||
)
|
||
self.assertEqual(response.status_code, status.HTTP_401_UNAUTHORIZED)
|
||
|
||
|
||
class ShipmentQueryAPITestCase(TestCase):
|
||
"""测试出货单查询 API（列表/详情）"""
|
||
|
||
def setUp(self):
|
||
self.client = APIClient()
|
||
|
||
self.merchant1 = basic_models.Merchant.objects.create(
|
||
name="商户1", type=basic_models.MerchantTypeEnum.FACTORY
|
||
)
|
||
self.merchant2 = basic_models.Merchant.objects.create(
|
||
name="商户2", type=basic_models.MerchantTypeEnum.FACTORY
|
||
)
|
||
|
||
self.user1 = User.objects.create_user(
|
||
username="u1", password="pass123", email="u1@example.com"
|
||
)
|
||
self.emp1 = basic_models.Employee.objects.create(
|
||
sys_user=self.user1,
|
||
merchant=self.merchant1,
|
||
name="员工1",
|
||
mobile="13800138010",
|
||
status=basic_models.EmployeeStatusEnum.ACTIVE,
|
||
)
|
||
|
||
self.user2 = User.objects.create_user(
|
||
username="u2", password="pass123", email="u2@example.com"
|
||
)
|
||
self.emp2 = basic_models.Employee.objects.create(
|
||
sys_user=self.user2,
|
||
merchant=self.merchant2,
|
||
name="员工2",
|
||
mobile="13800138011",
|
||
status=basic_models.EmployeeStatusEnum.ACTIVE,
|
||
)
|
||
|
||
self.customer1 = basic_models.Customer.objects.create(
|
||
merchant=self.merchant1, name="客户1", mobile="13900139010", area="A"
|
||
)
|
||
self.customer2 = basic_models.Customer.objects.create(
|
||
merchant=self.merchant2, name="客户2", mobile="13900139011", area="B"
|
||
)
|
||
|
||
self.shipment1 = shipment_models.Shipment.objects.create(
|
||
merchant=self.merchant1,
|
||
customer=self.customer1,
|
||
shipment_date="2026-01-15",
|
||
created_by=self.user1,
|
||
remark="s1",
|
||
area="A1",
|
||
)
|
||
self.shipment2 = shipment_models.Shipment.objects.create(
|
||
merchant=self.merchant2,
|
||
customer=self.customer2,
|
||
shipment_date="2026-01-15",
|
||
created_by=self.user2,
|
||
remark="s2",
|
||
area="B1",
|
||
)
|
||
|
||
self.client.force_authenticate(user=self.user1)
|
||
|
||
def test_list_shipments_only_current_merchant(self):
|
||
resp = self.client.get("/api/v1/shipment/shipments/")
|
||
self.assertEqual(resp.status_code, status.HTTP_200_OK)
|
||
data = resp.json()
|
||
|
||
# LimitOffsetPagination 结构：count/next/previous/results
|
||
self.assertIn("count", data)
|
||
self.assertIn("results", data)
|
||
ids = [it["id"] for it in data["results"]]
|
||
self.assertIn(self.shipment1.id, ids)
|
||
self.assertNotIn(self.shipment2.id, ids)
|
||
|
||
# 关键：列表序列化器必须稳定输出明细数组字段（即使为空）
|
||
item = next(it for it in data["results"] if it["id"] == self.shipment1.id)
|
||
self.assertIn("area", item)
|
||
self.assertEqual(item["area"], "A1")
|
||
self.assertEqual(item["status"], shipment_models.ShipmentStatus.DRAFT)
|
||
self.assertEqual(item["status_display"], "草稿(未发布)")
|
||
self.assertIn("sales_items", item)
|
||
self.assertIsInstance(item["sales_items"], list)
|
||
self.assertIn("external_finished_products", item)
|
||
self.assertIsInstance(item["external_finished_products"], list)
|
||
|
||
def test_retrieve_shipment_success(self):
|
||
resp = self.client.get(f"/api/v1/shipment/shipments/{self.shipment1.id}/")
|
||
self.assertEqual(resp.status_code, status.HTTP_200_OK)
|
||
result = resp.json()
|
||
self.assertEqual(result["id"], self.shipment1.id)
|
||
self.assertIn("area", result)
|
||
self.assertEqual(result["area"], "A1")
|
||
self.assertEqual(result["status"], shipment_models.ShipmentStatus.DRAFT)
|
||
self.assertEqual(result["status_display"], "草稿(未发布)")
|
||
self.assertIn("sales_items", result)
|
||
self.assertIsInstance(result["sales_items"], list)
|
||
self.assertIn("external_finished_products", result)
|
||
self.assertIsInstance(result["external_finished_products"], list)
|
||
|
||
def test_patch_shipment_area_success(self):
|
||
"""
|
||
新增字段 area：支持更新（PATCH）并回显。
|
||
"""
|
||
resp = self.client.patch(
|
||
f"/api/v1/shipment/shipments/{self.shipment1.id}/",
|
||
data={"area": "更新地区"},
|
||
format="json",
|
||
)
|
||
self.assertEqual(resp.status_code, status.HTTP_200_OK)
|
||
result = resp.json()
|
||
self.assertEqual(result["id"], self.shipment1.id)
|
||
self.assertEqual(result.get("area", ""), "更新地区")
|
||
|
||
self.shipment1.refresh_from_db()
|
||
self.assertEqual(getattr(self.shipment1, "area", ""), "更新地区")
|
||
|
||
def test_list_shipments_includes_external_finished_product_remark(self):
|
||
"""
|
||
Shipments list 需要附带 external_finished_products 明细数据（包含 remark 字段）。
|
||
"""
|
||
# 给 shipment1 挂一个外部成品表
|
||
shipment_models.ExternalFinishedProduct.objects.create(
|
||
shipment=self.shipment1,
|
||
style_name="款式X",
|
||
num_of_rolls=1,
|
||
remark="X备注",
|
||
created_by=self.user1,
|
||
)
|
||
|
||
resp = self.client.get("/api/v1/shipment/shipments/")
|
||
self.assertEqual(resp.status_code, status.HTTP_200_OK)
|
||
data = resp.json()
|
||
item = next(it for it in data["results"] if it["id"] == self.shipment1.id)
|
||
efps = item["external_finished_products"]
|
||
self.assertIsInstance(efps, list)
|
||
target = next(p for p in efps if p["style_name"] == "款式X")
|
||
self.assertIn("remark", target)
|
||
self.assertEqual(target["remark"], "X备注")
|
||
|
||
def test_retrieve_other_merchant_shipment_404(self):
|
||
resp = self.client.get(f"/api/v1/shipment/shipments/{self.shipment2.id}/")
|
||
self.assertEqual(resp.status_code, status.HTTP_404_NOT_FOUND)
|
||
|
||
def test_list_shipments_supports_status_filter(self):
|
||
from shipment.services import modify_status
|
||
|
||
modify_status(
|
||
self.shipment1,
|
||
target_status=shipment_models.ShipmentStatus.PUBLISHED,
|
||
operator=self.user1,
|
||
)
|
||
|
||
resp = self.client.get(
|
||
f"/api/v1/shipment/shipments/?status={shipment_models.ShipmentStatus.PUBLISHED}"
|
||
)
|
||
self.assertEqual(resp.status_code, status.HTTP_200_OK)
|
||
data = resp.json()
|
||
self.assertEqual(data["count"], 1)
|
||
self.assertEqual(data["results"][0]["id"], self.shipment1.id)
|
||
|
||
def test_retrieve_shipment_supports_status_filter(self):
|
||
from shipment.services import modify_status
|
||
|
||
modify_status(
|
||
self.shipment1,
|
||
target_status=shipment_models.ShipmentStatus.PUBLISHED,
|
||
operator=self.user1,
|
||
)
|
||
|
||
resp = self.client.get(
|
||
f"/api/v1/shipment/shipments/{self.shipment1.id}/?status={shipment_models.ShipmentStatus.PUBLISHED}"
|
||
)
|
||
self.assertEqual(resp.status_code, status.HTTP_200_OK)
|
||
self.assertEqual(resp.json()["id"], self.shipment1.id)
|
||
|
||
def test_retrieve_shipment_status_filter_mismatch_returns_404(self):
|
||
from shipment.services import modify_status
|
||
|
||
modify_status(
|
||
self.shipment1,
|
||
target_status=shipment_models.ShipmentStatus.PUBLISHED,
|
||
operator=self.user1,
|
||
)
|
||
|
||
resp = self.client.get(
|
||
f"/api/v1/shipment/shipments/{self.shipment1.id}/?status={shipment_models.ShipmentStatus.APPROVED}"
|
||
)
|
||
self.assertEqual(resp.status_code, status.HTTP_404_NOT_FOUND)
|
||
|
||
def test_list_shipments_unauthenticated(self):
|
||
self.client.logout()
|
||
resp = self.client.get("/api/v1/shipment/shipments/")
|
||
self.assertEqual(resp.status_code, status.HTTP_401_UNAUTHORIZED)
|
||
|
||
|
||
class ShipmentStatusServiceTestCase(TestCase):
|
||
"""测试 shipment.services.modify_status 状态机"""
|
||
|
||
def setUp(self):
|
||
self.merchant = basic_models.Merchant.objects.create(
|
||
name="状态测试商户", type=basic_models.MerchantTypeEnum.FACTORY
|
||
)
|
||
self.user = User.objects.create_user(
|
||
username="shipment_status_user",
|
||
password="testpass123",
|
||
email="shipment_status@example.com",
|
||
)
|
||
self.employee = basic_models.Employee.objects.create(
|
||
sys_user=self.user,
|
||
merchant=self.merchant,
|
||
name="状态测试员工",
|
||
mobile="13800138100",
|
||
status=basic_models.EmployeeStatusEnum.ACTIVE,
|
||
)
|
||
self.customer = basic_models.Customer.objects.create(
|
||
merchant=self.merchant,
|
||
name="状态测试客户",
|
||
mobile="13900139100",
|
||
area="杭州",
|
||
)
|
||
self.shipment = shipment_models.Shipment.objects.create(
|
||
merchant=self.merchant,
|
||
customer=self.customer,
|
||
shipment_date="2026-04-02",
|
||
created_by=self.user,
|
||
)
|
||
|
||
def test_modify_status_keeps_idempotent_when_same_status(self):
|
||
from shipment.services import modify_status
|
||
|
||
original_updated_at = self.shipment.updated_at
|
||
original_status_modified_at = self.shipment.status_modified_at
|
||
|
||
returned = modify_status(
|
||
self.shipment,
|
||
target_status=shipment_models.ShipmentStatus.DRAFT,
|
||
operator=self.user,
|
||
)
|
||
|
||
self.assertEqual(returned.id, self.shipment.id)
|
||
self.shipment.refresh_from_db()
|
||
self.assertEqual(self.shipment.status, shipment_models.ShipmentStatus.DRAFT)
|
||
self.assertEqual(self.shipment.status_modified_at, original_status_modified_at)
|
||
self.assertEqual(self.shipment.updated_at, original_updated_at)
|
||
|
||
def test_modify_status_allows_draft_to_published(self):
|
||
from shipment.services import modify_status
|
||
|
||
modify_status(
|
||
self.shipment,
|
||
target_status=shipment_models.ShipmentStatus.PUBLISHED,
|
||
operator=self.user,
|
||
)
|
||
|
||
self.shipment.refresh_from_db()
|
||
self.assertEqual(self.shipment.status, shipment_models.ShipmentStatus.PUBLISHED)
|
||
self.assertIsNotNone(self.shipment.status_modified_at)
|
||
self.assertIsNone(self.shipment.cancelled_by)
|
||
self.assertIsNone(self.shipment.approved_by)
|
||
|
||
def test_modify_status_rejects_draft_to_approved(self):
|
||
from shipment.services import modify_status
|
||
|
||
with self.assertRaisesMessage(ValueError, "不允许将出货单状态从 草稿(未发布) 修改为 已审核"):
|
||
modify_status(
|
||
self.shipment,
|
||
target_status=shipment_models.ShipmentStatus.APPROVED,
|
||
operator=self.user,
|
||
approved_by=self.user,
|
||
)
|
||
|
||
def test_modify_status_requires_approved_by_when_approving(self):
|
||
from shipment.services import modify_status
|
||
|
||
modify_status(
|
||
self.shipment,
|
||
target_status=shipment_models.ShipmentStatus.PUBLISHED,
|
||
operator=self.user,
|
||
)
|
||
|
||
with self.assertRaisesMessage(ValueError, "approved_by 不能为空"):
|
||
modify_status(
|
||
self.shipment,
|
||
target_status=shipment_models.ShipmentStatus.APPROVED,
|
||
operator=self.user,
|
||
approved_by=None,
|
||
)
|
||
|
||
def test_modify_status_sets_approved_by_when_approved(self):
|
||
from shipment.services import modify_status
|
||
|
||
modify_status(
|
||
self.shipment,
|
||
target_status=shipment_models.ShipmentStatus.PUBLISHED,
|
||
operator=self.user,
|
||
)
|
||
modify_status(
|
||
self.shipment,
|
||
target_status=shipment_models.ShipmentStatus.APPROVED,
|
||
operator=self.user,
|
||
approved_by=self.user,
|
||
)
|
||
|
||
self.shipment.refresh_from_db()
|
||
self.assertEqual(self.shipment.status, shipment_models.ShipmentStatus.APPROVED)
|
||
self.assertEqual(self.shipment.approved_by, self.user)
|
||
self.assertIsNotNone(self.shipment.status_modified_at)
|
||
|
||
def test_modify_status_allows_rejected_to_approved(self):
|
||
from shipment.services import modify_status
|
||
|
||
modify_status(
|
||
self.shipment,
|
||
target_status=shipment_models.ShipmentStatus.PUBLISHED,
|
||
operator=self.user,
|
||
)
|
||
modify_status(
|
||
self.shipment,
|
||
target_status=shipment_models.ShipmentStatus.REJECTED,
|
||
operator=self.user,
|
||
)
|
||
modify_status(
|
||
self.shipment,
|
||
target_status=shipment_models.ShipmentStatus.APPROVED,
|
||
operator=self.user,
|
||
approved_by=self.user,
|
||
)
|
||
|
||
self.shipment.refresh_from_db()
|
||
self.assertEqual(self.shipment.status, shipment_models.ShipmentStatus.APPROVED)
|
||
self.assertEqual(self.shipment.approved_by, self.user)
|
||
|
||
def test_modify_status_rejects_rejected_to_published(self):
|
||
from shipment.services import modify_status
|
||
|
||
modify_status(
|
||
self.shipment,
|
||
target_status=shipment_models.ShipmentStatus.PUBLISHED,
|
||
operator=self.user,
|
||
)
|
||
modify_status(
|
||
self.shipment,
|
||
target_status=shipment_models.ShipmentStatus.REJECTED,
|
||
operator=self.user,
|
||
)
|
||
|
||
with self.assertRaisesMessage(ValueError, "不允许将出货单状态从 已驳回 修改为 已发布"):
|
||
modify_status(
|
||
self.shipment,
|
||
target_status=shipment_models.ShipmentStatus.PUBLISHED,
|
||
operator=self.user,
|
||
)
|
||
|
||
def test_modify_status_allows_cancel_from_any_non_cancelled_state(self):
|
||
from shipment.services import modify_status
|
||
|
||
modify_status(
|
||
self.shipment,
|
||
target_status=shipment_models.ShipmentStatus.PUBLISHED,
|
||
operator=self.user,
|
||
)
|
||
modify_status(
|
||
self.shipment,
|
||
target_status=shipment_models.ShipmentStatus.CANCELLED,
|
||
operator=self.user,
|
||
)
|
||
|
||
self.shipment.refresh_from_db()
|
||
self.assertEqual(self.shipment.status, shipment_models.ShipmentStatus.CANCELLED)
|
||
self.assertEqual(self.shipment.cancelled_by, self.user)
|
||
self.assertIsNotNone(self.shipment.status_modified_at)
|
||
|
||
def test_modify_status_rejects_change_after_cancelled(self):
|
||
from shipment.services import modify_status
|
||
|
||
modify_status(
|
||
self.shipment,
|
||
target_status=shipment_models.ShipmentStatus.PUBLISHED,
|
||
operator=self.user,
|
||
)
|
||
modify_status(
|
||
self.shipment,
|
||
target_status=shipment_models.ShipmentStatus.CANCELLED,
|
||
operator=self.user,
|
||
)
|
||
|
||
with self.assertRaisesMessage(ValueError, "不允许将出货单状态从 已取消 修改为 已审核"):
|
||
modify_status(
|
||
self.shipment,
|
||
target_status=shipment_models.ShipmentStatus.APPROVED,
|
||
operator=self.user,
|
||
approved_by=self.user,
|
||
)
|
||
|
||
|
||
class SalesItemCreateAPITestCase(APITestCase):
|
||
"""销售品创建 API 测试"""
|
||
|
||
def setUp(self):
|
||
from django.contrib.auth import get_user_model
|
||
from basic_info import models as basic_models
|
||
from printing import models as printing_models
|
||
from shipment import models as shipment_models
|
||
from decimal import Decimal
|
||
|
||
User = get_user_model()
|
||
|
||
# 创建商户
|
||
self.merchant = basic_models.Merchant.objects.create(
|
||
name="测试商户", type=basic_models.MerchantTypeEnum.FACTORY
|
||
)
|
||
|
||
# 创建用户
|
||
self.user = User.objects.create_user(
|
||
username="testuser_sales",
|
||
password="testpass123",
|
||
email="test_sales@example.com",
|
||
)
|
||
|
||
# 创建员工并关联商户
|
||
self.employee = basic_models.Employee.objects.create(
|
||
sys_user=self.user,
|
||
merchant=self.merchant,
|
||
name="测试员工Sales",
|
||
mobile="13800138003",
|
||
status=basic_models.EmployeeStatusEnum.ACTIVE,
|
||
)
|
||
|
||
# 创建客户
|
||
self.customer = basic_models.Customer.objects.create(
|
||
merchant=self.merchant,
|
||
name="测试客户Sales",
|
||
mobile="13900139003",
|
||
area="测试地区Sales",
|
||
)
|
||
|
||
# 创建产品
|
||
self.product = basic_models.Product.objects.create(
|
||
merchant=self.merchant,
|
||
name="测试产品",
|
||
code="TEST001",
|
||
unit=basic_models.ProductUnitEnum.METER,
|
||
)
|
||
|
||
# 创建印染订单
|
||
self.printing_order = printing_models.PrintingOrder.objects.create(
|
||
merchant=self.merchant,
|
||
customer=self.customer,
|
||
fabric="测试面料",
|
||
created_by=self.user,
|
||
)
|
||
|
||
# 创建印染任务
|
||
self.printing_job = printing_models.PrintingJob.objects.create(
|
||
merchant=self.merchant,
|
||
printing_order=self.printing_order,
|
||
product=self.product,
|
||
quantity=100,
|
||
unit="米",
|
||
pieces=1,
|
||
description="测试任务",
|
||
created_by=self.user,
|
||
)
|
||
|
||
self.client.force_authenticate(user=self.user)
|
||
|
||
def test_create_sales_item_success(self):
|
||
"""测试成功创建销售品"""
|
||
data = {
|
||
"printing_job_id": self.printing_job.id,
|
||
"name": "测试销售品",
|
||
"quantity": "150.50",
|
||
"unit": 1, # 米
|
||
"customer_id": self.customer.id,
|
||
"remark": "测试备注",
|
||
"position": "A1-01",
|
||
}
|
||
|
||
resp = self.client.post("/api/v1/shipment/sales-items/", data, format="json")
|
||
self.assertEqual(resp.status_code, status.HTTP_201_CREATED)
|
||
|
||
result = resp.json()
|
||
self.assertEqual(result["name"], "测试销售品")
|
||
self.assertEqual(result["quantity"], "150.50")
|
||
self.assertEqual(result["unit"], 1)
|
||
self.assertEqual(result["unit_display"], "米")
|
||
self.assertEqual(result["printing_job_id"], self.printing_job.id)
|
||
self.assertEqual(result["customer_id"], self.customer.id)
|
||
self.assertIsNone(result["shipment_id"]) # 待分配状态
|
||
self.assertEqual(result["created_by_id"], self.user.id)
|
||
|
||
def test_create_sales_item_without_customer_id(self):
|
||
"""测试不指定客户ID时自动从生产订单获取"""
|
||
data = {
|
||
"printing_job_id": self.printing_job.id,
|
||
"name": "测试销售品无客户",
|
||
"quantity": "100",
|
||
"unit": 1,
|
||
}
|
||
|
||
resp = self.client.post("/api/v1/shipment/sales-items/", data, format="json")
|
||
self.assertEqual(resp.status_code, status.HTTP_201_CREATED)
|
||
|
||
result = resp.json()
|
||
# 客户ID应自动从生产订单获取
|
||
self.assertEqual(result["customer_id"], self.customer.id)
|
||
|
||
def test_create_sales_item_invalid_unit(self):
|
||
"""测试无效的单位值"""
|
||
data = {
|
||
"printing_job_id": self.printing_job.id,
|
||
"name": "测试销售品",
|
||
"quantity": "100",
|
||
"unit": 99, # 无效单位
|
||
}
|
||
|
||
resp = self.client.post("/api/v1/shipment/sales-items/", data, format="json")
|
||
self.assertEqual(resp.status_code, status.HTTP_400_BAD_REQUEST)
|
||
self.assertIn("unit", resp.json())
|
||
|
||
def test_create_sales_item_invalid_printing_job(self):
|
||
"""测试不存在的生产任务"""
|
||
data = {
|
||
"printing_job_id": 99999,
|
||
"name": "测试销售品",
|
||
"quantity": "100",
|
||
"unit": 1,
|
||
}
|
||
|
||
resp = self.client.post("/api/v1/shipment/sales-items/", data, format="json")
|
||
self.assertEqual(resp.status_code, status.HTTP_400_BAD_REQUEST)
|
||
self.assertIn("detail", resp.json())
|
||
|
||
def test_create_sales_item_missing_required_fields(self):
|
||
"""测试缺少必填字段"""
|
||
data = {
|
||
"printing_job_id": self.printing_job.id,
|
||
# 缺少 name, quantity, unit
|
||
}
|
||
|
||
resp = self.client.post("/api/v1/shipment/sales-items/", data, format="json")
|
||
self.assertEqual(resp.status_code, status.HTTP_400_BAD_REQUEST)
|
||
result = resp.json()
|
||
self.assertIn("name", result)
|
||
self.assertIn("quantity", result)
|
||
self.assertIn("unit", result)
|
||
|
||
def test_create_sales_item_unauthenticated(self):
|
||
"""测试未认证访问"""
|
||
self.client.logout()
|
||
data = {
|
||
"printing_job_id": self.printing_job.id,
|
||
"name": "测试销售品",
|
||
"quantity": "100",
|
||
"unit": 1,
|
||
}
|
||
|
||
resp = self.client.post("/api/v1/shipment/sales-items/", data, format="json")
|
||
self.assertEqual(resp.status_code, status.HTTP_401_UNAUTHORIZED)
|