feat: 참가자 포탈용 preview API 추가

Author: MU-Software

app/participant_portal_api/serializers/modification_audit_preview.py

@@ -0,0 +1,25 @@
+from participant_portal_api.models import ModificationAudit
+from participant_portal_api.serializers.modification_audit import ModificationAuditResponsePortalSerializer
+from participant_portal_api.serializers.presentation import PresentationPortalSerializer
+from participant_portal_api.serializers.user import UserPortalSerializer
+from rest_framework import serializers
+
+
+class ModificationAuditPresentationPreviewPortalSerializer(serializers.ModelSerializer):
+    modification_audit = ModificationAuditResponsePortalSerializer(read_only=True, source="*")
+    original = PresentationPortalSerializer(read_only=True, source="fake_original_instance")
+    modified = PresentationPortalSerializer(read_only=True, source="fake_modified_instance")
+
+    class Meta:
+        model = ModificationAudit
+        fields = read_only_fields = ("id", "modification_audit", "original", "modified")
+
+
+class ModificationAuditUserPreviewPortalSerializer(serializers.ModelSerializer):
+    modification_audit = ModificationAuditResponsePortalSerializer(read_only=True, source="*")
+    original = UserPortalSerializer(read_only=True, source="fake_original_instance")
+    modified = UserPortalSerializer(read_only=True, source="fake_modified_instance")
+
+    class Meta:
+        model = ModificationAudit
+        fields = read_only_fields = ("id", "modification_audit", "original", "modified")

app/participant_portal_api/views/modification_audit.py

@@ -1,13 +1,29 @@
 from core.const.tag import OpenAPITag
 from django.db import models
 from drf_spectacular import utils
+from drf_standardized_errors.openapi_serializers import (
+    ValidationErrorEnum,
+    ValidationErrorResponseSerializer,
+    ValidationErrorSerializer,
+)
+from event.presentation.models import Presentation
 from participant_portal_api.models import ModificationAudit, ModificationAuditComment
 from participant_portal_api.permissions import IsSessionSpeaker
 from participant_portal_api.serializers.modification_audit import (
     ModificationAuditCancelPortalSerializer,
     ModificationAuditResponsePortalSerializer,
 )
-from rest_framework import decorators, mixins, request, response, viewsets
+from participant_portal_api.serializers.modification_audit_preview import (
+    ModificationAuditPresentationPreviewPortalSerializer,
+    ModificationAuditUserPreviewPortalSerializer,
+)
+from rest_framework import decorators, mixins, request, response, serializers, status, viewsets
+from user.models import UserExt
+
+MODEL_SERIALIZER_MAP: dict[models.Model, type[serializers.Serializer]] = {
+    Presentation: ModificationAuditPresentationPreviewPortalSerializer,
+    UserExt: ModificationAuditUserPreviewPortalSerializer,
+}
 
 
 @utils.extend_schema_view(
@@ -43,3 +59,36 @@ def cancel_audit(self, request: request.Request, *args: tuple, **kwargs: dict) -
         instance = serializer.save()
 
         return response.Response(data=self.get_serializer(instance).data)
+
+    @utils.extend_schema(
+        tags=[OpenAPITag.PARTICIPANT_PORTAL_MODIFICATION_AUDIT],
+        responses={
+            status.HTTP_200_OK: ModificationAuditPresentationPreviewPortalSerializer,
+            status.HTTP_400_BAD_REQUEST: ValidationErrorResponseSerializer,
+        },
+    )
+    @decorators.action(detail=True, methods=["get"], url_path="preview")
+    def preview_modification_audit(self, request: request.Request, *args: tuple, **kwargs: dict) -> response.Response:
+        audit: ModificationAudit = self.get_object()
+
+        if serializer := MODEL_SERIALIZER_MAP.get(audit.instance_type.model_class()):
+            return response.Response(data=serializer(audit, context={"request": request}).data)
+
+        return response.Response(
+            data=ValidationErrorResponseSerializer(
+                instance={
+                    "type": ValidationErrorEnum.VALIDATION_ERROR,
+                    "errors": ValidationErrorSerializer(
+                        instance=[
+                            {
+                                "code": "modification_audit_preview_error",
+                                "detail": f"지원하지 않는 모델: {audit.instance_type.model_class().__name__}",
+                                "attr": "instance",
+                            }
+                        ],
+                        many=True,
+                    ).data,
+                },
+            ).data,
+            status=status.HTTP_400_BAD_REQUEST,
+        )