## 소스맵 노출 차단 (공개 이슈 )
배포본에 .map 이 포함돼 원본 TS/TSX 전문(sourcesContent, 한글 주석 포함)이
그대로 노출됐다. 생성·서빙·저장소 유입 3계층을 모두 막는다.
- 빌드 config 15곳(코어 3 + _bundled 12): sourcemap 하드코딩 제거.
G7_BUILD_SOURCEMAP 판정식으로 교체 — 미설정(로컬 npm run build)이면 생성해
개발 디버깅 경험을 보존하고, 0 이면 미생성.
- Build{Core,Module,Plugin,Template}Command: 죽어 있던 --production 플래그 복구.
$productionMode 를 콘솔 문자열에만 쓰고 npm 프로세스에 env 를 넘기지 않아
산출물이 개발 빌드와 동일했다. runNpmCommand 에 $env 를 추가해 주입
(--watch 에는 미주입). Symfony Process 는 부모 환경에 병합하므로 PATH 유실 없음.
- Allowed{Module,Plugin}FileType / {Module,Plugin}Service::getMimeType:
허용 확장자 map 제거 — 익명 200 서빙 차단(템플릿은 원래 미허용, 3종 정책 일치).
- ExtensionBundleService: CSS 번들의 /*# sourceMappingURL=... */ strip 추가.
CSS 는 블록 주석이라 JS 의 //# 패턴으로는 검출되지 않던 구멍.
- 추적 .map 13개 삭제 + .gitignore 전역 *.map 규칙(경로 한정 시 새 확장에서 누락).
실측: 산출 JS 의 sourceMappingURL 13 → 0, 추적 .map 13 → 0,
확장 디렉토리 npm run build 는 여전히 map 생성(개발 경험 회귀 없음).
## 관리자 환경설정 탭 지연 로딩
코어/이커머스/게시판 환경설정 화면이 진입 즉시 전 탭의 데이터소스를 한꺼번에
호출했다. 각 데이터소스에 활성 탭 조건(if)을 걸어 해당 탭에서만 fetch 하도록
변경하고, 결제 플러그인 3종의 테스트모드 상태 조회도 주문설정 탭으로 한정.
## 동반 결함 수정 (무관 결함 — 재발 방지 목적으로 같은 세션 처리)
- 나이스페이먼츠: 체크아웃 캐시 프리페치가 라우트를 가리지 않아 플러그인 번들이
로드되는 모든 페이지(홈/게시판/로그인)에서 주문서를 조회 → 비회원 매번 422.
형제 플러그인(kginicis)의 기존 가드 패턴을 적용해 체크아웃 경로로 한정.
- admin smoke 8건: 대부분 구현이 아니라 테스트 결함이었다 — URL 오타(단수 board),
존재하지 않는 권한키, 앱 로케일이 en 인데 한국어 라벨 로케이터, DataGrid 버튼을
먼저 잡던 휴리스틱 로케이터. 레이아웃에는 sticky className / 안정 id 를 부여.
- PHPDoc ↔ Pint 충돌 3건: 설명 없는 @param 은 no_superfluous_phpdoc_tags 가
삭제해 audit phpdoc-public-method 와 무한 충돌. 한국어 설명을 붙여 양쪽 충족
(리스너 3종의 설명 누락 메서드도 전수 보강).
- Log::spy 500 3건: spy 가 Log::channel('activity') 를 null 로 만들고
logActivity 가 null->info 로 \Error → 같은 줄 catch(\Exception) 은 못 잡아
통과. 운영에선 채널이 항상 로거이므로 제품 무결 → 테스트에 activity 채널
보존 헬퍼 추가.
- NhnKcpApiServiceTest 5건: 스텁이 Unix 바이너리만 만들어 Windows 분기
(pp_cli_exe.exe)에서만 실패. #!/bin/sh 는 Windows 실행 불가 → 파일 내 기존
컨벤션대로 skip 가드.
## 테스트
- 소스맵 범위 130 passed (신규: BuildCommandSourcemapEnv, NoSourcemapArtifacts,
ExtensionBundleService CSS strip, Allowed*FileType 반전, 자산 서빙 거부)
- 결제 3플러그인 505 passed / 0 failed (skipped 9 = Windows 전용 CLI, 사유 명시)
- 나이스페이먼츠 프론트 38 passed (가드 제거 시 red 실증 후 복원)
- E2E: production-sourcemap-exposure.spec.ts 6건 + 시나리오 매니페스트
버전: sirsoft-admin_basic 1.0.2 → 1.0.3, sirsoft-board 1.0.1 → 1.0.2
(각 manifest/package/lock/composer 동기화). 코어 7.0.4 는 미출시 누적.
67 lines
3.5 KiB
YAML
67 lines
3.5 KiB
YAML
# audit:allow test-scenario-coverage reason: 프로덕션 소스맵 노출 차단(하드닝). 입력 axis(빌드 모드·확장 종류·에셋 종류) cross-product 는 test_files 의 Unit/Feature 가 cover 하고, effects 는 3중 방어선(생성 차단 / 서빙 차단 / 저장소 유입 차단)과 브라우저 실측(맵 요청 부재·렌더 정상)을 enumerate.
|
|
|
|
feature: 프로덕션 소스맵 노출 차단 (코어 + 전 확장)
|
|
|
|
description: |
|
|
소스맵(.map)은 sourcesContent 에 원본 TS/TSX 전문(주석 포함)을 담는다. 기존에는
|
|
모든 vite config 가 sourcemap: true 를 하드코딩하고 `--production` 플래그가 실효가
|
|
없어, 배포 산출물에 맵이 그대로 실리고 익명 요청으로 서빙됐다.
|
|
|
|
3중 방어선으로 차단한다:
|
|
- 생성 차단: `--production` → Build{Core,Module,Plugin,Template}Command 가
|
|
G7_BUILD_SOURCEMAP=0 을 npm 프로세스 env 로 주입 → 각 vite config 의 인라인
|
|
판정식이 sourcemap:false → 맵 파일도, sourceMappingURL 주석도 생성되지 않음
|
|
- 서빙 차단: 모듈/플러그인 허용 확장자에서 map 제거 (템플릿은 원래 미허용)
|
|
→ 3종 정책 일치. 디스크에 맵이 실재해도 서빙 거부
|
|
- 유입 차단: .gitignore 전역 `*.map` + 기존 추적 맵 13개 제거
|
|
→ 공개 release 배포판에 맵이 실리지 않음
|
|
|
|
개발 경험은 보존한다: 환경변수 미설정(로컬 `npm run build`, --watch)이면 기본값
|
|
true 로 맵이 생성된다.
|
|
|
|
axes:
|
|
build_mode: [production, non_production, watch]
|
|
extension_type: [core, module, plugin, template]
|
|
asset_kind: [js, css]
|
|
sourcemap_env: [unset, zero, false_literal]
|
|
map_file_on_disk: [present, absent]
|
|
serving_target: [module_asset, plugin_asset, template_asset, core_webroot]
|
|
bundle_environment: [production, non_production]
|
|
|
|
exclusions:
|
|
- { build_mode: watch, sourcemap_env: zero, reason: "감시 모드에는 억제를 주입하지 않는다 — 개발 중 디버깅 필요" }
|
|
- { extension_type: core, serving_target: module_asset, reason: "코어 번들은 웹루트 직접 서빙 — 확장 에셋 라우트를 타지 않음" }
|
|
|
|
effects:
|
|
# 생성 차단 (빌드)
|
|
- production_build_injects_sourcemap_off_env
|
|
- non_production_build_injects_nothing
|
|
- watch_mode_does_not_inject_sourcemap_off
|
|
- run_npm_command_accepts_env_and_merges_with_parent_environment
|
|
- vite_config_defaults_to_sourcemap_on_when_env_unset
|
|
# 서빙 차단
|
|
- module_sourcemap_asset_request_rejected_even_when_file_exists
|
|
- plugin_sourcemap_asset_request_rejected_even_when_file_exists
|
|
- sourcemap_content_never_present_in_rejection_response
|
|
- allowed_file_types_aligned_across_module_plugin_template
|
|
# 번들 서비스
|
|
- prod_strips_js_source_mapping_url
|
|
- prod_strips_css_source_mapping_url
|
|
- dev_keeps_css_source_mapping_url
|
|
- css_style_body_preserved_when_stripping_comment
|
|
# 저장소 유입 차단
|
|
- no_sourcemap_files_tracked_by_git
|
|
- gitignore_actually_ignores_sourcemap_files
|
|
- tracked_build_output_has_no_source_mapping_url
|
|
# 브라우저 실측
|
|
- no_sourcemap_requests_from_loaded_bundles
|
|
- page_renders_without_map_related_console_errors
|
|
|
|
test_files:
|
|
- tests/Unit/Extension/BuildCommandSourcemapEnvTest.php
|
|
- tests/Unit/Extension/NoSourcemapArtifactsTest.php
|
|
- tests/Unit/Services/ExtensionBundleServiceTest.php
|
|
- tests/Feature/Module/ModuleAssetServingTest.php
|
|
- tests/Feature/Plugin/PluginAssetServingTest.php
|
|
- tests/Playwright/specs/production-sourcemap-exposure.spec.ts
|