From e72fb6e290bad739fa55ff4f7a69aa8bd72e852c Mon Sep 17 00:00:00 2001 From: DongHyeonka Date: Thu, 5 Nov 2026 22:32:05 +0900 Subject: [PATCH] =?UTF-8?q?docs(testing):=20=ED=85=8C=EC=8A=A4=ED=8A=B8=20?= =?UTF-8?q?=EC=A0=84=EB=9E=B5=EC=9D=B4=20=EC=A7=80=EC=9A=B4=20auth-recover?= =?UTF-8?q?y=20=ED=85=8C=EC=8A=A4=ED=8A=B8=20=EB=8C=80=EC=8B=A0=20V3?= =?UTF-8?q?=EC=9D=98=20401=20=ED=8C=90=EC=A0=95=EC=9D=84=20=EA=B0=80?= =?UTF-8?q?=EB=A6=AC=ED=82=A8=EB=8B=A4?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 문제 docs/testing/frontend-platform-testing-strategy.md 11.2절이 "401 뒤 인증 복구 흐름은 tests/integration/auth-recovery.test.ts가 다룬다"고 적는다. 그 파일은 V2 클라이언트를 지울 때(048f490a) 같이 지웠고, V3 실행기에는 401 뒤 복구·재전송 흐름이 없다. 문서를 따라가면 없는 테스트와 없는 동작을 찾게 된다. 이 문서는 docs/README.md 1절 밖(목표 설계)이라 verify:documentation이 보지 않는다. 고른 방법 - 문장을 지금 동작으로 고친다: V3는 401을 UNAUTHENTICATED로 끝내고 다시 보내지 않는다(http-execution-v3.ts), 판정은 tests/unit/http-execution-v3.test.ts가 검사한다. 지운 파일 이름은 backtick 경로로 남기지 않는다. - 1103/12-05의 남은 둘(지운 심볼 이름 검사, 1절 밖 문서 검사)은 이 커밋에서 하지 않는다. 심볼 검사는 지난 리뷰가 버린 대안이다(지운 이름 목록을 따로 관리해야 하고 오탐이 많다). 1절 밖 문서는 목표 설계라 일부러 없는 경로를 적는다. 2절 문서의 backtick repo 경로 중 없는 것이 15개쯤이고 대부분 계획 경로다(src/domain, src/generated, V2 파일 등). 검사로 넓히려면 문서별 예외 방식부터 정해야 한다(결정 대기). 위험·한계 - 같은 종류의 옛 경로는 1절 밖 다른 문서에 남아 있다(2026-07-30 결정 정본의 V2 http 파일 등). 이 커밋은 리뷰가 든 한 곳만 고친다. 검증 - 문서만 바꿨다. 이 문서를 보는 자동 검사는 없다(1절 밖). desktop batch에서 corepack pnpm verify:documentation이 그대로 통과하는지만 본다. Refs: 1103/12-05 --- docs/testing/frontend-platform-testing-strategy.md | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/docs/testing/frontend-platform-testing-strategy.md b/docs/testing/frontend-platform-testing-strategy.md index d4fa1549..b32d7bdc 100644 --- a/docs/testing/frontend-platform-testing-strategy.md +++ b/docs/testing/frontend-platform-testing-strategy.md @@ -766,8 +766,10 @@ tests/factories/ | `server-terminal-503` | 503. 조회는 retry 2회 뒤 소진, 명령은 retry 없이 결과 불명(`MAYBE_APPLIED`) | 이 표는 `tests/mocks/scenarios/catalog.ts`의 `HTTP_SCENARIO_IDS`와 같은 순서다. -401 뒤 인증 복구 흐름은 catalog가 아니라 `tests/integration/auth-recovery.test.ts`가 -다룬다. +401 뒤 세션을 복구하고 다시 보내는 흐름은 없다. V3 실행기는 401을 `UNAUTHENTICATED`로 +끝내고 재전송하지 않는다(`src/adapters/http/http-execution-v3.ts`). 그 판정은 +`tests/unit/http-execution-v3.test.ts`가 검사한다. 복구 흐름을 검사하던 V2의 +auth-recovery 통합 테스트는 V2 클라이언트와 함께 지웠다. ### 11.3 Catalog 규칙