feat(core): 모듈/플러그인 프론트엔드 에셋 서버측 번들 병합

활성 모듈/플러그인마다 프론트엔드 IIFE JS·CSS 가 개별 HTTP 요청으로 로드되어 확장 수에 비례해 요청이 늘어나는 오버헤드를, 종류별 1개 번들로 서버 병합해 줄인다. 각 확장 IIFE 자가등록 계약(핸들러/리스너/preblocker)은 priority 순 물리 병합으로 실행 순서가 보존되어 그대로 동작한다. ## 백엔드 - 신규 ExtensionBundleService — 정렬(uasort priority)·필터(global)·concat(\n;\n 구분자로 ASI 경계 보호)·소스맵(prod strip / dev rewrite)·version-in-path 디스크 캐시·확장별 fine-grained try/catch(한 확장 실패가 번들 전체를 붕괴시키지 않음) - AbstractModule/AbstractPlugin::getBuiltAssetAbsolutePaths — _bundled 경로 정확 해석용 절대경로 게터(getAssetFilePath 하드코딩 복제 회피) - PublicModule/PluginController::serveBundle{Js,Css} + routes/api.php 4개 (/api/{modules,plugins}/bundle.{js,css}?v={version}, fileResponse ETag/304 재사용) - config/filesystems.php ext-bundles 디스크 + storage/.gitignore + 루트 .gitignore - 신규 ext-bundles:cleanup 커맨드 + {module,plugin,template}:cache-clear 번들 정리 통합 + dev-dashboard 버튼 ## 프론트엔드 (engine-v1.52.0) - TemplateApp.loadExtensionAssets — 개별 로딩 → bundleUrls 기반 모듈→플러그인 순 번들 로딩. bundleUrls 부재 시 개별 로딩 폴백(회귀 안전) - ModuleAssetLoader.loadBundle + parseBundleUrlsFromConfig + ExtensionBundleUrls - TemplateComposer/UserTemplateComposer bundleUrls 뷰변수 + app/admin.blade.php - core:build 재빌드 산출물(public/build/core/*) ## 버전 - 코어 7.0.1 → 7.0.2 bump. 7.0.1 이 이미 2026-07-03 공개 릴리스이므로 그 위 신규 기능은 +1 bump(new-bump). config/app.php(SSoT) + .env{.example,.testing.example, .testing} + README 뱃지 + INSTALL 예시 + 루트 CHANGELOG 신규 [7.0.2] 섹션 동기화. - 확장 g7_version 상향 안 함(>=7.0.0 유지) — 6개 프론트 에셋 확장이 신규 코어 표면을 자기 코드에서 호출하지 않고 개별 서빙 라우트 존치+프론트 폴백으로 코어 7.0.0 에서도 동작 → 실제 의존 없음( 결정). - 부수 결함 수정: config/app.php 편집으로 활성화된 core-update-targets-coverage 룰이 v1.51.0 에서 추가된 vite.config.{editor,devtools}.js 가 app.update.targets 에 미등재됨을 검출 → 추가. 코어 업데이트 시 편집기/devtools 빌드 설정 갱신 누락 방지(CHANGELOG [7.0.2] Fixed). ## 규정/audit/문서/테스트 - ("확장 번들 병합" 절+파일유형표+E2E경로) / AGENTS.md / docs/extension/module-assets.md / docs/cheatsheet.md - coverage.json 4항목 + codified 룰 4종(url-same-origin, concat-separator, asset-path-getter, clears-template-caches-no-file-delete) - 루트 CHANGELOG [7.0.2] Added/Fixed / 엔진 CHANGELOG engine-v1.52.0 Added - Vitest 11(loadBundle + concat 자가등록) + PHPUnit 17(Service 12 + Feature 5) + Playwright spec + 시나리오 매니페스트 - 브라우저 실측(g7.dev): 홈/관리자 번들 각 1건·개별 iife 0건, gdpr 인터셉터 정상, 활성화 토글 반영, 장바구니→체크아웃·게시판 글쓰기 정상. g7_2.dev 미적용 대비 확장 요청 11~12→4건, DOMContentLoaded ~843~957→605~741ms(페이로드 무손실) ## 도구 보완 - pre-commit-review 스킬 에 엔진 경로 감지 게이트(5-pre + 보고 5e행) 신설 — 매핑 표에 엔진 파일이 있으면 엔진 CHANGELOG 판정을 강제(이번 초기 누락 재발 방지)
2026-07-05 21:57:39 +09:00
parent 7c18adc09d
commit a958443d69
40 changed files with 1766 additions and 59 deletions
@@ -0,0 +1,78 @@
+/**
+ * E2E: 확장 프론트엔드 병합 번들 로딩 회귀 검증
+ *
+ * @scenario extension-bundle-loading
+ * @effects bundle_js_requested_once_per_type, individual_iife_requests_absent,
+ *          gdpr_interceptor_still_active, extension_handlers_registered
+ *
+ * 배경: 활성 모듈/플러그인 IIFE 를 서버측에서 종류별 1개 번들로 병합 서빙한다.
+ * 실제 페이지 로드 시 (1) 개별 `*.iife.js` 요청이 사라지고 `bundle.js` 로 대체되는지,
+ * (2) gdpr preblocker 가 여전히 유효한지(병합 후 race 회귀 없음), (3) 확장 자가등록
+ * (핸들러/레지스트리)이 정상 동작하는지 실측한다.
+ */
+import { test, expect } from '@playwright/test';
+
+test.describe('확장 병합 번들 로딩', () => {
+  test('@smoke 홈페이지 로드 시 개별 iife 대신 병합 번들이 요청된다', async ({ page }) => {
+    const requestedUrls: string[] = [];
+    page.on('request', (req) => {
+      requestedUrls.push(req.url());
+    });
+
+    await page.goto('/');
+    await page.waitForLoadState('networkidle', { timeout: 30_000 });
+
+    const moduleBundle = requestedUrls.filter((u) => /\/api\/modules\/bundle\.js/.test(u));
+    const pluginBundle = requestedUrls.filter((u) => /\/api\/plugins\/bundle\.js/.test(u));
+
+    // 활성 확장이 있으면 번들이 요청되고, 종류별로 1건씩만 나가야 한다
+    const individualIife = requestedUrls.filter((u) => /\/api\/(modules|plugins)\/assets\/.*\.iife\.js/.test(u));
+
+    // 개별 iife 직접 요청은 0건 (번들로 대체)
+    expect(individualIife, `개별 iife 요청이 남아있음: ${individualIife.join(', ')}`).toHaveLength(0);
+
+    // 번들이 요청됐다면 종류별 최대 1건 (중복 가드)
+    expect(moduleBundle.length, '모듈 번들 중복 요청').toBeLessThanOrEqual(1);
+    expect(pluginBundle.length, '플러그인 번들 중복 요청').toBeLessThanOrEqual(1);
+  });
+
+  test('@smoke 병합 번들 응답이 정상(200/304)이고 same-origin 이다', async ({ page }) => {
+    const bundleResponses: { url: string; status: number }[] = [];
+    page.on('response', (res) => {
+      if (/\/api\/(modules|plugins)\/bundle\.(js|css)/.test(res.url())) {
+        bundleResponses.push({ url: res.url(), status: res.status() });
+      }
+    });
+
+    await page.goto('/');
+    await page.waitForLoadState('networkidle', { timeout: 30_000 });
+
+    for (const r of bundleResponses) {
+      expect([200, 304], `번들 응답 비정상: ${r.url} → ${r.status}`).toContain(r.status);
+      // same-origin (/api/...) — CDN/외부 origin 금지 (gdpr preblocker 자기차단 방지)
+      const origin = new URL(page.url()).origin;
+      expect(r.url.startsWith(origin), `번들 URL 이 same-origin 아님: ${r.url}`).toBe(true);
+    }
+  });
+
+  test('@smoke 확장 병합 로드 후 페이지가 정상 렌더된다 (자가등록 계약)', async ({ page }) => {
+    const consoleErrors: string[] = [];
+    page.on('console', (msg) => {
+      if (msg.type() === 'error') {
+        consoleErrors.push(msg.text());
+      }
+    });
+
+    await page.goto('/');
+    await page.waitForLoadState('networkidle', { timeout: 30_000 });
+
+    // 홈 네비게이션이 렌더되면 템플릿 엔진 + 확장 자가등록이 정상 작동한 것
+    await expect(page.getByTestId('nav-home')).toBeVisible({ timeout: 15_000 });
+
+    // 번들 파싱 에러(ASI 경계 붕괴)가 있으면 "Unexpected token" 등 콘솔 에러가 뜬다
+    const parseErrors = consoleErrors.filter((e) =>
+      /Unexpected token|SyntaxError|is not defined|Unknown action handler/i.test(e),
+    );
+    expect(parseErrors, `번들 실행 관련 콘솔 에러: ${parseErrors.join(' | ')}`).toHaveLength(0);
+  });
+});