docs(core,scripts): 요구사항 선언과 실제 검증 범위 정합화 + 내부 하네스 3건

요구사항 문서가 "지원한다"고 선언한 항목과 실제로 검증되는 범위가 어긋나 있었다.
지원 브라우저 3종 "최신 2개 버전" 선언에 비해 자동 테스트는 Chromium 단일이었고,
같은 형태의 불일치가 문서 전반에 있었다 — 디스크 700MB↔게이트 500MB, 확장 33개
필수 선언↔게이트 14개, HTTPS "필수"↔비차단 경고.

선언을 낮추는 대신 검증 수준을 명시하는 방향으로 정리했다. 항목마다 "설치 프로그램이
자동 검사" 와 "운영자 확인 필요" 를 구분하는 절(§9)을 두어, 이슈가 지적한 질문
("지원 선언이 어느 수준의 검증을 의미하는가")을 문서 전반으로 일반화했다.

조사 중 드러난 내부 하네스 결함 3건도 함께 고쳤다.
- 테스트 스코프 훅이 npm run test:e2e:smoke 를 오차단 — 필터가 package.json 안에
 있어 명령 문자열에서 보이지 않았다. 회귀 케이스 3건 red 확인 후 수정
- 브라우저 테스트 안내 문서가 없어진 스크립트·디렉토리를 가리키고 있었다
- E2E 동반 강제 룰의 확장 config 경로 패턴이 실제 경로와 달라, 확장 8개의 config
 변경이 인정되지 않았다

E2E 브라우저 확대는 하지 않는다 — 도입 조건만 문서에 못박았다.

CHANGELOG.md

@@ -21,6 +21,9 @@
 - 공개 자산을 외부 주소(CDN)로 서빙할 때, 그 주소로 나가는 요청에는 로그인 토큰을 함께 보내지 않습니다 — 공개 자산은 인증이 필요 없고, 토큰이 외부 서비스로 전달되지 않아야 하기 때문입니다. 사이트 자신의 주소로 가는 요청은 종전과 동일합니다.
 - 확장 개발자용: 확장 캐시 계약 인터페이스에 카테고리별 스토리지 접근이 추가되었습니다. 코어가 제공하는 확장 베이스 클래스·서비스 프로바이더를 상속하는 확장은 수정 없이 호환되지만, 이 계약을 직접 구현하는 확장은 새 메서드를 구현해야 합니다 (번들 확장은 모두 반영 완료 — 최소 요구 코어 버전 7.0.7).
 - 예약 작업의 실행 시각이 환경설정의 시간대를 기준으로 해석되도록 바꿨습니다. 종전에는 세계표준시 기준이어서 '새벽 4시'로 등록해도 국내 기준 낮에 실행됐습니다. 이번 변경으로 새로 추가된 자동 정리 작업은 물론, 기존 사이트맵 자동 생성·GeoIP 갱신·확장이 제공하는 예약 작업, 관리자가 직접 등록한 예약 작업까지 모두 같은 기준을 따릅니다. **시각을 지정해 둔 예약은 실제 실행 시각이 이동하므로 확인이 필요합니다.**
+- 시스템 요구사항 문서를 실제 검증 기준에 맞게 정비했습니다. 지원 브라우저 항목에 검증 방식을 명시하고(자동 테스트는 Chromium 기준이며, Firefox·Safari 는 프론트엔드 의존성의 호환 범위를 기준으로 지원합니다), PHP 확장을 필수와 기능별 선택으로 구분했으며, 설치 프로그램이 자동으로 검사하는 항목과 운영자가 직접 확인해야 하는 항목을 구분하는 절을 새로 두었습니다. "요구사항" 이라고 적힌 항목이 모두 설치 단계에서 검사되는 것은 아니라는 점이 이제 문서에 드러납니다. (#95 @glitter-gim 님께서 제보해주셨습니다.)
+- 문서 사이에 어긋나 있던 수치와 표기를 정정했습니다 — 디스크 용량 기준(설치 검사 기준 500MB), PHP 확장 개수, 지원 운영체제에 Windows 개발 환경 추가, 데이터베이스 표기에 MariaDB 병기, 한국어 README 의 시스템 요구사항 항목 보완, 그리고 데이터베이스 접두어 길이 제한·collation 변경 가능 여부처럼 실제로는 동작하지만 문서에 없던 조건의 추가.
+- 확장 개발자용: 배포본에 함께 들어가는 브라우저 테스트 안내 문서가 실제 디렉토리 구성 및 실행 스크립트와 어긋나 있던 부분을 정정했습니다.
 
 ### Fixed
 

INSTALL.md

@@ -8,7 +8,7 @@
 
 | 항목 | 요구사항 |
 |------|---------|
-| **PHP** | 8.2 이상 (필수 확장 30개 포함) |
+| **PHP** | 8.2 이상 (필수 확장 16개 포함 — 기능별 선택 확장은 별도) |
 | **데이터베이스** | MySQL 8.0+ 또는 MariaDB 10.3+ (utf8mb4) |
 | **Composer** | 2.x |
 | **Redis** | 6.0+ (프로덕션 권장, 선택) |

README.ko.md

@@ -71,7 +71,7 @@ Laravel과 React를 기반으로, 보안부터 아키텍처까지 처음부터
 
 | 구분 | 기술 |
 |------|------|
-| **백엔드** | PHP 8.2+, Laravel 12.x, MySQL 8.0+, Redis 6.0+ |
+| **백엔드** | PHP 8.2+, Laravel 12.x, MySQL 8.0+ / MariaDB 10.3+, Redis 6.0+ |
 | **프론트엔드** | React 19, Vite, Tailwind CSS 4 (다크 모드 지원) |
 | **인증** | Laravel Sanctum (Bearer 토큰) |
 | **테스트** | PHPUnit 11.x, Vitest |
@@ -353,10 +353,12 @@ HookManager::doAction('sirsoft-ecommerce.order.after_confirm', $order);
 
 ### 시스템 요구사항
 
-- PHP 8.2+ (필수 확장 30개 포함)
+- PHP 8.2+ (필수 확장 16개 포함 — `ctype`, `curl`, `dom`, `fileinfo`, `json`, `mbstring`, `openssl`, `pdo_mysql`, `tokenizer`, `xml`, `zip` 등. `gd`/`imagick`, `intl`, `redis`, `bcmath` 등은 해당 기능을 쓸 때만 필요하며 전체 목록은 [docs/requirements.md](docs/requirements.md) 참조)
 - MySQL 8.0+ 또는 MariaDB 10.3+ (utf8mb4)
-- Node.js 20+ (빌드 시에만 필요)
 - Composer 2.x
+- Node.js 20+ (프론트엔드 에셋을 직접 빌드할 때만 필요)
+- 웹 서버(Apache 또는 Nginx) — 문서 루트를 `public/` 으로 지정
+- Redis 6.0+ (선택 — 프로덕션의 캐시·큐에 권장)
 
 ### 설치
 

README.md

@@ -75,7 +75,7 @@ Everything a modern web platform needs, built in.
 
 | Layer | Technology |
 |-------|------------|
-| **Backend** | PHP 8.2+, Laravel 12.x, MySQL 8.0+, Redis 6.0+ |
+| **Backend** | PHP 8.2+, Laravel 12.x, MySQL 8.0+ / MariaDB 10.3+, Redis 6.0+ |
 | **Frontend** | React 19, Vite, Tailwind CSS 4 (dark mode supported) |
 | **Authentication** | Laravel Sanctum (Bearer tokens) |
 | **Testing** | PHPUnit 11.x, Vitest |
@@ -359,7 +359,7 @@ Every verification point — signup, password reset, sensitive operations, the m
 
 ### System requirements
 
-- PHP 8.2+ with the required extensions (30 in total), including `bcmath`, `ctype`, `curl`, `dom`, `fileinfo`, `gd`, `intl`, `mbstring`, `openssl`, `pdo_mysql`, `tokenizer`, `xml`, and `zip`
+- PHP 8.2+ with the required extensions (16 in total), including `ctype`, `curl`, `dom`, `fileinfo`, `json`, `mbstring`, `openssl`, `pdo_mysql`, `tokenizer`, `xml`, and `zip`. Additional extensions (`gd`/`imagick`, `intl`, `redis`, `bcmath`, and others) are optional and only needed for the features that use them — see [docs/requirements.md](docs/requirements.md)
 - MySQL 8.0+ or MariaDB 10.3+ (utf8mb4)
 - Composer 2.x
 - Node.js 20+ (only needed when building frontend assets)

docs/requirements.md

@@ -7,9 +7,9 @@
 ```text
 1. PHP 8.2+ 필수
 2. MySQL 8.0+ 또는 MariaDB 10.3+ (utf8mb4, utf8mb4_unicode_ci)
-3. PHP 필수 모듈 30개 (ctype, curl, gd, intl, redis, imagick 등)
-4. 하드웨어: 최소 2 vCPU·2GB / 권장 4 vCPU·8GB, 디스크 최소 700MB / 권장 2GB+
-5. 프로덕션: HTTPS 필수, Redis 권장, 큐 워커/스케줄러/Reverb 데몬 필요
+3. PHP 확장: 필수 16개 + 기능별 선택 17개 (설치 단계 자동 검사는 그중 14개)
+4. 하드웨어: 최소 2 vCPU·2GB / 권장 4 vCPU·8GB, 디스크: 설치 검사 기준 500MB, 권장 2GB+
+5. 프로덕션: HTTPS 필수(설치는 차단하지 않고 경고), Redis 권장, 큐 워커/스케줄러/Reverb 데몬 필요
 ```
 
 ---
@@ -21,6 +21,7 @@
 | OS | 지원 수준 | 비고 |
 |----|----------|------|
 | Linux (Ubuntu 22.04+, CentOS/RHEL 8+) | 프로덕션 권장 | 가장 안정적 |
+| Windows | 개발 환경 지원 | XAMPP/Laragon 등 (§1.3.1, [INSTALL.md](../INSTALL.md) 참조) |
 
 ### 1.2 웹서버
 
@@ -34,10 +35,13 @@
 
 ### 1.3 PHP
 
-| 항목 | 요구사항                                                    |
-|------|-------------------------------------------------------------|
-| 버전 | **8.2 이상** (`^8.2`)                                       |
-| SAPI | FPM (권장) 또는 mod_php (Apache + mod_fcgid 환경은 §1.3.1)  |
+| 항목 | 요구사항 |
+|------|---------|
+| 버전 | **8.2 이상** (`^8.2`) |
+| SAPI | FPM (권장) 또는 mod_php (Apache + mod_fcgid 환경은 §1.3.1) |
+| `disable_functions` | `exec`·`proc_open`·`shell_exec` 허용 필요 (설치·코어 업데이트가 자식 프로세스를 실행) |
+| 웹 ↔ CLI 버전 | 메이저·마이너 버전 일치 권장 (설치 프로그램이 확인 후 불일치 시 안내) |
+| OPcache | 활성화 권장 (성능 — 미활성화 시 설치는 진행되고 안내만 표시) |
 
 #### 1.3.1 Apache + mod_fcgid 환경 추가 설정 (권장)
 
@@ -53,43 +57,52 @@ FcgidOutputBufferSize 0
 - 인스톨러 SSE 호환성 사전 체크가 buffered 환경으로 자동 판정되어 폴링 모드로 fallback
 - 폴링 모드 응답은 코드 레벨 64KB padding 워크어라운드로 동작은 보장되나, SSE 모드가 아닌 1초 간격 폴링으로 진행 상황이 표시됨
 
-### 1.4 PHP 필수 확장 모듈
+### 1.4 PHP 확장 모듈
 
-| 모듈 | 용도 |
-|------|------|
-| `bcmath` | 정밀 수학 연산 (가격 계산 등) |
-| `ctype` | 문자 타입 검사 |
-| `curl` | HTTP 클라이언트 |
-| `dom` | XML/HTML DOM 처리 |
-| `exif` | 이미지 메타데이터 읽기 |
-| `fileinfo` | MIME 타입 감지 |
-| `filter` | 데이터 필터링/검증 |
-| `gd` | 이미지 처리 (썸네일, 리사이징) |
-| `hash` | 해시 함수 |
-| `imagick` | 고급 이미지 처리 (ImageMagick) |
-| `intl` | 국제화 (다국어, 날짜/숫자 포맷) |
-| `json` | JSON 인코딩/디코딩 |
-| `ldap` | LDAP 인증 연동 |
-| `libxml` | XML 파싱 기반 라이브러리 |
-| `maxminddb` | GeoIP 데이터베이스 조회 |
-| `mbstring` | 멀티바이트 문자열 처리 |
-| `memcached` | Memcached 캐시 드라이버 |
-| `openssl` | 암호화/복호화 (AES-256-CBC) |
-| `pcntl` | 프로세스 제어 (큐 워커) |
-| `pcre` | 정규 표현식 |
-| `pdo` | 데이터베이스 추상화 |
-| `pdo_mysql` | MySQL/MariaDB PDO 드라이버 |
-| `phar` | Phar 아카이브 (Composer) |
-| `posix` | POSIX 함수 (프로세스 관리) |
-| `redis` | Redis 캐시/세션/큐 드라이버 |
-| `session` | 세션 관리 |
-| `simplexml` | 간편 XML 파싱 |
-| `sodium` | 최신 암호화 라이브러리 |
-| `tokenizer` | PHP 토큰 파싱 |
-| `xml` | XML 파서 |
-| `xmlwriter` | XML 문서 생성 |
-| `zip` | ZIP 압축/해제 |
-| `zlib` | 데이터 압축 |
+필수 16개 + 기능별 선택 17개.
+
+| 구분 | 모듈 | 용도 |
+|------|------|------|
+| 필수 | `ctype` | 문자 타입 검사 |
+| 필수 | `curl` | HTTP 클라이언트 |
+| 필수 | `dom` | XML/HTML DOM 처리 (메일 본문 인라인 CSS 등) |
+| 필수 | `fileinfo` | MIME 타입 감지 |
+| 필수 | `filter` | 데이터 필터링/검증 |
+| 필수 | `hash` | 해시 함수 |
+| 필수 | `json` | JSON 인코딩/디코딩 |
+| 필수 | `mbstring` | 멀티바이트 문자열 처리 |
+| 필수 | `openssl` | 암호화/복호화 (AES-256-CBC) |
+| 필수 | `pcre` | 정규 표현식 |
+| 필수 | `pdo` | 데이터베이스 추상화 |
+| 필수 | `pdo_mysql` | MySQL/MariaDB PDO 드라이버 |
+| 필수 | `session` | 세션 관리 |
+| 필수 | `tokenizer` | PHP 토큰 파싱 |
+| 필수 | `xml` | XML 파서 |
+| 필수 | `zip` | 확장·언어팩·코어 업데이트 패키지의 압축 해제 |
+| 선택 | `gd` | 이미지 처리 (썸네일, 리사이징) — `imagick` 과 택일 |
+| 선택 | `imagick` | 고급 이미지 처리 (ImageMagick) — `gd` 와 택일 |
+| 선택 | `exif` | 이미지 메타데이터 읽기 |
+| 선택 | `intl` | 국제화 (다국어 날짜/숫자 포맷) |
+| 선택 | `bcmath` | 정밀 수학 연산 (금액 계산 등) |
+| 선택 | `redis` | Redis 캐시/세션/큐 드라이버 (`predis` 동봉 — 확장 없이도 사용 가능) |
+| 선택 | `memcached` | Memcached 캐시 드라이버 |
+| 선택 | `pcntl` | 큐 워커 전체 기능 및 콘솔 시그널 처리 |
+| 선택 | `posix` | 큐 워커 전체 기능 및 코어 업데이트의 파일 소유자 확인 |
+| 선택 | `maxminddb` | GeoIP 데이터베이스 조회 (접속 국가·타임존 감지) |
+| 선택 | `simplexml` | AWS SDK(S3/SES/SQS) 응답 파싱 |
+| 선택 | `libxml` | XML 파싱 기반 라이브러리 (`dom`·`simplexml` 의 토대) |
+| 선택 | `sodium` | 최신 암호화 라이브러리 |
+| 선택 | `phar` | Phar 아카이브 (Composer 실행) |
+| 선택 | `xmlwriter` | XML 문서 생성 |
+| 선택 | `zlib` | 데이터 압축 (gzip 응답 압축) |
+| 선택 | `ldap` | LDAP 연동 확장을 사용할 때 (코어 기본 기능은 사용하지 않음) |
+
+설치 프로그램은 위 필수 확장 중 14개(`pdo`, `mbstring`, `openssl`, `tokenizer`, `xml`,
+`ctype`, `json`, `fileinfo`, `curl`, `dom`, `filter`, `hash`, `pcre`, `session`)를 설치
+단계에서 자동 검사하고 하나라도 없으면 진행을 막는다. `pdo_mysql` 과 `zip` 은 자동 검사
+대상이 아니지만 각각 데이터베이스 접속과 확장·언어팩 설치에 반드시 필요하므로 필수로
+분류한다. 선택 확장은 해당 기능을 사용하는 시점에 필요하며, 자동 검사 항목과 운영자가
+직접 확인해야 하는 항목의 전체 구분은 §9 를 참조한다.
 
 ### 1.5 PHP 설정 권장값 (php.ini)
 
@@ -150,6 +163,17 @@ sudo chmod -R 755 storage bootstrap/cache vendor modules plugins templates
 
 인스톨러의 기본 안내 명령은 보수적으로 `chmod -R 755` 를 제시한다. 방식 A 로 운영하려면 인스톨 완료 후 `775` 로 재조정 + 소유자/그룹을 본인 계정 + `www-data` 로 변경. 인스톨러는 `chmod` 를 직접 호출하지 않으므로 운영자가 쉘에서 1회 실행.
 
+### 1.7 개발/빌드 도구
+
+| 도구 | 버전 | 필요한 경우 |
+|------|------|------------|
+| Node.js | 20 이상 | 프론트엔드 소스를 직접 빌드할 때 |
+| Composer | 2.x | Composer 로 의존성을 설치할 때, 확장이 외부 패키지를 요구할 때 |
+
+배포본에는 빌드 산출물과 `vendor` 디렉토리가 동봉되어 있으므로 **일반적인 운영 설치에는
+두 도구 모두 필요하지 않다.** 소스에서 직접 빌드하거나 개발 환경을 구성할 때, 또는
+Composer 설치 방식을 선택할 때만 필요하다.
+
 ---
 
 ## 2. 데이터베이스
@@ -166,8 +190,8 @@ sudo chmod -R 755 storage bootstrap/cache vendor modules plugins templates
 | 항목 | 값 | 비고 |
 |------|-----|------|
 | charset | `utf8mb4` | 이모지 등 4바이트 문자 지원 |
-| collation | `utf8mb4_unicode_ci` | 유니코드 정렬 |
-| 테이블 접두어 | `g7_` (기본값) | `.env`에서 `DB_PREFIX`로 변경 가능 |
+| collation | `utf8mb4_unicode_ci` | 기본값이며 `.env`의 `DB_COLLATION`으로 변경 가능 |
+| 테이블 접두어 | `g7_` (기본값) | `.env`에서 `DB_PREFIX`로 변경 가능 (최대 6자 — 자동 생성 인덱스명이 MySQL 식별자 한도 64자를 넘지 않도록 제한) |
 
 **선택 기능**:
 - Write/Read 분리: Master-Replica 구성 지원 (`DB_WRITE_*` / `DB_READ_*` 환경 변수)
@@ -210,7 +234,7 @@ sudo chmod -R 755 storage bootstrap/cache vendor modules plugins templates
 
 | 수준 | 용량 | 포함 범위 |
 |------|------|----------|
-| 최소 | **700MB** | 코어 + 기본 확장 |
+| 최소 | **500MB** (설치 프로그램 검사 기준) | 설치가 진행되기 위한 여유 공간의 하한. 코어 + 기본 확장의 실사용은 약 700MB 이므로 여유 확보 권장 |
 | 권장 | **2GB 이상** | 코어 + 확장 + 첨부파일 + 캐시 + 로그 |
 
 - 사용자 업로드 파일, 로그, 캐시 등은 별도 용량 산정 필요
@@ -270,6 +294,8 @@ sudo chmod -R 755 storage bootstrap/cache vendor modules plugins templates
 |------|---------|
 | 프로덕션 | **HTTPS 필수** |
 
+- 설치 단계에서는 HTTPS 여부를 경고로 안내하며 설치를 차단하지 않는다. 정책상 필수라는
+  선언은 유지하되, 자동으로 강제되지는 않으므로 운영자가 직접 확인해야 한다
 - Laravel Reverb WebSocket도 `wss://` 프로토콜 사용 (`REVERB_SCHEME=https`)
 - Sanctum 세션 인증 시 `SESSION_SECURE_COOKIE=true` 설정 권장
 
@@ -294,13 +320,17 @@ sudo chmod -R 755 storage bootstrap/cache vendor modules plugins templates
 
 ## 7. 지원 브라우저
 
-| 브라우저 | 지원 범위 |
-|---------|----------|
-| Chrome / Edge | 최신 2개 버전 |
-| Firefox | 최신 2개 버전 |
-| Safari | 최신 2개 버전 |
+| 브라우저 | 지원 기준 | 검증 방식 |
+|---------|----------|----------|
+| Chrome / Edge | React 19 + Tailwind CSS 4 호환 범위 | 자동 브라우저 테스트(Chromium)로 상시 검증 |
+| Firefox | React 19 + Tailwind CSS 4 호환 범위 | 호환 범위 기준 지원 (상시 자동 테스트 대상 아님) |
+| Safari | React 19 + Tailwind CSS 4 호환 범위 | 호환 범위 기준 지원 (상시 자동 테스트 대상 아님, 실기기 검증 미수행) |
 
-- React 19 + Tailwind CSS 4 호환 범위 기준
+- 지원 하한은 프론트엔드 핵심 의존성(React 19, Tailwind CSS 4)의 공식 지원 브라우저
+  범위를 따르며, 해당 의존성 버전이 변경되면 이 기준도 함께 재검토한다
+- 참고: 2026-08 현재 Tailwind CSS 4 의 공식 하한은 Chrome 111 / Safari 16.4 / Firefox 128 이다
+- 자동 테스트는 테스트 도구에 포함된 단일 브라우저 빌드로 수행하므로 특정 버전
+  목록(예: "최신 N개 버전")을 상시 보장하지 않는다
 - Internet Explorer 미지원
 
 ---
@@ -322,3 +352,44 @@ sudo chmod -R 755 storage bootstrap/cache vendor modules plugins templates
 | 커스텀 포트 (80/443 외) | Reverb WebSocket (기본 8080 포트) | Pusher 등 외부 WebSocket 서비스 |
 | 파일 권한 (`symlink` 등) | `storage/` 심볼릭 링크 | `php artisan storage:link` 대체 방식 확인 |
 | 디스크 용량 | 첨부파일, 로그, 캐시 누적 | 플랜별 용량 확인, 정기 정리 |
+
+---
+
+## 9. 요구사항 검증 수준
+
+이 문서의 항목은 자동으로 확인되는 것과 운영자가 직접 확인해야 하는 것으로 나뉜다.
+"요구사항" 이라는 표현이 곧 "설치 프로그램이 검사한다" 를 뜻하지는 않는다.
+
+### 9.1 설치 프로그램이 자동 검사
+
+| 항목 | 기준 | 미충족 시 |
+|------|------|----------|
+| PHP 버전 | 8.2 이상 | 설치 차단 |
+| PHP 확장 | §1.4 필수 확장 중 14개 | 설치 차단 |
+| 차단 함수 | `exec`·`proc_open`·`shell_exec` 사용 가능 | 설치 차단 |
+| 디스크 여유 공간 | 500MB | 설치 차단 |
+| 디렉토리 쓰기 권한 | `storage/`, `bootstrap/cache`, `vendor`, 확장 디렉토리 등 | 설치 차단 |
+| `.env` 파일 | 존재 + 쓰기 가능 | 설치 차단 |
+| 데이터베이스 접속 | 접속 성공 여부 | 다음 단계 진행 불가 |
+| DB 테이블 접두어 | 최대 6자 | 입력 거부 |
+| 웹 ↔ CLI PHP 버전 | 메이저·마이너 일치 | 안내만 (설치 진행) |
+| OPcache | 활성화 여부 | 안내만 (설치 진행) |
+| HTTPS | 사용 여부 | 안내만 (설치 진행) |
+
+`gd`·`imagick`·`redis`·`intl`·`zlib` 은 설치 단계에서 상태를 표시하지만 설치를 막지 않는다.
+
+### 9.2 운영자 확인 필요 — 자동 검사 없음
+
+| 항목 | 문서상의 기준 | 확인 방법 |
+|------|--------------|----------|
+| 데이터베이스 버전 | MySQL 8.0+ / MariaDB 10.3+ | `SELECT VERSION()` |
+| DB charset·collation | `utf8mb4` / `utf8mb4_unicode_ci` | 접속 후 스키마 확인 |
+| php.ini 값 | §1.5 의 5개 항목 | `php -i` 또는 관리자 정보 화면 |
+| CPU·메모리 | §3.1 | 서버 사양 확인 |
+| 웹서버 종류·버전 | Nginx 1.18+ / Apache 2.4+ | 서버 설정 확인 |
+| `mod_rewrite` | Apache 사용 시 활성화 | 서버 설정 확인 |
+| Redis 버전 | 6.0 이상 | `redis-server --version` |
+| Node.js·Composer 버전 | §1.7 | 소스 빌드·Composer 설치를 할 때만 해당 |
+| 지원 브라우저 | §7 | 자동 브라우저 테스트는 Chromium 만 상시 수행 |
+| 데몬 프로세스 가동 | §6 의 3종 | 프로세스 관리 도구에서 확인 |
+| §1.4 의 선택 확장 | 사용하는 기능에 따라 | 관리자 정보 화면의 확장 목록 |

docs/testing/e2e-testing.md

@@ -11,6 +11,7 @@
 - 데이터 생성: 데이터를 소유한 영역에 시드 커맨드 배치 (코어 ↔ 모듈 의존 역전 회피)
 - 편집기 저장 spec: 제품 화면 대신 전용 시드 화면(e2e_sandbox) 대상 — globalSetup 이 매 실행 원본으로 덮어씀 (§4.1)
 - 외부 의존: mock-first 전략 (page.route() 로 결제창/외부 API 가로채기)
+- 브라우저: 일상 E2E 는 Chromium 전용 — 확대 조건은 §3 브라우저 범위
 ```
 
 ## §1. 도구 선택 정당화
@@ -113,6 +114,35 @@ spec 이 전부 실패한다.
 | 워커 수 | 관리자 SPA 는 번들이 크고 레이아웃을 여러 번 받아온다. 개발 머신에서 2워커 이상이면 `page.waitForLoadState` 가 30초를 넘겨 **비결정적으로** 실패한다(실측: 같은 스위트가 회차마다 다른 5~7건 실패, 테스트당 8초 → 25초). 판정은 `--workers=1` 결과로 한다 |
 | 편집기 spec 만 몰아 실행할 때 | 레이아웃 편집기 spec 만 골라 돌리면 워커 전부가 동시에 편집기 페이지를 연다 — 전체 스위트에서는 가벼운 spec 이 섞여 그 집중이 생기지 않는다. 실측: 편집기 7파일 27건을 7워커로 돌리면 `g7le-preview-frame` 대기가 전부 30초 타임아웃(27/27 실패), 같은 코드로 2워커는 26/27 통과. 편집기만 선택 실행할 때는 `--workers=2` 이하로 둔다 |
 
+### 브라우저 범위
+
+일상 E2E 는 Chromium 전용이 정책이다. 코어 config 와 확장 config 모두 `projects` 에
+chromium 하나만 두며, `npx playwright install chromium` 만 안내하는 것(§2)이 곧 이 정책이다.
+문서상의 지원 브라우저 선언(`docs/requirements.md` §7)은 이 자동 검증 범위와 구분해서 읽는다 —
+Firefox/Safari 는 프론트엔드 의존성(React 19, Tailwind CSS 4)의 호환 범위 기준 지원이며
+상시 자동 테스트 대상이 아니다.
+
+이 정책의 근거는 위험 표면의 위치다. 엔진과 레이아웃에는 브라우저별 분기 코드가 없어 JS
+레벨의 브라우저 편차 위험이 낮고, 실질 위험은 CSS 렌더링과 contenteditable(위지윅) 거동에
+몰려 있다. 그 두 축은 브라우저 프로젝트를 늘리는 것보다 해당 spec 을 두껍게 쓰는 편이
+비용 대비 회수가 크다.
+
+Firefox/WebKit 프로젝트를 상시 스위트에 넣지 않은 이유:
+
+- 프로젝트 간 병렬 실행이 공유 서버 상태를 경합시킨다 — 시드 화면 PUT 저장(§4.1)과 관리자
+  설정 저장 spec 은 같은 레코드를 건드리므로 브라우저별 실행이 서로의 저장을 덮어쓴다.
+- 시나리오 매니페스트에 브라우저 축을 추가하면 cross product 가 브라우저 수만큼 배가된다.
+- 총 실행 시간이 프로젝트 수에 비례해 늘어, 개발 머신의 워커 예산(위 "실행 시 유의")과
+  정면으로 충돌한다.
+
+향후 도입할 경우 아래 4가지를 조건으로 한다:
+
+- 상시 스위트가 아니라 **별도 opt-in 스위트**로만 실행한다 (기본 실행 대상에 넣지 않는다).
+- 대상은 `@smoke` 로 한정한다 — 레이아웃 편집기 저장 spec 을 배제해 시드 화면 경합을 피한다.
+- `--workers=1` 로 고정한다.
+- CDP 를 쓰는 spec(`specs/smoke/localinit-multi-progressive-datasource.spec.ts` 의
+  `newCDPSession`)은 `test.skip(browserName !== 'chromium')` 로 제외한다.
+
 ## §4. 데이터 생성 위치 — 책임 분리 매트릭스
 
 | 데이터 종류 | 책임 영역 | 위치 | 호출 |

tests/Playwright/README.md

@@ -8,9 +8,12 @@ G7 코어의 Playwright (TypeScript) 기반 결정론적 E2E 인프라.
 # PowerShell (개발 환경)
 $env:PLAYWRIGHT_BASE_URL='https://g7.dev'
 npm run test:e2e            # 전체 spec
-npm run test:e2e:smoke      # @smoke 태그 (homepage / login / admin-dashboard 3건)
-npm run test:e2e:wysiwyg    # 위지윅 매트릭스 90건 (Phase M)
+npm run test:e2e:smoke      # @smoke 태그 (--grep @smoke)
 npm run test:e2e:ui         # Playwright UI 모드 (디버깅)
+
+# 특정 spec / 디렉토리만
+npx playwright test tests/Playwright/specs/smoke/admin-base.spec.ts
+npx playwright test tests/Playwright/specs/layout-editor --workers=2
 ```
 
 ```bash
@@ -18,6 +21,13 @@ npm run test:e2e:ui         # Playwright UI 모드 (디버깅)
 PLAYWRIGHT_BASE_URL=https://g7.dev npx playwright test
 ```
 
+루트 `package.json` 이 제공하는 E2E 스크립트는 `test:e2e` · `test:e2e:smoke` · `test:e2e:ui`
+3개다. 그 밖의 범위 지정은 `npx playwright test` 에 경로나 `--grep` 을 직접 준다.
+
+브라우저는 Chromium 전용이다 (`playwright.config.ts` 의 `projects` 에 chromium 하나).
+Firefox/WebKit 도입 조건은 [docs/testing/e2e-testing.md](../../docs/testing/e2e-testing.md)
+§3 "브라우저 범위" 참조.
+
 ## Base URL 해석 우선순위 (하드코딩 회피)
 
 `playwright.config.ts` 의 `resolveBaseUrl()` 가 다음 순서로 결정:
@@ -30,24 +40,30 @@ PLAYWRIGHT_BASE_URL=https://g7.dev npx playwright test
 
 ## 디렉토리 구조
 
-```
+```text
 tests/Playwright/
 ├── fixtures/
-│   └── auth.ts                        (Sanctum 토큰 발급 + addInitScript 주입)
+│   ├── auth.ts                        (Sanctum 토큰 발급 + addInitScript 주입)
+│   ├── ecommerce-auth.ts              (구매자 세션 fixture)
+│   ├── layout-editor.ts               (편집기 진입/저장 헬퍼)
+│   ├── seed-layout.ts                 (시드 화면 준비/정리)
+│   └── seed-layouts/                  (시드 화면 원본 JSON)
+├── global-setup.ts                    (시드 화면 설치)
+├── global-teardown.ts                 (시드 화면 제거)
 ├── specs/
-│   ├── smoke/                         (Phase 1 — 3건)
-│   │   ├── homepage.spec.ts
-│   │   ├── login.spec.ts
-│   │   └── admin-dashboard.spec.ts
-│   └── wysiwyg/                       (Phase 2 — 90건, 위지윅 편집기 Phase M)
-│       ├── auth-guard.spec.ts                (12: access_outcome × user_permission)
-│       ├── handler-suppression.spec.ts       (6:  suppressed_handler 축)
-│       ├── anchor-intercept.spec.ts          (45: anchor_kind × modifier_key)
-│       └── url-template-param.spec.ts        (27: url_template_param × anchor_kind)
+│   ├── smoke/                         (핵심 화면 — 14 파일)
+│   ├── admin/                         (관리자 화면 — 17 파일)
+│   ├── layout-editor/                 (레이아웃 편집기 — 46 파일)
+│   ├── pagination/                    (목록 페이지네이션 — 4 파일)
+│   ├── search/                        (검색 — 1 파일)
+│   └── *.spec.ts                      (엔진/렌더링 회귀 — 14 파일)
 ├── .auth/                             (gitignore — storageState 캐시)
 └── README.md                          (본 문서)
 ```
 
+`@smoke` 표기는 70곳(25개 파일)이며, 그중 1곳은 `test.describe` 단위라 `--grep @smoke` 로
+선택되는 테스트 수는 표기 수보다 많다. 파일·건수는 변하므로 판단이 필요할 때 직접 센다.
+
 ## 코어/확장 분리 원칙
 
 기존 PHPUnit / Vitest 와 동일 원칙. **모듈/플러그인/템플릿 E2E spec 을 코어 디렉토리에 작성 금지.**
@@ -98,19 +114,20 @@ E2E spec 이 "특정 유저 + 특정 역할 + 특정 도메인 상황" 에서
 | 플러그인 도메인 데이터 (결제 키 등) | 플러그인 | `plugins/_bundled/{id}/src/Console/Commands/PlaywrightSeed{id}.php` |
 | 외부 의존 (토스 결제창 응답 등) | spec 안 mock | `page.route('https://api.tosspayments.com/**', ...)` |
 
-**핵심 원칙**: 코어는 모듈 도메인을 모른다. 모듈 도메인 시드 커맨드를 코어에 두면 코어↔모듈 의존이 뒤집힘 (audit 룰 위반).
+**핵심 원칙**: 코어는 모듈 도메인을 모른다. 모듈 도메인 시드 커맨드를 코어에 두면 코어↔모듈 의존이 뒤집힘 (정적 검사 위반).
 
 ## 시나리오 매니페스트 ↔ spec 매핑
 
-| YAML axis | spec 파일 | 케이스 |
-|---|---|---|
-| `tests/scenarios/wysiwyg-editor-access-guard.yaml` `cross_product[0]` (access_outcome × user_permission) | `specs/wysiwyg/auth-guard.spec.ts` | 12 |
-| 동일 yaml `cross_product[1]` (anchor_kind × modifier_key) | `specs/wysiwyg/anchor-intercept.spec.ts` | 45 |
-| 동일 yaml `cross_product[2]` (suppressed_handler) | `specs/wysiwyg/handler-suppression.spec.ts` | 6 |
-| 동일 yaml `cross_product[3]` (url_template_param × anchor_kind) | `specs/wysiwyg/url-template-param.spec.ts` | 27 |
+시나리오 매니페스트(`tests/scenarios/*.yaml`)의 축과 spec 은 파일명으로 대응시킨다 —
+`layout-editor-table-editor.yaml` ↔ `specs/layout-editor/table-editor.spec.ts` 처럼
+매니페스트 이름에서 도메인 접두어를 뗀 형태가 spec 파일명이 된다.
 
-각 spec 은 `test.describe.parallel(axisName)` 으로 묶고 matrix 배열로 매개변수화.
-케이스 docblock 에 `// @scenario k1=v1, k2=v2` / `// @effects e1, e2` 마킹.
+각 spec 은 `test.describe.parallel(axisName)` 으로 묶고 matrix 배열로 매개변수화한다.
+케이스 docblock 에 `// @scenario k1=v1, k2=v2` / `// @effects e1, e2` 를 마킹하면
+매니페스트의 `cross_product` · `effects` 와 자동으로 대조된다.
+
+`@scenario` 의 축 구분자는 **쉼표뿐이다.** `k1=v1 × k2=v2` 처럼 곱셈 기호로 적으면
+첫 축만 인식되고 나머지는 조용히 누락된다.
 
 ## 외부 의존 시나리오 — mock-first 패턴 (결제 등)
 
@@ -156,7 +173,7 @@ await page.route('https://api.tosspayments.com/v1/payments/confirm', route => ro
 $env:PLAYWRIGHT_BASE_URL='https://g7.dev'; npm run test:e2e:ui
 
 # 특정 spec 만 실행
-PLAYWRIGHT_BASE_URL=https://g7.dev npx playwright test tests/Playwright/specs/wysiwyg/auth-guard.spec.ts
+PLAYWRIGHT_BASE_URL=https://g7.dev npx playwright test tests/Playwright/specs/layout-editor/auth-guard-and-locales.spec.ts
 
 # trace 열기
 npx playwright show-trace test-results/<...>/trace.zip
@@ -167,6 +184,6 @@ Playwright 가 회귀를 발견하면 → Claude `chrome-devtools-mcp` 로 라
 ## 참고
 
 - 가이드: `docs/testing/e2e-testing.md`
-- 시나리오 매니페스트: `tests/scenarios/wysiwyg-editor-access-guard.yaml`
-- 단위 시뮬레이션 (Vitest): `resources/js/core/template-engine/wysiwyg/__tests__/previewNavigation.test.ts` 등
+- 시나리오 매니페스트: `tests/scenarios/` (레이아웃 편집기 축은 `layout-editor-*.yaml`)
+- 단위 시뮬레이션 (Vitest): `resources/js/core/template-engine/__tests__/`
 - 모듈 sample skeleton: `modules/_bundled/sirsoft-ecommerce/tests/Playwright/README.md`