diff --git a/src/sideshow/enum.py b/src/sideshow/enum.py
index 2349f3d..a761d02 100644
--- a/src/sideshow/enum.py
+++ b/src/sideshow/enum.py
@@ -285,6 +285,12 @@ Indicates the buyer has placed a vendor purchase order which includes
this item. So the item is "on order" until the truck arrives.
"""
+ORDER_ITEM_EVENT_REORDER = 210
+"""
+Indicates the item was not received with the delivery on which it was
+expected, and must be re-ordered from vendor.
+"""
+
ORDER_ITEM_EVENT_RECEIVED = 300
"""
Indicates the receiver has found the item while receiving a vendor
@@ -366,6 +372,7 @@ ORDER_ITEM_EVENT = OrderedDict([
(ORDER_ITEM_EVENT_CUSTOMER_RESOLVED, "customer resolved"),
(ORDER_ITEM_EVENT_PRODUCT_RESOLVED, "product resolved"),
(ORDER_ITEM_EVENT_PLACED, "placed with vendor"),
+ (ORDER_ITEM_EVENT_REORDER, "marked for re-order"),
(ORDER_ITEM_EVENT_RECEIVED, "received from vendor"),
(ORDER_ITEM_EVENT_CONTACTED, "customer contacted"),
(ORDER_ITEM_EVENT_CONTACT_FAILED, "contact failed"),
diff --git a/src/sideshow/orders.py b/src/sideshow/orders.py
index 0434782..9f99e53 100644
--- a/src/sideshow/orders.py
+++ b/src/sideshow/orders.py
@@ -96,3 +96,215 @@ class OrderHandler(GenericHandler):
enum.ORDER_ITEM_STATUS_EXPIRED,
enum.ORDER_ITEM_STATUS_INACTIVE):
return 'warning'
+
+ def process_placement(self, items, user, vendor_name=None, po_number=None, note=None):
+ """
+ Process the "placement" step for the given order items.
+
+ This may eventually do something involving an *actual*
+ purchase order, or at least a minimal representation of one,
+ but for now it does not.
+
+ Instead, this will simply update each item to indicate its new
+ status. A note will be attached to indicate the vendor and/or
+ PO number, if provided.
+
+ :param items: Sequence of
+ :class:`~sideshow.db.model.orders.OrderItem` records.
+
+ :param user:
+ :class:`~wuttjamaican:wuttjamaican.db.model.auth.User`
+ performing the action.
+
+ :param vendor_name: Name of the vendor to which purchase order
+ is placed, if known.
+
+ :param po_number: Purchase order number, if known.
+
+ :param note: Optional *additional* note to be attached to each
+ order item.
+ """
+ enum = self.app.enum
+
+ placed = None
+ if vendor_name:
+ placed = f"PO {po_number or ''} for vendor {vendor_name}"
+ elif po_number:
+ placed = f"PO {po_number}"
+
+ for item in items:
+ item.add_event(enum.ORDER_ITEM_EVENT_PLACED, user, note=placed)
+ if note:
+ item.add_event(enum.ORDER_ITEM_EVENT_NOTE_ADDED, user, note=note)
+ item.status_code = enum.ORDER_ITEM_STATUS_PLACED
+
+ def process_receiving(self, items, user, vendor_name=None,
+ invoice_number=None, po_number=None, note=None):
+ """
+ Process the "receiving" step for the given order items.
+
+ This will update the status for each item, to indicate they
+ are "received".
+
+ TODO: This also should email the customer notifying their
+ items are ready for pickup etc.
+
+ :param items: Sequence of
+ :class:`~sideshow.db.model.orders.OrderItem` records.
+
+ :param user:
+ :class:`~wuttjamaican:wuttjamaican.db.model.auth.User`
+ performing the action.
+
+ :param vendor_name: Name of the vendor, if known.
+
+ :param po_number: Purchase order number, if known.
+
+ :param invoice_number: Invoice number, if known.
+
+ :param note: Optional *additional* note to be attached to each
+ order item.
+ """
+ enum = self.app.enum
+
+ received = None
+ if invoice_number and po_number and vendor_name:
+ received = f"invoice {invoice_number} (PO {po_number}) from vendor {vendor_name}"
+ elif invoice_number and vendor_name:
+ received = f"invoice {invoice_number} from vendor {vendor_name}"
+ elif po_number and vendor_name:
+ received = f"PO {po_number} from vendor {vendor_name}"
+ elif vendor_name:
+ received = f"from vendor {vendor_name}"
+
+ for item in items:
+ item.add_event(enum.ORDER_ITEM_EVENT_RECEIVED, user, note=received)
+ if note:
+ item.add_event(enum.ORDER_ITEM_EVENT_NOTE_ADDED, user, note=note)
+ item.status_code = enum.ORDER_ITEM_STATUS_RECEIVED
+
+ def process_reorder(self, items, user, note=None):
+ """
+ Process the "reorder" step for the given order items.
+
+ This will update the status for each item, to indicate they
+ are "ready" (again) for placement.
+
+ :param items: Sequence of
+ :class:`~sideshow.db.model.orders.OrderItem` records.
+
+ :param user:
+ :class:`~wuttjamaican:wuttjamaican.db.model.auth.User`
+ performing the action.
+
+ :param note: Optional *additional* note to be attached to each
+ order item.
+ """
+ enum = self.app.enum
+
+ for item in items:
+ item.add_event(enum.ORDER_ITEM_EVENT_REORDER, user)
+ if note:
+ item.add_event(enum.ORDER_ITEM_EVENT_NOTE_ADDED, user, note=note)
+ item.status_code = enum.ORDER_ITEM_STATUS_READY
+
+ def process_contact_success(self, items, user, note=None):
+ """
+ Process the "successful contact" step for the given order
+ items.
+
+ This will update the status for each item, to indicate they
+ are "contacted" and awaiting delivery.
+
+ :param items: Sequence of
+ :class:`~sideshow.db.model.orders.OrderItem` records.
+
+ :param user:
+ :class:`~wuttjamaican:wuttjamaican.db.model.auth.User`
+ performing the action.
+
+ :param note: Optional *additional* note to be attached to each
+ order item.
+ """
+ enum = self.app.enum
+
+ for item in items:
+ item.add_event(enum.ORDER_ITEM_EVENT_CONTACTED, user)
+ if note:
+ item.add_event(enum.ORDER_ITEM_EVENT_NOTE_ADDED, user, note=note)
+ item.status_code = enum.ORDER_ITEM_STATUS_CONTACTED
+
+ def process_contact_failure(self, items, user, note=None):
+ """
+ Process the "failed contact" step for the given order items.
+
+ This will update the status for each item, to indicate
+ "contact failed".
+
+ :param items: Sequence of
+ :class:`~sideshow.db.model.orders.OrderItem` records.
+
+ :param user:
+ :class:`~wuttjamaican:wuttjamaican.db.model.auth.User`
+ performing the action.
+
+ :param note: Optional *additional* note to be attached to each
+ order item.
+ """
+ enum = self.app.enum
+
+ for item in items:
+ item.add_event(enum.ORDER_ITEM_EVENT_CONTACT_FAILED, user)
+ if note:
+ item.add_event(enum.ORDER_ITEM_EVENT_NOTE_ADDED, user, note=note)
+ item.status_code = enum.ORDER_ITEM_STATUS_CONTACT_FAILED
+
+ def process_delivery(self, items, user, note=None):
+ """
+ Process the "delivery" step for the given order items.
+
+ This will update the status for each item, to indicate they
+ are "delivered".
+
+ :param items: Sequence of
+ :class:`~sideshow.db.model.orders.OrderItem` records.
+
+ :param user:
+ :class:`~wuttjamaican:wuttjamaican.db.model.auth.User`
+ performing the action.
+
+ :param note: Optional *additional* note to be attached to each
+ order item.
+ """
+ enum = self.app.enum
+
+ for item in items:
+ item.add_event(enum.ORDER_ITEM_EVENT_DELIVERED, user)
+ if note:
+ item.add_event(enum.ORDER_ITEM_EVENT_NOTE_ADDED, user, note=note)
+ item.status_code = enum.ORDER_ITEM_STATUS_DELIVERED
+
+ def process_restock(self, items, user, note=None):
+ """
+ Process the "restock" step for the given order items.
+
+ This will update the status for each item, to indicate they
+ are "restocked".
+
+ :param items: Sequence of
+ :class:`~sideshow.db.model.orders.OrderItem` records.
+
+ :param user:
+ :class:`~wuttjamaican:wuttjamaican.db.model.auth.User`
+ performing the action.
+
+ :param note: Optional *additional* note to be attached to each
+ order item.
+ """
+ enum = self.app.enum
+
+ for item in items:
+ item.add_event(enum.ORDER_ITEM_EVENT_RESTOCKED, user)
+ if note:
+ item.add_event(enum.ORDER_ITEM_EVENT_NOTE_ADDED, user, note=note)
+ item.status_code = enum.ORDER_ITEM_STATUS_RESTOCKED
diff --git a/src/sideshow/web/menus.py b/src/sideshow/web/menus.py
index c8256fc..1641c72 100644
--- a/src/sideshow/web/menus.py
+++ b/src/sideshow/web/menus.py
@@ -57,6 +57,27 @@ class SideshowMenuHandler(base.MenuHandler):
'perm': 'orders.create',
},
{'type': 'sep'},
+ {
+ 'title': "Placement",
+ 'route': 'order_items_placement',
+ 'perm': 'order_items_placement.list',
+ },
+ {
+ 'title': "Receiving",
+ 'route': 'order_items_receiving',
+ 'perm': 'order_items_receiving.list',
+ },
+ {
+ 'title': "Contact",
+ 'route': 'order_items_contact',
+ 'perm': 'order_items_contact.list',
+ },
+ {
+ 'title': "Delivery",
+ 'route': 'order_items_delivery',
+ 'perm': 'order_items_delivery.list',
+ },
+ {'type': 'sep'},
{
'title': "All Order Items",
'route': 'order_items',
diff --git a/src/sideshow/web/templates/contact/index.mako b/src/sideshow/web/templates/contact/index.mako
new file mode 100644
index 0000000..bd8e05f
--- /dev/null
+++ b/src/sideshow/web/templates/contact/index.mako
@@ -0,0 +1,159 @@
+## -*- coding: utf-8; -*-
+<%inherit file="/master/index.mako" />
+
+<%def name="render_grid_tag()">
+ % if master.has_perm('process_contact'):
+ ${grid.render_vue_tag(**{'@process-contact-success': "processContactSuccessInit", '@process-contact-failure': "processContactFailureInit"})}
+ % else:
+ ${grid.render_vue_tag()}
+ % endif
+
+
+<%def name="page_content()">
+ ${parent.page_content()}
+
+ % if master.has_perm('process_contact'):
+
+ <${b}-modal has-modal-card
+ % if request.use_oruga:
+ v-model:active="processContactSuccessShowDialog"
+ % else:
+ :active.sync="processContactSuccessShowDialog"
+ % endif
+ >
+
+ ${h.form(url(f'{route_prefix}.process_contact_success'), ref='processContactSuccessForm')}
+ ${h.csrf_token(request)}
+ ${h.hidden('item_uuids', **{':value': 'processContactSuccessUuids.join()'})}
+
+
+ Process Contact Success
+
+
+
+
+ This will mark {{ processContactSuccessUuids.length }}
+ item{{ processContactSuccessUuids.length > 1 ? 's' : '' }}
+ as being "contacted".
+
+
+
+
+
+
+
+
+ ${h.end_form()}
+
+ ${h.form(url(f'{route_prefix}.process_contact_failure'), ref='processContactFailureForm')}
+ ${h.csrf_token(request)}
+ ${h.hidden('item_uuids', **{':value': 'processContactFailureUuids.join()'})}
+
+
+ Process Contact Failure
+
+
+
+
+ This will mark {{ processContactFailureUuids.length }}
+ item{{ processContactFailureUuids.length > 1 ? 's' : '' }}
+ as being "contact failed".
+
+
+
+
+
+
+
+
+ ${h.end_form()}
+
+ ${h.form(url(f'{route_prefix}.process_delivery'), ref='processDeliveryForm')}
+ ${h.csrf_token(request)}
+ ${h.hidden('item_uuids', **{':value': 'processDeliveryUuids.join()'})}
+
+
+
+
+
+ This will mark {{ processDeliveryUuids.length }}
+ item{{ processDeliveryUuids.length > 1 ? 's' : '' }}
+ as being "delivered".
+
+
+
+
+
+
+
+
+ ${h.end_form()}
+
+ ${h.form(url(f'{route_prefix}.process_restock'), ref='processRestockForm')}
+ ${h.csrf_token(request)}
+ ${h.hidden('item_uuids', **{':value': 'processRestockUuids.join()'})}
+
+
+
+
+
+ This will mark {{ processRestockUuids.length }}
+ item{{ processRestockUuids.length > 1 ? 's' : '' }}
+ as being "restocked".
+
+
+
+
+
+
+
+
+ ${h.end_form()}
+
+ ${h.form(url(f'{route_prefix}.process_placement'), ref='processPlacementForm')}
+ ${h.csrf_token(request)}
+ ${h.hidden('item_uuids', **{':value': 'processPlacementUuids.join()'})}
+
+
+
+
+
+ This will mark {{ processPlacementUuids.length }}
+ item{{ processPlacementUuids.length > 1 ? 's' : '' }} as
+ being "placed" on order from vendor.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ ${h.end_form()}
+
+ ${h.form(url(f'{route_prefix}.process_receiving'), ref='processReceivingForm')}
+ ${h.csrf_token(request)}
+ ${h.hidden('item_uuids', **{':value': 'processReceivingUuids.join()'})}
+
+
+
+
+
+ This will mark {{ processReceivingUuids.length }}
+ item{{ processReceivingUuids.length > 1 ? 's' : '' }}
+ as being "received" from vendor.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ ${h.end_form()}
+
+ ${h.form(url(f'{route_prefix}.process_reorder'), ref='processReorderForm')}
+ ${h.csrf_token(request)}
+ ${h.hidden('item_uuids', **{':value': 'processReorderUuids.join()'})}
+
+
+
+
+
+ This will mark {{ processReorderUuids.length }}
+ item{{ processReorderUuids.length > 1 ? 's' : '' }}
+ as being "ready" for placement (again).
+
+
+
+
+
+
+
+
+ ${h.end_form()}
+