feat(core,engine): 부트스트랩 리소스 정적 게시(bake) 및 폴백 체계 도입

공개 제보 https://github.com/gnuboard/g7/issues/122 대응 — 초기 부트스트랩
리소스(다국어 병합·컴포넌트 정의·라우트·확장 번들·템플릿 dist)를 캐시 버전
디렉토리(public/build/ext/{v}/)에 실파일로 게시해 웹서버가 rewrite 전에 직접
서빙한다. 부트 임계 경로의 PHP 왕복을 제거하고(실측 TTFB 131~144ms → 1~7ms),
미게시·부분게시·GC 직후에는 fetch·태그·번들 3계층이 종전 API 로 즉시 폴백한다.

- 게시: 원자적 tmp→rename→manifest(존재=완료), 캐시 락 단일 실행, 인라인 GC
 (현재+직전 1개), incrementExtensionCacheVersion 단일 지점 terminating 트리거
 + blade 자가 치유 + 설치기 태스크(best_effort) + 일일 cleanup 스케줄,
 sudo 업데이트 대비 소유권 정상화(normalizeOwnership)·prune/백업 제외
- 프론트(engine-v1.61.0): blade 주입 cache_version 1급 시드(이중 부트 로드 제거),
 fetchStaticFirst 즉시 폴백, ComponentRegistry 버전 키드 매니페스트,
 ModuleAssetLoader 번들 정적→레거시 폴백, asset-url-recovery staticToLegacy 역변환
- 폴백 API 품질: lang/components/routes ETag+304 + 환경 분기 Cache-Control,
 열화 라우트 스냅샷 공개 캐시 금지(서버측 캐시 회피와 대칭), 게시 .htaccess
 mod_deflate + nginx gzip 스니펫(압축 전송량 회귀 방지)
- SEO 정합: 봇 HTML 은 GC 대상 정적 URL 미사용(allowStatic:false), props $switch
 봇측 해석 구현(engine-v1.56.0 패리티), 패리티 룰 expression-dialect 그룹 신설,
 상주 allow 헤더 제거로 잠금 복원, _comment* 접두 주석 키 분류
- 검증: 전 수정 red→green 4단계, Playwright 라이브 21건, Chrome MCP 24축+M1~M3,
 봇 curl 3축, 캐시 저장소(file/redis/database) 축 판정, 히스토리·공개이슈·커밋
 이력 전수 재조사 반영
- 코어 7.0.10, engine-v1.61.0. kill-switch: G7_STATIC_CACHE=false
This commit is contained in:
HeuJung
2026-08-25 17:02:53 +09:00
parent 56836a2b66
commit 5ba7a83597
73 changed files with 4219 additions and 98 deletions
File diff suppressed because one or more lines are too long
+24
View File
@@ -1576,6 +1576,27 @@ if (! function_exists('optimizeConfigCacheSSE')) {
}
}
if (! function_exists('publishStaticCacheSSE')) {
/**
* 설치 완료 직후 부트스트랩 리소스 정적 게시(bake)를 최초 수행한다 (#122).
*
* 이 지점이 없으면 첫 방문자가 blade 자가 치유(1회 API 폴백)를 겪는다.
* best_effort — 실패해도 설치는 완료 처리한다(사이트는 API 폴백으로 정상).
*
* @return array 태스크 실행 결과
*/
function publishStaticCacheSSE(): array
{
return executeArtisanCommandSSE(
artisanCommand: 'ext-static:publish --force',
taskId: 'static_publish',
taskNameKey: 'task_static_publish',
successMsgKey: 'log_static_publish_success',
errorMsgKey: 'error_static_publish_failed'
);
}
}
if (! function_exists('createSettingsJsonSSE')) {
function createSettingsJsonSSE(): array
{
@@ -1859,6 +1880,9 @@ if (! function_exists('runInstallationTasks')) {
// complete_flag(installer_completed=true) 이후에 config 캐시를 최초 생성해야
// 설치가 config:cache 켜진 상태로 시작한다. best_effort — 실패해도 설치는 완료.
$tasks[] = ['id' => 'config_cache', 'function' => 'optimizeConfigCacheSSE', 'best_effort' => true];
// 부트스트랩 리소스 정적 게시(bake) 최초 수행 — 없으면 첫 방문자가
// 자가 치유(1회 API 폴백)를 겪는다. best_effort — 실패해도 설치는 완료.
$tasks[] = ['id' => 'static_publish', 'function' => 'publishStaticCacheSSE', 'best_effort' => true];
foreach ($tasks as $task) {
if (checkAbortStatusSSE()) {
+3
View File
@@ -280,6 +280,7 @@ return [
'task_create_settings_json' => 'Creating Settings Files',
'task_complete_flag' => 'Finalizing Installation',
'task_config_cache' => 'Building Configuration Cache',
'task_static_publish' => 'Publishing Static Bootstrap Resources',
'task_unknown' => 'Unknown Task',
// Task Group Names
@@ -382,10 +383,12 @@ return [
// Error Messages - Worker (Cache)
'error_cache_clear_failed' => 'Cache clearing failed',
'error_config_cache_failed' => 'Configuration cache build failed',
'error_static_publish_failed' => 'Static bootstrap resource publishing failed (site still works via API fallback)',
// Log Messages - Worker (Cache)
'log_cache_clear_success' => 'Cache clearing completed',
'log_config_cache_success' => 'Configuration cache built',
'log_static_publish_success' => 'Static bootstrap resources published',
// Error Messages - Worker (Settings JSON)
'error_settings_json_failed' => 'Settings file creation failed',
+3
View File
@@ -280,6 +280,7 @@ return [
'task_create_settings_json' => '설정 파일 생성',
'task_complete_flag' => '설치 완료 처리',
'task_config_cache' => '설정 캐시 생성',
'task_static_publish' => '부트스트랩 리소스 정적 게시',
'task_unknown' => '알 수 없는 작업',
// 작업 그룹명
@@ -382,10 +383,12 @@ return [
// 에러 메시지 - Worker (Cache)
'error_cache_clear_failed' => '캐시 클리어에 실패했습니다',
'error_config_cache_failed' => '설정 캐시 생성에 실패했습니다',
'error_static_publish_failed' => '부트스트랩 리소스 정적 게시에 실패했습니다 (사이트는 API 경로로 정상 동작합니다)',
// 로그 메시지 - Worker (Cache)
'log_cache_clear_success' => '캐시 클리어 완료',
'log_config_cache_success' => '설정 캐시 생성 완료',
'log_static_publish_success' => '부트스트랩 리소스 정적 게시 완료',
// 에러 메시지 - Worker (Settings JSON)
'error_settings_json_failed' => '설정 파일 생성에 실패했습니다',