Commit @c8268f0d4b426dded4864a4a484d174e1627eb44

임동욱 08-21

feat: 금융OX퀴즈를 콘텐츠관리 API(/mngr/cntntns/quiz)로 연결

퀴즈가 콘텐츠관리 API 아래로 들어왔다. 경로를 `/api/v1/mngr/quiz`에서
`/api/v1/mngr/cntntns/quiz`로 옮기고 쇼츠·만화와 같은 규약으로 맞춘다 — 등록은 form(중첩
목록은 인덱스 표기), 수정은 JSON, 삭제는 soft delete.

학교·학년이 생겼다. `TB_COM_QUIZ_SCHUL_GRD`에 따로 저장되고 `schulGrdList`로 오간다 —
쇼츠·만화와 같은 모양이라 매핑·전송 규칙을 그대로 쓴다(학년 없는 학교는 `grdCd`를 빼서
GRD_CD에 빈 문자열이 박히지 않게 한다). 수정 화면이 저장된 학교·학년을 불러온다.

엑셀 일괄등록은 기획 중이라 넣지 않았다 — 백엔드에도 업로드 엔드포인트가 없고
`excel/download`만 있다. 버튼과 Server Action을 걷어내고 TODO만 남긴다. 다운로드 경로는 새
API로 옮겼다.

확인(임시 프로브로 실제 요청 캡처): 등록 `POST /cntntns/quiz` form +
`schulGrdList[0].schulCd`, 수정 `PUT /cntntns/quiz/42` JSON, 삭제 `DELETE /cntntns/quiz/42`,
학년 없는 학교는 `grdCd` 파라미터 자체가 빠짐. 응답 매핑도 `schulGrdList` → 학교 코드 +
학년 배열, `useYn:'N'` → 비공개로 확인.

⚠️ 백엔드 결함 5건을 Repository 주석에 적었다. 특히 **등록 INSERT의 컬럼 11개 : 값 10개**
불일치(`USE_YN` 자리 누락)로 지금은 등록이 SQL 오류로 끝난다. 프론트는 `useYn`을 정상적으로
보내므로 값 목록만 맞추면 그대로 동작한다.

Co-Authored-By: Claude Opus 5

@c8268f0d4b426dded4864a4a484d174e1627eb44

4561a14

c8268f0

app/(protected)/(basic)/contents/_actions.ts

--- app/(protected)/(basic)/contents/_actions.ts

+++ app/(protected)/(basic)/contents/_actions.ts


   createQuiz,
   deleteQuiz,
   updateQuiz,
-  uploadQuizExcel,
 } from '@/lib/data/repositories/content-quiz-repository';
 import { CONTENT_TYPE_CODE, type ContentKind } from '@/lib/domain/content';
 import {

   }
 
   revalidatePath(contentListPath(kind));
-  return { status: 'success' };
-}
-
-/** 금융OX퀴즈 엑셀 일괄등록. 한 행이라도 검증에 실패하면 백엔드가 전체를 되돌린다. */
-export async function uploadQuizExcelAction(
-  _prevState: ContentFormState,
-  formData: FormData
-): Promise<ContentFormState> {
-  await verifySession();
-
-  const file = readFiles(formData, 'excelFile')[0] ?? null;
-  if (!file) {
-    return { status: 'error', message: '엑셀 파일을 선택해 주세요.' };
-  }
-
-  try {
-    await uploadQuizExcel(file);
-  } catch (error) {
-    return failure(error, '엑셀을 등록하지 못했습니다.');
-  }
-
-  revalidatePath(contentListPath('quiz'));
   return { status: 'success' };
 }

4561a14

c8268f0

app/(protected)/(basic)/contents/quizzes/_components/quiz-excel-actions.tsx

--- app/(protected)/(basic)/contents/quizzes/_components/quiz-excel-actions.tsx

+++ app/(protected)/(basic)/contents/quizzes/_components/quiz-excel-actions.tsx


 'use client';
 
-import { useActionState, useEffect, useRef } from 'react';
 import { FoxButton } from '@fox/core/components/fox-button';
-import { useFeedback } from '@/app/_hooks/use-feedback';
-import { INITIAL_CONTENT_FORM_STATE } from '@/lib/domain/content-form';
-import { uploadQuizExcelAction } from '../../_actions';
 
 const EXCEL_DOWNLOAD_PATH = '/contents/quizzes/excel';
 
-/** 엑셀 일괄등록 / 다운로드 — 기획 ②. 등록은 파일을 고르는 즉시 올린다. */
+/**
+ * 엑셀 다운로드 — 기획 ②.
+ *
+ * TODO: 같은 자리의 「엑셀등록」(일괄등록)은 기획 중이라 아직 넣지 않았다. 백엔드에도 업로드
+ * 엔드포인트가 없다(`/api/v1/mngr/cntntns/quiz`에 `excel/download`만 있다). 기획이 확정되면
+ * 이 컴포넌트에 버튼과 Server Action을 함께 붙인다.
+ */
 export function QuizExcelActions() {
-  const { showToast } = useFeedback();
-  const inputRef = useRef<HTMLInputElement>(null);
-  const formRef = useRef<HTMLFormElement>(null);
-  const [state, formAction, isPending] = useActionState(
-    uploadQuizExcelAction,
-    INITIAL_CONTENT_FORM_STATE
-  );
-
-  useEffect(() => {
-    if (state.status === 'success') {
-      showToast({ variant: 'success', message: '엑셀을 등록했습니다.' });
-    }
-    if (state.status === 'error') {
-      showToast({
-        variant: 'danger',
-        message: state.message ?? '엑셀을 등록하지 못했습니다.',
-      });
-    }
-  }, [state, showToast]);
-
   return (
-    <>
-      <form ref={formRef} action={formAction} hidden>
-        <input
-          ref={inputRef}
-          type="file"
-          name="excelFile"
-          accept=".xlsx,.xls"
-          onChange={() => formRef.current?.requestSubmit()}
-        />
-      </form>
-
+    <form action={EXCEL_DOWNLOAD_PATH} method="get">
       <FoxButton
         type="secondary"
         size="md"
-        leadingIcon={<i className="fox-ico fox-ico-UploadSimple" aria-hidden="true" />}
-        label="엑셀등록"
-        loading={isPending}
-        onAction={() => inputRef.current?.click()}
+        htmlType="submit"
+        leadingIcon={<i className="fox-ico fox-ico-DownloadSimple" aria-hidden="true" />}
+        label="엑셀다운로드"
       />
-      <form action={EXCEL_DOWNLOAD_PATH} method="get">
-        <FoxButton
-          type="secondary"
-          size="md"
-          htmlType="submit"
-          leadingIcon={<i className="fox-ico fox-ico-DownloadSimple" aria-hidden="true" />}
-          label="엑셀다운로드"
-        />
-      </form>
-    </>
+    </form>
   );
 }

4561a14

c8268f0

app/(protected)/(basic)/contents/quizzes/_components/quiz-form.tsx

--- app/(protected)/(basic)/contents/quizzes/_components/quiz-form.tsx

+++ app/(protected)/(basic)/contents/quizzes/_components/quiz-form.tsx


           <ContentGradeField
             schools={schools}
             gradesBySchool={gradesBySchool}
+            defaultSchoolCode={item?.schoolCode}
+            defaultGrades={item?.grades}
             schoolError={errors.schoolCode}
             gradesError={errors.grades}
           />

4561a14

c8268f0

app/(protected)/(basic)/contents/quizzes/excel/route.ts

--- app/(protected)/(basic)/contents/quizzes/excel/route.ts

+++ app/(protected)/(basic)/contents/quizzes/excel/route.ts


 import { getSessionAccessToken, verifySession } from '@/lib/auth/dal';
 import { backendFetchStream } from '@/lib/http/backend-fetch';
 
-const QUIZ_EXCEL_PATH = '/api/v1/mngr/quiz/excel/download';
+const QUIZ_EXCEL_PATH = '/api/v1/mngr/cntntns/quiz/excel/download';
 
 const EXCEL_TIMEOUT_MS = 60_000;
 

4561a14

c8268f0

lib/data/repositories/content-quiz-repository.ts

--- lib/data/repositories/content-quiz-repository.ts

+++ lib/data/repositories/content-quiz-repository.ts


 import type { QuizFormValues } from '@/lib/domain/content-form';
 
 /**
- * 금융OX퀴즈 Repository — 쇼츠·만화와 테이블(`TB_COM_QUIZ`)도 API도 다르다.
+ * 금융OX퀴즈 Repository — 쇼츠·만화와 테이블(`TB_COM_QUIZ`)은 다르지만 콘텐츠관리 API 아래로
+ * 들어와 규약은 같다(등록은 form, 수정은 JSON, 삭제는 soft delete).
  *
  * ```
- * GET  /api/v1/mngr/quiz/pagination       목록
- * GET  /api/v1/mngr/quiz/excel/download   엑셀 다운로드
- * POST /api/v1/mngr/quiz/excel/upload     엑셀 일괄등록 (multipart, 파트 이름 `file`)
+ * GET    /api/v1/mngr/cntntns/quiz/pagination      학교·학년·난이도·검색어
+ * POST   /api/v1/mngr/cntntns/quiz                 어노테이션 없음 → form(중첩 목록은 인덱스 표기)
+ * PUT    /api/v1/mngr/cntntns/quiz/{quizSn}        @RequestBody(JSON)
+ * DELETE /api/v1/mngr/cntntns/quiz/{quizSn}        soft delete(DEL_YN)
+ * GET    /api/v1/mngr/cntntns/quiz/excel/download  엑셀 다운로드
  * ```
  *
- * 이슈: 등록·수정·삭제·단건조회 API가 없다. 아래 쓰기 함수는 다른 관리 화면과 같은 규약으로
- *   미리 맞춰 둔 것이라 백엔드가 생기기 전에는 실패한다.
- * 이슈: 학교(`COM_SCHUL_CD`)·학년(`GRD_CD`)을 담을 컬럼이 없다. 검색 VO에 `searchSchul`/
- *   `searchGrade`가 있지만 매퍼의 `<if>` 블록이 비어 있어 필터가 조용히 무시된다.
- * 이슈: 키워드가 별도 테이블이 아니라 `quiz_title` 한 칸이다. 목록의 「키워드」 열이 이 값이고,
- *   기획의 "키워드+설명 쌍"을 담을 자리는 아직 없다.
- * 이슈: 정답 노출 문구(기획 "기본 3종 + 기타")를 담을 컬럼이 없다.
+ * 학교·학년은 `TB_COM_QUIZ_SCHUL_GRD`에 따로 저장되고 `schulGrdList`로 오간다 — 쇼츠·만화와
+ * 같은 모양이라 화면 쪽 취급도 같다.
+ *
+ * ⚠️ 백엔드 결함(보고함, 미수정)
+ * 1. **등록 INSERT의 컬럼 수와 값 수가 다르다** — 컬럼은 11개인데 값은 10개고 `USE_YN` 자리가
+ *    비어 있다. 지금은 등록이 SQL 오류로 끝난다. 프론트는 `useYn`을 정상적으로 보내고 있으므로
+ *    백엔드가 값 목록만 맞추면 그대로 동작한다.
+ * 2. 등록 INSERT의 `keyProperty`/`keyColumn`이 `cntntsSn`/`CNTNTS_SN`이다(이 테이블은 `QUIZ_SN`).
+ *    채번된 키가 VO에 담기지 않아 학교·학년 매핑이 `quiz_sn` 없이 저장된다.
+ * 3. 단건 조회 API가 없다 — 매퍼·서비스에는 `selectOne`이 있는데 컨트롤러가 열지 않았다.
+ *    그래서 수정 화면은 목록에서 찾는다(아래 `fetchQuizDetail`).
+ * 4. 검색어가 질문·정답만 본다(`QUIZ_ANSWER`·`QUIZ_QUESTION`). 화면의 「키워드」 검색은
+ *    `QUIZ_TITLE`을 봐야 하는데 조건에 없어 결과가 비어 온다.
+ * 5. 난이도 필터가 SQL에 없다 — `searchLevelCd`를 받지만 `searchWhere`가 쓰지 않는다.
+ *    화면 선택지는 기획대로 두고 값만 실어 보낸다.
  */
 
-const QUIZ_PATH = '/api/v1/mngr/quiz';
+const QUIZ_PATH = '/api/v1/mngr/cntntns/quiz';
 
-/** 목록에서 단건을 찾을 때 한 번에 받아올 최대 행 수(단건 조회 API가 없다). */
+/** 목록에서 단건을 찾을 때 한 번에 받아올 최대 행 수(단건 조회 API가 없다 — 결함 3). */
 const DETAIL_SCAN_LIMIT = 500;
-
-/** 엑셀 업로드는 일반 조회보다 오래 걸린다. */
-const UPLOAD_TIMEOUT_MS = 60_000;
 
 function isRecord(value: unknown): value is Record<string, unknown> {
   return value !== null && typeof value === 'object';

   if (typeof value === 'string' && value.length > 0) return value;
   if (typeof value === 'number') return String(value);
   return null;
+}
+
+/** `schulGrdList` → 화면이 쓰는 학교 코드 + 학년 코드 목록(쇼츠·만화와 같은 규칙). */
+function toSchoolGrades(raw: unknown): { schoolCode: string; grades: string[] } {
+  if (!Array.isArray(raw)) {
+    return { schoolCode: '', grades: [] };
+  }
+
+  const grades: string[] = [];
+  let schoolCode = '';
+
+  for (const entry of raw) {
+    if (!isRecord(entry)) {
+      continue;
+    }
+    schoolCode = schoolCode || (readString(entry, 'schulCd') ?? '');
+    const grade = readString(entry, 'grdCd');
+    if (grade && !grades.includes(grade)) {
+      grades.push(grade);
+    }
+  }
+
+  return { schoolCode, grades };
+}
+
+function toSchoolGradePayload(schoolCode: string, grades: readonly string[]) {
+  if (!schoolCode) {
+    return [];
+  }
+  if (grades.length === 0) {
+    // 학년 없는 학교(전체연령 등)는 학교만 남긴다 — 빈 문자열을 넣으면 GRD_CD에 ''가 박힌다.
+    return [{ schulCd: schoolCode, grdCd: null }];
+  }
+  return grades.map((grade) => ({ schulCd: schoolCode, grdCd: grade }));
 }
 
 function toQuizItem(raw: unknown): QuizItem {

   }
 
   const points = raw.quizPoint;
+  const schulGrd = toSchoolGrades(raw.schulGrdList);
 
   return {
     quizSn,

     explanation: readString(raw, 'quizExplan') ?? '',
     answer: readString(raw, 'quizAnswer') ?? '',
     points: typeof points === 'number' ? points : null,
+    schoolCode: schulGrd.schoolCode,
+    grades: schulGrd.grades,
     isVisible: readString(raw, 'useYn') !== 'N',
     modifiedAt:
       readString(raw, 'lastMdfcnDtStr') ?? readString(raw, 'frstRegDtStr'),

   const keyword = query.keyword.trim();
 
   return {
-    searchSchul: query.school,
-    searchGrade: query.grade,
-    searchLevel: query.level,
-    searchCondition: keyword ? '1' : '',
+    searchSchulGradeCd: query.school,
+    searchGradeCd: query.grade,
+    // 백엔드 SQL이 아직 쓰지 않는다(결함 5). 화면 선택지는 기획대로 두고 값만 보낸다.
+    searchLevelCd: query.level,
     searchKeyword: keyword,
-    searchSortOrder: query.sort,
     pageIndex,
     recordCountPerPage,
   };

     accessToken: accessToken ?? undefined,
     cache: 'no-store',
     canHaveNullData: true,
+    canHaveEmptyBody: true,
   });
 
   if (!result.ok) {

   };
 }
 
-/** TODO: `GET /api/v1/mngr/quiz/{quizSn}`이 생기면 이 스캔을 그 호출로 교체한다. */
+/** TODO: 단건 조회 API(결함 3)가 열리면 이 스캔을 `GET {base}/{quizSn}` 호출로 교체한다. */
 export async function fetchQuizDetail(quizSn: string): Promise<QuizItem | null> {
   const { items } = await requestList(
     {

   return items.find((item) => item.quizSn === quizSn) ?? null;
 }
 
-function buildQuizPayload(values: QuizFormValues) {
+type QuizWritePayload = {
+  quizTitle: string;
+  quizLev: string;
+  quizQuestion: string;
+  quizExplan: string;
+  quizAnswer: string;
+  useYn: string;
+  schulGrdList: Array<{ schulCd: string; grdCd: string | null }>;
+};
+
+/**
+ * 이슈: 정답 노출 문구(기획 "기본 3종 + 기타")를 담을 필드가 백엔드에 없다. 화면은 값을 받지만
+ *   저장되지 않는다 — 컬럼이 생기면 여기에 실어 보낸다.
+ * 이슈: 키워드가 별도 테이블이 아니라 `quizTitle` 한 칸이라 쉼표로 이어 붙인다.
+ */
+function buildQuizPayload(values: QuizFormValues): QuizWritePayload {
   return {
     quizTitle: values.keywords.map((item) => item.keyword).join(', '),
     quizLev: values.level,
     quizQuestion: values.question,
     quizExplan: values.explanation,
     quizAnswer: values.answer,
-    schulCd: values.schoolCode,
-    gradeCd: values.grades.join(','),
-    answerMssageCd: values.answerMessageCode,
-    answerMssage: values.answerMessageText,
     useYn: values.isVisible ? 'Y' : 'N',
+    schulGrdList: toSchoolGradePayload(values.schoolCode, values.grades),
   };
+}
+
+/** 등록만 form이다 — 컨트롤러가 `@RequestBody` 없이 받는다(쇼츠·만화와 같은 갈림). */
+function toFormParams(
+  payload: QuizWritePayload
+): Record<string, string | number | undefined> {
+  const params: Record<string, string | number | undefined> = {
+    quizTitle: payload.quizTitle,
+    quizLev: payload.quizLev,
+    quizQuestion: payload.quizQuestion,
+    quizExplan: payload.quizExplan,
+    quizAnswer: payload.quizAnswer,
+    useYn: payload.useYn,
+  };
+
+  payload.schulGrdList.forEach((item, index) => {
+    params[`schulGrdList[${index}].schulCd`] = item.schulCd;
+    // undefined면 파라미터 자체가 빠져 백엔드에서 null이 된다.
+    params[`schulGrdList[${index}].grdCd`] = item.grdCd ?? undefined;
+  });
+
+  return params;
 }
 
 async function sendWrite(
   path: string,
   method: 'POST' | 'PUT' | 'DELETE',
-  body?: unknown
-): Promise<string | null> {
+  body?: unknown,
+  form?: Record<string, string | number | undefined>
+): Promise<void> {
   const accessToken = await getSessionAccessToken();
 
   const result = await backendFetch<unknown>(path, {
     method,
     ...(body === undefined ? {} : { body }),
+    ...(form === undefined ? {} : { form }),
     accessToken: accessToken ?? undefined,
     cache: 'no-store',
     canHaveNullData: true,

   if (!result.ok) {
     throw new BackendRequestError(result);
   }
-
-  return typeof result.data === 'string' ? result.data : null;
 }
 
-export async function createQuiz(values: QuizFormValues): Promise<string | null> {
-  return sendWrite(QUIZ_PATH, 'POST', buildQuizPayload(values));
+export async function createQuiz(values: QuizFormValues): Promise<void> {
+  await sendWrite(QUIZ_PATH, 'POST', undefined, toFormParams(buildQuizPayload(values)));
 }
 
 export async function updateQuiz(

 
 export async function deleteQuiz(quizSn: string): Promise<void> {
   await sendWrite(`${QUIZ_PATH}/${encodeURIComponent(quizSn)}`, 'DELETE');
-}
-
-/** 엑셀 일괄등록. 한 행이라도 검증에 실패하면 백엔드가 전체를 되돌린다. */
-export async function uploadQuizExcel(file: File): Promise<void> {
-  const accessToken = await getSessionAccessToken();
-
-  const multipart = new FormData();
-  multipart.set('file', file);
-
-  const result = await backendFetch<unknown>(`${QUIZ_PATH}/excel/upload`, {
-    method: 'POST',
-    multipart,
-    accessToken: accessToken ?? undefined,
-    cache: 'no-store',
-    timeoutMs: UPLOAD_TIMEOUT_MS,
-    canHaveNullData: true,
-  });
-
-  if (!result.ok) {
-    throw new BackendRequestError(result);
-  }
 }

4561a14

c8268f0

lib/domain/content.ts

--- lib/domain/content.ts

+++ lib/domain/content.ts


   explanation: string;
   answer: string;
   points: number | null;
+  /** 공통코드 `COM_SCHUL_CD` 코드값. */
+  schoolCode: string;
+  /** 공통코드 `GRD_CD` 코드값. */
+  grades: string[];
   isVisible: boolean;
   modifiedAt: string | null;
 };

Add a comment

Open 0
Closed 0

List

...	...	@@ -20,7 +20,6 @@
20	20	createQuiz,
21	21	deleteQuiz,
22	22	updateQuiz,
23		- uploadQuizExcel,
24	23	} from '@/lib/data/repositories/content-quiz-repository';
25	24	import { CONTENT_TYPE_CODE, type ContentKind } from '@/lib/domain/content';
26	25	import {
...	...	@@ -445,27 +444,5 @@
445	444	}
446	445
447	446	revalidatePath(contentListPath(kind));
448		- return { status: 'success' };
449		-}
450		-
451		-/** 금융OX퀴즈 엑셀 일괄등록. 한 행이라도 검증에 실패하면 백엔드가 전체를 되돌린다. */
452		-export async function uploadQuizExcelAction(
453		- _prevState: ContentFormState,
454		- formData: FormData
455		-): Promise<ContentFormState> {
456		- await verifySession();
457		-
458		- const file = readFiles(formData, 'excelFile')[0] ?? null;
459		- if (!file) {
460		- return { status: 'error', message: '엑셀 파일을 선택해 주세요.' };
461		- }
462		-
463		- try {
464		- await uploadQuizExcel(file);
465		- } catch (error) {
466		- return failure(error, '엑셀을 등록하지 못했습니다.');
467		- }
468		-
469		- revalidatePath(contentListPath('quiz'));
470	447	return { status: 'success' };
471	448	}

...	...	@@ -103,6 +103,10 @@
103	103	explanation: string;
104	104	answer: string;
105	105	points: number \| null;
	106	+ /** 공통코드 `COM_SCHUL_CD` 코드값. */
	107	+ schoolCode: string;
	108	+ /** 공통코드 `GRD_CD` 코드값. */
	109	+ grades: string[];
106	110	isVisible: boolean;
107	111	modifiedAt: string \| null;
108	112	};

...	...	@@ -1,64 +1,26 @@
1	1	'use client';
2	2
3		-import { useActionState, useEffect, useRef } from 'react';
4	3	import { FoxButton } from '@fox/core/components/fox-button';
5		-import { useFeedback } from '@/app/_hooks/use-feedback';
6		-import { INITIAL_CONTENT_FORM_STATE } from '@/lib/domain/content-form';
7		-import { uploadQuizExcelAction } from '../../_actions';
8	4
9	5	const EXCEL_DOWNLOAD_PATH = '/contents/quizzes/excel';
10	6
11		-/** 엑셀 일괄등록 / 다운로드 — 기획 ②. 등록은 파일을 고르는 즉시 올린다. */
	7	+/**
	8	+ * 엑셀 다운로드 — 기획 ②.
	9	+ *
	10	+ * TODO: 같은 자리의 「엑셀등록」(일괄등록)은 기획 중이라 아직 넣지 않았다. 백엔드에도 업로드
	11	+ * 엔드포인트가 없다(`/api/v1/mngr/cntntns/quiz`에 `excel/download`만 있다). 기획이 확정되면
	12	+ * 이 컴포넌트에 버튼과 Server Action을 함께 붙인다.
	13	+ */
12	14	export function QuizExcelActions() {
13		- const { showToast } = useFeedback();
14		- const inputRef = useRef<HTMLInputElement>(null);
15		- const formRef = useRef<HTMLFormElement>(null);
16		- const [state, formAction, isPending] = useActionState(
17		- uploadQuizExcelAction,
18		- INITIAL_CONTENT_FORM_STATE
19		- );
20		-
21		- useEffect(() => {
22		- if (state.status === 'success') {
23		- showToast({ variant: 'success', message: '엑셀을 등록했습니다.' });
24		- }
25		- if (state.status === 'error') {
26		- showToast({
27		- variant: 'danger',
28		- message: state.message ?? '엑셀을 등록하지 못했습니다.',
29		- });
30		- }
31		- }, [state, showToast]);
32		-
33	15	return (
34		- <>
35		- <form ref={formRef} action={formAction} hidden>
36		- <input
37		- ref={inputRef}
38		- type="file"
39		- name="excelFile"
40		- accept=".xlsx,.xls"
41		- onChange={() => formRef.current?.requestSubmit()}
42		- />
43		- </form>
44		-
	16	+ <form action={EXCEL_DOWNLOAD_PATH} method="get">
45	17	<FoxButton
46	18	type="secondary"
47	19	size="md"
48		- leadingIcon={<i className="fox-ico fox-ico-UploadSimple" aria-hidden="true" />}
49		- label="엑셀등록"
50		- loading={isPending}
51		- onAction={() => inputRef.current?.click()}
	20	+ htmlType="submit"
	21	+ leadingIcon={<i className="fox-ico fox-ico-DownloadSimple" aria-hidden="true" />}
	22	+ label="엑셀다운로드"
52	23	/>
53		- <form action={EXCEL_DOWNLOAD_PATH} method="get">
54		- <FoxButton
55		- type="secondary"
56		- size="md"
57		- htmlType="submit"
58		- leadingIcon={<i className="fox-ico fox-ico-DownloadSimple" aria-hidden="true" />}
59		- label="엑셀다운로드"
60		- />
61		- </form>
62		- </>
	24	+ </form>
63	25	);
64	26	}

...	...	@@ -80,6 +80,8 @@
80	80	<ContentGradeField
81	81	schools={schools}
82	82	gradesBySchool={gradesBySchool}
	83	+ defaultSchoolCode={item?.schoolCode}
	84	+ defaultGrades={item?.grades}
83	85	schoolError={errors.schoolCode}
84	86	gradesError={errors.grades}
85	87	/>

...	...	@@ -1,7 +1,7 @@
1	1	import { getSessionAccessToken, verifySession } from '@/lib/auth/dal';
2	2	import { backendFetchStream } from '@/lib/http/backend-fetch';
3	3
4		-const QUIZ_EXCEL_PATH = '/api/v1/mngr/quiz/excel/download';
	4	+const QUIZ_EXCEL_PATH = '/api/v1/mngr/cntntns/quiz/excel/download';
5	5
6	6	const EXCEL_TIMEOUT_MS = 60_000;
7	7

...	...	@@ -6,30 +6,38 @@
6	6	import type { QuizFormValues } from '@/lib/domain/content-form';
7	7
8	8	/**
9		- * 금융OX퀴즈 Repository — 쇼츠·만화와 테이블(`TB_COM_QUIZ`)도 API도 다르다.
	9	+ * 금융OX퀴즈 Repository — 쇼츠·만화와 테이블(`TB_COM_QUIZ`)은 다르지만 콘텐츠관리 API 아래로
	10	+ * 들어와 규약은 같다(등록은 form, 수정은 JSON, 삭제는 soft delete).
10	11	*
11	12	* ```
12		- * GET /api/v1/mngr/quiz/pagination 목록
13		- * GET /api/v1/mngr/quiz/excel/download 엑셀 다운로드
14		- * POST /api/v1/mngr/quiz/excel/upload 엑셀 일괄등록 (multipart, 파트 이름 `file`)
	13	+ * GET /api/v1/mngr/cntntns/quiz/pagination 학교·학년·난이도·검색어
	14	+ * POST /api/v1/mngr/cntntns/quiz 어노테이션 없음 → form(중첩 목록은 인덱스 표기)
	15	+ * PUT /api/v1/mngr/cntntns/quiz/{quizSn} @RequestBody(JSON)
	16	+ * DELETE /api/v1/mngr/cntntns/quiz/{quizSn} soft delete(DEL_YN)
	17	+ * GET /api/v1/mngr/cntntns/quiz/excel/download 엑셀 다운로드
15	18	* ```
16	19	*
17		- * 이슈: 등록·수정·삭제·단건조회 API가 없다. 아래 쓰기 함수는 다른 관리 화면과 같은 규약으로
18		- * 미리 맞춰 둔 것이라 백엔드가 생기기 전에는 실패한다.
19		- * 이슈: 학교(`COM_SCHUL_CD`)·학년(`GRD_CD`)을 담을 컬럼이 없다. 검색 VO에 `searchSchul`/
20		- * `searchGrade`가 있지만 매퍼의 `<if>` 블록이 비어 있어 필터가 조용히 무시된다.
21		- * 이슈: 키워드가 별도 테이블이 아니라 `quiz_title` 한 칸이다. 목록의 「키워드」 열이 이 값이고,
22		- * 기획의 "키워드+설명 쌍"을 담을 자리는 아직 없다.
23		- * 이슈: 정답 노출 문구(기획 "기본 3종 + 기타")를 담을 컬럼이 없다.
	20	+ * 학교·학년은 `TB_COM_QUIZ_SCHUL_GRD`에 따로 저장되고 `schulGrdList`로 오간다 — 쇼츠·만화와
	21	+ * 같은 모양이라 화면 쪽 취급도 같다.
	22	+ *
	23	+ * ⚠️ 백엔드 결함(보고함, 미수정)
	24	+ * 1. 등록 INSERT의 컬럼 수와 값 수가 다르다 — 컬럼은 11개인데 값은 10개고 `USE_YN` 자리가
	25	+ * 비어 있다. 지금은 등록이 SQL 오류로 끝난다. 프론트는 `useYn`을 정상적으로 보내고 있으므로
	26	+ * 백엔드가 값 목록만 맞추면 그대로 동작한다.
	27	+ * 2. 등록 INSERT의 `keyProperty`/`keyColumn`이 `cntntsSn`/`CNTNTS_SN`이다(이 테이블은 `QUIZ_SN`).
	28	+ * 채번된 키가 VO에 담기지 않아 학교·학년 매핑이 `quiz_sn` 없이 저장된다.
	29	+ * 3. 단건 조회 API가 없다 — 매퍼·서비스에는 `selectOne`이 있는데 컨트롤러가 열지 않았다.
	30	+ * 그래서 수정 화면은 목록에서 찾는다(아래 `fetchQuizDetail`).
	31	+ * 4. 검색어가 질문·정답만 본다(`QUIZ_ANSWER`·`QUIZ_QUESTION`). 화면의 「키워드」 검색은
	32	+ * `QUIZ_TITLE`을 봐야 하는데 조건에 없어 결과가 비어 온다.
	33	+ * 5. 난이도 필터가 SQL에 없다 — `searchLevelCd`를 받지만 `searchWhere`가 쓰지 않는다.
	34	+ * 화면 선택지는 기획대로 두고 값만 실어 보낸다.
24	35	*/
25	36
26		-const QUIZ_PATH = '/api/v1/mngr/quiz';
	37	+const QUIZ_PATH = '/api/v1/mngr/cntntns/quiz';
27	38
28		-/** 목록에서 단건을 찾을 때 한 번에 받아올 최대 행 수(단건 조회 API가 없다). */
	39	+/** 목록에서 단건을 찾을 때 한 번에 받아올 최대 행 수(단건 조회 API가 없다 — 결함 3). */
29	40	const DETAIL_SCAN_LIMIT = 500;
30		-
31		-/** 엑셀 업로드는 일반 조회보다 오래 걸린다. */
32		-const UPLOAD_TIMEOUT_MS = 60_000;
33	41
34	42	function isRecord(value: unknown): value is Record<string, unknown> {
35	43	return value !== null && typeof value === 'object';
...	...	@@ -40,6 +48,40 @@
40	48	if (typeof value === 'string' && value.length > 0) return value;
41	49	if (typeof value === 'number') return String(value);
42	50	return null;
	51	+}
	52	+
	53	+/** `schulGrdList` → 화면이 쓰는 학교 코드 + 학년 코드 목록(쇼츠·만화와 같은 규칙). */
	54	+function toSchoolGrades(raw: unknown): { schoolCode: string; grades: string[] } {
	55	+ if (!Array.isArray(raw)) {
	56	+ return { schoolCode: '', grades: [] };
	57	+ }
	58	+
	59	+ const grades: string[] = [];
	60	+ let schoolCode = '';
	61	+
	62	+ for (const entry of raw) {
	63	+ if (!isRecord(entry)) {
	64	+ continue;
	65	+ }
	66	+ schoolCode = schoolCode \|\| (readString(entry, 'schulCd') ?? '');
	67	+ const grade = readString(entry, 'grdCd');
	68	+ if (grade && !grades.includes(grade)) {
	69	+ grades.push(grade);
	70	+ }
	71	+ }
	72	+
	73	+ return { schoolCode, grades };
	74	+}
	75	+
	76	+function toSchoolGradePayload(schoolCode: string, grades: readonly string[]) {
	77	+ if (!schoolCode) {
	78	+ return [];
	79	+ }
	80	+ if (grades.length === 0) {
	81	+ // 학년 없는 학교(전체연령 등)는 학교만 남긴다 — 빈 문자열을 넣으면 GRD_CD에 ''가 박힌다.
	82	+ return [{ schulCd: schoolCode, grdCd: null }];
	83	+ }
	84	+ return grades.map((grade) => ({ schulCd: schoolCode, grdCd: grade }));
43	85	}
44	86
45	87	function toQuizItem(raw: unknown): QuizItem {
...	...	@@ -53,6 +95,7 @@
53	95	}
54	96
55	97	const points = raw.quizPoint;
	98	+ const schulGrd = toSchoolGrades(raw.schulGrdList);
56	99
57	100	return {
58	101	quizSn,
...	...	@@ -62,6 +105,8 @@
62	105	explanation: readString(raw, 'quizExplan') ?? '',
63	106	answer: readString(raw, 'quizAnswer') ?? '',
64	107	points: typeof points === 'number' ? points : null,
	108	+ schoolCode: schulGrd.schoolCode,
	109	+ grades: schulGrd.grades,
65	110	isVisible: readString(raw, 'useYn') !== 'N',
66	111	modifiedAt:
67	112	readString(raw, 'lastMdfcnDtStr') ?? readString(raw, 'frstRegDtStr'),
...	...	@@ -76,12 +121,11 @@
76	121	const keyword = query.keyword.trim();
77	122
78	123	return {
79		- searchSchul: query.school,
80		- searchGrade: query.grade,
81		- searchLevel: query.level,
82		- searchCondition: keyword ? '1' : '',
	124	+ searchSchulGradeCd: query.school,
	125	+ searchGradeCd: query.grade,
	126	+ // 백엔드 SQL이 아직 쓰지 않는다(결함 5). 화면 선택지는 기획대로 두고 값만 보낸다.
	127	+ searchLevelCd: query.level,
83	128	searchKeyword: keyword,
84		- searchSortOrder: query.sort,
85	129	pageIndex,
86	130	recordCountPerPage,
87	131	};
...	...	@@ -100,6 +144,7 @@
100	144	accessToken: accessToken ?? undefined,
101	145	cache: 'no-store',
102	146	canHaveNullData: true,
	147	+ canHaveEmptyBody: true,
103	148	});
104	149
105	150	if (!result.ok) {
...	...	@@ -144,7 +189,7 @@
144	189	};
145	190	}
146	191
147		-/** TODO: `GET /api/v1/mngr/quiz/{quizSn}`이 생기면 이 스캔을 그 호출로 교체한다. */
	192	+/** TODO: 단건 조회 API(결함 3)가 열리면 이 스캔을 `GET {base}/{quizSn}` 호출로 교체한다. */
148	193	export async function fetchQuizDetail(quizSn: string): Promise<QuizItem \| null> {
149	194	const { items } = await requestList(
150	195	{
...	...	@@ -164,31 +209,67 @@
164	209	return items.find((item) => item.quizSn === quizSn) ?? null;
165	210	}
166	211
167		-function buildQuizPayload(values: QuizFormValues) {
	212	+type QuizWritePayload = {
	213	+ quizTitle: string;
	214	+ quizLev: string;
	215	+ quizQuestion: string;
	216	+ quizExplan: string;
	217	+ quizAnswer: string;
	218	+ useYn: string;
	219	+ schulGrdList: Array<{ schulCd: string; grdCd: string \| null }>;
	220	+};
	221	+
	222	+/**
	223	+ * 이슈: 정답 노출 문구(기획 "기본 3종 + 기타")를 담을 필드가 백엔드에 없다. 화면은 값을 받지만
	224	+ * 저장되지 않는다 — 컬럼이 생기면 여기에 실어 보낸다.
	225	+ * 이슈: 키워드가 별도 테이블이 아니라 `quizTitle` 한 칸이라 쉼표로 이어 붙인다.
	226	+ */
	227	+function buildQuizPayload(values: QuizFormValues): QuizWritePayload {
168	228	return {
169	229	quizTitle: values.keywords.map((item) => item.keyword).join(', '),
170	230	quizLev: values.level,
171	231	quizQuestion: values.question,
172	232	quizExplan: values.explanation,
173	233	quizAnswer: values.answer,
174		- schulCd: values.schoolCode,
175		- gradeCd: values.grades.join(','),
176		- answerMssageCd: values.answerMessageCode,
177		- answerMssage: values.answerMessageText,
178	234	useYn: values.isVisible ? 'Y' : 'N',
	235	+ schulGrdList: toSchoolGradePayload(values.schoolCode, values.grades),
179	236	};
	237	+}
	238	+
	239	+/** 등록만 form이다 — 컨트롤러가 `@RequestBody` 없이 받는다(쇼츠·만화와 같은 갈림). */
	240	+function toFormParams(
	241	+ payload: QuizWritePayload
	242	+): Record<string, string \| number \| undefined> {
	243	+ const params: Record<string, string \| number \| undefined> = {
	244	+ quizTitle: payload.quizTitle,
	245	+ quizLev: payload.quizLev,
	246	+ quizQuestion: payload.quizQuestion,
	247	+ quizExplan: payload.quizExplan,
	248	+ quizAnswer: payload.quizAnswer,
	249	+ useYn: payload.useYn,
	250	+ };
	251	+
	252	+ payload.schulGrdList.forEach((item, index) => {
	253	+ params[`schulGrdList[${index}].schulCd`] = item.schulCd;
	254	+ // undefined면 파라미터 자체가 빠져 백엔드에서 null이 된다.
	255	+ params[`schulGrdList[${index}].grdCd`] = item.grdCd ?? undefined;
	256	+ });
	257	+
	258	+ return params;
180	259	}
181	260
182	261	async function sendWrite(
183	262	path: string,
184	263	method: 'POST' \| 'PUT' \| 'DELETE',
185		- body?: unknown
186		-): Promise<string \| null> {
	264	+ body?: unknown,
	265	+ form?: Record<string, string \| number \| undefined>
	266	+): Promise<void> {
187	267	const accessToken = await getSessionAccessToken();
188	268
189	269	const result = await backendFetch<unknown>(path, {
190	270	method,
191	271	...(body === undefined ? {} : { body }),
	272	+ ...(form === undefined ? {} : { form }),
192	273	accessToken: accessToken ?? undefined,
193	274	cache: 'no-store',
194	275	canHaveNullData: true,
...	...	@@ -198,12 +279,10 @@
198	279	if (!result.ok) {
199	280	throw new BackendRequestError(result);
200	281	}
201		-
202		- return typeof result.data === 'string' ? result.data : null;
203	282	}
204	283
205		-export async function createQuiz(values: QuizFormValues): Promise<string \| null> {
206		- return sendWrite(QUIZ_PATH, 'POST', buildQuizPayload(values));
	284	+export async function createQuiz(values: QuizFormValues): Promise<void> {
	285	+ await sendWrite(QUIZ_PATH, 'POST', undefined, toFormParams(buildQuizPayload(values)));
207	286	}
208	287
209	288	export async function updateQuiz(
...	...	@@ -219,25 +298,4 @@
219	298
220	299	export async function deleteQuiz(quizSn: string): Promise<void> {
221	300	await sendWrite(`${QUIZ_PATH}/${encodeURIComponent(quizSn)}`, 'DELETE');
222		-}
223		-
224		-/** 엑셀 일괄등록. 한 행이라도 검증에 실패하면 백엔드가 전체를 되돌린다. */
225		-export async function uploadQuizExcel(file: File): Promise<void> {
226		- const accessToken = await getSessionAccessToken();
227		-
228		- const multipart = new FormData();
229		- multipart.set('file', file);
230		-
231		- const result = await backendFetch<unknown>(`${QUIZ_PATH}/excel/upload`, {
232		- method: 'POST',
233		- multipart,
234		- accessToken: accessToken ?? undefined,
235		- cache: 'no-store',
236		- timeoutMs: UPLOAD_TIMEOUT_MS,
237		- canHaveNullData: true,
238		- });
239		-
240		- if (!result.ok) {
241		- throw new BackendRequestError(result);
242		- }
243	301	}

Delete comment