💫 [feature] - 관리자 미션 검수 화면

pages/admin/review.tsx

@@ -0,0 +1,10 @@
+import { createRoute } from '@granite-js/react-native';
+import { AdminReviewScreen } from '../../src/features/profile/AdminReviewScreen';
+
+export const Route = createRoute('/admin/review', {
+    component: Page,
+});
+
+function Page() {
+    return <AdminReviewScreen />;
+}

src/api/adminMissionReview.ts

@@ -0,0 +1,153 @@
+import { apiRequest, ApiClientError, isApiEnabled } from './client';
+import { API_PATHS } from './notion/types';
+
+export type AdminReviewStatus = 'APPROVED' | 'REJECTED';
+
+export type AdminMissionPendingItem = {
+    completionId: number;
+    userId: number;
+    userNickname: string | null;
+    missionId: number;
+    missionTitle: string;
+    photoKey: string;
+    /** BE 추가 예정 — 있으면 미리보기에 우선 사용 */
+    photoUrl?: string | null;
+    submittedAt: string;
+};
+
+export type AdminCommunityProofPendingItem = {
+    proofId: number;
+    communityMissionId: number;
+    communityMissionTitle: string;
+    requirementId: number;
+    proofOrder: number;
+    requirementTitle: string | null;
+    userId: number;
+    nickname: string | null;
+    submittedAt: string;
+    imageKeys: string[];
+    /** BE 추가 예정 — 있으면 미리보기에 우선 사용 */
+    imageUrls?: string[] | null;
+};
+
+type CommunityPendingPage = {
+    items: AdminCommunityProofPendingItem[];
+    page: number;
+    size: number;
+    totalElements: number;
+    totalPages: number;
+    hasNext: boolean;
+};
+
+/** BE 공개 에셋 베이스 — photoKey 폴백용 (현재 미션 경로는 403일 수 있음). */
+export const PUBLIC_ASSETS_BASE_URL = 'https://assets.zero-st.com';
+
+export function publicAssetUrl(fileKey: string): string {
+    const trimmed = fileKey.trim().replace(/^\//, '');
+    return `${PUBLIC_ASSETS_BASE_URL}/${trimmed}`;
+}
+
+/** 일일 검수 — photoUrl 우선, 없으면 key로 폴백 */
+export function resolveDailyReviewPhotoUri(item: AdminMissionPendingItem): string | null {
+    const url = item.photoUrl?.trim();
+    if (url != null && url.length > 0) {
+        return url;
+    }
+    if (item.photoKey.trim().length > 0) {
+        return publicAssetUrl(item.photoKey);
+    }
+    return null;
+}
+
+/** 공동 검수 — imageUrls 우선, 없으면 imageKeys 폴백 */
+export function resolveCommunityReviewPhotoUris(
+    item: AdminCommunityProofPendingItem,
+): string[] {
+    const urls = (item.imageUrls ?? [])
+        .map((u) => u.trim())
+        .filter((u) => u.length > 0);
+    if (urls.length > 0) {
+        return urls;
+    }
+    return item.imageKeys
+        .map((k) => k.trim())
+        .filter((k) => k.length > 0)
+        .map(publicAssetUrl);
+}
+
+function bySubmittedAtAsc<T extends { submittedAt: string }>(a: T, b: T): number {
+    return a.submittedAt.localeCompare(b.submittedAt);
+}
+
+/** GET /api/v1/admin/missions/completions/pending — ADMIN만. 일반 유저는 null */
+export async function getAdminMissionCompletionsPending(): Promise<
+    AdminMissionPendingItem[] | null
+> {
+    if (!isApiEnabled()) {
+        return null;
+    }
+    try {
+        const items = await apiRequest<AdminMissionPendingItem[]>(
+            API_PATHS.adminMissionCompletionsPending,
+        );
+        return [...items].sort(bySubmittedAtAsc);
+    } catch (error) {
+        if (
+            error instanceof ApiClientError &&
+            (error.status === 403 || error.code === 'ADMIN_ACCESS_DENIED')
+        ) {
+            return null;
+        }
+        throw error;
+    }
+}
+
+/** POST /api/v1/admin/missions/completions/{id}/review */
+export async function postAdminMissionCompletionReview(
+    completionId: number,
+    status: AdminReviewStatus,
+): Promise<{ completionId: number; status: string }> {
+    return apiRequest(API_PATHS.adminMissionCompletionReview(completionId), {
+        method: 'POST',
+        body: { status },
+    });
+}
+
+/** GET /api/v1/admin/community-missions/proofs/pending */
+export async function getAdminCommunityProofsPending(params?: {
+    page?: number;
+    size?: number;
+}): Promise<CommunityPendingPage | null> {
+    if (!isApiEnabled()) {
+        return null;
+    }
+    const page = params?.page ?? 0;
+    const size = params?.size ?? 50;
+    const path = `${API_PATHS.adminCommunityProofsPending}?page=${page}&size=${size}`;
+    try {
+        const data = await apiRequest<CommunityPendingPage>(path);
+        return {
+            ...data,
+            items: [...(data.items ?? [])].sort(bySubmittedAtAsc),
+        };
+    } catch (error) {
+        if (
+            error instanceof ApiClientError &&
+            (error.status === 403 || error.code === 'ADMIN_ACCESS_DENIED')
+        ) {
+            return null;
+        }
+        throw error;
+    }
+}
+
+/** POST /api/v1/admin/community-missions/proofs/{proofId}/review */
+export async function postAdminCommunityProofReview(
+    proofId: number,
+    status: AdminReviewStatus,
+): Promise<{ proofId: number; status: string }> {
+    return apiRequest(API_PATHS.adminCommunityProofReview(proofId), {
+        method: 'POST',
+        body: { status },
+    });
+}

src/api/notion/types.ts

@@ -236,4 +236,10 @@ export const API_PATHS = {
     adminTesterLink: '/api/v1/admin/tester-link',
     adminUsers: '/api/v1/admin/users',
     adminAssetsGrant: '/api/v1/admin/assets/grant',
+    adminMissionCompletionsPending: '/api/v1/admin/missions/completions/pending',
+    adminMissionCompletionReview: (completionId: number) =>
+        `/api/v1/admin/missions/completions/${completionId}/review`,
+    adminCommunityProofsPending: '/api/v1/admin/community-missions/proofs/pending',
+    adminCommunityProofReview: (proofId: number) =>
+        `/api/v1/admin/community-missions/proofs/${proofId}/review`,
 } as const;

src/features/profile/AdminReviewEntry.tsx

@@ -0,0 +1,88 @@
+import { readAccessTokenRole } from '@api/accessTokenRole';
+import { getAuthSession } from '@api/authSession';
+import { Txt } from '@toss/tds-react-native';
+import { useEffect, useState } from 'react';
+import { Pressable, StyleSheet, View } from 'react-native';
+
+type AdminReviewEntryProps = {
+    onPress: () => void;
+};
+
+/**
+ * ADMIN 전용 — 마이에서 검수 화면으로 들어가는 진입 행.
+ */
+export function AdminReviewEntry({ onPress }: AdminReviewEntryProps) {
+    const [ready, setReady] = useState(false);
+    const [isAdmin, setIsAdmin] = useState(false);
+
+    useEffect(() => {
+        let cancelled = false;
+        (async () => {
+            try {
+                const session = await getAuthSession();
+                const role = readAccessTokenRole(session?.accessToken);
+                if (!cancelled) {
+                    setIsAdmin(role === 'ADMIN');
+                }
+            } finally {
+                if (!cancelled) {
+                    setReady(true);
+                }
+            }
+        })();
+        return () => {
+            cancelled = true;
+        };
+    }, []);
+
+    if (!ready || !isAdmin) {
+        return null;
+    }
+
+    return (
+        <View style={styles.wrap} testID="admin-review-entry">
+            <Txt typography="t5" fontWeight="bold">
+                관리
+            </Txt>
+            <Pressable
+                onPress={onPress}
+                accessibilityRole="button"
+                accessibilityLabel="미션 검수 열기"
+                style={styles.row}
+            >
+                <View style={styles.rowText}>
+                    <Txt typography="t6" fontWeight="bold">
+                        미션 검수
+                    </Txt>
+                    <Txt typography="t7" color="grey600">
+                        일일·공동 인증을 승인하거나 반려해요.
+                    </Txt>
+                </View>
+                <Txt typography="t6" color="blue500">
+                    열기
+                </Txt>
+            </Pressable>
+        </View>
+    );
+}
+
+const styles = StyleSheet.create({
+    wrap: {
+        gap: 10,
+        marginTop: 24,
+        marginBottom: 8,
+    },
+    row: {
+        flexDirection: 'row',
+        alignItems: 'center',
+        gap: 12,
+        paddingVertical: 14,
+        paddingHorizontal: 14,
+        borderRadius: 12,
+        backgroundColor: '#F3F0E8',
+    },
+    rowText: {
+        flex: 1,
+        gap: 4,
+    },
+});