그누보드7 예약 시스템 모듈 - Glitter Reservation

개요

glitter-reservation은 그누보드7에서 동작하는 번들형 예약 모듈입니다.

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

프로젝트 소개

이 프로젝트는 단순한 예약 인터페이스가 아닙니다.

그누보드7의 modules / plugins / templates 구조 위에서 동작하는 모듈형 예약 시스템으로,
사용자 영역부터 관리자 관리까지 이어지는 전체 운영 흐름을 지원합니다.

또한 API 기반 백엔드 구조와 JSON Layout 기반 UI 렌더링을 통해
화면 구조와 동작을 유연하게 제어할 수 있습니다.

주요 기능

Modular Architecture

예약 기능은 코어와 분리된 모듈로 구성되어 있습니다

modules/_bundled 경로에 복사하는 방식으로 G7 다른 프로젝트에서도 재사용할 수 있으며,
커스터마이징과 배포 경계를 명확하게 유지할 수 있습니다.

JSON Layout-Based UI

UI는 JSON 레이아웃 정의를 기반으로 렌더링됩니다

template routing, layout resolve, API 기반 데이터 연동, action handler를 통해
뷰 템플릿에 강하게 의존하지 않고 유연한 페이지 구성이 가능합니다.

Reservation Flow

• 예약 신청
• 이메일 인증
• 예약 생성
• 예약 조회
• 예약 취소

전체 예약 흐름은 하나의 상태 기반 프로세스로 구성되어 있습니다.

Email Verification System

토큰 기반 이메일 인증과 세션 기반 상태 관리를 포함합니다.

인증된 사용자만 예약을 생성할 수 있도록 설계되어 있습니다.

Admin System

사용자 영역과 관리자 영역이 분리되어 있습니다.

관리자에서는 예약 목록 조회, 상태 변경, 상세 확인 등 운영에 필요한 기능을 제공합니다..

기술 스택

PHP 8.2+, Laravel 12.x, MySQL 8, Laravel Sanctum, JSON Layout Engine

참고 사항

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

대상 사용자

다음과 같은 사용자에게 적합합니다:

• 그누보드7 기반에서 재사용 가능한 모듈 구조를 구성하고 싶은 개발자
• 실제 운영 가능한 예약 흐름이 필요한 개발자 및 운영자.
• API 기반 백엔드와 동적 UI 렌더링 구조에 관심 있는 개발자.
• 모듈 단위로 확장 가능한 CMS 구조를 설계하고 싶은 사용자.

개발 방향

• 예약 UX 개선
• 이메일 인증 기반 예약 흐름 안정화.
• 템플릿 및 렌더링 구조 정리.
• 세션, 인증, 보안 처리 강화.
• 모듈 확장성과 유지보수성 개선.

설계 철학

이 프로젝트는 단순한 예약 페이지가 아니라

CMS 구조 안에서 독립적으로 동작하는 예약 시스템 모듈을 만드는 것을 목표로 합니다.

상태

안정적인 배포가 가능한 상태입니다..

현재 모듈은 설치 및 재사용이 가능하며, GitHub Release를 통해 배포되고 있습니다.

설치 방법

1. GitHub 저장소에서 설치 (권장)

관리자 → 모듈 관리 → 수동 설치 → GitHub

아래의 저장소 URL을 입력합니다.

https://github.com/glitter-node/glitter-reservation

설치 완료 후 생성된 반짝이 예약 모듈을 활성화하면
좌측 사이드바에 반짝이 예약 관리 메뉴가 생성됩니다.

2. ZIP 파일로 설치

• ZIP 패키지 파일 다운로드 클릭

위의 모듈 ZIP 파일을 다운로드한 후,
관리자 → 모듈 관리 → 수동 설치 → 파일 업로드를 통해 설치할 수도 있습니다.

다만 GitHub 저장소를 통한 설치 및 업데이트를 권장합니다.

3. 설치 후 생성된 페이지의 로드 에러 발생 시

관리자 → 환경설정 → 고급 → 캐시 모두 삭제

라이선스

MIT License