docs(upgrade): objectstorage 포트 계약이 바꾼 결과를 파생 서비스에 알린다
pr / done (pull_request) Canceled after 0s

실패한 managed 게시를 다시 하면 APPLIED가 되고, 중단한 stage의 재검증은
IllegalStateException이 되며, 불변 Set capability가 동작한다. 이 셋과
testFixtures의 fake·계약을 쓰는 법을 업그레이드 안내에 적는다.

Refs: RR9-03-31, RR9-03-33, RR9-03-35
This commit is contained in:
DongHyeonka
2026-11-13 15:09:33 +09:00
parent 3e1c629d1f
commit d95e8dc0f9
@@ -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`와 포트 계약을 쓴다 | — 더하기만 한 변경 | 객체 저장소를 쓰는 유스케이스를 시험하는 서비스 |