mirror of
https://github.com/inventree/InvenTree.git
synced 2025-04-28 19:46:46 +00:00
648faf4ed2
* Adds a configurable 'reference pattern' to the IndexingReferenceMixin class * Expand tests for reference_pattern validator: - Prevent inclusion of illegal characters - Prevent multiple groups of hash (#) characters - Add unit tests * Validator now checks for valid strftime formatter * Adds build order reference pattern * Adds function for creating a valid regex from the supplied pattern - More unit tests - Use it to validate BuildOrder reference field * Refactoring the whole thing again - try using python string.format * remove datetime-matcher from requirements.txt * Add some more formatting helper functions - Construct a regular expression from a format string - Extract named values from a string, based on a format string * Fix validator for build order reference field * Adding unit tests for the new format string functionality * Adds validation for reference fields * Require the 'ref' format key as part of a valid reference pattern * Extend format extraction to allow specification of integer groups * Remove unused import * Fix requirements * Add method for generating the 'next' reference field for a model * Fix function for generating next BuildOrder reference value - A function is required as class methods cannot be used - Simply wraps the existing class method * Remove BUILDORDER_REFERENCE_REGEX setting * Add unit test for build order reference field validation * Adds unit testing for extracting integer values from a reference field * Fix bugs from previous commit * Add unit test for generation of default build order reference * Add data migration for BuildOrder model - Update reference field with old prefix - Construct new pattern based on old prefix * Adds unit test for data migration - Check that the BuildOrder reference field is updated as expected * Remove 'BUILDORDER_REFERENCE_PREFIX' setting * Adds new setting for SalesOrder reference pattern * Update method by which next reference value is generated * Improved error handling in api_tester code * Improve automated generation of order reference fields - Handle potential errors - Return previous reference if something goes wrong * SalesOrder reference has now been updated also - New reference pattern setting - Updated default and validator for reference field - Updated serializer and API - Added unit tests * Migrate the "PurchaseOrder" reference field to the new system * Data migration for SalesOrder and PurchaseOrder reference fields * Remove PURCHASEORDER_REFERENCE_PREFIX * Remove references to SALESORDER_REFERENCE_PREFIX * Re-add maximum value validation * Bug fixes * Improve algorithm for generating new reference - Handle case where most recent reference does not conform to the reference pattern * Fixes for 'order' unit tests * Unit test fixes for order app * More unit test fixes * More unit test fixing * Revert behaviour for "extract_int" clipping function * Unit test value fix * Prevent build order notification if we are importing records
295 lines
10 KiB
Python
295 lines
10 KiB
Python
"""Unit tests for the SalesOrder models"""
|
|
|
|
from datetime import datetime, timedelta
|
|
|
|
from django.contrib.auth import get_user_model
|
|
from django.contrib.auth.models import Group
|
|
from django.core.exceptions import ValidationError
|
|
from django.test import TestCase
|
|
|
|
import order.tasks
|
|
from common.models import InvenTreeSetting, NotificationMessage
|
|
from company.models import Company
|
|
from InvenTree import status_codes as status
|
|
from order.models import (SalesOrder, SalesOrderAllocation, SalesOrderLineItem,
|
|
SalesOrderShipment)
|
|
from part.models import Part
|
|
from stock.models import StockItem
|
|
from users.models import Owner
|
|
|
|
|
|
class SalesOrderTest(TestCase):
|
|
"""Run tests to ensure that the SalesOrder model is working correctly."""
|
|
|
|
fixtures = [
|
|
'users',
|
|
]
|
|
|
|
def setUp(self):
|
|
"""Initial setup for this set of unit tests"""
|
|
# Create a Company to ship the goods to
|
|
self.customer = Company.objects.create(name="ABC Co", description="My customer", is_customer=True)
|
|
|
|
# Create a Part to ship
|
|
self.part = Part.objects.create(name='Spanner', salable=True, description='A spanner that I sell')
|
|
|
|
# Create some stock!
|
|
self.Sa = StockItem.objects.create(part=self.part, quantity=100)
|
|
self.Sb = StockItem.objects.create(part=self.part, quantity=200)
|
|
|
|
# Create a SalesOrder to ship against
|
|
self.order = SalesOrder.objects.create(
|
|
customer=self.customer,
|
|
reference='SO-1234',
|
|
customer_reference='ABC 55555'
|
|
)
|
|
|
|
# Create a Shipment against this SalesOrder
|
|
self.shipment = SalesOrderShipment.objects.create(
|
|
order=self.order,
|
|
reference='SO-001',
|
|
)
|
|
|
|
# Create a line item
|
|
self.line = SalesOrderLineItem.objects.create(quantity=50, order=self.order, part=self.part)
|
|
|
|
def test_so_reference(self):
|
|
"""Unit tests for sales order generation"""
|
|
|
|
# Test that a good reference is created when we have no existing orders
|
|
SalesOrder.objects.all().delete()
|
|
|
|
self.assertEqual(SalesOrder.generate_reference(), 'SO-0001')
|
|
|
|
def test_rebuild_reference(self):
|
|
"""Test that the 'reference_int' field gets rebuilt when the model is saved"""
|
|
|
|
self.assertEqual(self.order.reference_int, 1234)
|
|
|
|
self.order.reference = '999'
|
|
self.order.save()
|
|
self.assertEqual(self.order.reference_int, 999)
|
|
|
|
self.order.reference = '1000K'
|
|
self.order.save()
|
|
self.assertEqual(self.order.reference_int, 1000)
|
|
|
|
def test_overdue(self):
|
|
"""Tests for overdue functionality."""
|
|
today = datetime.now().date()
|
|
|
|
# By default, order is *not* overdue as the target date is not set
|
|
self.assertFalse(self.order.is_overdue)
|
|
|
|
# Set target date in the past
|
|
self.order.target_date = today - timedelta(days=5)
|
|
self.order.save()
|
|
self.assertTrue(self.order.is_overdue)
|
|
|
|
# Set target date in the future
|
|
self.order.target_date = today + timedelta(days=5)
|
|
self.order.save()
|
|
self.assertFalse(self.order.is_overdue)
|
|
|
|
def test_empty_order(self):
|
|
"""Test for an empty order"""
|
|
self.assertEqual(self.line.quantity, 50)
|
|
self.assertEqual(self.line.allocated_quantity(), 0)
|
|
self.assertEqual(self.line.fulfilled_quantity(), 0)
|
|
self.assertFalse(self.line.is_fully_allocated())
|
|
self.assertFalse(self.line.is_over_allocated())
|
|
|
|
self.assertTrue(self.order.is_pending)
|
|
self.assertFalse(self.order.is_fully_allocated())
|
|
|
|
def test_add_duplicate_line_item(self):
|
|
"""Adding a duplicate line item to a SalesOrder is accepted"""
|
|
|
|
for ii in range(1, 5):
|
|
SalesOrderLineItem.objects.create(order=self.order, part=self.part, quantity=ii)
|
|
|
|
def allocate_stock(self, full=True):
|
|
"""Allocate stock to the order"""
|
|
SalesOrderAllocation.objects.create(
|
|
line=self.line,
|
|
shipment=self.shipment,
|
|
item=StockItem.objects.get(pk=self.Sa.pk),
|
|
quantity=25)
|
|
|
|
SalesOrderAllocation.objects.create(
|
|
line=self.line,
|
|
shipment=self.shipment,
|
|
item=StockItem.objects.get(pk=self.Sb.pk),
|
|
quantity=25 if full else 20
|
|
)
|
|
|
|
def test_allocate_partial(self):
|
|
"""Partially allocate stock"""
|
|
self.allocate_stock(False)
|
|
|
|
self.assertFalse(self.order.is_fully_allocated())
|
|
self.assertFalse(self.line.is_fully_allocated())
|
|
self.assertEqual(self.line.allocated_quantity(), 45)
|
|
self.assertEqual(self.line.fulfilled_quantity(), 0)
|
|
|
|
def test_allocate_full(self):
|
|
"""Fully allocate stock"""
|
|
self.allocate_stock(True)
|
|
|
|
self.assertTrue(self.order.is_fully_allocated())
|
|
self.assertTrue(self.line.is_fully_allocated())
|
|
self.assertEqual(self.line.allocated_quantity(), 50)
|
|
|
|
def test_order_cancel(self):
|
|
"""Allocate line items then cancel the order"""
|
|
self.allocate_stock(True)
|
|
|
|
self.assertEqual(SalesOrderAllocation.objects.count(), 2)
|
|
self.assertEqual(self.order.status, status.SalesOrderStatus.PENDING)
|
|
|
|
self.order.cancel_order()
|
|
self.assertEqual(SalesOrderAllocation.objects.count(), 0)
|
|
self.assertEqual(self.order.status, status.SalesOrderStatus.CANCELLED)
|
|
|
|
with self.assertRaises(ValidationError):
|
|
self.order.can_complete(raise_error=True)
|
|
|
|
# Now try to ship it - should fail
|
|
result = self.order.complete_order(None)
|
|
self.assertFalse(result)
|
|
|
|
def test_complete_order(self):
|
|
"""Allocate line items, then ship the order"""
|
|
# Assert some stuff before we run the test
|
|
# Initially there are two stock items
|
|
self.assertEqual(StockItem.objects.count(), 2)
|
|
|
|
# Take 25 units from each StockItem
|
|
self.allocate_stock(True)
|
|
|
|
self.assertEqual(SalesOrderAllocation.objects.count(), 2)
|
|
|
|
# Attempt to complete the order (but shipments are not completed!)
|
|
result = self.order.complete_order(None)
|
|
|
|
self.assertFalse(result)
|
|
|
|
self.assertIsNone(self.shipment.shipment_date)
|
|
self.assertFalse(self.shipment.is_complete())
|
|
|
|
# Mark the shipments as complete
|
|
self.shipment.complete_shipment(None)
|
|
self.assertTrue(self.shipment.is_complete())
|
|
|
|
# Now, should be OK to ship
|
|
result = self.order.complete_order(None)
|
|
|
|
self.assertTrue(result)
|
|
|
|
self.assertEqual(self.order.status, status.SalesOrderStatus.SHIPPED)
|
|
self.assertIsNotNone(self.order.shipment_date)
|
|
|
|
# There should now be 4 stock items
|
|
self.assertEqual(StockItem.objects.count(), 4)
|
|
|
|
sa = StockItem.objects.get(pk=self.Sa.pk)
|
|
sb = StockItem.objects.get(pk=self.Sb.pk)
|
|
|
|
# 25 units subtracted from each of the original items
|
|
self.assertEqual(sa.quantity, 75)
|
|
self.assertEqual(sb.quantity, 175)
|
|
|
|
# And 2 items created which are associated with the order
|
|
outputs = StockItem.objects.filter(sales_order=self.order)
|
|
self.assertEqual(outputs.count(), 2)
|
|
|
|
for item in outputs.all():
|
|
self.assertEqual(item.quantity, 25)
|
|
|
|
self.assertEqual(sa.sales_order, None)
|
|
self.assertEqual(sb.sales_order, None)
|
|
|
|
# And the allocations still exist
|
|
self.assertEqual(SalesOrderAllocation.objects.count(), 2)
|
|
|
|
self.assertEqual(self.order.status, status.SalesOrderStatus.SHIPPED)
|
|
|
|
self.assertTrue(self.order.is_fully_allocated())
|
|
self.assertTrue(self.line.is_fully_allocated())
|
|
self.assertEqual(self.line.fulfilled_quantity(), 50)
|
|
self.assertEqual(self.line.allocated_quantity(), 50)
|
|
|
|
def test_default_shipment(self):
|
|
"""Test sales order default shipment creation"""
|
|
# Default setting value should be False
|
|
self.assertEqual(False, InvenTreeSetting.get_setting('SALESORDER_DEFAULT_SHIPMENT'))
|
|
|
|
# Create an order
|
|
order_1 = SalesOrder.objects.create(
|
|
customer=self.customer,
|
|
reference='1235',
|
|
customer_reference='ABC 55556'
|
|
)
|
|
|
|
# Order should have no shipments when setting is False
|
|
self.assertEqual(0, order_1.shipment_count)
|
|
|
|
# Update setting to True
|
|
InvenTreeSetting.set_setting('SALESORDER_DEFAULT_SHIPMENT', True, None)
|
|
self.assertEqual(True, InvenTreeSetting.get_setting('SALESORDER_DEFAULT_SHIPMENT'))
|
|
|
|
# Create a second order
|
|
order_2 = SalesOrder.objects.create(
|
|
customer=self.customer,
|
|
reference='1236',
|
|
customer_reference='ABC 55557'
|
|
)
|
|
|
|
# Order should have one shipment
|
|
self.assertEqual(1, order_2.shipment_count)
|
|
self.assertEqual(1, order_2.pending_shipments().count())
|
|
|
|
# Shipment should have default reference of '1'
|
|
self.assertEqual('1', order_2.pending_shipments()[0].reference)
|
|
|
|
def test_overdue_notification(self):
|
|
"""Test overdue sales order notification"""
|
|
|
|
self.order.created_by = get_user_model().objects.get(pk=3)
|
|
self.order.responsible = Owner.create(obj=Group.objects.get(pk=2))
|
|
self.order.target_date = datetime.now().date() - timedelta(days=1)
|
|
self.order.save()
|
|
|
|
# Check for overdue sales orders
|
|
order.tasks.check_overdue_sales_orders()
|
|
|
|
messages = NotificationMessage.objects.filter(
|
|
category='order.overdue_sales_order',
|
|
)
|
|
|
|
self.assertEqual(len(messages), 2)
|
|
|
|
def test_new_so_notification(self):
|
|
"""Test that a notification is sent when a new SalesOrder is created.
|
|
|
|
- The responsible user should receive a notification
|
|
- The creating user should *not* receive a notification
|
|
"""
|
|
|
|
SalesOrder.objects.create(
|
|
customer=self.customer,
|
|
reference='1234567',
|
|
created_by=get_user_model().objects.get(pk=3),
|
|
responsible=Owner.create(obj=Group.objects.get(pk=3))
|
|
)
|
|
|
|
messages = NotificationMessage.objects.filter(
|
|
category='order.new_salesorder',
|
|
)
|
|
|
|
# A notification should have been generated for user 4 (who is a member of group 3)
|
|
self.assertTrue(messages.filter(user__pk=4).exists())
|
|
|
|
# However *no* notification should have been generated for the creating user
|
|
self.assertFalse(messages.filter(user__pk=3).exists())
|