그누보드7 기반 팝업스토어 예약 운영을 위한 glitter-reservation_popup의 첫 공개 릴리스입니다.
이 모듈은 이벤트, 회차, 예약, 취소, 체크인까지 이어지는 팝업스토어 예약 운영 흐름을 하나의 모듈로 제공합니다.
주요 기능
- 팝업 이벤트 관리
- 예약 가능 회차 관리
- 사용자 예약 접수
- 예약 조회 및 취소
- 관리자 예약 현황 관리
- QR/체크인 운영
- 이벤트별 예약 및 체크인 상태 관리
- 관리자용 JSON Layout UI
- 한국어/영어 다국어 지원
관리자 기능
관리자에서는 다음 기능을 제공합니다.
- 이벤트 목록 및 상세 관리
- 이벤트 생성 및 수정
- 예약 현황 조회
- 예약 상태 관리
- 회차 관리
- 체크인 관리
- 주요 운영 현황 요약
관리자 진입 경로:
/admin/reservation-popups
관리자 사이드 메뉴는 모듈 식별성을 높이기 위해 다음 이름을 사용합니다.
- 한국어:
반짝이 예약 팝업 관리 - 영어:
Glitter Reservation Popup Management
Frontend i18n
Gnuboard7의 frontend i18n 규약에 맞춰 관리자 JSON Layout의 표시 문자열을 번역 리소스로 분리했습니다.
한국어와 영어 번역 리소스를 제공하며, 관리자 화면에서 translation key가 그대로 노출되지 않도록 i18n contract를 정비했습니다.
주요 대상:
- 관리자 화면 제목 및 설명
- 이벤트 생성
- 체크인 관리
- 전체 이벤트
- 진행 중인 이벤트
- 오늘 예약
- 오늘 체크인
- 최근 예약
- 기타 관리자 UI 문구
구조
모듈은 Gnuboard7 확장 구조에 맞춰 다음 계층으로 구성됩니다.
- Controller
- Request
- Resource
- Service
- Repository
- Model
- Module Service Provider
- JSON Layout
- Module Routes
- Module i18n
- Database Migration
예약 도메인별 Repository Interface와 Service를 분리해 유지보수 및 확장이 가능하도록 구성했습니다.
데이터 모델
팝업 예약 운영을 위해 다음 주요 데이터를 관리합니다.
- Events
- Slots
- Reservations
- Cancellations
- Check-ins
각 기능은 독립된 migration과 domain layer를 통해 관리됩니다.
API
Public, Auth, Admin 영역을 분리하여 API를 제공합니다.
주요 영역:
- 공개 이벤트 조회
- 인증 사용자 예약
- 예약 취소
- 관리자 이벤트 관리
- 관리자 회차 관리
- 관리자 예약 관리
- 관리자 체크인 관리
각 API는 Gnuboard7의 인증 및 권한 구조를 따릅니다.
테스트
이번 릴리스에는 다음 테스트가 포함됩니다.
- Reservation Popup API Feature Test
- Domain Service Unit Test
- Admin Layout Test
- Frontend i18n Contract Test
Frontend i18n contract test를 통해 layout에서 사용하는 번역 키가 언어 리소스와 일치하는지 검증합니다.
호환성
- Gnuboard7 7.x
- PHP 8.2+
- Laravel 12.x
- MySQL 8.x
설치
Gnuboard7의 공식 모듈 설치 및 업데이트 lifecycle을 사용해 설치하세요.
저장소:
https://github.com/glitter-node/glitter-reservation_popup
Release tag:
v0.1.1
참고
이 릴리스는 팝업스토어 예약 운영의 핵심 흐름과 관리자 기능을 제공하는 초기 안정화 버전입니다.
향후 실제 운영 피드백을 바탕으로 예약 정책, 회차 운영, 체크인 흐름 및 관리자 UX를 계속 보완할 예정입니다.