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
6
Commits
| Author | SHA1 | Message | Date | |
|---|---|---|---|---|
|
|
6e3d0e194d |
chore(ledger): round9 그룹 A의 예측·실측 줄을 맞춘다
pr / done (pull_request) Successful in 14m8s
round9 그룹 A의 예측 줄은 장부에 있지만 실측 줄이 없다. PR 셋이 같은 파일 끝을 건드리면 충돌하므로 세 PR이 모두 병합된 뒤로 미뤘다. 실측(작업 중 215분, 호출 2295, 출력 약 197만 토큰)과 예측을 벗어난 이유(새 눈 리뷰 4라운드, main 이동 두 번, desktop 잠금 대기 중 실행 교체)를 한 줄로 더한다. 위험: 장부에 한 줄을 더할 뿐이다. 검증: ledger.py append가 칸을 검사했다. Refs: round9 그룹 A |
||
|
|
13ffb6cfb1 |
docs(runbooks): runbook 본문의 옛 설계 번호와 커밋 sha를 설명으로 바꾼다
job·outbox·internal-error-spike runbook이 근거를 템플릿 개발 때의 설계 번호(D2·D4·D7·D8, K8S-POD-LC-C2, WAF-REL05-C3, TPE-JDK21-C6, OUT_OF_BRANCH_SCOPE), 옛 feature 브랜치 이름의 wiki 링크, 커밋 sha bbe944bd로 적는다. 파생 서비스의 운영자는 그 번호와 브랜치를 찾을 수 없어 근거를 읽지 못한다. 번호마다 그 뜻을 문장으로 쓴다: 한도 없는 queue가 무너지는 이유, CallerRunsPolicy가 요청 지연을 늘리는 이유, 종료 대기 19s와 k8s grace period의 SIGKILL, 다시 해도 같은 오류는 곧바로 DLQ로. PARKED가 생긴 버전은 커밋 sha 대신 V22 migration으로 가리킨다. 「관련 branch」 줄은 지우고, 「관련 runbook」의 wiki 링크는 상대 링크로 바꾼다. 위험: 문서만 바뀐다. 절차와 SQL 블록은 그대로다. 검증: python3 scripts/check-work-docs.py --history docs/runbooks에서 걸린 줄 0, check-docs.py OK. Refs: round9 그룹 A 범위 밖 후속 6 |
||
|
|
346f8be837 |
test(grpc): handler가 부른 @RequiresPermission 거부를 wire에서 확인한다
gRPC handler가 부른 @RequiresPermission 유스케이스가 권한 없는 호출자를 PERMISSION_DENIED로 돌려보내는지는 조각마다의 단위 시험으로만 본다. 인터셉터가 SecurityContext에 호출자를 두는 것, web method security가 그것을 읽는 것, 거부가 AUTHZ_INSUFFICIENT_PERMISSION carrier인 것, 예외 인터셉터가 그것을 PERMISSION_DENIED로 바꾸는 것이 따로 시험되고, 한 서버에서 함께 돌려 본 시험이 없다. GrpcRequiresPermissionWireTest가 실제 loopback Netty 서버를 띄우고 web 어댑터의 MethodSecurityConfig·AuthorizationAdapter로 order:close 권한을 판정한다. 권한 없는 호출자는 PERMISSION_DENIED와 trailer error-code=AUTHZ_INSUFFICIENT_PERMISSION을, 권한 있는 호출자는 같은 유스케이스의 응답을 받는다. 시험에만 :adapter:inbound:web· :application-core를 testImplementation으로 더하고 lockfile을 다시 만든다. grpcTransportQualificationTest lane이 이 시험을 반드시 돌린다. 버린 안: app-bootstrap integrationTest에 두기. grpc 자동 설정은 모듈이 classpath에 있으면 켜지므로, app-bootstrap 시험 classpath에 grpc를 넣으면 그 leaf의 모든 시험에서 gRPC 서버 설정이 돈다. 운영 의존 (api·implementation)은 그대로라 registry edge는 바뀌지 않는다(의존 방향 검사는 운영 configuration만 본다). 위험: 시험 classpath만 커진다. gRPC lockfile을 자기 쪽에서 고친 파생 서비스는 upgrade 문서 7행대로 lockfile을 다시 만든다. 검증: desktop :adapter:inbound:grpc:check :adapter:inbound:grpc:grpcTransportQualificationTest :adapter:inbound:grpc:verifyDependencyLocks, scripts/verify.sh pr. Refs: round9 그룹 A 범위 밖 후속 5 |
||
|
|
593615b019 |
docs(runbooks)!: 인증 설정 오류 runbook 이름을 내용에 맞춘다
INTERNAL_AUTH_MISCONFIGURATION의 runbook은 JWT decoder 설정 오류(issuer discovery 실패, jwks_uri 없음)를 다루지만 파일 이름과 runbook_link는 옛 이름 auth-public-path-misconfiguration이다. 제목만 바꾼 채로 두어 경보에서 링크를 따라온 사람이 공개 경로 문제로 읽는다. 본문이 다 쓰였는데도 status 초안이라 RunbookCoverageContractTest의 임시 목록 LEGACY_STUB_DEBT에 남아 있다. 파일을 auth-decoder-misconfiguration.md로 옮기고 runbook_link를 runbook://auth/decoder-misconfiguration으로 바꾼다. status를 운영으로 올리고 초안 꼬리 문단을 이 runbook이 다루는 범위(템플릿의 JwtDecoderConfig가 내는 신호) 한 줄로 바꾼다. 이 500의 처리로 공개 경로 되돌리기를 안내하던 진단·조치·에스컬레이션 문장은 지우고, 공개 경로 오류는 verifyPublicPathSnapshot이 잡는다는 한 줄만 남긴다. LEGACY_STUB_DEBT에서 빼고, 옛 이름을 가리키던 be-security 스킬·다른 runbook 두 곳을 고친다. 위험: runbook_link 값이 바뀐다. 옛 링크로 경보를 만든 서비스는 upgrade 문서 6행대로 바꾼다. 검증: python3 scripts/check-docs.py·check-work-docs.py OK, desktop :app-bootstrap:documentContractTest :app-bootstrap:repositoryContractTest, scripts/verify.sh pr. BREAKING CHANGE: INTERNAL_AUTH_MISCONFIGURATION의 runbook_link가 runbook://auth/decoder-misconfiguration이다. Refs: round9 그룹 A 범위 밖 후속 4 |
||
|
|
c4a2023aaa |
refactor(web)!: 쓰는 곳 없는 ApiHeaders.DEPRECATION·DATE 상수를 지운다
web ApiHeaders가 Deprecation·Date 헤더 이름 상수를 공개하지만 운영 코드와 시험 어디에서도 부르지 않는다. 헤더 registry는 지난 변경에서 쓰지 않는 Deprecation 행을 이미 지웠고, 상수만 남아 응답이 그 헤더를 보낸다고 읽힌다. 두 상수와 주석을 지우고 README의 ApiHeaders 절, 시험 도구 MainSources의 Javadoc 예시, docs/capability-status.md 제거 표를 맞춘다. 버린 안: @Deprecated로 한 판 남기기. 템플릿 안에 부르는 곳이 없고, 파생 서비스가 쓰고 있었다면 Spring HttpHeaders.DATE나 자기 상수로 바로 옮길 수 있다. 위험: 그 상수를 부르던 파생 서비스는 컴파일이 실패한다. upgrade 문서 5행이 옮기는 법을 적는다. 검증: desktop :adapter:inbound:web:check, scripts/verify.sh pr. BREAKING CHANGE: ApiHeaders.DEPRECATION·ApiHeaders.DATE 상수가 없다. Refs: round9 그룹 A 범위 밖 후속 3 |
||
|
|
e69c321eca |
fix(graphql)!: GraphQL 지표에 플랫폼 tag를 붙이고 key 묶음을 고정한다
GraphQlResolverObservationConvention·GraphQlDataLoaderObservationConvention bean이 있지만 Spring for GraphQL observation에 붙지 않는다. 그래서 graphql.datafetcher·graphql.dataloader timer는 Spring 기본 tag (graphql.field.name, graphql.loader.name, graphql.error.type)를 달고, 플랫폼이 정한 schema 좌표·resolver 무게·batch 크기 tag는 아무 지표에도 없다. 두 convention의 tag 이름도 뜻과 맞지 않는다: 무게를 graphql.operation.type으로, batch 크기를 graphql.complexity.bucket으로 단다. graphql.request는 오류가 없거나 복잡도를 세기 전에 끝난 요청에서 error.type·graphql.complexity.bucket을 빼는데, Prometheus registry는 이름이 같고 key 묶음이 다른 meter를 버린다. 먼저 등록된 쪽만 남고 성공이나 실패 한쪽이 /actuator/prometheus에서 사라진다. Spring의 DataFetcherObservationConvention·DataLoaderObservationConvention을 구현한 adapter 둘(runtime 패키지)을 두고 GraphQlObservationConfiguration이 @ConditionalOnMissingBean으로 등록한다. resolver는 부모 타입과 field 이름으로 schema 좌표(Type.field)를 만들고, 좌표로 이름 붙일 수 없는 field(_Service.sdl 같은 federation field)는 unnamed와 기본 무게로 같은 key를 단다. DataLoader는 등록한 loader 이름, 또는 Spring이 @BatchMapping loader에 붙이는 schema 좌표(Book.author)를 이름으로 쓰고, 둘 다 아니면 unknown이다. graphql.request는 오류가 없으면 error.type=NONE, 복잡도를 세지 않았으면 graphql.complexity.bucket=unknown을 단다. tag 이름을 graphql.resolver.weight·graphql.batch.size.bucket으로 고치고 cardinality 허용 목록, metrics.yaml 세 행(Micrometer가 다는 error tag 포함), 공개 API 스냅숏을 맞춘다. 응답 path와 batch key는 싣지 않는다. 버린 안: Spring 기본 convention을 두고 registry만 그 tag로 적기. 플랫폼 convention이 죽은 코드로 남고, field 이름만으로는 타입이 다른 같은 이름 field를 가를 수 없다. 기본 convention을 감싸 tag만 더하는 안은 graphql.error.type이 Micrometer의 error tag와 같은 값을 한 번 더 싣는다. 위험: 세 timer의 tag가 바뀐다. 옛 tag로 거른 대시보드·경보는 비고, docs/upgrade/2026-11-round9-followups.md 1~4행이 옮기는 법을 적는다. 클래스 이름으로 등록한 loader는 unknown 하나로 묶인다. 자기 DataFetcherObservationConvention·DataLoaderObservationConvention bean을 둔 서비스는 그 bean이 그대로 쓰인다. 검증: desktop :adapter:inbound:graphql:check :adapter:inbound:graphql:systemTest :adapter:inbound:graphql:verifyGraphQlApiSurface, scripts/verify.sh pr. BREAKING CHANGE: graphql.datafetcher·graphql.dataloader timer의 tag가 graphql.schema.coordinate·graphql.outcome·graphql.resolver.weight와 graphql.dataloader.name·graphql.outcome·graphql.batch.size.bucket으로 바뀐다. graphql.request는 error.type=NONE·graphql.complexity.bucket=unknown을 단다. 두 convention의 tag key도 바뀐다. Refs: round9 그룹 A 범위 밖 후속 1 |