old-tab-chunk-recovery 시험은 A 빌드 탭을 연 채 B를 배포하고 「탐색」을
누른다. A의 탐색 청크가 서버에 없으니 탭이 한 번 B로 다시 불러와야 한다.
그런데 홈 화면이 탐색(과 프로필) 청크를 modulepreload로 미리 받는다.
탭이 이미 그 청크를 가지고 있어 서버에 묻지 않고, 다시 불러오기가 0번이라
떨어진다.
미리 받지 않는 「프로젝트」와 「주제」 화면으로 바꾼다. 허용하는 실패
요청 정규식도 그 두 청크 이름으로 바꾼다.
검증: 이 시험이 chromium·firefox·webkit 모두 통과한다. 홈에서 받는
route 청크 목록(explore·case·profile·search·not-found·home)은 빌드한 앱을
열어 performance 항목으로 확인했다.
service-worker-update 시험이 두 가지를 템플릿 빌드 기준으로 가정한다.
- 빌드 B에서 바꿀 route 화면으로 src/presentation/pages/not-found-page.tsx를
연다. 이 제품에는 없는 파일이라 beforeAll이 ENOENT로 떨어지고, 이
파일의 시험 넷이 전부 돌지 않는다.
- 캐시 목록을 dist/assets/의 모든 파일과 비교한다. 템플릿 빌드는 그
폴더가 곧 정적 자산 집합이다. 이 제품은 두 방향으로 다르다. IBM Plex
Mono의 .woff 대체 파일은 캐시 대상 확장자가 아니고(SW-RR-03, .woff2만),
dist/media/의 SVG는 캐시 대상이다.
바꿀 화면은 같은 방식으로 lazy load되는 TechLog Public not-found 화면이다.
기대하는 캐시 목록은 빌드가 선언한 집합, 즉 생성기의 collectStaticAssets
결과다. route 청크가 사라졌는지 보는 곳은 그대로 dist/assets를 쓴다.
검증: service-worker-update.spec.ts 4개 시험이 chromium·firefox·webkit
모두 통과한다.
boot-module-failure 시험은 빌드 사본의 installed-feature-messages.ts에서
`composeInstalledMessageCatalogs(\n INSTALLED_PRODUCT_FEATURE_MODULES,\n)`를
찾아 두 번 합치게 고친다. 같은 메시지 키가 두 번 들어가 모듈 평가 중에
예외가 나야 한다. 이 제품은 동기화 때 그 줄을 TechLog 카탈로그를 같이
합치는 배열로 바꿨다. 그래서 문자열을 찾지 못하고 빌드 전에 떨어진다.
TechLog 카탈로그 줄을 두 번 넣는다. 키가 겹쳐 같은 TypeError가 난다.
한계: 이제 fixture는 의도대로 동작하지만 시험은 여전히 떨어진다. 제품
결함이다. 예외가 나는 모듈이 route-not-found 청크에 묶이고, 부팅 실패
화면(render-boot-failure 청크)이 그 청크에서 두 값을 import한다. 그래서
부팅 실패 화면도 그리지 못하고 「불러오는 중」이 계속된다. 27e342d(PR #6
전) 빌드도 같은 import를 가지고 있어 react-dom 청크 분리 때문은 아니다.
청크 구성을 고치는 일은 이 PR 밖이다.
검증: 빌드 사본에서 「Duplicate ko-KR message key: route.TECH_LOG_HOME.title」
TypeError가 route-not-found 청크에서 나는 것을 trace로 확인했다.
09-29 템플릿 동기화(c80320d, ebea300→af3d8e6)가 템플릿 e2e 시험을
그대로 들여왔다. 그 시험은 이 제품이 지운 템플릿 예시 화면을 연다.
- app-shell: 제목 「Tech Log」(지금 브랜드는 「TechLog」), 템플릿 drawer의
「메뉴」 버튼과 /examples/states.
- production-csp: 제목 「Clean Architecture Frontend」와 「화면 상태」 링크.
- scroll-restoration: /examples/ui와 .app-shell__header.
그래서 세 엔진 모두에서 요소를 찾지 못해 떨어진다.
같은 동작을 TechLog 화면으로 본다.
- 홈 제목은 TechLog, 이동할 화면은 주요 탐색의 「프로젝트」.
- drawer는 TechLog의 details.mobile-nav와 「모바일 주요 탐색」.
- 긴 화면은 Case(1280x720에서 약 6,000px), 해시 대상은 그 안의 h2.
- production-csp는 경로가 바뀐 것을 URL과 제목으로만 확인한다. 초점은
app-shell 시험이 따로 본다. 그래야 초점 결함과 상관없이 CSP 검사가 돈다.
위험·한계: 옮긴 시험 가운데 셋은 제품이 그 동작을 하지 않아 여전히
떨어진다. 시험을 고쳐서 생긴 실패가 아니라, 템플릿 이름 때문에 가려져
있던 실패다.
- 경로 이동 뒤 초점: app-router.tsx는 「shell이 초점을 맡는다」며 이동을
뺐지만, TechLog Public shell에는 초점 처리가 없다. drawer 링크로 이동해도
새 화면의 제목으로 초점이 가지 않는다.
- 뒤로 가기 스크롤 복원: Case에서 900px 내려갔다가 다른 화면에 갔다
돌아오면 0이다.
- 해시로 연 Case에서 대상 h2로 스크롤하지 않는다. TechLog 화면은 해시를
처리하는 PageHeader를 쓰지 않는다(project-decisions-page만 따로 처리).
정할 것(초점 정책)이 있어 이 PR에서 제품을 고치지 않는다.
검증: production-csp는 세 엔진 모두 통과한다. 첫 번째 app-shell
시험(홈 부팅)과 scroll-restoration의 화면 열기까지는 통과하고, 위 세
동작에서 떨어진다.
6784eb1(08-20)부터 운영 서버는 빌드가 본 slug 목록이 아니라 등록된
Public 경로 패턴으로 SPA를 낸다. 빌드 뒤에 게시한 기록도 열려야 하기
때문이다. 그래서 /projects/missing-project는 이제 200으로 SPA를 받고,
화면 안에서 not-found를 보인다. 시험은 아직 그 경로가 edge 404라고
기대해 세 엔진 모두 떨어진다.
모르는 slug는 200 SPA를 기대한다. edge 404 사례는 경로 매개변수가 한
segment만 맞는다는 것을 보이는 /projects/missing-project/unknown-tab으로
바꾼다. 경로가 없는 /definitely-not-a-product-route는 그대로 둔다.
검증: tech-log-http-contract.spec.ts가 세 엔진 모두 통과한다.
tech-log-studio-workflow.spec.ts만 page.goto로 들어가 실제 시계를 쓴다.
mock 저장본의 검증 결과는 2026-08-14 09:40~10:10 KST에만 유효해서,
실제 시각에서는 「지난 결과 · 저장 후 다시 검증해야 합니다」가 나오고
「현재 저장 버전의 검증을 통과했습니다」를 찾지 못해 떨어진다. 로그인도
하지 않았다.
다른 Studio 시험처럼 gotoTechLogStudio(fixture 시계 2026-08-14T01:00Z,
reduced motion, 데모 로그인)로 들어간다.
검증: 두 시험이 chromium·firefox·webkit 모두 통과한다.
5e2b1a5(08-20)부터 로그인하지 않은 방문자는 Studio 경로에서 로그인
화면만 받는다. e2e 빌드는 local profile(AUTH_MODE demo)이고, 데모
세션은 로그아웃 상태로 시작해 메모리에만 있다. 그런데 Studio 시험은
로그인하지 않고 들어간다. 그래서
- 편집기·접근성 시험은 로그인 화면에서 「저장」 버튼이나 「요약」 칸을
기다리다 떨어지고,
- 경로별 axe 검사(accessibility.spec)와 visual 시험은 Studio 경로 12개에서
Studio 화면 대신 로그인 화면을 검사하고 있었다.
tech-log-fixtures.ts에 gotoTechLogStudio를 둔다. gotoTechLog 뒤에
작성자가 쓰는 「로그인 시작」 버튼을 누르고, 로그인한 세션만 받는
Studio 머리말이 뜰 때까지 기다린다. Studio 경로를 여는 e2e·접근성·visual
시험이 이것을 쓴다.
버린 대안: 앱의 세션을 시험에서 직접 authenticated로 바꾸기. 로그인
버튼과 관문 동작을 건너뛰게 되고, 앱 내부에 시험용 구멍이 필요하다.
위험: 이 변경으로 Studio 화면을 실제로 검사하게 되면서, 로그인 화면에
가려져 있던 결함이 드러난다. MOCK Studio에서도 관리 기능(주제·프로젝트·
릴리즈)이 실제 HTTP(/api/v1/studio/session)로 나가 연결이 거부된다
(create-tech-log-feature-input.ts의 createManagementGateway에 MOCK 분기가
없다). 그 결함은 이 PR 밖이다. 그동안 Studio 편집기·대시보드 시험은
그 이유로 실패한다.
검증: Studio 경로에서 로그인 뒤 Studio 머리말과 주 탐색이 뜨는 것을
error-context 스냅숏으로 확인했다. 남은 실패는 모두 위 HTTP 요청이다.
Question 화면의 「다음 검증」 상자 안 라벨(「왜 다음인가」 등)은
--faint(#6c6f76)를 info 바탕(#eef1fc) 위에 쓴다. 대비가 4.46:1이라
WCAG AA 4.5:1에 못 미친다. axe가 세 엔진 모두에서 color-contrast
serious로 잡아 FE-GATE-009(TECH_LOG_QUESTION)가 떨어진다.
이 두 라벨만 --muted(#5a5d64)로 바꾼다. 같은 바탕에서 5.85:1이다.
--faint 토큰 자체는 흰 바탕에서 5.03:1이라 다른 곳은 문제가 없어서
건드리지 않는다.
위험: 라벨 글자가 조금 진해진다. visual 기준 이미지 가운데 Question
화면이 바뀐다. visual 기준 이미지는 이 변경과 상관없이 8월 18일 것이라
전부 다시 검토해야 한다(PR 본문).
검증: test:a11y에서 TECH_LOG_QUESTION이 chromium·firefox·webkit 모두
통과한다(고치기 전 세 엔진 모두 color-contrast 실패).
Firefox는 번들된 pretendard 1.3.9 가변 폰트를 열 때마다 콘솔에
「downloadable font: name: name records are not sorted」 경고를 낸다.
브라우저 시험의 공용 fixture(strict-browser-test.ts)는 경고도 실패로
세므로, Firefox에서는 폰트를 쓰는 거의 모든 시험이 떨어진다.
2026-11-12 main(7853ff1d) 기준으로 FE-GATE-008 e2e의 Firefox 실패
143건 중 118건, capability 19건 전부, FE-GATE-009의 29건이 이것
하나뿐이었다.
경고는 폰트 파일 안 name 레코드의 순서를 말한다. Firefox의 폰트 검사기
(OTS)가 순서를 고치고 폰트를 그대로 쓴다. Chromium과 WebKit은 아무것도
내지 않는다. 그래서 이 경고 한 줄만 fixture에서 무시한다. 폰트 이름,
가중치 범위, 파일 이름까지 맞는 문장만 받는다. 폰트가 거부되면
「rejected by sanitizer」 같은 다른 문장이 나오고, 그것은 여전히 실패다.
버린 대안: 폰트를 다시 써서(fonttools로 저장) 정렬된 파일을 repo에 두기.
npm 패키지 대신 고친 바이너리를 직접 관리하게 되고, 패키지를 올릴 때마다
다시 만들어야 한다.
위험: Pretendard를 다른 판으로 바꿔 경고 문장이 달라지면 이 정규식이
맞지 않아 다시 실패한다. 그때는 그 문장을 보고 판단한다.
검증 (desktop, Playwright 1.62, CI env):
- Firefox에서 빌드한 앱: Pretendard Variable status "loaded",
document.fonts.check('16px "Pretendard Variable"') true, h1 글꼴
Pretendard Variable. 경고는 그대로 한 줄 나온다.
- test:browser-capabilities: Firefox 실패 19건 → 0건.