업종 선택지는 FRCS_TPBIZ_CD(2자리)만 — 4자리 FRCS_CD는 업종+업태를 이어 붙인 표시용이라 저장값이
아니다. 연락처는 BizPlay 행처럼 숫자만 보낸다. 백엔드가 BizPlay 위임을 끊고 TB_COM_VOUCHER에
직접 넣게 된 것과 수정 VO에 frcsNo가 빠진 결함을 문서에 적는다.
Co-Authored-By: Claude Fable 5.1
가맹몰 관리 — [등록] 버튼과 수정 모달을 활성화해 백엔드 VO(MngrVocInsertReqVo/UpdateReqVo)
대로 JSON으로 보낸다. 예금주·입금은행(COM_BANK_CD)·계좌·업태(FRCS_BZSTAT_CD)·구분(FRCS_DV_CD)
항목을 더하고 주소·우편번호도 직접 고칠 수 있다. 백엔드는 아직 BizPlay(웹캐시) 위임이고
우리 DB 저장으로 바뀔 예정(사용자 공지)이라 응답의 가맹점 코드는 어느 모양이든 읽고, 없으면
목록에서 이름·연락처로 찾는다.
가맹몰 상세 — 업체명·연락처·우편번호([주소 검색])·주소·상세주소를 읽기 전용에서 입력으로
바꾼다(사용자 확정). 저장하면 가맹점을 만들거나(코드 없음) 바뀐 값만 고친(코드 있음) 뒤 상세를
붙인다. 가맹점 선택 화면은 빈 등록 폼으로 바뀐다. 우편번호 검색 도우미는 두 화면이 쓰므로
app/_components/postcode.ts로 옮긴다.
Co-Authored-By: Claude Fable 5.1
백엔드 1c7b0e0 — GET /common/file/image/list/{atchFileId}가 생겨 이미지 존재를 더듬던 코드
(HEAD 401·fetch 취소 멈춤·빈 200을 거치며 세 번 고친 것)를 전부 걷어낸다. 상세 목록·단건이
메뉴 건수(productCnt)를 주고 카테고리 코드표 INNER JOIN이 빠졌으며, 가맹점 목록은 등록일
(frstRegDtStr)을 준다.
Co-Authored-By: Claude Fable 5.1
COM_FRCS_TYPE_CD엔 첫 코드(이탈리안음식점) 하나만 남아 있고 백엔드도 이름을 FRCS_TYPE_CD로
푼다. 관리자 목록·단건 SQL의 코드표 조인만 아직 COM_ 그룹이라(보고함) 새 코드로 저장한 상세가
목록에서 빠질 수 있다.
Co-Authored-By: Claude Fable 5.1
백엔드 40f85c4 — 묶음 업로드가 atchFileId를 받으면 그 묶음 뒤에 새 장만 덧붙인다. 저장된 장이
앞에 그대로 있고 새 장이 뒤에만 붙는 저장은 이 경로로 보내 저장된 장을 다시 읽지 않는다
(파일이 다른 서버에 있어도 됨). 순서 변경·삭제는 전처럼 통째로 다시 올린다. 앱 API가
frcsBadge의 쉼표 코드를 FRCS_BADGE_CD 이름으로 풀므로 배지 선택지·표시·검증도 그 코드표로
바꾼다(하드코딩 BEST/MAIN/NEW/SALE 제거).
Co-Authored-By: Claude Fable 5.1
BizPlay 업종 값이 2자리(FRCS_TPBIZ_CD)와 4자리(FRCS_CD = 업종+업태)로 섞여 온다. 두 표를
차례로 이어 붙여 앞 표가 먼저 맞게 한다(사용자 확정). 목록·상세 모달·엑셀이 같은 표를 쓴다.
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
목록·단건이 소개·카테고리 코드·영업시간·휴무일·순서·추가이미지·우편번호·등록자·등록일·수정일을
돌려주고, 목록은 상세가 있는 가맹점만(INNER JOIN), 상세 없는 단건은 NOT_FOUND, 등록은 상세가
있으면 409다. 그래서 등록 진입을 다시 가맹점 선택 화면(/new)으로 두고 — 선택지는 가맹점 전체에서
상세 보유분을 뺀 차집합 — 행의 [수정]은 상세 있는 가맹점만 연다. 응답 VO에 frcsNm이 빠진 결함은
업체명 자리에 코드를 보이는 것으로 버틴다(보고함).
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
알림에 대상 컬럼이 없어(TB_COM_NTCN: 제목·내용·읽음뿐) 제목으로 가른다 — 지금 쌓이는
알림은 학습자 1:1문의 등록 하나라 1:1문의 게시판(/boards/inquiries)으로 보낸다. 누르면
드롭다운을 닫고, 링크는 hover·focus 표시를 갖는다. 모르는 알림은 종전처럼 누를 수 없다.
내용 줄은 두 줄로 잘라 요약처럼 보이게 하고 전체는 title로 남긴다. 다만 백엔드가
내용을 고정 문구("학습자가 1:1 문의 게시판에 게시글을 등록하였습니다")로 넣고 있어
실제 게시글 요약은 CmmBbsServiceImpl.insert가 ntcnCn에 글 본문을 실어 줘야 나온다.
Co-Authored-By: Claude Opus 5
MngrVocDetailVo는 MngrVocVo를 상속해 useYn을 갖는다 — 등록·수정·조회 모두 실리므로
결함이 아니었다(origin/develop 22f67cb 재확인). 남은 결함은 셋: 단건 SELECT의 상세 컬럼
누락, 등록일 검색 조건 미사용, 바우처 사용 필드 부재. hasDetail 주석도 c5ad833 이후
상태로 맞춘다.
Co-Authored-By: Claude Opus 5
카테고리·노출 상태·등록일 기간은 고를 때마다 조회하던 것을 초안으로만 두고 [적용] 한 번에
보낸다(사용자 확정). 업체명 검색은 검색 상자가 그대로 바로 반영한다.
등록일 규칙 — 시작일은 오늘을 넘지 못하고 종료일은 시작일보다 앞설 수 없다. 피커의 max/min으로
막고, 어기는 값은 clampDateRange가 경계로 당긴다. URL 파싱도 같은 함수를 쓴다 — 주소로 직접
넣은 값도 규칙을 지킨다.
오늘 날짜는 page.tsx가 정해 prop으로 내린다. 클라이언트에서 계산하면 서버·브라우저의
시간대·자정 경계에서 hydration이 어긋난다.
Co-Authored-By: Claude Opus 5
기획 BO-MAL-001~004(지역상생몰 > 업체관리)를 「가맹몰 상세 관리」로 옮겼다. 백엔드
(15d409a)의 상세는 기존 가맹점(frcsNo)에 1:1로 붙는 구조라 업체를 새로 만들지 않는다 —
목록에 가맹점 전체를 보이고 행에서 [상세 등록]으로 들어가며, 업체명·연락처·주소는 가맹점
원본을 읽기 전용으로 보여 준다(사용자 확정).
- 목록: 업체명·카테고리·노출상태·등록일 검색, 체크박스 일괄 비활성·삭제, 행 관리
- 등록·수정(/[frcsNo]): 기본 정보 + 이미지(대표 1 + 추가 11) + 메뉴 표 + 등록 정보
- 메뉴 등록·수정(/[frcsNo]/products): 이미지·메뉴명·가격·설명·배지·노출·순서
- @fox FoxSortableList 신설 — 네이티브 DnD + 방향키, 상태 없이 onReorder만 (사용자 확정)
- 배지는 코드를 쉼표로 이어 frcsBadge에 싣는다(BEST,MAIN,NEW,SALE — 사용자 확정)
- 파일 저장소 모듈은 바우처용이 없어 잠정 MODULE_VOUCHER (사용자 확정)
백엔드가 아직 주지 않는 값(노출 상태·카테고리·수정 프리필·기간 검색·메뉴 건수·바우처 사용)은
화면을 시안대로 두고 그대로 보낸다(사용자 확정). 목록의 노출 토글만은 예외다 — PUT이 모든
컬럼을 덮어써 단건 조회가 비어 있는 동안 값 없이 보내면 상세가 지워지므로, 조회 결과에
대표이미지가 없으면 거부하고 수정 화면으로 안내한다.
추가 이미지 묶음은 fileSn이 1..n으로 채번되어 순서·삭제·추가 어느 것이든 통째로 다시 올린다.
저장된 장은 백엔드에서 다시 읽어 합친다. 묶음의 장 수를 묻는 API가 없어 HEAD로 더듬는다.
Co-Authored-By: Claude Opus 5
가맹점: 조회 SQL이 USE_YN을 select하지 않고 MngrVocVo에도 필드가 없어 값이 오지 않는데
`!== 'N'`으로 읽어 늘 「노출」이었다. 「미노출」로 걸러 낸 행까지 전부 「노출」로 보였다.
값이 없으면 판단하지 않고(null) 목록·모달 모두 고르지 않은 상태로 둔다 — 브랜드명·메모·
등록일과 같은 처리다(사용자 확정). 신규 등록만 「노출」로 시작한다.
회원: 학생·관리자 모두 상태를 바꿀 수는 있는데 목록에 그 열이 없어 확인할 자리가 없었다.
학생은 사용여부(useYn), 관리자는 잠김여부(acctLockYn의 반대)를 열로 넣는다. 값이 없는 행은
`-`다.
Co-Authored-By: Claude Opus 5
칸·열·검색·필터는 IS_BOARD_CATEGORY_ENABLED에 걸어 뒀는데 검증만 빠져 있었다. 화면에
구분 칸이 없어 값이 오지 않으므로 공지사항 등록이 「구분을 선택해 주세요」로 막혔다.
검증도 같은 플래그를 보게 한다 — 호출부가 아니라 검증기 안에서 본다. Server Action은 UI를
거치지 않고 호출될 수 있어, 스위치가 한 곳에 있어야 되살릴 때도 어긋나지 않는다.
Co-Authored-By: Claude Opus 5
