👋 Welcome to Staff App
Staff App is the application for employees of Premium.Coffee network coffeehouses.
Use it to award Coffee Points to visitors and process reward redemptions.
📌 Important: You have a separate login and password to access the app.
Do not share your credentials with anyone else.
📌 First Steps
1
Use your personal login and password provided by the coffeehouse manager.
2
Understand the basic rule
1 scan = 1 Coffee Point. Each successful scan awards 1 point to the visitor. No need to enter amounts — just scan.
3
Only after real purchase
Award points ONLY after a completed purchase. Do not scan without an order — this violates program rules.
📷 1. Awarding Points by Scanning
main method
1
Open the application
Log in to the Staff App on the coffeehouse tablet or smartphone.
2
Select "Scan QR Code"
On the main screen, tap Scan QR Code.
3
Scan the visitor's QR code
Point the camera at the QR code from the visitor's phone.
Make sure the code is well-lit and not damaged.
4
Confirm the award
The system will automatically award 1 Coffee Point to the visitor's card.
A message will appear: "+1 Coffee Point awarded".
5
Tell the visitor
Say to the guest: "Point added!"
📌 Important: Only award points after a real purchase.
Do not scan codes without an order — this violates the program rules.
✏️ 2. Manual Entry
backup method
1
When to use
• QR code won't scan (dirty screen, damaged code, camera issues).
• Visitor doesn't have their phone (forgot or battery died).
• Visitor hasn't activated their card yet but wants to earn points.
• Visitor doesn't have their phone (forgot or battery died).
• Visitor hasn't activated their card yet but wants to earn points.
2
Open "Manual Entry"
In the app, tap Manual Entry.
3
Enter the visitor's information
Ask the visitor for their email or user ID (printed under their QR code).
Enter this information in the appropriate field.
Enter this information in the appropriate field.
4
Confirm the award
Tap Award Points. The system will award 1 Coffee Point to the visitor's card.
📌 Important: Always double-check the email or ID to ensure points go to the correct visitor.
🎁 3. Processing Redemptions
reward exchange
1
Visitor wants to redeem points
Visitor says: "I want to redeem my points for a reward".
Ask which reward they want ($COFFEE or BTC depending on their card type).
2
Open "Process Redemptions"
In the app, tap Process Redemptions.
3
Scan the QR code
Scan the visitor's QR code. The system will show:
• Current point balance.
• Available rewards (Loyalty Card: $COFFEE; Stamp Card: BTC).
4
Select reward and confirm
Select the reward the visitor wants and tap Confirm.
Points will be deducted automatically.
5
Nothing to hand out
The reward ($COFFEE or BTC) will be sent automatically to the visitor's crypto wallet.
You don't need to give out physical items or vouchers.
6
Wish them a good day
Smile and say: "Reward sent! Thank you for being with us!"
📌 Important: When redeeming a Stamp Card, the card automatically resets to 0.
The visitor can immediately start collecting 10 points again.
📜 4. Viewing History
1
When needed
• Visitor asks: "How many points do I have?"
• Visitor says: "My points weren't added last time"
• Need to check when the last activity occurred.
• Visitor says: "My points weren't added last time"
• Need to check when the last activity occurred.
2
Open "Viewing History"
In the app, tap Viewing History.
3
Scan QR code or enter information
Scan the visitor's QR code, or enter their email or ID manually.
4
View the information
The system will show:
• Current point balance.
• Dates and times of awards.
• Reward redemption history.
📌 Tip: If a visitor claims points weren't awarded, check the history together.
If there's an error, notify your manager — only they can void or adjust transactions.
🔢 5. Redemption Codes
1
When to use codes
• Visitor doesn't have their phone or battery is dead.
• QR code won't scan and manual entry isn't possible (visitor doesn't know email).
• Phone orders or delivery.
• QR code won't scan and manual entry isn't possible (visitor doesn't know email).
• Phone orders or delivery.
2
Generate a code
In the app, tap Generate Code.
The system will show a 4-digit code, for example: 0754
3
Give the code to the visitor
Tell the visitor the code. They can enter it later in the Enter Code section of their account.
Points will be awarded after the code is entered.
📌 Important: Codes have a limited validity period (usually a few days).
Visitors should enter their code as soon as possible.
⚠️ 6. Common Issues and Solutions
❓
"Not eligible"
Cause: Purchase amount below minimum, daily limit exceeded, or visitor's card expired.
Solution: Politely explain the reason to the visitor. Check program conditions with your manager.
Solution: Politely explain the reason to the visitor. Check program conditions with your manager.
❓
QR code won't scan
Cause: Dirty screen, glare, damaged code, poor lighting.
Solution: Ask the visitor to increase screen brightness, wipe the camera lens, try moving closer or farther. If it still doesn't work — use manual entry or a redemption code.
Solution: Ask the visitor to increase screen brightness, wipe the camera lens, try moving closer or farther. If it still doesn't work — use manual entry or a redemption code.
❓
Visitor says points weren't awarded
Solution: Check the visitor's history through Viewing History.
If points are indeed missing, notify your manager.
Only the manager can void or adjust transactions.
❓
"Card expired" error
Cause: The visitor's card has passed its expiration date.
Solution: The visitor cannot earn new points but may redeem remaining ones. Suggest adding a new card if the program is still active.
Solution: The visitor cannot earn new points but may redeem remaining ones. Suggest adding a new card if the program is still active.