Skip to content

feat(mentors): admin mentor engagement report - #374

Merged
gregv merged 2 commits into
developfrom
feat/mentor-engagement-report
Nov 17, 2026
Merged

gregv merged 2 commits into
developfrom
feat/mentor-engagement-report

Conversation

@gregv

@gregv gregv commented Nov 17, 2026

Copy link
Copy Markdown
Contributor

What

  • New admin-only route GET /api/admin/mentor-engagement/<event_id> (volunteer.admin).
  • Per mentor: check-ins (self check-in count, hours from check-in/check-out pairs, desk check-in) joined with mentor-panel work read off the event's team docs (coverage sign-offs, notes, flags raised/resolved, ratings, teams helped, last activity).
  • Rows are ranked most engaged first (rank) and carry a suggested level for Heart Certificates: engaged = checked in and at least 5 panel actions on at least 1 team. It is a suggestion only; nothing issues a certificate.
  • Panel activity is matched to the mentor application by PropelAuth id, then by PropelAuth email; anything unmatched is returned in unmatched.
  • Adds api/mentors/tests to the CI test loop (it was not being run).

Notes

  • Help given only in Slack or in person is not measured.
  • Uncached; reads the event's mentor applications and team docs on each call.
  • Deploy before the frontend PR that adds the panel.

Testing

pytest api/mentors/tests — 22 passed. Not yet run against real fall-2026 data.

🤖 Generated with Claude Code

GET /api/admin/mentor-engagement/<event_id> joins mentor check-ins with
mentor-panel activity per mentor, ranked most engaged first, with a
suggested Heart Certificate level. Adds api/mentors/tests to CI.

Co-Authored-By: Claude Fable 5.2 <[email protected]>
@auth.require_org_member_with_permission("volunteer.admin", req_to_org_id=getOrgId)
def mentor_engagement_api(event_id):
try:
return get_mentor_engagement(event_id), 200
@gregv
gregv merged commit 161cbdc into develop Nov 17, 2026
4 of 6 checks passed
@gregv
gregv deleted the feat/mentor-engagement-report branch November 17, 2026 04:30
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants