From d95e8dc0f9f525f155ab17fa21562001c46dd660 Mon Sep 17 00:00:00 2001 From: DongHyeonka Date: Fri, 13 Nov 2026 15:09:33 +0900 Subject: [PATCH] =?UTF-8?q?docs(upgrade):=20objectstorage=20=ED=8F=AC?= =?UTF-8?q?=ED=8A=B8=20=EA=B3=84=EC=95=BD=EC=9D=B4=20=EB=B0=94=EA=BE=BC=20?= =?UTF-8?q?=EA=B2=B0=EA=B3=BC=EB=A5=BC=20=ED=8C=8C=EC=83=9D=20=EC=84=9C?= =?UTF-8?q?=EB=B9=84=EC=8A=A4=EC=97=90=20=EC=95=8C=EB=A6=B0=EB=8B=A4?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 실패한 managed 게시를 다시 하면 APPLIED가 되고, 중단한 stage의 재검증은 IllegalStateException이 되며, 불변 Set capability가 동작한다. 이 셋과 testFixtures의 fake·계약을 쓰는 법을 업그레이드 안내에 적는다. Refs: RR9-03-31, RR9-03-33, RR9-03-35 --- docs/upgrade/2026-11-round9-objectstorage.md | 19 +++++++++++++++++++ 1 file changed, 19 insertions(+) create mode 100644 docs/upgrade/2026-11-round9-objectstorage.md diff --git a/docs/upgrade/2026-11-round9-objectstorage.md b/docs/upgrade/2026-11-round9-objectstorage.md new file mode 100644 index 00000000..284c3e0a --- /dev/null +++ b/docs/upgrade/2026-11-round9-objectstorage.md @@ -0,0 +1,19 @@ +# 업그레이드 안내 — 2026-11 objectstorage 포트 계약 + +- 범위: `application-objectstorage` 포트의 결과와 거절을 포트 Javadoc에 적고, fake와 local-dev adapter가 같은 계약 + 시험을 통과하게 맞춘 변경. 결과가 바뀐 호출이 셋 있다. 아래 표가 그 목록이다. +- 근거: 2026-11-12 전체 리뷰(`docs/reviews/2026-11-12-round9-review/`)의 objectstorage 포트 계약 발견 + +## 1. 누가 읽나 + +이 템플릿을 `upstream` remote로 두고 merge해 받으면서 객체 저장소 포트(`ManagedObjectPublicationPort` 등)를 쓰는 +파생 서비스가 읽는다. 포트를 쓰지 않으면 할 일이 없다. + +## 2. 할 일 + +| # | 할 일 | 안 하면 | 해당 서비스 | +| --- | --- | --- | --- | +| 1 | 실패한 managed 게시를 같은 operation key로 다시 했을 때의 결과를 확인한다. 이제 이번 호출이 게시를 끝냈으면 `APPLIED`다(전에는 `REPLAYED`). 같은 key로 겹친 호출은 `PUBLISHED`로 바꾼 하나만 `APPLIED`다 | 재시도 결과가 `REPLAYED`라고 보고 분기하던 코드가 다른 길로 간다 | `ManagedObjectPublicationPort.publish`를 재시도하는 서비스 | +| 2 | 중단한 stage를 다시 검증하지 않는다. 이제 `verifyIntegrity`가 `IllegalStateException`으로 거절한다(전에는 검증 뒤 중단한 stage를 다시 검증하면 `REPLAYED`) | 그 호출이 예외로 끝난다 | `StagedObjectPublicationPort`를 쓰는 서비스 | +| 3 | 불변 `Set`(`Set.of`)으로 capability를 넘겨도 된다. 전에는 요청을 만들 때 `NullPointerException`이 났다 | — 고치기만 한 변경 | 게시·stage 요청을 만드는 서비스 | +| 4 | 유스케이스 시험에서 포트 대역이 필요하면 `testImplementation testFixtures(project(':application-objectstorage'))`로 `InMemoryObjectStorage`와 포트 계약을 쓴다 | — 더하기만 한 변경 | 객체 저장소를 쓰는 유스케이스를 시험하는 서비스 |