HeuJung
bd215bc586
메일 인증 대신 휴대폰 본인확인을 쓸 수 있게 하는 플러그인을 추가한다. 가입·비밀번호 재설정·성인인증 등 코어 IDV 가 강제하는 모든 지점에서 동작하며, 테스트 모드로 계약 없이 전 흐름을 확인할 수 있다. 구현·검수 과정에서 드러난 저장소 전역 결함을 함께 처리했다. - 외래키 컬럼의 한국어 comment 가 방출되지 않던 문제 (소스 38건 교정 + 기설치본 백필 업그레이드 스텝 7종). ->comment 를 ->constrained 뒤에 체인하면 예외 없이 통과하면서 comment 가 조용히 사라진다 - 로케일 전환 후 확장 액션 핸들러가 소실되던 문제 (플러그인 3종에 재등록 진입점 노출) - 본인인증 상태 폴링 응답이 누적 시도 횟수를 함께 내보내던 문제 - 인증 안내 문구와 실제 진행 방식의 폭 경계 불일치 (768~1023px). 엔진과 같은 값을 같은 방법으로 읽도록 교정 - transition_overlay_target 이 replace 없이 무효이던 관리자 목록 40곳. 로딩 표시가 나오지 않아도 경고가 남지 않아 화면을 봐야만 알 수 있었다 두 인증 플러그인의 코어 최소 요구 버전을 7.0.6 으로 올린다. 운영 모드 자격증명 필수 검사가 7.0.6 의 설정 저장 검증 표면에 의존하며, 그보다 낮은 코어에서는 그 검사가 조용히 통과해 빈 자격증명으로 저장할 수 있었다. 재발 차단으로 정적 검사 룰 4종을 신설하고, 검사 도구가 미커밋 신규 확장을 "검사 파일 0" 으로 통과시키던 사각을 함께 막았다.
그누보드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 - 데이터베이스 가이드