G7 기본 커뮤니티 템플릿 - SIRsoft Basic Community

프로젝트 개요

sirsoft-basic_comm Template는 GnuBoard7 기반으로 커뮤니티 중심 사이트를 빠르게 구축할 수 있도록 설계된 템플릿 예제입니다

설치

템플릿 번들만 추가 설치

BASH 쉘 셋업

• 운영 호스트(/path/to/project)의 번들_폴더(templates/_bundled)에 clone 한 후 설치
• clone 설치 시 폴더 이름은 sirsoft-basic_comm으로 유지해 주세요

# cd /path/to/project

cd templates/_bundled

git clone https://github.com/glitter-node/sirsoft-basic_comm.git sirsoft-basic_comm
rm -rf sirsoft-basic_comm/.git

# 이하는 웹의 '관리자'에서 설치/활성화 기능으로 대체 가능

cd sirsoft-basic_comm

npm install
npm run build

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

# cd /path/to/project

php artisan template:build sirsoft-basic_comm
php artisan template:install sirsoft-basic_comm
php artisan template:activate sirsoft-basic_comm

mkdir -p templates/sirsoft-basic_comm/dist
cp -a templates/_bundled/sirsoft-basic_comm/dist/. templates/sirsoft-basic_comm/dist/

php artisan template:cache-clear
php artisan optimize:clear

템플릿 번들 다운로드

• ZIP 다운로드: sirsoft-basic_comm-v1.0.2.zip
• tar.gz 다운로드: sirsoft-basic_comm-v1.0.2.tar.gz

압축을 풀어서 생성된 폴더(sirsoft-basic_comm)를 운영 호스트의 번들_폴더(templates/_bundled)에 . . .

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

• 코드
• 설치 구조
• 레이아웃 설계
• 운영 기준

즉, "커뮤니티 스킨"이 아니라, 구축 시 참고할 수 있는 구조와 방식 자체를 제공하는 프로젝트입니다.

무엇을 제공하는가

sirsoft-basic_comm은 다음 목적에 맞춰 설계되었습니다.

• 게시판 중심 커뮤니티 구조
• JSON Layout 기반 UI 구성 방식
• 데이터 의존 최소화 구조
• GnuBoard7 템플릿 엔진과 연동되는 UI 레이어
• 이커머스 의존 제거된 커뮤니티 전용 템플릿

기술 스택

• PHP 8.2+
• Laravel 12.x
• MariaDB / MySQL
• TypeScript
• JSON Layout
• Vite Build (prebuilt dist 포함)
• Custom CSS (no inline style)

프로젝트 성격

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

• GnuBoard7 템플릿 엔진 기반
• Template 단위 확장 구조
• JSON 기반 UI 정의
• 이커머스 의존 제거
• 빌드 완료된 dist 포함 (운영 환경 빌드 불필요)
• 코어 수정 없이 적용 가능

핵심 가치

1. 커뮤니티 전용 구조

이 템플릿은 쇼핑몰 기능을 제거하고 커뮤니티 기능에 집중합니다.

• cart / shop / checkout 제거
• orders / wishlist / addresses 제거
• 사용자 흐름 단순화

즉,

• 게시판 중심 구조
• 불필요한 상태 제거
• 유지보수 단순화

2. 재현성

보장:

• 동일한 결과 재현
• 환경 의존성 최소화
• 운영 환경 빌드 불필요

3. JSON Layout 기반 UI

모든 페이지는 JSON으로 정의됩니다.

구조:

• layouts/*.json
• partials 분리
• data source 선언형 구성

효과:

• UI 변경 시 코드 수정 최소화
• 구조 중심 설계
• 템플릿 레벨 제어

4. 데이터 의존 최소화

커뮤니티 UI는 데이터 없이도 동작하도록 설계되었습니다.

적용:

• fallback 구조
• 안전 바인딩

즉,

• API 실패 시에도 UI 유지
• 초기 상태에서도 깨지지 않음

5. UI 일관성

전체 UI는 다음 기준으로 설계되었습니다.

• low contrast UI
• border 기반 인터랙션
• 과도한 강조 제거

즉,

• 정보 중심 UI
• 정적 콘텐츠에 적합한 구조
• 피로도 낮은 인터페이스

포함된 페이지

Public

• /
• /boards
• /search

User

• /mypage/profile
• /mypage/profile/edit
• /mypage/change-password
• /mypage/notifications
• /mypage/board

제거된 기능

다음 기능은 의도적으로 제거되었습니다.

• /shop/*
• /cart
• /checkout
• /mypage/orders
• /mypage/wishlist
• /mypage/addresses

의존 구조

이 템플릿은 다음을 전제로 합니다.

• GnuBoard7 호스트 프로젝트
• GnuBoard7 Template Engine 활성화

의존성:

• 게시판 모듈 (sirsoft-board)
• 페이지 모듈 (sirsoft-page)
• Daum 우편번호 플러그인 (sirsoft-daum_postcode)

※ 데이터 없이도 기본 UI는 동작.

운영 기준

sirsoft-basic_comm은 다음 목적에 적합합니다.

운영 대상

• 커뮤니티 사이트
• 게시판 중심 서비스
• MVP / 베타 서비스
• 내부 커뮤니케이션 플랫폼

운영 전 확인 항목

• 템플릿 반영 여부
• dist 자산 존재 여부
• 게시판 모듈 정상 여부
• API 응답 상태
• 캐시 상태

장애 대응 범위

포함:

• 템플릿 구조
• UI 레이아웃
• fallback 처리

포함되지 않음:

• 데이터 품질
• 외부 API 장애
• 인프라 구성
• 사용자 데이터 관리

현재 상태

Beta

현재 기준:

• 커뮤니티 구조 안정화 완료
• 이커머스 의존 제거 완료
• API 정상 동작 확인
• 배포 가능 상태

추천 대상

• GnuBoard7 기반 개발자
• 커뮤니티 서비스 구축자
• 빠른 MVP가 필요한 경우
• 구조 설계를 참고하려는 경우

향후 계획

• 커뮤니티 기능 확장-
• 알림/소셜 기능 강화.
• UI 컴포넌트 정리.
• 다국어 지원. (현, 2개 국)

정리

sirsoft-basic_comm Template는 다음을 검토하기 위한 프로젝트입니다.

• 어떻게 커뮤니티 전용 템플릿을 구성할 것인가.
• 어떻게 이커머스 의존을 제거할 것인가
• 어떻게 JSON 기반 UI를 구성할 것인가
• 어떻게 재설치 가능한 구조를 만들 것인가

즉, 실운용 제품이라기보다 구조와 방식을 제시하는 템플릿 예제 프로젝트입니다.

의존성 필수 확장

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

• 게시판 모듈 (sirsoft-board >= 1.1.2)
• 페이지 모듈 (sirsoft-page >= 1.1.2)
• Daum 우편번호 플러그인 (sirsoft-daum_postcode >= 1.0.3)
• Core 버전 : 7.0.11

관리자 페이지에서 설치

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

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

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

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

https://github.com/glitter-node/sirsoft-basic_comm

설치 완료 후 Basic Comm 템플릿을 활성화하면 됩니다.

2. ZIP 패키지 설치

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

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

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

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

라이선스

MIT License

본 템플릿은 MIT License로 제공됩니다. 개인 및 상업적 이용, 수정 및 재배포가 가능합니다. 단, 원 저작권 고지는 유지해야 합니다.