docs(review): 최종 게이트와 매뉴얼 재실험에서 찾은 것을 적는다
문제: 결정 반영 묶음을 다 합친 뒤의 게이트 결과, 매뉴얼만으로 기능을
추가한 재실험 결과, 그 과정에서 찾은 결함이 리뷰 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).
This commit is contained in:
@@ -121,6 +121,8 @@
|
|||||||
|
|
||||||
- 백엔드 응답 code 정본(`clean-architecture-backend-template/docs/web/http-contract.md`)은 아직 백엔드 repo에 커밋되지 않았다. 그래서 프론트 계약 문서는 커밋 SHA 대신 결정일로 기준을 적었다. 백엔드 application 층이 쓰기 뒤에 `VALIDATION_FAILED`를 던지면 "적용 안 됨" 판정이 틀린다. 지금 백엔드는 이 code를 요청 바인딩 단계에서만 낸다.
|
- 백엔드 응답 code 정본(`clean-architecture-backend-template/docs/web/http-contract.md`)은 아직 백엔드 repo에 커밋되지 않았다. 그래서 프론트 계약 문서는 커밋 SHA 대신 결정일로 기준을 적었다. 백엔드 application 층이 쓰기 뒤에 `VALIDATION_FAILED`를 던지면 "적용 안 됨" 판정이 틀린다. 지금 백엔드는 이 code를 요청 바인딩 단계에서만 낸다.
|
||||||
- 백엔드 필드 검증 code(`NOT_BLANK`, `SIZE` 등)가 폼 문구 표에 없어 "입력값을 확인해 주세요." 기본 문구가 나온다. V3 실행기 진단에는 problem 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와 `<main>`은 타입 주석·문서·테스트로만 지킨다. 실행 검사는 없다 (1101/09-03).
|
- context 레이아웃의 skip link와 `<main>`은 타입 주석·문서·테스트로만 지킨다. 실행 검사는 없다 (1101/09-03).
|
||||||
- OPFS: lease 밖(FINISH~commit)에서 다른 탭이 같은 partition에 쓰는 경합은 검증하지 않았다 (0929/05-01).
|
- OPFS: lease 밖(FINISH~commit)에서 다른 탭이 같은 partition에 쓰는 경합은 검증하지 않았다 (0929/05-01).
|
||||||
- realtime: live-poll handoff coordinator의 마감 4곳은 아직 `IDLE_TIMEOUT`이다 (1101/04-02 범위 밖).
|
- realtime: live-poll handoff coordinator의 마감 4곳은 아직 `IDLE_TIMEOUT`이다 (1101/04-02 범위 밖).
|
||||||
|
|||||||
@@ -499,6 +499,9 @@
|
|||||||
| 적재에 실패한 레지스트리 source를 "missing registry source"로만 적어, 기능 계약의 깨진 import가 파일 없음처럼 보였다 | U6·U3 후속을 합칠 때 실제로 겪었다 | 고쳤다(`3ea7c37`, 새 테스트) |
|
| 적재에 실패한 레지스트리 source를 "missing registry source"로만 적어, 기능 계약의 깨진 import가 파일 없음처럼 보였다 | U6·U3 후속을 합칠 때 실제로 겪었다 | 고쳤다(`3ea7c37`, 새 테스트) |
|
||||||
| 등록 라우트가 없는 URL에서 적재가 실패하면 진단 `route_id`가 `NOT_FOUND`다 | NOT_FOUND splat이 모든 URL에 맞아 gateway의 `?? routeModule.id`를 쓰지 않는다 | 남김(14.4) |
|
| 등록 라우트가 없는 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`) |
|
| `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건은 남았다 | 남김 |
|
| `check:remediation-ledger`가 기준 커밋에서도 4건 실패했다(게이트 밖) | 예산 1건은 `313f9ba`로 풀렸다. 테스트가 TR-02~04 ID를 적지 않는 3건은 남았다 | 남김 |
|
||||||
|
|
||||||
### 14.4 남은 문제와 위험
|
### 14.4 남은 문제와 위험
|
||||||
@@ -514,3 +517,17 @@
|
|||||||
- `ui-gallery-page.tsx` component 커버리지 0%(e2e·시각만).
|
- `ui-gallery-page.tsx` component 커버리지 0%(e2e·시각만).
|
||||||
- 초기 청크 25개. HTTP/1.1 호스팅이면 다시 본다.
|
- 초기 청크 25개. HTTP/1.1 호스팅이면 다시 본다.
|
||||||
- `create:feature --context reference-context`는 참조 라우팅 테스트를 깬다. 생성한 `context-module.ts`는 테스트가 실행하지 않는다.
|
- `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) 이식 |
|
||||||
|
|||||||
Reference in New Issue
Block a user