USRSE / USRSE/usrse.github.io

feat(admin): recognition — awards, mentorship, contributions

Open
#1,962 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language
HTML
Stars
33
Forks
104
Avg merge
12h 3m
Merged PRs (30d)
10

Description

Summary

Recognition workflows: award nomination → review → approval, mentorship pair management, community contribution logging. Schema landed in Phase 3 (daa677b).

Requirements

  • Brainstorming → spec under docs/superpowers/specs/.
  • /admin/awards — manage the awards vocabulary (tier, accent, description) — staff+.
  • /admin/awards/:slug/nominations — nomination intake + review workflow — super_admin (lifetime tier) or staff (other tiers).
  • User awards CRUD: add / revoke entries on user_awards with citation text.
  • /admin/mentorship — match mentor / mentee pairs, manage active pairings, capture privacy preferences (partner names visible only when partnerIsPublic).
  • /admin/contributions — log community contributions (newsletters, tutorials, guides, etc.) for badge calculation.
  • All recognition writes flow through audit middleware so the trail of "who awarded what to whom" is complete.

Context

Foundation must ship first (#1956). Schema: awards, user_awards, mentorship_pairings, community_contributions, plus the award_tier, award_accent, contribution_kind enums.

Implementation Notes

  • Policy: canManageRecognition is staff+. Lifetime-tier awards may need an additional gate or a board-quorum-style approval (defer the decision to brainstorm).
  • Existing badge engine (packages/api/src/lib/badges.ts) is computed-on-read, so recognition data flows automatically into dossiers once admin writes land.

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start by confirming foundation issue #1956 and reviewing the Phase 3 recognition schema plus packages/api/src/lib/badges.ts. Draft the required spec under docs/superpowers/specs/, resolve the lifetime-tier approval decision, then define the awards, nominations, mentorship, and contributions workflows with audit coverage; done means the listed admin flows and recognition writes are complete.

Written by the indexing model from the issue text.

Assessment

Domain
authorization, backend, database, documentation
Issue type
Feature
Difficulty
5/5
Estimated time
Over a week
Activity status
Quiet
Clarity
Needs clarification
Newbie friendliness
25/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.