Introduction

The goals of this loyalty program are as follows:

● Promote local commerce.
● Increase the number of customers for a business.
● Build customer loyalty by making them feel special.

We've created a web application that uses QR codes to manage a rewards system. Users can
earn 'coins' and enjoy special privileges at a business. They can also use these coins to pay for
select items or services. These 'coins' act as a custom currency exclusive to this business.

How it works
For each business, a virtual currency is defined with a name. In the case of the test business I
have for demonstration, an Ice Cream shop, the currency is called SCOOP.

Each business must define a list of privileges, something that customers want to have, that
makes them feel special and that they can always enjoy. The idea of a privilege is that it lasts
forever. For example, every time I go to a perfumery and buy something, because of who I am,
they will give me a free perfume sample.

Privileges are earned when you reach a number of coins and visits (times you have gone and
consumed at the business). Let's see it with an example: suppose a privilege is obtained when I
get 20 SCOOP (for simplicity, we imagine that for every euro spent I receive one SCOOP) and 5
visits. The privilege will be automatically granted when I have consumed 5 times independently
a total equal to or greater than 20€ (for each consumption I receive a QR code equivalent to as
many SCOOP as euros spent. As I scan them, they accumulate).

The process that a user/customer follows is as follows:

● The customer consumes at the business as usual.
● The business gives them a QR code equivalent to X virtual coins (proportional to what
the customer has spent).
● The customer scans the code and accesses a website where they redeem the coins and
see the list of privileges of the business and if they have any of them.
● When the customer returns to consume, they can show that web page - where their
privileges are displayed - and claim some of them.
● If the business allows it, the customer can buy certain items from the business with the
virtual currency.

We have special privileges, called “badges” that are used when a business has several
locations. Every location has its own badge and to collect them you have to purchase something
in each location.

There is also a "Recommendations" section that each business can decide whether to enable or
not. If it is enabled, a special QR code appears in the application that you can give to someone
to scan, recording that you have recommended that business. If that someone goes to the
business, consumes and scans the QR code they are given with the X SCOOP, they will receive
extra coins for having followed the recommendation and the recommender will automatically
receive extra coins as well.

Considerations
● Each business has its own currency and privileges.
● The privileges you have at one business do not apply to others.
● If a business has several stores (chain), it can use the same currency in all of them, and
there you could indeed make your privileges valid at different "branches".
● The QR codes that give you coins are unique and can only be scanned once (those I
give in the other document are special and can be scanned multiple times, because they
are for demonstration).
● No need to download any application from the AppStore (Apple) or PlayStore (Android),
everything is done from a web page/application.
● From the web application, you can also see a list of affiliated businesses.
● The same application works for all businesses. Users only have to register once.

General requirements
● I want to have clean and easy to use application
● I want to have a small style guide with
○ The colors used in the application in “day mode”
○ The colors used in the application in “night mode”
○ The set of fonts
○ The basic definition of the visual elements used: titles, text, tables, warnings,
popover, buttons, links…
● I want to have a multilingual application (mockups and designs will be in English but the
application will be translated to multiple languages)
● I want to have all the designs in Figma. Just light mode for mobile is needed.
● Nothing written in this document is set in stone. Any change, improvement or comment
is well appreciated.

Login
Context
This is the initial point of the users where they can access the web application. Initially only
email and MetaMask access is allowed. In the future, we can allow access with Google,
Microsoft and Apple but there is no need now.
MetaMask is a cryptowallet that you can install in your browser as an extension or use its own
mobile app that has a browser integrated.
99% of the users will use Email.
Requirements
● I want to be able to create an account with email and password
● I want to be able to login with email and password
● I want to be able to login with MetaMask
● I want to the Email register is more relevant than MetaMask
● I want to be able to reset my password using the email if I forgot it

Welcome Screen
Context
Users will access this loyalty program, probably scanning a QR code, either to see their
privileges in a certain Shop/Brand (from various types of advertisements, such as posters, small
table signs, or Instagram ads) or to claim some tokens/virtual coins they have earned after
purchasing. In both scenarios, if the customer is not registered, we want to show them a simple
web with basic information about the program before redirecting them to the sign up / login

Requirements
● I want to be see a page with basic information about the program
● I want to see a title with the name of the brand
● I want to see a few paragraphs with information about the loyalty program
● I want to be able to go to the Login/SignUp section

Shop/Brands list
Context
Users can access the whole list of shops that are currently using this loyalty program. The
loyalty program will be global so it is needed to filter, search and order properly a potential big
number of shops (hundreds)
Although in the requirements I add some basic information, I’m open to show more or less
depending on the UI and moving the whole information to the Shop details section.

Requirements
● I want to see a list of Shops/Brands using the program (name, description, category,
address…)
● I want to be able to filter the shops
● I want to be able to search the shops
● I want to be able to sort the Shops
 ● I want to be able to access to the details of a Shop
● I want to be able to access to the privileges of the Shop
○ I want this is the most relevant link
● I want to have access to the main menu / other sections of the application

Shop/Brands detail
Context
This section shows the details of certain brand, including multiple location if it has

Requirements
● I want to see the detail of a Shop: name, logo, category, address, website, link to social
networks, link to Google Maps, description, different locations (in case it has more than
one)
● I want to be able to access to the list of privileges
● I want to be able to come back to the list of the Shops section

Shop privileges
Context
This section is the main and most important of the whole application. Is where the user will be
redirected after scanning a QR code to earn virtual coins or a QR that will be in each shop to
access the list of the available privileges and the ones that are already granted for the user.

Requirements
● I want to see the brand name & logo of the Shop
● I want to see the number of virtual coins I have
● I want to see the number of visits I have
● I want to be able to reload the number of visits and virtual coins (as the value is obtained
from blockchain, sometimes it takes until one minute to be available the new values after
scanning a code to earn additional coins)
● I want to see my privileges
● I want to see what I need in order to reach the next privilege
● I want to have three types of privileges: forever, badges, one-use
○ Forever privileges can be used as many times as the user wants (with some time
restriction that the shop owner can indicate)
■ I want to see a list of all existing privileges
● I want to see the privilegeId
● I want to see the privilege name
 ● I want to see the conditions needed to get automatically the
privilege
● If the privilege is limited for the first X users that reach it, I want to
see that limit (X) and the free slots (available for new users)
● I want to see, if needed, a short information about the privilege or
the limitation (as a tooltip)
■ I want to see clearly which privileges I have and which I haven’t
■ I want to be able to claim a privilege I have
● I want to see a confirmation with the name of the privilege and
options Yes/No
● In case I cannot claim the privilege (because I have to wait some
time) I want to see the name of the privilege and a message
indicating the time you should wait before claiming the privilege.
● In case I claimed the privilege I want to see a message indicating
if the claim was successful or not (verification will take some
seconds)
○ Badges privileges are for shops with multiple locations and are granted when you
visit a certain shop location a certain number of times. i.e. We can have three
badges per location: first is granted on the first visit, second with 10 visits and
third with 50 visits.
■ I want to see the badge
■ I want to see the location related with the badge
■ I want to see the number of visits I need to have to earn the badge
■ I want to see a tooltip in the badge in order to have extra information
about, if needed.
○ One-use privileges are special privileges that disappear after using/redeem them.
You can have several of the same kind
■ I want to see a list of privileges the user has
● I want to see the name
● I want to see the amount I have
■ I want to be able to redeem the privilege
● When redeeming I want to see a popover for confirmation
● After redeem I want to see a confirmation if the redeem was ok or
not
● I want to see a list items I can buy with the virtual coins
○ I want to see the name
○ I want to see the cost (in virtual coins)
○ I want to be able to purchase an item
■ I want to see a confirmation: Yes/No
■ I want to see the result of the purchase (OK / KO)
● I want to be able to recommend a shop (this will open a new section)
● I want to see the account id of the user
● I want to have access to a help section
● I want to have access to the main menu / other sections of the application
Redeem tokens
Context
This will be the second more used section, the place where the customer access after scanning
a reward QR code.

Requirements
● I want to see the name and logo of the shop
● I want to see an informative text about what is going to happen (earn some coins)
● I want to be able to claim my coins
● I want to show a message with the result of the claim: OK, KO
● I want to show a message if the code has been already used
● I want to see some extra text if additional to the code I’ll be earning additional coins due
to a recommendation.

Recommendations
Context
This section show the list of shops I recommended and the list of recommendations that have
been done to me

Requirements
● I want to see a list of the recommendations I’ve done
○ I want to see when I did the recommendation
○ I want to see the Shop I recommended
○ I want to see the status of the recommendation: Redeem, Pending, Expired
● I want to see a list of recommendations I’ve received
○ I want to see when I was recommended
○ I want to see the Shop I was recommended
○ I want to see the status of the recommendation: Redeem, Pending, Expired
■ In case of Pending I want to see the date when it will expire
● I want to have access to the main menu / other sections of the application
Shop recommendation
Context
A user can recommend a Shop sharing with other user a QR code or URL. If the user
recommended goes to the shop, makes a purchase and scans the code, both users will have an
extra reward of X and Y coins respectively.

Requirements
● I want to see the brand I’m rcommending
● I want to see a text explaining how the recommendations works
● I want to see the amount of coins I will win if the user I recommend purchases (and scan
the QR code) in the recommended Shop
● I want to see the amount of coins the user I recommend will earn after purchasing (and
scanning the QR code).
● I want to be able to come back to the list of privileges of the shop.

User profile
Context
Personal data of the user

Requirements
● I want to see the name of the user
● I want to be able to update the name of the user
● I want to see the email of the user
● I want to see the language of the user
● I want to be able to change the language of the user
● I want to see the accountid of the user

Shop Help
Context
Every shop will have a help section explaining how the loyalty program works.

Requirements
● I want to see the help of the programa for that shop
 ○ I want to have several paragraphs, titles, links…

Current MVP
You can access to the current application here: [Link]
You can ask for tokens/virtual coins with these other links:
● Schelato: [Link]
9844978acf3e
● Doggy: [Link]