G7

소개 · 주요 기능 · 기술 스택 · 아키텍처 · 빠른 시작 · 기본 제공 확장 · 비즈니스 모델 · 기존 사용자 · 문서 · 기여하기 · 만든 사람들 · 커뮤니티 · 변경 기록 · 라이선스

그누보드7 소개

그누보드7 (Gnuboard7) 은 23년간 대한민국에서 가장 널리 사용된 오픈소스 CMS인 그누보드를, 현대적 기술 스택으로 완전히 새로 설계한 차세대 웹 플랫폼입니다.

Laravel과 React를 기반으로, 보안부터 아키텍처까지 처음부터 다시 만들었습니다.

• JSON 레이아웃 엔진: React를 몰라도 JSON만으로 React 기반 UI를 선언적으로 정의. 모듈/플러그인이 프론트엔드 빌드 없이 JSON만으로 UI를 동적으로 주입/확장. 고도화된 UI가 필요한 경우 커스텀 React 컴포넌트를 개발하여 등록 가능
• 하나의 플랫폼, 다양한 비즈니스: 커뮤니티, 쇼핑몰, 구독, 예약 — 비즈니스 모델에 맞게 확장
• 정교한 권한 관리: 역할(Role) + 권한(Permission) + 스코프(Scope) 3단계 접근 제어로, 서비스 규모가 커져도 통제력 유지
• 글로벌 레디: 다국어(i18n) 네이티브 지원, 로케일 기반 UI, 다중 통화 대응
• 확장 시스템: 모듈 + 플러그인 + 템플릿 3중 구조로 코어 수정 없이 기능 확장

주요 기능

현대적인 웹 플랫폼에 필요한 핵심 기능을 갖추었습니다.

기술 스택

아키텍처

Gnuboard7
├── Core (Laravel 12)
│   ├── Controller → FormRequest → Service → Repository → Model
│   ├── Hook System (Action / Filter)
│   ├── Permission (Role → Permission → Scope)
│   ├── Identity Verification (Policy × Purpose × Provider × Message)
│   ├── Language Pack (가상 보호 행 + ZIP/GitHub 설치 + sub-key 보존)
│   ├── Notification (Definition × Template × Recipients)
│   └── SEO (Bot Detection → Static HTML → Cache → Sitemap)
│
├── Extensions
│   ├── Modules    — 게시판, 쇼핑몰, 페이지 ...
│   ├── Plugins    — 결제, 인증, 마케팅 ...
│   ├── Templates  — 관리자 UI, 사용자 UI
│   └── LanguagePacks — 일본어 등 공식/외부 언어팩
│
└── Template Engine
    ├── JSON Layout → React Components
    └── Dynamic Rendering + Data Binding

템플릿 엔진 동작 흐름

그누보드7의 템플릿 엔진은 JSON으로 UI 구조를 선언하면, 엔진이 이를 해석하여 React 컴포넌트로 렌더링합니다.

제공 기능

• JSON 선언만으로 React 기반 UI 구성 — React 전문 지식 없이도 화면 개발 가능
• 모듈/플러그인이 프론트엔드 빌드 없이 JSON만으로 UI를 동적으로 주입/확장
• 고도화된 UI가 필요한 경우 커스텀 React 컴포넌트를 개발하여 등록 가능
• UI가 코드가 아닌 데이터(JSON)로 정의되는 구조를 활용한 위지윅 레이아웃 편집기 — 비개발자도 화면 블록을 직접 배치·편집하고 결과를 바로 확인할 수 있습니다

flowchart TB
    subgraph Backend ["🔧 Backend — Laravel"]
        A["📄 JSON 레이아웃 파일"] --> B["⚙️ LayoutService"]
        B --> |"상속 해석<br/>extends / partial"| B
        M["📦 모듈 레이아웃"] -.-> |"layout_extensions<br/>extension_point 주입"| B
        P["🔌 플러그인 레이아웃"] -.-> |"layout_extensions<br/>extension_point 주입"| B
        B --> C["🔒 권한 필터링<br/>사용자별 컴포넌트 제거"]
        C --> D["📨 병합된 JSON 응답<br/>캐싱 · 1시간 TTL"]
    end

    subgraph Frontend ["⚛️ Frontend — React"]
        D --> E["📥 LayoutLoader<br/>레이아웃 JSON 수신"]
        E --> F["💾 상태 초기화<br/>_global · _local · _computed"]
        E --> G["🌐 데이터 소스 로딩<br/>API 병렬 호출"]
        F & G --> H["🎨 DynamicRenderer"]

        H --> I{"❓ 조건 평가<br/>if 표현식"}
        I --> |"✅ true"| J["🗂️ ComponentRegistry<br/>name → React 컴포넌트"]
        I --> |"❌ false"| K["⏭️ 렌더링 스킵"]

        J --> L["🔗 데이터 바인딩<br/>표현식 → 실제 값"]
        L --> N["🖱️ 이벤트 바인딩<br/>onClick → ActionDispatcher"]
        N --> O["✨ React 렌더링"]
    end

    subgraph Actions ["👆 사용자 인터랙션"]
        O --> |"클릭 · 입력"| Q["🎯 ActionDispatcher"]
        Q --> R["🧭 navigate — 페이지 이동"]
        Q --> S["📡 apiCall — API 호출"]
        Q --> T["🔄 setState — 상태 변경"]
        Q --> U["📋 openModal — 모달 열기"]
        S --> |"onSuccess · onError"| Q
        T --> |"상태 변경 → 리렌더링"| H
    end

    style Backend fill:#dbeafe,stroke:#2563eb,stroke-width:2px,color:#1e3a5f
    style Frontend fill:#d1fae5,stroke:#059669,stroke-width:2px,color:#064e3b
    style Actions fill:#fce7f3,stroke:#db2777,stroke-width:2px,color:#831843

    style A fill:#2563eb,stroke:#1d4ed8,color:#fff
    style B fill:#2563eb,stroke:#1d4ed8,color:#fff
    style M fill:#7c3aed,stroke:#6d28d9,color:#fff
    style P fill:#7c3aed,stroke:#6d28d9,color:#fff
    style C fill:#dc2626,stroke:#b91c1c,color:#fff
    style D fill:#059669,stroke:#047857,color:#fff

    style E fill:#059669,stroke:#047857,color:#fff
    style F fill:#0891b2,stroke:#0e7490,color:#fff
    style G fill:#0891b2,stroke:#0e7490,color:#fff
    style H fill:#d97706,stroke:#b45309,color:#fff
    style I fill:#d97706,stroke:#b45309,color:#fff
    style J fill:#2563eb,stroke:#1d4ed8,color:#fff
    style K fill:#6b7280,stroke:#4b5563,color:#fff
    style L fill:#7c3aed,stroke:#6d28d9,color:#fff
    style N fill:#7c3aed,stroke:#6d28d9,color:#fff
    style O fill:#059669,stroke:#047857,color:#fff

    style Q fill:#e11d48,stroke:#be123c,color:#fff
    style R fill:#be185d,stroke:#9d174d,color:#fff
    style S fill:#be185d,stroke:#9d174d,color:#fff
    style T fill:#be185d,stroke:#9d174d,color:#fff
    style U fill:#be185d,stroke:#9d174d,color:#fff

    linkStyle default stroke:#374151,stroke-width:2px

JSON 레이아웃 예시 — 아래 JSON이 실제 React UI로 렌더링됩니다:

{
  "data_sources": [
    { "id": "products", "endpoint": "/api/products", "method": "GET" }
  ],
  "layout": {
    "type": "basic", "name": "Div",
    "children": [
      { "type": "basic", "name": "H1", "text": "$t:product_list" },
      {
        "type": "basic", "name": "Div",
        "iteration": { "source": "{{products?.data?.data}}", "item_var": "$item" },
        "children": [
          { "type": "basic", "name": "Span", "text": "{{$item.name}}" }
        ]
      },
      {
        "type": "basic", "name": "Button", "text": "$t:add",
        "if": "{{products?.data?.abilities?.can_create}}",
        "actions": [{
          "event": "onClick",
          "handler": "navigate",
          "params": { "path": "/products/create" }
        }]
      }
    ]
  }
}

모듈/플러그인을 활성화하면 해당 UI와 컴포넌트가 자동으로 주입됩니다. 개발자는 JSON만으로 UI를 추가하거나 변경할 수 있어 별도의 프론트엔드 빌드가 필요 없으며, 권한(abilities)에 따라 UI 요소가 자동으로 표시/숨김 처리됩니다.

핵심 시스템

플랫폼을 떠받치는 네 가지 시스템이 유기적으로 동작합니다.

1. 확장 시스템 — 3원칙

1. 코어 수정 최소화 — 모든 비즈니스 로직은 모듈/플러그인으로 구현
2. 동적 로딩 — composer.json 하드코딩 없이 디렉토리 스캔으로 자동 발견
3. Hook 기반 확장 — 서비스 계층에서 Action/Filter 훅으로 기능 주입

2. 훅 시스템 (Action / Filter)

Laravel 이벤트와 별개로 동작하는 가벼운 훅 시스템입니다. Action 은 부수 작업(로깅, 알림), Filter 는 값 변형 (기본값 주입, 권한 확장)에 사용됩니다.

// Service 계층에서 훅 발행
HookManager::doAction('core.user.after_create', $user, $data);
$data = HookManager::applyFilters('core.user.filter_create_data', $data);

// 모듈 Listener 가 훅 구독 (자동 발견)
public static function getSubscribedHooks(): array
{
    return [
        'core.user.after_create' => ['method' => 'onUserCreated', 'priority' => 20],
    ];
}

모듈/플러그인은 Listeners/ 디렉토리에 클래스만 두면 HookListenerRegistrar 가 자동으로 구독합니다. 큐 직렬화를 통한 비동기 실행도 지원하며, 워커에서도 Auth::user(), request()->ip(), App::getLocale() 같은 컨텍스트가 자동 복원됩니다.

3. 공통 캐시 시스템

CacheInterface 를 기반으로 코어 · 모듈 · 플러그인 이 키 충돌 없이 각자의 캐시를 관리합니다.

// 모듈 서비스는 BaseModuleServiceProvider::$cacheServices 배열에 등록하면
// 생성자 타입힌트만으로 자동 주입됨 (Storage 패턴과 동일)
public function __construct(
    private BoardRepositoryInterface $repository,
    private CacheInterface $cache, // ← g7:module.sirsoft-board: 접두사 자동 적용
) {}

• TTL 중앙 관리 — 모든 캐시 TTL 은 g7_core_settings('cache.*_ttl') 를 추종합니다. 하드코딩 금지
• 자동 무효화 — CacheInvalidatable 트레이트를 모델에 적용하면 saved / deleted 시점에 태그 기반으로 관련 캐시 자동 삭제
• 라이프사이클 연동 — 모듈 비활성화/삭제 시 ModuleManager 가 해당 모듈의 격리 캐시를 일괄 flush
• 프론트엔드 캐시 버스팅 — ext.cache_version 증가가 응답의 config.json 을 통해 전파되어 ?v= 쿼리 파라미터 기반으로 브라우저 캐시까지 무효화

4. 알림 시스템

Definition × Template × Recipients 3계층 모델로 멀티 채널 알림을 관리합니다.

┌─────────────────────┐      ┌───────────────────────┐      ┌─────────────────────┐
│ NotificationDefini- │ 1..N │ NotificationTemplate  │      │ Recipients (JSON)   │
│ tion                ├──────┤ (채널별 독립)         ├──────┤ - trigger_user      │
│ type=order.created  │      │ channel=mail|db|...   │      │ - related_user      │
│ variables=[...]     │      │ subject, body,        │      │ - role              │
│                     │      │ click_url             │      │ - specific_users    │
└─────────────────────┘      └───────────────────────┘      └─────────────────────┘

• Definition — 알림 종류(type), 지원 채널, 변수 메타데이터 정의
• Template — 채널(mail / database / broadcast)마다 독립된 제목·본문·클릭 URL. 관리자가 다국어로 커스터마이징 가능
• Recipients — 템플릿별로 수신자 규칙을 JSON 으로 정의. 템플릿 단위 독립이므로 "메일은 주문자에게, DB 알림은 역할 보유자에게" 같은 분기 구성 가능

// 모듈 Service 에서 훅 발행만 하면 발송 파이프라인이 자동 실행
HookManager::doAction('sirsoft-ecommerce.order.after_confirm', $order);

// ↓ NotificationHookListener → NotificationDispatcher:
// 1. order.confirmed 정의 조회
// 2. 활성 템플릿 순회 (mail/database)
// 3. 템플릿의 recipients JSON 해석 → 수신자 Collection
// 4. 각 수신자에게 channel 별 발송 (GenericNotification)
// 5. notification_logs 에 발송 이력 기록

• 코어 기본 알림 3종: welcome, reset_password, password_changed
• 이커머스 모듈 알림 7종: order_confirmed, order_shipped, order_completed, order_cancelled, new_order_admin, inquiry_received, inquiry_replied
• 실시간 브로드캐스트는 Laravel Reverb (WebSocket) 기반. Reverb 미구성 환경에서는 graceful skip 으로 오류 없이 동작
• GenericNotification 단일 클래스가 모든 알림을 처리 — 신규 알림 타입 추가 시 개별 Notification 클래스 작성 불필요

5. 언어팩 시스템

새 언어를 코어 수정 없이 추가할 수 있는 운영 도구로, 모듈/플러그인/템플릿 관리와 동일한 라이프사이클(설치 → 활성화 → 업데이트 → 제거 + 자동 백업/롤백) 을 제공합니다.

공식 일본어(ja) 번들 14종(코어 + 주요 모듈/플러그인/템플릿) 이 즉시 사용 가능하며, 인스톨러 4단계에서 모듈/플러그인/템플릿 선택과 종속된 언어팩 카드가 자동 연동되어 함께 설치할 수 있습니다.

상세: docs/extension/language-packs.md

6. 본인인증 (Identity Verification)

회원가입·비밀번호 재설정·민감 작업·결제 직전 등 모든 본인인증 시점을 라우트/훅 단위 선언형 정책으로 통합 관리합니다.

┌────────────────────┐    ┌─────────────────────┐    ┌──────────────────────┐
│ Policy             │    │ Purpose             │    │ Provider             │
│ (강제 시점·실패 모드│    │ (인증 목적·허용 채널│    │ (메일·KCP·이니시스   │
│  ·단계·conditions) │ ◀▶ │  ·source 추적)      │ ◀▶ │  ·SMS·외부 IDV ...)  │
└────────────────────┘    └─────────────────────┘    └──────────────────────┘
            │                                                  │
            └──────────▶ Message Template (정책×목적 매핑) ◀───┘
                                    │
                              GenericNotification

• 정책 SSoT — 정책 enable 토글이 라우트 코드 수정 없이 즉시 적용. 모든 API 라우트가 정책 DB 와 자동 매칭
• 428 인터셉터 — 서버가 HTTP 428 응답을 반환하면 프론트엔드가 자동으로 인증 모달을 띄우고 인증 성공 시 원 요청을 자동 재실행
• 선언형 등록 — 모듈/플러그인은 module.php::getIdentityPolicies() / getIdentityPurposes() / getIdentityMessages() 만 선언하면 활성화/업데이트 시 자동 등록되며 운영자 편집값 보존
• 메시지 템플릿 — 프로바이더와 (목적/정책)별로 다국어 제목/본문을 개별 정의. 정책 → 목적 → 프로바이더 기본값 순서로 fallback
• 외부 Provider 슬롯 — 플러그인이 KCP·PortOne·토스인증·Stripe Identity 등을 G7 표준 Extension Point 패턴으로 자기 SDK UI 를 주입 가능
• 이력 관리 — 관리자 화면에서 인증 수단 탭, 통합 검색, 상태/목적/채널/IP 멀티 필터, 보관주기(180일) 일괄 파기 제공

상세: docs/backend/identity-policies.md, docs/backend/identity-providers.md, docs/backend/identity-messages.md

빠른 시작

시스템 요구사항

• PHP 8.2+ (필수 확장 30개 포함)
• MySQL 8.0+ 또는 MariaDB 10.3+ (utf8mb4)
• Node.js 20+ (빌드 시에만 필요)
• Composer 2.x

설치

# 1. 프로젝트 클론
git clone https://github.com/gnuboard/g7.git
cd g7

# 2. 환경 설정 파일 복사
cp .env.example .env

# 3. 브라우저에서 /install 접속 → 설치 마법사 진행

상세 설치 가이드는 INSTALL.md를 참조하세요.

기본 제공 확장

모듈

플러그인

템플릿

번들 언어팩

설치 시 함께 동반 설치할 수 있는 공식 언어팩입니다. 코어 + 주요 모듈/플러그인/템플릿이 일관된 번역으로 즉시 사용 가능합니다.

한국어/영어는 코어/번들 확장에 내장되어 있으며 설치 없이 항상 활성 상태로 동작합니다. 새 언어는 ZIP 또는 GitHub URL 로 자유롭게 추가할 수 있습니다.

학습용 샘플 확장

확장 시스템 학습을 위한 최소 구현 샘플입니다. 관리자 UI 에서 "숨김 포함" 토글로 노출되며 CLI 에서는 항상 보입니다.

비즈니스 모델

그누보드7 하나로 다양한 비즈니스를 운영할 수 있습니다.

기존 그누보드 사용자

기존 그누보드5에서 그누보드7으로 전환할 수 있도록, 회원·게시글·상품 등 주요 데이터의 마이그레이션 툴을 제공할 예정입니다.

문서

기여하기

그누보드7은 오픈소스 프로젝트입니다. 모든 형태의 기여를 환영합니다.

• 버그 리포트 및 기능 제안: GitHub Issues
• 코드 스타일: Laravel Pint (PSR-12)
• 테스트: PHPUnit (백엔드) + Vitest (프론트엔드)
• AI 협업: AI 에이전트용 개발 규칙 명세(AGENTS.md)와 MCP 디버깅 도구를 내장하고 있어, AI 도구와 자연스럽게 협업할 수 있습니다

만든 사람들

SIRSOFT 에서 개발하고 있습니다.

Core Team

Contributors

커뮤니티 기여자 목록은 GitHub Contributors에서 확인할 수 있습니다.

커뮤니티

변경 기록

최근 변경된 사항에 대한 자세한 내용은 CHANGELOG를 참고해 주세요.

보안 취약점

보안 취약점을 발견하셨다면 SIR 문의게시판에 비밀글로 제보해 주세요.

라이선스

그누보드7은 MIT 라이선스에 따라 배포되는 오픈소스 소프트웨어입니다.

Copyright (c) 2026 SIRSOFT