feat: add endpoint to retrieve team details by ID (#150)

Co-authored-by: Amit Prakash <[email protected]>

Author: amit-flx

todo/services/team_service.py

@@ -138,3 +138,32 @@ def get_user_teams(cls, user_id: str) -> GetUserTeamsResponse:
 
         except Exception as e:
             raise ValueError(f"Failed to get user teams: {str(e)}")
+
+    @classmethod
+    def get_team_by_id(cls, team_id: str) -> TeamDTO:
+        """
+        Get a team by its ID.
+
+        Args:
+            team_id: ID of the team to retrieve
+
+        Returns:
+            TeamDTO with the team details
+
+        Raises:
+            ValueError: If the team is not found
+        """
+        team = TeamRepository.get_by_id(team_id)
+        if not team:
+            raise ValueError(f"Team with id {team_id} not found")
+        return TeamDTO(
+            id=str(team.id),
+            name=team.name,
+            description=team.description,
+            poc_id=str(team.poc_id) if team.poc_id else None,
+            invite_code=team.invite_code,
+            created_by=str(team.created_by),
+            updated_by=str(team.updated_by),
+            created_at=team.created_at,
+            updated_at=team.updated_at,
+        )

todo/urls.py

@@ -5,11 +5,12 @@
 from todo.views.auth import GoogleLoginView, GoogleCallbackView, LogoutView
 from todo.views.role import RoleListView, RoleDetailView
 from todo.views.label import LabelListView
-from todo.views.team import TeamListView
+from todo.views.team import TeamListView, TeamDetailView
 from todo.views.watchlist import WatchlistListView, WatchlistDetailView
 
 urlpatterns = [
     path("teams", TeamListView.as_view(), name="teams"),
+    path("teams/<str:team_id>", TeamDetailView.as_view(), name="team_detail"),
     path("tasks", TaskListView.as_view(), name="tasks"),
     path("tasks/<str:task_id>", TaskDetailView.as_view(), name="task_detail"),
     path("roles", RoleListView.as_view(), name="roles"),

todo/views/team.py

@@ -11,6 +11,9 @@
 from todo.dto.responses.get_user_teams_response import GetUserTeamsResponse
 from todo.dto.responses.error_response import ApiErrorResponse, ApiErrorDetail, ApiErrorSource
 from todo.constants.messages import ApiErrors
+from drf_spectacular.utils import extend_schema, OpenApiParameter, OpenApiResponse
+from drf_spectacular.types import OpenApiTypes
+from todo.dto.team_dto import TeamDTO
 
 
 class TeamListView(APIView):
@@ -90,3 +93,46 @@ def _handle_validation_errors(self, errors):
         error_response = ApiErrorResponse(statusCode=400, message=ApiErrors.VALIDATION_ERROR, errors=formatted_errors)
 
         return Response(data=error_response.model_dump(mode="json"), status=status.HTTP_400_BAD_REQUEST)
+
+
+class TeamDetailView(APIView):
+    @extend_schema(
+        operation_id="get_team_by_id",
+        summary="Get team by ID",
+        description="Retrieve a single team by its unique identifier",
+        tags=["teams"],
+        parameters=[
+            OpenApiParameter(
+                name="team_id",
+                type=OpenApiTypes.STR,
+                location=OpenApiParameter.PATH,
+                description="Unique identifier of the team",
+            ),
+        ],
+        responses={
+            200: OpenApiResponse(description="Team retrieved successfully"),
+            404: OpenApiResponse(description="Team not found"),
+            500: OpenApiResponse(description="Internal server error"),
+        },
+    )
+    def get(self, request: Request, team_id: str):
+        """
+        Retrieve a single team by ID.
+        """
+        try:
+            team_dto: TeamDTO = TeamService.get_team_by_id(team_id)
+            return Response(data=team_dto.model_dump(mode="json"), status=status.HTTP_200_OK)
+        except ValueError as e:
+            fallback_response = ApiErrorResponse(
+                statusCode=404,
+                message=str(e),
+                errors=[{"detail": str(e)}],
+            )
+            return Response(data=fallback_response.model_dump(mode="json"), status=404)
+        except Exception as e:
+            fallback_response = ApiErrorResponse(
+                statusCode=500,
+                message=ApiErrors.UNEXPECTED_ERROR_OCCURRED,
+                errors=[{"detail": str(e) if settings.DEBUG else ApiErrors.INTERNAL_SERVER_ERROR}],
+            )
+            return Response(data=fallback_response.model_dump(mode="json"), status=500)