Overview


Aura’s Kitchen Items application has been re-introduced as a web service application, with updates that improve speed and better assist stores with complex production lines that have more than one step.

Kitchen Items now runs as a service on the server computer, which will be responsible for polling the database and letting the monitors know when any changes are detected. 

The interface is served through a browser running on lightweight kitchen hardware. 

By replacing the client side application with a web-page hosted by the service we reduce the load on the kitchen screens and allow better compatibility as every operating system has a browser.

The web service is installed alongside the existing application rather than replacing outright, allowing stores who are used to the existing system to upgrade without issue.



Installation


Server

The service is released to a store via the Aura Updater, and will self-install. The service is installed as BackofficeSvc.exe , which if installed correctly can be found in the server’s Task Manager and Services.msc list.


You will also need to install the Aura Print Services on the Server. 

Please follow the below link on how to install Aura Print Service for Kitchen Workflow Manager

Click here to access the Solutions page on how to install Aura Print Service


Raspberry Pi/Linux

Kitchen Items & Customer Display interface will run on a Raspberry Pi connected to a screen in the kitchen and at the counter. When the Raspberry Pi starts up, it will go to the desktop. Right-click the desktop to get an options menu.



To launch the browser, select Launch Application from the drop down menu. If you do not have a mouse connected to the kitchen display that is controlled with a numeric keypad, you can also launch the application by

pressing the + button on the numpad and on the Customer Display connect to the Display using RealVNC / Anydesk or Teamviewer.


The Raspberry Pi should also be configured to launch the browser automatically when it is booted.


Aside from the menu, these other commands are available:

  • Press + on Numpad to Open Application.

  • Press - on Numpad to Close Application.

  • Press / on Numpad to Reboot Computer.


The browser being used is Chromium and it will always open in kiosk mode with the URL of the website pre-selected. The user will not necessarily know that he is interacting with a website because it looks and behaves like a normal application. The user cannot open more tabs or access any other websites other than the one that is pre-configured in the settings.


Setting the Pi to launch Kitchen Items:

(This will be done in-house at before the Installation will be done in the Store)


Step 1: Right-click the desktop and select Terminal.

Step 2: In the Terminal type sudo nano /home/aurauser/Desktop/ApplicationPrimary.sh and press Enter  (Linux is case-sensitive).



Step 3: This will launch the ApplicationPrimary.sh script in the Nano text-editing program within the terminal. ApplicationPrimary.sh is the file that is run when the user presses the + button on the numpad or when the user right clicks and selects Launch Application from the menu on the desktop.



Step 4: The # will nullify the line following it. Put a # in front of the Deliveree line, and make sure that there isn’t one in front of the Kitchen Items line.



Step 5: Make sure to set the IP address of the server correctly with the port of :3004 so that the Pi can access the Backoffice service properly.

Step 6: Press Ctrl-X to exit. It will prompt you to save your changes. Press Y  then Enter to accept.



Editing the auto-run configurations:


If you want to run the Application.sh script automatically when the computer is booted up, you can edit the auto-start script to run the Application.sh script.


Step 1: From the right-click menu, select Terminal. A terminal window will open.

Step 2:Type in sudo nano /etc/xdg/openbox/autostart and press Enter (Linux is case sensitive).



Step 3: This will launch the auto start script in the Nano text-editing program within the terminal.


  1. The last line is the command to run the Application.sh file, which contains the instruction to launch Chromium in kiosk mode with the URL.

  1. You can use a # symbol to comment out a line. To stop auto-running Chromium on launch, put a # in front of the last line.

  1. Press Ctrl-X to exit. It will prompt you to save your changes. Press Y  then Enter to accept.


Configuring Queues

(This will be done in-store)


Before you can use Kitchen Items, you will need to configure a Queue. To configure queues, go to http://localhost:3004/settings/kitchenitems/makeline/manage-queues on the SERVER’s browser.



On this screen you can create Store Queues. A queue is a particular set of conditions that have to be met and steps that Kitchen Items follows during the preparation process.

Click Create Queue to begin.

Enter a queue name. 

Each queue must have a name describing its function (i.e Steers, Debonairs, Drive Thru, etc).




Below the name you will see a list of possible Filters which will determine which orders show:

  • Shift ID - Only show orders from a specific shift.

  • Transaction Type -  Only show orders of a particular type: counter; collect; delivery or table.

  • Production Printer - Only show items assigned to a particular printer.

  • Till ID - Only show items from a specific Till ID.

  • Department - Only show items from a particular department.


NB: Multiple of each of the above can be selected.


Then queue Settings:

  • From Step - This describes which workflow steps must be completed before an order is eligible to be claimed into this step, including orders from other queues.

  • Skip If No Match - If this is set to Yes then any order which is eligible to be claimed because it has completed the required steps but fails the filter checks will be instantly completed by any client subscribed to that step.

  • Actions On Claim - A list of actions to be performed by the server when an invoice is claimed.



  • Actions On Complete - A list of actions to be performed by the server when an invoice is completed.


 




As above, multiple options may be selected for each here. 


NB: Click Save to save the queue after making any changes.


Configuring Devices

Once the queues has been setup you will need to configure the devices where the queues will be displayed:

This can be done by going to Kitchen then Device Settings.



Here you will find a list of all the Devices:



Each device is assigned an ID. Its computer name and IP address is displayed along with a drop-down containing all current till IDs.

Once a till ID is selected the Queue Settings , Customer Display Settings and Remove Device buttons will become accessible which will allow you to configure the Kitchen Display interface.


First select Queue Settings.



The most important setting here is Selected Queue which must be set in order to use the interface. Click the drop-down to choose which of the queues you’ve created will be displayed.

Number of Columns will set the number of columns displayed in the kitchen items interface(default is 5).

Enable Pending Items will set the queue to use Pending Items so as soon as the order is being rung up on the Till the items will start displaying on the Kitchen Item interface.

Print At Till will default to the computer running the service if not specified.

Enable Automatic Claiming will set the queue to use Automatic Claiming.


Once you have set up the Queue Settings you should click on Update Settings then go back to device to start with the Customer Display Settings.

Before selecting Customer Display Settings you will need to set up your Customer Display, follow the below steps to setup your Customer Display.


Step 1: Click on Kitchen then select Manage Customer Displays



Step 2: Click on Create Display.



Step 3: Add the display information.



  • Name - What would you like to call the Display
  • Expected Wait Time - What is the expected waiting time you want to display to the customer 


NB:

Debonairs : 12 min (As per Famous Brands)

Steers: 4 min (As per Famous Brands)


Filters:

  • Has Been In Queue will set the queue that will display the menu items to the Customer Display.
  • Transaction Type will set which transactions are displayed on the Customer Display.
  • Till ID will set which till will display on the Customer Display.
  • Department will set the Department that needs to display on the Customer Display.


Style Sheets:


This is setup using the Kitchen Items Rework and different stores require using different .CSS Style Sheets to setup the customer display screens as each brand is unique.

All Style Sheets for all brands are automatically downloaded and installed into the C:\Program Files (x86)\Alphapos\Aura folder under a folder called assets.



Style Sheets needs the correct path of the main.css Style Sheets for the selected brand.

For example if this was a Debonairs the Style Sheet will look like below:


\assets\debonairs\main.css


NB: Always use a Backslash "\"


Once you are done with creating the Display you should always click Save.


Now the Customer display then needs to be assigned to the correct device from the Device Settings.



Now you will need to select Customer Display Settings next to the device that will be using the Customer Display interface.



Here you will need to select the Display that you have created.



You can also set the Minutes until order Hidden as it is on 5 min by default. Once done click Update Settings.

To test if you have setup all the settings correctly you can go to the Kitchen menu and select:


Rework to view the Kitchen Display.

Customer Display to view the Customer Display.



If you have missed any steps or settings the page will re-load to the settings page where are step has been missed. Once you have tested and they are working you can now load the Kitchen Display on the screens in the Kitchen and the Customer Display on the Display at the Counters.


Note: If the customer display is only showing "Connecting" you need to check the Windows licence and make sure it is a licensed version. If Windows is not licensed it will not display.!

Using The New Interface


Kitchen Items:



Orders will wrap to the next column if they are too long to fit the current one, and will be highlighted in red once they exceed their Minutes Until Late time as set in Queue settings.

The controls are very similar to the Kitchen Items standalone application. Keyboard shortcuts exist for numeric keypads and buttons for touch screen users. In addition to the normal controls you can double click / tap an order to complete it.


Invoices have the following information:


Kitchen Items Description.png 


  • Header Left - Order Number / Invoice Number.

  • Header Right - Minutes since order was rung up.

  • Center - Quantity, size and description of menu items.

  • Footer Left - Till ID where the order was created.

  • Footer Right - Name of cashier who created the order.


Additionally any invoice notes applied will display as a line item underneath the header, prefixed with “Note: “. 

Any item notes applied will appear where they were inserted with the same prefix. If an order is not a counter order then the transaction type will be displayed before the order number


Customer Display:



  • Expected Wait Times - Minutes a customer would need to wait for their orders.
  • Waiting / Preparing - Order numbers that are currently being made.
  • Ready - Orders that are ready for customers to collect.