그누보드7 비즈니스 템플릿 - Glitter Business

프로젝트 개요

Glitter Business는 GnuBoard7 기반으로 기관, 브랜드 소개 사이트를 빠르게 구성할 수 있도록 제작된 범용 비즈니스 템플릿입니다.

이 템플릿은 특정 업종이나 업무 기능에 종속된 제품이 아니라,
다음과 같은 정보를 명료한 구조로 전달하는 공개 웹사이트를 목표로 합니다.

• 조직 소개
• 서비스
• 프로젝트
• 소식
• 연락 안내

단순한 화면 묶음보다 다음 요소를 함께 제공하는 예제 프로젝트를 지향합니다.

• 템플릿 구조
• JSON Layout 기반 화면 설계
• 설치 및 배포 구조
• 반응형 UI
• 다국어 구조
• 실제 GnuBoard7 모듈 연동 사례
• 운영 시 고려할 fallback 구조

또한 Glitter Business는 완성된 디자인 하나를 그대로 사용하는 데 목적을 두지 않습니다.

검증된 템플릿 구조와 설치·활성화·업데이트·배포 구조를 기반으로 콘텐츠와 디자인을 교체하고 확장하여,
새로운 GnuBoard7 템플릿을 제작할 수 있는 기반 구조를 함께 제공합니다.

따라서 프로젝트별 요구사항에 따라 정보 구조, 디자인, 콘텐츠, 모듈 연동을 변경하면서도 GnuBoard7 Template lifecycle과 독립 배포 구조는 재사용할 수 있습니다.

즉, "디자인이 포함된 템플릿"을 넘어 GnuBoard7에서 범용 비즈니스 사이트를 구성하는
하나의 기준 구현 예제이자, 검증된 제품 골격을 재사용하여
새로운 G7 템플릿을 만들어 갈 수 있는 기반 템플릿을 목표로 합니다.

주요 특징

Editorial Business UI

Glitter Business는 일반적인 카드 중심 기업 홈페이지보다 정보의 위계와 읽기 흐름을 우선합니다.

• 넓은 여백
• 명확한 타이포그래피 위계
• 섹션 중심 레이아웃
• 이미지에 의존하지 않는 화면 구성
• 과도한 카드와 장식 최소화
• 콘텐츠 중심 인터페이스
• 제한된 강조색과 높은 가독성

GnuBoard7 JSON Layout 기반

• JSON 선언형 UI
• React 기반 렌더링
• partial 기반 화면 구성
• G7 Template lifecycle 사용
• 동적 데이터 바인딩
• fallback-safe rendering
• i18n 기반 다국어 대응

반응형 공개 템플릿

• 모바일 / 태블릿 / 데스크톱 대응
• 공통 Header / Footer
• 반응형 Navigation
• 모바일 Navigation horizontal scroll
• 화면 크기에 따른 컬럼 자동 전환
• 콘텐츠 폭과 읽기 길이 제어

Zero-data 중심 구조

About, Services, Projects, Contact는 별도 API나 데이터가 없어도 렌더링됩니다.

News 연동 역시 게시글이 없거나 API 응답에 문제가 발생한 경우 기본 화면을 유지합니다.

• API 데이터가 없어도 화면 유지
• Empty State 제공
• API failure fallback
• 이미지 없이도 기본 UI 성립
• 특정 DB 데이터에 대한 설치 의존 최소화

Prebuilt Asset 배포

Release 패키지에는 Production CSS / JavaScript 결과물이 포함됩니다.

일반적인 설치 과정에서는 다음 작업이 필요하지 않습니다.

• npm install
• Vite build
• Node.js 기반 Production build

따라서 설치 대상 GnuBoard7 서버에서는 Node/npm 빌드 환경 없이도 사용할 수 있습니다.

포함된 페이지

Public

• /
• /about
• /services
• /projects
• /news
• /contact

Home

메인 화면은 다음 정보 흐름으로 구성됩니다.

• Hero
• Introduction
• Services
• Selected Projects
• Latest News
• Contact CTA
• Footer

홈 화면 자체가 하나의 완성된 비즈니스 랜딩 페이지가 되도록 구성했습니다.

About

기업이나 기관의 정체성과 방향을 소개하기 위한 범용 페이지입니다.

구성:

• Intro
• Statement
• Principles
• Capabilities
• Closing

특정 기업의 실제 연혁이나 조직 정보를 가정하지 않고 교체 가능한 정보 구조를 제공합니다.

Services

서비스나 업무 영역을 설명하기 위한 페이지입니다.

구성:

• Intro
• Service Overview
• Working Approach
• Scope
• Closing

기본 예시 구조:

• Strategy
• Design
• Technology

특정 업종의 실제 서비스 상품이 아니라 사이트 구축 시 활용할 수 있는 범용 예시 구조입니다.

Projects

프로젝트와 사례를 정리하기 위한 페이지입니다.

구성:

• Intro
• Project Types
• Selected Cases
• Evaluation Criteria
• Closing

프로젝트 표현 방식은 이미지 갤러리보다 Case Study 중심의 정보 구조에 초점을 맞춥니다.

예시 유형:

• Brand Platform
• Public Information Site
• Digital Service System

실제 고객사나 실적 수치를 포함하지 않습니다.

News

News는 GnuBoard7의 sirsoft-board 모듈과 연동됩니다.

사용 게시판 slug:

news

Home:

/api/modules/sirsoft-board/boards/news/posts?per_page=5

Home에서는 최대 3개의 최신 소식을 표시합니다.

News 페이지:

/api/modules/sirsoft-board/boards/news/posts?per_page=10

특징:

• 공개 게시판 데이터 사용
• 게시글 0건 시 Empty State
• API 실패 시 fallback
• Thumbnail 의존 없음
• 날짜 + 제목 중심 Editorial List

현재 버전에는 게시글 상세 Presentation Layer가 포함되지 않습니다.

따라서 News 제목은 게시글 상세 페이지 링크로 동작하지 않습니다.

또한 news 게시판 데이터 자체는 템플릿 설치의 hard dependency가 아닙니다.

Contact

현재 Contact는 정보형 Contact 페이지입니다.

다음 기능은 포함하지 않습니다.

• 문의 Form
• Input / Textarea
• 개인정보 저장
• 개인정보 전송
• 이메일 발송
• mailto:
• tel:
• 임의 이메일 주소
• 임의 전화번호
• 임의 주소

GnuBoard7에서 공개 연락처로 정의된 범용 필드가 확인되지 않았기 때문에
관리자 이메일 등의 비공개 정보를 임의로 노출하지 않습니다.

페이지는 다음과 같은 정보 구조를 제공합니다.

• Contact Channels 안내
• General inquiries
• Project discussions
• Partnership
• Other communication
• 문의 전 준비 정보

향후 별도의 Contact Backend 또는 Form Module과 결합할 수 있습니다.

다국어

현재 지원 언어:

• 한국어 (ko)
• 영어 (en)

레이아웃의 고정 문장은 language key 기반으로 관리합니다.

lang/
├── ko.json
└── en.json

API에서 전달되는 실제 게시글 제목과 같은 동적 데이터는 번역 대상이 아닙니다.

기술 스택

• GnuBoard7
• PHP 8.2+
• Laravel 12.x
• React 19
• TypeScript
• JSON Layout
• Tailwind CSS
• Vite
• Vitest

프로젝트 성격

Glitter Business는 다음 성격을 갖습니다.

• GnuBoard7 Template Engine 기반
• User Template 확장 구조
• JSON Layout 중심 설계
• 코어 수정 없이 적용
• Zero-data rendering
• API fallback
• Prebuilt dist 포함
• 다국어 구조
• 특정 업종 비종속
• 기업·기관·브랜드·프로젝트 사이트에 재사용 가능한 범용 구조

요구사항

GnuBoard7

GnuBoard7 >= 7.0.8

PHP

PHP 8.2+

필수 확장

• 게시판 모듈 (sirsoft-board >= 1.0.5)

현재 버전에서는 sirsoft-page를 필수 dependency로 사용하지 않습니다.

전체 GnuBoard7 Host 설치

시드(seed) 템플릿 ID: glitter-business, user 템플릿, 버전 v0.1.0-beta.10 포함 코어 설치

• Core version : 7.0.8

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

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

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

/path/to/project/public

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

http://도메인/install

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

관리자에서 템플릿만 설치

• 템플릿 ID: glitter-business, user 템플릿, 버전 v0.1.0-beta.11

1. GitHub 저장소에서 설치

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

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

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

설치 완료 후 Glitter Business 템플릿을 활성화합니다.

2. ZIP 패키지 설치

GitHub Release에서 다음 패키지를 다운로드합니다.

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

다운로드한 ZIP 패키지를 다음 경로에서 설치합니다.

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

배포 ZIP은 다음과 같이 하나의 wrapper directory를 갖습니다.

glitter-business/
├── template.json
├── routes.json
├── components.json
├── layouts/
├── lang/
├── dist/
├── src/
├── README.md
├── CHANGELOG.md
└── LICENSE

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

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

Bundled Source 설치

GitHub Release에서 다음 패키지를 다운로드/압축해제합니다.

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

GnuBoard7 호스트 프로젝트의 다음 경로에 압축해제 소스 glitter-business를 배치한 후:

templates/_bundled/glitter-business

G7의 템플릿 lifecycle을 이용할 수도, 관리자 페이지를 이용할 수도 있습니다.

설치:

php artisan template:install glitter-business

활성화:

php artisan template:activate glitter-business

업데이트

Bundled Source에서 업데이트하는 경우:

php artisan template:update glitter-business \
  --force \
  --source=bundled \
  --layout-strategy=overwrite

Production Build

Release 패키지에는 이미 Production Asset이 포함되어 있으므로 일반 설치 서버에서 별도 Build는 필요하지 않습니다.

템플릿 소스를 수정하고 직접 다시 Build하려는 개발자의 경우:

npm install
npm run type-check
npm run test:run
npm run build

GnuBoard7 Template Production Build:

php artisan template:build glitter-business --production

일반 Runtime 설치 과정에서는 Node/npm을 요구하지 않습니다.

개발 구조

glitter-business/
├── template.json
├── routes.json
├── components.json
├── layouts/
│   ├── _user_base.json
│   ├── home.json
│   ├── about.json
│   ├── services.json
│   ├── projects.json
│   ├── news.json
│   ├── contact.json
│   ├── errors/
│   └── partials/
├── lang/
│   ├── ko.json
│   └── en.json
├── src/
├── dist/
├── __tests__/
├── package.json
├── package-lock.json
├── CHANGELOG.md
├── README.md
└── LICENSE

배포 구조

Release 패키지에는 다음 항목이 포함됩니다.

• Template manifest
• Routes
• JSON Layout
• Partials
• Translation
• Prebuilt CSS
• Prebuilt JavaScript
• Frontend source
• Tests
• Build configuration
• README
• CHANGELOG
• LICENSE

다음 항목은 포함하지 않습니다.

• node_modules
• .env
• DB 파일
• Cache
• Session
• Storage runtime data
• Source map
• 설치된 templates/glitter-business 복사본
• Host 전용 절대 경로
• Credential

테스트 및 검증

현재 Beta 패키지는 빌드·패키징·Template lifecycle 및 개발 환경 기준으로 다음 검증을 통과했습니다.

• TypeScript type-check
• Vitest 25/25
• Production Template Build
• Template install/update lifecycle
• Bundled / Installed Asset 동기화
• G7 ZIP Parser
• Release Archive 무결성
• Secret / Host Path 검사
• 한국어 / 영어 translation parity
• News API fallback
• 공개 Route 확인

현재 공개 경로:

/          200
/about     200
/services  200
/projects  200
/news      200
/contact   200

미등록 경로는 404를 반환하도록 확인했습니다.

현재 상태

Beta

현재 버전:

v0.1.0-beta.12

현재 기준:

• 핵심 공개 IA 구성 완료
• 반응형 UI 기반 구성 완료
• G7 Template lifecycle 검증
• News 실제 모듈 연동
• Zero-data fallback 적용
• 한국어/영어 지원
• Standalone Template Repository 구성
• ZIP / TAR.GZ 배포 패키지 구성
• Beta Package 배포 가능 상태

현재 단계는 Beta Package Ready로 판단합니다.

현재 알려진 제한사항

다음 항목은 독립된 실제 설치 환경에서 수행하는 최종 E2E 검증 범위로 남아 있습니다.

• 독립된 Clean GnuBoard7 Host에서의 최초 ZIP 설치 E2E
• 관리자 브라우저를 통한 ZIP Upload 전체 E2E
• 실제 브라우저 기반 Accessibility 최종 검증
• Lighthouse 최종 측정
• News 게시글 상세 Presentation Layer

따라서 현재 버전은 Stable이 아닌 Beta Release입니다.

보안 및 개인정보

현재 Glitter Business 자체에서는 다음 데이터를 수집하거나 저장하지 않습니다.

• Contact 개인정보
• 이메일 주소
• 전화번호
• 주소
• 문의 내용
• 인증 Credential

Release 패키지에도 다음과 같은 환경 종속 파일을 포함하지 않습니다.

• .env
• Credential
• DB dump
• Private key
• Runtime cache/session
• Host-specific configuration

Contact는 현재 정보 안내 역할만 수행합니다.

알려진 GnuBoard7 관련 이슈

Glitter Business의 template:update 및 배포 lifecycle을 검증하는 과정에서,
업데이트된 template.json과 달리 공개 Template Config가
이전 Manifest를 반환할 수 있는 GnuBoard7 Core의 cache invalidation 문제를 확인했습니다.
해당 문제는 G7 ISSUE #119「template:update 후 public template config 캐시가 무효화되지 않아 이전 manifest가 반환된다」 로 제보됐습니다.

이 문제는 Glitter Business 자체의 데이터 손실이나 보안 문제로 확인된 것은 아니며,
GnuBoard7 Template lifecycle의 cache invalidation 범위와 관련된 문제입니다.

추천 대상

• 기업 홈페이지
• 기관 홈페이지
• 브랜드 사이트
• 프로젝트 소개 사이트
• 스타트업 소개 사이트
• 조직 소개 사이트
• 서비스 소개 사이트
• 공공·비영리 정보 사이트
• GnuBoard7 기반 MVP
• GnuBoard7 Template 구조를 참고하려는 개발자

향후 계획

• 실제 Browser 기반 Responsive 검수
• Accessibility 개선
• Lighthouse / SEO 검증
• Clean Host 최초 설치 검증
• 관리자 ZIP Upload E2E
• News 상세 Presentation Layer
• 설치 및 운영 문서 고도화
• Release 안정화

저장소

Template

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

전체 GnuBoard7 Host 예제

https://github.com/glitter-node/glitter-business-BETA_10

Demo

https://glitter-business.glitter.kr

Release

https://github.com/glitter-node/glitter-business/releases/tag/v0.1.0-beta.12

배포 파일:

glitter-business-v0.1.0-beta.12.zip
glitter-business-v0.1.0-beta.12.tar.gz

라이선스

MIT License

Copyright (c) 2026 Glitter.kr

Vendor: Glitter.kr
Author: Glitter.kr

정리

Glitter Business는 기업·기관·브랜드·프로젝트의 정보를 명료하게 전달하기 위한 GnuBoard7 범용 비즈니스 템플릿입니다.

특정 업종의 기능을 완성품 형태로 제공하기보다는 다음을 하나의 예제 구조로 보여주는 데 목적이 있습니다.

• 조직을 어떻게 소개할 것인가
• 서비스를 어떻게 구조화할 것인가
• 프로젝트와 사례를 어떻게 표현할 것인가
• 실제 GnuBoard7 데이터를 어떻게 연결할 것인가
• 데이터가 없을 때도 어떻게 안전하게 화면을 유지할 것인가
• Template을 어떻게 독립적으로 설치하고 배포할 것인가

즉, 실제 사이트 구축에 활용할 수 있으면서 동시에 G7 Template 확장 구조를 참고할 수 있는 패키지형 비즈니스 템플릿입니다.