FEAT: Resident Profile Overview

[chrissantillan]

User Story

As an Administrator, I want to click on a Resident's name from the Resident table and be taken to a detailed Resident Profile Overview, so that I can view a snapshot of their activity and engagement within UnlockEd.

Description

This feature will introduce a Resident Profile Overview, providing administrators with key insights into individual residents' engagement and progress.

• Clicking a Resident's name in the Residents table will navigate to a dedicated Resident Profile Overview page.
• The page will display Resident details, activity insights, and engagement metrics across different areas of UnlockEd.
• Future iterations will incorporate Program Hub data as those features are developed.

Screenshots

Residents screen

Potential Resident Profile Overview sceen

Tasks

Navigation & Routing

• Link each Resident name in the Residents table to their corresponding profile overview.
• Create a new route for the Resident Profile Overview.

Resident Profile Overview Section

• Display Resident username, ID, and date joined in the UnlockEd platform.
• Display First and Last Active Date for the Resident.

Engagement & Activity Metrics

• Display Total Hours Engaged in UnlockEd.
• Show Days Active (number of unique days the Resident was active) with a filter to switch between this week and this month.
• Show Average Hours Active (calculated based on the last 30 days) with a filter to switch between per day and per week.
• Show Total Hours Active This Week.
• Show First and Last Active Date for the Resident.

Activity Graph

• Display a line graph of Resident activity over the past 30 days, showing daily engagement trends.
• Most Engaged Time of Day – Show breakdown of morning, afternoon, and evening engagement using a line chart.

Knowledge Center Engagement

• Track and display time spent engaging with content in the Knowledge Center with a filter to switch between per week and per month.
• Show time spent engaging with Featured Content with a filter to switch between per week and per month.
• Engagement by Content Category – Show breakdown of time spent on Libraries, Videos, and Helpful Links using a pie chart or bar graph. (Helps admins see whether a Resident prefers Libraries, Videos, or Helpful Links. )

Connected Learning Engagement

• Show list of courses the Resident is actively enrolled in.
• Display time spent per course with a filter to switch between per week and per month.
• Display Completed Courses.

Program Hub (Future Integration Placeholder)

• Placeholder for tracking institutionally-administered programs (e.g., Anger Management).

Advanced Engagement Metrics

• Engagement by "Layer" (Knowledge Base, Connected Learning, Program Hub) – Show a pie chart or bar graph of Resident engagement across UnlockEd's three core layers. (Helps admins see whether a Resident prefers Open Study Resources, Courses, or Programs.)

User Flow

1. Admin visits the Residents page.
2. Admin clicks on a Resident's name in the table.
3. Admin is taken to the Resident Profile Overview.
4. Admin sees Resident details at the top of the page.
5. Admin reviews engagement metrics, activity trends, and course progress.
6. Admin filters engagement metrics by week/month (or day/week, where applicable) to refine data.
7. (Optional): Admin navigates back to the Residents table via a back button.

Acceptance Criteria

• Clicking on a Resident’s name in the Resident table navigates to their profile overview.
• Resident Profile displays correct user details (username, ID, date joined, First and Last Active Date).
• Overview correctly calculates and displays:
  • Total Hours Engaged
  • Days Active with week/month filter
  • Average Weekly/Daily Hours
  • Total Hours This Week
• Graph accurately reflects past 30 days of engagement.
• Knowledge Center section correctly tracks time spent engaging with content.
• Learning Hub section correctly tracks current courses, time spent, and completed courses.
• Placeholder section is present for future Program Hub integration.
• Engagement graphs and charts accurately display engagement trends by content category and platform layer.

Technical Considerations

• Data Filtering:
  • Implement week/month filters for Days Active and day/week filters for Average Hours Active.
• Graphical Elements:
  • Use existing charting libraries to visualize time-of-day engagement, content category breakdown, and platform layer engagement.

Outstanding Questions

• Do we need permissions or access restrictions for certain Admin roles? (Note: defining an additional role is a future feature)
• Additional Engagement Metrics to Consider: (NICE TO HAVE)
  • Session Length Distribution
    • Why? Helps identify whether Residents engage in short bursts or long study sessions.
    • Metric: Average session length per login (e.g., 5 min, 15 min, 60+ min sessions).
    • Placement: Maybe a small bar chart next to the Activity Graph