HeuJung
ca4834bbb9
- pay_nhnkcp 1.0.3 분리: 관리자 API 권한 게이트 변경분이 이미 배포된 1.0.2 섹션에 소급 누적돼 있어 배포본과 어긋나고 업데이트 감지도 불가하던 것을 manifest/package/composer/lock 동기와 함께 정정 - 공개 시나리오 매니페스트의 내부 경로 참조 제거 — 릴리즈 파일 누출 검사가 error 로 발행을 차단하던 상태 해소 (내부 정적 검사 연계는 도구 비귀속 서술로 이관) - 모듈/플러그인/템플릿 수동 설치에서 깨진 zip·manifest 누락 같은 사용자 입력 오류가 500 으로 위장되던 422 계약 회귀 복원 — 서비스 경계에서 도메인 예외로 승격해 상태코드와 실패 사유를 함께 보존 (회귀 테스트 동반) - 본인인증 정책 검색 버튼이 입력 중인 검색어를 반영하지 않고, 초기화 후에도 입력창에 이전 검색어가 남던 문제 수정 — 폼 자동바인딩 옵트아웃 + 명시 상태 전환, E2E 회귀 스펙과 트러블슈팅 사례 동반 - 프록시 URL 검증 비문자열 분기의 :schemes 치환 누락 보정 (회귀 테스트 동반) - 7.0.8 사이클 출시일자를 2026-08-22 로 정렬 (코어·엔진·확장 7종·언어팩 3종, 버전·콘텐츠 무변경) 및 설치본 언어팩 동기
그누보드7 확장 시스템 개발 가이드
이 문서는 그누보드7의 확장 시스템 전체 개요와 각 상세 문서에 대한 링크를 제공합니다.
핵심 원칙
필수: /modules, /plugins 디렉토리 스캔으로 자동 발견 (composer.json 하드코딩 금지)
필수: 모든 확장 작업은 Artisan 커맨드로 수행
✅ 필수: 훅 시스템을 통한 코어 수정 최소화
확장 시스템 개요
G7은 동적 로딩 기반의 확장 시스템을 제공합니다:
- 모듈: 독립적인 비즈니스 기능 단위 (예: 이커머스, 블로그)
- 플러그인: 특정 기능 확장 (예: 결제, 배송)
- 템플릿: UI 렌더링 및 레이아웃 정의 (Admin, User)
- 훅 시스템: 코어 수정 없이 로직 확장
문서 구조
훅 시스템
| 문서 | 설명 |
|---|---|
| hooks.md | Action/Filter Hook, 리스너 구현, 우선순위 |
모듈 개발
| 문서 | 설명 |
|---|---|
| module-basics.md | AbstractModule, 디렉토리 구조, 네이밍 규칙 |
| module-routing.md | API/Web 라우트, 자동 Prefix, routes.json |
| module-layouts.md | 레이아웃 등록, 오버라이드, 상속 |
| module-commands.md | Artisan 커맨드 (install, activate, uninstall) |
| module-i18n.md | 백엔드/프론트엔드 다국어 분리 |
레이아웃 확장
| 문서 | 설명 |
|---|---|
| layout-extensions.md | 동적 UI 주입 (Overlay, Extension Point), 템플릿 오버라이드 |
플러그인 개발
| 문서 | 설명 |
|---|---|
| plugin-development.md | PluginInterface, 격리성, 의존성 원칙 |
확장 관리자
| 문서 | 설명 |
|---|---|
| extension-manager.md | Composer 오토로드, 서비스 등록, hidden 필터링 |
학습용 샘플
| 문서 | 설명 |
|---|---|
| sample-extensions.md | 학습용 최소 샘플 확장 4종 (gnuboard7-hello_*) — 계층 1:1 비교 레퍼런스 |
템플릿 시스템
| 문서 | 설명 |
|---|---|
| template-basics.md | Admin/User 템플릿, 메타데이터, 버전 히스토리 |
| template-routing.md | 라우트 정의, 언어 파일 경로 규칙 |
| template-security.md | API 서빙, 파일 확장자 화이트리스트 |
| template-caching.md | 캐시 계층, 무효화 전략 |
| template-commands.md | Artisan 커맨드 (install, activate) |
권한 및 메뉴 시스템
| 문서 | 설명 |
|---|---|
| permissions.md | Role, Permission, 자동 관리 |
| menus.md | 메뉴 권한, 시더 |
확장 타입별 네이밍 규칙
| 타입 | 디렉토리명 | 네임스페이스 | Composer 경로 |
|---|---|---|---|
| 모듈 | vendor-module |
Modules\Vendor\Module\ |
modules/vendor-module |
| 플러그인 | vendor-plugin |
Plugins\Vendor\Plugin\ |
plugins/vendor-plugin |
| 템플릿 | vendor-template |
- | templates/vendor-template |
예시:
- 모듈:
sirsoft-ecommerce→Modules\Sirsoft\Ecommerce\ - 플러그인:
sirsoft-payment→Plugins\Sirsoft\Payment\ - 템플릿:
sirsoft-admin_basic
훅 네이밍 규칙
[vendor-module].[entity].[action]_[timing]
타이밍 접미사:
before_*: 작업 실행 전after_*: 작업 실행 후on_*: 특정 이벤트 발생 시filter_*: 데이터 필터링
예시:
sirsoft-ecommerce.product.before_create
sirsoft-ecommerce.product.after_update
sirsoft-ecommerce.product.filter_create_data
sirsoft-ecommerce.order.on_payment_success
주요 Artisan 커맨드
모듈 관련
php artisan module:list # 모듈 목록 조회
php artisan module:install [identifier] # 모듈 설치
php artisan module:activate [identifier] # 모듈 활성화
php artisan module:deactivate [identifier] # 모듈 비활성화
php artisan module:uninstall [identifier] # 모듈 제거
php artisan module:cache-clear # 모듈 캐시 정리
템플릿 관련
php artisan template:list # 템플릿 목록 조회
php artisan template:install [identifier] # 템플릿 설치
php artisan template:activate [identifier] # 템플릿 활성화
php artisan template:deactivate [identifier] # 템플릿 비활성화
php artisan template:uninstall [identifier] # 템플릿 제거
php artisan template:cache-clear # 템플릿 캐시 정리
확장 관리자
php artisan extension:update-autoload # Composer 오토로드 업데이트
빠른 시작 가이드
새 모듈 개발 시
- module-basics.md - 기본 구조 이해
- module-routing.md - 라우트 설정
- module-i18n.md - 다국어 지원
- module-layouts.md - 레이아웃 등록 (필요시)
- hooks.md - 훅 리스너 구현 (필요시)
새 플러그인 개발 시
- plugin-development.md - 플러그인 구조 이해
- hooks.md - 훅 리스너 구현
템플릿 커스터마이징 시
- template-basics.md - 템플릿 타입 이해
- template-routing.md - 라우트/언어 파일
- template-security.md - 보안 규칙
관련 문서
- AGENTS.md - 프로젝트 개발 가이드
- backend/ - 백엔드 개발 가이드
- frontend/ - 프론트엔드 개발 가이드
- database-guide.md - 데이터베이스 가이드