refactor: admin_api의 구조 수정

Author: MU-Software

app/admin_api/serializers/modification_audit.py

@@ -1,13 +1,14 @@
 import typing
 import unicodedata
 
+from core.serializer.json_schema_serializer import JsonSchemaSerializer
 from event.presentation.models import Presentation, PresentationSpeaker
 from participant_portal_api.models import ModificationAudit, ModificationAuditComment
 from rest_framework import serializers
 from user.models import UserExt
 
 
-class ModificationAuditResponseAdminSerializer(serializers.ModelSerializer):
+class ModificationAuditResponseAdminSerializer(JsonSchemaSerializer, serializers.ModelSerializer):
     class ModificationAuditCommentAdminSerializer(serializers.ModelSerializer):
         class ModificationAuditCommentAdminUserSerializer(serializers.ModelSerializer):
             class Meta:

app/admin_api/test/shop/categories_api_test.py

@@ -8,7 +8,7 @@
 from user.models.organization import Organization
 
 LIST_URL = reverse("v1:admin-shop-category-list")
-CHOICES_URL = LIST_URL + "choices/"
+SELECTABLES_URL = LIST_URL + "selectables/"
 
 
 @pytest.fixture
@@ -42,35 +42,27 @@ def test_category_list_returns_categories(api_client, category_fixtures):
 
 
 @pytest.mark.django_db
-def test_category_choices_returns_group_and_event(api_client, category_fixtures):
-    response = api_client.get(CHOICES_URL)
+def test_category_selectables_include_meta(api_client, category_fixtures):
+    # selectables 결과의 각 category 는 Category.get_choice_meta() 로 group/is_ticket/event 메타를 실어야 한다.
+    response = api_client.get(SELECTABLES_URL)
     assert response.status_code == HTTP_200_OK
-    data = response.json()
-    assert {"group", "event"} <= set(data)
-    assert str(category_fixtures["g2026"].id) in {c["const"] for c in data["group"]}
-    assert str(category_fixtures["event"].id) in {c["const"] for c in data["event"]}
+    body = response.json()
+    ticket_meta = {c["const"]: c for c in body["results"]}[str(category_fixtures["ticket"].id)]["meta"]
+    assert ticket_meta["group"] == "2026"
+    assert ticket_meta["is_ticket"] is True
+    assert ticket_meta["event"] == str(category_fixtures["event"])
+    # meta_schema 는 모델의 choices_meta_schema 를 반영한다.
+    assert {"is_ticket", "group", "event"} <= set(body["meta_schema"])
 
 
 @pytest.mark.django_db
-def test_category_choices_include_meta_for_event(api_client, category_fixtures):
-    # Event 모델이 choices_meta_schema/get_choice_meta 를 정의하므로 event choice 에 meta 가 붙어야 한다.
-    response = api_client.get(CHOICES_URL)
-    assert response.status_code == HTTP_200_OK
-    event_choices = {c["const"]: c for c in response.json()["event"] if c["const"] is not None}
-    event_meta = event_choices[str(category_fixtures["event"].id)]["meta"]
-    assert event_meta["organization"] == "Org"
-    assert event_meta["started_at"] == "2026-08-01"
-
-
-@pytest.mark.django_db
-def test_category_choices_include_audit_meta_for_event(api_client, category_fixtures):
+def test_category_selectables_include_audit_meta(api_client, category_fixtures):
     # BaseAbstractModel 의 audit 메타(created_by/updated_by/created_at/updated_at)가 자동으로 붙어야 한다.
-    response = api_client.get(CHOICES_URL)
+    response = api_client.get(SELECTABLES_URL)
     assert response.status_code == HTTP_200_OK
-    event_choices = {c["const"]: c for c in response.json()["event"] if c["const"] is not None}
-    event_meta = event_choices[str(category_fixtures["event"].id)]["meta"]
-    assert {"created_by", "updated_by", "created_at", "updated_at"} <= set(event_meta)
-    assert event_meta["created_at"] is not None
+    ticket_meta = {c["const"]: c for c in response.json()["results"]}[str(category_fixtures["ticket"].id)]["meta"]
+    assert {"created_by", "updated_by", "created_at", "updated_at"} <= set(ticket_meta)
+    assert ticket_meta["created_at"] is not None
 
 
 @pytest.mark.django_db

app/admin_api/test/shop/products_api_test.py

@@ -3,7 +3,6 @@
 import pytest
 from admin_api.test.helpers import CategoryGroupsAdminApi, OptionGroupsAdminApi, ProductsAdminApi, TagsAdminApi
 from django.urls import reverse
-from event.models import Event
 from rest_framework.status import (
     HTTP_200_OK,
     HTTP_201_CREATED,
@@ -13,10 +12,8 @@
 )
 from shop.conftest import FAR_FUTURE, FAR_PAST
 from shop.product.models import Category, CategoryGroup, OptionGroup, Product, Tag
-from user.models.organization import Organization
 
-PRODUCT_CHOICES_URL = reverse("v1:admin-shop-product-list") + "choices/"
-OPTION_GROUP_CHOICES_URL = reverse("v1:admin-shop-option-group-list") + "choices/"
+PRODUCT_SELECTABLES_URL = reverse("v1:admin-shop-product-list") + "selectables/"
 
 
 @pytest.mark.parametrize("api_cls", [CategoryGroupsAdminApi, TagsAdminApi, ProductsAdminApi])
@@ -442,41 +439,20 @@ def test_admin_product_list_filters_by_status(api_client, products_by_status, st
 
 
 @pytest.mark.django_db
-def test_admin_product_choices_include_category_meta(api_client, ticket_product):
-    # Product choices 의 category FK 는 Category.get_choice_meta() 로 group/is_ticket/event 메타를 실어야 한다.
-    org = Organization.objects.create(name="PSK")
-    event = Event.objects.create(
-        organization=org, name="PyCon Korea 2026", event_start_at=datetime(2026, 8, 1, tzinfo=timezone.utc)
-    )
-    evented = Category.objects.create(
-        group=CategoryGroup.objects.create(name="2026"), name="Conference", is_ticket=True, event=event
-    )
-
-    response = api_client.get(PRODUCT_CHOICES_URL)
-    assert response.status_code == HTTP_200_OK
-    category_choices = {c["const"]: c for c in response.json()["category"]}
-
-    # event 가 있는 카테고리 — str(event) 분기.
-    evented_meta = category_choices[str(evented.id)]["meta"]
-    assert evented_meta.items() >= {"group": "2026", "is_ticket": True, "event": str(event)}.items()
-
-    # event 가 없는 카테고리(fixture) — None 분기.
-    plain_meta = category_choices[str(ticket_product.category.id)]["meta"]
-    assert plain_meta.items() >= {"group": "기본", "is_ticket": True, "event": None}.items()
-
-
-@pytest.mark.django_db
-def test_admin_option_group_choices_include_product_meta(api_client, ticket_product):
-    # OptionGroup choices 의 product FK 는 Product.get_choice_meta() 로 category/price/stock/status 메타를 실어야 한다.
-    response = api_client.get(OPTION_GROUP_CHOICES_URL)
+def test_admin_product_selectables_include_meta(api_client, ticket_product):
+    # selectables 결과의 각 product 는 Product.get_choice_meta() 로 category/price/stock/status 메타를 실어야 한다.
+    response = api_client.get(PRODUCT_SELECTABLES_URL)
     assert response.status_code == HTTP_200_OK
-    product_choices = {c["const"]: c for c in response.json()["product"]}
+    body = response.json()
+    product_meta = {p["const"]: p for p in body["results"]}[str(ticket_product.id)]["meta"]
     assert (
-        product_choices[str(ticket_product.id)]["meta"].items()
+        product_meta.items()
         >= {
             "category": str(ticket_product.category),
             "price": ticket_product.price,
             "stock": ticket_product.stock,
             "status": Product.CurrentStatus.ACTIVE.label,
         }.items()
     )
+    # meta_schema 는 모델의 choices_meta_schema 를 반영한다.
+    assert {"category", "price", "stock", "status"} <= set(body["meta_schema"])

app/admin_api/views/cms.py

@@ -12,7 +12,9 @@
 from cms.models import DomainGroup, Page, Section, Sitemap
 from core.authz import IsSuperUser
 from core.const.tag import OpenAPITag
-from core.viewset.json_schema_viewset import JsonSchemaViewSet
+from core.pagination import AdminPagination
+from core.viewset.json_schema_viewset import JsonSchemaMixin
+from core.viewset.selectables_viewset import SelectablesMixin
 from django.db import transaction
 from drf_spectacular.utils import extend_schema, extend_schema_view, inline_serializer
 from drf_standardized_errors.openapi_serializers import (
@@ -26,7 +28,8 @@
 
 
 @extend_schema_view(**{m: extend_schema(tags=[OpenAPITag.ADMIN_CMS]) for m in ADMIN_METHODS})
-class DomainGroupAdminViewSet(JsonSchemaViewSet, viewsets.ModelViewSet):
+class DomainGroupAdminViewSet(JsonSchemaMixin, SelectablesMixin, viewsets.ModelViewSet):
+    pagination_class = AdminPagination
     http_method_names = ["get", "post", "patch", "delete"]
     serializer_class = DomainGroupAdminSerializer
     permission_classes = [IsSuperUser]
@@ -61,7 +64,8 @@ class SectionData(typing.TypedDict):
 
 
 @extend_schema_view(**{m: extend_schema(tags=[OpenAPITag.ADMIN_CMS]) for m in ADMIN_METHODS})
-class SitemapAdminViewSet(JsonSchemaViewSet, viewsets.ModelViewSet):
+class SitemapAdminViewSet(JsonSchemaMixin, SelectablesMixin, viewsets.ModelViewSet):
+    pagination_class = AdminPagination
     http_method_names = ["get", "post", "patch", "delete"]
     serializer_class = SitemapAdminSerializer
     permission_classes = [IsSuperUser]
@@ -70,7 +74,8 @@ class SitemapAdminViewSet(JsonSchemaViewSet, viewsets.ModelViewSet):
 
 
 @extend_schema_view(**{m: extend_schema(tags=[OpenAPITag.ADMIN_CMS]) for m in ADMIN_METHODS})
-class PageAdminViewSet(JsonSchemaViewSet, viewsets.ModelViewSet):
+class PageAdminViewSet(JsonSchemaMixin, SelectablesMixin, viewsets.ModelViewSet):
+    pagination_class = AdminPagination
     serializer_class = PageAdminSerializer
     permission_classes = [IsSuperUser]
     filterset_class = PageAdminFilterSet

app/admin_api/views/document.py

@@ -2,7 +2,9 @@
 from admin_api.serializers.document import DocumentTemplateAdminSerializer, IssuedDocumentAdminSerializer
 from core.authz import IsSuperUser
 from core.const.tag import OpenAPITag
-from core.viewset.json_schema_viewset import JsonSchemaViewSet
+from core.pagination import AdminPagination
+from core.viewset.json_schema_viewset import JsonSchemaMixin
+from core.viewset.selectables_viewset import SelectablesMixin
 from document.models import DocumentTemplate, IssuedDocument
 from drf_spectacular.utils import extend_schema, extend_schema_view
 from rest_framework import request, response
@@ -14,15 +16,17 @@
 
 
 @extend_schema_view(**{m: extend_schema(tags=[OpenAPITag.ADMIN_DOCUMENT]) for m in TEMPLATE_METHODS})
-class DocumentTemplateAdminViewSet(JsonSchemaViewSet, ModelViewSet):
+class DocumentTemplateAdminViewSet(JsonSchemaMixin, SelectablesMixin, ModelViewSet):
+    pagination_class = AdminPagination
     http_method_names = ["get", "post", "patch", "delete"]
     permission_classes = [IsSuperUser]
     serializer_class = DocumentTemplateAdminSerializer
     queryset = DocumentTemplate.objects.filter_active().select_related_with_user().order_by("-created_at", "pk")
 
 
 @extend_schema_view(**{m: extend_schema(tags=[OpenAPITag.ADMIN_DOCUMENT]) for m in ISSUED_METHODS})
-class IssuedDocumentAdminViewSet(JsonSchemaViewSet, ReadOnlyModelViewSet):
+class IssuedDocumentAdminViewSet(JsonSchemaMixin, SelectablesMixin, ReadOnlyModelViewSet):
+    pagination_class = AdminPagination
     permission_classes = [IsSuperUser]
     filterset_class = IssuedDocumentAdminFilterSet
     serializer_class = IssuedDocumentAdminSerializer

app/admin_api/views/event/event.py

@@ -3,7 +3,9 @@
 from admin_api.serializers.event.event import EventAdminSerializer
 from core.authz import IsSuperUser
 from core.const.tag import OpenAPITag
-from core.viewset.json_schema_viewset import JsonSchemaViewSet
+from core.pagination import AdminPagination
+from core.viewset.json_schema_viewset import JsonSchemaMixin
+from core.viewset.selectables_viewset import SelectablesMixin
 from drf_spectacular.utils import extend_schema, extend_schema_view
 from event.models import Event
 from rest_framework import viewsets
@@ -12,7 +14,8 @@
 
 
 @extend_schema_view(**{m: extend_schema(tags=[OpenAPITag.ADMIN_EVENT_EVENT]) for m in ADMIN_METHODS})
-class EventAdminViewSet(JsonSchemaViewSet, viewsets.ModelViewSet):
+class EventAdminViewSet(JsonSchemaMixin, SelectablesMixin, viewsets.ModelViewSet):
+    pagination_class = AdminPagination
     http_method_names = ["get", "post", "patch", "delete"]
     serializer_class = EventAdminSerializer
     permission_classes = [IsSuperUser]

app/admin_api/views/event/presentation.py

@@ -18,7 +18,9 @@
 )
 from core.authz import IsSuperUser
 from core.const.tag import OpenAPITag
-from core.viewset.json_schema_viewset import JsonSchemaViewSet
+from core.pagination import AdminPagination
+from core.viewset.json_schema_viewset import JsonSchemaMixin
+from core.viewset.selectables_viewset import SelectablesMixin
 from drf_spectacular.utils import extend_schema, extend_schema_view
 from event.presentation.models import (
     Presentation,
@@ -34,7 +36,8 @@
 
 
 @extend_schema_view(**{m: extend_schema(tags=[OpenAPITag.ADMIN_EVENT_PRESENTATION]) for m in ADMIN_METHODS})
-class PresentationTypeAdminViewSet(JsonSchemaViewSet, viewsets.ModelViewSet):
+class PresentationTypeAdminViewSet(JsonSchemaMixin, SelectablesMixin, viewsets.ModelViewSet):
+    pagination_class = AdminPagination
     http_method_names = ["get", "post", "patch", "delete"]
     serializer_class = PresentationTypeAdminSerializer
     permission_classes = [IsSuperUser]
@@ -47,7 +50,8 @@ class PresentationTypeAdminViewSet(JsonSchemaViewSet, viewsets.ModelViewSet):
 
 
 @extend_schema_view(**{m: extend_schema(tags=[OpenAPITag.ADMIN_EVENT_PRESENTATION]) for m in ADMIN_METHODS})
-class PresentationCategoryAdminViewSet(JsonSchemaViewSet, viewsets.ModelViewSet):
+class PresentationCategoryAdminViewSet(JsonSchemaMixin, SelectablesMixin, viewsets.ModelViewSet):
+    pagination_class = AdminPagination
     http_method_names = ["get", "post", "patch", "delete"]
     serializer_class = PresentationCategoryAdminSerializer
     permission_classes = [IsSuperUser]
@@ -60,7 +64,8 @@ class PresentationCategoryAdminViewSet(JsonSchemaViewSet, viewsets.ModelViewSet)
 
 
 @extend_schema_view(**{m: extend_schema(tags=[OpenAPITag.ADMIN_EVENT_PRESENTATION]) for m in ADMIN_METHODS})
-class PresentationAdminViewSet(JsonSchemaViewSet, viewsets.ModelViewSet):
+class PresentationAdminViewSet(JsonSchemaMixin, SelectablesMixin, viewsets.ModelViewSet):
+    pagination_class = AdminPagination
     http_method_names = ["get", "post", "patch", "delete"]
     serializer_class = PresentationAdminSerializer
     permission_classes = [IsSuperUser]
@@ -74,7 +79,8 @@ class PresentationAdminViewSet(JsonSchemaViewSet, viewsets.ModelViewSet):
 
 
 @extend_schema_view(**{m: extend_schema(tags=[OpenAPITag.ADMIN_EVENT_PRESENTATION]) for m in ADMIN_METHODS})
-class PresentationSpeakerAdminViewSet(JsonSchemaViewSet, viewsets.ModelViewSet):
+class PresentationSpeakerAdminViewSet(JsonSchemaMixin, SelectablesMixin, viewsets.ModelViewSet):
+    pagination_class = AdminPagination
     http_method_names = ["get", "post", "patch", "delete"]
     serializer_class = PresentationSpeakerAdminSerializer
     permission_classes = [IsSuperUser]
@@ -85,7 +91,8 @@ class PresentationSpeakerAdminViewSet(JsonSchemaViewSet, viewsets.ModelViewSet):
 
 
 @extend_schema_view(**{m: extend_schema(tags=[OpenAPITag.ADMIN_EVENT_PRESENTATION]) for m in ADMIN_METHODS})
-class RoomAdminViewSet(JsonSchemaViewSet, viewsets.ModelViewSet):
+class RoomAdminViewSet(JsonSchemaMixin, SelectablesMixin, viewsets.ModelViewSet):
+    pagination_class = AdminPagination
     http_method_names = ["get", "post", "patch", "delete"]
     serializer_class = RoomAdminSerializer
     permission_classes = [IsSuperUser]
@@ -94,7 +101,8 @@ class RoomAdminViewSet(JsonSchemaViewSet, viewsets.ModelViewSet):
 
 
 @extend_schema_view(**{m: extend_schema(tags=[OpenAPITag.ADMIN_EVENT_PRESENTATION]) for m in ADMIN_METHODS})
-class RoomScheduleAdminViewSet(JsonSchemaViewSet, viewsets.ModelViewSet):
+class RoomScheduleAdminViewSet(JsonSchemaMixin, SelectablesMixin, viewsets.ModelViewSet):
+    pagination_class = AdminPagination
     http_method_names = ["get", "post", "patch", "delete"]
     serializer_class = RoomScheduleAdminSerializer
     permission_classes = [IsSuperUser]

app/admin_api/views/event/sponsor.py

@@ -12,7 +12,9 @@
 )
 from core.authz import IsSuperUser
 from core.const.tag import OpenAPITag
-from core.viewset.json_schema_viewset import JsonSchemaViewSet
+from core.pagination import AdminPagination
+from core.viewset.json_schema_viewset import JsonSchemaMixin
+from core.viewset.selectables_viewset import SelectablesMixin
 from django.db import models
 from drf_spectacular.utils import extend_schema, extend_schema_view
 from event.sponsor.models import Sponsor, SponsorTag, SponsorTier
@@ -22,7 +24,8 @@
 
 
 @extend_schema_view(**{m: extend_schema(tags=[OpenAPITag.ADMIN_EVENT_SPONSOR]) for m in ADMIN_METHODS})
-class SponsorTierAdminViewSet(JsonSchemaViewSet, viewsets.ModelViewSet):
+class SponsorTierAdminViewSet(JsonSchemaMixin, SelectablesMixin, viewsets.ModelViewSet):
+    pagination_class = AdminPagination
     http_method_names = ["get", "post", "patch", "delete"]
     serializer_class = SponsorTierAdminSerializer
     permission_classes = [IsSuperUser]
@@ -42,7 +45,8 @@ class SponsorTierAdminViewSet(JsonSchemaViewSet, viewsets.ModelViewSet):
 
 
 @extend_schema_view(**{m: extend_schema(tags=[OpenAPITag.ADMIN_EVENT_SPONSOR]) for m in ADMIN_METHODS})
-class SponsorTagAdminViewSet(JsonSchemaViewSet, viewsets.ModelViewSet):
+class SponsorTagAdminViewSet(JsonSchemaMixin, SelectablesMixin, viewsets.ModelViewSet):
+    pagination_class = AdminPagination
     http_method_names = ["get", "post", "patch", "delete"]
     serializer_class = SponsorTagAdminSerializer
     permission_classes = [IsSuperUser]
@@ -53,7 +57,8 @@ class SponsorTagAdminViewSet(JsonSchemaViewSet, viewsets.ModelViewSet):
 
 
 @extend_schema_view(**{m: extend_schema(tags=[OpenAPITag.ADMIN_EVENT_SPONSOR]) for m in ADMIN_METHODS})
-class SponsorAdminViewSet(JsonSchemaViewSet, viewsets.ModelViewSet):
+class SponsorAdminViewSet(JsonSchemaMixin, SelectablesMixin, viewsets.ModelViewSet):
+    pagination_class = AdminPagination
     http_method_names = ["get", "post", "patch", "delete"]
     serializer_class = SponsorAdminSerializer
     permission_classes = [IsSuperUser]

app/admin_api/views/external_api/google_oauth2.py

@@ -4,7 +4,9 @@
 )
 from core.authz import IsSuperUser
 from core.const.tag import OpenAPITag
-from core.viewset.json_schema_viewset import JsonSchemaViewSet
+from core.pagination import AdminPagination
+from core.viewset.json_schema_viewset import JsonSchemaMixin
+from core.viewset.selectables_viewset import SelectablesMixin
 from drf_spectacular.utils import extend_schema, extend_schema_view
 from external_api.google_oauth2.models import GoogleOAuth2
 from rest_framework import decorators, request, response, status, viewsets
@@ -13,7 +15,8 @@
 
 
 @extend_schema_view(**{m: extend_schema(tags=[OpenAPITag.ADMIN_EXT_API_GOOGLE_OAUTH2]) for m in ADMIN_METHODS})
-class GoogleOAuth2AdminViewSet(JsonSchemaViewSet, viewsets.ModelViewSet):
+class GoogleOAuth2AdminViewSet(JsonSchemaMixin, SelectablesMixin, viewsets.ModelViewSet):
+    pagination_class = AdminPagination
     http_method_names = ["get", "post", "patch", "delete"]
     serializer_class = GoogleOAuth2AdminSerializer
     permission_classes = [IsSuperUser]

app/admin_api/views/file.py

@@ -2,7 +2,9 @@
 from admin_api.serializers.file import PublicFileAdmimUploadSerializer, PublicFileAdminSerializer
 from core.authz import IsSuperUser
 from core.const.tag import OpenAPITag
-from core.viewset.json_schema_viewset import JsonSchemaViewSet
+from core.pagination import AdminPagination
+from core.viewset.json_schema_viewset import JsonSchemaMixin
+from core.viewset.selectables_viewset import SelectablesMixin
 from drf_spectacular import utils
 from file.models import PublicFile
 from rest_framework import decorators, mixins, parsers, request, response, serializers, status, viewsets
@@ -15,9 +17,11 @@ class PublicFileAdminViewSet(
     mixins.RetrieveModelMixin,
     mixins.DestroyModelMixin,
     mixins.ListModelMixin,
-    JsonSchemaViewSet,
+    JsonSchemaMixin,
+    SelectablesMixin,
     viewsets.GenericViewSet,
 ):
+    pagination_class = AdminPagination
     serializer_class = PublicFileAdminSerializer
     permission_classes = [IsSuperUser]
     filterset_class = PublicFileAdminFilterSet