test(fileserver): admin 유스케이스가 자기 접근 연산을 묻는지 시험한다 #87

Merged
donghyeon.kang merged 3 commits from test/fileserver-admin-access-checks into main 2026-11-21 19:32:03 +00:00
Owner

무엇을, 왜

FileOperation(FileOperation.java:6)은 「공개 진입점마다 연산 하나를 묻고, 검사 안 하는 연산은 없다」고 약속한다. lifecycle·upload 시험은 이 약속을 본다. admin 쪽 여섯(orphan 적용, upload 정리, reverify, orphan 목록, 미완료 upload 목록, runtime capability 조회)은 accessPolicy.authorize(...) 줄을 지우거나 연산을 바꿔도 :application-fileserver:test가 통과한다. 시험의 FakeFileAccessPolicy는 기본이 허용이고, admin 거절 시험은 storage health와 force delete 둘뿐이다. main 코드는 바꾸지 않는다. 시험만 더하며 커밋은 하나다.

  • REV-BE-0034 (FileserverAdminUseCasesTest), 새 시험 셋:
    • everyAdminOperationConsultsItsOwnAccessOperation: admin 패키지의 유스케이스 여덟을 한 번씩 부르고, policy가 받은 연산 순서를 containsExactly로 본다.
    • anOrphanApplyWithoutTheSecondAuthorityRemovesNothing: deny(ADMIN_FORCE_DELETE)이면 맞는 fingerprint를 보내도 거절된다. 저장소 삭제·quarantine·cleanup queue가 모두 비어 있다(C2).
    • anUploadCleanupWithoutTheSecondAuthorityClaimsNothing: 같은 거절이면 queue의 요청이 claim되지 않고 그대로 남는다.

고른 방법과 버린 대안

  • 순서 단언: 운영 정책(RoleBasedFileAccessPolicy.java:91)은 세 admin 연산을 같은 tier로 묶는다. 그래서 ADMIN_FORCE_DELETE→ADMIN_READ 변이는 운영 동작이 같다. 기본이 허용인 fake가 받은 연산 순서를 보는 것만이 잘못 물은 연산을 잡는다.
  • 여섯이 아니라 여덟: 항목이 말한 여섯에 storage health·force delete를 더했다. 그래야 이름의 「every」가 맞다. 그 둘은 이미 다른 시험이 지키므로 RED 변이에는 넣지 않았다.
  • 정리 서비스: CleanupUploadsApplicationUseCase에는 testkit fake(InMemoryCleanupQueue, FakeCleanupContentGateway, RecordingQuotaReclaimGateway)로 조립한 실제 DefaultCleanupService를 넣었다. 시험 안에 private fake를 만들지 않는다.
  • 버린 안: web-fileserver controller 시험에서 403을 보기. permission gate가 먼저 403을 내서 이 검사를 증명하지 못한다.

위험과 영향

  • main 코드와 RoleBasedFileAccessPolicy는 바꾸지 않았다. 운영 영향이 없다.
  • 순서 단언은 서로 메우는 변이(한 유스케이스가 검사를 빼고 다른 유스케이스가 같은 연산을 한 번 더 묻는 경우)는 잡지 못한다. 지금 코드에는 그런 경로가 없다.

검증

RED·GREEN은 desktop 드라이버(red.sh)로 돌렸다. 로그는 ~/be-lane-n5-p1red2-logs/다. 먼저 origin/main b884bb11 위에서 변이를 넣고 모듈 전체를 돌렸다. 다음에 커밋을 git am해 트리 1b461721f07b(노트북 HEAD 트리와 같음)에서 GREEN과 변이 일곱을 하나씩 돌렸다. 명령: flock /tmp/claude-gates/heavy.lock ./gradlew :application-fileserver:test [--tests …FileserverAdminUseCasesTest] --no-daemon --console=plain --no-build-cache.

실행 변이(main 한 줄) 범위 rc 실패한 시험
pre-a m1 + m3~m7 함께, 고치기 전 트리 모듈 전체 0 없음(379 통과)
pre-b m2 + m3~m7 함께, 고치기 전 트리 모듈 전체 0 없음(379 통과)
green 없음 클래스 0 없음(18)
m1 ReconcileOrphansApplicationUseCase.java:54 ADMIN_FORCE_DELETE→ADMIN_READ 클래스 1 anOrphanApplyWithoutTheSecondAuthorityRemovesNothing(예외 없음), everyAdminOperation…(6번째 ADMIN_READ)
m2 같은 파일 :54 검사 삭제 클래스 1 같은 둘
m3 CleanupUploadsApplicationUseCase.java:48 검사 삭제 클래스 1 anUploadCleanupWithoutTheSecondAuthorityClaimsNothing(예외 없음), everyAdminOperation…
m4 ReverifyFileApplicationUseCase.java:58 검사 삭제 클래스 1 everyAdminOperation…(ADMIN_REVERIFY 빠짐)
m5 ListOrphansApplicationUseCase.java:38 검사 삭제 클래스 1 everyAdminOperation…(ADMIN_READ 셋)
m6 ListIncompleteUploadsApplicationUseCase.java:54 검사 삭제 클래스 1 everyAdminOperation…(ADMIN_READ 셋)
m7 GetRuntimeCapabilitiesApplicationUseCase.java:37 검사 삭제 클래스 1 everyAdminOperation…(ADMIN_READ 셋)
  • 「검사 삭제」는 그 줄을 Objects.requireNonNull(accessPolicy, "accessPolicy");로 바꾼 것이다. 줄만 지우면 Error Prone UnusedVariable(필드를 읽지 않음)이 -Werror로 컴파일을 깬다. 변이 로그에 컴파일 오류는 없다.
  • pre-a·pre-b는 m1과 m2가 같은 줄을 바꾸기 때문에 둘로 나눴다.

gate(노트북 detached worktree, 트리 1b461721f0, HEAD 트리와 같음):

  • desktop scripts/verify.sh leaf :application-fileserver --no-cache --log be-lane-n5-p1-leaf-fs: rc=0, tests=382 failures=0 errors=0 skipped=0, FROM-CACHE 0
  • desktop scripts/verify.sh pr --no-cache --log be-lane-n5-p1-pr: rc=0, tests=7353 failures=0 errors=0 skipped=35, FROM-CACHE 0
  • 노트북 scripts/verify.sh docs: rc=0
  • PR run pr / done: run 521(head f2269d8c) success

리뷰어가 볼 곳

  • everyAdminOperationConsultsItsOwnAccessOperation: 기대 목록의 줄마다 붙인 주석이 callEveryAdminOperationOnce 안의 호출 순서와 같다.
  • 두 거절 시험의 상태 단언은 이 repo 규칙(.claude/rules/java-tests.md 5, then은 한 번에 비교)에 맞춰 List.of(...) 하나로 묶었다. 대신 .as(...)로 각 자리의 이름을 붙였다.

리뷰 반영

  • 종류 A, 새 눈 1회(Sonnet 5.5, 렌즈 .claude/skills/be-testing/SKILL.md). 발견: High 0, Medium 0, Low 1, Minor 2. 확인 리뷰 0회.
    • Low(상태 단언 묶음은 실패 메시지가 어느 자리가 틀렸는지 말하지 않는다): 나누라는 권고는 rule 5(한 번에 비교)와 맞지 않는다. 그래서 묶음은 두고 .as("[deleted objects, quarantined keys, queued cleanup]")·.as("[claim sweeps, queued cleanup]")로 자리 이름을 붙였다.
    • Minor(기대 목록 인덱스와 유스케이스 대응이 안 보인다): 기대 목록 줄마다 유스케이스 이름 주석을 달았다.
    • Minor(서로 메우는 변이는 못 잡는다): 코드는 바꾸지 않았다. 위 「위험과 영향」에 적었다.
  • 반영은 커밋을 amend했다(트리 36418621 → 1b461721). RED·verify는 반영한 트리에서 다시 돌렸다(위 표와 gate). 반영 전 트리의 RED 1회차(~/be-lane-n5-p1red-logs/)도 결과가 같았다.

관련

  • 리뷰 항목 REV-BE-0034(묶음 REV-BE-0047 be4-core의 PR 1)
## 무엇을, 왜 `FileOperation`(`FileOperation.java:6`)은 「공개 진입점마다 연산 하나를 묻고, 검사 안 하는 연산은 없다」고 약속한다. lifecycle·upload 시험은 이 약속을 본다. admin 쪽 여섯(orphan 적용, upload 정리, reverify, orphan 목록, 미완료 upload 목록, runtime capability 조회)은 `accessPolicy.authorize(...)` 줄을 지우거나 연산을 바꿔도 `:application-fileserver:test`가 통과한다. 시험의 `FakeFileAccessPolicy`는 기본이 허용이고, admin 거절 시험은 storage health와 force delete 둘뿐이다. main 코드는 바꾸지 않는다. 시험만 더하며 커밋은 하나다. - **REV-BE-0034** (`FileserverAdminUseCasesTest`), 새 시험 셋: - `everyAdminOperationConsultsItsOwnAccessOperation`: admin 패키지의 유스케이스 여덟을 한 번씩 부르고, policy가 받은 연산 순서를 `containsExactly`로 본다. - `anOrphanApplyWithoutTheSecondAuthorityRemovesNothing`: `deny(ADMIN_FORCE_DELETE)`이면 맞는 fingerprint를 보내도 거절된다. 저장소 삭제·quarantine·cleanup queue가 모두 비어 있다(C2). - `anUploadCleanupWithoutTheSecondAuthorityClaimsNothing`: 같은 거절이면 queue의 요청이 claim되지 않고 그대로 남는다. ## 고른 방법과 버린 대안 - **순서 단언:** 운영 정책(`RoleBasedFileAccessPolicy.java:91`)은 세 admin 연산을 같은 tier로 묶는다. 그래서 `ADMIN_FORCE_DELETE`→`ADMIN_READ` 변이는 운영 동작이 같다. 기본이 허용인 fake가 받은 연산 순서를 보는 것만이 잘못 물은 연산을 잡는다. - **여섯이 아니라 여덟:** 항목이 말한 여섯에 storage health·force delete를 더했다. 그래야 이름의 「every」가 맞다. 그 둘은 이미 다른 시험이 지키므로 RED 변이에는 넣지 않았다. - **정리 서비스:** `CleanupUploadsApplicationUseCase`에는 testkit fake(`InMemoryCleanupQueue`, `FakeCleanupContentGateway`, `RecordingQuotaReclaimGateway`)로 조립한 실제 `DefaultCleanupService`를 넣었다. 시험 안에 private fake를 만들지 않는다. - 버린 안: web-fileserver controller 시험에서 403을 보기. permission gate가 먼저 403을 내서 이 검사를 증명하지 못한다. ## 위험과 영향 - main 코드와 `RoleBasedFileAccessPolicy`는 바꾸지 않았다. 운영 영향이 없다. - 순서 단언은 서로 메우는 변이(한 유스케이스가 검사를 빼고 다른 유스케이스가 같은 연산을 한 번 더 묻는 경우)는 잡지 못한다. 지금 코드에는 그런 경로가 없다. ## 검증 RED·GREEN은 desktop 드라이버(`red.sh`)로 돌렸다. 로그는 `~/be-lane-n5-p1red2-logs/`다. 먼저 origin/main b884bb11 위에서 변이를 넣고 모듈 전체를 돌렸다. 다음에 커밋을 `git am`해 트리 `1b461721f07b`(노트북 HEAD 트리와 같음)에서 GREEN과 변이 일곱을 하나씩 돌렸다. 명령: `flock /tmp/claude-gates/heavy.lock ./gradlew :application-fileserver:test [--tests …FileserverAdminUseCasesTest] --no-daemon --console=plain --no-build-cache`. | 실행 | 변이(main 한 줄) | 범위 | rc | 실패한 시험 | |---|---|---|---|---| | pre-a | m1 + m3~m7 함께, 고치기 전 트리 | 모듈 전체 | 0 | 없음(379 통과) | | pre-b | m2 + m3~m7 함께, 고치기 전 트리 | 모듈 전체 | 0 | 없음(379 통과) | | green | 없음 | 클래스 | 0 | 없음(18) | | m1 | `ReconcileOrphansApplicationUseCase.java:54` `ADMIN_FORCE_DELETE`→`ADMIN_READ` | 클래스 | 1 | `anOrphanApplyWithoutTheSecondAuthorityRemovesNothing`(예외 없음), `everyAdminOperation…`(6번째 `ADMIN_READ`) | | m2 | 같은 파일 `:54` 검사 삭제 | 클래스 | 1 | 같은 둘 | | m3 | `CleanupUploadsApplicationUseCase.java:48` 검사 삭제 | 클래스 | 1 | `anUploadCleanupWithoutTheSecondAuthorityClaimsNothing`(예외 없음), `everyAdminOperation…` | | m4 | `ReverifyFileApplicationUseCase.java:58` 검사 삭제 | 클래스 | 1 | `everyAdminOperation…`(`ADMIN_REVERIFY` 빠짐) | | m5 | `ListOrphansApplicationUseCase.java:38` 검사 삭제 | 클래스 | 1 | `everyAdminOperation…`(`ADMIN_READ` 셋) | | m6 | `ListIncompleteUploadsApplicationUseCase.java:54` 검사 삭제 | 클래스 | 1 | `everyAdminOperation…`(`ADMIN_READ` 셋) | | m7 | `GetRuntimeCapabilitiesApplicationUseCase.java:37` 검사 삭제 | 클래스 | 1 | `everyAdminOperation…`(`ADMIN_READ` 셋) | - 「검사 삭제」는 그 줄을 `Objects.requireNonNull(accessPolicy, "accessPolicy");`로 바꾼 것이다. 줄만 지우면 Error Prone `UnusedVariable`(필드를 읽지 않음)이 `-Werror`로 컴파일을 깬다. 변이 로그에 컴파일 오류는 없다. - pre-a·pre-b는 m1과 m2가 같은 줄을 바꾸기 때문에 둘로 나눴다. gate(노트북 detached worktree, 트리 1b461721f07b, HEAD 트리와 같음): - desktop `scripts/verify.sh leaf :application-fileserver --no-cache --log be-lane-n5-p1-leaf-fs`: rc=0, tests=382 failures=0 errors=0 skipped=0, FROM-CACHE 0 - desktop `scripts/verify.sh pr --no-cache --log be-lane-n5-p1-pr`: rc=0, tests=7353 failures=0 errors=0 skipped=35, FROM-CACHE 0 - 노트북 `scripts/verify.sh docs`: rc=0 - PR run `pr / done`: run 521(head f2269d8c) success ## 리뷰어가 볼 곳 - `everyAdminOperationConsultsItsOwnAccessOperation`: 기대 목록의 줄마다 붙인 주석이 `callEveryAdminOperationOnce` 안의 호출 순서와 같다. - 두 거절 시험의 상태 단언은 이 repo 규칙(`.claude/rules/java-tests.md` 5, then은 한 번에 비교)에 맞춰 `List.of(...)` 하나로 묶었다. 대신 `.as(...)`로 각 자리의 이름을 붙였다. ## 리뷰 반영 - 종류 A, 새 눈 1회(Sonnet 5.5, 렌즈 `.claude/skills/be-testing/SKILL.md`). 발견: High 0, Medium 0, Low 1, Minor 2. 확인 리뷰 0회. - Low(상태 단언 묶음은 실패 메시지가 어느 자리가 틀렸는지 말하지 않는다): 나누라는 권고는 rule 5(한 번에 비교)와 맞지 않는다. 그래서 묶음은 두고 `.as("[deleted objects, quarantined keys, queued cleanup]")`·`.as("[claim sweeps, queued cleanup]")`로 자리 이름을 붙였다. - Minor(기대 목록 인덱스와 유스케이스 대응이 안 보인다): 기대 목록 줄마다 유스케이스 이름 주석을 달았다. - Minor(서로 메우는 변이는 못 잡는다): 코드는 바꾸지 않았다. 위 「위험과 영향」에 적었다. - 반영은 커밋을 amend했다(트리 36418621 → 1b461721). RED·verify는 반영한 트리에서 다시 돌렸다(위 표와 gate). 반영 전 트리의 RED 1회차(`~/be-lane-n5-p1red-logs/`)도 결과가 같았다. ## 관련 - 리뷰 항목 REV-BE-0034(묶음 REV-BE-0047 be4-core의 PR 1)
donghyeon.kang added 1 commit 2026-11-21 17:54:13 +00:00
FileOperation은 공개 진입점마다 연산 하나를 묻고 검사 안 하는 연산은
없다고 약속한다. lifecycle·upload 시험에는 그 약속을 보는 시험이
있지만 admin 쪽에는 없다. orphan 적용·upload 정리·reverify·orphan
목록·미완료 upload 목록·runtime capability 조회의 authorize 줄을
지우거나 연산을 바꿔도 :application-fileserver:test가 통과한다. 시험의
FakeFileAccessPolicy는 기본이 허용이고, admin 거절 시험은 storage
health와 force delete 둘뿐이다.

FileserverAdminUseCasesTest에 시험 셋을 더한다.
- everyAdminOperationConsultsItsOwnAccessOperation: admin 패키지의
  유스케이스 여덟을 한 번씩 부르고 policy가 받은 연산 순서를 본다.
  항목이 말한 여섯에 storage health·force delete를 더해 이름의
  「every」가 맞게 했다. 운영 정책은 세 admin 연산을 같은 tier로 묶어
  연산을 바꿔도 동작이 같으므로, 순서 단언만이 잘못 물은 연산을 잡는다.
- anOrphanApplyWithoutTheSecondAuthorityRemovesNothing: ADMIN_FORCE_DELETE
  거절이면 맞는 fingerprint를 보내도 저장소 삭제·quarantine·cleanup
  queue가 모두 비어 있다.
- anUploadCleanupWithoutTheSecondAuthorityClaimsNothing: 같은 거절이면
  queue에 있던 요청이 claim되지 않고 그대로 남는다. 정리 서비스는
  testkit fake로 조립한 DefaultCleanupService다.

버린 안: web-fileserver controller 시험에서 403을 보기. permission
gate가 먼저 403을 내서 이 검사를 증명하지 못한다.

위험·한계: main 코드와 RoleBasedFileAccessPolicy는 바꾸지 않았다.

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

Refs: REV-BE-0034
donghyeon.kang added 1 commit 2026-11-21 18:22:52 +00:00
donghyeon.kang added 1 commit 2026-11-21 18:46:02 +00:00
donghyeon.kang merged commit 92ae78f8fb into main 2026-11-21 19:32:03 +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#87