프로젝트 개요
홈페이지에서 들어온 예약·결제·문자 발송·블로그를 운영자가 한곳에서 처리하는 확장 프로젝트입니다. 예약 현황판, 결제·환불 처리, 문자·알림 템플릿, 블로그 관리, 기존 관리자 페이지와의 연동 상태, 회원과 수강 통계 화면을 제안하며, MVP와 같은 데이터 구조 위에서 단계적으로 확장할 수 있습니다.
작업 범위
- 예약 현황 대시보드: 오늘과 이번 주 수업별 예약·대기·취소 건수를 현황판으로 보고, 처리가 필요한 건을 바로 열어 상태를 바꿉니다. 수강 인원 추이와 회원 등록 현황도 함께 제안합니다
- 결제·환불 관리: 네이버페이·카카오페이 결제 내역을 조회하고, 환불 요청을 검토해 부분·전체 취소를 처리합니다
- 문자·알림 템플릿: 예약 확정·변경·취소 문자와 수업 전 리마인더 템플릿을 편집하고, 발송 예정 목록과 결과를 확인합니다
- 관리자 연동 현황: 기존 관리자 페이지로 예약·결제 정보를 넘기는 연동 상태와 실패 건, 재전송 이력을 확인합니다
주요 업무
- 예약 현황 대시보드 화면: 수업별 예약 현황판, 대기 처리, 회원·수강 통계
- 결제·환불 관리 화면: 결제 내역 조회, 환불 승인·거절, 정산 대조
- 문자·알림 템플릿 화면: 템플릿 편집, 리마인더 스케줄, 발송 결과 조회
- 관리자 연동 현황 화면: 연동 작업 목록, 실패 재처리, 필드 매핑 확인




프로젝트 핵심 과제
기존 관리자 페이지의 데이터 구조가 다를 수
필드 매핑을 설정으로 분리해 대응합니다
문자 발송 비용과 발신번호 명의가 발주사 측 계약이라 템플릿 승인 절차를 일정에 포함할 계획입니다
환불 규칙이 수업 유형별로 다를 수
규칙표를 설정으로 두어 조정 가능하게 설계합니다
PG 취소와 예약 상태 변경이 어긋나지 않
재시도와 대조 작업을 함께 설계합니다
핵심 기능 상세
예약 현황 대시보드
오늘과 이번 주 수업별 예약·대기·취소 건수를 현황판으로 보고, 처리가 필요한 건을 바로 열어 상태를 바꿉니다. 수강 인원 추이와 회원 등록 현황도 함께 제안합니다.
- 수업·회차별 집계 쿼리를 뷰로 묶어 현황판과 통계가 같은 값을 읽는 구조 설계
- 대기 신청을 취소 발생 시 순번대로 승급하는 서버 작업 구현
- 관리자 권한을 역할 기반으로 나눠 메뉴와 API 접근을 함께 제한하는 구조 적용
예약·대기·취소가 한 현황판에서 처리되고 같은 변경이 홈페이지 잔여 좌석에 반영되는 구조를 구현합니다.


결제·환불 관리
네이버페이·카카오페이 결제 내역을 조회하고, 환불 요청을 검토해 부분·전체 취소를 처리합니다. 결제 내역 조회, 환불 승인·거절, 정산 대조.
- 결제 내역과 PG 승인 번호를 함께 저장해 PG 거래 조회와 대조하는 구조 설계
- 환불 요청을 승인하면 PG 취소 API 호출과 예약 상태 변경을 한 작업으로 묶는 로직 구현
- 일자별 정산 대조표를 CSV로 내려받는 기능 구현
환불 승인 한 번으로 PG 취소와 예약 상태·알림이 함께 처리되는 흐름을 구현합니다.


문자·알림 템플릿
예약 확정·변경·취소 문자와 수업 전 리마인더 템플릿을 편집하고, 발송 예정 목록과 결과를 확인합니다. 템플릿 편집, 리마인더 스케줄, 발송 결과 조회.
- 문자·알림톡 발송 API를 발송 어댑터로 감싸 템플릿 변수를 치환하는 구조 설계
- 수업 시작 전 시각을 기준으로 리마인더를 예약하고 작업 큐로 처리하는 스케줄러 구현
- 발송 결과와 실패 사유를 이력 테이블에 남기고 재발송을 지원하는 로직 적용
템플릿 한 번 수정으로 이후 발송 문구가 바뀌고 발송 결과가 목록에서 추적되는 구조를 구현합니다.


관리자 연동 현황
기존 관리자 페이지로 예약·결제 정보를 넘기는 연동 상태와 실패 건, 재전송 이력을 확인합니다. 연동 작업 목록, 실패 재처리, 필드 매핑 확인.
- 기존 관리자 페이지의 데이터 구조에 맞춘 필드 매핑표를 설정으로 분리하는 구조 설계
- 연동 작업을 큐에 쌓고 실패 시 재시도 횟수를 제한하며 재전송하는 로직 구현
- 연동 이력과 요청·응답 요약을 남겨 원인을 추적하는 로그 구조 적용
홈페이지 데이터가 기존 관리자 페이지 형식으로 넘어가는 경로와 실패 재처리를 한 화면에서 확인하는 구조를 구현합니다.


프로젝트 진행 단계
운영 데이터 집계 설계 · 2026.11
수업별 예약 집계 뷰와 회원·수강 통계 쿼리 설계
결제·환불 처리 구현 · 2026.11
환불 승인 흐름과 PG 취소 호출, 정산 대조표 구현
문자·알림 스케줄러 구현 · 2026.11
템플릿 변수 치환, 리마인더 예약 큐, 발송 이력 구현
관리자 연동 어댑터 구현 · 2026.11
필드 매핑 설정, 연동 작업 큐와 재전송 로직, 블로그 관리 화면 구현
개발 결과
기술적 주안점
- 예약·대기·취소가 한 현황판에서 처리되고 같은 변경이 홈페이지 잔여 좌석에 반영되는 구조를 구현합니다
- 환불 승인 한 번으로 PG 취소와 예약 상태·알림이 함께 처리되는 흐름을 구현합니다
- 템플릿 한 번 수정으로 이후 발송 문구가 바뀌고 발송 결과가 목록에서 추적되는 구조를 구현합니다