백엔드 40f85c4 — 묶음 업로드가 atchFileId를 받으면 그 묶음 뒤에 새 장만 덧붙인다. 저장된 장이
앞에 그대로 있고 새 장이 뒤에만 붙는 저장은 이 경로로 보내 저장된 장을 다시 읽지 않는다
(파일이 다른 서버에 있어도 됨). 순서 변경·삭제는 전처럼 통째로 다시 올린다. 앱 API가
frcsBadge의 쉼표 코드를 FRCS_BADGE_CD 이름으로 풀므로 배지 선택지·표시·검증도 그 코드표로
바꾼다(하드코딩 BEST/MAIN/NEW/SALE 제거).
Co-Authored-By: Claude Fable 5.1
단건 조회가 상세 없음을 NOT_FOUND 대신 성공 봉투의 null로 주는 것, 삭제된 상세를
selectOne이 그대로 돌려주는 결함(재등록 409·수정 화면에 삭제값 노출), 프론트가 쓰지 않게
된 건수 쿼리 문제를 문서에 맞춘다. 등록 409는 삭제 잔존 안내 문구로 바꾼다.
Co-Authored-By: Claude Fable 5.1
이미지 파일은 서버 디스크에만 있고 DB 행은 공유되므로, dev에서 올린 이미지를 로컬 백엔드로
붙어 다시 읽으면 200에 빈 본문이 온다(백엔드가 없는 파일에 404 대신 빈 200을 준다 — 보고함).
그 0KB 파일이 묶음 재업로드에 섞여 500이 났다. 빈 본문은 실패로 다뤄 안내하고, 존재 확인도
content-length 0을 없는 것으로 센다.
Co-Authored-By: Claude Opus 5
Next가 감싼 fetch는 response.body.cancel()이 영영 끝나지 않아(라우터 서버 안에서 재현) 추가
이미지 존재 확인이 멈추고 상세 화면이 렌더되지 않았다. node:http 요청으로 응답 머리만 보고
바로 끊으며 5초 타임아웃을 둔다(같은 프로세스에서 11장 0.4초 확인).
Co-Authored-By: Claude Opus 5
백엔드 인증 예외가 GET에만 열려 있어 이미지 존재 확인 HEAD가 전부 401로 떨어졌고, 그래서
저장한 추가 이미지 묶음이 수정 화면에 한 장도 안 보이고 다시 저장하면 묶음 id까지 지워졌다.
GET으로 상태만 보고 본문은 바로 끊는다(dev 실물 묶음으로 1장 검출 확인).
Co-Authored-By: Claude Opus 5
BizPlay 업종 값이 2자리(FRCS_TPBIZ_CD)와 4자리(FRCS_CD = 업종+업태)로 섞여 온다. 두 표를
차례로 이어 붙여 앞 표가 먼저 맞게 한다(사용자 확정). 목록·상세 모달·엑셀이 같은 표를 쓴다.
Co-Authored-By: Claude Opus 5
feature/voc b009025 재확인 — 관리자 쪽 추가는 업종 세분류 이름(frcsCdNm)뿐이라 계약은
그대로다. 노출 토글·일괄 비활성은 값만 다시 보내므로 단건 조회에서 추가 이미지 HEAD 더듬기를
끈다(건당 최대 11회 → 0회). 일괄 삭제·비활성은 차례로 멈추던 것을 동시에 보내고 실패 수를
세어 알린다(백엔드에 트랜잭션이 없어 어차피 부분 반영된다).
Co-Authored-By: Claude Opus 5
업종 값은 BizPlay FRCS_TPBIZ_CD(CHAR라 뒤 공백 제거)이고 그동안 구분코드(FRCS_DV_CD)를 읽어
하드코딩 목록과 맞추고 있었다. 공통코드 FRCS_TPBIZ_CD를 받아 목록 열·상세 모달 선택지·엑셀이
같은 표로 이름을 찾는다(사용자 확정).
Co-Authored-By: Claude Opus 5
백엔드가 카테고리 이름(frcsTypeCdNm)을 붙여 주므로 목록·메뉴 폼이 그것을 먼저 쓰고 코드표
매핑은 뒤로 물린다. 추가 이미지 장수를 알아내는 HEAD 더듬기는 차례가 아니라 한꺼번에 보내
왕복을 한 번으로 줄인다. 가맹점 목록이 useYn을 주기 시작한 것을 문서에 반영한다.
Co-Authored-By: Claude Opus 5
Node 20으로 띄우면 인스펙터 Network 도메인이 fetch를 잡지 못해 요청이 조용히 안 보인다
(실제 라우터 서버가 v20.20.2로 떠 있던 것을 확인). 버전 가드를 앞에 두어 nvm use를 안내한다.
Co-Authored-By: Claude Opus 5
백엔드(feature/voc) 목록은 상세 있는 가맹점만 주므로 Repository가 가맹점 목록에 상세 목록을
덧입혀 합치고, 검색·카테고리·노출·등록일 기간·페이지를 프론트에서 처리한다(사용자 확정). 상세
없는 행의 [수정]은 가맹점 목록에서 그 건을 찾아 고정한 채 처음 만드는 화면을 연다. 상세 응답에
업체명이 빠지는 결함은 가맹점 목록의 이름으로 메운다.
Co-Authored-By: Claude Opus 5
목록·단건이 소개·카테고리 코드·영업시간·휴무일·순서·추가이미지·우편번호·등록자·등록일·수정일을
돌려주고, 목록은 상세가 있는 가맹점만(INNER JOIN), 상세 없는 단건은 NOT_FOUND, 등록은 상세가
있으면 409다. 그래서 등록 진입을 다시 가맹점 선택 화면(/new)으로 두고 — 선택지는 가맹점 전체에서
상세 보유분을 뺀 차집합 — 행의 [수정]은 상세 있는 가맹점만 연다. 응답 VO에 frcsNm이 빠진 결함은
업체명 자리에 코드를 보이는 것으로 버틴다(보고함).
Co-Authored-By: Claude Opus 5
관리자 앱은 백엔드를 서버(Server Component·Action)에서만 부르므로 브라우저 Network 탭에는
안 잡힌다. Node 24부터 인스펙터 Network 도메인이 undici fetch를 잡으므로(20은 안 됨 — 확인)
`next dev --inspect`에 `--experimental-network-inspection`을 얹어 chrome://inspect의
라우터 서버 타깃에서 본다. 클라이언트 직접 호출로 바꾸는 것은 토큰 노출이라 하지 않는다.
Co-Authored-By: Claude Opus 5
PUT /api/v1/common/ntcn/{ntcnSn}을 규약대로 붙인다. 누르는 즉시 낙관적으로 읽음 표시
(표시선·배지 감소)를 하고 이동한 뒤 router.refresh()로 서버 목록에 되맞춘다.
백엔드 컨트롤러가 아직 경로변수 ntcnSn과 readYn을 VO에 담지 않아 어느 행도 갱신되지
않고 200만 돌아온다 — 그래서 지금은 새로 고치면 안 읽음으로 돌아온다. 백엔드가
setNtcnSn(ntcnSn)·setReadYn("Y") 두 줄을 채우면 프론트 수정 없이 동작한다.
Co-Authored-By: Claude Opus 5
한줄 소개·카테고리·영업시간·휴무일·노출 순서·추가 이미지는 INSERT/UPDATE에 실려 저장되지만
(dev 앱용 API로 영업시간·휴무일·이미지 id 저장 확인) 관리자 단건 SELECT에 그 컬럼이 없어
화면에선 비어 보이고, 그대로 저장하면 빈 값으로 덮어써진다. 컬럼이 추가될 때까지 경고를
둔다.
Co-Authored-By: Claude Opus 5
상세가 없는 가맹점도 목록에 서므로 상세 화면은 언제나 행에서 들어온다 — 업체명 선택 상자와
/new 화면, 그 선택지를 만들던 전 페이지 훑기를 지운다. 업체(가맹점)는 BizPlay 미러라
[+ 업체 등록]은 시안 자리만 지키고 비활성이다(사용자 확정). 표의 대표이미지는 인라인
흐름에 두어 셀 가운데에 선다.
Co-Authored-By: Claude Opus 5
목록은 백엔드 페이지를 그대로 쓰고(전 페이지 훑기는 등록 화면의 가맹점 선택지에만 남긴다),
상세가 없는 행의 [수정]은 그 가맹점을 고정한 상세 화면으로 가서 거기서 처음 만든다
(사용자 확정). 등록 화면으로 되돌리던 리다이렉트와 그 경로 도우미는 지운다.
Co-Authored-By: Claude Opus 5
제목·경로 표시·구성을 「가맹몰 상세 정보」 하나로 두고, 저장 액션은 리다이렉트 대신 결과를
돌려준다. 처음 저장하면 토스트를 띄우고 그 가맹점 주소로만 옮겨 가 화면은 그대로이고
(바로 메뉴 추가 가능), 이후 저장은 그 자리에서 새로고침한다(사용자 확정). 이미지 칸은
저장으로 파일 id가 바뀌면 다시 마운트해 서버 값과 맞춘다.
Co-Authored-By: Claude Opus 5
dev 로그로 확인 — POST /common/file/upload/MODULE_VOUCHER(·/list)가 68~95KB PNG에도
500을 돌려줘 상세 등록이 막혔다. 저장소 설정 표에 바우처 행이 없고 코드상 기본 저장소
(FILE_STORAGE) 폴백도 dev DB에 행이 없어 거기서 터진다. 한 장은 콘텐츠 섬네일
저장소(MODULE_CONTENT_THUMB), 여러 장 묶음은 4컷만화 저장소(MODULE_TOON_CONTENT)를
빌려 쓴다 — 바우처 행이 생기면 file-module.ts의 두 ID만 바꾼다.
Co-Authored-By: Claude Opus 5
[+ 업체 등록]은 /system/merchant-details/new로 간다 — 업체명 자리에서 상세가 없는 가맹점을
고르면 연락처·주소가 채워지고 나머지는 같은 폼이다(사용자 확정). 행의 [수정]은 언제나 수정
화면이 되도록 목록에는 상세가 등록된 가맹점만 세운다 — 백엔드 목록에 그 조건이 없어
Repository가 전 페이지를 받아 거르고 화면 쪽 페이지로 자른다(TODO 백엔드). 상세가 없는
가맹점의 수정 주소로 들어오면 등록 화면으로 보내 미리 골라 둔다.
Co-Authored-By: Claude Opus 5
