Table of contents

Definition

❓ Open questions

Requirements

Problem statement

Develop a system to control the use of the free refill period in a restaurant. The system should generate a QR code when a mobile order(eat-in and takeaway) is created that includes a free refill drink. This QR code will be used to track the time during which the customer can access the drink machine.

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. 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 system needs to fulfill the following requirements:

1. Generate a QR code when a mobile order with a free refill drink is created.

2. Display a sticker with the QR code in the mobile application footer for 60 minutes.

3. Show the QR code on the receipt screen for 4 hours, with 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.

By implementing this system, the restaurant can effectively manage the free refill period for mobile orders while ensuring that the new order takes precedence over the free refill display on the home screen.

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. The QR code is correctly associated with the specific mobile order and is easily scannable by the drink machine.

3. The QR code remains valid and active throughout the entire duration of the free refill period, ensuring customers can access the drink machine within that timeframe.

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

5. 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.

6. The receipt screen prominently shows the QR code associated with the mobile order for a total duration of 4 hours.

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. 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, if this new order has a QR code to display.

9. 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 footers.

10. There is no control on the platform to identify whether the restaurant has a drinks machine with a QR code reader available, just as it is not possible to identify whether the order has available drinks with refills. For this reason, the app will show a QR code whenever it receives the hash in the POS integration response.

Success metrics

🤔 Assumptions

Solution

Scenarios

Scenario 1: xxx

Design

Figma design here: [insert link]

Development

Release