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

Gnuboard7 Template Engine 기반 상담예약 플랫폼 템플릿

Glitter Academy Core (glitter-academy_core) v1.0.0-beta.7

Glitter Academy Core는 Gnuboard7을 기반으로 상담 신청 및 예약 서비스형 사이트를 빠르게 구축할 수 있도록 설계된 사용자 템플릿입니다.

단순한 화면 디자인이나 스킨이 아니라 코드, 설치 절차, 레이아웃 구조, 모듈 연동 및 운영 기준을 함께 제공하는 확장형 템플릿 예제 프로젝트입니다.

• GitHub 저장소
• v1.0.0-beta.7 릴리스
• ZIP 다운로드
• tar.gz 다운로드

프로젝트 개요

Glitter Academy Core는 Gnuboard7의 Template Engine과 확장 모듈 구조를 활용하여 상담예약 사이트를 구성하기 위한 초기 설계 템플릿입니다.

이 프로젝트는 다음 네 가지 요소를 함께 제공합니다.

1. 코드 — 사용자 페이지, 인증 화면, UI 컴포넌트 및 JSON Layout
2. 설치 문서 — 템플릿 설치와 필수 모듈 구성 절차
3. 구조 설명 — Module / Plugin / Template 확장 구조 및 연동 방식
4. 운영 기준 — 설치 후 검증, 설정 및 장애 대응 범위

즉, 단순히 디자인이 포함된 템플릿이 아니라 상담예약 플랫폼 구축 시 참고할 수 있는 구조와 구현 절차를 제공하는 프로젝트입니다.

기존의 호스트 프로젝트 통합 예제와 달리, 현재 glitter-academy_core는 Gnuboard7 호스트 프로젝트에 별도로 설치할 수 있는 사용자 템플릿으로 배포됩니다.

릴리스 정보

구체적인 버전별 변경 내역은 CHANGELOG.md를 참고해 주세요.

무엇을 제공하는가

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

• 상담예약 사이트의 기본 페이지 및 UI 구조 제공
• 로그인, 회원가입, 비밀번호 재설정을 포함한 인증 흐름
• 프로그램, 강사, 시간표 및 안내 페이지 구성
• 상담 신청과 예약 모듈의 연동 구조
• Gnuboard7 인증 API 및 CMS 기능 활용
• JSON Layout 기반 선언형 화면 구성
• 재사용 가능한 컴포넌트와 partial 구조
• 커스터마이징 및 확장을 고려한 템플릿 설계
• 운영 전 검증에 활용할 수 있는 예제 구조

주요 특징

1. 상담예약 중심 구조

상담 신청을 포함하는 서비스형 사이트를 위한 기본 UI와 페이지 흐름을 제공합니다.

2. 인증 흐름

로그인, 회원가입, 비밀번호 재설정 및 마이페이지 구성을 포함합니다.

3. JSON Layout 기반 UI

레이아웃과 partial을 분리하고, 선언형 데이터 소스와 상태 바인딩을 활용합니다.

4. 확장 모듈 연동

게시판, 페이지 및 예약 기능을 별도 모듈과 연계하여 구성합니다.

5. 코어 수정 최소화

Gnuboard7의 Module / Plugin / Template 확장 구조를 활용합니다.

6. 사전 빌드된 정적 자산

배포용 CSS 및 JavaScript를 dist/에 포함하여 운영 환경에서 별도 프런트엔드 빌드 없이 사용할 수 있도록 구성합니다.

기술 스택

• PHP 8.2+
• Laravel 12.x
• MariaDB / MySQL
• React 19
• TypeScript
• JSON Layout
• Tailwind CSS
• Vite
• Gnuboard7 Template Engine
• Module / Plugin / Template 확장 구조

템플릿 구조

주요 디렉터리와 파일은 다음과 같습니다.

glitter-academy_core/
├── assets/
├── components.json
├── dist/
├── extensions/
├── lang/
├── layouts/
├── setup/
├── src/
├── CHANGELOG.md
├── LICENSE
├── README.md
├── routes.json
├── seo-config.json
└── template.json

포함된 페이지

Public

Auth

Mypage

실제 페이지 접근 및 기능 동작 여부는 호스트 프로젝트의 라우트 설정, 사용자 권한, API 및 필수 모듈 설치 상태에 따라 달라질 수 있습니다.

필수 의존성

Glitter Academy Core는 Gnuboard7 호스트 프로젝트와 Template Engine을 전제로 합니다.

v1.0.0-beta.7의 template.json에 선언된 최소 요구 버전은 다음과 같습니다.

필수 확장 모듈과 플러그인을 먼저 설치한 후 템플릿을 설치하고 활성화하는 것을 권장합니다.

반짝이 예약 모듈 — Glitter Reservation

상담 신청과 예약 기능은 별도로 제공되는 glitter-reservation 모듈과 연동됩니다.

• GitHub 저장소
• Release v0.2.4
• ZIP 다운로드 — glitter-reservation-v0.2.4.zip
• tar.gz 다운로드 — glitter-reservation-v0.2.4.tar.gz

특히 /consultation 등 상담 신청 관련 기능은 예약 모듈의 설치 및 설정이 완료되어야 정상적으로 동작합니다.

설치

1. 관리자 페이지에서 설치 (권장)

이미 Gnuboard7 호스트 프로젝트가 설치되어 있는 환경을 기준으로 합니다.

1-1. 필수 모듈 설치

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

반짝이 예약 모듈 저장소:

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

설치 완료 후 반짝이 예약 모듈을 활성화합니다.

게시판 모듈(sirsoft-board)과 페이지 모듈(sirsoft-page)도 필요한 버전으로 설치되어 있어야 합니다.

Daum 우편번호 플러그인(sirsoft-daum_postcode)의 설치 상태도 확인합니다.

1-2. 템플릿 설치

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

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

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

설치 완료 후 Glitter Academy Core (glitter-academy_core) 템플릿을 활성화합니다.

특정 버전을 설치하려는 경우 관리자 설치 기능에서 태그 지정이 지원되는지 확인하거나 아래 ZIP 패키지 설치 방법을 사용합니다.

2. ZIP 패키지 설치

GitHub Release에서 배포 패키지를 다운로드하여 설치할 수 있습니다.

2-1. 반짝이 예약 모듈 설치

glitter-reservation-v0.2.4.zip 다운로드

관리자 → 모듈 관리 → 수동 설치 → 파일 업로드

다운로드한 ZIP 패키지를 업로드하여 설치합니다.

2-2. Glitter Academy Core 템플릿 설치

glitter-academy_core-1.0.0-beta.7.zip 다운로드

관리자 → 템플릿 관리 → 수동 설치 → 파일 업로드

다운로드한 ZIP 패키지를 업로드하여 설치합니다.

설치 후 템플릿을 활성화하고 페이지 및 정적 자산 로딩 상태를 확인합니다.

3. SSH를 이용한 템플릿 번들 설치

Gnuboard7 호스트 프로젝트가 이미 설치된 환경에서 템플릿만 추가하는 방법입니다.

프로젝트 루트:

/path/to/project

템플릿 번들 디렉터리로 이동합니다.

cd /path/to/project/templates/_bundled

GitHub 저장소에서 템플릿을 복제합니다.

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

v1.0.0-beta.7 태그로 전환합니다.

cd glitter-academy_core

git checkout v1.0.0-beta.7

템플릿 디렉터리 이름은 반드시 다음과 같이 유지합니다.

glitter-academy_core

배포 패키지에 정상적인 dist/ 자산이 포함되어 있다면 운영 환경에서 별도 빌드가 필요하지 않습니다.

이후 관리자 페이지에서 템플릿 설치 및 활성화를 진행합니다.

4. 소스 수정 후 프런트엔드 빌드

템플릿의 React, TypeScript 또는 CSS 소스를 직접 수정하는 경우에만 빌드를 수행합니다.

cd /path/to/project/templates/_bundled/glitter-academy_core

npm install
npm run build

빌드 결과를 확인합니다.

test -f dist/js/components.iife.js
test -f dist/css/components.css

운영 환경에서는 사전 빌드된 배포 패키지 사용을 권장합니다.

5. 기존 설치 환경에서 업데이트

기존 설치 환경에서 업데이트할 경우 다음 순서로 진행합니다.

1. 현재 템플릿과 모듈 버전 확인
2. 데이터베이스 및 사용자 설정 백업
3. 필수 확장 모듈 호환성 확인
4. 업데이트 대상 템플릿 번들 준비
5. 템플릿 업데이트
6. 레이아웃 및 정적 자산 검증
7. 활성화 상태 확인
8. 브라우저에서 주요 기능 테스트

Gnuboard7에서 제공하는 Artisan 명령을 사용할 수도 있습니다.

예시:

php artisan template:update glitter-academy_core --source=bundled

위 명령은 실제 설치된 Gnuboard7 버전에서 지원하는 옵션을 확인한 후 실행해야 합니다.

주의: 모듈 업데이트, seed, 강제 업데이트 및 템플릿 활성화는 기존 데이터와 설정에 영향을 줄 수 있습니다. 운영 환경에서는 백업과 사전 검증 없이 일괄 실행하지 않는 것을 권장합니다.

설치 후 확인 사항

설치 및 활성화 후 다음 사항을 점검합니다.

• 필수 모듈 및 플러그인 설치
• Glitter Academy Core 템플릿 활성화
• CSS 및 JavaScript 정상 로딩
• 메인 페이지 정상 표시
• 프로그램 및 강사 소개 페이지
• 시간표 및 공지사항
• 로그인 및 회원가입
• 비밀번호 재설정
• 프로필 및 마이페이지
• 상담 신청 페이지
• 예약 모듈 API 연결
• 게시판 글쓰기 및 수정
• 첨부파일 업로드
• 모바일 화면
• 브라우저 콘솔 및 서버 로그
• 캐시 상태

페이지 로딩 오류 발생 시

우선 다음 항목을 확인합니다.

1. 템플릿 설치 및 활성화 여부
2. 필수 확장 모듈 설치 여부
3. JSON Layout 검증 오류
4. dist/ 정적 자산 존재 여부
5. API 응답 및 접근 권한
6. 캐시 상태

필요한 경우 다음 관리자 기능을 사용합니다.

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

캐시 삭제 전에 운영 중인 사이트에 미치는 영향을 확인해 주세요.

프로젝트 성격

Glitter Academy Core는 다음 특성을 갖습니다.

• Gnuboard7 Template Engine 기반
• Module / Plugin / Template 확장 구조
• JSON Layout 기반 UI
• 인증 흐름 포함
• 상담예약 모듈 연동
• 커스터마이징 가능한 구성
• 사전 빌드된 배포 자산
• 코어 수정 없는 확장 방식 지향
• 운영 전 추가 설정과 검증 필요

이 프로젝트는 템플릿만 설치하면 모든 기능이 자동으로 완성되는 독립형 서비스가 아닙니다.

Gnuboard7 호스트 프로젝트와 관련 모듈을 조합하여 구성하는 확장형 템플릿입니다.

운영 기준

운영 대상

• 상담 신청이 포함된 서비스형 사이트
• 교육 및 아카데미 플랫폼
• 프로그램 안내 및 예약 사이트
• 인증 기반 MVP
• 베타 서비스
• 내부 상담 및 예약 시스템

운영 전 확인 항목

• Gnuboard7 코어 및 확장 모듈 호환성
• 인증 API 연동 상태
• 메일 발송 환경
• 예약 모듈 설정
• 사용자 권한 및 접근 제어
• 템플릿 정적 자산 반영
• 페이지 및 레이아웃 렌더링
• 상담 신청 및 예약 처리
• 로그 및 캐시 상태

장애 대응 범위

템플릿에서 제공하는 영역

• UI 레이아웃 및 컴포넌트
• 인증 관련 화면과 경로
• 페이지 렌더링 구조
• API 연동을 위한 UI 구성
• 상담예약 페이지 및 사용자 동선
• JSON Layout 및 다국어 리소스

별도로 구성해야 하는 영역

• 메일 서버 및 발송 환경
• 데이터베이스 운영
• 서버 및 네트워크 인프라
• 배포 자동화
• 백업 및 복구
• 예약 모듈 내부 기능
• 사용자 데이터 관리
• 운영 환경의 종합적인 E2E 검증

즉, 이 프로젝트는 모든 운영 기능을 대신하는 완제품이 아니라 구축 범위와 확장 구조를 명확히 구분하여 제공하는 템플릿 예제입니다.

현재 상태

Beta — v1.0.0-beta.7

Glitter Academy Core는 베타 버전으로 배포되고 있습니다.

현재 제공하는 주요 구성은 다음과 같습니다.

• 상담예약 사이트 기본 구조
• 주요 사용자 페이지
• 로그인 및 인증 화면
• JSON Layout 기반 UI
• 게시판 및 페이지 모듈 연동
• 반짝이 예약 모듈 연동 구조
• 템플릿 설치 및 배포 패키지

GitHub Release를 통해 설치 가능한 패키지를 제공하고 있습니다.

다만 베타 배포가 실제 운영 환경의 모든 구성에서 안정성을 보증한다는 의미는 아닙니다.

사용 중인 Gnuboard7 버전, 모듈 구성, 인증 및 예약 API 환경에 따라 추가 설정과 검증이 필요합니다.

추천 대상

• Gnuboard7 기반 서비스 개발자
• 상담예약 사이트를 빠르게 구축하려는 사용자
• 교육 및 아카데미 플랫폼 구축자
• 인증 흐름을 포함한 템플릿이 필요한 개발자
• MVP 또는 베타 서비스 준비 단계
• JSON Layout 기반 UI 구조를 연구하려는 개발자
• 확장형 웹 서비스 설계를 참고하려는 사용자

향후 계획

• 상담예약 UX 개선
• 디자인 시스템 정리
• UI 컴포넌트 구조 개선
• JSON Layout 재사용성 향상
• 다국어 및 접근성 개선
• 설치 및 업데이트 문서 보완
• 운영 체크리스트 개선
• 장애 대응 가이드 보강

향후 계획은 개발 상황에 따라 변경될 수 있습니다.

정리

Glitter Academy Core는 Gnuboard7 기반 상담예약 사이트 구축을 위한 템플릿 예제 프로젝트입니다.

다음 항목을 검토할 수 있도록 설계되었습니다.

• 상담예약 사이트를 어떤 구조로 구성할 것인가?
• 인증 및 사용자 페이지를 어떻게 연동할 것인가?
• JSON Layout 기반 UI를 어떻게 설계할 것인가?
• 예약 모듈과 사용자 템플릿을 어떻게 연결할 것인가?
• 코어 수정 없이 확장 가능한 구조를 어떻게 만들 것인가?
• 템플릿 설치와 업데이트를 어떻게 관리할 것인가?
• 실제 운영을 위해 어떤 기능과 인프라를 별도로 준비해야 하는가?

즉, 단순한 디자인 템플릿을 넘어 상담예약 플랫폼 구축의 초기 설계와 구현 방향을 제시하는 확장형 템플릿 프로젝트입니다.

저장소 및 다운로드

Glitter Academy Core v1.0.0-beta.7

• GitHub: https://github.com/glitter-node/glitter-academy_core
• Release: https://github.com/glitter-node/glitter-academy_core/releases/tag/v1.0.0-beta.7
• ZIP: https://github.com/glitter-node/glitter-academy_core/releases/download/v1.0.0-beta.7/glitter-academy_core-1.0.0-beta.7.zip
• tar.gz: https://github.com/glitter-node/glitter-academy_core/releases/download/v1.0.0-beta.7/glitter-academy_core-1.0.0-beta.7.tar.gz

Glitter Reservation v0.2.4

• GitHub: https://github.com/glitter-node/glitter-reservation
• Release: https://github.com/glitter-node/glitter-reservation/releases/tag/v0.2.4
• ZIP: https://github.com/glitter-node/glitter-reservation/releases/download/v0.2.4/glitter-reservation-v0.2.4.zip
• tar.gz: https://github.com/glitter-node/glitter-reservation/releases/download/v0.2.4/glitter-reservation-v0.2.4.tar.gz

라이선스

MIT License

본 템플릿은 MIT License로 제공됩니다.

개인 및 상업적 이용, 수정 및 재배포가 가능합니다.

재배포 시 기존 저작권 및 라이선스 고지를 유지해야 합니다.

자세한 내용은 저장소의 LICENSE 파일을 참고해 주세요.

Glitter Academy Core — Gnuboard7 Consultation & Reservation Template

Version: v1.0.0-beta.7