fix(objectstorage): 포트 계약 시험을 두고 그 시험이 찾은 결함을 고친다 #35

Merged
donghyeon.kang merged 7 commits from claude/r9-objstore-contract into main 2026-11-13 09:42:53 +00:00
7 Commits
Author SHA1 Message Date
donghyeon.kang 228f20391a Merge branch 'main' into claude/r9-objstore-contract
pr / done (pull_request) Successful in 12m57s
2026-11-13 07:58:21 +00:00
donghyeon.kang e742e47921 Merge branch 'main' into claude/r9-objstore-contract
pr / done (pull_request) Canceled after 4m7s
2026-11-13 06:28:59 +00:00
DongHyeonka d95e8dc0f9 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
2026-11-13 15:09:33 +09:00
DongHyeonka 3e1c629d1f docs(rules): 공유 계약 테스트는 포트가 선언한 것만 단언한다
pr / done (pull_request) Canceled after 0s
시험 규칙 5는 예외 메시지까지 단언하라고 했다. fake와 adapter가 함께
상속하는 계약에서는 메시지가 구현마다 달라 그 규칙을 따를 수 없다.
TESTING_STRATEGY 9.4가 이미 그렇게 정했는데 규칙 문서가 가리키지 않아,
다음 작성자가 메시지 단언을 다시 넣을 수 있었다.

Refs: RR9-03-31
2026-11-13 15:02:10 +09:00
DongHyeonka 1ab96de01d test(objectstorage): 포트 계약을 포트 소유 leaf에 두고 fake와 adapter가 함께 통과하게 한다
문제: capability 기준 5(docs/manual/10-capabilities.md)는 포트를 가진 모듈의
testFixtures에 포트 계약을 두고 fake와 실제 adapter가 모두 통과하게 한다.
application-objectstorage에는 testFixtures도 fake도 없었다. 포트 수준 동작은 adapter
안의 local-dev 시험으로만 봤고, 포트 인터페이스는 결과와 예외를 적지 않았다.
capability-status는 app-bootstrap 통합 시험이 MinIO로 조립한다고 적었지만 실제로는
local-dev다.

고친 것:
- 포트 여덟의 Javadoc에 결과(APPLIED·REPLAYED·REJECTED 등)와 예외 타입을 적었다.
  IllegalArgumentException은 요청 그대로를, IllegalStateException은 지금 상태에서의
  거절이다. 유스케이스가 감싸 기능 오류로 바꾸고, 설정이 틀린 destination은 조립
  오류(500)로 바꾼다(AGENTS 규칙). 예외 메시지는 구현의 것이라 계약이 단언하지 않는다.
- testFixtures testkit: 계약 셋(ManagedObjectStoragePortContract 관리 게시·조회·
  전송·복구 조회·회수, StagedObjectPublicationPortContract 단계 게시·handoff·중단,
  ObjectScanMaintenancePortContract scan gate), in-memory fake InMemoryObjectStorage,
  destination 설명 ObjectStorageDestinationPolicy.
- fake(이 leaf test)와 adapter routing 구현(local-dev, adapter test contract/LocalDev*)이
  같은 계약을 상속한다. adapter 쪽 destination 설명은 조립된 policySnapshot에서 읽는다.
- adapter에서 계약이 드러낸 것 둘:
  - 실패한 managed 게시를 다시 하면 이번 호출이 게시했는데도 REPLAYED였다(stage 재시도는
    APPLIED). 이제 PUBLISHED로 바꾼 호출 하나만 APPLIED다. 같은 key로 겹친 호출은
    REPLAYED다(ManagedPublicationOutcomeTest가 겹침을 결정적으로 재현한다).
  - 검증한 뒤 중단한 stage를 다시 검증하면 REPLAYED였다. 중단된 operation의 검증을
    거절한다.
- 문서: application-objectstorage AGENTS·README, adapter README 「포트 계약」,
  TESTING_STRATEGY 9.4, capability-status Object storage 증거 칸.

버린 대안: MinIO에서 포트 계약 돌리기. S3 provider는 readiness registry에서 아직 배포
대상이 아니다(docs/registries/object-storage-readiness.yaml). 포트 경로를 MinIO로 묶는
일은 S3를 배포 대상으로 올리는 일과 같이 간다. MinIO에서는 provider 계약이 돈다.
남은 것: adapter 전용 ObjectStorageProviderException이 포트 밖으로 나가 바이트
불일치·consumer 실패는 계약이 unchecked 예외까지만 단언한다(RR9-03-34, 따로 고친다).

검증: desktop, :application-objectstorage:check :adapter:outbound:objectstorage:check
:app-bootstrap:architectureTest architectureCheck -p build-logic test 726건 실패 0.
RED: main에 ManagedPublicationOutcomeTest만 → 실패. 돌연변이: adapter의 회수 재시도를
REPLAYED→APPLIED로 바꾸면 계약 1건이 실패한다.

Refs: RR9-03-31, RR9-03-35, RR9-04-46
2026-11-13 13:49:40 +09:00
DongHyeonka b44aa49e7a fix(build-logic): 순수 모듈 testFixtures classpath도 순수성 검사에 넣는다
문제: verifyModuleDependencyPurity는 순수 모듈(application-*, domain-core,
shared-contract)의 compile·runtime·test classpath만 풀어 봤다. test classpath는
testFixturesImplementation을 거쳐 보지만 testFixturesCompileOnly는 보지 않는다. 그래서
공유 fixtures에 Spring을 compileOnly로 두면 순수성 검사를 통과했다. testFixtures를 쓰는
순수 leaf 다섯 곳에 같은 구멍이 있었다.

고친 것: java-test-fixtures를 쓴 순수 모듈은 testFixturesCompileClasspath·
testFixturesRuntimeClasspath도 같은 금지 group으로 본다. 지금 다섯 leaf의 fixtures에는
금지 group이 없어 기존 빌드는 그대로 통과한다(lockfile 대조).

검증: desktop, 기준 4ca61cd9 + 새 functional 시험만 → testFixturesCompileOnly Spring
케이스가 빌드 통과로 실패(RED). 고친 뒤 -p build-logic test 통과(다음 커밋의 GREEN
실행에 포함).

Refs: RR9-04-47
2026-11-13 13:49:40 +09:00
DongHyeonka 42d84d505e fix(objectstorage): 불변 Set으로 만든 요청에서 NPE를 내지 않는다
문제: ObjectRequestSupport.immutableCapabilities가 null 원소를 거르려고
capabilities.contains(null)을 불렀다. JDK의 불변 Set(Set.of, Set.copyOf)은
contains(null)에서 false 대신 NullPointerException을 던진다. 그래서 게시·stage 요청을
Set.of(...) capability로 만들면 생성자가 NPE로 실패했다. 지금 호출자가 모두 EnumSet을
넘겨 드러나지 않았고, 포트 계약 시험(다음 커밋)이 처음 잡았다.

고친 것: 원소를 하나씩 보고 null이면 지금처럼 IllegalArgumentException을 던진다.

검증: desktop, 기준 4ca61cd9에 새 시험만 → 「불변 Set으로 만든 요청」이 NPE로 실패.
고친 뒤 :application-objectstorage:check 통과(다음 커밋의 GREEN 실행에 포함).

Refs: RR9-03-33
2026-11-13 13:49:40 +09:00