그누보드7 예약 모듈

개요

그누보드7 예약 모듈인 glitter-reservation은 그누보드7에서 동작하는 번들형 예약 모듈입니다. 예약 신청, 조회, 취소, 이메일 인증까지 이어지는 전체 예약 흐름을 제공하며, 코어 수정 없이 어떤 그누보드7 프로젝트에도 독립적으로 붙여 사용할 수 있도록 설계되었습니다.

프로젝트 소개

이 프로젝트는 단순한 예약 인터페이스가 아니라, 그누보드7의 modules, plugins, templates 구조 위에서 동작하는 모듈형 예약 시스템입니다. 사용자 영역부터 관리자 관리까지 이어지는 전체 운영 흐름을 지원하며, 모듈 단위로 확장 가능한 CMS 구조를 검토할 수 있는 예제이자 실제 재사용 가능한 예약 모듈입니다.

핵심 기능

예약 신청, 이메일 인증, 예약 생성, 예약 조회, 예약 취소, 사용자 영역과 관리자 영역 분리, 예약 목록 조회, 예약 상태 변경, 예약 상세 확인, 운영 로그 확인 구조를 포함합니다. UI는 JSON Layout 기반으로 렌더링되고 API 기반 데이터 연동, template routing, layout resolve, action handler 기반 동작을 사용합니다.

아키텍처

Gnuboard7 module architecture를 따르며 modules, plugins, templates 확장 구조 기반으로 동작합니다. modules/_bundled 경로에 복사하여 다른 G7 프로젝트에서도 재사용할 수 있고, 코어 수정 없이 독립적으로 설치 및 활성화할 수 있습니다. 백엔드는 API 기반이며 UI는 JSON Layout Engine 기반입니다.

기술 스택

PHP 8.2 이상, Laravel 12.x, MySQL 8, Laravel Sanctum, JSON Layout Engine을 사용합니다.

배포

GitHub Release를 통해 배포 중이며 안정적인 배포가 가능한 상태입니다. Release package는 glitter-reservation-v0.2.0.zip과 glitter-reservation-v0.2.0.tar.gz입니다.

운영 노트

public 및 admin 페이지 노출은 template routes.json에서 설정해야 합니다. 초기 예약 서비스 및 스케줄 데이터는 호스트에서 구성해야 하며 notification 기능은 외부 플러그인으로 확장할 수 있습니다. 실제 실행해야 하는 마이그레이션은 database/migrations에 포함된 항목이며 database/migrations_excluded 경로는 실행 대상이 아닙니다.

대상 사용자와 개발 방향

그누보드7 기반에서 재사용 가능한 모듈 구조를 구성하고 싶은 개발자, 실제 운영 가능한 예약 흐름이 필요한 개발자 및 운영자, API 기반 백엔드와 동적 UI 렌더링 구조에 관심 있는 개발자, 모듈 단위로 확장 가능한 CMS 구조를 설계하고 싶은 사용자를 대상으로 합니다. 앞으로는 예약 UX 개선, 이메일 인증 기반 예약 흐름 안정화, 템플릿 및 렌더링 구조 정리, 세션·인증·보안 처리 강화, 모듈 확장성과 유지보수성 개선을 진행합니다.

라이선스

MIT License를 사용합니다.