개발일지 (2026-07-20)

개요

카카오 알림톡 템플릿 형식을 뿌리오 심사 규격([*N*])에 맞춰 전면 교체하고, 악보 상세 화면 3단계 분리, 악보 요청 삭제 기능, 하드코딩 제거 등을 진행했다.

---

수정/생성 파일 목록

백엔드 (piano-backend)

• PpurioService.java (수정) — [*N*] / [*이름*] 형식 변수 치환 추가
• AcademyNotificationSender.java (수정) — 학원명 자동 주입, 카카오 알림톡 발송 + SMS 폴백
• NotificationTemplate.java (수정) — kakaoTemplateCode 필드 추가
• NotificationTemplateMapper.xml (수정) — kakao_template_code COALESCE 조회 누락 수정
• StudentSheetRequestController.java (수정) — 삭제 조건 변경 (PROCESSING만 차단)

프론트 — 학원 앱 (academy)

• pages/NotificationTemplates.tsx (수정) — VAR_MAP [*N*] 형식 전면 교체, 제목 편집, 뿌리오 카카오 키 입력
• api/notificationTemplates.ts (수정) — kakaoTemplateCode 필드 추가

프론트 — 학생 앱 (student)

• pages/SheetsPage.tsx (수정) — 악보 상세 3단계 분리 (목록→리스트→상세), "출력 요청"/"상세보기" 버튼
• pages/DashboardPage.tsx (수정) — "피아노" 하드코딩 제거
• pages/MyPage.tsx (수정) — "피아노" 하드코딩 제거
• pages/LoginPage.tsx (수정) — 슬로건 "음악과 함께 성장하는 특별한 시간"

프론트 — sheets 사이트

• lib/types.ts (수정) — 상태 타입 "검토중" → "접수대기"
• lib/api/requests.ts (수정) — 상태 매핑 변경 + deleteRequest API 추가
• app/request/page.tsx (수정) — 접수대기 시 삭제 버튼 추가

DB

• academy_notification_templates — 전체 템플릿 [*N*] 형식 교체, 뿌리오 키 6종 등록

---

파일별 상세

1. 카카오 알림톡 변수 형식 통일

카카오 심사에서 {1} 형식이 반려되어 [*N*] / [*이름*] 형식으로 전면 교체.

등록된 뿌리오 카카오 키 6종:

• 레슨 확정, 예약 알림, 결제 완료, 환불 완료, 상담 예약, 수강권 만료

2. 악보 상세 3단계 분리

곡 클릭 → 악보 리스트 (난이도/편곡 칩 + 상세보기) → 미리보기 상세 (PDF + 출력 요청 + 보관함)

3. 악보 요청 삭제

• 백엔드: PROCESSING 아닌 모든 상태에서 삭제 가능
• sheets: 접수대기 시 삭제 버튼 + 확인 팝업
• 상태명: "검토중" → "접수대기"

4. 알림 발송 시점 정책 정리

즉시 발송(레슨 확정/결제/환불 등) + 사전 알림 배치(리마인더/만료) 2가지로 통일.

---

트러블슈팅 메모

• kakao_template_code 조회 누락: COALESCE 쿼리에 컬럼 빠짐 → SELECT에 추가
• 카카오 심사 반려: {1} → [*N*], 수신자 액션 명시 필요
• sheets 타입 에러: 상태 리터럴 변경 시 types.ts도 함께 수정 필요

---

결론 / 배운 점

• 카카오 알림톡은 변수 형식에 엄격하다. [*변수*] + 수신자 액션 필수.
• UI 흐름은 단계별 분리가 직관적. 목록→리스트→상세 3단계.
• 발송 시점은 단순하게. 즉시 + 고정 사전 알림이 운영 효율적.