feat: 어드민 API의 수정 심사 관련 API 추가

Author: MU-Software

packages/common/src/apis/admin_api.ts

@@ -77,6 +77,29 @@ namespace BackendAdminAPIs {
         `v1/admin-api/cms/page/${pageId}/section/bulk-update/`,
         data
       );
+
+  export const approveModificationAudit = (client: BackendAPIClient, id: string) => (reason?: string | null) =>
+    client.patch<BackendAdminAPISchemas.ModificationAuditSchema, { reason?: string | null }>(
+      `v1/admin-api/modification-audit/modification-audit/${id}/approve/`,
+      { reason: reason ?? null }
+    );
+
+  export const rejectModificationAudit = (client: BackendAPIClient, id: string) => (reason?: string | null) =>
+    client.patch<BackendAdminAPISchemas.ModificationAuditSchema, { reason?: string | null }>(
+      `v1/admin-api/modification-audit/modification-audit/${id}/reject/`,
+      { reason: reason ?? null }
+    );
+
+  export const previewModificationAudit =
+    <T>(client: BackendAPIClient, app: string, resource: string, instanceId: string, auditId: string) =>
+    async () => {
+      try {
+        return await client.get<T>(`v1/admin-api/${app}/${resource}/${instanceId}/preview/${auditId}/`);
+        // eslint-disable-next-line @typescript-eslint/no-unused-vars
+      } catch (_) {
+        return null;
+      }
+    };
 }
 
 export default BackendAdminAPIs;

packages/common/src/hooks/useAdminAPI.ts

@@ -19,6 +19,8 @@ const MUTATION_KEYS = {
   ADMIN_CREATE: ["mutation", "admin", "create"],
   ADMIN_UPDATE: ["mutation", "admin", "update"],
   ADMIN_REMOVE: ["mutation", "admin", "remove"],
+  ADMIN_APPROVE_MODIFICATION_AUDIT: ["mutation", "admin", "approve", "modification-audit"],
+  ADMIN_REJECT_MODIFICATION_AUDIT: ["mutation", "admin", "reject", "modification-audit"],
 };
 
 namespace BackendAdminAPIHooks {
@@ -122,6 +124,30 @@ namespace BackendAdminAPIHooks {
       mutationKey: [...MUTATION_KEYS.ADMIN_UPDATE, "cms", "page", pageId, "section"],
       mutationFn: BackendAdminAPIs.bulkUpdateSections(client, pageId),
     });
+
+  export const useApproveModificationAuditMutation = (client: BackendAPIClient, id: string) =>
+    useMutation({
+      mutationKey: MUTATION_KEYS.ADMIN_APPROVE_MODIFICATION_AUDIT,
+      mutationFn: BackendAdminAPIs.approveModificationAudit(client, id),
+    });
+
+  export const useRejectModificationAuditMutation = (client: BackendAPIClient, id: string) =>
+    useMutation({
+      mutationKey: MUTATION_KEYS.ADMIN_REJECT_MODIFICATION_AUDIT,
+      mutationFn: BackendAdminAPIs.rejectModificationAudit(client, id),
+    });
+
+  export const useModificationAuditPreviewRetrieveQuery = <T>(
+    client: BackendAPIClient,
+    app: string,
+    resource: string,
+    instanceId: string,
+    auditId: string
+  ) =>
+    useSuspenseQuery({
+      queryKey: [...QUERY_KEYS.ADMIN_RETRIEVE, app, resource, instanceId, "preview", auditId],
+      queryFn: BackendAdminAPIs.previewModificationAudit<T>(client, app, resource, instanceId, auditId),
+    });
 }
 
 export default BackendAdminAPIHooks;

packages/common/src/schemas/backendAdminAPI.ts

@@ -82,6 +82,44 @@ namespace BackendAdminAPISchemas {
   };
 
   export type PageSectionBulkUpdateSchema = PageSectionSchema | Omit<PageSectionSchema, "id">;
+
+  export type PresentationSchema = {
+    id: string; // UUID
+    type: string; // UUID of the presentation type
+    categories: string[]; // Array of category UUIDs
+    title_ko: string;
+    title_en: string;
+    summary_ko: string;
+    summary_en: string;
+    description_ko: string;
+    description_en: string;
+    image: string | null;
+  };
+
+  export type ModificationAuditSchema = {
+    id: string; // UUID
+    status: "requested" | "approved" | "rejected" | "cancelled"; // Status of the modification request
+    created_at: string; // ISO 8601 timestamp
+    updated_at: string; // ISO 8601 timestamp
+    modification_data: string; // JSON string containing the modification data
+    str_repr: string; // String representation of the modification audit, e.g., "Presentation Title - Status"
+    comments: {
+      id: string; // UUID of the comment
+      content: string; // Content of the comment
+      created_at: string; // ISO 8601 timestamp
+      created_by: {
+        id: number; // User ID of the commenter
+        nickname: string; // Nickname of the commenter
+        is_superuser: boolean; // Whether the commenter is a staff member
+      };
+      updated_at: string; // ISO 8601 timestamp
+    }[];
+    instance: {
+      app: string;
+      model: string;
+      id: string; // UUID of the instance being modified, e.g., presentation ID
+    };
+  };
 }
 
 export default BackendAdminAPISchemas;