From ec7435c3f748e4daee1841d30a683e44f274c60f Mon Sep 17 00:00:00 2001 From: DongHyeonka Date: Tue, 3 Nov 2026 08:02:03 +0900 Subject: [PATCH] =?UTF-8?q?docs(review):=20=EC=B5=9C=EC=A2=85=20=EA=B2=8C?= =?UTF-8?q?=EC=9D=B4=ED=8A=B8=EC=99=80=20=EB=A7=A4=EB=89=B4=EC=96=BC=20?= =?UTF-8?q?=EC=9E=AC=EC=8B=A4=ED=97=98=EC=97=90=EC=84=9C=20=EC=B0=BE?= =?UTF-8?q?=EC=9D=80=20=EA=B2=83=EC=9D=84=20=EC=A0=81=EB=8A=94=EB=8B=A4?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 문제: 결정 반영 묶음을 다 합친 뒤의 게이트 결과, 매뉴얼만으로 기능을 추가한 재실험 결과, 그 과정에서 찾은 결함이 리뷰 README와 CHANGELOG에 없었다. 방법: - 리뷰 README 14.3에 세 가지를 더했다. - create:feature와 참조 기능(V3 실행기)이 짝 백엔드 Envelope 응답을 읽지 못한다(High, P1, 결정 필요라 남김). - 매뉴얼 재실험 결과: 막힘 5건, 예고된 실패 1건. 막힘은 매뉴얼에 메웠다. - webkit old-tab-chunk-recovery 간헐 실패. - 14.5에 7c7ef32 최종 게이트 표를 둔다. - CHANGELOG 알려진 제한에 Envelope 제한과 webkit 간헐 실패를 더했다. 버린 대안: Envelope 제한을 이번에 고치기. V3 실행기에 Envelope 읽기를 넣을지, 백엔드가 problem+json을 보낼지는 두 repo에 걸친 결정이다. 게다가 백엔드 repo는 사람만 커밋한다. 위험: Envelope 제한이 풀리기 전에는 생성한 기능을 짝 백엔드에 바로 붙일 수 없다. 매뉴얼 01-3단계가 이를 적는다. 검증: tests/unit/changelog-review-ids.test.ts 통과. webkit 반복 실행 10/10 통과(load 16). --- CHANGELOG.md | 2 ++ .../2026-11-01-maturity-review/README.md | 17 +++++++++++++++++ 2 files changed, 19 insertions(+) diff --git a/CHANGELOG.md b/CHANGELOG.md index eaecde1b..160723aa 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -121,6 +121,8 @@ - 백엔드 응답 code 정본(`clean-architecture-backend-template/docs/web/http-contract.md`)은 아직 백엔드 repo에 커밋되지 않았다. 그래서 프론트 계약 문서는 커밋 SHA 대신 결정일로 기준을 적었다. 백엔드 application 층이 쓰기 뒤에 `VALIDATION_FAILED`를 던지면 "적용 안 됨" 판정이 틀린다. 지금 백엔드는 이 code를 요청 바인딩 단계에서만 낸다. - 백엔드 필드 검증 code(`NOT_BLANK`, `SIZE` 등)가 폼 문구 표에 없어 "입력값을 확인해 주세요." 기본 문구가 나온다. V3 실행기 진단에는 problem code가 없다. +- **`create:feature`로 만든 기능과 참조 기능(V3 실행기)은 짝 백엔드의 Envelope 응답(`{success, data|error, meta}`)을 그대로 읽지 못한다.** V3는 DTO 본문과 problem details를 읽는다. 백엔드 맞추기는 V2 클라이언트에만 들어갔다. 해결 방법은 아직 정하지 않았다 (1101 README 14.3). +- webkit에서 `old-tab-chunk-recovery.spec.ts`가 가끔 "preload했지만 쓰지 않음" 경고로 실패할 수 있다(한 번 관찰, 10회 반복은 통과). - context 레이아웃의 skip link와 `
`은 타입 주석·문서·테스트로만 지킨다. 실행 검사는 없다 (1101/09-03). - OPFS: lease 밖(FINISH~commit)에서 다른 탭이 같은 partition에 쓰는 경합은 검증하지 않았다 (0929/05-01). - realtime: live-poll handoff coordinator의 마감 4곳은 아직 `IDLE_TIMEOUT`이다 (1101/04-02 범위 밖). diff --git a/docs/reviews/2026-11-01-maturity-review/README.md b/docs/reviews/2026-11-01-maturity-review/README.md index 542a86eb..a7fff703 100644 --- a/docs/reviews/2026-11-01-maturity-review/README.md +++ b/docs/reviews/2026-11-01-maturity-review/README.md @@ -499,6 +499,9 @@ | 적재에 실패한 레지스트리 source를 "missing registry source"로만 적어, 기능 계약의 깨진 import가 파일 없음처럼 보였다 | U6·U3 후속을 합칠 때 실제로 겪었다 | 고쳤다(`3ea7c37`, 새 테스트) | | 등록 라우트가 없는 URL에서 적재가 실패하면 진단 `route_id`가 `NOT_FOUND`다 | NOT_FOUND splat이 모든 URL에 맞아 gateway의 `?? routeModule.id`를 쓰지 않는다 | 남김(14.4) | | `tests/e2e/reference-route.spec.ts`가 세 엔진에서 실패했다. 0929/08-02가 목록 h1을 "참조 기능"으로 바꿨는데 테스트는 영어 route 제목을 기다렸다. 그 수정 때 e2e를 돌리지 않았다 | 14.5 첫 e2e 실행. 화면은 정상(스크린샷) | 고쳤다(`87aebf4`) | +| **생성한 기능은 짝 백엔드 응답을 그대로 읽지 못한다.** `create:feature`와 참조 기능이 쓰는 V3 실행기는 응답 본문을 DTO로 바로 검증하고 오류를 problem details(최상위 `code`)로 읽는다. 짝 백엔드는 모든 JSON 응답을 Envelope(`{success, data\|error, meta}`)로 보낸다. 01-01~02-02의 백엔드 맞추기는 V2 클라이언트만 Envelope에 맞췄다 | `src/adapters/http/index.ts` 41-48행 주석("V2는 봉투를, V3는 DTO 자체를 검증"), `docs/architecture/backend-api-and-server-state-contract.md` 4.1절, 백엔드 `docs/web/http-contract.md` 1절. 매뉴얼 재실험(아래)에서 실험자가 3단계에서 막혔다 | 확인된 결함 · High · P1. 두 템플릿을 짝으로 써서 빨리 출시한다는 목표에 직접 걸린다. 고치려면 결정이 필요하다(V3에 Envelope 읽기 추가 / 백엔드에 problem+json 모드 / BFF가 변환). 남김 | +| 매뉴얼만 보고 기능(`notice-feature`, 목록·상세·작성 폼)을 추가하는 실험 E를 다시 했다. 막힘 5건(각 2~5분), 예고된 실패 1건. 원래 실험 E의 막힘 12곳보다 줄었지만 "막힘 0" 기준은 못 맞췄다 | 실험 브랜치 `worktree-agent-a13a14a7bbd252aad` `b58d131` 본문. 끝 상태: tsc 3종, registries(additive), i18n, 문서 검사, 기능 테스트 21건, unit·component·integration 3,022건 통과 | 막힘 5건은 매뉴얼에 메웠다(`5c2f8b8`). 응답 모양 막힘은 위 결함이 원인이라 매뉴얼에는 제한으로만 적었다 | +| webkit에서 `old-tab-chunk-recovery.spec.ts`가 한 번 실패했다. preload한 청크(badge·card·schema-registry·server-state)를 load 뒤 몇 초 안에 쓰지 않았다는 브라우저 경고를 strict 검사가 실패로 본다 | 14.5 최종 e2e. 같은 커밋에서 webkit 10회 반복은 10/10 통과(load 16) | 간헐 실패 위험 · Low. 08-08이 초기 preload 청크를 늘린 것과 관련 있을 수 있다. 남김 | | `check:remediation-ledger`가 기준 커밋에서도 4건 실패했다(게이트 밖) | 예산 1건은 `313f9ba`로 풀렸다. 테스트가 TR-02~04 ID를 적지 않는 3건은 남았다 | 남김 | ### 14.4 남은 문제와 위험 @@ -514,3 +517,17 @@ - `ui-gallery-page.tsx` component 커버리지 0%(e2e·시각만). - 초기 청크 25개. HTTP/1.1 호스팅이면 다시 본다. - `create:feature --context reference-context`는 참조 라우팅 테스트를 깬다. 생성한 `context-module.ts`는 테스트가 실행하지 않는다. + +### 14.5 최종 게이트 (`7c7ef32`, 오케스트레이터, 2026-11-03 07:29~) + +| 게이트 | 결과 | +|---|---| +| `check:architecture`, `check:types`, `lint`, `check:registries`, `check:ci`, `check:design-system`, `check:i18n`, `check:adapter-inventory`, `verify:documentation`, `build` | 통과 | +| `test:unit` / `test:component` / `test:integration` | 2,603 / 244 / 175건 통과. `test:contract`, `test:runtime-schema`, `test:system` 통과 | +| `check:bundle` | 초기 JS 202,770 / 204,800 B | +| `check:optional-recipes:source` | 4개 예산 안(14.2 0929/05-04) | +| `test:sample-removal` | 23개 검사 통과. 샘플을 지운 뒤 생성 단계 포함 | +| `test:feature-scaffold` | 16개 검사 통과 | +| `test:e2e` (chromium·firefox·webkit) | 186 통과, 1 실패(webkit 간헐, 14.3), 3 skip. 바로 전 실행(`313f9ba`)에서는 `reference-route.spec.ts`가 실패해 `87aebf4`로 고쳤다 | +| `test:visual` | 6 통과. 골든을 다시 찍지 않았다 | +| 실행하지 않음 | 실제 Gitea runner, 실제 HTTPS 호스트 probe, 다운스트림(tech-log·memento) 이식 |