문제: 프론트 문서 체계는 백엔드와 다르다. docs/README.md는 "README와 입구 문서는 영어"라고 정해 두어 2026-11-07 소유자 결정(살아 있는 문서는 본문까지 한국어)과 반대이고, 기록의 머리 블록·언어·숫자 복사를 보는 검사가 없다. verify:documentation은 docs/README.md 1절이 링크한 문서의 경로만 본다. 고른 방법: 백엔드 scripts/check-docs.py의 규칙(language, head, number, map, readme, style)을 같은 이름·문턱으로 TypeScript로 옮겨 scripts/lib/docs-system.ts에 두고 verify:documentation(FE-GATE-017)이 부르게 한다. 참조 검사는 지금 있는 것을 그대로 쓰고 대상만 살아 있는 문서 전부로 넓힌다. FE-GATE-017 job은 workflow_dispatch(documentation 단계)에서만 돌아서, PR에서 실패하도록 merge 단계 FE-GATE-005의 documentation-readiness 시험이 이 repo를 그대로 두고 verify:documentation을 한 번 돌린다. - 버린 안: 새 게이트나 package script를 더하는 것. config/ci(정리 3단계·CI 세션 범위)와 CI 계약의 개수·해시를 건드린다. - 버린 안: check-docs.py를 그대로 복사하는 것. 프론트 CI 이미지와 도구는 Node뿐이고, 참조 검사(짝 백엔드 pin, 지운 샘플, 생성 산출물)는 이미 TS에 있다. - 예외 목록 scripts/docs-system-exceptions.txt는 줄기만 한다(줄마다 FROZEN 지문). 이 커밋의 줄은 아직 옮기지 않은 문서의 기준선이고 뒤 번역 커밋들이 지운다. - docs/README.md를 모든 문서 폴더를 덮는 지도와 수명·언어·머리 블록· 검사 규칙으로 다시 쓰고, 루트 README.md를 docs-system.md 6.1절의 필수 절 순서로 한국어로 다시 쓴다. README의 src 폴더 설명은 layers.md 표와 글자가 같아야 하므로 layers.md·overview.md·foundation.md를 같이 옮긴다. - README 「복사한 뒤 지워도 되는 것」을 읽는 정규식과, 문서를 바꿔 넣는 테스트의 기대 문자열을 새 한국어 문장으로 고친다. 검사기는 기록 폴더 이름을 적지만 지운 사본에서도 통과하므로 deletable-history-documents 테스트의 검사 대상에서 뺀다(그 이유를 테스트와 검사기 시험에 적었다). 위험: 파생 서비스가 이 변경을 받으면 자기 살아 있는 문서가 영어일 때 verify:documentation이 실패한다. CHANGELOG에 「먼저 할 일」로 적는다. review-evidence.md는 다른 작업 공간의 경로를 적은 사본이라 참조·숫자 검사에서 뺐다(HISTORY_HOLDERS). 검증: tests/unit/docs-system.test.ts(조건마다 실패 입력), documentation-readiness·template-feature-removal-documents· deletable-history-documents 시험, verify:documentation을 desktop에서 돌렸다.
29 lines
1.3 KiB
Bash
29 lines
1.3 KiB
Bash
# Build-time inputs (§6.1). These are compiled into the bundle by Vite, so
|
|
# everything here is public by definition. Never put a secret in this file or in
|
|
# any `.env*` file: a frontend has no confidential storage, and a value that
|
|
# reaches the browser has been published.
|
|
#
|
|
# Runtime configuration — API endpoints, auth mode, telemetry, capability
|
|
# switches — is NOT here. It lives in `config/runtime/<profile>.json` and is
|
|
# materialized into `dist/config.json` at build time. Only the emergency
|
|
# switches (CAPABILITY_OVERRIDES, FEATURE_OVERRIDES) may be changed in a
|
|
# deployed config.json without rebuilding, by the checked procedure in
|
|
# docs/runbooks/FE-RB-001.md. See the 「런타임 설정과 배포 변수」 section of
|
|
# README.md.
|
|
#
|
|
# Copy to `.env.local` (git-ignored) to override locally.
|
|
|
|
# Identifies the build in release manifests and the runtime document.
|
|
# CI supplies the real value; a developer build falls back to "local-build".
|
|
VITE_BUILD_ID=local-build
|
|
|
|
# Source revision the bundle was produced from.
|
|
VITE_COMMIT_SHA=local
|
|
|
|
# Sub-path the app is served under. Must start and end with "/".
|
|
# Feeds the router, the Service Worker scope and Vite's asset base together.
|
|
VITE_ROUTER_BASE_PATH=/
|
|
|
|
# Where the browser fetches the runtime document from at boot.
|
|
VITE_RUNTIME_CONFIG_URL=/config.json
|