fix(http)!: 계약 문서대로 patch·bulk·포화 오류를 답한다 #25
Closed
donghyeon.kang
wants to merge 0 commits from
claude/r9-c-contracts into main
pull from: claude/r9-c-contracts
merge into: :main
:main
:claude/r9-review-record-2
:docs/improve-review-budget
:claude/r9-objstore-exceptions
:claude/w2-be-flaky-ledger
:claude/r9-a-follow-ups
:claude/r9-b-claim-tx
:claude/w2-be-ci-perf-4
:claude/r9-review-record
:claude/r9-c-tests-build
:claude/r9-c-docs-body
:claude/r9-c-contracts
:claude/r9-compose-ops
:claude/r9-public-surface
:claude/r9-stale-names
:claude/r9-tx-timeouts
:claude/r9-env-keys
:claude/r9-arch-rules
:claude/w2-be-ci-perf-2
:claude/w2-be-ci-perf-2-wip
:claude/redteam-be-fixes-main
:claude/w2-be-ci-perf-e89fe7
:claude/redteam-be-fixes
:claude/t2a-backend-ci-451e3b
:claude/x3-messaging-library-1aa3fa
:claude/x2-grpc-library-43dd09
:claude/h3-backend-harness-34fc23
:claude/v1-vuln-fix-e089b9
:claude/i2-docs-merge-02df15
:claude/d2c-ops-docs-1-c22c9f
:claude/d2a-entry-docs-12a342
:claude/d2b-src-adr-d46d23
:claude/d2d-ops-docs-2-e40938
:claude/i1-layout-docs-merge-217f1e
:refactor/maturity-review-2026-11
:claude/t1-backend-layout-46973e
:claude/d1-docs-system-fd4a0f
:claude/integration-r9-f1bc5c
:claude/r9-g1-inbound-456713
:claude/r9-g3-migration-7ce36d
:claude/r9-g2-stomp-interceptor-f5675d
:claude/r9-g4-idempotency-c669be
:claude/manual-gap-fix-2-9b0fe2
:claude/r8-review-a-3851a7
:claude/integration-r8-a4196a
:claude/r8-f1-transport-errors-b21ebf
:claude/r8-f5-small-fixes-f40412
:claude/r8-f3-persistence-9e8157
:claude/r8-f2-arch-rules-60140e
:claude/r8-f4-idempotency-3a6a0f
:claude/manual-gap-fix-1-824a41
:claude/t4-2-manual-history-ids-9ac57c
:claude/t1-r10-review-d0ecc6
:claude/integration-r7
:claude/t5-idempotency-operation-id-9bd973
:claude/t3-error-codes-loglevel-fcf427
:claude/t1-baseline-7d623a
:claude/t2-circuit-breaker-2ff8df
:claude/t4-manual-history-ids-51889f
:claude/b3-docs-work-34a1dd
:claude/perf-assertions-fail-closed-c09414
:claude/improvement-manual-6ae516
:refactor/review-followup
No Reviewers
Labels
No items
No labels
Milestone
No items
No Milestone
Projects
Clear projects
No projects
Assignees
donghyeon.kang (동현 강)
Clear assignees
No Assignees
Notifications
Due Date
No due date set.
Dependencies
No dependencies set.
Reference: donghyeon.kang/clean-architecture-backend-template#25
Reference in New Issue
Block a user
Blocking a user prevents them from interacting with repositories, such as opening or commenting on pull requests or issues. Learn more about blocking a user.
무엇을, 왜
round9 리뷰 그룹 C의 계약·오류 코드 묶음(B11a web-advanced, B12 fileserver·notification HTTP, B13 전송 오류 코드)을 고친다. 계약 문서·registry와 코드가 갈린 곳을 약속한 응답으로 맞추고, 약속끼리 다른 곳은 리뷰 README 6절의 권하는 안(①②③)으로 정했다.
PATCH_REJECTED. 두 applier가 결과 전체를 Bean Validation으로 검증한다. stream writer가 위치 역행을 쓰기 전에 거절하고, commit 뒤Failure기록이 실패 자신의 코드(없으면INTERNAL_ERROR)와 고정 문구를 싣는다. writer가 하지 않는 heartbeat·idle·버퍼·drain은 계약 문서를 실제대로 고쳤다. virtual thread admission guard가 bean만 있고 요청 경로에서 아무도 부르지 않았다 →VirtualThreadAdmissionFilter.success:true였다 → 공용 bulk envelope. bulk 문구·null 키,Content-RangeCORS 노출, 알림의 모르는 channel·slot·locale →VALIDATION_FAILED(필드 details), template 경로/notificationTemplates, 전송 넷이 기본 파일 이름을 짓지 않음,EnvelopeWireShapeTest빈틈.SERVER_BUSY(503, retryable,Retry-After: 1) 하나. 상태만 아는 503은SERVER_BUSY, async timeout만REQUEST_TIMEOUT. fileserver 오류 code 표 전체, §4의OPERATION_NOT_FOUND, Retry-After를 본문 retryable과 같은 규칙으로.고른 방법과 버린 대안
JOB_EXECUTOR_REJECTED재사용은 백그라운드 job 이름이라 버렸다. fileserver는 같은 이름FileserverErrorCode.SERVER_BUSY를 두고, 이름이 같은 code의 뜻이 같은지FileserverExceptionTest가 본다. 호출자 자신의 동시 전송 초과만 429다./notification-templates를 별칭으로 남기는 안은 버렸다. 같은 자원의 경로가 둘이 된다.정한 기본값
details[]는 공용BulkItemResult모양이라 part별retryable·ambiguous·category가 없다.code로 안다. ①의 결과다.위험과 영향(파생 서비스가 따라 할 일)
docs/upgrade/2026-11-round9-contracts.md1~18행. 요점: patch applier 생성자에Validator, patch·stream·포화 오류 코드가 바뀜, fileserver batch 응답 모양, 알림 template 경로,BulkItemResult.error(index, ApiErrorCode), 이름 없는 업로드 표시 이름file, virtual thread 상한이 실제로 걸림. 커밋!셋.검증
desktop,
--no-build-cache.c1-red-webadv). 동작 RED는 각 시험이 옛 응답을 거절하는 단언(예: JSON이 아닌 본문 → 옛 코드에서 500).check+:app-bootstrap:test·documentContractTest·repositoryContractTest2209건 실패 0(트리9b814124). 리뷰 수정 뒤 web 넷의check+:app-bootstrap:architectureTest+:architectureCheck1027건 실패 0.scripts/verify.sh pr --no-cache: 첫 실행이 새 예외 이름 하나(THROWABLES_ARE_NAMED_EXCEPTION)로 실패해 고쳤다. 최종 head 재실행은 결과를 아래 댓글로 붙인다.check-docs.py·check-work-docs.pyrc=0.377cf176에서 고침.발견 ID 표
18188f78,377cf17618188f78,377cf17618188f78,377cf17618188f7818188f78,377cf17618188f787b5b4c69,377cf1767b5b4c69697e62e87b5b4c697b5b4c69,377cf176697e62e8,377cf1767b5b4c69697e62e8697e62e8697e62e8,377cf176697e62e87b5b4c69697e62e8RR9-05-19(W2A-20)는 그룹 B 몫이라 이 PR에 없다.
관련
docs/reviews/2026-11-12-round9-review/.최종 head
377cf176(트리a4fbf21f6d76)의 desktopscripts/verify.sh pr --no-cache: 6784건 실패 0, 건너뜀 35, rc=0,FROM-CACHE0. 기준d3a90479, 로그 desktop~/claude-r9-c-contracts-logs/pr.log.#28로 병합됐다(main
3d31896a). 이 PR의 head377cf176가 #28 브랜치에 merge 커밋으로 들어 있고, #28의 runnerpr / done이 그 합친 트리로 초록이었다. runner 대기를 줄이려고 이번만 쓴 방식이다(소유자 승인, 2026-11-13).Pull request closed