test(fileserver): 내용 해시 선조건 거절과 읽기 정책 배선을 시험한다 #81

Merged
donghyeon.kang merged 2 commits from test/fileserver-precondition-and-policy-wiring into main 2026-11-21 16:30:29 +00:00
Owner

무엇을, 왜

fileserver 시험 두 곳이 지키려는 줄을 지워도 통과한다. main 코드는 바꾸지 않고 시험만 고친다. 항목마다 커밋 하나다.

  • REV-BE-0035 (FileLifecycleUseCasesTest): ContentPreconditions.requireDigestMatches는 delete·copy·move가 모두 지키는 내용 해시 선조건이다. copy·move에는 맞지 않는 해시로 도는 시험이 없어 CopyFileApplicationUseCase.java:97을 지워도 :application-fileserver:test가 통과한다. delete 시험은 예외 타입만 본다.
    • copy: 맞지 않는 해시 → PRECONDITION_FAILED, 대상 레코드·복사·쿼터 예약 없음. 맞는 해시 → 대상 namespace에 READY, 쿼터 확정.
    • move: 맞지 않는 해시 → PRECONDITION_FAILED, namespace·출발·대상 사용량 그대로. 맞는 해시 쪽은 이미 있는 moveChangesOnlyTheNamespaceAndNeverTheContentKey(Optional.of(DIGEST))가 본다.
    • delete: 같은 시험이 코드 PRECONDITION_FAILED까지 단언한다.
  • REV-BE-0027 (FileserverCompositionIntegrationTest): 「읽기 역할 없음 → 거절」 시험의 호출자에게 file:read 매핑이 없어, 다운로드 유스케이스의 권한 gate가 fileserver 정책보다 먼저 403을 낸다. read-roles 배선이 틀려도 이 클래스는 초록이다.
    • 시험 환경에 ROLE_READ_ELSEWHERE=file:read를 더하고, ROLE_FILE_WRITE+ROLE_READ_ELSEWHERE 호출자의 다운로드가 403·ACCESS_DENIED인지 보는 시험을 더한다.
    • 옛 시험은 downloadWithoutTheReadPermissionIsRefusedByThePermissionGate로 이름을 바꾸고 AUTHZ_INSUFFICIENT_PERMISSION을 함께 단언한다.

고른 방법과 버린 대안

  • 0027 호출자에 쓰기 역할을 함께 든다. 항목이 예로 든 ROLE_READ_ELSEWHERE 하나만이면 항목의 변이(read-roles 자리에 write-roles)에서도 그 호출자는 읽기 집합에 없어 거절되고, RED가 나오지 않는다. ROLE_FILE_WRITE를 함께 들면 원래 배선에서는 읽기 역할이 없어 ACCESS_DENIED, 변이 배선에서는 다운로드가 성공해 시험이 실패한다. gate는 ROLE_READ_ELSEWHERE로 통과하고 호출자는 파일 소유자라, 거절은 fileserver 정책의 읽기 역할 검사에서만 나온다.
  • 0027 errorCodeOf: 본문이 오류 envelope가 아니면(거절돼야 할 요청이 성공해 파일 바이트가 온 경우) 본문을 그대로 돌려준다. 그래야 실패 메시지가 파싱 예외가 아니라 돌아온 상태와 본문을 보여 준다(RED 1회차에서 그 꼴을 보고 고쳤다).
  • 0035 오래된 값: 다른 내용의 SHA-256 꼴(STALE_DIGEST)로 둬 거절이 비교에서만 나오게 했다. delete 시험의 옛 값 "\"stale\""도 이것으로 바꿨다.
  • 버린 안(0027): 옛 시험에 code 단언만 더하기. 그 호출자로는 gate code가 나와 배선을 증명하지 못한다.

위험과 영향

  • main 코드는 바꾸지 않았다. 운영 영향이 없다.
  • FileserverCompositionIntegrationTest는 integration lane이라 PR run에서 돌지 않는다. 아래 desktop RED 드라이버의 green-it가 그 lane 전체(:app-bootstrap:integrationTest, 필터 없음)를 이 트리에서 돌린 결과다.
  • web-fileserver controller가 If-Match를 copy·move에 넘기는 경로는 0035 범위 밖이라 시험하지 않는다.
  • 정정(항목 0027): 항목은 「이 클래스의 시험 4개」라 적었지만 @Test는 3개다(4번째 grep 결과는 @Testcontainers). 고친 뒤 4개다.

검증

RED·GREEN — desktop 드라이버(red.sh, 로그 ~/be-lane-n4-n3red2-logs/). origin/main 위에서 변이 확인을 먼저 돌리고, 커밋 둘을 git am해 트리 f6ee393e6d3a(노트북 HEAD 트리와 같음)에서 GREEN과 변이 넷을 돌렸다. 변이는 main 코드 한 줄씩이다. 명령: flock /tmp/claude-gates/heavy.lock ./gradlew <task> --no-daemon --console=plain --no-build-cache.

실행 변이(main 한 줄) task rc 실패한 시험
green-fs 없음 :application-fileserver:test --tests FileLifecycleUseCasesTest 0 없음(26)
green-it 없음 :app-bootstrap:integrationTest(lane 전체) 0 없음(11)
m1 CopyFileApplicationUseCase.java:97 삭제 fs 1 copyWithAStaleDigestIsRefusedBeforeAnythingIsWritten — actual ["no failure", …] vs PRECONDITION_FAILED
m2 MoveFileApplicationUseCase.java:85 삭제 fs 1 moveWithAStaleDigestIsRefusedAndTheFileStays — actual ["no failure", tenant-b, 0L, …]
m3 ContentPreconditions.java:25 PRECONDITION_FAILED→CONCURRENT_MODIFICATION fs 1 delete·copy·move 맞지 않는 해시 시험 셋 — actual [CONCURRENT_MODIFICATION, …]
m4 FileserverSecurityConfiguration.java:53 readRoles()→writeRoles() it 1 downloadByAWriterWhoseReadPermissionComesFromAnotherTierIsRefusedByTheFileserverPolicy — actual [200, "round-trip payload: …"] vs [403, "ACCESS_DENIED"]
  • 변이 확인(고치기 전 트리 origin/main b2bfb9bb): (m1)을 넣고 :application-fileserver:test 전체 rc=0(376 통과, 실패 0). (m4)를 넣고 :app-bootstrap:integrationTest 전체 rc=0(10 통과, 실패 0 — 이 클래스의 옛 시험 3개 포함).
  • (m3)은 항목의 「CONFLICT로 바꾸기」다. FileserverErrorCode에 CONFLICT라는 이름은 없어 같은 409 CONFLICT 범주의 CONCURRENT_MODIFICATION을 썼다.

gate:

  • desktop scripts/verify.sh leaf :application-fileserver --log be-lane-n4-n3-leaf-fs — rc=0, tests=379 failures=0 errors=0 skipped=0(트리 f6ee393e6d, HEAD 트리와 같음)
  • desktop scripts/verify.sh leaf :app-bootstrap --log be-lane-n4-n3-leaf-app — rc=0, tests=334 failures=0 errors=0 skipped=5
  • desktop scripts/verify.sh pr --no-cache --log be-lane-n4-n3-pr — rc=0, tests=7350 failures=0 errors=0 skipped=35
  • 노트북 scripts/verify.sh docs — rc=0
  • PR run pr / done — run 508(head 6af38df5) success

리뷰어가 볼 곳

  • 0027 새 시험의 Javadoc: 왜 쓰기 역할을 함께 드는지.
  • 0035 copyWithTheCurrentDigestProceeds: 쿼터 확정까지 보는 이유는 「맞는 해시 → 진행」이 대상 namespace에 실제로 기록되는지 보기 위해서다.

리뷰 반영

  • 종류 A, 새 눈 1회(Sonnet 5.5, 렌즈 .claude/skills/be-testing/SKILL.md). 발견 없음. 리뷰가 실행으로 확인하라고 남긴 것(error.code 문자열)은 RED·GREEN의 integration lane으로 확인했다.
  • 리뷰 뒤 스스로 고친 것 하나(Low): errorCodeOf가 JSON이 아닌 본문에서 파싱 예외를 내던 것(위 「고른 방법」). 고친 뒤 RED·verify를 다시 돌렸다.

관련

  • 리뷰 항목 REV-BE-0035, REV-BE-0027
## 무엇을, 왜 fileserver 시험 두 곳이 지키려는 줄을 지워도 통과한다. main 코드는 바꾸지 않고 시험만 고친다. 항목마다 커밋 하나다. - **REV-BE-0035** (`FileLifecycleUseCasesTest`): `ContentPreconditions.requireDigestMatches`는 delete·copy·move가 모두 지키는 내용 해시 선조건이다. copy·move에는 맞지 않는 해시로 도는 시험이 없어 `CopyFileApplicationUseCase.java:97`을 지워도 `:application-fileserver:test`가 통과한다. delete 시험은 예외 타입만 본다. - copy: 맞지 않는 해시 → `PRECONDITION_FAILED`, 대상 레코드·복사·쿼터 예약 없음. 맞는 해시 → 대상 namespace에 READY, 쿼터 확정. - move: 맞지 않는 해시 → `PRECONDITION_FAILED`, namespace·출발·대상 사용량 그대로. 맞는 해시 쪽은 이미 있는 `moveChangesOnlyTheNamespaceAndNeverTheContentKey`(`Optional.of(DIGEST)`)가 본다. - delete: 같은 시험이 코드 `PRECONDITION_FAILED`까지 단언한다. - **REV-BE-0027** (`FileserverCompositionIntegrationTest`): 「읽기 역할 없음 → 거절」 시험의 호출자에게 `file:read` 매핑이 없어, 다운로드 유스케이스의 권한 gate가 fileserver 정책보다 먼저 403을 낸다. read-roles 배선이 틀려도 이 클래스는 초록이다. - 시험 환경에 `ROLE_READ_ELSEWHERE=file:read`를 더하고, `ROLE_FILE_WRITE`+`ROLE_READ_ELSEWHERE` 호출자의 다운로드가 403·`ACCESS_DENIED`인지 보는 시험을 더한다. - 옛 시험은 `downloadWithoutTheReadPermissionIsRefusedByThePermissionGate`로 이름을 바꾸고 `AUTHZ_INSUFFICIENT_PERMISSION`을 함께 단언한다. ## 고른 방법과 버린 대안 - **0027 호출자에 쓰기 역할을 함께 든다.** 항목이 예로 든 `ROLE_READ_ELSEWHERE` 하나만이면 항목의 변이(read-roles 자리에 write-roles)에서도 그 호출자는 읽기 집합에 없어 거절되고, RED가 나오지 않는다. `ROLE_FILE_WRITE`를 함께 들면 원래 배선에서는 읽기 역할이 없어 `ACCESS_DENIED`, 변이 배선에서는 다운로드가 성공해 시험이 실패한다. gate는 `ROLE_READ_ELSEWHERE`로 통과하고 호출자는 파일 소유자라, 거절은 fileserver 정책의 읽기 역할 검사에서만 나온다. - **0027 `errorCodeOf`:** 본문이 오류 envelope가 아니면(거절돼야 할 요청이 성공해 파일 바이트가 온 경우) 본문을 그대로 돌려준다. 그래야 실패 메시지가 파싱 예외가 아니라 돌아온 상태와 본문을 보여 준다(RED 1회차에서 그 꼴을 보고 고쳤다). - **0035 오래된 값:** 다른 내용의 SHA-256 꼴(`STALE_DIGEST`)로 둬 거절이 비교에서만 나오게 했다. delete 시험의 옛 값 `"\"stale\""`도 이것으로 바꿨다. - 버린 안(0027): 옛 시험에 code 단언만 더하기. 그 호출자로는 gate code가 나와 배선을 증명하지 못한다. ## 위험과 영향 - main 코드는 바꾸지 않았다. 운영 영향이 없다. - `FileserverCompositionIntegrationTest`는 integration lane이라 PR run에서 돌지 않는다. 아래 desktop RED 드라이버의 `green-it`가 그 lane 전체(`:app-bootstrap:integrationTest`, 필터 없음)를 이 트리에서 돌린 결과다. - web-fileserver controller가 If-Match를 copy·move에 넘기는 경로는 0035 범위 밖이라 시험하지 않는다. - 정정(항목 0027): 항목은 「이 클래스의 시험 4개」라 적었지만 `@Test`는 3개다(4번째 grep 결과는 `@Testcontainers`). 고친 뒤 4개다. ## 검증 RED·GREEN — desktop 드라이버(`red.sh`, 로그 `~/be-lane-n4-n3red2-logs/`). origin/main 위에서 변이 확인을 먼저 돌리고, 커밋 둘을 `git am`해 트리 `f6ee393e6d3a`(노트북 HEAD 트리와 같음)에서 GREEN과 변이 넷을 돌렸다. 변이는 main 코드 한 줄씩이다. 명령: `flock /tmp/claude-gates/heavy.lock ./gradlew <task> --no-daemon --console=plain --no-build-cache`. | 실행 | 변이(main 한 줄) | task | rc | 실패한 시험 | |---|---|---|---|---| | green-fs | 없음 | `:application-fileserver:test --tests FileLifecycleUseCasesTest` | 0 | 없음(26) | | green-it | 없음 | `:app-bootstrap:integrationTest`(lane 전체) | 0 | 없음(11) | | m1 | `CopyFileApplicationUseCase.java:97` 삭제 | fs | 1 | `copyWithAStaleDigestIsRefusedBeforeAnythingIsWritten` — actual `["no failure", …]` vs `PRECONDITION_FAILED` | | m2 | `MoveFileApplicationUseCase.java:85` 삭제 | fs | 1 | `moveWithAStaleDigestIsRefusedAndTheFileStays` — actual `["no failure", tenant-b, 0L, …]` | | m3 | `ContentPreconditions.java:25` `PRECONDITION_FAILED`→`CONCURRENT_MODIFICATION` | fs | 1 | delete·copy·move 맞지 않는 해시 시험 셋 — actual `[CONCURRENT_MODIFICATION, …]` | | m4 | `FileserverSecurityConfiguration.java:53` `readRoles()`→`writeRoles()` | it | 1 | `downloadByAWriterWhoseReadPermissionComesFromAnotherTierIsRefusedByTheFileserverPolicy` — actual `[200, "round-trip payload: …"]` vs `[403, "ACCESS_DENIED"]` | - 변이 확인(고치기 전 트리 origin/main b2bfb9bb): (m1)을 넣고 `:application-fileserver:test` 전체 rc=0(376 통과, 실패 0). (m4)를 넣고 `:app-bootstrap:integrationTest` 전체 rc=0(10 통과, 실패 0 — 이 클래스의 옛 시험 3개 포함). - (m3)은 항목의 「CONFLICT로 바꾸기」다. `FileserverErrorCode`에 `CONFLICT`라는 이름은 없어 같은 409 CONFLICT 범주의 `CONCURRENT_MODIFICATION`을 썼다. gate: - desktop `scripts/verify.sh leaf :application-fileserver --log be-lane-n4-n3-leaf-fs` — rc=0, tests=379 failures=0 errors=0 skipped=0(트리 f6ee393e6d3a, HEAD 트리와 같음) - desktop `scripts/verify.sh leaf :app-bootstrap --log be-lane-n4-n3-leaf-app` — rc=0, tests=334 failures=0 errors=0 skipped=5 - desktop `scripts/verify.sh pr --no-cache --log be-lane-n4-n3-pr` — rc=0, tests=7350 failures=0 errors=0 skipped=35 - 노트북 `scripts/verify.sh docs` — rc=0 - PR run `pr / done` — run 508(head 6af38df5) success ## 리뷰어가 볼 곳 - 0027 새 시험의 Javadoc: 왜 쓰기 역할을 함께 드는지. - 0035 `copyWithTheCurrentDigestProceeds`: 쿼터 확정까지 보는 이유는 「맞는 해시 → 진행」이 대상 namespace에 실제로 기록되는지 보기 위해서다. ## 리뷰 반영 - 종류 A, 새 눈 1회(Sonnet 5.5, 렌즈 `.claude/skills/be-testing/SKILL.md`). 발견 없음. 리뷰가 실행으로 확인하라고 남긴 것(`error.code` 문자열)은 RED·GREEN의 integration lane으로 확인했다. - 리뷰 뒤 스스로 고친 것 하나(Low): `errorCodeOf`가 JSON이 아닌 본문에서 파싱 예외를 내던 것(위 「고른 방법」). 고친 뒤 RED·verify를 다시 돌렸다. ## 관련 - 리뷰 항목 REV-BE-0035, REV-BE-0027
donghyeon.kang added 2 commits 2026-11-21 16:10:54 +00:00
ContentPreconditions.requireDigestMatches는 delete·copy·move가 모두
지키는 내용 버전 선조건이다. 해시가 다르면 PRECONDITION_FAILED를 낸다.
copy·move 시험에는 맞지 않는 해시로 도는 시험이 없어, 두 유스케이스의
선조건 호출 줄을 지워도 :application-fileserver:test가 통과한다. delete
시험은 예외 타입만 보아 거절 코드를 바꿔도 통과한다.

FileLifecycleUseCasesTest에 시험 셋을 더하고 하나를 고친다.
- copy: 맞지 않는 해시면 PRECONDITION_FAILED이고 대상 레코드·복사·쿼터
  예약이 없다. 맞는 해시면 대상 namespace에 READY 파일을 만들고 그
  크기를 쿼터에 확정한다.
- move: 맞지 않는 해시면 PRECONDITION_FAILED이고 namespace와 출발·대상
  사용량이 그대로다. 맞는 해시 쪽은 이미 있는
  moveChangesOnlyTheNamespaceAndNeverTheContentKey(Optional.of(DIGEST))가
  본다.
- delete: 같은 시험이 거절 코드 PRECONDITION_FAILED도 단언한다.
오래된 값은 다른 내용의 SHA-256 꼴(STALE_DIGEST)로 둬 거절이 비교에서만
나올 수 있게 했다. delete 시험의 옛 값 "\"stale\""도 이것으로 바꿨다.

위험·한계: main 코드는 바꾸지 않았다. web-fileserver controller가
If-Match를 넘기는 경로는 이 항목 범위 밖이라 시험하지 않는다.

검증: desktop RED·GREEN은 PR 본문에 둔다.

Refs: REV-BE-0035
downloadWithoutTheReadRoleIsRefused의 Javadoc은 이 시험이 조립이 주입한
정책에 닿는다는 것을 증명한다고 적는다. 그러나 호출자 ROLE_UNRELATED에는
file:read 매핑이 없어, 다운로드 유스케이스의 @RequiresPermission
("file:read") gate가 정책보다 먼저 403을 낸다. 단언이 상태 코드뿐이라
read-roles 배선이 틀려도 이 클래스는 초록이다.

시험 환경에 ROLE_READ_ELSEWHERE=file:read 매핑을 더하고, 그 역할과
ROLE_FILE_WRITE를 든 호출자의 다운로드가 403·ACCESS_DENIED인지 보는
시험을 더한다. gate는 통과하고 호출자는 파일 소유자이니 거절은
fileserver 정책의 읽기 역할 검사에서만 나온다. 쓰기 역할을 함께 든 것은
일부러다. read-roles 자리에 write-roles를 넘기는 배선이면 이 호출자가
다운로드에 성공해 시험이 실패한다. 항목이 예로 든 ROLE_READ_ELSEWHERE
하나만으로는 그 배선에서도 거절돼 회귀를 잡지 못한다.

옛 시험은 downloadWithoutTheReadPermissionIsRefusedByThePermissionGate로
이름을 바꾸고 code AUTHZ_INSUFFICIENT_PERMISSION을 함께 단언한다.
버린 안: 옛 시험에 code 단언만 더하기. 그 호출자로는 gate code가 나와
배선을 증명하지 못한다.

위험·한계: main의 권한 설정과 정책 코드는 바꾸지 않았다. 이 클래스는
integration lane이라 PR run에서 돌지 않는다. desktop에서 그 lane을 돌린
결과를 PR 본문에 둔다.

검증: desktop RED·GREEN은 PR 본문에 둔다.

Refs: REV-BE-0027
donghyeon.kang merged commit b884bb11dd into main 2026-11-21 16:30:29 +00:00
Sign in to join this conversation.
No Reviewers
No labels
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: donghyeon.kang/clean-architecture-backend-template#81