문제: 앞 커밋이 레지스트리 주석의 `# source:`를 `# 출처:`로 바꾸고, 출처 줄 안의 기록 절 이름(「In scope」「Decisionized Work Items」「decisions」「Exposure Policy」「AuthN/AuthZ Decision Matrix」)까지 한국어로 옮겼다. 출처 줄은 기록 이름·날짜·절 이름으로 원문을 찾아가는 줄이라, 옮기면 그 기록에서 같은 이름을 찾을 수 없다. 또 metrics.yaml 주석 세 줄에 변환 실수로 `\"`(백슬래시가 붙은 따옴표)가 들어갔다. 고른 방법: 총괄 기준(2026-11-07)대로 나눈다. - 원문으로 둔다: 출처 줄의 꼬리표 `source:`, 기록 이름·날짜·절 이름, 따옴표 인용. - 한국어로 둔다: 같은 줄의 나머지 설명, 행마다의 이유·조건·주의 산문, 값 칸, 파일 머리 블록. - `\"`는 `"`로 고친다. 위험·한계: 출처가 가리키는 `feature-*` 계약 기록 24개는 저장소 어디에도(이력 포함) 그 이름의 파일이 없다. `docs/design/`에 있는 것은 `five-adapter-runtime-remediation`과 `redis-production-capability` 둘이고, 파일 이름에 날짜와 `-design`이 붙어 있다. 이름은 고치지 않았다. 검증: 여덟 파일을 `yaml.safe_load`로 읽은 데이터가 앞 커밋과 같다(주석만 바뀜). `python3 scripts/check-docs.py` rc=0.
191 lines
6.9 KiB
YAML
191 lines
6.9 KiB
YAML
# Registry: HTTP Headers
|
|
# Schema owner: feature-contract-registry-governance
|
|
# Last updated: 2026-05-22
|
|
#
|
|
# 표기 규칙
|
|
# - HTTP 헤더 이름: kebab-case (X-Request-Id, X-Correlation-Id)
|
|
# - W3C 표준 헤더: 소문자 (traceparent, tracestate)
|
|
# - mdc_key: snake_case (foundation이 정본)
|
|
# - envelope_meta_field: camelCase (envelope이 정본)
|
|
|
|
headers:
|
|
# source: feature-operational-error-observability-foundation.md L97
|
|
# "request_id | inbound filter (생성 또는 X-Request-Id 헤더) | response header X-Request-Id"
|
|
- name: X-Request-Id
|
|
direction: both
|
|
type: ulid
|
|
required: false
|
|
generated_if_missing: true
|
|
mdc_key: request_id
|
|
envelope_meta_field: requestId
|
|
owner_branch: feature-operational-error-observability-foundation
|
|
case_style: kebab
|
|
compatibility_impact: none
|
|
required_test: contract-verification:envelope-headers
|
|
|
|
# source: feature-api-contract-baseline.md L77 / feature-rate-limit-idempotency-contract.md L66-67
|
|
# "idempotency header 이름은 Idempotency-Key" / "기본 scope는 (authenticatedPrincipal, idempotencyKey, useCaseName)"
|
|
- name: Idempotency-Key
|
|
direction: inbound
|
|
type: string
|
|
required: false
|
|
generated_if_missing: false
|
|
mdc_key: null
|
|
envelope_meta_field: null
|
|
owner_branch: feature-rate-limit-idempotency-contract
|
|
case_style: kebab
|
|
compatibility_impact: additive
|
|
required_test: contract-verification:idempotency-replay
|
|
|
|
# source: feature-rate-limit-idempotency-contract.md L85 / foundation L85
|
|
# "RATE_LIMIT | ... | 429 | true (Retry-After 이후)" / "retry-after 기준 없이 429를 반환하면 실패"
|
|
- name: Retry-After
|
|
direction: outbound
|
|
type: duration-seconds
|
|
required: false
|
|
generated_if_missing: false
|
|
mdc_key: null
|
|
envelope_meta_field: null
|
|
owner_branch: feature-rate-limit-idempotency-contract
|
|
case_style: kebab
|
|
compatibility_impact: additive
|
|
required_test: contract-verification:rate-limit-headers
|
|
|
|
# source: feature-rate-limit-idempotency-contract.md scope L26 (rate limit response/log 기준)
|
|
# app.rate-limit.enabled=true인 요청 경로에서만 생성되는 rate-limit 응답 표면
|
|
- name: X-RateLimit-Limit
|
|
direction: outbound
|
|
type: numeric
|
|
required: false
|
|
generated_if_missing: true
|
|
mdc_key: null
|
|
envelope_meta_field: null
|
|
owner_branch: feature-rate-limit-idempotency-contract
|
|
case_style: kebab
|
|
compatibility_impact: additive
|
|
required_test: contract-verification:rate-limit-headers
|
|
|
|
# source: feature-rate-limit-idempotency-contract.md scope L26 (rate limit response/log 기준)
|
|
- name: X-RateLimit-Remaining
|
|
direction: outbound
|
|
type: numeric
|
|
required: false
|
|
generated_if_missing: true
|
|
mdc_key: null
|
|
envelope_meta_field: null
|
|
owner_branch: feature-rate-limit-idempotency-contract
|
|
case_style: kebab
|
|
compatibility_impact: additive
|
|
required_test: contract-verification:rate-limit-headers
|
|
|
|
# source: feature-rate-limit-idempotency-contract.md scope L26 (rate limit response/log 기준)
|
|
- name: X-RateLimit-Reset
|
|
direction: outbound
|
|
type: rfc3339-date
|
|
required: false
|
|
generated_if_missing: true
|
|
mdc_key: null
|
|
envelope_meta_field: null
|
|
owner_branch: feature-rate-limit-idempotency-contract
|
|
case_style: kebab
|
|
compatibility_impact: additive
|
|
required_test: contract-verification:rate-limit-headers
|
|
|
|
# source: feature-api-compatibility-deprecation-contract.md L87
|
|
# "deprecation marker | OpenAPI deprecated: true + design record | response header optional"
|
|
- name: Deprecation
|
|
direction: outbound
|
|
type: http-date
|
|
required: false
|
|
generated_if_missing: false
|
|
mdc_key: null
|
|
envelope_meta_field: null
|
|
owner_branch: feature-api-compatibility-deprecation-contract
|
|
case_style: kebab
|
|
compatibility_impact: additive
|
|
required_test: contract-verification:deprecation-marker
|
|
|
|
# source: feature-api-compatibility-deprecation-contract.md L87
|
|
# "deprecation marker | OpenAPI deprecated: true + design record | response header optional" (RFC 8594 Sunset)
|
|
- name: Sunset
|
|
direction: outbound
|
|
type: http-date
|
|
required: false
|
|
generated_if_missing: false
|
|
mdc_key: null
|
|
envelope_meta_field: null
|
|
owner_branch: feature-api-compatibility-deprecation-contract
|
|
case_style: kebab
|
|
compatibility_impact: additive
|
|
required_test: contract-verification:deprecation-marker
|
|
|
|
# source: feature-distributed-tracing-contract.md L64, L85
|
|
# "propagation header는 W3C traceparent default" / "HTTP | traceparent, tracestate (W3C)"
|
|
- name: traceparent
|
|
direction: both
|
|
type: string
|
|
required: false
|
|
generated_if_missing: true
|
|
mdc_key: trace_id
|
|
envelope_meta_field: traceId
|
|
owner_branch: feature-distributed-tracing-contract
|
|
case_style: kebab
|
|
compatibility_impact: none
|
|
required_test: contract-verification:trace-propagation
|
|
|
|
# source: feature-distributed-tracing-contract.md L66, L85
|
|
# "propagation format = W3C traceparent + tracestate only. B3 propagation은 forbidden"
|
|
- name: tracestate
|
|
direction: both
|
|
type: comma-separated
|
|
required: false
|
|
generated_if_missing: false
|
|
mdc_key: null
|
|
envelope_meta_field: null
|
|
owner_branch: feature-distributed-tracing-contract
|
|
case_style: kebab
|
|
compatibility_impact: none
|
|
required_test: contract-verification:trace-propagation
|
|
|
|
# source: feature-operational-error-observability-foundation.md L100
|
|
# "correlation_id | inbound header X-Correlation-Id 또는 생성 | HTTP X-Correlation-Id, message header correlation_id"
|
|
- name: X-Correlation-Id
|
|
direction: both
|
|
type: ulid
|
|
required: false
|
|
generated_if_missing: true
|
|
mdc_key: correlation_id
|
|
envelope_meta_field: correlationId
|
|
owner_branch: feature-operational-error-observability-foundation
|
|
case_style: kebab
|
|
compatibility_impact: none
|
|
required_test: contract-verification:envelope-headers
|
|
|
|
# source: feature-security-operational-baseline.md L66
|
|
# "JWT Resource Server를 baseline security model로 둠" (Authorization 헤더의 Bearer 토큰)
|
|
- name: Authorization
|
|
direction: inbound
|
|
type: bearer-token
|
|
required: false
|
|
generated_if_missing: false
|
|
mdc_key: null
|
|
envelope_meta_field: null
|
|
owner_branch: feature-security-operational-baseline
|
|
case_style: kebab
|
|
compatibility_impact: none
|
|
required_test: contract-verification:jwt-resource-server
|
|
|
|
# source: feature-security-operational-baseline.md L83-90 (AuthN/AuthZ Decision Matrix)
|
|
# 401 응답 시 WWW-Authenticate (Bearer realm/error) — Spring Security JWT Resource Server의 표준 challenge 헤더
|
|
- name: WWW-Authenticate
|
|
direction: outbound
|
|
type: string
|
|
required: false
|
|
generated_if_missing: true
|
|
mdc_key: null
|
|
envelope_meta_field: null
|
|
owner_branch: feature-security-operational-baseline
|
|
case_style: kebab
|
|
compatibility_impact: none
|
|
required_test: contract-verification:jwt-resource-server
|