chore(layout): 정리 1단계로 버려진 파일·이력·nginx 조각을 정리한다 #11
Merged
donghyeon.kang
merged 4 commits from 2026-11-07 15:14:49 +00:00
chore/layout-1-cleanup into main
4
Commits
| Author | SHA1 | Message | Date | |
|---|---|---|---|---|
|
|
121e11250a |
docs(operations): nginx 설정 예시를 지우고 호스트가 지킬 조건만 남긴다
문제: docs/operations/release-cache-rollback.md에 nginx 설정이 통째로 있다(보안 헤더 snippet과 server 블록, 「Example: nginx on a single server」 절). CI는 그것을 돌리지 않고, 호스트 설정은 개발 repo의 일이 아니다(소유자 2026-11-07). ci-quality-gates.md의 runner 요구 절에도 호스트를 바꾸는 절차(AppArmor profile 본문, sysctl 명령)가 있다. 고른 방법: - nginx 절을 지우고 같은 문서에 「운영 환경이 지켜야 할 조건」 19개를 문장으로 쓴다. 조건마다 재는 쪽을 적었다: FE-GATE-019가 잰다(live 모드, 값은 config/hosting/*.json) / 아무도 재지 않는다. 백엔드와 같은 절 이름·같은 언어(한국어)다. - 지운 설정을 한 줄씩 대조했다. snippet 6줄 → 6(값), always → 7; listen 443 ssl·server_name·인증서 → 1; http2 → 2; gzip·gzip_types → 10, gzip_vary → 11; root current와 원자적 symlink 전환 → 17; index.html → 3·6; try_files fallback → 4·6; config.json· release-manifest.json → 5·6; 공유 /assets/·기간으로 지우기 → 18; 없는 청크 404 → 12; immutable → 8; service-worker.js → 14·15; .map 404 → 16; Cache-Control에 always 없음 → 13; 기본 base path / → 1; mime.types에 맡긴 Content-Type → 3·5·9·14. 롤백 때 동작은 19. - static-delivery.md의 "nginx example" 문장은 이 절을 가리키게 고친다. - ci-quality-gates.md: runner 요구(바이너리, systemd, cgroup, 비특권 user namespace)는 게이트가 runner에 요구하는 조건이라 남긴다. 고치는 방법 목록과 AppArmor profile 본문만 지우고 "고치는 방법은 scripts/check-system-test-prerequisites.ts가 실패할 때 출력한다"로 바꾼다. 그 스크립트가 같은 세 방법을 출력한다. 버린 대안: nginx 설정을 project-infra나 cicd-platform으로 복사하기. 아무도 시험하지 않는 복사본이 다른 repo에 생긴다(백엔드도 지웠다). 위험·한계: 아무도 재지 않는 부분이 있는 조건이 11개다(7, 8의 나머지 파일, 10의 나머지 청크와 CSS·JSON·SVG, 11, 12, 13, 15, 16의 호스트 쪽, 17의 전환 도중, 18, 19의 호스트 쪽). 지운 nginx 예시도 CI가 돌리지 않았으니 재지 않는 범위는 넓어지지 않았다. AppArmor profile 본문은 이 repo에서 없어진다. 필요하면 runner를 만드는 쪽 인프라 repo가 갖는다. 검증: git grep -n '^```nginx' 0줄. desktop(이 커밋 30a379f 트리, 로그 ~/l1-layout-cleanup-logs/): verify:documentation PASS_SCOPED(새 절의 경로·script 이름·FE-GATE ID와 static-delivery.md의 링크 포함), test:unit 3091 tests 통과. Refs: design-docs repo-structure/04-frontend-layout.md 4절 I-3·I-4·I-11 |
||
|
|
429b8d8802 |
docs(history): 루트의 tasks/와 .superpowers/ 기록을 docs/history로 옮긴다
문제: 끝난 작업의 기록이 루트 폴더 둘에 따로 있다. tasks/는 2026-09-25 리뷰 수정 라운드(v0.2.0으로 끝남)의 계획·작업 목록·인계·레인 지시서와 레인 준비 스크립트 5개, .superpowers/는 2026-08-01 런타임 정합성 수정의 작업 보고 1개다. 읽는 코드는 없다(tests/unit/deletable-history- documents.test.ts가 지킨다). 소유자가 2026-11-07 백엔드와 같이 이력 폴더로 옮기기로 정했다. 고른 방법: - tasks/ → docs/history/plans/2026-09-25-review-fix-round/ (lanes/ 유지), .superpowers/sdd/2026-08-01-runtime-correctness-remediation/ task-5-report.md → docs/history/evidence/2026-08-01-runtime-correctness- remediation/. 폴더 이름은 docs-system 2절과 백엔드를 따른다. - .md 5개 맨 위에 docs-system 4.1절 머리 블록 9줄(빈 줄 포함, 백엔드와 같은 모양)을 단다. 본문은 바꾸지 않았다: 블록 9줄을 빼면 옛 파일과 바이트가 같다(cmp). setup-lane.sh는 실행 파일(첫 줄 shebang)이라 블록을 달지 않고 그대로 옮긴다(R100). 같은 폴더 LANE-BRIEF.md의 블록이 그 파일을 설명한다. - 상태: 계획서 넷은 끝남. 기계 규칙(체크 상자가 모두 표시돼야 끝남)으로는 plan·todo가 확인 안 함이지만, 이력이 라운드의 끝을 정한다(CHANGELOG 0.2.0, 태그 v0.2.0 2026-09-27). 증거는 보관. - 작성일: plan·todo는 2026-09-25. git이 처음 더한 날( |
||
|
|
0805910c47 |
chore(config): 아무도 읽지 않는 config/schemas의 JSON Schema 4개를 지운다
문제: config/schemas/에 산출물 JSON Schema 4개가 있다. 코드·테스트· workflow·문서 어디서도 경로나 $id(ART-FE-FIELD-WEB-VITALS@1, ART-FE-LAB@1, ART-FE-003@1, ART-FE-RUNBOOK-DRILL@2)로 읽지 않는다 (git grep, CHANGELOG·리뷰 기록 제외). 산출물을 실제로 검사하는 것은 scripts/contracts/release-artifacts.ts의 zod schema다. 그런데도 81701ad(2026-11-05)가 lab 칸을 더하면서 이 파일도 손으로 고쳤다. 읽는 곳 없는 사본을 맞추는 일이 생긴다. schemas/의 생성 스키마와 비교: scripts/generate-artifact-schemas.ts가 만드는 4개(build-manifest, dependency-inventory, registry-snapshot, supply-chain-verification)와 이름·대상이 겹치는 것이 없다. 그래서 각 파일을 그 산출물의 zod 정본과 대조했다. - field-web-vitals ↔ fieldWebVitalsArtifactSchema: 최상위 칸 9개와 context 칸 9개가 같다. zod가 더 엄격하다(window.days = 28, consentRequired = true, 숫자 범위, 하위 객체 strict). - lab-performance ↔ labPerformanceArtifactSchema: zod는 context·metrics를 아무 객체로 받는다. JSON만 context 필수 칸 7개, metrics 필수 칸 5개, fixtures 2개 이상을 적었다. context 칸 7개는 scripts/lib/performance-budgets.ts evaluateLabBudget가 없으면 실패로 판정한다. metrics 5칸과 fixtures 3개는 scripts/test-performance.ts가 늘 만든다. - release-verification ↔ releaseVerificationArtifactSchema: zod가 더 엄격하다(artifact.releaseId 필수, fixture 칸 strict). JSON만 fixtures 2개 이상을 적었다. scripts/verify-release.ts는 config/release/coherence-fixtures.json의 4개를 쓴다. - runbook-drill-record ↔ runbookRecordArtifactSchema: 칸이 같다. zod는 result가 판정들의 합과 맞는지도 본다. JSON만 recoveryAssertions 4개 이상을 적었다. scripts/drill-runbook.ts의 runbook 5개는 모두 4개를 만든다. JSON에만 있는 최소 개수 셋은 지금 만드는 쪽이 늘 채우지만 아무도 검사하지 않는다. 이 파일도 읽는 곳이 없어 지워도 검사가 줄지 않는다. 버린 대안: schemas/로 옮기거나 zod에서 생성하기. 읽는 곳이 없는 파일을 옮기거나 생성하면 지킬 것 없는 사본이 하나 더 생긴다. 스키마 자리를 한 곳으로 모으는 일은 3단계(schemas/ → config/schemas/)다. 위험·한계: 다운스트림이 이 파일을 외부 도구에 물렸다면 그쪽이 끊긴다. 템플릿 안에는 그런 곳이 없다. 검증: git grep으로 경로와 $id 넷을 찾아 0건(CHANGELOG·리뷰 기록 제외). desktop(네 커밋의 끝 30a379f, 로그 ~/l1-layout-cleanup-logs/): check:types, test:unit(212 files, 3091 tests), check:ci, lint exit 0. Refs: design-docs repo-structure/04-frontend-layout.md 2.1절, 9.2절 |
||
|
|
85f941c44c |
chore(artifacts): 읽는 곳 없는 산출물 13개를 지우고 폴더째 무시한다
문제: .gitignore가 artifacts/를 확장자별로만 무시한다(*.json, *.xml, *.txt, *.sarif, *.log). 규칙에 없는 확장자가 새어 들어와 화면 캡처 3개 (artifacts/local-preview/*.png)와 커버리지 보고서 10개 (artifacts/tests/coverage-gateway/)가 추적된다. 읽는 코드·게이트·문서는 없다(git grep 'local-preview', 'coverage-gateway' 0건, 리뷰 기록 제외). 0929/14-01이 찾았고 2026-11-06 리뷰까지 '일부'로 남았다. 고른 방법: - 13개를 지운다. - artifacts/를 폴더째 무시하고 .gitkeep 2개와 수동 a11y 기록 (artifacts/tests/a11y-manual/*.md)만 다시 넣는다. git은 무시한 폴더 아래 파일을 다시 넣지 못해서, 지나가는 폴더마다 다시 넣고 그 내용을 다시 무시한다. 확장자·폴더별 옛 규칙은 모두 이 안에 들어가 지웠다. - tests/unit/tracked-artifacts.test.ts가 git ls-files artifacts를 허용 목록과 대조한다. git add -f로 넣은 파일도 잡는다. 버린 대안: - artifacts/** 와 !artifacts/**/ 꼴: git에서는 같게 되지만 verify:documentation이 .gitignore를 읽는 방식 (scripts/verify-documentation-readiness.ts generated())이 !artifacts/**/ 를 "artifacts 아래 전부 다시 넣음"으로 읽는다. 그러면 문서가 이름 부르는 생성 산출물(artifacts/quality/... 등)이 없는 경로로 실패한다(코드 읽기로 확인). - 확장자 규칙에 *.png, *.html, *.info를 더하기: 다음 새 확장자에서 같은 일이 난다. 위험·한계: a11y 기록 말고 사람이 쓴 파일을 artifacts/에 두면 이제 무시된다. 지금 추적 파일 12개는 모두 허용 목록 안이다. 다운스트림은 지운 13개를 고치지 않았으면 병합이 그대로 지운다. 검증(desktop, 네 커밋의 끝 30a379f에서 한 번. 커밋마다 따로 돌리지는 않았다. 로그 ~/l1-layout-cleanup-logs/): - tracked-artifacts.test.ts: 지금 트리 통과. 지운 png 3개를 index에 되돌리면 실패하고 그 3개를 낸다. 허용 목록 밖 note.txt를 git add -f 하면 실패하고 그 파일을 낸다. - 새 .gitignore를 빈 저장소에 두고 산출물 15개를 만든 뒤 git add -A: .gitkeep 2개와 a11y .md 1개만 추적된다(노트북). - git ls-files artifacts: 12개(.gitkeep 2, a11y-manual/*.md 10). - corepack pnpm test:unit: 212 files, 3091 tests 통과. verify:documentation: PASS_SCOPED. check:architecture, check:types, lint, check:ci, check:adapter-inventory: exit 0. Refs: design-docs repo-structure/04-frontend-layout.md 9.2절 1단계 |