chore: 일반 API 정리

Author: MU-Software

app/core/urls.py

@@ -26,7 +26,8 @@
 v1_apis: list[resolvers.URLPattern | resolvers.URLResolver] = [
     path("cms/", include("cms.urls")),
     path("admin-api/", include("admin_api.urls")),
-    path("event/presentations/", include("event.presentation.urls")),
+    path("event/presentation/", include("event.presentation.urls")),
+    path("event/sponsor/", include("event.sponsor.urls")),
 ]
 
 urlpatterns = [

app/event/presentation/urls.py

@@ -20,6 +20,7 @@
 from rest_framework import routers
 
 cms_router = routers.SimpleRouter()
-cms_router.register("presentation", views.PresentationViewSet, basename="presentation")
+cms_router.register("", views.PresentationViewSet, basename="presentation")
+cms_router.register("category", views.PresentationCategoryViewSet, basename="presentation-category")
 
 urlpatterns = [path("", include(cms_router.urls))]

app/event/presentation/views.py

@@ -1,7 +1,10 @@
-from core.const.regex import UUID_V4
+from core.const.regex import UUID_V4_REGEX
+from core.const.tag import OpenAPITag
 from django.db.models import QuerySet
+from django.utils.decorators import method_decorator
 from django_filters import rest_framework as filters
 from django_filters.constants import EMPTY_VALUES
+from drf_spectacular.utils import extend_schema
 from event.presentation.models import Presentation, PresentationCategory, PresentationCategoryRelation
 from event.presentation.serializers import PresentationSerializer
 from rest_framework import mixins, serializers, viewsets
@@ -14,18 +17,21 @@ class PresentationFilterSet(filters.FilterSet):
     def filter_by_category_ids(self, queryset: QuerySet, name: str, value: list[str]) -> QuerySet:
         if not value or value in EMPTY_VALUES:
             return queryset
-        if not any(UUID_V4.match(v) for v in value):
+        if not any(UUID_V4_REGEX.match(v) for v in value):
             return serializers.ValidationError(f"Invalid UUID format in {name} filter: {value}.")
 
         target_ids = PresentationCategoryRelation.objects.filter(category__id__in=value).values_list("presentation_id")
         return queryset.filter(id__in=target_ids)
 
 
+@method_decorator(name="list", decorator=extend_schema(tags=[OpenAPITag.EVENT_PRESENTATION]))
 class PresentationCategoryViewSet(mixins.ListModelMixin, viewsets.GenericViewSet):
     queryset = PresentationCategory.objects.filter_active()
 
 
-class PresentationViewSet(mixins.ListModelMixin, viewsets.GenericViewSet):
+@method_decorator(name="list", decorator=extend_schema(tags=[OpenAPITag.EVENT_PRESENTATION]))
+@method_decorator(name="retrieve", decorator=extend_schema(tags=[OpenAPITag.EVENT_PRESENTATION]))
+class PresentationViewSet(mixins.ListModelMixin, mixins.RetrieveModelMixin, viewsets.GenericViewSet):
     queryset = Presentation.objects.get_all_nested_data()
     serializer_class = PresentationSerializer
     filterset_class = PresentationFilterSet

app/event/sponsor/urls.py

@@ -3,6 +3,6 @@
 from rest_framework import routers
 
 cms_router = routers.SimpleRouter()
-cms_router.register("sponsors", views.SponsorTierViewSet, basename="sponsor")
+cms_router.register("", views.SponsorTierViewSet, basename="sponsor")
 
 urlpatterns = [path("", include(cms_router.urls))]

app/event/sponsor/views.py

@@ -1,9 +1,13 @@
+from core.const.tag import OpenAPITag
 from django.db import models
+from django.utils.decorators import method_decorator
+from drf_spectacular.utils import extend_schema
 from event.sponsor.models import Sponsor, SponsorTier
 from event.sponsor.serializers import SponsorTierSerializer
 from rest_framework import mixins, viewsets
 
 
+@method_decorator(name="list", decorator=extend_schema(tags=[OpenAPITag.EVENT_SPONSOR]))
 class SponsorTierViewSet(mixins.ListModelMixin, viewsets.GenericViewSet):
     queryset = SponsorTier.objects.filter_active().prefetch_related(
         models.Prefetch(