SIRsoft Comm Template

쇼핑몰(이커머스) 의존성을 제거하고 커뮤니티 기능에 집중한 경량 GnuBoard7 사용자 템플릿

• 템플릿 ID: sirsoft-comm
• 최신 버전: v1.0.0-beta.11
• 배포 상태: Beta
• 저장소: https://github.com/glitter-node/sirsoft-comm
• 최신 릴리스: https://github.com/glitter-node/sirsoft-comm/releases/tag/v1.0.0-beta.11
• 라이선스: MIT License

프로젝트 개요

SIRsoft Comm Template은 GnuBoard7 기반으로 커뮤니티 중심 사이트를 빠르게 구축할 수 있도록 쇼핑몰 관련 의존성을 제외한 사용자 템플릿 예제입니다.

게시판, 검색, 회원 관리 및 마이페이지 등 커뮤니티 운영에 필요한 사용자 인터페이스를 제공하며, JSON Layout 기반의 선언형 UI 구조를 통해 템플릿 단위의 확장과 유지보수를 지원합니다.

GnuBoard7 코어를 수정하지 않고 설치할 수 있으며, 빌드된 정적 자산을 포함하여 운영 환경에서 별도의 프런트엔드 빌드 없이 적용할 수 있도록 구성되었습니다.

최신 릴리스

SIRsoft Comm v1.0.0-beta.11

현재 공개 배포 버전은 **v1.0.0-beta.11**입니다.

GitHub 저장소 또는 릴리스 패키지를 통해 설치할 수 있습니다.

배포 파일 다운로드

• ZIP 패키지 다운로드 — sirsoft-comm-v1.0.0-beta.11.zip
• TAR.GZ 패키지 다운로드 — sirsoft-comm-v1.0.0-beta.11.tar.gz
• GitHub 릴리스 상세 보기
• GitHub 저장소 바로가기

본 버전은 Beta 릴리스입니다. 실제 운영 환경에 적용하기 전에 GnuBoard7 코어 및 확장 모듈과의 호환성을 확인하시기 바랍니다.

v1.0.0-beta.9 ~ beta.11 주요 변경 사항

v1.0.0-beta.11 — 제3자 라이선스 고지 보완

• 배포 JavaScript 및 CSS에 포함된 제3자 코드의 저작권·라이선스 정보를 THIRD_PARTY_NOTICES.md에 기록
• 식별되지 않는 패키지 버전은 미확인으로 구분
• 기존 MIT 라이선스와 원저작권 고지 유지

v1.0.0-beta.10 — 공개 배포 문서 정비

• 외부 사용자를 위한 설치·업데이트 절차 보완
• 필수 의존 확장 및 배포 자산 안내
• 저작권 고지와 알려진 배포 제한 사항 정리

v1.0.0-beta.9 — 컴포넌트 및 번역 정합성 개선

• Section 컴포넌트를 basic 컴포넌트 매니페스트에 등록
• 정책 레이아웃에서 사용하는 컴포넌트 등록 계약 정합화
• 라우트 제목 번역 참조 수정
• 게시판 목록 및 게시글 상세 제목의 한국어·영어 번역 추가

기존 템플릿 구조와 JSON Layout 체계는 유지했습니다.

관리자에서 템플릿 수동 설치

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

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

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

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

설치 완료 후 커뮤니티 스타터(SIRsoft Comm) 템플릿을 활성화하면 됩니다.

2. ZIP 패키지 설치

최신 ZIP 패키지를 다운로드합니다.

• sirsoft-comm-v1.0.0-beta.11.zip 다운로드

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

다운로드한 ZIP 파일을 업로드한 후 템플릿을 설치합니다.

설치 완료 후 커뮤니티 스타터(SIRsoft Comm) 템플릿을 활성화하면 됩니다.

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

3. 필수 의존성

이 템플릿은 다음 확장 모듈 및 플러그인을 사용합니다.

템플릿 설치 전 필요한 확장을 설치하고 활성화해야 합니다.

4. 기존 버전 업데이트

기존 sirsoft-comm이 설치되어 있다면 GnuBoard7의 템플릿 업데이트 기능을 이용합니다.

템플릿의 사용자 정의 레이아웃이 있는 경우 업데이트 전에 백업하고, 기존 레이아웃 보존 정책을 확인하시기 바랍니다.

5. 설치 후 페이지 로딩 오류가 발생하는 경우

다음 메뉴에서 캐시를 초기화합니다.

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

이후 페이지를 새로고침하여 정상적으로 표시되는지 확인합니다.

무엇을 제공하는가

SIRsoft Comm는 다음 목적에 맞춰 설계되었습니다.

• 게시판 중심 커뮤니티 구조
• JSON Layout 기반 UI 구성 방식
• 데이터 의존 최소화 구조
• GnuBoard7 템플릿 엔진과 연동되는 UI 레이어
• 이커머스 의존성을 제거한 커뮤니티 전용 템플릿
• 운영 환경에서 별도 빌드 없이 사용할 수 있는 정적 자산 구성

기술 스택

프로젝트 성격

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

• GnuBoard7 템플릿 엔진 기반
• Template 단위 확장 구조
• JSON 기반 UI 정의
• 이커머스 의존성 제거
• 빌드 완료된 dist 포함
• 운영 환경에서 별도 프런트엔드 빌드 불필요
• 코어 수정 없이 적용 가능
• GitHub 저장소 및 배포 패키지를 통한 재설치 가능

주요 특징

1. 커뮤니티 전용 구조

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

제거된 기능:

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

이를 통해 게시판 중심 구조, 불필요한 상태 제거, 사용자 흐름 단순화, 유지보수 복잡도 감소를 지향합니다.

2. 재현 가능한 배포 구조

다음과 같은 배포 구조를 지향합니다.

• 동일한 템플릿 구성의 재현
• 환경 의존성 최소화
• 운영 환경 빌드 불필요
• GitHub 저장소 기반 설치 및 업데이트
• 버전별 ZIP·TAR.GZ 패키지를 통한 배포 관리

3. JSON Layout 기반 UI

페이지 UI는 JSON Layout 기반으로 정의됩니다.

주요 구조:

• layouts/**/*.json
• Partial 분리
• Data Source 선언형 구성
• 컴포넌트 매니페스트 기반 등록

UI 변경 시 코드 수정 범위를 최소화하고, 템플릿 수준의 구조적 확장과 공통 UI 재사용을 지원합니다.

4. 데이터 의존 최소화

커뮤니티 UI는 데이터가 없거나 API 응답이 불완전한 환경에서도 가능한 범위에서 기본 화면을 유지하도록 설계되었습니다.

주요 방향:

• Fallback 구조
• 안전한 데이터 바인딩
• API 응답 실패 시 UI 유지
• 초기 데이터가 없는 상태에서도 기본 화면 구성
• 데이터 계층과 UI 계층의 의존성 최소화

실제 기능 동작에는 관련 모듈 및 API의 정상적인 응답이 필요합니다.

5. UI 일관성

전체 UI는 다음 기준을 지향합니다.

• Low Contrast UI
• Border 기반 인터랙션
• 과도한 강조 요소 제거
• 정보 중심 인터페이스
• 정적 콘텐츠에 적합한 구조

포함된 페이지

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

운영 기준

운영 대상

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

운영 전 확인 항목

• 템플릿 설치 및 활성화 여부
• dist JavaScript·CSS 자산 존재 및 로딩 여부
• 게시판 모듈 정상 동작 여부
• 페이지 모듈 정상 동작 여부
• API 응답 상태
• 게시글 작성 및 첨부파일 업로드 동작
• 회원 인증 및 접근 권한 처리
• 브라우저 콘솔 오류
• 템플릿 캐시 상태

장애 대응 범위

포함되는 범위

• 템플릿 구조
• UI 레이아웃
• 컴포넌트 등록
• 번역 리소스
• Fallback 처리

포함되지 않는 범위

• 데이터 품질
• 외부 API 장애
• 인프라 구성
• 사용자 데이터 관리
• GnuBoard7 코어 자체의 오류
• 별도 확장 모듈의 내부 오류

현재 상태 및 알려진 제한 사항

Beta — v1.0.0-beta.11

현재 배포 방향은 다음과 같습니다.

• 커뮤니티 중심 UI 구조
• 이커머스 의존성 제거
• JSON Layout 기반 템플릿 구성
• 빌드된 정적 자산 포함
• GitHub 저장소 및 압축 패키지 배포
• 기존 SIRsoft 템플릿 구조 유지

JavaScript 메타데이터

배포 JavaScript의 templateMetadata.version에는 이전 버전인 1.0.0-beta.6이 포함되어 있습니다.

현재 확인된 GnuBoard7 코어 실행 경로에서는 이 값을 템플릿 로딩이나 자산 캐시 무효화에 사용하는 것으로 확인되지 않았으며, 별도 캐시 버전 관리 구조를 사용합니다.

다만 외부 소비자의 메타데이터 참조 가능성까지 완전히 검증한 것은 아닙니다.

검증 범위

기존 프로젝트에서 매니페스트 문법, 자산 존재 여부, 컴포넌트 등록, 번역 참조 및 번들·활성 파일 일치 여부를 정적으로 확인했습니다.

외부 사용자의 신규 설치 환경, 전체 브라우저 기능 및 레이아웃 병합 동작에 대한 포괄적인 검증은 완료되지 않았습니다.

Beta 단계이므로 운영 환경에서 사용하기 전에 호스트 GnuBoard7 및 설치된 확장 모듈과의 호환성을 확인하시기 바랍니다.

추천 대상

• GnuBoard7 기반 개발자
• 커뮤니티 서비스 구축자
• 빠른 MVP가 필요한 경우
• JSON Layout 기반 템플릿 구조를 참고하려는 경우
• 쇼핑몰 기능 없이 게시판 중심 서비스를 구성하려는 경우

향후 계획

• 커뮤니티 기능 확장
• 알림 및 소셜 기능 강화
• UI 컴포넌트 정리
• 템플릿 구조 및 유지보수성 개선
• 배포 자산 메타데이터 동기화
• 신규 설치 환경 호환성 검증

라이선스

MIT License

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

개인 및 상업적 이용, 수정 및 재배포가 가능합니다. 단, 원 저작권 및 허가 고지를 유지해야 합니다.

• 원저작자: (주)에스아이알소프트 (SIRSOFT)
• 추가 수정 및 커스터마이징: Glitter.kr
• 라이선스 전문: LICENSE
• 제3자 저작권·라이선스 안내: THIRD_PARTY_NOTICES.md

본 배포본은 기존 SIRsoft Comm 템플릿을 기반으로 수정·보완한 버전이며, SIRSOFT의 별도 승인 또는 공식 인증을 의미하지 않습니다.

프로젝트 링크

• GitHub Repository: https://github.com/glitter-node/sirsoft-comm
• Latest Release: https://github.com/glitter-node/sirsoft-comm/releases/tag/v1.0.0-beta.11
• ZIP Download: https://github.com/glitter-node/sirsoft-comm/releases/download/v1.0.0-beta.11/sirsoft-comm-v1.0.0-beta.11.zip
• TAR.GZ Download: https://github.com/glitter-node/sirsoft-comm/releases/download/v1.0.0-beta.11/sirsoft-comm-v1.0.0-beta.11.tar.gz

SIRsoft Comm — Community First, Lightweight by Design.