feat: 수정 심사 테이블 추가 및 API 추가

Author: MU-Software

app/admin_api/serializers/modification_audit.py

@@ -0,0 +1,84 @@
+import typing
+import unicodedata
+
+from participant_portal_api.models import ModificationAudit, ModificationAuditComment
+from rest_framework import serializers
+from user.models import UserExt
+
+
+class ModificationAuditResponseAdminSerializer(serializers.ModelSerializer):
+    class ModificationAuditCommentAdminSerializer(serializers.ModelSerializer):
+        class ModificationAuditCommentAdminUserSerializer(serializers.ModelSerializer):
+            class Meta:
+                model = UserExt
+                fields = read_only_fields = ("id", "nickname", "is_superuser")
+
+        created_by = ModificationAuditCommentAdminUserSerializer(read_only=True)
+
+        class Meta:
+            model = ModificationAuditComment
+            fields = read_only_fields = ("id", "content", "created_at", "created_by", "updated_at")
+
+    comments = ModificationAuditCommentAdminSerializer(many=True, read_only=True)
+    str_repr = serializers.CharField(source="__str__", read_only=True)
+
+    class Meta:
+        model = ModificationAudit
+        fields = read_only_fields = (
+            "id",
+            "status",
+            "created_at",
+            "updated_at",
+            "modification_data",
+            "comments",
+            "str_repr",
+        )
+
+
+class ModificationAuditApprovalAdminSerializer(serializers.ModelSerializer):
+    class Meta:
+        model = ModificationAudit
+        fields = read_only_fields = ("id",)
+
+    def validate(self, attrs: dict) -> dict:
+        if typing.cast(ModificationAudit, self.instance).status != ModificationAudit.Status.REQUESTED:
+            raise serializers.ValidationError("심사가 진행 중인 수정 요청만 승인할 수 있습니다.")
+
+        return attrs
+
+    def save(self, **kwargs: dict) -> ModificationAudit:
+        instance: ModificationAudit = self.instance
+        instance.status = ModificationAudit.Status.APPROVED
+        instance.apply_modification(save=True)
+
+        return instance
+
+
+class ModificationAuditRejectionAdminSerializer(serializers.ModelSerializer):
+    reason = serializers.CharField(required=True, allow_blank=True, allow_null=True, write_only=True)
+
+    class Meta:
+        model = ModificationAudit
+        fields = ("reason",)
+
+    def validate_reason(self, reason: str | None) -> str | None:
+        if not (reason and (normalized_reason := unicodedata.normalize("NFC", reason).strip())):
+            return None
+
+        return normalized_reason
+
+    def validate(self, attrs: dict) -> dict:
+        if typing.cast(ModificationAudit, self.instance).status != ModificationAudit.Status.REQUESTED:
+            raise serializers.ValidationError("심사가 진행 중인 수정 요청만 반려할 수 있습니다.")
+
+        return attrs
+
+    def save(self, **kwargs: dict) -> ModificationAudit:
+        instance: ModificationAudit = self.instance
+        instance.status = ModificationAudit.Status.REJECTED
+        instance.save(update_fields=["status"])
+
+        if reason := self.validated_data["reason"]:
+            ModificationAuditComment.objects.create(audit=instance, content=reason)
+
+        return instance

app/admin_api/views/modification_audit.py

@@ -0,0 +1,51 @@
+from admin_api.serializers.modification_audit import (
+    ModificationAuditApprovalAdminSerializer,
+    ModificationAuditRejectionAdminSerializer,
+    ModificationAuditResponseAdminSerializer,
+)
+from core.const.tag import OpenAPITag
+from core.permissions import IsSuperUser
+from django.db import models
+from drf_spectacular import utils
+from participant_portal_api.models import ModificationAudit, ModificationAuditComment
+from rest_framework import decorators, mixins, request, response, status, viewsets
+
+
+@utils.extend_schema_view(
+    list=utils.extend_schema(tags=[OpenAPITag.ADMIN_MODIFICATION_AUDIT]),
+    retrieve=utils.extend_schema(tags=[OpenAPITag.ADMIN_MODIFICATION_AUDIT]),
+)
+class ModificationAuditAdminViewSet(mixins.ListModelMixin, mixins.RetrieveModelMixin, viewsets.GenericViewSet):
+    serializer_class = ModificationAuditResponseAdminSerializer
+    permission_classes = [IsSuperUser]
+    queryset = (
+        ModificationAudit.objects.filter_active()
+        .prefetch_related(
+            models.Prefetch("comments", queryset=ModificationAuditComment.objects.select_related("created_by"))
+        )
+        .select_related("created_by", "updated_by", "deleted_by")
+    )
+
+    @utils.extend_schema(
+        tags=[OpenAPITag.ADMIN_MODIFICATION_AUDIT],
+        responses={status.HTTP_200_OK: ModificationAuditApprovalAdminSerializer},
+    )
+    @decorators.action(detail=True, methods=["patch"], url_path="aprove")
+    def cancel_audit(self, request: request.Request, *args: tuple, **kwargs: dict) -> response.Response:
+        serializer = ModificationAuditApprovalAdminSerializer(self.get_object(), data=request.data)
+        serializer.is_valid(raise_exception=True)
+        instance = serializer.save()
+
+        return response.Response(data=self.get_serializer(instance).data)
+
+    @utils.extend_schema(
+        tags=[OpenAPITag.ADMIN_MODIFICATION_AUDIT],
+        responses={status.HTTP_200_OK: ModificationAuditRejectionAdminSerializer},
+    )
+    @decorators.action(detail=True, methods=["patch"], url_path="reject")
+    def reject_audit(self, request: request.Request, *args: tuple, **kwargs: dict) -> response.Response:
+        serializer = ModificationAuditRejectionAdminSerializer(self.get_object(), data=request.data)
+        serializer.is_valid(raise_exception=True)
+        instance = serializer.save()
+
+        return response.Response(data=self.get_serializer(instance).data)