refactor(ratelimit): policyId 문법과 기간 검사를 shared-contract 한 곳에 둔다 #93

Merged
donghyeon.kang merged 4 commits from refactor/ratelimit-shared-bounds into main 2026-11-22 00:51:34 +00:00
4 Commits
Author SHA1 Message Date
donghyeon.kang 5c3315d1ea Merge branch 'main' into refactor/ratelimit-shared-bounds
pr / done (pull_request) Successful in 21m49s
2026-11-22 00:08:39 +00:00
DongHyeonka bb1f32d7de docs(ratelimit): 정본과 redis 상한 클래스의 Javadoc을 실제 책임에 맞춘다
pr / done (pull_request) Successful in 22m23s
RateLimitBounds.isPolicyId의 @return은 null일 때 false라는 것만 적고
true가 되는 조건을 적지 않는다. redis RateLimitPolicyBounds의 설명은
식별자 문법과 기간 검사를 정본에서 받는 이유를 하나(요청이 같은 id로
policy를 부른다)로 묶는데, 그 이유는 문법에만 맞는다.

@return에 「문법과 맞으면 true, null이면 false」를 적는다.
RateLimitPolicyBounds는 이유를 둘로 나누고(문법은 같은 id라서, 기간 검사는
양수·상한·whole-ms 규칙을 한 벌만 두려고), 같은 패키지의 dedup 상한은
RateLimitEvaluationDedupPolicy에 있다고 적는다. 상수 둘을
RateLimitPolicy로 옮기고 클래스를 지우는 안은 diff를 넓히는 데 비해 얻는
동작이 없어 버렸다.

위험·한계: 주석만 바뀐다.

검증: 커밋 전에는 돌리지 않았다. 최종 트리의 desktop leaf·pr 결과는 PR
본문에 있다.

Refs: REV-BE-0040
2026-11-22 07:41:05 +09:00
DongHyeonka b64518f97a test(ratelimit): web bridge가 공용 문법 밖 policyId를 거절하는지 시험한다
앞 커밋이 EdgeRateLimitTransportBridge의 policyId 검사를
RateLimitBounds.isPolicyId로 바꾸면서 null·문법 밖 id를 자기 메시지의
IllegalArgumentException으로 거절한다고 약속했다. 그런데 Bridge 시험은
정상 id 하나만 보고 있어서 이 검사를 지워도 모두 통과한다. 잘못된 id는
나중에 evaluate에서 RateLimitRequest가 다른 메시지로 거절할 뿐이다.

Bridge 시험에 null과 문법 밖 네 행(대문자, 밑줄, 숫자 첫 글자, 64자)을
ParameterizedTest로 넣고 예외 타입과 메시지를 함께 단언한다. 행은 settings
·redis 시험과 같아서, 정본 정규식을 느슨하게 바꾸면 이 시험도 함께
실패한다. RateLimitBoundsTest의 설명은 시험이 실제로 보는 것
(isPolicyId가 문법에 답한다)만 말하게 줄인다.

위험·한계: 시험만 바뀐다. 운영 코드와 메시지는 그대로다.

검증: 커밋 전에는 돌리지 않았다. 최종 트리의 desktop leaf·pr 결과와 RED는
PR 본문에 있다.

Refs: REV-BE-0040
2026-11-22 07:41:05 +09:00
DongHyeonka 9df5cad4d8 refactor(ratelimit): policyId 문법과 기간 검사를 shared-contract 한 곳에 둔다
policyId 정규식([a-z][a-z0-9-]{0,62})이 rate-limit main에 네 벌
있었다. shared-contract RateLimitBounds, cache-redis
RateLimitPolicyBounds, web EdgeRateLimitTransportBridge·
EdgeRateLimitTransportSettings다. redis 사본은 policyRevision과
duration 검사(null·음수·0·상한·toMillis·whole-ms 순서와 메시지)도
줄 단위로 베꼈다. 정본 RateLimitBounds가 package-private이라 다른
패키지에서 부를 수 없어서다. 한 곳만 문법을 바꾸면 web 설정이 받아들인
id를 RateLimitRequest가 실행 중에 거절하는 엇갈림이 생긴다.

- RateLimitBounds를 public으로 열고 policyId·policyRevision·
  positiveDuration·nonNegativeDuration을 public으로 둔다. 자기 말로
  거절을 알리는 쪽을 위해 isPolicyId(null이면 false)를 더한다.
  subjectDigest·optionalEvaluationId와 상수는 그대로 package-private이다.
- redis RateLimitPolicy·RateLimitEvaluationDedupPolicy는 정본을 부르고,
  RateLimitPolicyBounds에는 redis만의 상한 상수 둘만 남긴다.
- web 둘은 isPolicyId를 부르고 자기 오류 메시지("policyId|defaultPolicyId
  must be a bounded policy identifier")와 null 처리(IAE)를 그대로 둔다.
- 시험: shared-contract RateLimitBoundsTest(isPolicyId 표), redis
  RateLimitPolicyTest·web EdgeRateLimitTransportSettingsTest에 문법 밖
  id 네 행(대문자, 밑줄, 숫자로 시작, 64자) 거절. redis에는 policyId
  거절 시험이 없었다.

정규식 문법과 오류 메시지는 바꾸지 않았다. 버린 안: 사본 사이에 같은
값을 보는 대조 시험(사본을 두는 비용이 그대로다), RateLimitPolicyId 값
타입(공개 타입과 호출부가 더 바뀐다).

위험·한계: shared-contract 공개 API가 public 클래스 하나·메서드 다섯
늘어난다. application-core LeaseValidation의 같은 정규식은 lease
식별자라 이 변경 밖이다.

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

Refs: REV-BE-0040
2026-11-22 05:36:34 +09:00