Feat/mentee page

backend/apps/mentorship/admin/__init__.py

@@ -2,6 +2,7 @@
 
 from .issue_user_interest import IssueUserInterest
 from .mentee import MenteeAdmin
+from .mentee_module import MenteeModuleAdmin
 from .mentee_program import MenteeProgramAdmin
 from .mentor import MentorAdmin
 from .module import ModuleAdmin

backend/apps/mentorship/admin/mentee_module.py

@@ -0,0 +1,32 @@
+"""Mentorship app MenteeModule model admin."""
+
+from django.contrib import admin
+
+from apps.mentorship.models.mentee_module import MenteeModule
+
+
+@admin.register(MenteeModule)
+class MenteeModuleAdmin(admin.ModelAdmin):
+    """Admin view for MenteeModule model."""
+
+    list_display = (
+        "mentee",
+        "module",
+        "started_at",
+        "ended_at",
+    )
+
+    list_filter = (
+        "module__program",
+        "started_at",
+        "ended_at",
+    )
+
+    search_fields = (
+        "mentee__github_user__login",
+        "mentee__github_user__name",
+        "module__name",
+        "module__program__name",
+    )
+
+    ordering = ["mentee__github_user__login", "module__name"]

backend/apps/mentorship/api/internal/nodes/mentee.py

@@ -0,0 +1,29 @@
+"""GraphQL node for Mentee model."""
+
+import strawberry
+
+from apps.mentorship.api.internal.nodes.enum import ExperienceLevelEnum
+
+
+@strawberry.type
+class MenteeNode:
+    """A GraphQL node representing a mentorship mentee."""
+
+    id: str
+    login: str
+    name: str
+    avatar_url: str
+    bio: str | None = None
+    experience_level: ExperienceLevelEnum
+    domains: list[str] | None = None
+    tags: list[str] | None = None
+
+    @strawberry.field(name="avatarUrl")
+    def resolve_avatar_url(self) -> str:
+        """Get the GitHub avatar URL of the mentee."""
+        return self.avatar_url
+
+    @strawberry.field(name="experienceLevel")
+    def resolve_experience_level(self) -> str:
+        """Get the experience level of the mentee."""
+        return self.experience_level if self.experience_level else "beginner"

backend/apps/mentorship/api/internal/nodes/module.py

@@ -7,6 +7,7 @@
 from apps.github.api.internal.nodes.issue import IssueNode
 from apps.github.api.internal.nodes.user import UserNode
 from apps.github.models import Label
+from apps.github.models.user import User
 from apps.mentorship.api.internal.nodes.enum import ExperienceLevelEnum
 from apps.mentorship.api.internal.nodes.mentor import MentorNode
 from apps.mentorship.api.internal.nodes.program import ProgramNode
@@ -36,6 +37,34 @@ def mentors(self) -> list[MentorNode]:
         """Get the list of mentors for this module."""
         return self.mentors.all()
 
+    @strawberry.field
+    def mentees(self) -> list[UserNode]:
+        """Get the list of mentees for this module."""
+        mentee_users = (
+            self.menteemodule_set.select_related("mentee__github_user")
+            .filter(mentee__github_user__isnull=False)
+            .values_list("mentee__github_user", flat=True)
+        )
+
+        return list(User.objects.filter(id__in=mentee_users).order_by("login"))
+
+    @strawberry.field
+    def issue_mentees(self, issue_number: int) -> list[UserNode]:
+        """Return mentees assigned to this module's issue identified by its number."""
+        issue_ids = list(self.issues.filter(number=issue_number).values_list("id", flat=True))
+        if not issue_ids:
+            return []
+
+        # Get mentees assigned to tasks for this issue
+        mentee_users = (
+            Task.objects.filter(module=self, issue_id__in=issue_ids, assignee__isnull=False)
+            .select_related("assignee")
+            .values_list("assignee", flat=True)
+            .distinct()
+        )
+
+        return list(User.objects.filter(id__in=mentee_users).order_by("login"))
+
     @strawberry.field
     def project_name(self) -> str | None:
         """Get the project name for this module."""

backend/apps/mentorship/api/internal/queries/mentorship.py

@@ -1,10 +1,25 @@
 """GraphQL queries for mentorship role management."""
 
+from __future__ import annotations
+
+from typing import TYPE_CHECKING, cast
+
 import strawberry
+from django.core.exceptions import ObjectDoesNotExist
+from django.db.models import Prefetch
 
+from apps.github.api.internal.nodes.issue import IssueNode
+from apps.github.models import Label
 from apps.github.models.user import User as GithubUser
+from apps.mentorship.api.internal.nodes.mentee import MenteeNode
+from apps.mentorship.models import Module
+from apps.mentorship.models.mentee import Mentee
+from apps.mentorship.models.mentee_module import MenteeModule
 from apps.mentorship.models.mentor import Mentor
 
+if TYPE_CHECKING:
+    from apps.github.api.internal.nodes.issue import IssueNode
+
 
 @strawberry.type
 class UserRolesResult:
@@ -31,3 +46,81 @@ def is_mentor(self, login: str) -> bool:
             return False
 
         return Mentor.objects.filter(github_user=github_user).exists()
+
+    @strawberry.field
+    def get_mentee_details(
+        self, program_key: str, module_key: str, mentee_handle: str
+    ) -> MenteeNode:
+        """Get detailed information about a mentee in a specific module."""
+        try:
+            module = Module.objects.only("id").get(key=module_key, program__key=program_key)
+
+            github_user = GithubUser.objects.only("login", "name", "avatar_url", "bio").get(
+                login=mentee_handle
+            )
+
+            mentee = Mentee.objects.only("id", "experience_level", "domains", "tags").get(
+                github_user=github_user
+            )
+            is_enrolled = MenteeModule.objects.filter(mentee=mentee, module=module).exists()
+
+            if not is_enrolled:
+                message = f"Mentee {mentee_handle} is not enrolled in module {module_key}"
+                raise ObjectDoesNotExist(message)
+
+            return MenteeNode(
+                id=cast("strawberry.ID", str(mentee.id)),
+                login=github_user.login,
+                name=github_user.name or github_user.login,
+                avatar_url=github_user.avatar_url,
+                bio=github_user.bio,
+                experience_level=mentee.experience_level,
+                domains=mentee.domains,
+                tags=mentee.tags,
+            )
+
+        except (Module.DoesNotExist, GithubUser.DoesNotExist, Mentee.DoesNotExist) as e:
+            message = f"Mentee details not found: {e}"
+            raise ObjectDoesNotExist(message) from e
+
+    @strawberry.field
+    def get_mentee_module_issues(
+        self,
+        program_key: str,
+        module_key: str,
+        mentee_handle: str,
+        limit: int = 20,
+        offset: int = 0,
+    ) -> list[IssueNode]:
+        """Get issues assigned to a mentee in a specific module."""
+        try:
+            module = Module.objects.only("id").get(key=module_key, program__key=program_key)
+
+            github_user = GithubUser.objects.only("id").get(login=mentee_handle)
+
+            mentee = Mentee.objects.only("id").get(github_user=github_user)
+            is_enrolled = MenteeModule.objects.filter(mentee=mentee, module=module).exists()
+
+            if not is_enrolled:
+                message = f"Mentee {mentee_handle} is not enrolled in module {module_key}"
+                raise ObjectDoesNotExist(message)
+
+            issues_qs = (
+                module.issues.filter(assignees=github_user)
+                .only("id", "number", "title", "state", "created_at", "url")
+                .prefetch_related(
+                    Prefetch("labels", queryset=Label.objects.only("id", "name")),
+                    Prefetch(
+                        "assignees",
+                        queryset=GithubUser.objects.only("id", "login", "name", "avatar_url"),
+                    ),
+                )
+                .order_by("-created_at")
+            )
+            issues = issues_qs[offset : offset + limit]
+
+            return list(issues)
+
+        except (Module.DoesNotExist, GithubUser.DoesNotExist, Mentee.DoesNotExist) as e:
+            message = f"Mentee issues not found: {e}"
+            raise ObjectDoesNotExist(message) from e

cspell/custom-dict.txt

@@ -83,6 +83,7 @@ mastg
 mcr
 mdfile
 mentee
+menteemodule_set
 mentees
 mern
 millify

frontend/src/app/mentorship/programs/[programKey]/modules/[moduleKey]/page.tsx

@@ -1,12 +1,12 @@
 'use client'
 
 import { useQuery } from '@apollo/client'
+import upperFirst from 'lodash/upperFirst'
 import { useParams } from 'next/navigation'
 import { useEffect, useState } from 'react'
 import { ErrorDisplay, handleAppError } from 'app/global-error'
 import { GET_PROGRAM_ADMINS_AND_MODULES } from 'server/queries/moduleQueries'
 import type { Module } from 'types/mentorship'
-import { titleCaseWord } from 'utils/capitalize'
 import { formatDate } from 'utils/dateFormatter'
 import DetailsCard from 'components/CardDetailsPage'
 import LoadingSpinner from 'components/LoadingSpinner'
@@ -49,7 +49,7 @@ const ModuleDetailsPage = () => {
   }
 
   const moduleDetails = [
-    { label: 'Experience Level', value: titleCaseWord(module.experienceLevel) },
+    { label: 'Experience Level', value: upperFirst(module.experienceLevel) },
     { label: 'Start Date', value: formatDate(module.startedAt) },
     { label: 'End Date', value: formatDate(module.endedAt) },
     {