feat: Implement GraphQL support for badges

- Add BadgeNode GraphQL type with fields: id, name, description, weight, css_class
- Add badges query to return all badges ordered by weight and name
- Add badges field to UserNode to expose user badges sorted by weight
- Add comprehensive test coverage for BadgeQueries and UserNode badges field
- Integrate BadgeQueries into NestQuery schema

Fixes #1764

Author: Piyushrathoree

backend/apps/github/api/internal/nodes/user.py

@@ -4,6 +4,7 @@
 import strawberry_django
 
 from apps.github.models.user import User
+from apps.nest.api.internal.nodes.badge import BadgeNode
 
 
 @strawberry_django.type(
@@ -51,3 +52,17 @@ def updated_at(self) -> float:
     def url(self) -> str:
         """Resolve URL."""
         return self.url
+
+    @strawberry.field
+    def badges(self) -> list[BadgeNode]:
+        """Return active badges for the user, ordered by badge weight and name."""
+        # related_name on UserBadge is "badges"; prefetch badge and filter active
+        user_badges = (
+            self.badges.select_related("badge")
+            .filter(is_active=True)
+            .order_by(
+                "badge__weight",
+                "badge__name",
+            )
+        )
+        return [ub.badge for ub in user_badges]

backend/apps/nest/api/internal/nodes/badge.py

@@ -0,0 +1,20 @@
+"""GraphQL node for Badge model."""
+
+import strawberry
+import strawberry_django
+
+from apps.nest.models.badge import Badge
+
+
+@strawberry_django.type(
+    Badge,
+    fields=[
+        "id",
+        "name",
+        "description",
+        "weight",
+        "css_class",
+    ],
+)
+class BadgeNode(strawberry.relay.Node):
+    """GraphQL node for Badge model."""

backend/apps/nest/api/internal/queries/__init__.py

@@ -1,8 +1,9 @@
 import strawberry
 
 from apps.nest.api.internal.queries.api_key import ApiKeyQueries
+from apps.nest.api.internal.queries.badge import BadgeQueries
 
 
 @strawberry.type
-class NestQuery(ApiKeyQueries):
+class NestQuery(ApiKeyQueries, BadgeQueries):
     """Nest query."""

backend/apps/nest/api/internal/queries/badge.py

@@ -0,0 +1,16 @@
+"""GraphQL queries for Badge model."""
+
+import strawberry
+
+from apps.nest.api.internal.nodes.badge import BadgeNode
+from apps.nest.models.badge import Badge
+
+
+@strawberry.type
+class BadgeQueries:
+    """GraphQL query class for badges."""
+
+    @strawberry.field
+    def badges(self) -> list[BadgeNode]:
+        """Return all badges ordered by weight and name."""
+        return list(Badge.objects.all().order_by("weight", "name"))

backend/tests/apps/github/api/internal/nodes/user_badges_field_test.py

@@ -0,0 +1,33 @@
+"""Tests for badges field on GitHub UserNode."""
+
+from unittest.mock import MagicMock
+
+from apps.github.api.internal.nodes.user import UserNode
+
+
+class TestUserNodeBadgesField:
+    """Test cases for badges field on UserNode."""
+
+    def test_badges_resolution_orders_and_filters_active(self):
+        """Badges resolution should filter active and order by badge weight/name."""
+        # Build a lightweight object with required attributes and methods
+        user = MagicMock()
+        user_badge_qs = MagicMock()
+        user.badges.select_related.return_value = user_badge_qs
+
+        # Mock chained calls: filter(...).order_by(...) -> [ub1]
+        ordered_qs = MagicMock()
+        ordered_qs.__iter__.return_value = iter([])
+        ub1 = MagicMock()
+        ub1.badge = MagicMock()
+        ordered_qs.__iter__.return_value = iter([ub1])
+        user_badge_qs.filter.return_value = ordered_qs
+        ordered_qs.order_by.return_value = [ub1]
+
+        # Use the resolver through the class to keep Strawberry decorators intact
+        result = UserNode.badges(user)  # pass instance as self
+
+        user.badges.select_related.assert_called_once_with("badge")
+        user_badge_qs.filter.assert_called_once_with(is_active=True)
+        ordered_qs.order_by.assert_called_once_with("badge__weight", "badge__name")
+        assert result == [ub1.badge]

backend/tests/apps/nest/api/internal/queries/badge_test.py

@@ -0,0 +1,38 @@
+"""Tests for Badge GraphQL queries and nodes."""
+
+from unittest.mock import MagicMock, patch
+
+from apps.nest.api.internal.nodes.badge import BadgeNode
+from apps.nest.api.internal.queries.badge import BadgeQueries
+from apps.nest.models.badge import Badge
+
+
+class TestBadgeQueries:
+    """Test cases for BadgeQueries class."""
+
+    def test_has_strawberry_definition(self):
+        """BadgeQueries should be a valid Strawberry type with 'badges' field."""
+        assert hasattr(BadgeQueries, "__strawberry_definition__")
+        field_names = [f.name for f in BadgeQueries.__strawberry_definition__.fields]
+        assert "badges" in field_names
+
+    def test_badges_field_configuration(self):
+        """'badges' field should return a list of BadgeNode."""
+        field = next(
+            f for f in BadgeQueries.__strawberry_definition__.fields if f.name == "badges"
+        )
+        assert field.type.of_type is BadgeNode or field.type is BadgeNode
+
+    @patch("apps.nest.models.badge.Badge.objects.all")
+    def test_badges_resolution(self, mock_all):
+        """Resolver should return badges ordered by weight and name."""
+        mock_badge = MagicMock(spec=Badge)
+        mock_qs = MagicMock()
+        mock_qs.order_by.return_value = [mock_badge]
+        mock_all.return_value = mock_qs
+
+        result = BadgeQueries().badges()
+
+        assert result == [mock_badge]
+        mock_all.assert_called_once()
+        mock_qs.order_by.assert_called_once_with("weight", "name")