Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 11 Next »

This is a template that should be used to document each feature. It’s meant to be easy, not prescriptive - change it at will!

Table of contents

Definition

Status

DISCOVERY

RBIberia Owner

RBI Owner

❓ Open questions

We need to constantly make this section empty.

Requirements

Problem statement

To avoid people taking advantage of the free drink machine present in the stores, the company is experimenting a QR code system in a limited number of stores to control the use of the free refill period in a restaurant.

A QR code is generated when a mobile order that includes a free refill drink is created and activated once the order is complete and ready to be consumed. This QR code will be used by the person that made the purchase along his experience and avoid no clients accessing the machine.

With this new approach, the company is looking for a significative reduction of usage of drinks due to the lack of control; at the same time wants to guarantee a smooth and easy experience to the customer.

Solution

Once the purchase is completed in the kitchen, the mobile application should display a sticker with the QR code in the footer for 60 minutes that provides access to the free drink machine in the store.

Additionally, the receipt screen should show the QR code for 4 hours. The extended 4-hour duration is required because there may be specific cases, such as parties or birthdays, where the restaurant configures the QR code to have a longer expiration time.

However, if there is a new order placed while the footer with the QR code for the free refill is still being displayed on the home screen, the new order footer takes priority over the free refill footer.

To summarize, the solution needs to fulfill the following requirements:

  1. Generate a QR code when a mobile order with a free refill drink is created. (sure?? completed, right??)

  2. Display a sticker with the QR code in the mobile application footer for 60 minutes, after the purchase is completed.

  3. Show the QR code on the receipt page for 4 hours, even though there is the possibility of extending the time for special cases.

  4. Prioritize the display of the new order footer over the free refill footer if a new order is placed while the free refill footer is being shown on the home screen.

From the admin perspective (Sanity), it’s important to manage a few elements to avoid future dependency on devs:

  1. Type of services can be updated (ex: in the future the curbside could be added)

  2. QR code deadline (sticker and receipt) can be edited

Acceptance criteria

  1. When a mobile order is created for either eat-in or takeaway and includes a free refill drink, a QR code is generated (???).

  2. Curbside is not included in the services where the QR code is going to be generated.

  3. The QR code is correctly associated with the specific mobile order and is easily scannable by the drink machine.

  4. The app will show a QR code whenever it receives the hash in the POS integration response.

  5. The QR code timeframe:

    1. After the purchase is prepared and completed in the kitchen, the mobile application displays a sticker with the QR code in the footer section for exactly 60 minutes.

    2. In the same time, the receipt page prominently shows the QR code associated with the mobile order for a total duration of 4 hours.

  6. The sticker containing the QR code remains consistently visible in the footer for the full 60 minutes, even if the customer navigates to different screens within the application. Only one exception needs to be considered:

    1. In the event that a new order is placed while the sticker with the QR code for the free refill is still being displayed on the home screen, the system promptly replaces the free refill footer with the new order footer, ensuring the new order takes priority;

    2. If this new order has a QR code to display, the new QR code will be shown afterwards.

  7. If a specific case arises, such as a party or birthday, where the restaurant configures an extended expiration time for the QR code, the longer expiration duration should use the receipt screen. (?!?!?!)

  8. The system provides appropriate error handling and notifications if there are any issues with generating the QR code, displaying the sticker or receipt screen, or handling conflicts between different footer.

Success metrics

N/A

🤔 Assumptions

  • The code is produced by the Wimrest software

  • Wimrest is integrated with the existing platform (TBD)

  • The correct reading of the QR code depends on the machine

  • There is no control on the platform to identify whether the restaurant has a drinks machine with a QR code reader available or not, just as it is not possible to identify whether the order has available drinks with refills.

  • So far, the integration between Wimrest and the platform does not return any information regarding the duration of the QR code

Scenarios

Note: these are high-level scenarios that must pass testing before we can release the feature. They should also be used to drive design. Note that we do not specify user interface details in these steps - that is deliberate so that we focus on the process and not on the UI since the UI can change throughout design and development.

Scenario 1: Order with free drink refill purchase completed

Steps

Expected results

Order completed with a free drink refill purchase

Sticker with the QR code is shown in homepage and other key pages

QR code is shown in the receipt page

After 60 minutes from purchase of the free drink refill

Sticker disappears

QR code is shown in the receipt page

After 240 minutes from purchase of the free drink refill

QR code is no longer visible in the receipt page

Scenario 2: New Order with a free refill is completed while the user is finishing the previous order

Steps

Expected results

New order completed with a free drink refill purchase

Replaces the free refill footer with QR code of the previous order with the “new order” footer, ensuring the new order takes priority

QR code of the previous purchase is shown in the receipt page

Once the new order with a free drink refill purchase is completed and ready to be consumed

Sticker with the QR code of the new purchase is shown in homepage and other key pages

QR code is shown in the receipt page

QR code of the previous purchase is shown in the receipt page

After 60 minutes of the new order purchase

Sticker disappears

QR code of the previous purchase and new purchase is shown in the receipt page

After 240 minutes from purchase of the free drink refill

QR code is no longer visible in the receipt page

Design

Figma design here: [insert link]

Development

Release

  • No labels