Overdue order notification (#3114)

* Adds a background task to notify users when a PurchaseOrder becomes overdue

* Schedule the overdue purchaseorder check to occur daily

* Allow notifications to be sent to "Owner" instances

- Extract user information from the Owner instance

* add unit test to ensure notifications are sent for overdue purchase orders

* Adds notification for overdue sales orders

* Clean up notification display panel

- Simplify rendering
- Order "newest at top"
- Element alignment tweaks

* style fixes

* More style fixes

* Tweak notification padding

* Fix import order

* Adds task to notify user of overdue build orders

* Adds unit tests for build order notifications

* Refactor subject line for emails:

- Use the configured instance title as a prefix for the subject line

* Add email template for overdue build orders

* Fix unit tests to accommodate new default value

* Logic error fix

InvenTree/build/tasks.py

@@ -1,5 +1,6 @@
 """Background task definitions for the BuildOrder app"""
 
+from datetime import datetime, timedelta
 from decimal import Decimal
 import logging
 
@@ -8,9 +9,12 @@ from django.template.loader import render_to_string
 
 from allauth.account.models import EmailAddress
 
+from plugin.events import trigger_event
+import common.notifications
 import build.models
 import InvenTree.helpers
 import InvenTree.tasks
+from InvenTree.status_codes import BuildStatus
 from InvenTree.ready import isImportingData
 
 import part.models as part_models
@@ -93,8 +97,67 @@ def check_build_stock(build: build.models.Build):
         # Render the HTML message
         html_message = render_to_string('email/build_order_required_stock.html', context)
 
-        subject = "[InvenTree] " + _("Stock required for build order")
+        subject = _("Stock required for build order")
 
         recipients = emails.values_list('email', flat=True)
 
         InvenTree.tasks.send_email(subject, '', recipients, html_message=html_message)
+
+
+def notify_overdue_build_order(bo: build.models.Build):
+    """Notify appropriate users that a Build has just become 'overdue'"""
+
+    targets = []
+
+    if bo.issued_by:
+        targets.append(bo.issued_by)
+
+    if bo.responsible:
+        targets.append(bo.responsible)
+
+    name = _('Overdue Build Order')
+
+    context = {
+        'order': bo,
+        'name': name,
+        'message': _(f"Build order {bo} is now overdue"),
+        'link': InvenTree.helpers.construct_absolute_url(
+            bo.get_absolute_url(),
+        ),
+        'template': {
+            'html': 'email/overdue_build_order.html',
+            'subject': name,
+        }
+    }
+
+    event_name = 'build.overdue_build_order'
+
+    # Send a notification to the appropriate users
+    common.notifications.trigger_notification(
+        bo,
+        event_name,
+        targets=targets,
+        context=context
+    )
+
+    # Register a matching event to the plugin system
+    trigger_event(event_name, build_order=bo.pk)
+
+
+def check_overdue_build_orders():
+    """Check if any outstanding BuildOrders have just become overdue
+
+    - This check is performed daily
+    - Look at the 'target_date' of any outstanding BuildOrder objects
+    - If the 'target_date' expired *yesterday* then the order is just out of date
+    """
+
+    yesterday = datetime.now().date() - timedelta(days=1)
+
+    overdue_orders = build.models.Build.objects.filter(
+        target_date=yesterday,
+        status__in=BuildStatus.ACTIVE_CODES
+    )
+
+    for bo in overdue_orders:
+        notify_overdue_build_order(bo)

InvenTree/build/test_build.py

@@ -1,11 +1,16 @@
 """Unit tests for the 'build' models"""
 
+from datetime import datetime, timedelta
+
 from django.test import TestCase
 
+from django.contrib.auth import get_user_model
 from django.core.exceptions import ValidationError
 
 from InvenTree import status_codes as status
 
+import common.models
+import build.tasks
 from build.models import Build, BuildItem, get_next_build_number
 from part.models import Part, BomItem, BomItemSubstitute
 from stock.models import StockItem
@@ -14,6 +19,10 @@ from stock.models import StockItem
 class BuildTestBase(TestCase):
     """Run some tests to ensure that the Build model is working properly."""
 
+    fixtures = [
+        'users',
+    ]
+
     def setUp(self):
         """Initialize data to use for these tests.
 
@@ -84,7 +93,8 @@ class BuildTestBase(TestCase):
             reference=ref,
             title="This is a build",
             part=self.assembly,
-            quantity=10
+            quantity=10,
+            issued_by=get_user_model().objects.get(pk=1),
         )
 
         # Create some build output (StockItem) objects
@@ -450,8 +460,6 @@ class AutoAllocationTests(BuildTestBase):
             substitutes=True,
         )
 
-        # self.assertTrue(self.build.are_untracked_parts_allocated())
-
         # self.assertEqual(self.build.allocated_stock.count(), 8)
         self.assertEqual(self.build.unallocated_quantity(self.bom_item_1), 0)
         self.assertEqual(self.build.unallocated_quantity(self.bom_item_2), 0)
@@ -471,3 +479,19 @@ class AutoAllocationTests(BuildTestBase):
 
         self.assertEqual(self.build.unallocated_quantity(self.bom_item_1), 0)
         self.assertEqual(self.build.unallocated_quantity(self.bom_item_2), 0)
+
+    def test_overdue_notification(self):
+        """Test sending of notifications when a build order is overdue."""
+
+        self.build.target_date = datetime.now().date() - timedelta(days=1)
+        self.build.save()
+
+        # Check for overdue orders
+        build.tasks.check_overdue_build_orders()
+
+        message = common.models.NotificationMessage.objects.get(
+            category='build.overdue_build_order',
+            user__id=1,
+        )
+
+        self.assertEqual(message.name, 'Overdue Build Order')