v7.0.0-beta.1 release

2026-04-01 10:30:52 +09:00
commit 6595fd0eb5
3967 changed files with 1875383 additions and 0 deletions
@@ -0,0 +1,365 @@
+<p align="center">
+  <img src="https://img.shields.io/badge/그누보드7-Gnuboard7-000000?style=for-the-badge&labelColor=0066FF&logoColor=white" height="200" alt="그누보드7 (Gnuboard7)">
+</p>
+
+<p align="center">
+  <strong>모던 아키텍처로 다시 태어난 대한민국 대표 오픈소스 CMS</strong><br>
+  A modern, extensible CMS platform built with Laravel + React
+</p>
+
+<p align="center">
+  <a href="#"><img src="https://img.shields.io/badge/version-7.0.0--beta.1-blue" alt="Version"></a>
+  <a href="#"><img src="https://img.shields.io/badge/PHP-8.2%2B-777BB4?logo=php&logoColor=white" alt="PHP"></a>
+  <a href="#"><img src="https://img.shields.io/badge/Laravel-12.x-FF2D20?logo=laravel&logoColor=white" alt="Laravel"></a>
+  <a href="#"><img src="https://img.shields.io/badge/React-19-61DAFB?logo=react&logoColor=black" alt="React"></a>
+  <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-green" alt="License"></a>
+  <a href="#"><img src="https://img.shields.io/badge/status-Open%20Beta-orange" alt="Status"></a>
+</p>
+
+---
+
+[소개](#그누보드7-소개) · [주요 기능](#주요-기능) · [기술 스택](#기술-스택) · [아키텍처](#아키텍처) · [빠른 시작](#빠른-시작) · [기본 제공 확장](#기본-제공-확장) · [비즈니스 모델](#비즈니스-모델) · [기존 사용자](#기존-그누보드-사용자) · [문서](#문서) · [기여하기](#기여하기) · [만든 사람들](#만든-사람들) · [커뮤니티](#커뮤니티) · [변경 기록](#변경-기록) · [라이선스](#라이선스)
+
+---
+
+## 그누보드7 소개
+
+**그누보드7 (Gnuboard7)** 은 23년간 대한민국에서 가장 널리 사용된 오픈소스 CMS인 그누보드를, 현대적 기술 스택으로 **완전히 새로 설계**한 차세대 웹 플랫폼입니다.
+
+Laravel과 React를 기반으로, 보안부터 아키텍처까지 처음부터 다시 만들었습니다.
+
+- **JSON 레이아웃 엔진**: React를 몰라도 JSON만으로 React 기반 UI를 선언적으로 정의. 모듈/플러그인이 프론트엔드 빌드 없이 JSON만으로 UI를 동적으로 주입/확장. 고도화된 UI가 필요한 경우 커스텀 React 컴포넌트를 개발하여 등록 가능
+- **하나의 플랫폼, 다양한 비즈니스**: 커뮤니티, 쇼핑몰, 구독, 예약 — 비즈니스 모델에 맞게 확장
+- **정교한 권한 관리**: 역할(Role) + 권한(Permission) + 스코프(Scope) 3단계 접근 제어로, 서비스 규모가 커져도 통제력 유지
+- **글로벌 레디**: 다국어(i18n) 네이티브 지원, 로케일 기반 UI, 다중 통화 대응
+- **확장 시스템**: 모듈 + 플러그인 + 템플릿 3중 구조로 코어 수정 없이 기능 확장
+
+---
+
+## 주요 기능
+
+현대적인 웹 플랫폼에 필요한 핵심 기능을 갖추었습니다.
+
+| 영역 | 설명 |
+|------|------|
+| **모듈 아키텍처** | 모듈 + 플러그인 + 템플릿 3중 확장 구조. 코어 수정 없이 독립적 모듈(게시판, 커머스 등) 개발이 가능합니다. Hook 기반 기능 주입으로 Service-Repository 패턴의 명확한 계층 분리를 유지합니다 |
+| **현지화** | 백엔드부터 프론트엔드까지 일관된 다국어 개발 환경을 제공합니다. 로케일 기반 UI, 확장 가능한 언어 팩을 지원합니다 |
+| **해외 결제** | 로컬 비즈니스를 넘어 글로벌 커머스로 도약하기 위한 기반을 제공합니다 `정식버전에서 지원예정` |
+| **권한 제어** | 역할별 메뉴와 기능, 데이터 범위까지 제어할 수 있습니다. 역할(Role) + 권한(Permission) + 스코프(Scope) 3단계 접근 제어로 조직 구조에 맞는 유연한 접근 관리를 제공합니다 |
+| **보안** | 입력값 자동 검증과 토큰 기반 인증을 제공합니다. 설계부터 보안을 고려한 다층 방어 구조(CSRF/XSS/SQL Injection)를 구현합니다 |
+| **유연한 화면 구성** | 화면 구조를 정의하면 즉시 반영할 수 있습니다. 프론트엔드 인프라 없이 JSON 선언만으로 웹앱 수준의 동적 화면 구현이 가능합니다 |
+| **레이아웃 편집기** | 위지윅 기반 레이아웃 편집 기능으로 화면 블록을 직접 배치하고 수정 결과를 바로 확인할 수 있습니다 `정식버전에서 지원예정` |
+| **검증된 기반** | Laravel + React 기반을 제공합니다. 글로벌 기업이 채택한 기술 스택으로 높은 확장성과 유연한 UI 구현이 가능합니다 |
+| **캐싱** | 화면 구조와 API 응답, 권한 정보를 다층으로 캐싱합니다. 불필요한 재처리 없이 빠른 응답 속도를 유지합니다 |
+| **활동 로그** | 관리자·사용자 활동 이력을 자동으로 기록하고 조회할 수 있습니다. Monolog 기반 구조로 확장이 용이합니다 |
+| **검색** | Laravel Scout 기반 전문 검색을 지원합니다. 상품, 게시글 등 주요 콘텐츠를 대상으로 검색 기능을 제공합니다 |
+
+---
+
+## 기술 스택
+
+| 구분 | 기술 |
+|------|------|
+| **백엔드** | PHP 8.2+, Laravel 12.x, MySQL 8.0+, Redis 6.0+ |
+| **프론트엔드** | React 19, Vite, Tailwind CSS 4 (다크 모드 지원) |
+| **인증** | Laravel Sanctum (Bearer 토큰) |
+| **테스트** | PHPUnit 11.x, Vitest |
+| **코드 품질** | Laravel Pint (PSR-12) |
+
+---
+
+## 아키텍처
+
+```
+Gnuboard7
+├── Core (Laravel 12)
+│   ├── Controller → FormRequest → Service → Repository → Model
+│   ├── Hook System (Action / Filter)
+│   ├── Permission (Role → Permission → Scope)
+│   └── SEO (Bot Detection → Static HTML → Cache → Sitemap)
+│
+├── Extensions
+│   ├── Modules    — 게시판, 쇼핑몰, 페이지 ...
+│   ├── Plugins    — 결제, 인증, 마케팅 ...
+│   └── Templates  — 관리자 UI, 사용자 UI
+│
+└── Template Engine
+    ├── JSON Layout → React Components
+    └── Dynamic Rendering + Data Binding
+```
+
+### 템플릿 엔진 동작 흐름
+
+그누보드7의 템플릿 엔진은 **JSON으로 UI 구조를 선언**하면, 엔진이 이를 해석하여 React 컴포넌트로 렌더링합니다.
+
+#### 현재 지원
+
+- JSON 선언만으로 React 기반 UI 구성 — React 전문 지식 없이도 화면 개발 가능
+- 모듈/플러그인이 프론트엔드 빌드 없이 JSON만으로 UI를 동적으로 주입/확장
+- 고도화된 UI가 필요한 경우 커스텀 React 컴포넌트를 개발하여 등록 가능
+
+#### 지원 예정
+
+- UI가 코드가 아닌 데이터(JSON)로 정의되는 구조를 활용하여, **드래그 앤 드롭 방식의 비주얼 에디터**를 통해 비개발자도 화면을 직접 구성할 수 있도록 지원할 계획입니다
+
+```mermaid
+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로 렌더링됩니다:
+
+```json
+{
+  "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 요소가 자동으로 표시/숨김 처리됩니다.
+
+**확장 시스템 3원칙**
+
+1. **코어 수정 최소화** — 모든 비즈니스 로직은 모듈/플러그인으로 구현
+2. **동적 로딩** — composer.json 하드코딩 없이 디렉토리 스캔으로 자동 발견
+3. **Hook 기반 확장** — 서비스 계층에서 Action/Filter 훅으로 기능 주입
+
+---
+
+## 빠른 시작
+
+### 시스템 요구사항
+
+- PHP 8.2+ (필수 확장 30개 포함)
+- MySQL 8.0+ 또는 MariaDB 10.3+ (utf8mb4)
+- Node.js 20+ (빌드 시에만 필요)
+- Composer 2.x
+
+### 설치
+
+```bash
+# 1. 프로젝트 클론
+git clone https://github.com/gnuboard/g7.git
+cd g7
+
+# 2. 환경 설정 파일 복사
+cp .env.example .env
+
+# 3. 브라우저에서 /install 접속 → 설치 마법사 진행
+```
+
+> 상세 설치 가이드는 [INSTALL.md](INSTALL.md)를 참조하세요.
+
+---
+
+## 기본 제공 확장
+
+### 모듈
+
+| 모듈 | 설명 |
+|------|------|
+| **sirsoft-board** | 게시판 — 다중 게시판, 댓글, 파일 첨부 |
+| **sirsoft-ecommerce** | 쇼핑몰 — 상품, 주문, 결제, 배송, 쿠폰, 상품 문의 |
+| **sirsoft-page** | 페이지 — 정적 콘텐츠 관리 |
+
+### 플러그인
+
+| 플러그인 | 설명 |
+|---------|------|
+| **sirsoft-tosspayments** | 토스페이먼츠 결제 연동 |
+| **sirsoft-verification** | 본인인증 |
+| **sirsoft-daum_postcode** | 다음 우편번호 검색 |
+| **sirsoft-marketing** | 마케팅 도구 |
+
+### 템플릿
+
+| 템플릿 | 설명 |
+|--------|------|
+| **sirsoft-admin_basic** | 관리자 기본 템플릿 |
+| **sirsoft-basic** | 사용자 기본 템플릿 |
+
+---
+
+## 비즈니스 모델
+
+그누보드7 하나로 다양한 비즈니스를 운영할 수 있습니다.
+
+| 모델 | 설명 | 상태 |
+|------|------|------|
+| **커뮤니티** | 게시판, 댓글, 회원 관리 | Beta |
+| **커머스** | 상품 등록, 주문, 결제, 배송 관리 | Beta |
+
+---
+
+## 기존 그누보드 사용자
+
+기존 그누보드5에서 그누보드7으로 전환할 수 있도록, 회원·게시글·상품 등 주요 데이터의 **마이그레이션 툴을 제공할 예정**입니다.
+
+---
+
+## 문서
+
+| 문서 | 링크 |
+|------|------|
+| 설치 가이드 | [INSTALL.md](INSTALL.md) |
+| 전체 문서 | [docs/README.md](docs/README.md) |
+| 시스템 요구사항 | [docs/requirements.md](docs/requirements.md) |
+| 백엔드 개발 | [docs/backend/README.md](docs/backend/README.md) |
+| 프론트엔드 개발 | [docs/frontend/README.md](docs/frontend/README.md) |
+| 데이터베이스 | [docs/database-guide.md](docs/database-guide.md) |
+| 확장 시스템 | [docs/extension/README.md](docs/extension/README.md) |
+| 모듈 개발 | [docs/extension/module-basics.md](docs/extension/module-basics.md) |
+| 플러그인 개발 | [docs/extension/plugin-development.md](docs/extension/plugin-development.md) |
+| 템플릿 개발 | [docs/extension/template-basics.md](docs/extension/template-basics.md) |
+| 테스트 | [docs/testing-guide.md](docs/testing-guide.md) |
+| API 레퍼런스 | 준비 중 |
+
+---
+
+## 기여하기
+
+그누보드7은 오픈소스 프로젝트입니다. 모든 형태의 기여를 환영합니다.
+
+- 버그 리포트 및 기능 제안: [GitHub Issues](https://github.com/gnuboard/g7/issues)
+- 코드 스타일: Laravel Pint (PSR-12)
+- 테스트: PHPUnit (백엔드) + Vitest (프론트엔드)
+- AI 협업: AI 에이전트용 개발 규칙 명세(AGENTS.md)와 MCP 디버깅 도구를 내장하고 있어, AI 도구와 자연스럽게 협업할 수 있습니다
+
+---
+
+## 만든 사람들
+
+**[SIRSOFT](https://sir.kr)** 에서 개발하고 있습니다.
+
+### Core Team
+
+<p>
+  <a href="https://github.com/HeuJung"><img src="https://github.com/HeuJung.png" width="60" alt="HeuJung"></a>&nbsp;&nbsp;
+  <a href="https://github.com/chym1217"><img src="https://github.com/chym1217.png" width="60" alt="chym1217"></a>
+</p>
+
+### Contributors
+
+커뮤니티 기여자 목록은 [GitHub Contributors](https://github.com/gnuboard/g7/graphs/contributors)에서 확인할 수 있습니다.
+
+---
+
+## 커뮤니티
+
+| 채널 | 링크 |
+|------|------|
+| GitHub | [github.com/gnuboard/g7](https://github.com/gnuboard/g7) |
+| SIR 커뮤니티 | [sir.kr](https://sir.kr) |
+| 문의 | minsup@sir.kr |
+
+---
+
+## 변경 기록
+
+최근 변경된 사항에 대한 자세한 내용은 [CHANGELOG](CHANGELOG.md)를 참고해 주세요.
+
+---
+
+## 보안 취약점
+
+보안 취약점을 발견하셨다면 [GitHub Issues](https://github.com/gnuboard/g7/issues)에 보고해 주세요.
+
+---
+
+## 라이선스
+
+그누보드7은 [MIT 라이선스](LICENSE)에 따라 배포되는 오픈소스 소프트웨어입니다.
+
+Copyright (c) 2026 SIRSOFT
+
+---
+
+<p align="center">
+  Made by <a href="https://sir.kr">SIRSOFT</a>
+</p>