docs: 사라진 V2 동작 셋의 판정과 되살린 것을 기록한다
문제 14.7은 V2 삭제로 "401 뒤 세션 복구 재전송"과 "보낸 KEYED 요청 자동 재시도"가 사라졌다고만 적었다. 사용자가 없어져도 되는지 물었고, V2 보안 프로필 일관성 검사도 같이 사라졌다. 고른 방법 14.7에 세 동작의 판정 표를 적었다. 기준은 설계 정본(2026-07-30 closed deep design) 8절이다. - 401 재전송: 없어져도 된다(8.4 FRT-D016 hidden replay 금지). VD-23의 낡은 문장은 리뷰 대상으로 남긴다. - KEYED 자동 재시도: 정본 8.3이 허용하는 부분(재시도를 허락하는 알려진 응답)만 되살렸다(c05f41a). - 보안 프로필 검사: 쿠키 인증 쓰기의 CSRF 요구만 보안 불변식이라 되살렸다 (365d8c3). CHANGELOG에 [보안] 행과 [계약] 행을 더했다. 검증 - verify:documentation PASS_SCOPED, tests/unit/changelog-review-ids.test.ts 통과. Refs: docs/reviews/2026-11-01-maturity-review/README.md 14.7
This commit is contained in:
@@ -616,6 +616,12 @@ Envelope operation에서는 400·409·422와 503 `IDEMPOTENCY_UNAVAILABLE`의 ef
|
||||
| `12f3bb7` | V2 API 행(`defineRestOperation` 등), 기능의 `runtimeSchemas`·`mappers`, V2 보안 프로필 해석(`resolveRestSecurityProfiles` 등), V2/V3 일치 테스트 | FE-REG-API 행을 descriptor에서 뽑는다(`projectApiOperationRows`). `FeatureRuntime`은 `schemas`만 받는다. realtime snapshot 검사는 뽑은 행을 읽는다. 레지스트리 기준선 재승인(digest `16f72742…`, 승인자 `DongHyeonka`) |
|
||||
|
||||
- 초기 JS: 203,354 → 201,598 B(`048f490`) → 200,911 B. 14.6 시작(202,770 B)보다 1,859 B 작다.
|
||||
- 사라진 V2 전용 동작: 401 뒤 세션 복구 후 한 번 재전송, 보낸 KEYED 요청의 503 자동 재시도. 14.6의 "V2와 남은 차이"는 비교할 대상이 없어졌다.
|
||||
- 사라진 V2 전용 동작은 하나씩 판정했다(사용자 질문 "없어지면 안 되는 것 아닌가"). 기준은 현재 설계 정본 `docs/architecture/2026-07-30-frontend-runtime-capability-repository-aligned-implementation-closed-deep-design.md` 8절이다.
|
||||
|
||||
| V2 동작 | 판정 | 근거 | 처리 |
|
||||
|---|---|---|---|
|
||||
| 401 뒤 세션 복구 후 한 번 재전송 | 없어져도 된다 | 정본 8.4(FRT-D016): "401 response 뒤 hidden refresh-and-replay를 하지 않는다". 자격증명 owner가 보내기 전에 토큰을 준비하고, 401은 끝이며, 다시 로그인한 뒤 사용자가 다시 실행한다. V3는 401에서 `onUnauthenticated`를 부르고 세션 화면의 "recover" 동작이 이어 준다 | 코드 변경 없음. VD-23의 "401 recovery는 한 번 수행" 문장은 정본과 어긋난 낡은 문장이다(리뷰 대상) |
|
||||
| 보낸 KEYED 요청의 자동 재시도 | 일부는 있어야 한다 | 정본 8.3: KEYED는 "known response status가 retry 가능하다고 package가 명시한 경우만" 자동 재시도하고, 응답 없는 network·timeout 뒤에는 금지한다. V2는 network·timeout 뒤에도 재시도해 정본과 어긋났다. 반대로 V3는 응답이 재시도를 허락해도 재시도하지 않아 정본보다 좁았다 | 고쳤다(`c05f41a`). Envelope operation이 503 `IDEMPOTENCY_UNAVAILABLE`(실행 전 거절, 백엔드 §2가 같은 키 재전송을 요구)을 받으면 `retryBudget` 안에서 같은 키로 다시 보낸다. 다 쓰면 결과 불명이고 키를 지킨다 |
|
||||
| 보안 프로필 일관성 검사(`resolveRestSecurityProfiles`) | 하나는 있어야 한다 | `auth`·`authProfileId`·`csrfProfileId` 사이의 어긋남 검사는 V3 descriptor에 칸이 하나(`authProfileId`)뿐이라 대상이 없다. 그러나 "쿠키 인증 쓰기는 CSRF 헤더를 요구한다"는 보안 불변식이고, V3 프로필 설치 규칙에는 없었다 | 고쳤다(`365d8c3`). 계약 조립이 쿠키 프로필로 쓰기(GET·HEAD 밖)를 하면서 `x-csrf-token`·`x-xsrf-token`을 요구하지 않는 operation을 거절한다 |
|
||||
- 남긴 것: `src/application/policies/bounded-polling.ts`의 `BoundedPollOperationContract`는 `contractVersion: 2` 필드를 갖지만 realtime polling recipe의 자체 계약이고 V2 HTTP 경로가 아니다. 고치지 않았다.
|
||||
- 다운스트림: tech-log·memento 모두 V2 클라이언트를 부르지 않는다. memento-frontend의 `memento-web` 기능은 V2 API 행을 쓰므로 동기화 때 CHANGELOG의 옮기는 법을 따른다.
|
||||
|
||||
Reference in New Issue
Block a user