fix(arch): 아키텍처 규칙이 놓친 HARD-STOP 2 사각지대 다섯을 닫는다 #19
Closed
donghyeon.kang
wants to merge 0 commits from
claude/r9-arch-rules into main
pull from: claude/r9-arch-rules
merge into: :main
:main
:claude/r9-review-record-2
:docs/improve-review-budget
:claude/r9-objstore-exceptions
:claude/w2-be-flaky-ledger
:claude/r9-a-follow-ups
:claude/r9-b-claim-tx
:claude/w2-be-ci-perf-4
:claude/r9-review-record
:claude/r9-c-tests-build
:claude/r9-c-docs-body
:claude/r9-c-contracts
:claude/r9-compose-ops
:claude/r9-public-surface
:claude/r9-stale-names
:claude/r9-tx-timeouts
:claude/r9-env-keys
:claude/r9-arch-rules
:claude/w2-be-ci-perf-2
:claude/w2-be-ci-perf-2-wip
:claude/redteam-be-fixes-main
:claude/w2-be-ci-perf-e89fe7
:claude/redteam-be-fixes
:claude/t2a-backend-ci-451e3b
:claude/x3-messaging-library-1aa3fa
:claude/x2-grpc-library-43dd09
:claude/h3-backend-harness-34fc23
:claude/v1-vuln-fix-e089b9
:claude/i2-docs-merge-02df15
:claude/d2c-ops-docs-1-c22c9f
:claude/d2a-entry-docs-12a342
:claude/d2b-src-adr-d46d23
:claude/d2d-ops-docs-2-e40938
:claude/i1-layout-docs-merge-217f1e
:refactor/maturity-review-2026-11
:claude/t1-backend-layout-46973e
:claude/d1-docs-system-fd4a0f
:claude/integration-r9-f1bc5c
:claude/r9-g1-inbound-456713
:claude/r9-g3-migration-7ce36d
:claude/r9-g2-stomp-interceptor-f5675d
:claude/r9-g4-idempotency-c669be
:claude/manual-gap-fix-2-9b0fe2
:claude/r8-review-a-3851a7
:claude/integration-r8-a4196a
:claude/r8-f1-transport-errors-b21ebf
:claude/r8-f5-small-fixes-f40412
:claude/r8-f3-persistence-9e8157
:claude/r8-f2-arch-rules-60140e
:claude/r8-f4-idempotency-3a6a0f
:claude/manual-gap-fix-1-824a41
:claude/t4-2-manual-history-ids-9ac57c
:claude/t1-r10-review-d0ecc6
:claude/integration-r7
:claude/t5-idempotency-operation-id-9bd973
:claude/t3-error-codes-loglevel-fcf427
:claude/t1-baseline-7d623a
:claude/t2-circuit-breaker-2ff8df
:claude/t4-manual-history-ids-51889f
:claude/b3-docs-work-34a1dd
:claude/perf-assertions-fail-closed-c09414
:claude/improvement-manual-6ae516
:refactor/review-followup
No Reviewers
Labels
No items
No labels
Milestone
No items
No Milestone
Projects
Clear projects
No projects
Assignees
donghyeon.kang (동현 강)
Clear assignees
No Assignees
Notifications
Due Date
No due date set.
Dependencies
No dependencies set.
Reference: donghyeon.kang/clean-architecture-backend-template#19
Reference in New Issue
Block a user
Blocking a user prevents them from interacting with repositories, such as opening or commenting on pull requests or issues. Learn more about blocking a user.
무엇을, 왜
round9 리뷰의 High 둘(RR9-05-01·02)과 같은 원인의 Medium 셋(RR9-05-03~05)을 고친다. 저장소 전체 ArchUnit suite가 HARD-STOP 2와 매뉴얼 07 「시스템이 부르는 쓰기」의 약속을 막지 못하는 길이 다섯이었다.
*Repository(생성 명령이dev.caskeleton.domain.<feature>에 둠)·application*StorePort·*QueryPort를 들어도 통과ENDPOINTS_DO_NOT_HOLD_PERSISTENCE_PORTS..adapter.inbound..밖 사용자 전송이나 표시 없는 중간 클래스를 거쳐@SystemInvoked유스케이스에 닿아도 통과, bootstrap controller 금지가 문서뿐USER_TRANSPORTS_DO_NOT_REACH_SYSTEM_CALLERS전이 대상에@SystemInvoked유스케이스, 새 규칙CONTROLLERS_LIVE_IN_INBOUND_ADAPTERSAuthorizationManager,AuthenticationProvider, chain DSL)이 사용자 전송이 아님registration.interceptors(x)로 넘기면 설정이 안 걸림capabilityProjects에 inbound messaging이 없어 suite가 그 모듈을 못 읽음runtimeOnly줄에 더함매뉴얼 07 규칙 표와 app
AGENTS.md를 같이 고쳤다.고른 방법과 버린 대안
*Port전부를 못 쓰게 하는 안은 버렸다. web이AuthorizationPort·CorrelationIdPort를 구현·사용해 맞는 코드가 걸린다. 그래서 영속 포트(*Repository·*StorePort·*QueryPort)와 endpoint(controller·gRPC 서비스)로 좁혔다.*IdFactory는 지금DurableOperationController가 쓰고 있어 규칙에서 뺐다. 그 controller의 id 생성은 RR9-05-13으로 따로 고친다.위험과 영향
architectureCheck가 새로 실패한다 — 문서에 이미 적힌 금지(HARD-STOP 2, app AGENTS)를 검사가 지키게 된 것이다.io.grpc가 architectureTest 컴파일 classpath에 없어 두지 않았다(판정은io.grpc.BindableService이름).검증
desktop,
--no-build-cache, 로그~/r9-be-logs/b14-{red,green2}.log.a7e38c10+ 새 fixture·시험(새 규칙 대신 기존 규칙을 부르는 변형)만으로ArchitectureViolationFixtureTest204건 중 5건 실패 — 다섯 위반 모두 기존 규칙에 안 걸림. 허용 시험은 통과.:app-bootstrap:resolveAndLockAll --write-locks(잠금 변화 없음),spotlessApply뒤:app-bootstrap:architectureTest259건 실패 0,:app-bootstrap:testQualityCheck,:app-bootstrap:spotlessCheck,:verifyDependencyLocks,:architectureCheckrc=0.check-docs.pyrc=0.check-work-docs.py는 main의operate.md151줄 때문에만 rc=1(PR #15가 고침).리뷰어가 볼 곳
ApplicationBoundaryArchitectureTest의ARE_PROJECT_REQUEST_HANDLERS: 설정이 쥔 프로젝트 클래스의 상위 타입 판정. 설정용 타입(WebMvcConfigurer등)을 구현한 익명 클래스는 빼서 기존 허용 fixture가 그대로 통과한다.AdapterBoundaryArchitectureTest의ARE_PERSISTENCE_PORTS이름 규칙.관련
docs/reviews/2026-11-12-round9-review/RR9-05-01~05.문제: 저장소 전체 ArchUnit suite가 약속한 것을 막지 못하는 길이 다섯이다. 1. controller가 domain repository 포트(생성 명령이 aggregate 옆 dev.caskeleton.domain.<feature>에 두는 <Aggregate>Repository)를 주입해도 걸리지 않는다. 규칙은 ..repository.. 패키지와 Spring Data·JPA 타입만 본다. gRPC 서비스는 controller 판정에 들지 않는다(HARD-STOP 2). 2. ..adapter.inbound.. 밖의 사용자 전송(조립 모듈의 controller 등)이 @SystemInvoked 유스케이스를 new로 만들어 부르거나, 표시 없는 중간 클래스를 거쳐 부르면 통과한다. 매뉴얼 07은 이것을 "빌드 실패"라고 약속한다. app AGENTS의 "bootstrap에 controller 금지"도 검사가 없다. 3. web 패키지 밖에 둔 Spring Security 요청 경로 확장점(JWT converter, AuthorizationManager, AuthenticationProvider, 필터 chain DSL)은 servlet 타입을 쓰지 않아 사용자 전송으로 보이지 않는다. 4. 설정이 interceptor를 자기 클래스 타입 필드로 쥐고 registration.interceptors(x)로 넘기면, ArchUnit 1.3은 ChannelRegistration (설정용 타입)만 기록해 설정이 사용자 전송이 되지 않는다. 5. capabilityProjects에 :adapter:inbound:messaging이 없어 저장소 전체 suite가 MessagingInboxAutoConfiguration을 읽지 않는다("suite가 모든 모듈을 본다"는 주석과 다름). 고른 방법: 1. ENDPOINTS_DO_NOT_HOLD_PERSISTENCE_PORTS: controller와 gRPC 서비스는 ..domain..·..application..의 *Repository·*StorePort·*QueryPort에 의존하지 않는다. 2. CONTROLLERS_LIVE_IN_INBOUND_ADAPTERS, 그리고 USER_TRANSPORTS_DO_NOT_REACH_SYSTEM_CALLERS의 전이 대상에 @SystemInvoked 유스케이스 자신을 더한다. 3. org.springframework.security.web·config.annotation.web· oauth2.server.resource·oauth2.jwt 패키지와 AuthenticationProvider· AuthorizationManager를 사용자 전송·요청 처리기 목록에 더한다. 4. 설정이 의존하는 프로젝트 클래스가 요청 처리기 타입을 상속·구현하면 그 설정도 사용자 전송으로 본다. 5. capabilityProjects와 주석 처리된 runtimeOnly 줄에 inbound messaging을 더한다. 매뉴얼 07 표와 app AGENTS를 같이 고쳤다. 지금 운영 코드에 걸리는 곳은 없다(inbound가 그런 포트를 import한 곳 0, 조립 모듈 controller 0). 버린 대안: inbound가 application *Port 전부를 못 쓰게 하기 — web이 AuthorizationPort·CorrelationIdPort를 구현하고 쓰므로 맞는 코드가 걸린다. IdFactory는 지금 DurableOperationController가 쓰고 있어 이번 규칙에서 뺐다 (그 controller의 id 생성은 리뷰 RR9-05-13로 따로 고친다). 위험·한계: 규칙 3·4는 목록·클래스 의존 방식이라, 목록에 없는 보안 타입이나 타입 이름이 남지 않는 길(bean 이름 조회, 함수로 감싸 넘기기)은 여전히 못 본다(매뉴얼 07 「규칙이 못 보는 길」). gRPC 서비스 fixture는 io.grpc가 architectureTest 컴파일 classpath에 없어 두지 않았다 — 판정은 BindableService 이름으로 한다. 검증(desktop, --no-build-cache): - RED: 기준a7e38c10+ 새 fixture와 시험(새 규칙 대신 기존 규칙을 부르는 변형)만으로 ArchitectureViolationFixtureTest 204건 중 5건 실패 — 다섯 위반 모두 기존 규칙에 안 걸림. 허용 시험은 통과. - GREEN: :app-bootstrap:resolveAndLockAll --write-locks(잠금 변화 없음), spotlessApply 뒤 :app-bootstrap:architectureTest 259건 실패 0, :app-bootstrap:testQualityCheck, :app-bootstrap:spotlessCheck, :verifyDependencyLocks, :architectureCheck rc=0. 로그 desktop ~/r9-be-logs/b14-{red,green2}.log. Refs: docs/reviews/2026-11-12-round9-review RR9-05-01~05#28로 병합됐다(main
3d31896a). 이 PR의 head3df16851가 #28 브랜치에 merge 커밋으로 들어 있고, #28의 runnerpr / done이 그 합친 트리로 초록이었다. runner 대기를 줄이려고 이번만 쓴 방식이다(소유자 승인, 2026-11-13).Pull request closed