Files
clean-architecture-frontend…/recipes
DongHyeonka 762393a940 fix(contracts): 짝 백엔드 pin을 백엔드 main d32b4b53으로 옮긴다
문제: pin(45d2a478)이 백엔드 main보다 한참 뒤라 drift 검사가 exit 1이다.
그사이 백엔드가 폴더를 다시 배치하고(scaffold 원본 셋의 경로) 샘플을
지웠다. 계약 문서 6.1절 근거 파일 넷과 위치 목록이 main에 없고, 매뉴얼
04는 pin과 다른 bbe944bd를 기준이라 적는다. Fileserver 업로드 client의
게시 전 5xx 표는 pin 대조 밖이다(1105/01-02). 백엔드 697e62e8c부터
fileserver의 permit·pool 포화가 429에서 503 SERVER_BUSY로 바뀌어, client는
작업 전에 거절된 업로드를 결과 불명으로 읽는다.

고른 방법(R9-D4):
- pin, 답 표 source, 표 사본(--write-excerpt)을 d32b4b53으로 옮긴다.
  §4의 새 행 404 OPERATION_NOT_FOUND는 durable operation 조회의 답이라
  notCopied에 이유와 함께 둔다.
- scaffold 원본 세 경로를 새 위치로 고친다(내용 0줄 변경 확인).
- pin에 backend.codeSources를 더한다. Fileserver code 파일과 게시 전
  5xx 표(codes)를 적고, readers에 fileserver-upload.ts를 넣는다. drift
  검사가 그 파일들의 변경과, pin 커밋에 없는 경로(옮겨진 파일)를 알린다.
  pin 시험이 client 표와 pin 사본을 양쪽으로 대조한다.
- NOT_APPLIED_5XX_CODES에 SERVER_BUSY를 더한다. raise 자리 둘
  (TransferAdmissionController, BlockingTransferExecutor)이 모두 작업 전이다.
- 6.1절 표의 백엔드 파일:줄을 d32b4b53에서 다시 찾았다. 판정은 같다.
  샘플과 함께 사라진 근거(참조 도메인 행, WorkLogWebMapper 등)는 뺐고,
  새 출처(PatchBodies, 알림 컨트롤러 필드 거절)를 적었다.
- 매뉴얼 04의 기준을 pin으로 바꾸고 백엔드 경로 셋을 고친다.
버린 대안: 문서만 옛 pin 기준으로 맞추기 — drift 검사는 계속 막힌다.

위험·한계: V3 경로의 503 SERVER_BUSY는 상태만 정해진 모든 503에도 붙어
code로 단계를 가를 수 없다. 그래서 V3 표에 넣지 않고 결과 불명 쪽에
둔다(6.1절). 백엔드 main은 계속 움직이므로 다음 백엔드 병합 뒤 drift가
다시 1일 수 있다(설계된 신호).

검증: 노트북, 공유 clone(d32b4b53)으로
node scripts/check-backend-contract-drift.ts --backend <clone>: 옮기기 전
exit 1(문서·scaffold 4건), 옮긴 뒤 exit 0. desktop RED — pin·drift·
업로드 표 시험이 고치기 전 코드에서 실패
(/tmp/claude-gates/r9b-pr1-red/exec_node.log). merge 단계는 PR 본문.

Refs: 1112/02-05, 1112/08-18, 1105/01-02
2026-11-13 19:02:07 +09:00
..