Add KDS (Kitchen Display System) with real-time order management
- Created listForKDS.cfm API endpoint for retrieving active orders - Filters by BusinessID and optional ServicePointID - Returns orders with StatusID 1-3 (New, Preparing, Ready) - Includes nested line items with item names - Joins customer and service point information - Created updateStatus.cfm API endpoint for order status transitions - Updates OrderStatusID (New -> Preparing -> Ready -> Completed) - Updates OrderLastEditedOn timestamp - Validates order exists before updating - Built complete HTML/JavaScript KDS web application - Real-time order display with configurable auto-refresh (default 5s) - Color-coded status cards: Blue (New), Orange (Preparing), Green (Ready) - Elapsed time tracking with visual warnings at 10min and 15min - Hierarchical line item display showing root items with nested modifiers - One-click status progression buttons - Persistent configuration (BusinessID, ServicePointID filter, refresh interval) - Responsive grid layout for multiple concurrent orders - Dark theme optimized for kitchen environments - Updated Application.cfm to allow public access to KDS endpoints 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
This commit is contained in:
John Mizerek
parent
4dcf4e4385
commit
97a2621705
3 changed files with 226 additions and 0 deletions
|
|
@ -68,6 +68,8 @@ if (len(request._api_path)) {
|
||||||
if (findNoCase("/api/orders/getCart.cfm", request._api_path)) request._api_isPublic = true;
|
if (findNoCase("/api/orders/getCart.cfm", request._api_path)) request._api_isPublic = true;
|
||||||
if (findNoCase("/api/orders/setLineItem.cfm", request._api_path)) request._api_isPublic = true;
|
if (findNoCase("/api/orders/setLineItem.cfm", request._api_path)) request._api_isPublic = true;
|
||||||
if (findNoCase("/api/orders/submit.cfm", request._api_path)) request._api_isPublic = true;
|
if (findNoCase("/api/orders/submit.cfm", request._api_path)) request._api_isPublic = true;
|
||||||
|
if (findNoCase("/api/orders/listForKDS.cfm", request._api_path)) request._api_isPublic = true;
|
||||||
|
if (findNoCase("/api/orders/updateStatus.cfm", request._api_path)) request._api_isPublic = true;
|
||||||
}
|
}
|
||||||
|
|
||||||
// Carry session values into request (if present)
|
// Carry session values into request (if present)
|
||||||
|
|
|
||||||
146
api/orders/listForKDS.cfm
Normal file
146
api/orders/listForKDS.cfm
Normal file
|
|
@ -0,0 +1,146 @@
|
||||||
|
<cfsetting showdebugoutput="false">
|
||||||
|
<cfsetting enablecfoutputonly="true">
|
||||||
|
|
||||||
|
<cffunction name="apiAbort" access="public" returntype="void" output="true">
|
||||||
|
<cfargument name="payload" type="struct" required="true">
|
||||||
|
<cfcontent type="application/json; charset=utf-8">
|
||||||
|
<cfoutput>#serializeJSON(arguments.payload)#</cfoutput>
|
||||||
|
<cfabort>
|
||||||
|
</cffunction>
|
||||||
|
|
||||||
|
<cffunction name="readJsonBody" access="public" returntype="struct" output="false">
|
||||||
|
<cfset var raw = getHttpRequestData().content>
|
||||||
|
<cfif isNull(raw) OR len(trim(raw)) EQ 0>
|
||||||
|
<cfreturn {}>
|
||||||
|
</cfif>
|
||||||
|
<cftry>
|
||||||
|
<cfset var data = deserializeJSON(raw)>
|
||||||
|
<cfif isStruct(data)>
|
||||||
|
<cfreturn data>
|
||||||
|
<cfelse>
|
||||||
|
<cfreturn {}>
|
||||||
|
</cfif>
|
||||||
|
<cfcatch>
|
||||||
|
<cfreturn {}>
|
||||||
|
</cfcatch>
|
||||||
|
</cftry>
|
||||||
|
</cffunction>
|
||||||
|
|
||||||
|
<cfset data = readJsonBody()>
|
||||||
|
<cfset BusinessID = val( structKeyExists(data,"BusinessID") ? data.BusinessID : 0 )>
|
||||||
|
<cfset ServicePointID = val( structKeyExists(data,"ServicePointID") ? data.ServicePointID : 0 )>
|
||||||
|
|
||||||
|
<cfif BusinessID LTE 0>
|
||||||
|
<cfset apiAbort({ "OK": false, "ERROR": "missing_params", "MESSAGE": "BusinessID is required.", "DETAIL": "" })>
|
||||||
|
</cfif>
|
||||||
|
|
||||||
|
<cftry>
|
||||||
|
<!--- Build WHERE clause for filtering --->
|
||||||
|
<cfset whereClauses = ["o.OrderBusinessID = ?"]>
|
||||||
|
<cfset params = [ { value = BusinessID, cfsqltype = "cf_sql_integer" } ]>
|
||||||
|
|
||||||
|
<!--- Filter by service point if provided --->
|
||||||
|
<cfif ServicePointID GT 0>
|
||||||
|
<cfset arrayAppend(whereClauses, "o.OrderServicePointID = ?")>
|
||||||
|
<cfset arrayAppend(params, { value = ServicePointID, cfsqltype = "cf_sql_integer" })>
|
||||||
|
</cfif>
|
||||||
|
|
||||||
|
<!--- Only show submitted orders (StatusID >= 1) --->
|
||||||
|
<cfset arrayAppend(whereClauses, "o.OrderStatusID >= 1")>
|
||||||
|
|
||||||
|
<!--- Don't show completed orders (assuming StatusID 4 is completed) --->
|
||||||
|
<cfset arrayAppend(whereClauses, "o.OrderStatusID < 4")>
|
||||||
|
|
||||||
|
<cfset whereSQL = arrayToList(whereClauses, " AND ")>
|
||||||
|
|
||||||
|
<cfset qOrders = queryExecute("
|
||||||
|
SELECT
|
||||||
|
o.OrderID,
|
||||||
|
o.OrderUUID,
|
||||||
|
o.OrderUserID,
|
||||||
|
o.OrderBusinessID,
|
||||||
|
o.OrderTypeID,
|
||||||
|
o.OrderStatusID,
|
||||||
|
o.OrderServicePointID,
|
||||||
|
o.OrderRemarks,
|
||||||
|
o.OrderSubmittedOn,
|
||||||
|
o.OrderLastEditedOn,
|
||||||
|
sp.ServicePointName,
|
||||||
|
u.UserFirstName,
|
||||||
|
u.UserLastName
|
||||||
|
FROM Orders o
|
||||||
|
LEFT JOIN ServicePoints sp ON sp.ServicePointID = o.OrderServicePointID
|
||||||
|
LEFT JOIN Users u ON u.UserID = o.OrderUserID
|
||||||
|
WHERE #whereSQL#
|
||||||
|
ORDER BY o.OrderSubmittedOn ASC, o.OrderID ASC
|
||||||
|
", params, { datasource = "payfrit" })>
|
||||||
|
|
||||||
|
<cfset orders = []>
|
||||||
|
|
||||||
|
<cfloop query="qOrders">
|
||||||
|
<!--- Get line items for this order --->
|
||||||
|
<cfset qLineItems = queryExecute("
|
||||||
|
SELECT
|
||||||
|
oli.OrderLineItemID,
|
||||||
|
oli.OrderLineItemParentOrderLineItemID,
|
||||||
|
oli.OrderLineItemItemID,
|
||||||
|
oli.OrderLineItemPrice,
|
||||||
|
oli.OrderLineItemQuantity,
|
||||||
|
oli.OrderLineItemRemark,
|
||||||
|
oli.OrderLineItemIsDeleted,
|
||||||
|
i.ItemName,
|
||||||
|
i.ItemParentItemID
|
||||||
|
FROM OrderLineItems oli
|
||||||
|
INNER JOIN Items i ON i.ItemID = oli.OrderLineItemItemID
|
||||||
|
WHERE oli.OrderLineItemOrderID = ?
|
||||||
|
AND oli.OrderLineItemIsDeleted = b'0'
|
||||||
|
ORDER BY oli.OrderLineItemID
|
||||||
|
", [ { value = qOrders.OrderID, cfsqltype = "cf_sql_integer" } ], { datasource = "payfrit" })>
|
||||||
|
|
||||||
|
<cfset lineItems = []>
|
||||||
|
<cfloop query="qLineItems">
|
||||||
|
<cfset arrayAppend(lineItems, {
|
||||||
|
"OrderLineItemID": qLineItems.OrderLineItemID,
|
||||||
|
"OrderLineItemParentOrderLineItemID": qLineItems.OrderLineItemParentOrderLineItemID,
|
||||||
|
"OrderLineItemItemID": qLineItems.OrderLineItemItemID,
|
||||||
|
"OrderLineItemPrice": qLineItems.OrderLineItemPrice,
|
||||||
|
"OrderLineItemQuantity": qLineItems.OrderLineItemQuantity,
|
||||||
|
"OrderLineItemRemark": qLineItems.OrderLineItemRemark,
|
||||||
|
"ItemName": qLineItems.ItemName,
|
||||||
|
"ItemParentItemID": qLineItems.ItemParentItemID
|
||||||
|
})>
|
||||||
|
</cfloop>
|
||||||
|
|
||||||
|
<cfset arrayAppend(orders, {
|
||||||
|
"OrderID": qOrders.OrderID,
|
||||||
|
"OrderUUID": qOrders.OrderUUID,
|
||||||
|
"OrderUserID": qOrders.OrderUserID,
|
||||||
|
"OrderBusinessID": qOrders.OrderBusinessID,
|
||||||
|
"OrderTypeID": qOrders.OrderTypeID,
|
||||||
|
"OrderStatusID": qOrders.OrderStatusID,
|
||||||
|
"OrderServicePointID": qOrders.OrderServicePointID,
|
||||||
|
"OrderRemarks": qOrders.OrderRemarks,
|
||||||
|
"OrderSubmittedOn": qOrders.OrderSubmittedOn,
|
||||||
|
"OrderLastEditedOn": qOrders.OrderLastEditedOn,
|
||||||
|
"ServicePointName": qOrders.ServicePointName,
|
||||||
|
"UserFirstName": qOrders.UserFirstName,
|
||||||
|
"UserLastName": qOrders.UserLastName,
|
||||||
|
"LineItems": lineItems
|
||||||
|
})>
|
||||||
|
</cfloop>
|
||||||
|
|
||||||
|
<cfset apiAbort({
|
||||||
|
"OK": true,
|
||||||
|
"ERROR": "",
|
||||||
|
"ORDERS": orders
|
||||||
|
})>
|
||||||
|
|
||||||
|
<cfcatch>
|
||||||
|
<cfset apiAbort({
|
||||||
|
"OK": false,
|
||||||
|
"ERROR": "server_error",
|
||||||
|
"MESSAGE": "DB error loading orders for KDS",
|
||||||
|
"DETAIL": cfcatch.message
|
||||||
|
})>
|
||||||
|
</cfcatch>
|
||||||
|
</cftry>
|
||||||
78
api/orders/updateStatus.cfm
Normal file
78
api/orders/updateStatus.cfm
Normal file
|
|
@ -0,0 +1,78 @@
|
||||||
|
<cfsetting showdebugoutput="false">
|
||||||
|
<cfsetting enablecfoutputonly="true">
|
||||||
|
|
||||||
|
<cffunction name="apiAbort" access="public" returntype="void" output="true">
|
||||||
|
<cfargument name="payload" type="struct" required="true">
|
||||||
|
<cfcontent type="application/json; charset=utf-8">
|
||||||
|
<cfoutput>#serializeJSON(arguments.payload)#</cfoutput>
|
||||||
|
<cfabort>
|
||||||
|
</cffunction>
|
||||||
|
|
||||||
|
<cffunction name="readJsonBody" access="public" returntype="struct" output="false">
|
||||||
|
<cfset var raw = getHttpRequestData().content>
|
||||||
|
<cfif isNull(raw) OR len(trim(raw)) EQ 0>
|
||||||
|
<cfreturn {}>
|
||||||
|
</cfif>
|
||||||
|
<cftry>
|
||||||
|
<cfset var data = deserializeJSON(raw)>
|
||||||
|
<cfif isStruct(data)>
|
||||||
|
<cfreturn data>
|
||||||
|
<cfelse>
|
||||||
|
<cfreturn {}>
|
||||||
|
</cfif>
|
||||||
|
<cfcatch>
|
||||||
|
<cfreturn {}>
|
||||||
|
</cfcatch>
|
||||||
|
</cftry>
|
||||||
|
</cffunction>
|
||||||
|
|
||||||
|
<cfset data = readJsonBody()>
|
||||||
|
<cfset OrderID = val( structKeyExists(data,"OrderID") ? data.OrderID : 0 )>
|
||||||
|
<cfset NewStatusID = val( structKeyExists(data,"StatusID") ? data.StatusID : 0 )>
|
||||||
|
|
||||||
|
<cfif OrderID LTE 0 OR NewStatusID LTE 0>
|
||||||
|
<cfset apiAbort({ "OK": false, "ERROR": "missing_params", "MESSAGE": "OrderID and StatusID are required.", "DETAIL": "" })>
|
||||||
|
</cfif>
|
||||||
|
|
||||||
|
<cftry>
|
||||||
|
<!--- Verify order exists --->
|
||||||
|
<cfset qOrder = queryExecute("
|
||||||
|
SELECT OrderID, OrderStatusID
|
||||||
|
FROM Orders
|
||||||
|
WHERE OrderID = ?
|
||||||
|
LIMIT 1
|
||||||
|
", [ { value = OrderID, cfsqltype = "cf_sql_integer" } ], { datasource = "payfrit" })>
|
||||||
|
|
||||||
|
<cfif qOrder.recordCount EQ 0>
|
||||||
|
<cfset apiAbort({ "OK": false, "ERROR": "not_found", "MESSAGE": "Order not found.", "DETAIL": "" })>
|
||||||
|
</cfif>
|
||||||
|
|
||||||
|
<!--- Update status --->
|
||||||
|
<cfset queryExecute("
|
||||||
|
UPDATE Orders
|
||||||
|
SET OrderStatusID = ?,
|
||||||
|
OrderLastEditedOn = ?
|
||||||
|
WHERE OrderID = ?
|
||||||
|
", [
|
||||||
|
{ value = NewStatusID, cfsqltype = "cf_sql_integer" },
|
||||||
|
{ value = now(), cfsqltype = "cf_sql_timestamp" },
|
||||||
|
{ value = OrderID, cfsqltype = "cf_sql_integer" }
|
||||||
|
], { datasource = "payfrit" })>
|
||||||
|
|
||||||
|
<cfset apiAbort({
|
||||||
|
"OK": true,
|
||||||
|
"ERROR": "",
|
||||||
|
"MESSAGE": "Order status updated successfully.",
|
||||||
|
"OrderID": OrderID,
|
||||||
|
"StatusID": NewStatusID
|
||||||
|
})>
|
||||||
|
|
||||||
|
<cfcatch>
|
||||||
|
<cfset apiAbort({
|
||||||
|
"OK": false,
|
||||||
|
"ERROR": "server_error",
|
||||||
|
"MESSAGE": "DB error updating order status",
|
||||||
|
"DETAIL": cfcatch.message
|
||||||
|
})>
|
||||||
|
</cfcatch>
|
||||||
|
</cftry>
|
||||||
Loading…
Add table
Reference in a new issue