Commit @b9631e7759608d9884384d2c539e2f535db5f0d7

임동욱 08-20

feat: 금융쇼츠·4컷만화를 새 콘텐츠 API로 연결

백엔드가 toon/video 컨트롤러를 /cntntns 하나로 합치고 CRUD를 열었다. 목록은
searchCntntsType(V·T)으로 갈리고, 단건·등록·수정·삭제가 모두 실제 API를 탄다.

등록은 @RequestBody가 없어 form이라 중첩 목록을 keywordList[0].cntntsKeyword 같은
인덱스 표기로 편다. JSON으로 보내면 한 칸도 바인딩되지 않는다.

학교·학년은 새로 생긴 schulGrdList로 오간다 — 학년마다 한 줄이다.

컷은 upload/list/{moduleId}로 한 첨부에 묶어 올린다. 백엔드가 fileSn을 1,2,3으로
채번해 주므로 컷을 가리키는 건 아이디가 아니라 순번이 됐다. 응답의 fileList로
실제 순번을 받아 미리보기 주소를 만든다.

Co-Authored-By: Claude Opus 5

@b9631e7759608d9884384d2c539e2f535db5f0d7

708c925

b9631e7

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

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

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


 import { verifySession } from '@/lib/auth/dal';
 import { BackendRequestError } from '@/lib/http/backend-fetch';
 import { fetchSchoolGradeCodes } from '@/lib/data/repositories/common-code-repository';
-import { uploadAttachment } from '@/lib/data/repositories/file-repository';
+import {
+  uploadAttachment,
+  uploadAttachments,
+} from '@/lib/data/repositories/file-repository';
 import {
   buildComicPayload,
   buildShortsPayload,

  * 새로 고른 파일을 알맞은 저장소에 올려 파일 ID를 얻는다. 고르지 않았으면 폼이 들고 있던 기존
  * ID를 그대로 쓴다. 확장자는 백엔드가 사유 없이 실패하기 전에 여기서 먼저 잡는다.
  */
-async function resolveFileId(
-  file: File | null,
-  retainedId: string,
-  module: FileModule
-): Promise<string> {
-  if (!file) {
-    return retainedId;
-  }
+function assertUploadable(file: File, module: FileModule): void {
   if (file.size > MAX_ATTACHMENT_BYTES) {
     throw new ContentInputError(OVERSIZE_MESSAGE);
   }

       `${module.description}에는 ${allowedExtensions(module).join(', ')} 파일만 올릴 수 있습니다.`
     );
   }
+}
+
+async function resolveFileId(
+  file: File | null,
+  retainedId: string,
+  module: FileModule
+): Promise<string> {
+  if (!file) {
+    return retainedId;
+  }
+  assertUploadable(file, module);
   return uploadAttachment(file, module.id);
 }
 

   );
 }
 
-/** 컷은 개별 이미지로 올린다(기획). 고르지 않은 칸은 폼이 들고 있던 기존 ID를 그대로 쓴다. */
+/**
+ * 컷은 **한 첨부 아래** 올린다 — 백엔드가 `fileSn`을 1,2,3…으로 채번한다. 그래서 돌려주는
+ * 배열은 컷 수만큼 같은 아이디가 반복된다(컷을 가리키는 건 순번이지 아이디가 아니다).
+ *
+ * 한 컷만 바꿔도 묶음 전체를 다시 올려야 순번이 맞으므로, 새로 고른 것이 하나라도 있으면
+ * 고른 것들로 묶음을 새로 만든다. 하나도 고르지 않았으면 기존 아이디를 그대로 쓴다.
+ */
 async function resolveCutFileIds(formData: FormData): Promise<string[]> {
-  const files = readFiles(formData, 'cutFile');
+  // 고르지 않은 칸은 null로 오므로 걸러 낸다.
+  const files = readFiles(formData, 'cutFile').filter(
+    (file): file is File => file !== null
+  );
   const retained = formData
     .getAll('cutFileId')
-    .map((entry) => (typeof entry === 'string' ? entry : ''));
+    .map((entry) => (typeof entry === 'string' ? entry : ''))
+    .filter(Boolean);
 
-  const ids: string[] = [];
-  for (const [index, file] of files.entries()) {
-    const id = await resolveFileId(
-      file,
-      retained[index] ?? '',
-      FILE_MODULE.toonContent
-    );
-    if (id) {
-      ids.push(id);
-    }
+  if (files.length === 0) {
+    return retained;
   }
-  return ids;
+
+  for (const file of files) {
+    assertUploadable(file, FILE_MODULE.toonContent);
+  }
+
+  const attachmentId = await uploadAttachments(files, FILE_MODULE.toonContent.id);
+  return files.map(() => attachmentId);
 }
 
 export async function createShortsAction(

708c925

b9631e7

lib/data/repositories/content-repository.ts

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

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


 import { getSessionAccessToken } from '@/lib/auth/dal';
 import { BackendRequestError, backendFetch } from '@/lib/http/backend-fetch';
 import { buildFileImageUrl } from '@/lib/data/repositories/file-repository';
+import { CONTENT_TYPE_CODE } from '@/lib/domain/content';
 import type { ContentItem, ContentKeyword } from '@/lib/domain/content';
 import type { ContentQuery } from '@/lib/domain/content-query';
 import type {

 } from '@/lib/domain/content-form';
 
 /**
- * 금융쇼츠·4컷금융만화 Repository — 두 화면은 같은 테이블(`TB_COM_CNTNTS`)을 쓰고 경로만
- * 갈린다. 금융OX퀴즈는 테이블도 API도 달라 `content-quiz-repository.ts`가 따로 맡는다.
+ * 금융쇼츠·4컷금융만화 Repository — 두 화면은 같은 테이블(`TB_COM_CNTNTS`)을 쓰고
+ * `CNTNTS_TYPE`으로 갈린다(`V` 쇼츠 / `T` 만화).
  *
  * ```
- * GET /api/v1/mngr/cntntns/toon/pagination    4컷금융만화 목록
- * GET /api/v1/mngr/cntntns/video/pagination   금융쇼츠 목록
+ * GET    /api/v1/mngr/cntntns/pagination    searchCntntsType 필수
+ * GET    /api/v1/mngr/cntntns/{cntntsSn}    단건
+ * POST   /api/v1/mngr/cntntns               어노테이션 없음 → form(중첩 목록은 인덱스 표기)
+ * PUT    /api/v1/mngr/cntntns/{cntntsSn}    @RequestBody(JSON)
+ * DELETE /api/v1/mngr/cntntns/{cntntsSn}    soft delete(DEL_YN)
  * ```
  *
  * 이슈: 경로가 `cntnts`가 아니라 **`cntntns`**다(백엔드 오타). 고쳐지면 아래 상수만 바꾼다.
- * 이슈: `video/pagination` 컨트롤러가 `return null;`이라 응답 봉투 없이 **본문이 통째로 빈**
- *   200이 온다(서비스가 주입돼 있지 않다). 그래서 목록 조회는 `canHaveEmptyBody`가 필요하고,
- *   금융쇼츠 목록은 늘 빈 목록으로 보인다.
- * 이슈: 등록·수정·삭제·단건조회 API가 없다. 아래 쓰기 함수는 다른 관리 화면과 같은 규약
- *   (`POST {base}` / `PUT {base}/{sn}` / `DELETE {base}/{sn}`)으로 미리 맞춰 둔 것이라
- *   백엔드가 생기기 전에는 실패한다.
- * 이슈: 학교(`COM_SCHUL_CD`)·학년(`GRD_CD`)을 담을 컬럼도 필터 SQL도 없다 — 검색 VO에 파라미터만
- *   있고 매퍼의 `<if>`가 비어 있다. 주제·전달메시지도 컬럼이 없어 목록·상세에서 늘 빈 값이다.
- * 이슈: toon 매퍼의 검색 조건이 금칙어 테이블 컬럼(`BEN_WORD_NM`)을 보고 있어 검색어가 걸리면
- *   SQL이 깨진다. 그래서 검색어는 보내되 백엔드 수정 전까지는 결과를 신뢰할 수 없다.
- * 이슈: 목록 SQL이 키워드를 LEFT JOIN해 행이 키워드 수만큼 늘어나는데 count는 조인 없이 센다.
- *   한 페이지에 실제로 오는 콘텐츠 수가 `recordCountPerPage`보다 적을 수 있다.
+ *
+ * ⚠️ 백엔드 결함(보고함, 미수정)
+ * 1. `selectPaginationCount`가 `FROM TB_COM_CNTNTS`만 두고 `searchWhere`를 그대로 포함한다.
+ *    그 조건은 `c.`·`k.`·`g.` 별칭을 쓰므로 별칭을 모르는 count 쿼리에서 SQL이 깨진다.
+ * 2. 학교·학년 조건의 `<if test='searchSchulGradeCd != null != ""'>`가 OGNL에서 항상 참이고,
+ *    본문도 값 대신 `#{searchKeyword}`를 비교한다. 파라미터를 보내도 의미가 없어 보내지 않고,
+ *    학교·학년 필터는 받아온 뒤 여기서 건다.
+ * 3. 목록 SQL이 키워드·학교급·파일을 모두 LEFT JOIN해 한 콘텐츠가 여러 행이 된다. LIMIT이 그
+ *    늘어난 행에 걸려 한 페이지에 오는 콘텐츠 수가 `recordCountPerPage`보다 적을 수 있다.
  */
 
 const CONTENT_BASE_PATH = '/api/v1/mngr/cntntns';
 
-const SEGMENT: Record<'shorts' | 'comic', string> = {
-  shorts: 'video',
-  comic: 'toon',
-};
-
-type ContentApiKind = keyof typeof SEGMENT;
-
-/** 단건 조회 API가 없어 목록에서 찾는다. 그때 한 번에 받아올 최대 행 수. */
-const DETAIL_SCAN_LIMIT = 500;
-
-function basePath(kind: ContentApiKind): string {
-  return `${CONTENT_BASE_PATH}/${SEGMENT[kind]}`;
-}
+type ContentApiKind = 'shorts' | 'comic';
 
 function isRecord(value: unknown): value is Record<string, unknown> {
   return value !== null && typeof value === 'object';

   });
 }
 
+/** 학교급/학년 매핑은 학년마다 한 줄씩 온다 — 학교는 하나로 접고 학년만 모은다. */
+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 };
+}
+
+/** 한 `atchFileId` 아래 여러 컷이 `fileSn`으로 들어온다. */
+function toFileNumbers(raw: unknown): number[] {
+  if (!Array.isArray(raw)) {
+    return [];
+  }
+  return raw
+    .flatMap((entry) => (isRecord(entry) ? [Number(entry.fileSn)] : []))
+    .filter((value) => Number.isInteger(value) && value > 0)
+    .sort((a, b) => a - b);
+}
+
 function toContentItem(raw: unknown): ContentItem {
   if (!isRecord(raw)) {
     throw new Error('콘텐츠 응답 항목의 형식이 올바르지 않습니다.');

     throw new Error('콘텐츠 응답에 cntntsSn이 없습니다.');
   }
 
+  const schulGrd = toSchoolGrades(raw.schulGrdList);
+
   return {
     cntntsSn,
+    cutFileNumbers: toFileNumbers(raw.fileList),
     name: readString(raw, 'cntntsNm') ?? '',
     title: readString(raw, 'cntntsTitle') ?? '',
     subject: readString(raw, 'cntntsSbjct') ?? '',
     message: readString(raw, 'cntntsMssage') ?? '',
-    schoolCode: readString(raw, 'schulCd') ?? '',
-    grades: (readString(raw, 'gradeCd') ?? '')
-      .split(',')
-      .map((grade) => grade.trim())
-      .filter(Boolean),
+    schoolCode: schulGrd.schoolCode,
+    grades: schulGrd.grades,
     keywords: toKeywords(raw.keywordList),
     attachmentId: readString(raw, 'atchFileId'),
     thumbnailFileId: readString(raw, 'thumbAtchFileId'),

 }
 
 function buildListParams(
+  kind: ContentApiKind,
   query: ContentQuery,
   pageIndex: number,
   recordCountPerPage: number

   const keyword = query.keyword.trim();
 
   return {
-    searchSchulGradeCd: query.school,
-    searchGradeCd: query.grade,
+    // 없으면 `CNTNTS_TYPE = NULL`이 되어 한 건도 오지 않는다.
+    searchCntntsType: CONTENT_TYPE_CODE[kind],
     searchCondition: keyword ? '1' : '',
     searchKeyword: keyword,
-    // 이슈: 백엔드가 정렬 파라미터를 읽지 않는다(등록일 내림차순 고정). 화면 선택지는 기획대로
-    // 유지하고 값만 미리 실어 보낸다.
-    searchSortOrder: query.sort,
     pageIndex,
     recordCountPerPage,
   };

 ): Promise<{ items: ContentItem[]; reportedTotalCount: number }> {
   const accessToken = await getSessionAccessToken();
 
-  const result = await backendFetch<unknown>(`${basePath(kind)}/pagination`, {
+  const result = await backendFetch<unknown>(`${CONTENT_BASE_PATH}/pagination`, {
     method: 'GET',
-    query: buildListParams(query, pageIndex, recordCountPerPage),
+    query: buildListParams(kind, query, pageIndex, recordCountPerPage),
     accessToken: accessToken ?? undefined,
     cache: 'no-store',
     canHaveNullData: true,

   };
 }
 
-/**
- * 단건 조회.
- *
- * TODO: `GET {base}/{cntntsSn}`이 생기면 이 스캔을 그 호출로 교체한다. 지금은 단건 API가 없어
- * 목록에서 찾는다 — 목록이 돌려주는 필드만 채워지고 나머지는 빈 값이다.
- */
+/** 단건 조회 — 목록과 같은 SQL이라 키워드·학교급·파일 목록이 함께 온다. */
 export async function fetchContentDetail(
   kind: ContentApiKind,
   cntntsSn: string
 ): Promise<ContentItem | null> {
-  const { items } = await requestList(
-    kind,
+  void kind;
+  const accessToken = await getSessionAccessToken();
+
+  const result = await backendFetch<unknown>(
+    `${CONTENT_BASE_PATH}/${encodeURIComponent(cntntsSn)}`,
     {
-      school: '',
-      grade: '',
-      level: '',
-      searchField: '',
-      keyword: '',
-      sort: 'created',
-      page: 1,
-      pageSize: 10,
-    },
-    1,
-    DETAIL_SCAN_LIMIT
+      method: 'GET',
+      accessToken: accessToken ?? undefined,
+      cache: 'no-store',
+      canHaveNullData: true,
+    }
   );
 
-  return items.find((item) => item.cntntsSn === cntntsSn) ?? null;
+  if (!result.ok) {
+    throw new BackendRequestError(result);
+  }
+  if (result.data === null || result.data === undefined) {
+    return null;
+  }
+
+  return toContentItem(result.data);
 }
 
+// 이슈: 주제·전달메시지를 담을 컬럼이 테이블에 없다. 화면은 기획대로 두고 값은 보내지 않는다.
 type ContentWritePayload = {
   cntntsType?: string;
   cntntsNm: string;
   cntntsTitle: string;
-  cntntsSbjct: string;
-  cntntsMssage: string;
-  schulCd: string;
-  gradeCd: string;
   atchFileId: string;
   thumbAtchFileId: string;
   useYn: string;
   keywordList: Array<{ cntntsKeyword: string; cntntsExpln: string }>;
+  schulGrdList: Array<{ schulCd: string; grdCd: string }>;
 };
 
 function toKeywordPayload(keywords: readonly ContentKeyword[]) {

   }));
 }
 
+/** 학년마다 한 줄이다. 학년을 고르지 않았으면 학교만 담은 한 줄을 남긴다. */
+function toSchoolGradePayload(schoolCode: string, grades: readonly string[]) {
+  if (!schoolCode) {
+    return [];
+  }
+  if (grades.length === 0) {
+    return [{ schulCd: schoolCode, grdCd: '' }];
+  }
+  return grades.map((grade) => ({ schulCd: schoolCode, grdCd: grade }));
+}
+
 export function buildShortsPayload(
   values: ShortsFormValues
 ): ContentWritePayload {
   return {
     cntntsNm: values.title,
     cntntsTitle: values.title,
-    cntntsSbjct: values.subject,
-    cntntsMssage: values.message,
-    schulCd: values.schoolCode,
-    gradeCd: values.grades.join(','),
     atchFileId: values.videoFileId,
     thumbAtchFileId: values.thumbnailFileId,
     useYn: values.isVisible ? 'Y' : 'N',
     keywordList: toKeywordPayload(values.keywords),
+    schulGrdList: toSchoolGradePayload(values.schoolCode, values.grades),
   };
 }
 

   return {
     cntntsNm: values.name,
     cntntsTitle: values.name,
-    cntntsSbjct: values.subject,
-    cntntsMssage: values.message,
-    schulCd: values.schoolCode,
-    gradeCd: values.grades.join(','),
-    // 이슈: 기획은 "각 컷을 개별 이미지로 업로드"인데 백엔드 컬럼은 `atchFileId` 한 칸뿐이라
-    // 컷 묶음을 여러 개 연결할 자리가 없다. 지금은 첫 묶음만 저장된다.
+    // 컷은 한 첨부 아래 fileSn 1..N으로 들어간다 — 배열 값이 모두 같은 첨부 아이디다.
     atchFileId: values.cutFileIds[0] ?? '',
     thumbAtchFileId: values.thumbnailFileId,
     useYn: values.isVisible ? 'Y' : 'N',
     keywordList: toKeywordPayload(values.keywords),
+    schulGrdList: toSchoolGradePayload(values.schoolCode, values.grades),
   };
+}
+
+/**
+ * 등록은 `@RequestBody`가 없어 form으로 간다. 중첩 목록은 Spring이 읽는 인덱스 표기
+ * (`keywordList[0].cntntsKeyword`)로 편다 — JSON으로 보내면 한 칸도 바인딩되지 않는다.
+ */
+function toFormParams(
+  payload: ContentWritePayload & { cntntsType?: string }
+): Record<string, string | number | undefined> {
+  const params: Record<string, string | number | undefined> = {
+    cntntsType: payload.cntntsType,
+    cntntsNm: payload.cntntsNm,
+    cntntsTitle: payload.cntntsTitle,
+    atchFileId: payload.atchFileId,
+    thumbAtchFileId: payload.thumbAtchFileId,
+    useYn: payload.useYn,
+  };
+
+  payload.keywordList.forEach((item, index) => {
+    params[`keywordList[${index}].cntntsKeyword`] = item.cntntsKeyword;
+    params[`keywordList[${index}].cntntsExpln`] = item.cntntsExpln;
+  });
+  payload.schulGrdList.forEach((item, index) => {
+    params[`schulGrdList[${index}].schulCd`] = item.schulCd;
+    params[`schulGrdList[${index}].grdCd`] = item.grdCd;
+  });
+
+  return params;
 }
 
 async function sendWrite(
   path: string,
   method: 'POST' | 'PUT' | 'DELETE',
-  body?: unknown
+  body?: unknown,
+  form?: Record<string, string | number | undefined>
 ): Promise<string | null> {
   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,

   payload: ContentWritePayload,
   cntntsType: string
 ): Promise<string | null> {
-  return sendWrite(basePath(kind), 'POST', { ...payload, cntntsType });
+  return sendWrite(CONTENT_BASE_PATH, 'POST', undefined, toFormParams({ ...payload, cntntsType }));
 }
 
 export async function updateContent(

   payload: ContentWritePayload
 ): Promise<void> {
   await sendWrite(
-    `${basePath(kind)}/${encodeURIComponent(cntntsSn)}`,
+    `${CONTENT_BASE_PATH}/${encodeURIComponent(cntntsSn)}`,
     'PUT',
     payload
   );

   kind: ContentApiKind,
   cntntsSn: string
 ): Promise<void> {
-  await sendWrite(`${basePath(kind)}/${encodeURIComponent(cntntsSn)}`, 'DELETE');
+  await sendWrite(`${CONTENT_BASE_PATH}/${encodeURIComponent(cntntsSn)}`, 'DELETE');
 }
 
 export function contentThumbnailUrl(item: ContentItem): string | null {
   return buildFileImageUrl(item.thumbnailFileId);
 }
 
+/** 컷 이미지 주소 — 응답이 준 파일 번호를 쓰고, 없으면 1..count로 채운다. */
 export function contentCutUrls(item: ContentItem, count: number): string[] {
-  return Array.from({ length: count }, (_, index) =>
-    buildFileImageUrl(item.attachmentId, index + 1)
-  ).filter((url): url is string => url !== null);
+  const numbers =
+    item.cutFileNumbers.length > 0
+      ? item.cutFileNumbers
+      : Array.from({ length: count }, (_, index) => index + 1);
+
+  return numbers
+    .map((fileSn) => buildFileImageUrl(item.attachmentId, fileSn))
+    .filter((url): url is string => url !== null);
 }

708c925

b9631e7

lib/data/repositories/file-repository.ts

--- lib/data/repositories/file-repository.ts

+++ lib/data/repositories/file-repository.ts

...	...	@@ -67,6 +67,44 @@
67	67	return result.data;
68	68	}
69	69
	70	+/**
	71	+ * 여러 장을 한 `atchFileId` 아래 올린다 — 파일마다 `fileSn`이 1,2,3…으로 붙는다.
	72	+ * 4컷만화처럼 묶음이 하나의 콘텐츠에 매달리는 자리에 쓴다.
	73	+ */
	74	+export async function uploadAttachments(
	75	+ files: File[],
	76	+ moduleId: string
	77	+): Promise<string> {
	78	+ const accessToken = await getSessionAccessToken();
	79	+
	80	+ const multipart = new FormData();
	81	+ for (const file of files) {
	82	+ // 파트 이름이 모두 `file`이어야 백엔드가 List<MultipartFile>로 받는다.
	83	+ multipart.append('file', file);
	84	+ }
	85	+
	86	+ const result = await backendFetch<unknown>(
	87	+ `${FILE_UPLOAD_PATH}/list/${moduleId}`,
	88	+ {
	89	+ method: 'POST',
	90	+ multipart,
	91	+ accessToken: accessToken ?? undefined,
	92	+ cache: 'no-store',
	93	+ timeoutMs: UPLOAD_TIMEOUT_MS,
	94	+ }
	95	+ );
	96	+
	97	+ if (!result.ok) {
	98	+ throw new BackendRequestError(result);
	99	+ }
	100	+
	101	+ if (typeof result.data !== 'string' \|\| result.data.length === 0) {
	102	+ throw new Error('첨부파일 업로드 응답에 파일 식별자가 없습니다.');
	103	+ }
	104	+
	105	+ return result.data;
	106	+}
	107	+
70	108	/** 업로드된 파일의 이미지 URL. 이 GET은 인증이 필요 없어 브라우저가 직접 부른다. */
71	109	export function buildFileImageUrl(
72	110	atchFileId: string \| null,

708c925

b9631e7

lib/domain/content.ts

--- lib/domain/content.ts

+++ lib/domain/content.ts


   keywords: ContentKeyword[];
   /** 만화의 컷 이미지·쇼츠의 영상이 묶인 첨부 ID. */
   attachmentId: string | null;
+  /** 만화 컷처럼 한 첨부 아래 여러 파일이 있을 때의 파일 번호들. */
+  cutFileNumbers: number[];
   thumbnailFileId: string | null;
   isVisible: boolean;
   modifiedAt: string | null;

Add a comment

Open 0
Closed 0

List

...	...	@@ -5,7 +5,10 @@
5	5	import { verifySession } from '@/lib/auth/dal';
6	6	import { BackendRequestError } from '@/lib/http/backend-fetch';
7	7	import { fetchSchoolGradeCodes } from '@/lib/data/repositories/common-code-repository';
8		-import { uploadAttachment } from '@/lib/data/repositories/file-repository';
	8	+import {
	9	+ uploadAttachment,
	10	+ uploadAttachments,
	11	+} from '@/lib/data/repositories/file-repository';
9	12	import {
10	13	buildComicPayload,
11	14	buildShortsPayload,
...	...	@@ -84,14 +87,7 @@
84	87	* 새로 고른 파일을 알맞은 저장소에 올려 파일 ID를 얻는다. 고르지 않았으면 폼이 들고 있던 기존
85	88	* ID를 그대로 쓴다. 확장자는 백엔드가 사유 없이 실패하기 전에 여기서 먼저 잡는다.
86	89	*/
87		-async function resolveFileId(
88		- file: File \| null,
89		- retainedId: string,
90		- module: FileModule
91		-): Promise<string> {
92		- if (!file) {
93		- return retainedId;
94		- }
	90	+function assertUploadable(file: File, module: FileModule): void {
95	91	if (file.size > MAX_ATTACHMENT_BYTES) {
96	92	throw new ContentInputError(OVERSIZE_MESSAGE);
97	93	}
...	...	@@ -100,6 +96,17 @@
100	96	`${module.description}에는 ${allowedExtensions(module).join(', ')} 파일만 올릴 수 있습니다.`
101	97	);
102	98	}
	99	+}
	100	+
	101	+async function resolveFileId(
	102	+ file: File \| null,
	103	+ retainedId: string,
	104	+ module: FileModule
	105	+): Promise<string> {
	106	+ if (!file) {
	107	+ return retainedId;
	108	+ }
	109	+ assertUploadable(file, module);
103	110	return uploadAttachment(file, module.id);
104	111	}
105	112
...	...	@@ -184,25 +191,33 @@
184	191	);
185	192	}
186	193
187		-/** 컷은 개별 이미지로 올린다(기획). 고르지 않은 칸은 폼이 들고 있던 기존 ID를 그대로 쓴다. */
	194	+/**
	195	+ * 컷은 한 첨부 아래 올린다 — 백엔드가 `fileSn`을 1,2,3…으로 채번한다. 그래서 돌려주는
	196	+ * 배열은 컷 수만큼 같은 아이디가 반복된다(컷을 가리키는 건 순번이지 아이디가 아니다).
	197	+ *
	198	+ * 한 컷만 바꿔도 묶음 전체를 다시 올려야 순번이 맞으므로, 새로 고른 것이 하나라도 있으면
	199	+ * 고른 것들로 묶음을 새로 만든다. 하나도 고르지 않았으면 기존 아이디를 그대로 쓴다.
	200	+ */
188	201	async function resolveCutFileIds(formData: FormData): Promise<string[]> {
189		- const files = readFiles(formData, 'cutFile');
	202	+ // 고르지 않은 칸은 null로 오므로 걸러 낸다.
	203	+ const files = readFiles(formData, 'cutFile').filter(
	204	+ (file): file is File => file !== null
	205	+ );
190	206	const retained = formData
191	207	.getAll('cutFileId')
192		- .map((entry) => (typeof entry === 'string' ? entry : ''));
	208	+ .map((entry) => (typeof entry === 'string' ? entry : ''))
	209	+ .filter(Boolean);
193	210
194		- const ids: string[] = [];
195		- for (const [index, file] of files.entries()) {
196		- const id = await resolveFileId(
197		- file,
198		- retained[index] ?? '',
199		- FILE_MODULE.toonContent
200		- );
201		- if (id) {
202		- ids.push(id);
203		- }
	211	+ if (files.length === 0) {
	212	+ return retained;
204	213	}
205		- return ids;
	214	+
	215	+ for (const file of files) {
	216	+ assertUploadable(file, FILE_MODULE.toonContent);
	217	+ }
	218	+
	219	+ const attachmentId = await uploadAttachments(files, FILE_MODULE.toonContent.id);
	220	+ return files.map(() => attachmentId);
206	221	}
207	222
208	223	export async function createShortsAction(

...	...	@@ -2,6 +2,7 @@
2	2	import { getSessionAccessToken } from '@/lib/auth/dal';
3	3	import { BackendRequestError, backendFetch } from '@/lib/http/backend-fetch';
4	4	import { buildFileImageUrl } from '@/lib/data/repositories/file-repository';
	5	+import { CONTENT_TYPE_CODE } from '@/lib/domain/content';
5	6	import type { ContentItem, ContentKeyword } from '@/lib/domain/content';
6	7	import type { ContentQuery } from '@/lib/domain/content-query';
7	8	import type {
...	...	@@ -10,44 +11,32 @@
10	11	} from '@/lib/domain/content-form';
11	12
12	13	/**
13		- * 금융쇼츠·4컷금융만화 Repository — 두 화면은 같은 테이블(`TB_COM_CNTNTS`)을 쓰고 경로만
14		- * 갈린다. 금융OX퀴즈는 테이블도 API도 달라 `content-quiz-repository.ts`가 따로 맡는다.
	14	+ * 금융쇼츠·4컷금융만화 Repository — 두 화면은 같은 테이블(`TB_COM_CNTNTS`)을 쓰고
	15	+ * `CNTNTS_TYPE`으로 갈린다(`V` 쇼츠 / `T` 만화).
15	16	*
16	17	* ```
17		- * GET /api/v1/mngr/cntntns/toon/pagination 4컷금융만화 목록
18		- * GET /api/v1/mngr/cntntns/video/pagination 금융쇼츠 목록
	18	+ * GET /api/v1/mngr/cntntns/pagination searchCntntsType 필수
	19	+ * GET /api/v1/mngr/cntntns/{cntntsSn} 단건
	20	+ * POST /api/v1/mngr/cntntns 어노테이션 없음 → form(중첩 목록은 인덱스 표기)
	21	+ * PUT /api/v1/mngr/cntntns/{cntntsSn} @RequestBody(JSON)
	22	+ * DELETE /api/v1/mngr/cntntns/{cntntsSn} soft delete(DEL_YN)
19	23	* ```
20	24	*
21	25	* 이슈: 경로가 `cntnts`가 아니라 `cntntns`다(백엔드 오타). 고쳐지면 아래 상수만 바꾼다.
22		- * 이슈: `video/pagination` 컨트롤러가 `return null;`이라 응답 봉투 없이 본문이 통째로 빈
23		- * 200이 온다(서비스가 주입돼 있지 않다). 그래서 목록 조회는 `canHaveEmptyBody`가 필요하고,
24		- * 금융쇼츠 목록은 늘 빈 목록으로 보인다.
25		- * 이슈: 등록·수정·삭제·단건조회 API가 없다. 아래 쓰기 함수는 다른 관리 화면과 같은 규약
26		- * (`POST {base}` / `PUT {base}/{sn}` / `DELETE {base}/{sn}`)으로 미리 맞춰 둔 것이라
27		- * 백엔드가 생기기 전에는 실패한다.
28		- * 이슈: 학교(`COM_SCHUL_CD`)·학년(`GRD_CD`)을 담을 컬럼도 필터 SQL도 없다 — 검색 VO에 파라미터만
29		- * 있고 매퍼의 `<if>`가 비어 있다. 주제·전달메시지도 컬럼이 없어 목록·상세에서 늘 빈 값이다.
30		- * 이슈: toon 매퍼의 검색 조건이 금칙어 테이블 컬럼(`BEN_WORD_NM`)을 보고 있어 검색어가 걸리면
31		- * SQL이 깨진다. 그래서 검색어는 보내되 백엔드 수정 전까지는 결과를 신뢰할 수 없다.
32		- * 이슈: 목록 SQL이 키워드를 LEFT JOIN해 행이 키워드 수만큼 늘어나는데 count는 조인 없이 센다.
33		- * 한 페이지에 실제로 오는 콘텐츠 수가 `recordCountPerPage`보다 적을 수 있다.
	26	+ *
	27	+ * ⚠️ 백엔드 결함(보고함, 미수정)
	28	+ * 1. `selectPaginationCount`가 `FROM TB_COM_CNTNTS`만 두고 `searchWhere`를 그대로 포함한다.
	29	+ * 그 조건은 `c.`·`k.`·`g.` 별칭을 쓰므로 별칭을 모르는 count 쿼리에서 SQL이 깨진다.
	30	+ * 2. 학교·학년 조건의 `<if test='searchSchulGradeCd != null != ""'>`가 OGNL에서 항상 참이고,
	31	+ * 본문도 값 대신 `#{searchKeyword}`를 비교한다. 파라미터를 보내도 의미가 없어 보내지 않고,
	32	+ * 학교·학년 필터는 받아온 뒤 여기서 건다.
	33	+ * 3. 목록 SQL이 키워드·학교급·파일을 모두 LEFT JOIN해 한 콘텐츠가 여러 행이 된다. LIMIT이 그
	34	+ * 늘어난 행에 걸려 한 페이지에 오는 콘텐츠 수가 `recordCountPerPage`보다 적을 수 있다.
34	35	*/
35	36
36	37	const CONTENT_BASE_PATH = '/api/v1/mngr/cntntns';
37	38
38		-const SEGMENT: Record<'shorts' \| 'comic', string> = {
39		- shorts: 'video',
40		- comic: 'toon',
41		-};
42		-
43		-type ContentApiKind = keyof typeof SEGMENT;
44		-
45		-/** 단건 조회 API가 없어 목록에서 찾는다. 그때 한 번에 받아올 최대 행 수. */
46		-const DETAIL_SCAN_LIMIT = 500;
47		-
48		-function basePath(kind: ContentApiKind): string {
49		- return `${CONTENT_BASE_PATH}/${SEGMENT[kind]}`;
50		-}
	39	+type ContentApiKind = 'shorts' \| 'comic';
51	40
52	41	function isRecord(value: unknown): value is Record<string, unknown> {
53	42	return value !== null && typeof value === 'object';
...	...	@@ -74,6 +63,40 @@
74	63	});
75	64	}
76	65
	66	+/** 학교급/학년 매핑은 학년마다 한 줄씩 온다 — 학교는 하나로 접고 학년만 모은다. */
	67	+function toSchoolGrades(raw: unknown): { schoolCode: string; grades: string[] } {
	68	+ if (!Array.isArray(raw)) {
	69	+ return { schoolCode: '', grades: [] };
	70	+ }
	71	+
	72	+ const grades: string[] = [];
	73	+ let schoolCode = '';
	74	+
	75	+ for (const entry of raw) {
	76	+ if (!isRecord(entry)) {
	77	+ continue;
	78	+ }
	79	+ schoolCode = schoolCode \|\| (readString(entry, 'schulCd') ?? '');
	80	+ const grade = readString(entry, 'grdCd');
	81	+ if (grade && !grades.includes(grade)) {
	82	+ grades.push(grade);
	83	+ }
	84	+ }
	85	+
	86	+ return { schoolCode, grades };
	87	+}
	88	+
	89	+/** 한 `atchFileId` 아래 여러 컷이 `fileSn`으로 들어온다. */
	90	+function toFileNumbers(raw: unknown): number[] {
	91	+ if (!Array.isArray(raw)) {
	92	+ return [];
	93	+ }
	94	+ return raw
	95	+ .flatMap((entry) => (isRecord(entry) ? [Number(entry.fileSn)] : []))
	96	+ .filter((value) => Number.isInteger(value) && value > 0)
	97	+ .sort((a, b) => a - b);
	98	+}
	99	+
77	100	function toContentItem(raw: unknown): ContentItem {
78	101	if (!isRecord(raw)) {
79	102	throw new Error('콘텐츠 응답 항목의 형식이 올바르지 않습니다.');
...	...	@@ -84,17 +107,17 @@
84	107	throw new Error('콘텐츠 응답에 cntntsSn이 없습니다.');
85	108	}
86	109
	110	+ const schulGrd = toSchoolGrades(raw.schulGrdList);
	111	+
87	112	return {
88	113	cntntsSn,
	114	+ cutFileNumbers: toFileNumbers(raw.fileList),
89	115	name: readString(raw, 'cntntsNm') ?? '',
90	116	title: readString(raw, 'cntntsTitle') ?? '',
91	117	subject: readString(raw, 'cntntsSbjct') ?? '',
92	118	message: readString(raw, 'cntntsMssage') ?? '',
93		- schoolCode: readString(raw, 'schulCd') ?? '',
94		- grades: (readString(raw, 'gradeCd') ?? '')
95		- .split(',')
96		- .map((grade) => grade.trim())
97		- .filter(Boolean),
	119	+ schoolCode: schulGrd.schoolCode,
	120	+ grades: schulGrd.grades,
98	121	keywords: toKeywords(raw.keywordList),
99	122	attachmentId: readString(raw, 'atchFileId'),
100	123	thumbnailFileId: readString(raw, 'thumbAtchFileId'),
...	...	@@ -105,6 +128,7 @@
105	128	}
106	129
107	130	function buildListParams(
	131	+ kind: ContentApiKind,
108	132	query: ContentQuery,
109	133	pageIndex: number,
110	134	recordCountPerPage: number
...	...	@@ -112,13 +136,10 @@
112	136	const keyword = query.keyword.trim();
113	137
114	138	return {
115		- searchSchulGradeCd: query.school,
116		- searchGradeCd: query.grade,
	139	+ // 없으면 `CNTNTS_TYPE = NULL`이 되어 한 건도 오지 않는다.
	140	+ searchCntntsType: CONTENT_TYPE_CODE[kind],
117	141	searchCondition: keyword ? '1' : '',
118	142	searchKeyword: keyword,
119		- // 이슈: 백엔드가 정렬 파라미터를 읽지 않는다(등록일 내림차순 고정). 화면 선택지는 기획대로
120		- // 유지하고 값만 미리 실어 보낸다.
121		- searchSortOrder: query.sort,
122	143	pageIndex,
123	144	recordCountPerPage,
124	145	};
...	...	@@ -132,9 +153,9 @@
132	153	): Promise<{ items: ContentItem[]; reportedTotalCount: number }> {
133	154	const accessToken = await getSessionAccessToken();
134	155
135		- const result = await backendFetch<unknown>(`${basePath(kind)}/pagination`, {
	156	+ const result = await backendFetch<unknown>(`${CONTENT_BASE_PATH}/pagination`, {
136	157	method: 'GET',
137		- query: buildListParams(query, pageIndex, recordCountPerPage),
	158	+ query: buildListParams(kind, query, pageIndex, recordCountPerPage),
138	159	accessToken: accessToken ?? undefined,
139	160	cache: 'no-store',
140	161	canHaveNullData: true,
...	...	@@ -190,47 +211,44 @@
190	211	};
191	212	}
192	213
193		-/**
194		- * 단건 조회.
195		- *
196		- * TODO: `GET {base}/{cntntsSn}`이 생기면 이 스캔을 그 호출로 교체한다. 지금은 단건 API가 없어
197		- * 목록에서 찾는다 — 목록이 돌려주는 필드만 채워지고 나머지는 빈 값이다.
198		- */
	214	+/** 단건 조회 — 목록과 같은 SQL이라 키워드·학교급·파일 목록이 함께 온다. */
199	215	export async function fetchContentDetail(
200	216	kind: ContentApiKind,
201	217	cntntsSn: string
202	218	): Promise<ContentItem \| null> {
203		- const { items } = await requestList(
204		- kind,
	219	+ void kind;
	220	+ const accessToken = await getSessionAccessToken();
	221	+
	222	+ const result = await backendFetch<unknown>(
	223	+ `${CONTENT_BASE_PATH}/${encodeURIComponent(cntntsSn)}`,
205	224	{
206		- school: '',
207		- grade: '',
208		- level: '',
209		- searchField: '',
210		- keyword: '',
211		- sort: 'created',
212		- page: 1,
213		- pageSize: 10,
214		- },
215		- 1,
216		- DETAIL_SCAN_LIMIT
	225	+ method: 'GET',
	226	+ accessToken: accessToken ?? undefined,
	227	+ cache: 'no-store',
	228	+ canHaveNullData: true,
	229	+ }
217	230	);
218	231
219		- return items.find((item) => item.cntntsSn === cntntsSn) ?? null;
	232	+ if (!result.ok) {
	233	+ throw new BackendRequestError(result);
	234	+ }
	235	+ if (result.data === null \|\| result.data === undefined) {
	236	+ return null;
	237	+ }
	238	+
	239	+ return toContentItem(result.data);
220	240	}
221	241
	242	+// 이슈: 주제·전달메시지를 담을 컬럼이 테이블에 없다. 화면은 기획대로 두고 값은 보내지 않는다.
222	243	type ContentWritePayload = {
223	244	cntntsType?: string;
224	245	cntntsNm: string;
225	246	cntntsTitle: string;
226		- cntntsSbjct: string;
227		- cntntsMssage: string;
228		- schulCd: string;
229		- gradeCd: string;
230	247	atchFileId: string;
231	248	thumbAtchFileId: string;
232	249	useYn: string;
233	250	keywordList: Array<{ cntntsKeyword: string; cntntsExpln: string }>;
	251	+ schulGrdList: Array<{ schulCd: string; grdCd: string }>;
234	252	};
235	253
236	254	function toKeywordPayload(keywords: readonly ContentKeyword[]) {
...	...	@@ -240,20 +258,28 @@
240	258	}));
241	259	}
242	260
	261	+/** 학년마다 한 줄이다. 학년을 고르지 않았으면 학교만 담은 한 줄을 남긴다. */
	262	+function toSchoolGradePayload(schoolCode: string, grades: readonly string[]) {
	263	+ if (!schoolCode) {
	264	+ return [];
	265	+ }
	266	+ if (grades.length === 0) {
	267	+ return [{ schulCd: schoolCode, grdCd: '' }];
	268	+ }
	269	+ return grades.map((grade) => ({ schulCd: schoolCode, grdCd: grade }));
	270	+}
	271	+
243	272	export function buildShortsPayload(
244	273	values: ShortsFormValues
245	274	): ContentWritePayload {
246	275	return {
247	276	cntntsNm: values.title,
248	277	cntntsTitle: values.title,
249		- cntntsSbjct: values.subject,
250		- cntntsMssage: values.message,
251		- schulCd: values.schoolCode,
252		- gradeCd: values.grades.join(','),
253	278	atchFileId: values.videoFileId,
254	279	thumbAtchFileId: values.thumbnailFileId,
255	280	useYn: values.isVisible ? 'Y' : 'N',
256	281	keywordList: toKeywordPayload(values.keywords),
	282	+ schulGrdList: toSchoolGradePayload(values.schoolCode, values.grades),
257	283	};
258	284	}
259	285
...	...	@@ -261,29 +287,55 @@
261	287	return {
262	288	cntntsNm: values.name,
263	289	cntntsTitle: values.name,
264		- cntntsSbjct: values.subject,
265		- cntntsMssage: values.message,
266		- schulCd: values.schoolCode,
267		- gradeCd: values.grades.join(','),
268		- // 이슈: 기획은 "각 컷을 개별 이미지로 업로드"인데 백엔드 컬럼은 `atchFileId` 한 칸뿐이라
269		- // 컷 묶음을 여러 개 연결할 자리가 없다. 지금은 첫 묶음만 저장된다.
	290	+ // 컷은 한 첨부 아래 fileSn 1..N으로 들어간다 — 배열 값이 모두 같은 첨부 아이디다.
270	291	atchFileId: values.cutFileIds[0] ?? '',
271	292	thumbAtchFileId: values.thumbnailFileId,
272	293	useYn: values.isVisible ? 'Y' : 'N',
273	294	keywordList: toKeywordPayload(values.keywords),
	295	+ schulGrdList: toSchoolGradePayload(values.schoolCode, values.grades),
274	296	};
	297	+}
	298	+
	299	+/**
	300	+ * 등록은 `@RequestBody`가 없어 form으로 간다. 중첩 목록은 Spring이 읽는 인덱스 표기
	301	+ * (`keywordList[0].cntntsKeyword`)로 편다 — JSON으로 보내면 한 칸도 바인딩되지 않는다.
	302	+ */
	303	+function toFormParams(
	304	+ payload: ContentWritePayload & { cntntsType?: string }
	305	+): Record<string, string \| number \| undefined> {
	306	+ const params: Record<string, string \| number \| undefined> = {
	307	+ cntntsType: payload.cntntsType,
	308	+ cntntsNm: payload.cntntsNm,
	309	+ cntntsTitle: payload.cntntsTitle,
	310	+ atchFileId: payload.atchFileId,
	311	+ thumbAtchFileId: payload.thumbAtchFileId,
	312	+ useYn: payload.useYn,
	313	+ };
	314	+
	315	+ payload.keywordList.forEach((item, index) => {
	316	+ params[`keywordList[${index}].cntntsKeyword`] = item.cntntsKeyword;
	317	+ params[`keywordList[${index}].cntntsExpln`] = item.cntntsExpln;
	318	+ });
	319	+ payload.schulGrdList.forEach((item, index) => {
	320	+ params[`schulGrdList[${index}].schulCd`] = item.schulCd;
	321	+ params[`schulGrdList[${index}].grdCd`] = item.grdCd;
	322	+ });
	323	+
	324	+ return params;
275	325	}
276	326
277	327	async function sendWrite(
278	328	path: string,
279	329	method: 'POST' \| 'PUT' \| 'DELETE',
280		- body?: unknown
	330	+ body?: unknown,
	331	+ form?: Record<string, string \| number \| undefined>
281	332	): Promise<string \| null> {
282	333	const accessToken = await getSessionAccessToken();
283	334
284	335	const result = await backendFetch<unknown>(path, {
285	336	method,
286	337	...(body === undefined ? {} : { body }),
	338	+ ...(form === undefined ? {} : { form }),
287	339	accessToken: accessToken ?? undefined,
288	340	cache: 'no-store',
289	341	canHaveNullData: true,
...	...	@@ -302,7 +354,7 @@
302	354	payload: ContentWritePayload,
303	355	cntntsType: string
304	356	): Promise<string \| null> {
305		- return sendWrite(basePath(kind), 'POST', { ...payload, cntntsType });
	357	+ return sendWrite(CONTENT_BASE_PATH, 'POST', undefined, toFormParams({ ...payload, cntntsType }));
306	358	}
307	359
308	360	export async function updateContent(
...	...	@@ -311,7 +363,7 @@
311	363	payload: ContentWritePayload
312	364	): Promise<void> {
313	365	await sendWrite(
314		- `${basePath(kind)}/${encodeURIComponent(cntntsSn)}`,
	366	+ `${CONTENT_BASE_PATH}/${encodeURIComponent(cntntsSn)}`,
315	367	'PUT',
316	368	payload
317	369	);
...	...	@@ -321,15 +373,21 @@
321	373	kind: ContentApiKind,
322	374	cntntsSn: string
323	375	): Promise<void> {
324		- await sendWrite(`${basePath(kind)}/${encodeURIComponent(cntntsSn)}`, 'DELETE');
	376	+ await sendWrite(`${CONTENT_BASE_PATH}/${encodeURIComponent(cntntsSn)}`, 'DELETE');
325	377	}
326	378
327	379	export function contentThumbnailUrl(item: ContentItem): string \| null {
328	380	return buildFileImageUrl(item.thumbnailFileId);
329	381	}
330	382
	383	+/** 컷 이미지 주소 — 응답이 준 파일 번호를 쓰고, 없으면 1..count로 채운다. */
331	384	export function contentCutUrls(item: ContentItem, count: number): string[] {
332		- return Array.from({ length: count }, (_, index) =>
333		- buildFileImageUrl(item.attachmentId, index + 1)
334		- ).filter((url): url is string => url !== null);
	385	+ const numbers =
	386	+ item.cutFileNumbers.length > 0
	387	+ ? item.cutFileNumbers
	388	+ : Array.from({ length: count }, (_, index) => index + 1);
	389	+
	390	+ return numbers
	391	+ .map((fileSn) => buildFileImageUrl(item.attachmentId, fileSn))
	392	+ .filter((url): url is string => url !== null);
335	393	}

...	...	@@ -86,6 +86,8 @@
86	86	keywords: ContentKeyword[];
87	87	/** 만화의 컷 이미지·쇼츠의 영상이 묶인 첨부 ID. */
88	88	attachmentId: string \| null;
	89	+ /** 만화 컷처럼 한 첨부 아래 여러 파일이 있을 때의 파일 번호들. */
	90	+ cutFileNumbers: number[];
89	91	thumbnailFileId: string \| null;
90	92	isVisible: boolean;
91	93	modifiedAt: string \| null;

Delete comment