Feat #25 - 유치원 요약 정보 조회 API 구현

mung_manager/pet_kindergardens/apis/api_managers.py

@@ -6,6 +6,7 @@
 from mung_manager.pet_kindergardens.apis.apis import (
     PetKindergardenListAPI,
     PetKindergardenSelectionAPI,
+    PetKindergardenSummaryInfoAPI,
 )
 from mung_manager.schemas.errors.authentications import (
     ErrorAuthenticationPasswordChangedSchema,
@@ -117,3 +118,43 @@ class PetKindergardenSelectionAPIManager(BaseAPIManager):
     )
     def post(self, request, *args, **kwargs):
         return self.VIEWS_BY_METHOD["POST"]()(request, *args, **kwargs)
+
+
+class PetKindergardenSummaryInfoAPIManager(BaseAPIManager):
+    VIEWS_BY_METHOD = {
+        "GET": PetKindergardenSummaryInfoAPI.as_view,
+    }
+
+    @extend_schema(
+        tags=["반려동물 유치원"],
+        summary="반려동물 유치원 요약 정보 조회",
+        description="""
+        Rogic
+            - 유저 토큰 클레임에 포함된 반려동물 유치원 아이디로 해당 반려동물 유치원의 요약 정보를 조회합니다.
+        """,
+        responses={
+            status.HTTP_200_OK: VIEWS_BY_METHOD["GET"]().cls.OutputSerializer,
+            status.HTTP_401_UNAUTHORIZED: OpenApiResponse(
+                response=OpenApiTypes.OBJECT,
+                examples=[
+                    ErrorAuthenticationFailedSchema,
+                    ErrorNotAuthenticatedSchema,
+                    ErrorInvalidTokenSchema,
+                    ErrorAuthorizationHeaderSchema,
+                    ErrorAuthenticationPasswordChangedSchema,
+                    ErrorAuthenticationUserDeletedSchema,
+                    ErrorAuthenticationUserInactiveSchema,
+                    ErrorAuthenticationUserNotFoundSchema,
+                    ErrorTokenIdentificationSchema,
+                ],
+            ),
+            status.HTTP_403_FORBIDDEN: OpenApiResponse(
+                response=OpenApiTypes.OBJECT, examples=[ErrorPermissionDeniedSchema]
+            ),
+            status.HTTP_500_INTERNAL_SERVER_ERROR: OpenApiResponse(
+                response=OpenApiTypes.OBJECT, examples=[ErrorUnknownServerSchema]
+            ),
+        },
+    )
+    def get(self, request, *args, **kwargs):
+        return self.VIEWS_BY_METHOD["GET"]()(request, *args, **kwargs)

mung_manager/pet_kindergardens/apis/apis.py

@@ -3,7 +3,7 @@
 from rest_framework.response import Response
 from rest_framework.views import APIView
 
-from mung_manager.apis.mixins import APIAuthMixin
+from mung_manager.apis.mixins import APIAuthMixin, APIAuthWithPetKindergardenAccessMixin
 from mung_manager.authentications.containers import AuthenticationContainer
 from mung_manager.commons.base.serializers import BaseSerializer
 from mung_manager.pet_kindergardens.containers import PetKindergardenContainer
@@ -56,3 +56,23 @@ def post(self, request: Request) -> Response:
             }
         ).data
         return Response(data=auth_data, status=status.HTTP_200_OK)
+
+
+class PetKindergardenSummaryInfoAPI(APIAuthWithPetKindergardenAccessMixin, APIView):
+    class OutputSerializer(BaseSerializer):
+        id = serializers.IntegerField(label="유치원 아이디")
+        name = serializers.CharField(label="유치원 이름")
+        business_start_hour = serializers.TimeField(label="영업 시작 시간", format="%H:%M")
+        business_end_hour = serializers.TimeField(label="영업 종료 시간", format="%H:%M")
+
+    def __init__(self, *args, **kwargs):
+        super().__init__(*args, **kwargs)
+        self._pet_kindergarden_selector = PetKindergardenContainer.pet_kindergarden_selector()
+
+    def get(self, request: Request) -> Response:
+        pet_kindergarden_id = request.pet_kindergarden_id
+        pet_kindergarden = self._pet_kindergarden_selector.get_by_pet_kindergarden_id_for_summary_info(
+            pet_kindergarden_id
+        ).get()
+        pet_kindergardens_data = self.OutputSerializer(pet_kindergarden).data
+        return Response(data=pet_kindergardens_data, status=status.HTTP_200_OK)

mung_manager/pet_kindergardens/apis/urls.py

@@ -3,6 +3,7 @@
 from mung_manager.pet_kindergardens.apis.api_managers import (
     PetkindergardenListAPIManager,
     PetKindergardenSelectionAPIManager,
+    PetKindergardenSummaryInfoAPIManager,
 )
 
 urlpatterns = [
@@ -16,4 +17,9 @@
         PetKindergardenSelectionAPIManager.as_view(),
         name="pet-kindergarden-selection",
     ),
+    path(
+        "/summary",
+        PetKindergardenSummaryInfoAPIManager.as_view(),
+        name="pet-kindergarden-summary-info",
+    ),
 ]

mung_manager/pet_kindergardens/selectors/abstracts.py

@@ -9,8 +9,9 @@
 class AbstractPetKindergardenSelector(ABC):
 
     @abstractmethod
-    def get_queryset_by_user(
-        self,
-        user,
-    ) -> QuerySet[Any]:
+    def get_queryset_by_user(self, user) -> QuerySet[Any]:
+        raise NotImplementedException()
+
+    @abstractmethod
+    def get_by_pet_kindergarden_id_for_summary_info(self, pet_kindergarden_id: int) -> QuerySet:
         raise NotImplementedException()

mung_manager/pet_kindergardens/selectors/pet_kindergardens.py

@@ -1,21 +1,28 @@
-from typing import Any
+from datetime import time
+from typing import Any, TypedDict
 
 from django.db.models import F, QuerySet, Value
 from django.db.models.functions import Concat
+from django_stubs_ext.aliases import ValuesQuerySet
 
 from mung_manager.pet_kindergardens.models import PetKindergarden
 from mung_manager.pet_kindergardens.selectors.abstracts import (
     AbstractPetKindergardenSelector,
 )
 
+summery_info = TypedDict(
+    "summery_info", {"id": int, "name": str, "business_start_hour": time, "business_end_hour": time}
+)
+
 
 class PetKindergardenSelector(AbstractPetKindergardenSelector):
     """
     이 클래스는 반려동물 유치원을 DB에서 PULL하는 비즈니스 로직을 담당합니다.
     """
 
     def get_queryset_by_user(self, user) -> QuerySet[Any]:
-        """이 함수는 사용자 정보로, 해당 사용자가 속한 유치원 목록을 조회합니다.
+        """
+        이 함수는 사용자 정보로, 해당 사용자가 속한 유치원 목록을 조회합니다.
 
         Args:
             user: User: 유저 객체
@@ -29,3 +36,20 @@ def get_queryset_by_user(self, user) -> QuerySet[Any]:
             .annotate(full_address=Concat(F("road_address"), Value(" "), F("detail_address")))
             .values("id", "name", "full_address", "profile_thumbnail_url")
         )
+
+    def get_by_pet_kindergarden_id_for_summary_info(
+        self, pet_kindergarden_id: int
+    ) -> ValuesQuerySet[PetKindergarden, summery_info]:
+        """
+        이 함수는 반려동물 유치원 아이디로 해당 반려동물 유치원의 요약 정보를 조회합니다.
+
+        Args:
+            pet_kindergarden_id (int): 반려동물 유치원 아이디
+
+        Returns:
+            ValuesQuerySet[PetKindergarden, summery_info]: 정의된 응답 스키마
+        """
+
+        return PetKindergarden.objects.filter(id=pet_kindergarden_id).values(
+            "id", "name", "business_start_hour", "business_end_hour"
+        )