fix!: GraphQL 지표 tag·헤더 상수·인증 runbook 이름을 고치고 gRPC 권한 거부를 시험한다 #42
Open
donghyeon.kang
wants to merge 6 commits from
claude/r9-a-follow-ups into main
pull from: claude/r9-a-follow-ups
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#42
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 그룹 A(인증·관측·runbook)가 범위 밖으로 남긴 후속 다섯 건을 고친다. round9 발견 0 조건에 들어간다.
graphql.request가 요청에 따라 tag key를 빼서, Prometheus registry가 key 묶음이 다른 쪽 meter를 버렸다.ApiHeaders.DEPRECATION·DATE.INTERNAL_AUTH_MISCONFIGURATIONrunbook의 파일 이름·runbook_link가 옛 이름(public-path-misconfiguration)이었다. 다 쓴 본문이 초안으로LEGACY_STUB_DEBT에 남아 있었다.@RequiresPermission거부가 wire에서PERMISSION_DENIED가 되는지 함께 돌려 본 시험이 없었다.고른 방법과 버린 대안
DataFetcherObservationConvention·DataLoaderObservationConvention을 구현한 adapter 둘을@ConditionalOnMissingBeanbean으로 둔다. tag 이름은 뜻에 맞게 고친다(graphql.resolver.weight,graphql.batch.size.bucket). 세 지표 모두 meter 이름마다 key 묶음을 하나로 고정한다.graphql.error.type이 Micrometererrortag와 같은 값을 한 번 더 싣는다.ApiHeaders상수:@Deprecated로 한 판 남기는 안은 버렸다. 템플릿 안에 부르는 곳이 없고, SpringHttpHeaders.DATE로 바로 옮길 수 있다.auth-decoder-misconfiguration.md로 옮기고status: 운영으로 올린다. 이 500의 처리로 공개 경로 되돌리기를 안내하던 문단은 지운다.testImplementation으로 더한다. 운영 의존은 그대로라 registry edge는 바뀌지 않는다(선례: web-fileserver).정한 기본값
graphql.schema.coordinate=unnamed, 무게는 cost 단계의 기본값EXTERNAL_BATCH.error.type=NONE. 복잡도를 세기 전에 끝난 요청:graphql.complexity.bucket=unknown.@BatchMapping에 붙이는 schema 좌표(Book.author). 둘 다 아니면(클래스 이름 loader 등)unknown.위험과 영향
docs/upgrade/2026-11-round9-followups.md1~4행이 옮기는 법을 적는다.ApiHeaders상수를 부르던 파생 서비스는 컴파일이 실패한다(5행).runbook_link값이 바뀐다(6행).검증
scripts/verify.sh pr: rc=0 (트리f79039ae, basec7a18ec7, 시험 7047개 실패 0). 그 뒤 main에 들어온 #39(persistence-jpa 시험 파일 하나)와 겹치는 파일은 없고git merge-tree로 충돌 없음을 봤다.:adapter:inbound:graphql:check,:adapter:inbound:graphql:systemTest,:adapter:inbound:graphql:verifyGraphQlApiSurface,:adapter:inbound:grpc:check,:adapter:inbound:grpc:grpcTransportQualificationTest,:adapter:inbound:web:check,:app-bootstrap:documentContractTest,:app-bootstrap:repositoryContractTest, app-bootstrap 지표·runbook 정합 시험. 모두 통과했다.python3 scripts/check-docs.py·check-work-docs.pyOK,check-work-docs.py --history docs/runbooks걸린 줄 0.spotlessApply로 고쳤다. 남은 발견 0.리뷰어가 볼 곳
src/adapter/inbound/graphql/src/main/java/dev/caskeleton/adapter/inbound/graphql/runtime/GraphQlResolverObservationConventionAdapter.java,GraphQlDataLoaderObservationConventionAdapter.javaobservation/GraphQlRequestObservationConvention.java: key 묶음 고정src/adapter/inbound/grpc/src/test/java/dev/caskeleton/adapter/inbound/grpc/GrpcRequiresPermissionWireTest.javagradle.lockfile·스냅숏은 desktop에서resolveAndLockAll --write-locks·updateGraphQlApiSurface로 만들었다.관련
docs/upgrade/2026-11-round9-followups.md923298a2, 세 PR 병합 뒤로 미뤘던 것)e69c321eApiHeaders.DEPRECATION·DATEc4a2023aINTERNAL_AUTH_MISCONFIGURATIONrunbook 이름593615b0@RequiresPermissionwire 시험346f8be813ffb6cfView command line instructions
Checkout
From your project repository, check out a new branch and test the changes.