refactor: 어드민 경로 일원화

Author: MU-Software

app/admin_api/test/socialaccount_test.py

@@ -165,7 +165,7 @@ def test_social_account_provider_filter_enum_exposed_in_openapi(api_client):
     assert response.status_code == http.HTTPStatus.OK
     schema = yaml.safe_load(response.content)
 
-    list_path = next(p for p in schema["paths"] if p.endswith("/allauth/social-account/"))
+    list_path = next(p for p in schema["paths"] if p.endswith("/allauth/socialaccount/"))
     params = schema["paths"][list_path]["get"]["parameters"]
     provider = next(p for p in params if p["name"] == "provider")
     assert provider["schema"]["items"]["enum"] == ["google", "kakao"]

app/admin_api/urls.py

@@ -42,13 +42,16 @@
 from django.urls import include, path
 from rest_framework import routers
 
+# 라우트 컨벤션: <app_label 첫 segment>/<model_name>. (프론트 ChoicePicker 가 selectables 라우트를 모델 메타로 유도)
+# 모델 없는 뷰셋(order-notifications, refund-authorizer, charts)은 유도 대상이 아니므로 기존 명시 라우트 유지.
+
 admin_user_router = routers.SimpleRouter()
 admin_user_router.register("userext", UserAdminViewSet, basename="admin-user")
 admin_user_router.register("organization", OrganizationAdminViewSet, basename="admin-organization")
-admin_user_router.register("mcp-token", McpTokenAdminViewSet, basename="admin-mcp-token")
+admin_user_router.register("mcptoken", McpTokenAdminViewSet, basename="admin-mcp-token")
 
 admin_cms_router = routers.SimpleRouter()
-admin_cms_router.register("domain-group", DomainGroupAdminViewSet, basename="admin-domain-group")
+admin_cms_router.register("domaingroup", DomainGroupAdminViewSet, basename="admin-domain-group")
 admin_cms_router.register("sitemap", SitemapAdminViewSet, basename="admin-sitemap")
 admin_cms_router.register("page", PageAdminViewSet, basename="admin-page")
 
@@ -67,76 +70,74 @@
 admin_event_router.register("room", RoomAdminViewSet)
 admin_event_router.register("roomschedule", RoomScheduleAdminViewSet)
 
-admin_modificationaudit_router = routers.SimpleRouter()
-admin_modificationaudit_router.register(
-    "modification-audit", ModificationAuditAdminViewSet, basename="admin-modification-audit"
+admin_participant_portal_router = routers.SimpleRouter()
+admin_participant_portal_router.register(
+    "modificationaudit", ModificationAuditAdminViewSet, basename="admin-modification-audit"
 )
 
-admin_notification_email_router = routers.SimpleRouter()
-admin_notification_email_router.register(
-    "template", EmailNotificationTemplateAdminViewSet, basename="admin-notification-email-template"
+admin_notification_router = routers.SimpleRouter()
+admin_notification_router.register(
+    "emailnotificationtemplate", EmailNotificationTemplateAdminViewSet, basename="admin-notification-email-template"
 )
-admin_notification_email_router.register(
-    "history", EmailNotificationHistoryAdminViewSet, basename="admin-notification-email-history"
+admin_notification_router.register(
+    "emailnotificationhistory", EmailNotificationHistoryAdminViewSet, basename="admin-notification-email-history"
 )
-
-admin_notification_kakao_router = routers.SimpleRouter()
-admin_notification_kakao_router.register(
-    "template",
+admin_notification_router.register(
+    "nhncloudkakaoalimtalknotificationtemplate",
     NHNCloudKakaoAlimTalkNotificationTemplateAdminViewSet,
     basename="admin-notification-kakao-template",
 )
-admin_notification_kakao_router.register(
-    "history",
+admin_notification_router.register(
+    "nhncloudkakaoalimtalknotificationhistory",
     NHNCloudKakaoAlimTalkNotificationHistoryAdminViewSet,
     basename="admin-notification-kakao-history",
 )
-
-admin_notification_sms_router = routers.SimpleRouter()
-admin_notification_sms_router.register(
-    "template", NHNCloudSMSNotificationTemplateAdminViewSet, basename="admin-notification-sms-template"
+admin_notification_router.register(
+    "nhncloudsmsnotificationtemplate",
+    NHNCloudSMSNotificationTemplateAdminViewSet,
+    basename="admin-notification-sms-template",
 )
-admin_notification_sms_router.register(
-    "history", NHNCloudSMSNotificationHistoryAdminViewSet, basename="admin-notification-sms-history"
+admin_notification_router.register(
+    "nhncloudsmsnotificationhistory",
+    NHNCloudSMSNotificationHistoryAdminViewSet,
+    basename="admin-notification-sms-history",
 )
 
-admin_external_api_google_router = routers.SimpleRouter()
-admin_external_api_google_router.register("oauth2", GoogleOAuth2AdminViewSet, basename="admin-google-oauth2")
+admin_external_api_router = routers.SimpleRouter()
+admin_external_api_router.register("googleoauth2", GoogleOAuth2AdminViewSet, basename="admin-google-oauth2")
 
 admin_shop_router = routers.SimpleRouter()
-admin_shop_router.register("orders", OrderAdminViewSet, basename="admin-shop-order")
+admin_shop_router.register("order", OrderAdminViewSet, basename="admin-shop-order")
 admin_shop_router.register(
     "order-notifications", OrderNotificationAdminViewSet, basename="admin-shop-order-notification"
 )
-admin_shop_router.register("products", ProductAdminViewSet, basename="admin-shop-product")
-admin_shop_router.register("categories", CategoryAdminViewSet, basename="admin-shop-category")
-admin_shop_router.register("tags", TagAdminViewSet, basename="admin-shop-tag")
-admin_shop_router.register("category-groups", CategoryGroupAdminViewSet, basename="admin-shop-category-group")
-admin_shop_router.register("option-groups", OptionGroupAdminViewSet, basename="admin-shop-option-group")
+admin_shop_router.register("product", ProductAdminViewSet, basename="admin-shop-product")
+admin_shop_router.register("category", CategoryAdminViewSet, basename="admin-shop-category")
+admin_shop_router.register("tag", TagAdminViewSet, basename="admin-shop-tag")
+admin_shop_router.register("categorygroup", CategoryGroupAdminViewSet, basename="admin-shop-category-group")
+admin_shop_router.register("optiongroup", OptionGroupAdminViewSet, basename="admin-shop-option-group")
 admin_shop_router.register("refund-authorizer", RefundAuthorizerAdminViewSet, basename="admin-shop-refund-authorizer")
 
 admin_document_router = routers.SimpleRouter()
-admin_document_router.register("templates", DocumentTemplateAdminViewSet, basename="admin-document-template")
-admin_document_router.register("issued", IssuedDocumentAdminViewSet, basename="admin-document-issued")
+admin_document_router.register("documenttemplate", DocumentTemplateAdminViewSet, basename="admin-document-template")
+admin_document_router.register("issueddocument", IssuedDocumentAdminViewSet, basename="admin-document-issued")
 
 admin_dashboard_router = routers.SimpleRouter()
 admin_dashboard_router.register("charts", DashboardChartAdminViewSet, basename="admin-dashboard-chart")
 
 admin_allauth_router = routers.SimpleRouter()
-admin_allauth_router.register("social-app", SocialAppAdminViewSet, basename="admin-social-app")
-admin_allauth_router.register("social-account", SocialAccountAdminViewSet, basename="admin-social-account")
-admin_allauth_router.register("email-address", EmailAddressAdminViewSet, basename="admin-email-address")
+admin_allauth_router.register("socialapp", SocialAppAdminViewSet, basename="admin-social-app")
+admin_allauth_router.register("socialaccount", SocialAccountAdminViewSet, basename="admin-social-account")
+admin_allauth_router.register("emailaddress", EmailAddressAdminViewSet, basename="admin-email-address")
 
 urlpatterns = [
     path("cms/", include(admin_cms_router.urls)),
     path("file/", include(admin_file_router.urls)),
     path("user/", include(admin_user_router.urls)),
     path("event/", include(admin_event_router.urls)),
-    path("modification-audit/", include(admin_modificationaudit_router.urls)),
-    path("notification/email/", include(admin_notification_email_router.urls)),
-    path("notification/kakao-alimtalk/", include(admin_notification_kakao_router.urls)),
-    path("notification/sms/", include(admin_notification_sms_router.urls)),
-    path("external-api/google/", include(admin_external_api_google_router.urls)),
+    path("participant_portal_api/", include(admin_participant_portal_router.urls)),
+    path("notification/", include(admin_notification_router.urls)),
+    path("external_api/", include(admin_external_api_router.urls)),
     path("shop/", include(admin_shop_router.urls)),
     path("document/", include(admin_document_router.urls)),
     path("dashboard/", include(admin_dashboard_router.urls)),

app/core/openapi/ui_hints.py

@@ -9,10 +9,14 @@ def ui_hints_for_model_field(model_field: object) -> dict:
     hints: dict = {}
 
     if isinstance(model_field, (ForeignKey, ManyToManyField)):
+        hints["ui:options"] = {
+            "choiceApp": model_field.related_model._meta.app_config.name.split(".")[0],
+            "choiceResource": model_field.related_model._meta.model_name,
+        }
         if meta_schema := getattr(model_field.related_model, "choices_meta_schema", None):
             if hasattr(model_field.related_model, "get_audit_choice_meta"):
                 meta_schema = meta_schema | AUDIT_CHOICE_META_SCHEMA
-            hints["ui:options"] = {"choiceMetaSchema": meta_schema}
+            hints["ui:options"]["choiceMetaSchema"] = meta_schema
 
     if isinstance(model_field, ManyToManyField):
         return hints | {"ui:field": "m2m_select"}

app/core/viewset/json_schema_viewset.py

@@ -155,3 +155,18 @@ def response_json_schema(self, *args: tuple, **kwargs: dict) -> response.Respons
     @decorators.action(detail=False, methods=["get"], url_path="choices")
     def response_choices(self, *args: tuple, **kwargs: dict) -> response.Response:
         return response.Response(data=self.get_choices())
+
+    @utils.extend_schema(
+        tags=[OpenAPITag.ADMIN_JSON_SCHEMA],
+        summary="Selectables (this model's instances as choices)",
+        responses={status.HTTP_200_OK: openapi.OpenApiResponse(response=types.OpenApiTypes.OBJECT)},
+    )
+    @decorators.action(detail=False, methods=["get"], url_path="selectables")
+    def response_selectables(self, *args: tuple, **kwargs: dict) -> response.Response:
+        qs = self.get_queryset()
+        return response.Response(
+            data={
+                "results": self._get_choices_from_queryset(qs, False),
+                "meta_schema": getattr(qs.model, "choices_meta_schema", None) or {},
+            }
+        )

mcp_app/routes.py

@@ -32,7 +32,7 @@ def route_map(self) -> RouteMap:
     # ── CMS 도메인 그룹(어드민 읽기) ──
     Route(
         method="GET",
-        path="/v1/admin-api/cms/domain-group/",
+        path="/v1/admin-api/cms/domaingroup/",
         summary="도메인 그룹 목록",
         description="프론트엔드 도메인 그룹(name + domains 호스트 목록)을 조회합니다. "
         "CMS 페이지/사이트맵의 domain_group 이 어떤 실제 도메인(예: 2026.pycon.kr)에 대응하는지 확인하고, "
@@ -140,54 +140,54 @@ def route_map(self) -> RouteMap:
     # ── 쇼핑 주문·상품(어드민 읽기 전용) ──
     Route(
         method="GET",
-        path="/v1/admin-api/shop/category-groups/",
+        path="/v1/admin-api/shop/categorygroup/",
         summary="카테고리 그룹 목록",
         description='티켓 카테고리 그룹(예: "2024"/"2025"/"2026") 목록(id+이름). '
         "여기서 얻은 id 로 상품/주문을 category_group 으로 필터해 연도를 구분하세요.",
     ),
     Route(
         method="GET",
-        path="/v1/admin-api/shop/orders/",
+        path="/v1/admin-api/shop/order/",
         summary="주문 목록",
         description="주문을 조회/필터합니다(읽기 전용, 페이지네이션 count/results). 연도 구분은 category_group=<그룹 id> 로.",
     ),
     Route(
         method="GET",
-        path="/v1/admin-api/shop/orders/{id}/",
+        path="/v1/admin-api/shop/order/{id}/",
         summary="주문 상세",
     ),
     Route(
         method="GET",
-        path="/v1/admin-api/shop/products/",
+        path="/v1/admin-api/shop/product/",
         summary="상품 목록",
         description="상품을 조회/필터합니다(읽기 전용). 연도 구분은 category_group=<그룹 id> 로.",
     ),
     Route(
         method="GET",
-        path="/v1/admin-api/shop/products/{id}/",
+        path="/v1/admin-api/shop/product/{id}/",
         summary="상품 상세",
     ),
     Route(
         method="GET",
-        path="/v1/admin-api/shop/products/choices/",
+        path="/v1/admin-api/shop/product/choices/",
         summary="상품 관계 선택지",
         description="상품의 FK/M2M 선택지(category, tag 등; const=id, title=표시명). category id 로 상품/주문을 필터할 수 있습니다.",
     ),
     Route(
         method="GET",
-        path="/v1/admin-api/shop/categories/",
+        path="/v1/admin-api/shop/category/",
         summary="카테고리 목록",
         description="카테고리 목록(id, 이름, group, event, is_ticket). group/event/is_ticket 으로 필터 가능. "
         "상품/주문을 category=<id> 로 필터할 때 id 출처.",
     ),
     Route(
         method="GET",
-        path="/v1/admin-api/shop/categories/{id}/",
+        path="/v1/admin-api/shop/category/{id}/",
         summary="카테고리 상세",
     ),
     Route(
         method="GET",
-        path="/v1/admin-api/shop/categories/choices/",
+        path="/v1/admin-api/shop/category/choices/",
         summary="카테고리 관계 선택지",
         description="카테고리의 FK 선택지: group(카테고리 그룹=연도)·event(const=id, title=표시명).",
     ),