Skip to content

[IMP] Lunch: Update orders #13632

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 1 commit into
base: 18.0
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
71 changes: 33 additions & 38 deletions content/applications/hr/lunch/orders.rst
Original file line number Diff line number Diff line change
Expand Up @@ -4,8 +4,8 @@
Orders
======

When the *Lunch* application is opened, the :guilabel:`Order Your Lunch` dashboard loads. This view
is also accessed by navigating to :menuselection:`Lunch app --> My Lunch --> New Order`.
When the **Lunch** application is opened, the :guilabel:`Order Your Lunch` dashboard loads. This
view is also accessible by navigating to :menuselection:`Lunch app --> My Lunch --> New Order`.

The :guilabel:`Order Your Lunch` dashboard provides a summary of lunch offerings, the user's account
information, and the current day's orders, along with their statuses.
Expand All @@ -14,9 +14,9 @@ Order Your Lunch
================

On the main :guilabel:`Order Your Lunch` dashboard, all the necessary information needed to place an
order is visible. The default filter for the products is :guilabel:`Available Today`, which is
present in the :guilabel:`Search...` bar. This filter shows only products that can be purchased that
day, based on the :ref:`vendor's availability <lunch/availability>`.
order is visible. Enable the :guilabel:`Available Today` filter in the search bar by clicking into
the search bar and selecting :guilabel:`Available Today`. This filter shows only products that can
be purchased that day, based on the :ref:`vendor's availability <lunch/availability>`.

The left-side of the dashboard displays the various :guilabel:`Categories` of products available,
along with the :guilabel:`Vendors` supplying the products. To the right of each line is a number,
Expand All @@ -38,31 +38,31 @@ view. Each product card displays the name, cost, vendor, photo, and description
the product is configured as new, it also displays a :guilabel:`New` tag.

.. image:: orders/dashboard.png
:align: center
:alt: The *Lunch* app dashboard with all areas highlighted.
:alt: The Lunch app dashboard.

.. note::
Anywhere a vendor's name is listed in the *Lunch* app, such as on Kanban product cards, their
Anywhere a vendor's name is listed in the **Lunch** app, such as on Kanban product cards, their
phone number is listed, as well.

The products can also be displayed in a list view, by clicking the :guilabel:`≣ (four parallel
lines)` icon in the top-right corner of the dashboard.
The products can also be displayed in a list view, by clicking the :icon:`oi-view-list`
:guilabel:`(List)` icon in the top-right corner of the dashboard.

Placing orders
==============

To place a lunch order, navigate to the main :guilabel:`Order Your Lunch` dashboard, by either
opening the *Lunch* app, or by navigating to :menuselection:`Lunch app --> My Lunch --> New Order`.
opening the **Lunch** app, or by navigating to :menuselection:`Lunch app --> My Lunch --> New
Order`.

Add products to an order
------------------------

From the :guilabel:`Order Your Lunch` dashboard, click on a desired product to add to an order, and
the product appears in a :guilabel:`Configure Your Order` pop-up window.

At the top of the pop-up window is the product image, name, and price. Beneath that, there is a
potential :guilabel:`Extras` field, showcasing any :ref:`extra items or options <lunch/extras>`.
Tick the checkbox next to any desired extras present in the :guilabel:`Extras` field to add them to
At the top of the pop-up window is the product image, name, and price. Beneath that, there are
potential :guilabel:`Extras` fields, showcasing any :ref:`extra items or options <lunch/extras>`.
Tick the checkbox next to any desired extras present in the :guilabel:`Extras` fields to add them to
the order.

Each extra option is organized by a category, complete with its name and price. As extras are
Expand All @@ -77,8 +77,7 @@ When all selections for the product have been made, click the :guilabel:`Add To
lower-left of the pop-up window. To cancel the order, click the :guilabel:`Discard` button.

.. image:: orders/pizza.png
:align: center
:alt: The pop-up window for a personal pizza, with all the extras highlighted and selected.
:alt: The pop-up window for a personal pizza, with all the extras selected.

Errors
~~~~~~
Expand All @@ -102,7 +101,6 @@ changes to the :guilabel:`Configure Your Order` pop-up window.
one and only one Free Beverage with Purchase`.

.. image:: orders/error.png
:align: center
:alt: The :guilabel:`Validation Error` pop-up window with the specific error for the free
beverage displayed.

Expand All @@ -121,30 +119,30 @@ The available tags that can be displayed for each item are:
- :guilabel:`To Order`: the product has been added to the cart, but has not been purchased yet by
the user.
- :guilabel:`Ordered`: the product has been purchased by the user, and is waiting to be sent to the
vendor by a *Lunch* app manager.
- :guilabel:`Sent`: the order for the product has been sent to the vendor by a *Lunch* app manager.
vendor by a **Lunch** app manager.
- :guilabel:`Sent`: the order for the product has been sent to the vendor by a **Lunch** app
manager.
- :guilabel:`Received`: the product has been delivered by the vendor to the user's location, and has
been verified as received by a *Lunch* app manager.
been verified as received by a **Lunch** app manager.

Product quantities can be adjusted by clicking the :guilabel:`➕ (plus sign)` or :guilabel:`➖ (minus
sign)` to the left of the listed product. The product price adjusts in real-time to display the cost
for the currently selected quantity of the product.
Product quantities can be adjusted by clicking the :icon:`fa-plus` :guilabel:`(plus)` or
:icon:`fa-minus` :guilabel:`(minus)` icons to the left of the listed product. The product price
adjusts in real-time to display the cost for the currently selected quantity of the product.

The right side of the :guilabel:`Your Order` summary displays the purchasing information. The
:guilabel:`Total` amount for the entire day's lunch order is displayed. The :guilabel:`Already Paid`
field indicates how much has been paid that day towards the :guilabel:`Total` amount. The
:guilabel:`To Pay` field displays how much of the remaining :guilabel:`Total` amount must be paid,
in order to place the currently configured order.
in order to place the currently configured order.

.. image:: orders/your-order.png
:align: center
:alt: The Your Orders section of the dashboard, with the purchasing information highlighted.
:alt: The 'Your Orders' section of the dashboard, with purchasing information.

.. tip::
Users can place multiple orders throughout the day, and are not restricted to only placing one
lunch order each day. Multiple orders might need to be placed, due to users forgetting to add
items to an order, or if there are multiple meals that are available to be purchased for the
office ()not just lunch), and so on.
office (not only lunch), and so on.

Depending on the various vendors, and how the vendors and products are configured, it is possible
to order breakfast, lunch, dinner, coffee, and/or snacks.
Expand All @@ -154,9 +152,9 @@ Submit an order

To place the order, click the :guilabel:`Order Now` button on the right-side of the :guilabel:`Your
Order` summary. The user is charged the amount that is displayed in the :guilabel:`To Pay` field,
and the cost is deducted from their *Lunch* account balance.
and the cost is deducted from their **Lunch** account balance.

Once the order is placed, the tags for the items just purchased in the :guilabel:`Your Order` field
Once the order is placed, the tags for the purchased items in the :guilabel:`Your Order` field
change from orange :guilabel:`To Order` tags to red :guilabel:`Ordered` tags.

Track an order
Expand All @@ -171,16 +169,16 @@ green :guilabel:`Received` tags.
Receive an order
----------------

When orders are received at the delivery location, they are confirmed by a *Lunch* app manager, and
a notification is sent to the employee who ordered the food.
When orders are received at the delivery location, they are confirmed by a **Lunch** app manager,
and a notification is sent to the employee who ordered the food.

My Orders
=========

To view a full list of all orders placed in the *Lunch* app for the currently signed-in user,
To view a full list of all orders placed in the **Lunch** app for the currently signed-in user,
navigate to :menuselection:`Lunch app --> My Lunch --> My Order History`. This navigates to the
:guilabel:`My Orders` dashboard. The data is filtered by :guilabel:`My Orders` and grouped by
:guilabel:`Order Date: Day`, by default, both of which are located in the :guilabel:`Search...` bar.
:guilabel:`Order Date: Day`, by default, both of which are located in the search bar.

All products appear in a list view, organized by date. The list displays the :guilabel:`Order Date`,
:guilabel:`Vendor`, :guilabel:`Product`, :guilabel:`Extras`, :guilabel:`Notes`, :guilabel:`User`,
Expand All @@ -202,7 +200,6 @@ applicable. The new order appears in the list, under the current date, and the p
with money deducted from the user's account.

.. image:: orders/my-orders.png
:align: center
:alt: The list view that appears when navigating to the My Orders dashboard.

My Account
Expand All @@ -216,12 +213,10 @@ to oldest. The :guilabel:`Date`, :guilabel:`Description`, and :guilabel:`Amount`
displayed in the list.

Entries with a negative figure listed in the :guilabel:`Amount` column represent products purchased
in the *Lunch* app. These appear in a `$-XX.XX` format.
in the **Lunch** app. These appear in a `$-XX.XX` format.

Entries with a positive balance either represent funds added to the user's lunch account, or
cancelled orders that were eventually refunded to the user. These appear in a `$XX.XX` format.

.. image:: orders/my-account.png
:align: center
:alt: The My Account dashboard with the entry for adding funds to the user's lunch account
highlighted.
:alt: The 'My Account' dashboard with the entry for adding funds to the user's lunch account.
Binary file modified content/applications/hr/lunch/orders/dashboard.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified content/applications/hr/lunch/orders/my-account.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified content/applications/hr/lunch/orders/my-orders.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified content/applications/hr/lunch/orders/pizza.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified content/applications/hr/lunch/orders/your-order.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.