Table of contents

Definition

❓ Open questions

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 and ready 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. The solution works for either pick-up or dine at restraurant and includes a free refill drink

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 (it’s going to substitute the “check order” sticker). All pages.

   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)

• Wimrest is producing the same QR code for the store machine and it will be included in the receipt (only for no mobile orders)

• 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

Replicability

Scenarios

Scenario 1: Order with free drink refill purchase completed

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

Design

Figma design here

Development

Release