From c6c86dc377cbed1da491d2c60c537efcacd29756 Mon Sep 17 00:00:00 2001 From: DongHyeonka Date: Fri, 6 Nov 2026 05:37:39 +0900 Subject: [PATCH] =?UTF-8?q?docs(contracts):=20bulk=20operation=EC=9D=80=20?= =?UTF-8?q?responseEnvelope=20NONE=EC=9D=98=20=EB=B3=84=EB=8F=84=20?= =?UTF-8?q?=EA=B8=B0=EC=97=AC=EC=97=90=20=EB=91=90=EB=9D=BC=EA=B3=A0=20?= =?UTF-8?q?=EC=A0=81=EB=8A=94=EB=8B=A4?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 문제: 계약 문서 4.1절 끝 줄이 bulk 엔드포인트를 붙이려면 "responseEnvelope를 빼고" 기능 스키마가 본문 전체를 읽으라고 적는다. 1103/16-01(56272e8) 뒤 그 칸은 descriptor 타입의 필수 칸이라 빼면 check:types가 실패한다. 같은 기여에 "NONE"을 적으면 조립이 "a contribution is one backend's package ... split the contribution per backend"로 거절해 부팅과 check:registries가 실패한다. 같은 절의 바로 위 줄은 "빠뜨리면 check:types가 실패한다"고 적는다. 56272e8이 위 줄만 고치고 이 줄을 남겼다. 고른 방법: 그 줄을 "그 operation을 responseEnvelope: "NONE" as const로 적고 별도 계약 기여에 둔다. 기능 스키마가 본문 전체를 읽고 classifyProblem이 적용 여부를 정한다"로 고친다. 한 기여의 operation은 같은 값을 적는다는 규칙과, 한 기능이 기여 둘을 낼 수 있다는 근거(external-contract-runtime 단위 테스트 "lets one feature read two backends through two contributions")를 함께 적는다. 리뷰 16-02는 이 항목에 합쳐졌다. 버린 대안: bulk 기여를 조립하는 새 테스트(같은 꼴의 조립은 위 테스트가 이미 본다). 위험·한계: bulk 지원 여부는 여전히 결정 대기(1103/03-02)다. 지원으로 정해지면 이 줄을 그 방법으로 바꾼다. bulk operation을 실제로 붙여 돌려 보지는 않았다. 검증: git grep -n 'responseEnvelope.\{0,4\}를 빼' -- docs ':!docs/reviews' 0건 (노트북). desktop batch에서 확인: corepack pnpm verify:documentation Refs: 1106/07-01 --- .../architecture/backend-api-and-server-state-contract.md | 8 ++++++-- 1 file changed, 6 insertions(+), 2 deletions(-) diff --git a/docs/architecture/backend-api-and-server-state-contract.md b/docs/architecture/backend-api-and-server-state-contract.md index 6845ad83..5ca7d3f4 100644 --- a/docs/architecture/backend-api-and-server-state-contract.md +++ b/docs/architecture/backend-api-and-server-state-contract.md @@ -203,8 +203,12 @@ Envelope의 모양과 키 존재 규칙은 짝 백엔드 템플릿 문서가 정 `page`는 버리고 응답은 그대로 읽는다. 목록 화면의 전체 수는 `page.total`이다. 배열 길이는 첫 페이지 크기(기본 20)일 뿐이다. - bulk 응답(`results`, `BATCH_PARTIAL_FAILURE`)은 지원하지 않는다. 성공 status의 - `results` Envelope는 `ENVELOPE_MISMATCH`다. bulk 엔드포인트를 붙이려면 - `responseEnvelope`를 빼고 기능 스키마가 본문 전체를 읽는다. + `results` Envelope는 `ENVELOPE_MISMATCH`다. bulk 엔드포인트를 붙이려면 그 + operation을 `responseEnvelope: "NONE" as const`로 적고 별도 계약 기여에 둔다(한 + 기여의 operation은 같은 값을 적는다. 기능 하나가 기여 둘을 낼 수 있다, + `tests/unit/external-contract-runtime.test.ts` "lets one feature read two backends + through two contributions"). 기능 스키마가 본문 전체를 읽고 `classifyProblem`이 + 적용 여부를 정한다. ### 4.2 Status와 error