그누보드7 상담예약 템플릿 - Glitter Academy Core

프로젝트 개요

이 Template은 GnuBoard7 기반으로 상담예약 사이트를 빠르게 구축할 수 있도록 한 초기 설계 템플릿 예제입니다.

이 프로젝트는 단순한 화면 묶음이 아니라, 아래 4가지를 함께 제공하는 샘플 프로젝트를 목표로 합니다.

• 코드
• 설치 문서
• 구조 설명
• 운영 전략.

즉, "디자인이 포함된 템플릿"이 아니라, 구축 시 참고할 수 있는 예시 구조와 절차를 함께 담은 프로젝트입니다.

설치

웹 루트 디렉토리(/path/to/project)로 이동합니다.
git clone 명령어 끝의 .은 필수입니다.

# cd /path/to/project
git clone https://github.com/glitter-node/academy-core-BETA_2.git .
cp .env.example .env
composer install

• .env 파일 권한과 DB 정보를 운영 환경에 맞게 설정합니다.
• (초기 설치시, php 풀 워커의 .env 파일 쓰기 권한 필수)
• 웹 서버 DocumentRoot는 반드시 다음 경로로 지정합니다.

/path/to/project/public

• 브라우저에서 설치 마법사에 접근합니다.

http://도메인/install

• 설치 마법사에서 DB 정보와 관리자 정보를 입력하고 설치를 완료합니다.

설치 완료후, 관리자앱 셋업 흐름 :

이 템플릿 완성은 설치만으로 되지 않습니다.

예제와 같은 커뮤니티 초안을 구성하려면 아래 항목이 함께 셋업되어야 합니다.

• 1. sirsoft-board 업데이트
• 2. sirsoft-board seed
• 3. sirsoft-page 업데이트
• 4. sirsoft-page seed
• 5. sirsoft-comm template:update
• 6. sirsoft-comm 활성화

# cd /path/to/project
php artisan module:update sirsoft-board --force && \
php artisan module:seed sirsoft-board --force && \
php artisan module:update sirsoft-page --force && \
php artisan module:seed sirsoft-page --force && \
php artisan module:update glitter-reservation --force && \
php artisan module:seed glitter-reservation --force && \
php artisan template:update glitter-academy_core --force && \
php artisan template:activate glitter-academy_core

무엇을 제공하는가

이 렘를릿은 다음 목적에 맞춰 설계되었습니다.

• 상담예약 사이트의 기본 초안 구조 제공
• 로그인, 회원가입, 비밀번호 재설정까지 포함한 인증 흐름 제공
• GnuBoard7 기반 CMS 및 인증 API 구조에 맞춰 연동할 수 있는 템플릿 구조 제공
• 사전 검토와 커스터마이징에 활용할 수 있는 샘플 프로젝트 제공

기술 스택

• PHP 8.2+
• Laravel 12.x
• MySQL 8
• React 19
• TypeScript
• JSON Layout
• Tailwind CSS

프로젝트 성격

이 템플릿은 다음 성격을 갖습니다.

• GnuBoard7 템플릿 엔진 기반
• Module / Plugin / Template 확장 구조
• 인증 흐름 포함
• 운영 전 추가 점검과 설정을 전제로 구성
• 코어 수정이 아닌 확장 가능한 방식 중심 설계

포함된 페이지

Public

• /
• /about
• /programs
• /instructors
• /timetable
• /notices
• /faq
• /contact
• /consultation

Auth

• /login
• /register
• /forgot-password
• /reset-password

Mypage

• /mypage/profile
• /mypage/change-password

운영 기준

이 템플릿 소개와 함께 운영 전 확인이 필요한 항목입니다..

운영 대상

• 상담 신청이 포함된 서비스형 사이트
• 인증 기반 MVP 및 베타 서비스

운영 전 확인 항목

• 인증 API 연동 상태
• 메일 발송 환경 구성 여부
• 모듈 설치 상태
• 빌드 결과물 반영 상태
• 페이지 렌더링 이상 여부
• 상담/예약 관련 연결 동선 점검

장애 대응 관점에서의 범위

이 템플릿은 다음 범위를 포함합니다.

포함:

• 템플릿 구조
• 인증 관련 화면 및 경로
• 페이지 렌더링 구조
• API 연동 전제 구조

포함되지 않음:

• 메일 서버 구성
• 인프라 운영 자동화
• 별도 운영 환경 구성 및 배포 검증

즉, 이 프로젝트는 모든 것을 대신하는 제품이 아니라, 구축 범위를 구분해 참고할 수 있도록 정리한 샘플 프로젝트입니다.

현재 상태

Beta

현재 기준 :

• 핵심 구조와 주요 흐름 포함
• 커스터마이징 및 연동 검토 가능
• 초기 공개용 템플릿 예제 단계
• 브라우저 기반 E2E 검증이나 배포 완료 상태를 의미하지는 않습니다.

추가 안내 : 이 저장소는 이 템플릿만이 아니라 GnuBoard7 호스트 프로젝트를 함께 포함합니다. 또한 메일 발송, 템플릿 활성화, 관련 모듈 설치, API 연결 상태에 따라 일부 기능의 실제 동작 여부가 달라질 수 있습니다. consultation 흐름은 관련 커스텀 모듈이 설치되어 있어야 정상 동작합니다.

추천 대상

• GnuBoard7 기반 서비스 개발자
• 상담예약 사이트을 빠르게 구축하려는 경우
• 인증 흐름까지 포함된 템플릿이 필요한 경우
• MVP 또는 베타 서비스 준비 단계

향후 계획

• UX 개선
• 디자인 시스템 정리
• 컴포넌트 구조 개선
• 설치 문서 고도화
• 운영 체크리스트 정리
• 장애 대응 가이드 보강

정리

이 Template은 상담예약 사이트를 위한 GnuBoard7 템플릿 예제이면서, 동시에 다음을 검토하기 위한 샘플 프로젝트입니다.

• 어떤 구조로 빌드하고 반영할 수 있는가
• 어떤 인증 및 페이지 흐름을 포함하는가
• 어떤 방식으로 확장을 고려하고 있는가
• 어떤 범위까지 포함하고 무엇은 별도 준비가 필요한가

즉, 실운용 제품 자체라기보다 구축 방안을 제시하는 패키지형 템플릿 예제입니다...

상태

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

관련 플랫폼은 설치 및 사용이 가능하며, 아래의 GitHub Release를 통해 배포되고 있습니다.

• https://github.com/glitter-node/glitter-reservation/releases/tag/v0.2.4

• https://github.com/glitter-node/glitter-academy_core/releases/tag/v1.0.0-beta.6

의존성 필수 확장

이 템플릿은 다음 모듈 및 연동 조건을 전제로 합니다.

• 게시판 모듈 (sirsoft-board)
• 페이지 모듈 (sirsoft-page)
• 반짝이 예약 모듈 (glitter-reservation)
  • GitHub 저장소: ../glitter-node/glitter-reservation
  • glitter-reservation-v0.2.4.zip
  • glitter-reservation-v0.2.4.tar.gz
• Daum 우편번호 플러그인 (sirsoft-daum_postcode)

일부 동선, 특히 consultation 흐름은 관련 반짝이 예약 모듈이 설치되어 있어야 정상 동작합니다.

관리자 페이지에서 설치

필수: 상기의 의존성 필수 확장이 먼저 설치되어야 합니다.

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

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

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

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

설치 완료 후 반짝이 갤러리 모듈을 활성화하면 됩니다.

관리자 → 템플릿 관리 → 수동 설치 → GitHub

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

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

설치 완료 후 반짝이 갤러리 비즈 템플릿을 활성화하면 됩니다.

2. ZIP 패키지 설치

• ZIP 모듈 패키지를 다운로드 틀릭

위의 반짝이 예약 ZIP 패키지를 다운로드한 후 관리자 → 모듈 관리 → 수동 설치 → 파일 업로드를 통해 설치할 수도 있습니다.

• ZIP 템플릿 패키지를 다운로드 틀릭

위의 아카데미 코어 템플릿 ZIP 패키지를 다운로드한 후 관리자 → 템플릿 관리 → 수동 설치 → 파일 업로드를 통해 설치할 수도 있습니다.

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

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

저장소

GitHub

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

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

Release

https://github.com/glitter-node/glitter-reservation/releases/tag/v0.2.4

https://github.com/glitter-node/glitter-academy_core/releases/tag/v1.0.0-beta.6

라이선스

MIT License