Gnuboard7/CHANGELOG.md

Changelog

이 프로젝트의 모든 주요 변경사항을 기록합니다. 형식은 Keep a Changelog를 따르며, Semantic Versioning을 준수합니다.

[Unreleased]

[7.0.0-beta.1] - 2026-04-01

Changed

• 오픈 베타 릴리즈

[7.0.0-alpha.21] - 2026-03-30

Added

• 인스톨러 PHP CLI/Composer 필수 검증 기능 — 기본 php 미감지 시 CLI 설정 필수 전환, Composer 실행 확인 및 미설치 시 설치 안내, 둘 다 검증 완료 전 다음 단계 진행 차단
• 템플릿 레이아웃 수정 감지 시스템 — original_content_hash/original_content_size 컬럼 추가, SHA-256 해시 기반 수정 감지로 updated_by 방식 대체 (TemplateManager, LayoutRepository, 마이그레이션)
• 관리자 로그인 화면 개선 — 비밀번호 찾기/재설정 플로우 추가, 테마 Segmented Control, 언어 셀렉트 확대 (PasswordResetController, PasswordResetNotification, ForgotPasswordRequest, ResetPasswordRequest)
• {{raw:expression}} 바인딩 번역 면제 마커 시스템 — $t: 자동 번역 대상에서 특정 바인딩을 제외하는 마커 도입 (rawMarkers.ts)
• 레이아웃 프리뷰 모드 — 관리자 레이아웃 편집기에서 실시간 미리보기 지원 (LayoutPreviewController, LayoutPreviewService, 마이그레이션)
• 활동 로그 이력 조회 메뉴 신설 — ActivityLogController, ActivityLogResource, ActivityLogService, ActivityLogRepository, config/core.php 메뉴/권한 등록, 관리자 레이아웃 추가

Changed

• window.G7Config 설정 노출 최소화 Phase 1 — 프론트엔드 미참조 설정의 브라우저 소스 노출 차단
  • SettingsService: 필드 레벨 expose: false 지원 추가 (formatCategorySettings)
  • FiltersFrontendSchema: fields: {} (빈 객체) 시 전체 차단 안전 기본값 적용
  • View Composers: TemplateComposer/UserTemplateComposer에 ModuleSettingsService 주입 — frontend_schema 기반 필터링 적용 (기존 config() 직접 참조 우회 수정)
  • 코어 defaults.json: general 4개 필드, security 전체, seo 전체, advanced 9개 필드(debug_mode 제외), upload 2개 필드, drivers 전체를 expose: false 처리
• 캐시 무효화 로직 정비 — 016862cb 이전의 단순한 방식으로 복귀 (버전 증가 + TTL 자연 만료), extension_cache_previous_versions 추적 및 getCacheVersionsToInvalidate()/getCacheVersionsForLayoutInvalidation() 제거, Cache Tags 드라이버 분기 제거로 캐시 드라이버 비의존성 확보

Fixed

• MariaDB를 DB_CONNECTION=mysql 드라이버로 연결 시 WITH PARSER ngram 에러로 인스톨러 설치 실패 수정 — isMariaDb() 메서드 추가하여 서버 버전 문자열 기반 실제 DBMS 감지 (DatabaseFulltextEngine)
• 캐시 무효화 버전 키 누락 수정 — warmTemplateCache()가 버전 포함 키(.v{version})로 캐시를 생성하나 clearTemplateCache()가 레거시 키만 삭제하던 문제, routes/language 캐시에 버전 포함 키 삭제 추가
• 캐시 버전 0 무효화 누락 수정 — array_filter()가 버전 0을 falsy로 제거하여 .v0 캐시 키가 삭제 대상에서 누락되던 버그 (ClearsTemplateCaches, InvalidatesLayoutCache)
• 테스트 활성 디렉토리 보호 강화 — ProtectsExtensionDirectories에 moveDirectory spy 추가, copyToActive() 원자적 교체가 활성 디렉토리를 rename으로 파괴하는 것 방지
• 활동 로그 하위 호환 — ActivityLogResource에서 기존 DB 레코드(type: 'text')의 enum 필드를 모델의 현재 $activityLogFields 기준으로 동적 번역 + 일괄 변경 :count 미치환 보정
• 활동 로그 enum 미번역 전수 수정 — 14개 모델 필드의 $activityLogFields type: 'enum' 전환 + 14개 Enum 클래스에 labelKey() 메서드 추가 (User, Order, OrderOption, Product, Coupon, Post, Comment, Board)
• 활동 로그 삭제/일괄삭제 description_key 및 샘플 시더 누락 추가 — 코어 시더 activity_log_descriptions 테이블에 delete/bulk_delete 키 보충 + 다국어 파일 동기화
• 관리자 다크모드 품질 전수 조사 및 수정 — 레이아웃 JSON ~546건, TSX ~37건, CSS 5건의 누락된 dark: variant 추가 (이커머스 101파일, 게시판 19파일, 페이지 2파일, 마케팅 1파일, 템플릿 컴포넌트 ~20파일)
• 레이아웃 편집 캐시 무효화 및 버전 히스토리 수정 — LayoutService의 저장/복원 시 PublicLayoutController 서빙 캐시 무효화 + extension_cache_version 증가 누락 수정
• 사용자 관리에서 관리자/슈퍼관리자 삭제 시 토스트 메시지 및 어빌리티 처리 — CannotDeleteAdminException 추가, UserResource에 can_delete 어빌리티 반영
• ActivityLog 핸들러 $result 타입 불일치 수정 — CoreActivityLogListener에서 bool → array 반환 타입 정합성 보정
• 환경설정 사이트 로고 저장 시 Attachment 객체 정수 검증 오류 수정 — SaveSettingsRequest에서 Attachment JSON 객체를 정수로 검증하던 문제 수정
• 관리자 SPA 네비게이션 로고 깜빡임 수정 — extends base 컴포넌트 불필요 remount 방지 (_fromBase 마킹 기반 stable key 패턴)
• 인스톨러 다크모드 적색 배경 가독성 개선 — alert-title, alert-message, permission-badge, test-result 다크모드 색상 override 추가
• 인스톨러 BASE_PATH 심볼릭 링크 미해석 — realpath() 적용 + 절대경로/상대경로 병기로 호스팅 환경 대응
• 인스톨러 403 에러 페이지 다크모드 미지원 — prefers-color-scheme: dark 미디어쿼리 추가
• 템플릿 업데이트 수정 감지 실패 — LayoutRepository::update()가 updated_by를 설정하지 않아 hasModifiedLayouts()가 항상 "수정 없음" 반환하던 문제 수정 (hash 비교 방식으로 전환)
• 템플릿 업데이트 "수정 유지" 전략 미작동 — layoutStrategy === 'keep' 시 refreshTemplateLayouts() 미호출 → 양쪽 전략 모두 호출하되 preserveModified 플래그로 분기
• 템플릿 업데이트 API 응답 키 불일치 — 백엔드 has_modified → 프론트엔드 기대 has_modified_layouts/modified_count 키 정렬
• 템플릿/모듈/플러그인 설치 시 incrementExtensionCacheVersion() 누락 수정 — TemplateManager(install/activate/deactivate/uninstall) + ModuleManager(install) + PluginManager(install) 총 7곳 추가
• 캐시 버전 변경 시 프론트엔드 다국어 미갱신 수정 — TemplateApp.ts에서 캐시 버전 변경 감지 시 TranslationEngine 재로드 추가
• warmTemplateCache() 다국어 캐시 워밍 시 $partial 디렉티브 미해석 수정 — json_decode만 수행하던 코드를 TemplateService::getLanguageDataWithModules() 호출로 교체하여 fragment 해석 및 모듈/플러그인 다국어 병합 정상화
• ActivateTemplateCommand 의존성 미충족 시 성공으로 보고하는 버그 수정 — if ($result) → if ($result['success']) 변경 및 의존성 경고 메시지 출력, --force 옵션 추가
• ActivateModuleCommand/ActivatePluginCommand 의존성 미충족 시 경고 메시지 미출력 수정 — 의존성 경고 표시 및 --force 옵션 전달 추가

[7.0.0-alpha.20] - 2026-03-30

Added

• Laravel Scout 통합 및 MySQL FULLTEXT(ngram) 검색엔진 드라이버 확장 시스템 도입 — 커스텀 DatabaseFulltextEngine으로 MATCH...AGAINST IN BOOLEAN MODE 지원, core.search.engine_drivers 필터 훅으로 Meilisearch/Elasticsearch 등 외부 엔진 플러그인 등록 가능
• DatabaseFulltextEngine 다중 DBMS 호환 — FULLTEXT 미지원 DBMS(PostgreSQL, SQLite)에서 LIKE fallback 자동 전환, whereFulltext() 정적 헬퍼(관계 검색용), addFulltextIndex() 마이그레이션 헬퍼(DBMS별 조건부 DDL)
• config/scout.php 설정 파일 추가 — 기본 드라이버 mysql-fulltext, SCOUT_DRIVER 환경변수로 전환 가능
• FulltextSearchable 인터페이스 — FULLTEXT 검색 대상 컬럼 및 가중치 정의 계약
• AsUnicodeJson 커스텀 캐스트 — JSON 컬럼에 한글을 \uXXXX 이스케이프 없이 실제 UTF-8로 저장하여 FULLTEXT ngram 토크나이저 정상 동작 보장
• 환경설정 > 드라이버 탭에 검색엔진 설정 카드 추가 — 기본 MySQL FULLTEXT(ngram) 드라이버 표시, 플러그인 설치 시 추가 드라이버 자동 표시
• SaveSettingsRequest에 검색엔진 드라이버 동적 validation 추가 — core.search.engine_drivers 필터 훅 기반 허용 목록

[7.0.0-alpha.19] - 2026-03-29

Added

• 검색/필터/정렬 성능 향상을 위한 누락 인덱스 일괄 추가 — activity_logs(description_key), users(created_at), mail_send_logs(status), template_layouts(template_id), schedules(created_at)

[7.0.0-alpha.18] - 2026-03-26

Added

• SEO ExpressionEvaluator 산술 연산자 확장 — *, /, % 추가 (기존 +, -만 지원)
• SEO PipeRegistry 파이프 함수 엔진 구현 — 프론트엔드 PipeRegistry.ts 빌트인 파이프 15종 PHP 미러링 (date, datetime, relativeTime, number, truncate, uppercase, lowercase, stripHtml, default, fallback, first, last, join, length, filterBy, keys, values, json, localized)
• ActivityLog description_params ID→이름 변환 필터 훅 (core.activity_log.filter_description_params) — ActivityLog::getLocalizedDescriptionAttribute()에서 실행
• 코어 모델 $activityLogFields 정의 — User, Role, Menu, Schedule, MailTemplate (5개 모델)
• ActivityLog ChangeDetector 필드 라벨 다국어 키 추가 (lang/ko/activity_log.php, lang/en/activity_log.php — fields 섹션)
• module_helpers.php — getModuleSetting() 헬퍼 함수 추가
• CoreActivityLogListener: bulk_update per-User/per-Schedule 전환 + bulk_delete per-Schedule 전환 (건별 loggable_id 기록)
• ActivityLogHandler: 삭제된 엔티티용 loggable_type/loggable_id 직접 지정 fallback 지원
• 메뉴 관리 크로스 depth 이동 지원 — UpdateMenuOrderRequest에 moved_items 검증 추가, MenuRepository에 크로스 depth reorder 로직 구현
• NotCircularParent 검증 규칙 추가 — 메뉴 순환 참조 방지

Changed

• ActivityLog 규정 문서 대폭 보강 (docs/backend/activity-log.md) — description_params 저장 정책, ActivityLogDescriptionResolver 패턴, Bulk Update ChangeDetector 패턴, 개발자 체크리스트 추가

[7.0.0-alpha.17] - 2026-03-26

Added

• ActivityLog description_params ID→이름 변환 필터 훅 (core.activity_log.filter_description_params) — ActivityLog::getLocalizedDescriptionAttribute()에서 실행
• 코어 모델 $activityLogFields 정의 — User, Role, Menu, Schedule, MailTemplate (5개 모델)
• ActivityLog ChangeDetector 필드 라벨 다국어 키 추가 (lang/ko/activity_log.php, lang/en/activity_log.php — fields 섹션)
• module_helpers.php — getModuleSetting() 헬퍼 함수 추가
• CoreActivityLogListener: bulk_update per-User/per-Schedule 전환 + bulk_delete per-Schedule 전환 (건별 loggable_id 기록)
• ActivityLogHandler: 삭제된 엔티티용 loggable_type/loggable_id 직접 지정 fallback 지원

Changed

• ActivityLog 규정 문서 대폭 보강 (docs/backend/activity-log.md) — description_params 저장 정책, ActivityLogDescriptionResolver 패턴, Bulk Update ChangeDetector 패턴, 개발자 체크리스트 추가

[7.0.0-alpha.17] - 2026-03-26

Added

• Monolog 기반 ActivityLog 아키텍처: Log::channel('activity') → ActivityLogHandler → DB (3단계)
• ActivityLogChannel (커스텀 Monolog 채널), ActivityLogHandler, ActivityLogProcessor 신규
• ActivityLog i18n 지원: description_key + description_params 기반 실시간 다국어 번역
• ActivityLog 구조화된 변경 이력: changes JSON 컬럼 (필드별 label_key, old/new, type 포함)
• ChangeDetector 유틸리티 (모델 스냅샷 비교 → 구조화된 변경 이력 생성)
• CoreActivityLogListener 전면 확장: 모든 코어 Service 훅 구독 (User/Role/Menu/Settings/Schedule/Auth/Module/Plugin/Template/Layout/MailTemplate/Attachment — 66개 훅)
• 활동 로그 다국어 키 105개 정의 (lang/ko/activity_log.php, lang/en/activity_log.php)
• config/logging.php에 activity 채널 추가
• config/activity_log.php 전용 설정 파일 신규
• activity_logs 테이블 복합 인덱스 추가 (loggable_type+loggable_id+created_at, log_type+action+created_at)

Fixed

• resolveLogType() 사용자 역할 기반 → 요청 경로 기반으로 변경: 관리자가 사용자 화면에서 수행한 액션이 admin으로 기록되던 문제 수정 (ResolvesActivityLogType)

Changed

• ActivityLog 모델: description 컬럼 삭제 → description_key/description_params 기반 다국어 전환
• ActivityLogService: 기록 메서드 전면 제거 → 조회 전용으로 축소
• ActivityLogResource: description → localized_description (실시간 번역)
• 모든 Controller에서 logAdminActivity() 호출 전면 제거 → Listener 경로로 전환

Removed

• activity_logs.description 컬럼 (DB 삭제)
• ActivityLogManager, ActivityLogDriverInterface, DatabaseActivityLogDriver, NullActivityLogDriver
• ActivityLogListener (이중 훅 계층 — Monolog Handler로 대체)
• ActivityLogService.log/logAdmin/logUser/logSystem (Monolog 채널로 대체)
• AdminBaseController.logAdminActivity(), generateActivityDescription(), flattenDataForTranslation()

Fixed

• 마이페이지 프로필 저장 시 국가·언어 미선택 상태에서 오류가 발생하던 문제 수정 — 해당 필드를 선택 사항으로 변경
• 인스톨러 Step 2 .env 복사 명령어 안내 수정 — .env.example.production → .env.example (functions.php 2곳, installer.js 4곳)

[7.0.0-alpha.16] - 2026-03-23

Fixed

• 코어 업데이트 롤백 시 vendor 디렉토리 복원 불가 수정 — 백업 targets에 vendor 포함, excludes에서 vendor 제거
• 코어 백업 복원 시 개별 target 실패가 전체 복원을 중단하는 문제 수정 — 개별 try-catch로 나머지 target 복원 계속 진행
• 코어 업데이트 롤백 실패 시 수동 복구 안내 미출력 수정 — composer install 등 복구 단계 안내 추가
• 코어 업데이트 완전 복원 성공 시 유지보수 모드 자동 해제 추가
• 코어 업데이트 시 vendor 디렉토리 이중 처리로 인한 마이그레이션 실패 수정 — backup_only 설정 분리 (applyUpdate 제외, 백업/복원 전용)

[7.0.0-alpha.15] - 2026-03-23

Added

• Users UUID 전환 — 외부 노출 ID를 UUID v7으로 전환, 정수 id는 API 응답에서 숨김
• UniqueIdService 코어 서비스 추가 (UUID v7 + NanoID 생성)
• 코어 업그레이드 스텝 추가 (Upgrade_7_0_0_beta_15)

Changed

• User 모델: getRouteKeyName() → 'uuid', $hidden에 'id' 추가
• 공개 프로필 API: Route Model Binding 전환 ({userId} → {user})
• 사용자 벌크 상태변경: 정수 ID → UUID 기반
• API Resource: user.id → user.uuid 전환 (UserResource, UserCollection 외 7개)
• Activity Log 메타데이터: user_id → uuid 전환
• FormRequest: 정수 검증 → UUID 검증 전환

Fixed

• _global.currentUser?.id → ?.uuid 전환 (sirsoft-basic 템플릿 12개 파일)
• 글쓰기 버튼 abilities 비활성화 누락 수정
• 코어 업그레이드 스텝 raw SQL 테이블 프리픽스 미적용 수정 — UpgradeContext::table() 헬퍼 추가 (Upgrade_7_0_0_beta_15)

[7.0.0-alpha.14] - 2026-03-20

Fixed

• 확장 업데이트 시 임시 디렉토리(_updating_*, _old_*) 오토로드 오염 방지 — 임시 디렉토리를 _pending/ 하위에 생성하여 IDE 잠금 등으로 잔존 시에도 Fatal Error 방지 (ExtensionPendingHelper)

Added

• Windows 파일잠금 감지/해제 기능 — 확장 업데이트 시 IDE 등이 파일 핸들을 보유한 경우 자동 감지 및 해제 시도 (FileHandleHelper, ExtensionPendingHelper)

• SEO 렌더러 훅 시스템: core.seo.filter_context, core.seo.filter_meta, core.seo.filter_view_data — 확장이 SEO 렌더링 파이프라인에 런타임 데이터 변환으로 개입 가능

• seo.blade.php 확장 슬롯: extraHeadTags (</head> 직전), extraBodyEnd (</body> 직전) — filter_view_data 훅을 통해 커스텀 스크립트/스타일 주입

• ComponentHtmlMapper pagination 렌더 모드 — Pagination 컴포넌트에서 SEO용 페이지 링크 자동 생성 (currentPage/totalPages props 기반)

• ComponentHtmlMapper text_format dot notation 지원 — {author.nickname} 형태로 객체 prop의 중첩 필드 접근

• ExpressionEvaluator::evaluateRaw() — 표현식 결과를 원본 타입(배열 등)으로 반환하는 메서드

• SeoRenderer SEO 컨텍스트에 _global/_local 빈 객체 추가 — 프론트엔드 전용 상태 참조 시 null 대신 빈 객체 제공

• ComponentHtmlMapper fields 렌더 모드 — 컴포지트 컴포넌트(ProductCard 등)의 객체 prop에서 SEO용 HTML 필드 자동 생성 (조건부/반복/속성 기반)

• SeoRenderer seoVars 주입 — meta.seo.vars 선언을 해석하여 ComponentHtmlMapper format 모드에서 {key} 플레이스홀더 치환

• ExpressionEvaluator 리터럴 값 감지 — 숫자, 문자열, boolean, null/undefined 리터럴을 경로 해석 없이 직접 반환

• ExpressionEvaluator $t: 파라미터 {{}} 표현식 해석 — 번역 키 파라미터 값에 포함된 바인딩 표현식을 컨텍스트에서 평가

• TemplateManager seo-config 검증에 fields 타입 추가

• ExpressionEvaluator seo_overrides — seo-config.json에서 _local/_global 상태 오버라이드 선언 (와일드카드 매칭으로 접혀있는 콘텐츠 SEO 강제 펼침)

• TemplateManager seo-config 검증에 pagination 타입 및 seo_overrides 검증 추가

• SeoConfigMerger — 모듈/플러그인/템플릿의 seo-config.json을 수집·병합하는 동적 확장 시스템 (우선순위: 모듈 → 플러그인 → 템플릿, 24시간 TTL 캐싱)

• SeoRenderer _global 컨텍스트 주입 — SettingsService/PluginSettingsService 프론트엔드 설정을 _global에 주입 + initGlobal 매핑으로 데이터소스 응답을 _global 경로에 바인딩

• AbstractModule/AbstractPlugin SEO 기여 메서드 — getSeoConfig(), getSeoDataSources() 인터페이스 추가

• ModuleManager/PluginManager/TemplateManager install/activate/update 시 훅 발행 추가 — Artisan 커맨드에서도 SEO 캐시 자동 무효화 보장

• SEO Artisan 커맨드 다국어 파일 추가 (lang/ko/seo.php, lang/en/seo.php)

• ComponentHtmlMapper fields 모드 $all_props source — 모든 props 표현식을 해석하여 데이터 객체로 사용 (Header/Footer 등 다수 props 컴포넌트용)

• ComponentHtmlMapper fields 모드 $t: 번역 키 지원 — content 패턴에서 $t:key → 다국어 텍스트 렌더링

• ComponentHtmlMapper fields iterate item_attrs — 아이템별 동적 HTML 속성 (예: { "href": "/board/{slug}" })

• ExpressionEvaluator evaluateRaw() ?? null coalescing 지원 — 원본 타입(배열/객체) 유지하면서 null coalescing 수행

• 인스톨러 Windows 환경 명령어 대응 — chmod/chown 스킵, 미존재 디렉토리 안내 메시지 추가

• ExpressionEvaluator 삼항 연산자 (a ? b : c) — JS 우선순위 준수, ?./?? 자동 구분, 중첩 우측 결합

• ExpressionEvaluator $t() 함수 호출 구문 — 삼항 내부에서 $t('key') 형태로 번역 키 사용 가능 (기존 $t:key 방식 확장)

• ExpressionEvaluator $localized() 전역 함수 — 다국어 객체에서 현재 로케일 값 추출 ({ko: "상품", en: "Product"} → "상품")

• ExpressionEvaluator 객체 리터럴 파서 — {key: value, ...obj, [dynamicKey]: value} 구문 지원

• ExpressionEvaluator 스프레드 연산자 — 배열 [...arr, item] 및 객체 {...obj, key: value} 스프레드 지원

• SeoRenderer computed 속성 해석 — 레이아웃 computed 섹션을 _computed/$computed에 저장 (문자열 표현식 + $switch 형식)

• ComponentHtmlMapper classMap 지원 — base/variants/key/default로 조건부 CSS 클래스 선언적 적용

Fixed

• Redis 캐시 DB가 환경설정 값(REDIS_CACHE_DB)을 따르도록 수정 — config/database.php cache 연결 DB 반영

• ExpressionEvaluator 배열 리터럴 파싱 지원 — ['gallery','card'].includes(...) 표현식에서 배열 리터럴을 PHP 배열로 변환하여 includes 등 배열 메서드 정상 동작 (SEO 게시판 타입 분기 조건 중복 렌더링 수정)

• ExpressionEvaluator null 비교 JavaScript 시맨틱 적용 — null !== value → true, null === null → true (SEO 컨텍스트에서 _global 미존재 경로 비교 시 빈 문자열 대신 올바른 boolean 반환)

• ExpressionEvaluator $t: 번역에서 {{param}} 형식 파라미터 치환 지원 — 템플릿 번역 파일의 {{param}} + Laravel 표준 :param 형식 모두 처리

• ExpressionEvaluator 비교 연산 좌측 optional chaining 경로 타입 보존 — ?. 포함 경로가 evaluateExpression으로 불필요 라우팅되어 boolean 타입이 문자열로 변환되던 문제 수정

[7.0.0-alpha.13] - 2026-03-18

Added

• SeoCacheRegenerator — 단건 URL 캐시 즉시 재생성 서비스 (다국어 로케일별 렌더링 + 캐시 저장)
• SeoSettingsCacheListener — 코어 SEO 설정 변경 시 전체 SEO 캐시 + 사이트맵 삭제

Fixed

• SeoMiddleware에서 put() 대신 putWithLayout() 사용 — invalidateByLayout()이 레이아웃명 미저장으로 항상 0건 매칭되던 근본 버그 수정
• SeoRenderer에서 레이아웃명을 request attribute로 저장 — putWithLayout() 연동

[7.0.0-alpha.12] - 2026-03-17

Changed

• API 인증을 토큰 전용으로 전환 — 세션 기반 인증 의존 제거, Bearer 토큰 단일 방식으로 통일
• README 업데이트 — 표기 통일, 섹션 정비, 문서 링크 연결

[7.0.0-alpha.11] - 2026-03-16

Added

• 역할(Role) 상태 토글 API 추가 — PATCH /api/admin/roles/{role}/toggle-status 엔드포인트, 훅 지원 (core.role.before_toggle_status, core.role.after_toggle_status)
• RoleResource에 can_toggle_status ability 추가 — 역할별 토글 권한 제어
• RoleResource에 extension_name 필드 추가 — 확장 출처별 로케일 이름 표시
• 역할 생성 시 identifier 직접 입력 기능 추가 — 미입력 시 name 기반 자동 생성 유지
• 역할 관련 다국어 키 추가 (ko/en) — identifier 검증 메시지
• replaceUrl 핸들러 추가 — refetch 없이 URL만 변경 (페이지네이션 등 브라우저 히스토리 관리용)
• 사용자 검색 API에 id 파라미터 지원 추가 — 특정 사용자 ID로 직접 조회 가능
• TimezoneHelper 유틸리티 클래스 추가 — 사용자/서버 타임존 간 변환 헬퍼
• HasSampleSeeders 트레이트 추가 — 모듈/플러그인 시더에서 --sample 옵션으로 샘플 데이터만 분리 실행
• ComponentRegistry.getComponentNames() 메서드 추가 — 등록된 컴포넌트 이름 목록 조회

Fixed

• 템플릿 에러 페이지에서 :identifier가 리터럴로 표시되는 버그 수정 — Blade @ 이스케이프 처리
• ActionDispatcher onChange raw value fallback 제거 — 마운트/리렌더 시 의도치 않은 setState 실행으로 상품 폼 회귀 유발
• Form 자동 바인딩 setState 경합 수정 — 자동 바인딩과 수동 setState가 동시 실행 시 stale 값으로 덮어쓰이는 문제 해결
• Form 자동 바인딩 bindingType 메타데이터 기반 boolean 바인딩 수정 — Toggle/Checkbox 등 boolean 컴포넌트에서 문자열 변환 대신 boolean 값 유지
• SPA 네비게이션 시 _global._local에 이전 페이지 상태가 잔존하는 버그 수정 — 페이지 전환 시 _local 초기화 처리
• DynamicRenderer _computed 참조 prop에서 캐시된 stale 값이 사용되는 버그 수정 — _computed/$computed 참조 시 skipCache: true 적용

Changed

• 마이그레이션 통합 — 증분 마이그레이션을 테이블당 1개 create 마이그레이션으로 정리
• 시더 디렉토리 분리 — 설치 시더와 샘플 시더를 Sample/ 하위로 분리, --sample 옵션 추가
• 라이선스 프로그램 명칭 정비
• 일정 관리 메뉴 기본 비활성화 (config/core.php)
• Composer 의존성 업데이트 — Laravel Framework v12.54.1, Reverb v1.8.0, Symfony v7.4.6~7 등

[7.0.0-alpha.9] - 2026-03-13

Added

• 그누보드7 커스텀 에러 페이지 도입 — Laravel 기본 에러 페이지(401, 403, 404, 500, 503)를 그누보드7 스타일로 교체, 다크 모드 지원, 접근 경로 기반 홈 링크 분기 (admin → /admin, 기타 → /)
• 환경설정 > 고급 디버그 모드 활성화 시 개발 대시보드(/dev) 바로가기 버튼 추가
• 루트 LICENSE 파일 생성 (MIT 라이선스, 한국어 번역 + 영문 원문)
• 코어 라이선스/Changelog API 엔드포인트 추가 (GET /api/admin/license, GET /api/admin/changelog)
• 확장 라이선스 API 엔드포인트 추가 (GET /api/admin/modules/{id}/license, GET /api/admin/plugins/{id}/license, GET /api/admin/templates/{id}/license)
• Admin 푸터 copyright 클릭 → 코어 라이선스 모달, 버전 클릭 → Changelog 모달 표시 기능
• 확장 상세 모달에서 라이선스 클릭 시 전문 모달 표시 기능 (모듈/플러그인/템플릿)
• 각 번들 확장에 LICENSE 파일 및 manifest license 필드 추가

Changed

• 설치 화면 라이선스를 루트 LICENSE 파일로 통합 (public/install/lang/license-ko.txt, license-en.txt 삭제)
• /dev 라우트 뷰 이름을 dev-dashboard로 변경

[7.0.0-alpha.8] - 2026-03-13

Changed

• .env.example.develop과 .env.example.production을 .env.example로 통합 — 설치형 솔루션에 환경별 분리 불필요, Laravel/Vite 표준 준수
• 인스톨러에서 .env.production 백업 파일 생성 로직 제거 — Vite mode 기반 로딩 충돌 방지

Improved

• 코어/확장 업데이트 시 composer install 스킵 최적화 — composer.json/composer.lock 미변경 시 composer install 및 vendor 디렉토리 교체를 건너뛰어 업데이트 시간 단축

Fixed

• 확장 수동 설치 모달에서 설치 실패 시 상세 에러 사유(errors.error) 미표시 문제 수정 — 3개 모달에 상세 에러 P 요소 추가
• checkDependencies() 복수 의존성 에러 수집 — 첫 번째 미충족 의존성에서 즉시 throw 대신 전체 수집 후 줄바꿈 연결 (ModuleManager, PluginManager, TemplateManager)
• ModuleController/PluginController 에러 반환 형식을 TemplateController와 통일 — ['error' => $e->getMessage()] 형태
• 확장 설치 실패 시 _pending/{identifier} 디렉토리 자동 정리 — ModuleService, PluginService, TemplateService에 try-catch 추가

[7.0.0-alpha.7] - 2026-03-13

Added

• 템플릿 엔진 multipart/form-data 지원 — apiCall 핸들러 및 DataSourceManager에서 contentType: "multipart/form-data" 설정 시 params를 FormData로 자동 변환
  • ActionDispatcher: fetchWithOptions()에 FormData 변환 로직 추가, Content-Type 헤더 자동 생략 (브라우저 boundary 설정)
  • DataSourceManager: toFormData() 메서드 추가, 인증/비인증 경로 모두 multipart 지원
  • File/Blob 원본 유지, null/undefined 제외, 객체/배열 JSON.stringify 변환
• deepMergeWithState() non-plain 객체(File/Blob/Date) 보호 — spread 복사로 인한 내부 데이터 소실 방지
• resolveParams() non-plain 객체 재귀 해석 스킵 — File 객체가 빈 객체로 변환되는 문제 방지
• 컴포넌트 onChange raw value fallback — FileInput, Toggle 등 Event가 아닌 값을 전달하는 컴포넌트 지원

Fixed

• DataSourceManager isMultipart 변수 TDZ(Temporal Dead Zone) 버그 수정 — 선언 전 참조로 인한 ReferenceError 해결

[7.0.0-alpha.6] - 2026-03-13

Fixed

• 플러그인 환경설정 페이지 진입 시 404 오류 수정 — registerPluginLayouts() admin/user 분기 도입 후 루트 settings.json이 스킵되던 문제
  • 플러그인 설정 레이아웃을 resources/layouts/settings.json → resources/layouts/admin/plugin_settings.json으로 이동하여 모듈과 동일한 구조로 통일
  • AbstractPlugin::getSettingsLayout() 경로 변경
  • PluginSettingsService 오버라이드 경로 및 주석 수정
  • 영향받는 플러그인: sirsoft-daum_postcode, sirsoft-marketing, sirsoft-tosspayments

Changed

• 플러그인 설정 레이아웃 규정 문서(plugin-development.md) 경로/설명 업데이트

[7.0.0-alpha.5] - 2026-03-12

Added

• 확장(모듈/플러그인/템플릿) changelog GitHub 원격 소스 지원 — source=github 시 GitHub에서 CHANGELOG.md 조회, 실패 시 bundled 폴백
• ChangelogParser::parseFromString(), getVersionRangeFromString() 문자열 기반 파싱 메서드 추가
• ChangelogRequest validation 에러 다국어 메시지 추가 (source, version format, required_with)
• 플러그인 GitHub/ZIP 설치 기능 추가 — 모듈/템플릿에는 있지만 플러그인에 누락되어 있던 기능 신규 구현
  • PluginService::installFromGithub(), installFromZipFile(), findPluginJson() 메서드 추가
  • PluginController::installFromFile(), installFromGithub() 엔드포인트 추가
  • InstallPluginFromGithubRequest, InstallPluginFromFileRequest FormRequest 추가
  • install-from-file, install-from-github API 라우트 추가
• ExtensionManager::hasComposerDependenciesAt(string $path) 메서드 추가 — 임의 경로의 Composer 의존성 확인
• 모듈/플러그인 설치 시 _pending Composer 선행 설치 로직 추가 — 활성 디렉토리 이관 전 의존성 설치

Changed

• 확장 수동 설치 모달 3개(모듈/플러그인/템플릿) UI 통일 — TabNavigation underline, 에러 배너, 필드별 적색 테두리
• 확장 GitHub/ZIP 설치 공통 로직을 GithubHelper, ZipInstallHelper로 추출하여 3개 Service 중복 제거
• CoreUpdateService GitHub 관련 protected 메서드를 GithubHelper 위임으로 리팩토링
• 확장 목록 PageHeader에서 새로고침 버튼 제거, 업데이트 확인 버튼으로 통일
• 코어 업데이트 core_pending 고정 경로 → core_{Ymd_His} 타임스탬프 기반 격리 디렉토리로 변경
• 확장(모듈/플러그인/템플릿) 업데이트에 _pending/{identifier}_{timestamp}/ 스테이징 패턴 도입
• 확장 업데이트 시 스테이징 내에서 composer install 실행 (활성 디렉토리 무영향)
• 확장 GitHub 다운로드 코드를 코어와 동일한 패턴으로 통합 (인증 헤더, 폴백 체인, 타임아웃)
• GitHub 다운로드 공용 로직을 ExtensionManager로 추출하여 3개 Manager 중복 제거
• config/app.php에서 preserves 설정 키 제거 (타임스탬프 격리로 불필요)
• 모듈/플러그인 GitHub/ZIP 설치 흐름을 temp → _pending → composer install → 활성 디렉토리 패턴으로 통일

Fixed

• 코어 업데이트 결과 모달에서 from/to 버전 파라미터가 전달되지 않는 버그 수정 — params.params → params.query
• 플러그인에 GitHub/ZIP 설치 기능이 누락되어 있던 결함 수정
• 파일 복사 시 퍼미션/소유자/소유그룹 미보존 문제 수정 — File::copy() → FilePermissionHelper::copyFile() 교체 (6개 위치)
• Windows 환경에서 확장/코어 업데이트 후 _pending 하위에 빈 디렉토리가 잔존하는 문제 수정 — cleanupStaging()에 3단계 retry 로직 추가
• 코어 업데이트 후 vendor 교체 시 stale packages.php/services.php로 인한 500 오류 수정 — clearAllCaches()에 컴파일 캐시 삭제 + package:discover + extension:update-autoload 추가
• 코어 업데이트 시 bootstrap/cache 디렉토리가 소스에서 덮어씌워지는 문제 수정 — excludes에 bootstrap/cache 추가

[7.0.0-alpha.4] - 2026-03-12

Added

• 코어 업그레이드 스텝 검증용 샘플 마이그레이션 및 업그레이드 스텝 추가
• 코어 업그레이드 스텝 경로를 database/upgrades/ → upgrades/로 변경
• 업그레이드 스텝 실행을 프로그레스바 별도 단계로 분리 및 터미널 피드백 추가

Changed

• --source 모드에서 원본 소스 디렉토리를 _pending으로 복제 후 작업 (원본 보호)
• Step 8: 운영 디렉토리 composer install 재실행 → _pending/vendor/ 복사로 변경 (효율화)

Fixed

• --source 모드에서 소스 버전 감지 시 현재 env() 대신 config/app.php default 값 파싱
• 코어 업데이트 targets에 upgrades 디렉토리 누락 수정

[7.0.0-alpha.3] - 2026-03-12

Fixed

• .gitattributes의 CHANGELOG.md export-ignore가 모든 CHANGELOG 파일을 릴리스 아카이브에서 제외하던 문제 수정
• PharData(tar ustar) 100바이트 경로 제한으로 324개 파일이 누락되어 orphan 삭제가 발생하던 버그 수정

Removed

• PharData 아카이브 추출 전략 제거 — tar ustar 형식의 100바이트 경로 제한은 근본적 해결 불가

Added

• core:update --source= 옵션 추가 — ZipArchive/unzip 불가 환경에서 수동 업데이트 지원
  • 상대경로, 절대경로, Windows 경로 모두 지원
  • 소스 디렉토리의 그누보드7 프로젝트 유효성 검증 (config/app.php + version 키)
• 업데이트 안내 모달에 수동 업데이트 가이드 섹션 추가
• 시스템 요구사항 미충족 시 --source 옵션 안내 메시지 추가

[7.0.0-alpha.2] - 2026-03-12

Fixed

• 코어 업데이트 확인 시 업데이트할 버전이 없으면 피드백 없던 문제 수정
  • openModal 호출 형식 수정 (params.id → target)
  • 모달 데이터 바인딩 경로 수정 (_local → $parent._local)
• 코어 업데이트 명령어 에러 미출력 수정
• .env 예제 파일에서 G7_UPDATE_TARGETS 하드코딩 제거

Added

• 코어 업데이트 targets 확장 및 orphan 삭제 로직 추가
• 코어 업데이트 --local 옵션 및 설정 기반 제외/보존 추가
• 환경설정 고급 탭 코어 업데이트 설정 섹션 추가

[7.0.0-alpha.1] - 2026-03-07

Added

코어 아키텍처

• Laravel 12 기반 CMS 플랫폼 초기 구조 설계 및 구현
• Service-Repository 패턴 기반 계층 분리 아키텍처 구축
• CoreServiceProvider를 통한 인터페이스-구현체 바인딩 시스템
• ResponseHelper를 통한 통일된 API 응답 형식 (success/error/paginated)
• AdminBaseController / AuthBaseController / PublicBaseController 컨트롤러 계층 구조
• FormRequest + Custom Rule 기반 검증 시스템
• BaseApiResource 상속 기반 API 리소스 패턴
• PHP 8.2+ Backed Enum 기반 상태/타입/분류 관리

확장 시스템 (Extension System)

• 모듈(Module) 시스템: 디렉토리 스캔 기반 자동 발견, 설치/활성화/비활성화/삭제 관리
• 플러그인(Plugin) 시스템: 모듈 의존 기반 기능 확장, 설정 UI(settings.json) 지원
• 템플릿(Template) 시스템: Admin/User 타입 분리, JSON 기반 레이아웃, 컴포넌트 레지스트리
• ExtensionManager: 모듈/플러그인/템플릿 통합 관리 (설치, 업데이트, 삭제)
• HookManager: Action/Filter 훅 시스템 (doAction, applyFilters, HookListenerInterface)
• 확장 업데이트 시스템: _bundled/_pending 디렉토리 구조, GitHub/로컬 업데이트 감지 및 적용
• 확장 백업/복원 시스템 (ExtensionBackupHelper)
• 확장 상태 가드 (ExtensionStatusGuard): Installing/Updating/Uninstalled 상태 관리
• 확장 권한 동기화 (ExtensionRoleSyncHelper): 설치/삭제 시 역할-권한 자동 동기화
• 확장 메뉴 동기화 (ExtensionMenuSyncHelper): 모듈 메뉴 자동 등록/해제
• 확장 오토로드 시스템: 런타임 Composer 오토로드 (composer.json 수정 불필요)
• 확장 Composer 의존성 관리 (extension:composer-install 커맨드)
• 확장 업그레이드 스텝 시스템 (UpgradeStepInterface, UpgradeContext)
• 확장 설정 시스템 (SettingsMigrator): 모듈/플러그인별 독립 설정 관리
• 확장 소유권 시스템: extension_type/extension_identifier 기반 리소스 귀속
• 확장 에셋 시스템: module.json 매니페스트 기반 JS/CSS 자동 로딩
• 확장 Changelog 시스템: ChangelogParser 헬퍼 + API 엔드포인트 + 관리 화면 인라인 표시
• 확장 빌드 시스템: Artisan 커맨드 기반 (module:build, template:build, plugin:build)
• 확장 캐시 관리: 확장별 독립 캐시 + 일괄 클리어 커맨드

템플릿 엔진 (Template Engine)

• DynamicRenderer: JSON 레이아웃 기반 React 컴포넌트 동적 렌더링
• DataBindingEngine: {{expression}} 문법, Optional Chaining(?.), Nullish Coalescing(??) 지원
• ActionDispatcher: 20+ 내장 핸들러 (navigate, apiCall, setState, openModal, closeModal, sequence, condition, replaceUrl, scrollTo, copyToClipboard, downloadFile, debounce, emit, showToast, confirm, validate, submit, reset, filter, sort 등)
• ComponentRegistry: 컴포넌트 등록/검색/해석 시스템 (기본/집합/레이아웃 타입)
• TranslationEngine: $t:key 즉시 평가 / $t:defer:key 지연 평가 다국어 바인딩
• LayoutLoader: JSON 레이아웃 로딩, 캐싱, ETag 기반 조건부 요청
• Router: SPA 라우팅, 동적 경로 파라미터({{route.id}}), 쿼리스트링 관리
• 레이아웃 상속 시스템: extends 기반 베이스 상속 + type: "slot" 위치에 컨텐츠 삽입
• Partial 시스템: 레이아웃 모듈화, 컴포넌트 치환 (data_sources/computed/modals/state 미지원)
• 조건부 렌더링: if 속성 기반 표현식 평가 (type: "conditional" 미지원)
• 반복 렌더링: iteration 설정 (source, item_var, index_var, key)
• 반응형 레이아웃: responsive 속성 기반 breakpoint 오버라이드 (portable/compact/wide)
• 다크 모드: Tailwind dark: variant 기반 자동 전환
• classMap: 조건부 CSS 클래스 매핑 (key → variants)
• computed: 계산된 속성 시스템 (의존성 추적, 자동 재계산)
• 모달 시스템: modals 섹션 + openModal/closeModal 핸들러 (_global.modalStack 기반)
• init_actions: 레이아웃 초기화 시 자동 실행 액션 (루트 레이아웃 레벨)
• Named Actions: 액션 재사용 시스템 (DRY 패턴)
• errorHandling: 전역/데이터소스별 에러 핸들링 설정
• scripts: 레이아웃 레벨 커스텀 스크립트 로딩
• globalHeaders: API 호출 공통 헤더 설정 (pattern 기반 매칭)
• blur_until_loaded: 데이터 로딩 전 블러 처리
• lifecycle: 컴포넌트 생명주기 훅 (onMount, onUnmount)
• slots: 컴포넌트 슬롯 시스템
• layout_extensions: 모듈/플러그인의 동적 UI 주입 포인트
• isolatedState: 컴포넌트 상태 격리
• 데이터소스 조건부 로딩: if 표현식 기반 활성화/비활성화

컴포넌트 시스템

• Basic 컴포넌트 (27+): Div, Button, Input, Select, Form, A, H1~H6, Span, P, Img, Label, Textarea, Table, Thead, Tbody, Tr, Th, Td, Ul, Ol, Li, Hr, Strong, Em, Small, Pre, Code, Blockquote, Nav, Header, Footer, Main, Section, Article, Aside, Figure, FigCaption
• Composite 컴포넌트: DataGrid, CardGrid, Pagination, Modal, SearchBar, Tabs, TabPanel, Accordion, Badge, Breadcrumb, Card, Checkbox, CheckboxGroup, DatePicker, Dropdown, FileUpload, Icon, Notification, Radio, RadioGroup, RangeSlider, Rating, Select (enhanced), Sidebar, Stepper, Switch, Tag, Timeline, Toast, Tooltip, PasswordInput, DynamicFieldList, SortableList, ColorPicker, NumberInput, TreeView, DateRangePicker
• Layout 컴포넌트: FlexLayout, GridLayout, ScrollLayout, StickyLayout, Spacer, Container, AspectRatio
• HtmlEditor: TinyMCE 기반 HTML 에디터 컴포넌트
• Icon 컴포넌트: Font Awesome 6.4.x Free 아이콘 지원 (Solid 1,390개 / Regular 163개 / Brands 472개)
• Alert, EmptyState, LoadingSpinner, Skeleton, StatusBadge, CopyButton 유틸리티 컴포넌트

상태 관리

• 전역 상태 (_global): 앱 전체 공유, 페이지 이동 시 유지
• 로컬 상태 (_local): 레이아웃 단위 격리
• 계산된 상태 (_computed): 의존성 기반 자동 재계산
• 폼 자동 바인딩: Form 컴포넌트 stateKey 기반 자동 상태 연동
• setState 핸들러: target(global/local), 함수형 업데이트, 배열 조작 (push/filter/map)
• 상태 구독: G7Core.state.subscribe 기반 반응형 업데이트
• initGlobal: 전역 상태 초기값 선언
• 모달 스코프 상태: $parent._local 스냅샷 기반 데이터 전달

인증 시스템

• Laravel Sanctum 하이브리드 인증 (세션 + Bearer 토큰)
• AuthManager: 싱글톤 인증 상태 관리
• 자동 토큰 갱신: 401 응답 시 자동 리프레시 후 재시도
• OptionalSanctumMiddleware: 선택적 인증 지원 (비인증 사용자 허용)
• 로그인/로그아웃 3단계 프로토콜 (토큰 삭제 → 세션 무효화 → Auth::logout)
• 비밀번호 재설정: 이메일 인증 기반 토큰 발급 및 검증
• 회원가입: 약관 동의, 이메일 인증 지원

권한 시스템

• Role 기반 권한 관리 (User → Role → Permission 3계층)
• permission 미들웨어 체인 기반 접근 제어 (FormRequest authorize() 사용 금지)
• 확장별 권한 자동 등록/해제
• 역할별 메뉴 접근 제어 (role_menus 피벗 테이블)
• 슈퍼 관리자 (superadmin) 전체 권한 자동 부여

메뉴 시스템

• 계층형 메뉴 구조 (parent_id 기반)
• 역할별 메뉴 가시성 제어
• 모듈 메뉴 자동 등록 (getAdminMenus 인터페이스)
• 메뉴 순서 관리 (드래그 앤 드롭 SortableList)
• 다국어 메뉴명 지원 (JSON 배열 형식)

데이터 소스 (Data Sources)

• API 엔드포인트 선언적 정의 (id, endpoint, method, params)
• loading_strategy: immediate/lazy/manual 3가지 로딩 전략
• 데이터소스 의존성: depends_on 기반 연쇄 로딩
• 폴링: poll_interval 기반 주기적 갱신
• 조건부 로딩: if 표현식 기반 활성화
• transform: 응답 데이터 변환 함수
• cache_duration: 응답 캐싱

관리자 기능 (Admin)

• 대시보드: 시스템 정보, 통계 위젯, 최근 활동
• 사용자 관리: CRUD, 역할 할당, 상태 관리 (활성/비활성/차단)
• 역할 관리: CRUD, 권한 할당, 다국어 역할명
• 권한 관리: 카테고리별 권한 목록, 역할별 권한 할당
• 메뉴 관리: 계층형 메뉴 편집, 순서 변경, 역할별 가시성 설정
• 모듈 관리: 설치/활성화/비활성화/삭제, 업데이트 확인, 상세 정보 모달, changelog 표시
• 플러그인 관리: 설치/활성화/비활성화/삭제, 설정 UI, 업데이트 확인, changelog 표시
• 템플릿 관리: 설치/활성화/비활성화/삭제, 업데이트 확인, changelog 표시
• 환경설정: 사이트 기본 정보, SEO 설정, 메일 설정, 보안 설정, 탭 레이아웃
• 일정 관리: 스케줄 CRUD, 캘린더 뷰, 카테고리 분류
• 메일 템플릿 관리: DB 기반 메일 템플릿 CRUD, 변수 치환, 미리보기 기능
• 메일 발송 로그: 발송 이력 조회, 상태 추적, 상세 정보 모달
• 시스템 정보: PHP/Laravel/DB 버전, 디스크 사용량, 확장 현황 표시
• 코어 업데이트: 버전 확인, 업데이트 가이드, changelog 인라인 표시, 백업 생성

사용자 기능 (User/Public)

• 로그인/회원가입/비밀번호 재설정 페이지
• 마이페이지: 프로필 수정, 비밀번호 변경
• 통합 검색 기능
• 게시판 뷰: 목록/상세/작성/수정 (board 모듈 연동)
• 에러 페이지: 403, 404, 500, 503 커스텀 에러 페이지
• 점검 모드(maintenance) 페이지

설치 프로그램 (Installer)

• 다단계 웹 설치 마법사 (환경 체크 → DB 설정 → 관리자 생성 → 완료)
• SSE(Server-Sent Events) 기반 실시간 설치 진행 상태 표시
• 설치 롤백 기능: 실패 시 자동 복원 (마이그레이션/시더 롤백)
• 언어 선택 지원 (한국어/영어)
• 다크 모드 지원
• 환경 요구사항 자동 검증 (PHP 버전, 확장, 디렉토리 권한)

모듈: sirsoft-board (게시판)

• 게시판 관리: CRUD, 카테고리, 스킨 설정, 권한 설정
• 게시글 관리: CRUD, 검색, 정렬, 페이지네이션
• 댓글 시스템: CRUD, 대댓글 (계층형), 답글 알림
• 신고 시스템: 게시글/댓글 신고, 관리자 처리 (승인/거절)
• 첨부파일: 이미지/파일 업로드, 다운로드, 인라인 표시
• 비밀글: 작성자/관리자만 열람 가능
• 블라인드/복원: 관리자 블라인드 처리 및 복원 기능
• 카드/갤러리 레이아웃: 다양한 목록 표시 형태 지원
• 게시판 권한: 읽기/쓰기/댓글/관리 권한 분리
• 인기글/최신글 위젯
• SEO 메타 태그 자동 생성

모듈: sirsoft-ecommerce (이커머스)

• 상품 관리: CRUD, 옵션(사이즈/색상), 라벨, SEO 메타, 이미지 갤러리
• 상품 카테고리: 계층형 카테고리, 순서 관리, TreeView 편집
• 브랜드 관리: CRUD, 로고, 설명
• 주문 관리: 주문 목록, 상태 변경, 상세 정보, 주문 타임라인
• 쿠폰 시스템: 정액/정률 할인, 사용 조건 (최소 금액, 특정 상품), 유효기간, 사용 횟수 제한
• 배송 정책: 무료/유료/조건부 배송, 지역별 요금 설정
• 공통 정보 관리: 배송/교환/환불 안내, 판매자 정보
• 장바구니: 추가/수량 변경/삭제, 옵션별 관리, 품절 상품 알림
• 체크아웃: 주소 입력 (다음 우편번호 연동), 배송지 저장 체크박스, 결제수단 선택, 쿠폰 적용
• 주문 완료: 주문 번호, 결제 정보 요약, 장바구니 자동 비우기
• 상품 상세 페이지: 이미지 갤러리, 옵션 선택, 수량 입력, 장바구니 담기
• 상품 목록: 필터링 (카테고리/브랜드/가격), 정렬, 페이지네이션, 카드 그리드
• 위시리스트: 찜하기/해제 기능
• 상품 검색: 키워드 검색, 카테고리 필터 연동

모듈: sirsoft-page (페이지 관리)

• CMS 페이지: CRUD, 슬러그 기반 URL 매핑
• 페이지 버전 관리: 버전 이력 조회, 이전 버전 복원
• 첨부파일: 이미지/파일 업로드 지원
• 검색 통합: 페이지 내용 통합 검색 지원
• SEO: 메타 태그, Open Graph 설정

플러그인: sirsoft-daum_postcode (다음 우편번호)

• 다음 우편번호 검색 API 연동
• 주소 선택 후 폼 자동 입력
• 체크아웃 배송지 입력 연동

플러그인: sirsoft-tosspayments (토스페이먼츠)

• 토스페이먼츠 결제 API 연동
• 카드/계좌이체/가상계좌/무통장입금 결제 지원
• 결제 확인 (confirm) 프로세스
• 결제 성공/실패 콜백 처리
• 관리자 설정 UI (API 키 관리)

플러그인: sirsoft-marketing (마케팅 동의)

• 마케팅 동의 관리: 이메일 구독, 마케팅 동의, 제3자 제공 동의
• MarketingConsent / MarketingConsentHistory 모델 및 서비스
• MarketingConsentListener 훅 리스너 (회원가입/프로필 연동)
• 사용자 관리 화면 레이아웃 확장 (마케팅 동의 상세/폼/프로필)
• 회원가입 폼 마케팅 동의 항목 확장
• 플러그인 설정 UI
• 역할 기반 접근 제어 (마케팅 관리자)
• 다국어 지원 (ko, en)

플러그인: sirsoft-verification (본인인증)

• 휴대폰 인증, 아이핀 인증 등 본인인증 기능 제공
• 사용자 관리 화면 레이아웃 확장 (본인인증 상세/폼)
• 역할 기반 접근 제어 (본인인증 관리자)
• 다국어 지원 (ko, en)

템플릿: sirsoft-admin_basic (관리자)

• 관리자 대시보드 레이아웃
• 사이드바 네비게이션: 접기/펼치기, 계층형 메뉴, 활성 상태 표시
• 상단바: 사용자 정보, 알림 벨, 다크 모드 전환 토글
• 반응형 레이아웃 (데스크톱/태블릿/모바일)
• 관리자 전용 컴포넌트: DataGrid, CardGrid, SearchBar, 필터 패널 등
• CRUD 화면 표준 레이아웃 (목록/생성/수정/상세)
• 모달 기반 상세 보기/수정 기능
• 토스트 알림 시스템
• 확인 다이얼로그 (삭제 확인 등)
• 환경설정 탭 레이아웃
• 모듈/플러그인/템플릿 관리 화면 (설치/업데이트/상세 모달)
• 사용자/역할/권한 관리 화면
• 메뉴 관리 화면 (드래그 앤 드롭 순서 변경)
• 일정 관리 캘린더 화면
• 메일 템플릿 관리 화면
• 메일 발송 로그 화면
• 시스템 정보 화면
• 코어 업데이트 가이드/결과 모달

템플릿: sirsoft-basic (사용자)

• 사용자 메인 페이지 레이아웃
• 헤더/푸터 공통 레이아웃 (반응형)
• 로그인/회원가입/비밀번호 재설정 화면
• 마이페이지 레이아웃
• 게시판 목록/상세/작성/수정 화면
• 상품 목록/상세 화면
• 장바구니/체크아웃/주문완료 화면
• 검색 결과 화면
• CMS 페이지 표시 화면
• 에러 페이지 (403, 404, 500, 503)
• 점검 모드(maintenance) 전용 페이지
• 반응형 레이아웃 (데스크톱/태블릿/모바일)

다국어 시스템 (i18n)

• 백엔드 다국어: __() 함수 기반, lang/{locale}/*.php 파일 구조
• 프론트엔드 다국어: $t:key 즉시 평가 바인딩, $t:defer:key 지연 평가 바인딩
• 컴포넌트 다국어: G7Core.t() API 제공
• 모듈 다국어: 모듈별 독립 언어 파일, 네임스페이스 분리 (__('vendor-module::key'))
• 템플릿 다국어: partial 언어 파일 분할 (admin.json, errors.json 등)
• DB 다국어 필드: JSON 배열 형식 ({"ko": "...", "en": "..."})
• 지원 로케일: 한국어(ko), 영어(en)
• TranslatableField 트레이트: 모델 다국어 필드 자동 해석

보안 (Security)

• ValidLayoutStructure: JSON 레이아웃 구조 검증 Custom Rule
• WhitelistedEndpoint: API 엔드포인트 화이트리스트 검증 Custom Rule
• NoExternalUrls: 외부 URL 차단 검증 Custom Rule
• ComponentExists: 컴포넌트 존재 여부 검증 Custom Rule
• CSRF 보호: Laravel 기본 CSRF 토큰 검증
• XSS 방지: 출력 이스케이프, HTML sanitize 처리
• SQL Injection 방지: Eloquent ORM, 파라미터 바인딩 사용
• Rate Limiting: API 요청 제한 미들웨어

메일 시스템

• DB 기반 메일 템플릿: 제목/본문 DB 관리, 변수 치환 (Blade 문법)
• Notification + Mailable 통합 패턴: BaseNotification 상속으로 보일러플레이트 제거
• 메일 발송 로그: 발송 이력 DB 기록, 수신자/상태/발송 시간 추적
• 메일 템플릿 사용자 오버라이드 추적 (user_overrides 필드)

알림 시스템 (Notification)

• BaseNotification: 모든 알림의 베이스 클래스 (via() 보일러플레이트 제거)
• 알림 채널: 메일, 데이터베이스, 브로드캐스트 지원
• 실시간 알림: Laravel Reverb (WebSocket) 기반 Broadcasting

스토리지 시스템

• StorageInterface: 모든 파일 저장의 추상화 인터페이스 (Storage::disk() 직접 호출 금지)
• CoreStorageDriver: 코어 스토리지 구현체
• 확장별 독립 스토리지 공간 할당

코어 업데이트 시스템

• CoreUpdateService: GitHub API 기반 코어 버전 확인 및 업데이트 감지
• CoreUpdateController: 업데이트 상태 확인, 가이드 표시 API 엔드포인트
• CoreBackupHelper: 업데이트 전 코어 파일 백업 생성
• FilePermissionHelper: 파일/디렉토리 쓰기 권한 사전 검증
• MaintenanceModePage 미들웨어: 점검 모드 시 전용 페이지 표시
• 업데이트 가이드 모달: changelog 인라인 표시, 단계별 안내

그누보드7 DevTools

• MCP 서버: 20+ 디버깅 도구 제공
  • 기본 도구: g7-state, g7-actions, g7-cache, g7-diagnose, g7-lifecycle, g7-network, g7-form, g7-expressions, g7-logs
  • 고급 분석: g7-datasources, g7-handlers, g7-events, g7-performance, g7-conditionals, g7-websocket
  • 상태 계층/스타일: g7-renders, g7-state-hierarchy, g7-context-flow, g7-styles, g7-auth, g7-tailwind, g7-layout
  • Phase 8 심화: g7-computed, g7-nested-context, g7-modal-state, g7-sequence, g7-stale-closure, g7-change-detection
• 브라우저 상태 덤프: 런타임 상태 캡처 및 MCP 서버 전송
• UI 패널: 브라우저 내 DevTools 패널 (실시간 상태/액션/로그 확인)
• 페이지네이션: offset/limit 기반 대용량 데이터 조회 지원

WYSIWYG 에디터

• 비주얼 레이아웃 에디터: 드래그 앤 드롭 기반 레이아웃 편집
• PropertyPanel: 컴포넌트 속성 편집 UI
• 컴포넌트 팔레트: 사용 가능한 컴포넌트 드래그 목록
• 실시간 미리보기: 편집 즉시 렌더링 결과 확인

성능 최적화

• 레이아웃 캐싱: 파싱된 레이아웃 JSON + 상속 병합 결과 캐시
• 확장 캐싱: 모듈/플러그인/템플릿 목록 및 메타데이터 캐시
• 번역 캐싱: 언어 파일 파싱 결과 캐시
• ETag 지원: API 응답 조건부 캐시 검증 (304 Not Modified)
• Gzip 압축: API 응답 자동 압축
• Debounce 액션: 연속 이벤트 디바운스 처리 핸들러
• Lazy 로딩: 데이터소스 지연 로딩 (스크롤/이벤트 트리거)
• 순환 참조 방지 메커니즘: 레이아웃 상속 무한 루프 감지

데이터베이스

• 코어 테이블: users, roles, permissions, role_has_permissions, role_menus, menus, settings, mail_templates, mail_send_logs, schedules, modules, plugins, templates, template_layouts, template_layout_versions
• 모든 컬럼 한국어 comment 필수 규칙 적용
• down() 메서드 완전 롤백 구현 필수 규칙 적용
• 다국어 필드 JSON 배열 형식 표준
• MariaDB 호환성 지원
• boolean/enum 컬럼 값 설명 comment 포함 규칙

테스트 인프라

• PHPUnit 11.x: 백엔드 단위 테스트 (Unit) 및 기능 테스트 (Feature)
• Vitest: 프론트엔드 컴포넌트/템플릿 엔진 테스트
• createLayoutTest(): 레이아웃 JSON 렌더링 테스트 유틸리티 (Vitest + jsdom)
• mockApi(): API 응답 모킹 유틸리티 (fetch 자동 모킹)
• 트러블슈팅 회귀 테스트: 해결된 사례별 자동 검증
• 테스트 커버리지: 모델, 서비스, 컨트롤러, 컴포넌트, 레이아웃 렌더링

빌드 시스템

• Vite 기반 프론트엔드 빌드 (코드 분할, 트리 쉐이킹)
• Artisan 커맨드 기반 빌드 관리:
  • core:build: 코어 템플릿 엔진 빌드 (--full, --watch 옵션)
  • module:build: 모듈 프론트엔드 빌드 (--all, --watch, --active 옵션)
  • template:build: 템플릿 빌드 (--all, --watch, --active 옵션)
  • plugin:build: 플러그인 빌드 (--all, --watch, --active 옵션)
• _bundled 디렉토리 기본 빌드, --active 옵션으로 활성 디렉토리 빌드
• --watch 모드: 파일 감시 기반 실시간 빌드 (활성 디렉토리 자동 사용)

Artisan 커맨드

• 모듈 관리: module:list, module:install, module:activate, module:deactivate, module:uninstall, module:composer-install, module:cache-clear, module:seed, module:check-updates, module:update, module:build
• 플러그인 관리: plugin:list, plugin:install, plugin:activate, plugin:deactivate, plugin:uninstall, plugin:composer-install, plugin:cache-clear, plugin:seed, plugin:check-updates, plugin:update, plugin:build
• 템플릿 관리: template:list, template:install, template:activate, template:deactivate, template:uninstall, template:cache-clear, template:check-updates, template:update, template:build
• 확장 공통: extension:composer-install, extension:update-autoload
• 코어: core:build

개발 도구 및 문서

• AI 에이전트 개발 가이드 (AGENTS.md): 핵심 원칙, 코딩 규칙, 디버깅 프로토콜
• 규정 문서 체계 (docs/): 백엔드 14개, 프론트엔드 59개, 확장 23개, 공통 4개 (총 100개)
• AI 에이전트 자동화 도구: 검증/분석/구현 스킬 30+개, 인덱스 자동 생성 스크립트
• 트러블슈팅 가이드: 상태 관리, 캐시, 컴포넌트, 백엔드 문제 해결 사례집
• 코드 스타일: Laravel Pint (PSR-12) 자동 적용