🐞 Reporting Bugs & Issues (Order Management App Shakebug Functionality)

ℹ️ Overview
This guide explains how to report bugs, issues, and suggestions using the Order Management App.

---

🎯 Goals

🐞 Reporting a Bug or Issue

Use this when something unexpected happens, such as:

• 📶 Network failures
• ⚠️ Error messages
• ❌ Features not working as expected

---

💡 Reporting a Suggestion

Use this when you want to:

• Suggest improvements to the app
• Request new features
• Propose changes to improve efficiency

⚠️ Important Notes

• These features are only available if enabled by your store contact
• If unsure, please contact your store contact

💥 Crashes

ℹ️ Note
App crashes are reported automatically through a separate system

👉 No action is required from users

---

🧭 Step 1: Check if Bug Reporting is Enabled

• Bug reporting must be enabled to use this feature
• This can be checked in the app’s Settings screen

📱 How to Check

• Navigate to the app’s Settings
• Look for the Is Bug reporting enabled? option as shown below

❌ If Not Enabled

• Contact your store contact to enable the feature

🧭 Step 2: How to Start Bug Reporting

---

🐞 Reporting a Bug or Issue
When you experience a bug or issue, it is important to act immediately and not navigate away from the screen.

---

📱 Trigger the Bug Reporting Tool

• Shake your device to activate the bug reporting feature

⚙️ What Happens Next?

• The app will recognise the shake
• The Bug Reporting screen will appear automatically

⚠️ Important Notes

• You may need to shake the device firmly
  • The sensitivity is set high to avoid accidental triggers
• Do not move away from the issue before reporting
  • This ensures accurate capture of the problem

🧭 Step 3: How to Report a Bug or Issue

---

🐞 Complete the Bug Report
Once the Bug Reporting screen appears, fill in the required details to help the team investigate the issue effectively.

---

📝 Required Information

• 🏷️ Title
  • Enter a short, clear description of the issue
  • Examples:
    • “Bug when searching for an item”
    • “Driver details missing from screen”
    • “Error message when updating order”
• 📧 Email Address
  • Enter a contact email for your store
  • This will be used if:
    • More information is needed
    • The team provides updates or confirms a fix

📎 Attachments & Logs

• 📤 Enable Uploads (Highly Recommended)
  • Includes device logs up to that moment
  • Helps diagnose the issue faster
• 📸 Optional Attachments
  • Add:
    • Screenshots
    • Screen recordings
  • Useful for showing exactly what happened

🧠 Best Practice Tips

💡 Keep titles clear and specific
💡 Always include logs (Uploads) where possible
💡 Add screenshots for visual issues
💡 Report issues immediately for accuracy

🧭 Step 4: What Happens Next?

---

🐞 After Submitting a Bug Report
Once a bug or issue has been reported, the Snappy Shopper Engineering Team will review and triage the report.

---

🔍 What the Team Will Do

• Assess the issue and determine the best course of action
• This may include:
  • 🔧 Fixing issues directly on the platform
  • 📲 Releasing app updates with bug fixes
  • 📧 Contacting you for further information if required

⚠️ Important

Reporting a bug does not guarantee an immediate fix, but it is the most effective way to provide the data needed to resolve issues.
💡 We appreciate every bug report and value your input in improving the platform.

 

❓ Q&A

📦 What happens if a new order comes in while reporting a bug?

• Orders will still come through as normal
• 🔕 No pop-up notifications will appear while on the Bug Reporting screen
• 🔔 The order alarm will still sound

📎 What happens when I click “Upload Logs”?

• Logs are automatically attached
• You will remain on the same Bug Reporting screen
• No additional screen will appear

📧 Can the email address be pre-filled?

• The email field may be pre-populated if previously used
• However, this is not guaranteed
  • It may be cleared due to:
    • App updates
    • Memory resets

🧠 Best Practice Tips

💡 Always double-check your email before submitting
💡 Keep reporting issues—even small ones help improve the app
💡 Provide as much detail as possible if contacted