[ADD] Lunch: placing orders doc
closes odoo/documentation#8563 Signed-off-by: Zachary Straub (zst) <zst@odoo.com>
This commit is contained in:
parent
8e1d1632d2
commit
30e76c6eb3
@ -95,6 +95,8 @@ Vendor information
|
||||
:align: center
|
||||
:alt: The top portion of the vendor form filled out.
|
||||
|
||||
.. _lunch/availability:
|
||||
|
||||
Availability
|
||||
------------
|
||||
|
||||
@ -132,6 +134,8 @@ Orders
|
||||
:align: center
|
||||
:alt: The orders section of a vendor form, with all fields filled out.
|
||||
|
||||
.. _lunch/extras:
|
||||
|
||||
Extras
|
||||
------
|
||||
|
||||
@ -148,6 +152,8 @@ default, the first type or *category* of add-ons is labeled `Extras`, the second
|
||||
appear for **every item** offered by the vendor. That means that only items which apply to
|
||||
**all** products from the vendor should be added.
|
||||
|
||||
.. _lunch/configure-extras:
|
||||
|
||||
Configure extras
|
||||
~~~~~~~~~~~~~~~~
|
||||
|
||||
@ -308,13 +314,15 @@ lunch alert form loads. Enter the following information on the form:
|
||||
|
||||
.. image:: lunch/alert.png
|
||||
:align: center
|
||||
:alt: An alert form with al the information filled out for a chat alert sent at 10:30 AM, asking
|
||||
employees to submit orders by 11:30 AM.
|
||||
:alt: An alert form with all of the information filled out for a chat alert sent at 10:30 AM,
|
||||
asking employees to submit orders by 11:30 AM.
|
||||
|
||||
.. seealso::
|
||||
- :doc:`lunch/orders`
|
||||
- :doc:`lunch/user-accounts`
|
||||
|
||||
.. toctree::
|
||||
:titlesonly:
|
||||
|
||||
lunch/orders
|
||||
lunch/user-accounts
|
||||
|
227
content/applications/hr/lunch/orders.rst
Normal file
227
content/applications/hr/lunch/orders.rst
Normal file
@ -0,0 +1,227 @@
|
||||
:show-content:
|
||||
|
||||
======
|
||||
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`.
|
||||
|
||||
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.
|
||||
|
||||
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>`.
|
||||
|
||||
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,
|
||||
which indicates how many products are associated with that respective category or vendor.
|
||||
|
||||
To filter the products by categories or vendors, tick the checkbox next to the desired category or
|
||||
vendor to only view items related to those selections. Multiple selections can be made in each
|
||||
section.
|
||||
|
||||
.. note::
|
||||
If multiple selections are made, **only** products that fall under **all** the selected options
|
||||
are shown.
|
||||
|
||||
The top portion of the dashboard, which serves as an order summary, displays the user's account
|
||||
information, and the order details for today, if any orders have been placed.
|
||||
|
||||
The main section, beneath the user's information, displays all the products in a default Kanban
|
||||
view. Each product card displays the name, cost, vendor, photo, and description of the product. If
|
||||
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.
|
||||
|
||||
.. note::
|
||||
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.
|
||||
|
||||
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`.
|
||||
|
||||
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
|
||||
the order.
|
||||
|
||||
Each extra option is organized by a category, complete with its name and price. As extras are
|
||||
selected, the displayed price at the top of the pop-up window updates to reflect all current
|
||||
selections.
|
||||
|
||||
Beneath the :guilabel:`Extras` field is the :guilabel:`Description` of the product, followed by a
|
||||
:guilabel:`Notes` field. The :guilabel:`Notes` field is used to enter any vital information, which
|
||||
is then sent to the vendor regarding the order, such as any special requests or food allergies.
|
||||
|
||||
When all selections for the product have been made, click the :guilabel:`Add To Cart` button in the
|
||||
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.
|
||||
|
||||
Errors
|
||||
~~~~~~
|
||||
|
||||
Depending on how the various :ref:`extras <lunch/configure-extras>` are configured for a vendor, it
|
||||
is possible to receive an error when attempting to add products to the cart.
|
||||
|
||||
An error can occur when a configured product **requires** the user to select an option in the
|
||||
:guilabel:`Extras` field, but the user neglects to make one.
|
||||
|
||||
When this occurs, a :guilabel:`Validation Error` pop-up window appears. The error is briefly
|
||||
explained in the pop-up window. Click :guilabel:`Close` to close the window, and make any necessary
|
||||
changes to the :guilabel:`Configure Your Order` pop-up window.
|
||||
|
||||
.. example::
|
||||
The vendor, The Pizza Palace, provides a free beverage with any purchase. Their products are
|
||||
configured so that a beverage selection is **required** in the :guilabel:`Extras` field *before*
|
||||
adding one of their products to the cart.
|
||||
|
||||
If a selection is **not** made, an error occurs. The message that appears is `You have to order
|
||||
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.
|
||||
|
||||
Your Order summary
|
||||
------------------
|
||||
|
||||
When at least one item is added to an order, the items appear at the top of the dashboard in the
|
||||
:guilabel:`Your Order` summary. In addition to the products, users can view the account information,
|
||||
in addition to all the information related to orders placed during the current calendar day.
|
||||
|
||||
As products are added to an order, they appear at the top center of the summary box. Each product is
|
||||
listed beneath the words :guilabel:`Your Order`, with the product name, quantity, and a status tag.
|
||||
|
||||
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.
|
||||
- :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.
|
||||
|
||||
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.
|
||||
|
||||
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.
|
||||
|
||||
.. image:: orders/your-order.png
|
||||
:align: center
|
||||
:alt: The Your Orders section of the dashboard, with the purchasing information highlighted.
|
||||
|
||||
.. 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.
|
||||
|
||||
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.
|
||||
|
||||
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.
|
||||
|
||||
Once the order is placed, the tags for the items just purchased in the :guilabel:`Your Order` field
|
||||
change from orange :guilabel:`To Order` tags to red :guilabel:`Ordered` tags.
|
||||
|
||||
Track an order
|
||||
--------------
|
||||
|
||||
When orders have been sent to the vendors, the tags for the items in the :guilabel:`Your Order`
|
||||
summary change from red :guilabel:`Ordered` tags to blue :guilabel:`Sent` tags.
|
||||
|
||||
Once orders have been received and verified, the tags change from blue :guilabel:`Sent` tags to
|
||||
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.
|
||||
|
||||
My Orders
|
||||
=========
|
||||
|
||||
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.
|
||||
|
||||
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`,
|
||||
:guilabel:`Lunch Location`, :guilabel:`Price`, and :guilabel:`Status` information. If in a
|
||||
multi-company database, a :guilabel:`Company` column also appears.
|
||||
|
||||
The total cost for each order is displayed on the line containing the order date. At the bottom of
|
||||
the list, beneath all the lines, the overall total amount paid for all the orders appears, under the
|
||||
:guilabel:`Price` column.
|
||||
|
||||
At the end of each product line with a status of :guilabel:`Ordered` or :guilabel:`Sent`, an
|
||||
:guilabel:`X Cancel` button appears. Click :guilabel:`X Cancel` to cancel that product order. Once a
|
||||
product order has been canceled, the money paid for that product is refunded, and appears in the
|
||||
user's account.
|
||||
|
||||
At the end of each product line with a status of :guilabel:`Received`, a :guilabel:`Re-order` button
|
||||
appears. Click :guilabel:`Re-order` to instantly reorder that same product, with the same extras, if
|
||||
applicable. The new order appears in the list, under the current date, and the product is paid for,
|
||||
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
|
||||
==========
|
||||
|
||||
To view a summary of all transactions in the user's account, navigate to :menuselection:`Lunch app
|
||||
--> My Lunch --> My Account History`. Doing so reveals the :guilabel:`My Account` dashboard.
|
||||
|
||||
The default presentation of the :guilabel:`My Account` dashboard displays all entries, from newest
|
||||
to oldest. The :guilabel:`Date`, :guilabel:`Description`, and :guilabel:`Amount` are the only fields
|
||||
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.
|
||||
|
||||
Entries with a positive balance either represent funds added to the user's lunch account, or
|
||||
canceled 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.
|
BIN
content/applications/hr/lunch/orders/dashboard.png
Normal file
BIN
content/applications/hr/lunch/orders/dashboard.png
Normal file
Binary file not shown.
After Width: | Height: | Size: 52 KiB |
BIN
content/applications/hr/lunch/orders/error.png
Normal file
BIN
content/applications/hr/lunch/orders/error.png
Normal file
Binary file not shown.
After Width: | Height: | Size: 9.0 KiB |
BIN
content/applications/hr/lunch/orders/my-account.png
Normal file
BIN
content/applications/hr/lunch/orders/my-account.png
Normal file
Binary file not shown.
After Width: | Height: | Size: 21 KiB |
BIN
content/applications/hr/lunch/orders/my-orders.png
Normal file
BIN
content/applications/hr/lunch/orders/my-orders.png
Normal file
Binary file not shown.
After Width: | Height: | Size: 42 KiB |
BIN
content/applications/hr/lunch/orders/pizza.png
Normal file
BIN
content/applications/hr/lunch/orders/pizza.png
Normal file
Binary file not shown.
After Width: | Height: | Size: 40 KiB |
BIN
content/applications/hr/lunch/orders/your-order.png
Normal file
BIN
content/applications/hr/lunch/orders/your-order.png
Normal file
Binary file not shown.
After Width: | Height: | Size: 16 KiB |
Loading…
Reference in New Issue
Block a user