Read Badge Unlock Criteria for Each Recognition Tier
Tapping a badge on the Achievements screen expands or navigates to a detail view showing the badge's full name, category, description, and the specific criteria required to earn it (e.g. 'Complete 15 assignments as a peer mentor within a calendar year', or 'Maintain active status for 6 consecutive months'). Badge definitions are loaded from the Badge Repository where they are stored as configuration data, allowing administrators to update criteria descriptions without a code deployment. Both earned and locked badges show the full criteria so users understand what they achieved or what they need to do.
User Story
Acceptance Criteria
- Given a user taps on any badge (earned or locked), when the detail view opens, then the badge name, category, full description, and specific unlock criteria are displayed
- Given a badge has a numeric threshold, when the detail view is shown, then the exact number required (e.g. '15 completed assignments') is stated clearly
- Given an administrator updates badge criteria in the repository, when a user views the badge detail, then the updated criteria text is shown without requiring an app update
- Given a user taps a locked badge and reads the criteria, when they navigate back, then they are returned to the Achievements screen with no data loss
- Given a badge belongs to a specific organisation, when a user from a different organisation views the app, then that badge and its criteria are not visible to them
Business Value
Transparent criteria make the recognition programme credible and fair. When users understand exactly what earns a badge, they can make intentional choices about their participation. Criteria stored as configuration data keeps the system adaptable — organisations can adjust thresholds or add new tiers as their programmes evolve without requiring engineering intervention.
Components
- Achievements Screen ui
- Badge Widget ui
- Badge Repository data