Files
clean-architecture-backend-…/docs/upgrade/2026-11-round9-objectstorage.md
T
DongHyeonka d95e8dc0f9
pr / done (pull_request) Canceled after 0s
docs(upgrade): objectstorage 포트 계약이 바꾼 결과를 파생 서비스에 알린다
실패한 managed 게시를 다시 하면 APPLIED가 되고, 중단한 stage의 재검증은
IllegalStateException이 되며, 불변 Set capability가 동작한다. 이 셋과
testFixtures의 fake·계약을 쓰는 법을 업그레이드 안내에 적는다.

Refs: RR9-03-31, RR9-03-33, RR9-03-35
2026-11-13 15:09:33 +09:00

1.9 KiB

업그레이드 안내 — 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와 포트 계약을 쓴다 — 더하기만 한 변경 객체 저장소를 쓰는 유스케이스를 시험하는 서비스