feat: add production capability foundations

src/shared-contract/README.md

@@ -12,6 +12,25 @@ Micrometer·OTel 같은 프레임워크 타입을 import 하지 않는다. 그
 persistence·outbound)이 프레임워크 충돌 없이 이 타입들을 공유할 수 있고, HTTP status 같은
 전송 개념도 프레임워크 타입이 아니라 평범한 `int` 로 표현한다(매핑은 web 어댑터가 한다).
 
+`health/RedisHealthSnapshotProvider`도 같은 원칙을 따른다. Redis adapter는 native client나
+예외를 노출하지 않고 bounded role/capability 상태만 제공하며, bootstrap이 이를 Actuator
+health로 변환한다.
+
+---
+
+## ratelimit — edge enforcement 계약
+
+`EdgeRateLimitPort`는 inbound와 Redis adapter 사이의 provider-neutral edge enforcement
+경계다. Business quota나 entitlement policy를 담는 application use case가 아니며, 이미
+pseudonymized된 subject digest와 bounded policy ID/cost/deadline만 받는다.
+
+`RateLimitPolicy`는 fixed window, sliding-window counter, token bucket 중 하나의 exact parameter
+subtype을 고정하고 Lua의 `2^53-1` 안전 정수, 1일 window/refill/cleanup, 1시간 clock regression,
+`FAIL_CLOSED`만 허용한다. 결과는 evaluated, known pre-send unavailable, post-dispatch
+indeterminate, schema/program/reply incompatible로 분리하므로 adapter가 장애를 allow나 평범한
+deny로 숨길 수 없다. 이 패키지는 Java 표준 라이브러리만 사용하며 Redis key, command, Lua,
+Spring/Lettuce 타입을 노출하지 않는다.
+
 ---
 
 ## error — 에러 코드 계약