test: 브라우저 게이트의 시험 쪽 실패를 고치고 질문 라벨 대비를 올린다 #7

Merged
donghyeon.kang merged 9 commits from fix/browser-gates into main 2026-11-12 06:45:22 +00:00
Owner

제목: test(e2e): main의 브라우저 게이트에서 시험 쪽 어긋남을 고치고 남은 제품 결함을 드러낸다
브랜치: tech-log-frontend fix/browser-gates, head 9077a8d(main 7853ff1d 위, 커밋 9개)

무엇을, 왜

main에서 FE-GATE-008(e2e·capability·visual)과 FE-GATE-009(a11y)가 실패한다. 2026-11-12 desktop에서 처음으로 끝까지 돌려 봤다. CI env, Playwright 1.62, 세 엔진으로 돌렸다. 게이트는 첫 실패에서 멈추므로, 뒤 명령은 따로 돌렸다.

명령 main 7853ff1d
test:e2e 203 실패 / 376 통과 / 12 실행 안 됨
test:browser-capabilities 19 실패 / 44 통과
test:storybook 통과
test:visual 131 실패 / 2 통과
test:a11y (009) 31 실패 / 59 통과

원인은 크게 셋이다.

  1. Firefox 폰트 경고 하나. Firefox가 pretendard 1.3.9의 name 표 순서를 경고한다. 공용 fixture가 경고를 실패로 세서, Firefox 실패 대부분(e2e 118, capability 19, a11y 29)이 이것 하나였다.
  2. 시험이 제품 변경을 따라오지 못했다.
    • 8월 20일 Studio 로그인 관문(5e2b1a5).
    • 같은 날 경로 패턴 서빙(6784eb1).
    • 9월 29일 템플릿 동기화(c80320d)로 들어온, 템플릿 예시 화면 전제의 시험 여섯.
    • mock 검증 결과의 유효 시각(2026-08-14) 지남.
  3. 제품 결함. 시험을 고치자 드러난 것들이다. 이 PR에서는 고치지 않는다(아래 「남은 실패」).

바꾼 것 (커밋 하나에 원인 하나)

커밋 고친 것
0665cd7 test(browser) Firefox의 Pretendard name 표 경고 그 문장 하나만 fixture에서 무시한다. 폰트가 거부되면 다른 문장이 나와 여전히 실패한다
cd4fa8c fix(a11y) Question 「다음 검증」 라벨의 대비가 4.46:1이다. 이것을 5.85:1로 올린다(--faint → --muted, 그 두 라벨만)
500dbc6 test(e2e) Studio 시험이 데모 세션으로 로그인한 뒤 본다(gotoTechLogStudio). 경로별 axe와 visual도 로그인 화면 대신 실제 Studio 화면을 검사한다
db69e52 test(e2e) Studio 작업 흐름 시험을 fixture 시계(2026-08-14T01:00Z)로 돌린다
cfe587c test(e2e) 모르는 slug(/projects/missing-project)는 200 SPA로 기대한다(6784eb1). edge 404 예는 /projects/missing-project/unknown-tab으로 바꾼다
c408cc2 test(e2e) app-shell·production-csp·scroll-restoration을 TechLog 화면(홈 「TechLog」, 「프로젝트」, details.mobile-nav, 긴 Case)으로 옮긴다
70f3125 test(e2e) 부팅 실패 fixture가 TechLog 카탈로그를 두 번 합친다(동기화 때 바뀐 줄을 따라감)
a124e11 test(e2e) SW 갱신 시험: 바꿀 화면을 TechLog not-found로 둔다. 기대 캐시 목록은 빌드가 선언한 집합(collectStaticAssets)으로 바꾼다(.woff는 캐시 대상이 아니고 media/는 대상이다)
9077a8d test(e2e) 오래된 탭 시험이 홈에서 미리 받지 않는 「프로젝트」·「주제」 청크를 쓴다(탐색은 홈이 modulepreload한다)

고른 방법과 버린 대안

  • 폰트: 고쳐 쓴 폰트 파일을 repo에 두는 안을 버렸다. npm 패키지 대신 바이너리를 직접 관리하게 된다. 경고는 Firefox가 스스로 고치는 순서 문제다. Firefox에서 document.fonts.check가 true이고 상태가 loaded인 것을 확인했다.
  • Studio 로그인: 시험에서 세션 상태를 직접 바꾸는 안을 버렸다. 작업자가 누르는 「로그인 시작」 버튼으로 들어간다. 관문 자체도 같이 지나간다.
  • 템플릿에서 온 시험: 지우지 않고 TechLog 화면으로 옮겼다. 초점, 스크롤 복원, 해시 이동, 부팅 실패 화면, SW 캐시는 이 제품도 가져야 하는 동작이다. 옮기자 실제로 제품 결함 셋이 드러났다.
  • 실패하는 시험을 quarantine으로 돌리지 않았다. 담당자와 만료일을 정해야 하므로 소유자가 정할 일이다.

남은 실패 (이 PR로는 초록이 되지 않는다)

원인 실패하는 시험 종류
A. MOCK Studio에서도 관리 기능이 실제 HTTP로 나간다. create-tech-log-feature-input.ts의 createManagementGateway에 MOCK 분기가 없다. 그래서 로그인한 Studio가 localhost:8080/api/v1/studio/session에 요청하고 연결이 거부된다 Studio 편집기 반응형 40, tech-log-accessibility 7, 경로별 axe의 STUDIO_HOME·DOCUMENT_EDIT 6(009) 제품: mock 관리 gateway(메서드 30개)가 필요하다
B. TechLog Public 화면의 경로 이동 처리가 없다. app-router.tsx는 「shell이 초점을 맡는다」며 이동을 뺐지만 shell에 구현이 없다. 이동 뒤 제목에 초점이 가지 않는다. 뒤로 가기에서 스크롤 위치가 0이 된다. 해시로 열어도 대상으로 가지 않는다 app-shell drawer 3, scroll-restoration 6 제품 + 결정(초점 정책)
C. 부팅 실패 화면이 앱 청크에 묶였다. 예외를 던지는 모듈이 route-not-found 청크에 들어가고, render-boot-failure 청크가 그 청크에서 값 둘을 import한다. 그래서 실패 화면도 못 그리고 「불러오는 중」이 계속된다. PR #6 전(27e342d) 빌드도 같다 boot-module-failure 3 제품: 청크 구성
D. visual 기준 이미지가 8월 18일 것이다. 로그인 관문, 9월 디자인 변경(b9d0585 등), 제목 변경이 전부 차이로 잡힌다. maxDiffPixels: 0 test:visual 131 소유자 검토: 지금 화면을 기준으로 받아들일지
E. WebKit capability가 흔들린다 4번 실행 중 2번, 매번 다른 1~2건(IndexedDB blocked upgrade, Blob download) 이 PR 밖, 기록만
  • A가 고쳐지면 Studio 편집기 시험은 다시 봐야 한다. 9월 편집기 변경(「저장·게시를 아래에 고정」)으로 「저장」 버튼 기대가 아직 맞는지 확인하지 못했다.
  • review:a11y-manual --format-only(009의 두 번째 명령)는 test:a11y가 통과해야 만들어지는 보고서를 읽는다. 지금은 「missing record」로 떨어진다.

위험과 영향

  • 운영 동작이 바뀌는 것은 Question 라벨 색 하나다.
  • 경로별 axe와 visual이 Studio 화면을 실제로 검사하게 되어, A가 고쳐지기 전까지 009의 Studio 두 경로가 빨갛다. 지금까지는 로그인 화면을 검사하고 통과했다.

검증

desktop 호스트, node 24.14.0, CI env(CI=true, VITE_BUILD_ID, SOURCE_DATE_EPOCH), heavy lock 아래에서 돌렸다.

명령 main 7853ff1d 이 브랜치
FE-GATE-001·002·003 (#6에서 0) 0·0·0
FE-GATE-005 0 0
test:e2e 203 실패 / 376 통과 65 실패 / 527 통과 (전부 아래 A·B·C)
test:browser-capabilities 19 실패 0 실패(1회), WebKit 흔들림 1~2(2회)
test:storybook 통과 바꾸지 않음
test:visual 131 실패 돌리지 않음(D)
test:a11y (009) 31 실패 6 실패 / 84 통과 (전부 A)
  • 고친 시험들의 세 엔진 결과
    • SW 갱신 4개×3과 production-csp ×3: 통과.
    • 오래된 탭, HTTP 계약, Studio 작업 흐름, Question axe: 통과.
  • Firefox Pretendard: loaded, document.fonts.check true, h1 글꼴 Pretendard Variable.
  • 로그: desktop /tmp/claude-gates/w1-infra/bfix-logs/. 고치기 전 main은 /tmp/claude-gates/w1-infra/browser/, 남은 게이트 명령은 rest-*.log.

리뷰어가 볼 곳

  • tests/support/browser/strict-browser-test.ts의 정규식: 너무 넓지 않은지.
  • tests/support/browser/tech-log-fixtures.ts의 signInToStudio: 관문이 없는 Studio 경로에서는 버튼을 못 찾아 실패한다. 지금은 모든 Studio 경로가 관문을 거친다.
  • c408cc2 본문의 「남은 실패」: 시험을 고쳐서 생긴 실패가 아니라, 가려져 있던 실패인지.

관련

  • 이전 PR #6(typecheck·unit 게이트).
  • 템플릿 동기화 c80320d, Studio 관문 5e2b1a5, 경로 패턴 서빙 6784eb1.
제목: test(e2e): main의 브라우저 게이트에서 시험 쪽 어긋남을 고치고 남은 제품 결함을 드러낸다 브랜치: tech-log-frontend `fix/browser-gates`, head `9077a8d`(main `7853ff1d` 위, 커밋 9개) ## 무엇을, 왜 main에서 FE-GATE-008(e2e·capability·visual)과 FE-GATE-009(a11y)가 실패한다. 2026-11-12 desktop에서 처음으로 끝까지 돌려 봤다. CI env, Playwright 1.62, 세 엔진으로 돌렸다. 게이트는 첫 실패에서 멈추므로, 뒤 명령은 따로 돌렸다. | 명령 | main `7853ff1d` | | --- | --- | | test:e2e | 203 실패 / 376 통과 / 12 실행 안 됨 | | test:browser-capabilities | 19 실패 / 44 통과 | | test:storybook | 통과 | | test:visual | 131 실패 / 2 통과 | | test:a11y (009) | 31 실패 / 59 통과 | 원인은 크게 셋이다. 1. **Firefox 폰트 경고 하나.** Firefox가 pretendard 1.3.9의 name 표 순서를 경고한다. 공용 fixture가 경고를 실패로 세서, Firefox 실패 대부분(e2e 118, capability 19, a11y 29)이 이것 하나였다. 2. **시험이 제품 변경을 따라오지 못했다.** - 8월 20일 Studio 로그인 관문(`5e2b1a5`). - 같은 날 경로 패턴 서빙(`6784eb1`). - 9월 29일 템플릿 동기화(`c80320d`)로 들어온, 템플릿 예시 화면 전제의 시험 여섯. - mock 검증 결과의 유효 시각(2026-08-14) 지남. 3. **제품 결함.** 시험을 고치자 드러난 것들이다. 이 PR에서는 고치지 않는다(아래 「남은 실패」). ## 바꾼 것 (커밋 하나에 원인 하나) | 커밋 | 고친 것 | | --- | --- | | `0665cd7` test(browser) | Firefox의 Pretendard name 표 경고 **그 문장 하나만** fixture에서 무시한다. 폰트가 거부되면 다른 문장이 나와 여전히 실패한다 | | `cd4fa8c` fix(a11y) | Question 「다음 검증」 라벨의 대비가 4.46:1이다. 이것을 5.85:1로 올린다(`--faint` → `--muted`, 그 두 라벨만) | | `500dbc6` test(e2e) | Studio 시험이 데모 세션으로 로그인한 뒤 본다(`gotoTechLogStudio`). 경로별 axe와 visual도 로그인 화면 대신 실제 Studio 화면을 검사한다 | | `db69e52` test(e2e) | Studio 작업 흐름 시험을 fixture 시계(2026-08-14T01:00Z)로 돌린다 | | `cfe587c` test(e2e) | 모르는 slug(`/projects/missing-project`)는 200 SPA로 기대한다(`6784eb1`). edge 404 예는 `/projects/missing-project/unknown-tab`으로 바꾼다 | | `c408cc2` test(e2e) | app-shell·production-csp·scroll-restoration을 TechLog 화면(홈 「TechLog」, 「프로젝트」, `details.mobile-nav`, 긴 Case)으로 옮긴다 | | `70f3125` test(e2e) | 부팅 실패 fixture가 TechLog 카탈로그를 두 번 합친다(동기화 때 바뀐 줄을 따라감) | | `a124e11` test(e2e) | SW 갱신 시험: 바꿀 화면을 TechLog not-found로 둔다. 기대 캐시 목록은 빌드가 선언한 집합(`collectStaticAssets`)으로 바꾼다(`.woff`는 캐시 대상이 아니고 `media/`는 대상이다) | | `9077a8d` test(e2e) | 오래된 탭 시험이 홈에서 미리 받지 않는 「프로젝트」·「주제」 청크를 쓴다(탐색은 홈이 modulepreload한다) | ## 고른 방법과 버린 대안 - **폰트: 고쳐 쓴 폰트 파일을 repo에 두는 안을 버렸다.** npm 패키지 대신 바이너리를 직접 관리하게 된다. 경고는 Firefox가 스스로 고치는 순서 문제다. Firefox에서 `document.fonts.check`가 true이고 상태가 `loaded`인 것을 확인했다. - **Studio 로그인: 시험에서 세션 상태를 직접 바꾸는 안을 버렸다.** 작업자가 누르는 「로그인 시작」 버튼으로 들어간다. 관문 자체도 같이 지나간다. - **템플릿에서 온 시험: 지우지 않고 TechLog 화면으로 옮겼다.** 초점, 스크롤 복원, 해시 이동, 부팅 실패 화면, SW 캐시는 이 제품도 가져야 하는 동작이다. 옮기자 실제로 제품 결함 셋이 드러났다. - **실패하는 시험을 quarantine으로 돌리지 않았다.** 담당자와 만료일을 정해야 하므로 소유자가 정할 일이다. ## 남은 실패 (이 PR로는 초록이 되지 않는다) | 원인 | 실패하는 시험 | 종류 | | --- | --- | --- | | **A. MOCK Studio에서도 관리 기능이 실제 HTTP로 나간다.** `create-tech-log-feature-input.ts`의 `createManagementGateway`에 MOCK 분기가 없다. 그래서 로그인한 Studio가 `localhost:8080/api/v1/studio/session`에 요청하고 연결이 거부된다 | Studio 편집기 반응형 40, tech-log-accessibility 7, 경로별 axe의 STUDIO_HOME·DOCUMENT_EDIT 6(009) | 제품: mock 관리 gateway(메서드 30개)가 필요하다 | | **B. TechLog Public 화면의 경로 이동 처리가 없다.** `app-router.tsx`는 「shell이 초점을 맡는다」며 이동을 뺐지만 shell에 구현이 없다. 이동 뒤 제목에 초점이 가지 않는다. 뒤로 가기에서 스크롤 위치가 0이 된다. 해시로 열어도 대상으로 가지 않는다 | app-shell drawer 3, scroll-restoration 6 | 제품 + 결정(초점 정책) | | **C. 부팅 실패 화면이 앱 청크에 묶였다.** 예외를 던지는 모듈이 `route-not-found` 청크에 들어가고, `render-boot-failure` 청크가 그 청크에서 값 둘을 import한다. 그래서 실패 화면도 못 그리고 「불러오는 중」이 계속된다. PR #6 전(`27e342d`) 빌드도 같다 | boot-module-failure 3 | 제품: 청크 구성 | | **D. visual 기준 이미지가 8월 18일 것이다.** 로그인 관문, 9월 디자인 변경(`b9d0585` 등), 제목 변경이 전부 차이로 잡힌다. `maxDiffPixels: 0` | test:visual 131 | 소유자 검토: 지금 화면을 기준으로 받아들일지 | | E. WebKit capability가 흔들린다 | 4번 실행 중 2번, 매번 다른 1~2건(IndexedDB blocked upgrade, Blob download) | 이 PR 밖, 기록만 | - A가 고쳐지면 Studio 편집기 시험은 다시 봐야 한다. 9월 편집기 변경(「저장·게시를 아래에 고정」)으로 「저장」 버튼 기대가 아직 맞는지 확인하지 못했다. - `review:a11y-manual --format-only`(009의 두 번째 명령)는 test:a11y가 통과해야 만들어지는 보고서를 읽는다. 지금은 「missing record」로 떨어진다. ## 위험과 영향 - 운영 동작이 바뀌는 것은 Question 라벨 색 하나다. - 경로별 axe와 visual이 Studio 화면을 실제로 검사하게 되어, A가 고쳐지기 전까지 009의 Studio 두 경로가 빨갛다. 지금까지는 로그인 화면을 검사하고 통과했다. ## 검증 desktop 호스트, node 24.14.0, CI env(`CI=true`, `VITE_BUILD_ID`, `SOURCE_DATE_EPOCH`), heavy lock 아래에서 돌렸다. | 명령 | main `7853ff1d` | 이 브랜치 | | --- | --- | --- | | FE-GATE-001·002·003 | (#6에서 0) | 0·0·0 | | FE-GATE-005 | 0 | 0 | | test:e2e | 203 실패 / 376 통과 | 65 실패 / 527 통과 (전부 아래 A·B·C) | | test:browser-capabilities | 19 실패 | 0 실패(1회), WebKit 흔들림 1~2(2회) | | test:storybook | 통과 | 바꾸지 않음 | | test:visual | 131 실패 | 돌리지 않음(D) | | test:a11y (009) | 31 실패 | 6 실패 / 84 통과 (전부 A) | - 고친 시험들의 세 엔진 결과 - SW 갱신 4개×3과 production-csp ×3: 통과. - 오래된 탭, HTTP 계약, Studio 작업 흐름, Question axe: 통과. - Firefox Pretendard: `loaded`, `document.fonts.check` true, h1 글꼴 Pretendard Variable. - 로그: desktop `/tmp/claude-gates/w1-infra/bfix-logs/`. 고치기 전 main은 `/tmp/claude-gates/w1-infra/browser/`, 남은 게이트 명령은 `rest-*.log`. ## 리뷰어가 볼 곳 - `tests/support/browser/strict-browser-test.ts`의 정규식: 너무 넓지 않은지. - `tests/support/browser/tech-log-fixtures.ts`의 `signInToStudio`: 관문이 없는 Studio 경로에서는 버튼을 못 찾아 실패한다. 지금은 모든 Studio 경로가 관문을 거친다. - `c408cc2` 본문의 「남은 실패」: 시험을 고쳐서 생긴 실패가 아니라, 가려져 있던 실패인지. ## 관련 - 이전 PR #6(typecheck·unit 게이트). - 템플릿 동기화 `c80320d`, Studio 관문 `5e2b1a5`, 경로 패턴 서빙 `6784eb1`.
donghyeon.kang added 9 commits 2026-11-12 06:45:21 +00:00
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건.
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 실패).
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 요청이다.
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 모두 통과한다.
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가 세 엔진 모두 통과한다.
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의 화면 열기까지는 통과하고, 위 세
동작에서 떨어진다.
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로 확인했다.
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
모두 통과한다.
old-tab-chunk-recovery 시험은 A 빌드 탭을 연 채 B를 배포하고 「탐색」을
누른다. A의 탐색 청크가 서버에 없으니 탭이 한 번 B로 다시 불러와야 한다.
그런데 홈 화면이 탐색(과 프로필) 청크를 modulepreload로 미리 받는다.
탭이 이미 그 청크를 가지고 있어 서버에 묻지 않고, 다시 불러오기가 0번이라
떨어진다.

미리 받지 않는 「프로젝트」와 「주제」 화면으로 바꾼다. 허용하는 실패
요청 정규식도 그 두 청크 이름으로 바꾼다.

검증: 이 시험이 chromium·firefox·webkit 모두 통과한다. 홈에서 받는
route 청크 목록(explore·case·profile·search·not-found·home)은 빌드한 앱을
열어 performance 항목으로 확인했다.
donghyeon.kang merged commit 032ba31980 into main 2026-11-12 06:45:22 +00:00
Sign in to join this conversation.
No Reviewers
No labels
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: donghyeon.kang/tech-log-frontend#7