diff --git a/docs/registries/capabilities.yaml b/docs/registries/capabilities.yaml index 157c27b8..049d314d 100644 --- a/docs/registries/capabilities.yaml +++ b/docs/registries/capabilities.yaml @@ -19,8 +19,8 @@ capabilities: - # 출처: feature-repository-access-permission-contract — 판정 기준 "Required capability: READ_REPOSITORY" - # 출처: feature-application-port-usecase-contract — "read-only query use case는 readOnly 와 READ_REPOSITORY capability만 선언 가능" + # source: feature-repository-access-permission-contract — 판정 기준 "Required capability: READ_REPOSITORY" + # source: feature-application-port-usecase-contract — "read-only query use case는 readOnly 와 READ_REPOSITORY capability만 선언 가능" - name: READ_REPOSITORY scope: use_case_method enforcement: archunit @@ -32,8 +32,8 @@ capabilities: compatibility_impact: breaking required_test: architecture-enforcement:read-repository-capability - # 출처: feature-repository-access-permission-contract — 판정 기준 "Required capability: WRITE_REPOSITORY" - # 출처: feature-application-port-usecase-contract — "write use case는 transactionMode, idempotency, repositoryAccess를 명시해야 함" + # source: feature-repository-access-permission-contract — 판정 기준 "Required capability: WRITE_REPOSITORY" + # source: feature-application-port-usecase-contract — "write use case는 transactionMode, idempotency, repositoryAccess를 명시해야 함" - name: WRITE_REPOSITORY scope: use_case_method enforcement: archunit @@ -45,7 +45,7 @@ capabilities: compatibility_impact: breaking required_test: architecture-enforcement:write-repository-capability - # 출처: feature-repository-access-permission-contract — decisions 2026-05-22 + # source: feature-repository-access-permission-contract — decisions 2026-05-22 # "SENSITIVE_READ marker = registry-managed metadata table (entity FQN + field name 단위)" - name: SENSITIVE_READ scope: use_case_method @@ -58,7 +58,7 @@ capabilities: compatibility_impact: breaking required_test: architecture-enforcement:sensitive-read-capability - # 출처: feature-repository-access-permission-contract — decisions 2026-05-22 + # source: feature-repository-access-permission-contract — decisions 2026-05-22 # "BULK_WRITE threshold = N > 100 또는 batch size > 100. 미만은 일반 WRITE_REPOSITORY로 충분" - name: BULK_WRITE scope: use_case_method @@ -71,9 +71,9 @@ capabilities: compatibility_impact: breaking required_test: architecture-enforcement:bulk-write-capability - # 출처: feature-repository-access-permission-contract — decisions 2026-05-22 + # source: feature-repository-access-permission-contract — decisions 2026-05-22 # "TRANSACTION_REQUIRED는 application-port branch의 TransactionPort contract와 연결되어야 하며 Spring @Transactional 직접 import로 충족하지 않음" - # 출처: feature-application-port-usecase-contract — TransactionPort Contract + # source: feature-application-port-usecase-contract — TransactionPort Contract - name: TRANSACTION_REQUIRED scope: use_case_method enforcement: archunit @@ -85,9 +85,9 @@ capabilities: compatibility_impact: breaking required_test: architecture-enforcement:transaction-required-capability - # 출처: feature-repository-access-permission-contract — decisions 2026-05-22 + # source: feature-repository-access-permission-contract — decisions 2026-05-22 # "EXTERNAL_OUTBOUND_ALLOWED 분류 = outbox row INSERT는 in-process(불요), polling publisher의 broker publish는 outbound(필요)" - # 출처: feature-application-port-usecase-contract — "outbound adapter 호출 use case에 EXTERNAL_OUTBOUND_ALLOWED가 없으면 실패" + # source: feature-application-port-usecase-contract — "outbound adapter 호출 use case에 EXTERNAL_OUTBOUND_ALLOWED가 없으면 실패" - name: EXTERNAL_OUTBOUND_ALLOWED scope: use_case_method enforcement: archunit @@ -99,7 +99,7 @@ capabilities: compatibility_impact: breaking required_test: architecture-enforcement:external-outbound-capability - # 출처: feature-repository-access-permission-contract — decisions 2026-05-22 + # source: feature-repository-access-permission-contract — decisions 2026-05-22 # "CROSS_TENANT_ADMIN capability를 capability vocabulary에 추가 (tenant branch feature-tenant-context-policy와 cross-link)" - name: CROSS_TENANT_ADMIN scope: use_case_method diff --git a/docs/registries/env-keys.yaml b/docs/registries/env-keys.yaml index 9fc9fb82..fb2a3b8a 100644 --- a/docs/registries/env-keys.yaml +++ b/docs/registries/env-keys.yaml @@ -21,7 +21,7 @@ env_keys: # === Profile / 정체성 (feature-env-driven-runtime-configuration) === - name: SPRING_PROFILES_ACTIVE - # 출처: feature-env-driven-runtime-configuration D6 (2026-06-06), five-adapter-runtime-remediation §7.1에서 + # source: feature-env-driven-runtime-configuration D6 (2026-06-06), five-adapter-runtime-remediation §7.1에서 # 고침. profile 선택자는 Spring 자체 키 하나뿐이다(APP_PROFILE은 지웠다). CSV 목록이 아니라 값 정확히 # 하나다: 두 환경의 안전 규칙이 함께 적용될 수 없고, 진 쪽은 소리 없이 빠졌다. type: enum @@ -41,7 +41,7 @@ env_keys: # feature-env-driven-runtime-configuration Claims (wont-fix) 참고. - name: APP_NAME - # 출처: feature-env-driven-runtime-configuration 2026-05-22 + # source: feature-env-driven-runtime-configuration 2026-05-22 # "Required config: APP_NAME, APP_PROFILE..." type: string default: null @@ -57,7 +57,7 @@ env_keys: # === HTTP 서버 (D2에 따라 APP_로 통일) === - name: APP_SERVER_PORT - # 출처: feature-env-driven-runtime-configuration D2 (2026-06-05) — APP_로 전부 통일. server.port는 + # source: feature-env-driven-runtime-configuration D2 (2026-06-05) — APP_로 전부 통일. server.port는 # APP_SERVER_PORT에서 온다. # + feature-management-actuator-security-contract 2026-05-22 "management port default = 9001 (separate from app 8080)" # (관리 포트 기본값 9001, 앱 8080과 분리) @@ -73,7 +73,7 @@ env_keys: required_test: env-contract:server-port-bound - name: MANAGEMENT_SERVER_PORT - # 출처: feature-management-actuator-security-contract 2026-05-22 + # source: feature-management-actuator-security-contract 2026-05-22 # "management port default = 9001 (separate from app 8080). single-port는 platform ingress 보호 + 문서화 시만 허용." type: int default: 9001 @@ -87,7 +87,7 @@ env_keys: required_test: actuator-contract:management-port-separated - name: APP_SERVER_SHUTDOWN - # 출처: feature-env-driven-runtime-configuration D2 (2026-06-05) — APP_ 통일 + # source: feature-env-driven-runtime-configuration D2 (2026-06-05) — APP_ 통일 # (server.shutdown 방식. graceful은 처리 중인 요청을 끝내고 내린다) type: enum default: graceful @@ -101,7 +101,7 @@ env_keys: required_test: env-contract:server-shutdown-mode - name: APP_SERVER_SHUTDOWN_TIMEOUT - # 출처: feature-env-driven-runtime-configuration D2 (2026-06-05) — APP_ 통일. + # source: feature-env-driven-runtime-configuration D2 (2026-06-05) — APP_ 통일. # 옛 APP_SHUTDOWN_TIMEOUT 행을 대신한다. k8s terminationGracePeriod 이하여야 한다 # (feature-container-runtime-contract 참고). type: duration @@ -116,7 +116,7 @@ env_keys: required_test: env-contract:server-shutdown-timeout-aligned - name: APP_SERVER_FORWARD_HEADERS_STRATEGY - # 출처: feature-env-driven-runtime-configuration D2 (2026-06-05) — APP_ 통일. + # source: feature-env-driven-runtime-configuration D2 (2026-06-05) — APP_ 통일. # 기본은 닫힘(fail closed): forwarded 헤더는 배포가 정리·신뢰 proxy 뒤에서 직접 켤 때만 믿는다. # native = Tomcat RemoteIpValve. server.tomcat.remoteip.internal-proxies에 맞는 상대에게서 온 헤더만 # 따른다. framework는 허용하지 않는다: 그 ForwardedHeaderFilter는 모든 상대를 믿고, rate limiter가 @@ -133,7 +133,7 @@ env_keys: required_test: env-contract:server-forward-headers-strategy - name: APP_SERVER_TOMCAT_MAX_THREADS - # 출처: feature-env-driven-runtime-configuration D2 (2026-06-05) — APP_ 통일 + # source: feature-env-driven-runtime-configuration D2 (2026-06-05) — APP_ 통일 # (동시 요청 worker 상한) type: int default: 200 @@ -147,7 +147,7 @@ env_keys: required_test: env-contract:tomcat-max-threads-bounded - name: APP_SERVER_TOMCAT_MIN_SPARE_THREADS - # 출처: feature-env-driven-runtime-configuration D2 (2026-06-05) — APP_ 통일 + # source: feature-env-driven-runtime-configuration D2 (2026-06-05) — APP_ 통일 # (쉬는 worker pool의 하한) type: int default: 10 @@ -161,7 +161,7 @@ env_keys: required_test: env-contract:tomcat-min-spare-threads-valid - name: APP_SERVER_TOMCAT_ACCEPT_COUNT - # 출처: feature-env-driven-runtime-configuration D2 (2026-06-05) — APP_ 통일 + # source: feature-env-driven-runtime-configuration D2 (2026-06-05) — APP_ 통일 # (들어오는 TCP 연결의 OS backlog queue 깊이) type: int default: 100 @@ -175,7 +175,7 @@ env_keys: required_test: env-contract:tomcat-accept-count-valid - name: APP_SERVER_TOMCAT_MAX_CONNECTIONS - # 출처: feature-env-driven-runtime-configuration D2 (2026-06-05) — APP_ 통일 + # source: feature-env-driven-runtime-configuration D2 (2026-06-05) — APP_ 통일 # (동시에 열린 연결 수의 상한) type: int default: 8192 @@ -189,7 +189,7 @@ env_keys: required_test: env-contract:tomcat-max-connections-bounded - name: APP_SERVER_TOMCAT_CONNECTION_TIMEOUT - # 출처: feature-env-driven-runtime-configuration D2 (2026-06-05) — APP_ 통일 + # source: feature-env-driven-runtime-configuration D2 (2026-06-05) — APP_ 통일 # (Tomcat connector 연결 timeout) type: duration default: 20s @@ -203,7 +203,7 @@ env_keys: required_test: env-contract:tomcat-connection-timeout-set - name: APP_SERVER_COMPRESSION_ENABLED - # 출처: feature-env-driven-runtime-configuration D2 (2026-06-05) — APP_ 통일 + # source: feature-env-driven-runtime-configuration D2 (2026-06-05) — APP_ 통일 # (server.compression 켜고 끄기) type: boolean default: true @@ -217,7 +217,7 @@ env_keys: required_test: env-contract:server-compression-toggle - name: APP_SERVER_COMPRESSION_MIN_RESPONSE_SIZE - # 출처: feature-env-driven-runtime-configuration D2 (2026-06-05) — APP_ 통일 + # source: feature-env-driven-runtime-configuration D2 (2026-06-05) — APP_ 통일 # (이 크기보다 작은 응답은 압축하지 않는다) type: data_size default: 1KB @@ -231,7 +231,7 @@ env_keys: required_test: env-contract:server-compression-min-size - name: APP_SERVER_ERROR_INCLUDE_STACKTRACE - # 출처: feature-env-driven-runtime-configuration D2 (2026-06-05) — APP_ 통일 + # source: feature-env-driven-runtime-configuration D2 (2026-06-05) — APP_ 통일 # (spring.web.error.include-stacktrace 정책) type: enum default: never @@ -245,7 +245,7 @@ env_keys: required_test: env-contract:server-error-stacktrace-policy - name: APP_SERVER_ERROR_INCLUDE_MESSAGE - # 출처: feature-env-driven-runtime-configuration D2 (2026-06-05) — APP_ 통일 + # source: feature-env-driven-runtime-configuration D2 (2026-06-05) — APP_ 통일 # (spring.web.error.include-message 정책) type: enum default: never @@ -259,7 +259,7 @@ env_keys: required_test: env-contract:server-error-message-policy - name: APP_MULTI_INSTANCE_ENABLED - # 출처: feature-env-driven-runtime-configuration D8 (2026-06-06) + # source: feature-env-driven-runtime-configuration D8 (2026-06-06) # true면 StartupSafetyValidator(다른 singleton보다 먼저 도는 StartupRule)가 이름이 # distributedLockProvider인 인스턴스 간 DistributedLockPort bean을 요구한다. 없으면 기동이 실패한다 # (exit 72). 이 값을 쓰는 곳: feature-runtime-health-lifecycle-contract, @@ -278,7 +278,7 @@ env_keys: required_test: env-contract:multi-instance-beans-present - name: APP_MIGRATION_ON_STARTUP - # 출처: feature-migration-startup-contract + # source: feature-migration-startup-contract # true면 애플리케이션이 기동하면서 Flyway migration을 자동으로 돌린다. # false면 migration을 건너뛴다(앱 밖의 container·pipeline job에 맡긴다). type: boolean @@ -295,7 +295,7 @@ env_keys: # === Datasource / pool (env-driven branch "Required config: datasource") === - name: APP_DATASOURCE_URL - # 출처: feature-env-driven-runtime-configuration "Required config: datasource" + # source: feature-env-driven-runtime-configuration "Required config: datasource" # + feature-persistence-failure-baseline "datasource/pool/timeout/connection exhaustion log field" # (datasource·pool·timeout·연결 고갈 로그 필드) type: url @@ -310,7 +310,7 @@ env_keys: required_test: env-contract:datasource-url-resolvable - name: APP_DATASOURCE_USERNAME - # 출처: feature-env-driven-runtime-configuration "Required config: datasource" + # source: feature-env-driven-runtime-configuration "Required config: datasource" type: string default: null allowed_values: null @@ -323,7 +323,7 @@ env_keys: required_test: env-contract:datasource-credential-present - name: APP_DATASOURCE_PASSWORD - # 출처: feature-env-driven-runtime-configuration "Required config: datasource" + # source: feature-env-driven-runtime-configuration "Required config: datasource" # + feature-secrets-config-source-contract — secret 분류라 secrets-classification.yaml이 행을 가진다 type: string default: null @@ -337,7 +337,7 @@ env_keys: required_test: secrets-contract:db-password-not-leaked - name: APP_PERSISTENCE_VENDOR - # 출처: application-local.yml과 bootRunH2가 쓰는 영속성 vendor 선택자. + # source: application-local.yml과 bootRunH2가 쓰는 영속성 vendor 선택자. # PostgreSQL이 기본으로 들어 있고, H2는 개발자가 명시적으로 고를 때만 쓴다. property: app.persistence.vendor type: enum @@ -381,7 +381,7 @@ env_keys: required_test: jpa-contract:realtime-replay-env - name: APP_FLYWAY_ENABLED - # 출처: 로컬 PostgreSQL을 운영과 맞춤 / 명시적 H2 개발 lane. + # source: 로컬 PostgreSQL을 운영과 맞춤 / 명시적 H2 개발 lane. # 모든 profile이 기본으로 migration을 돌린다 — persistence-jpa 모듈 기본값이 이 키를 읽는다 # (07-08; dev/prod가 그 위에 값을 박지 않는다). bootRunH2는 migration tree가 PostgreSQL 전용이라 # 끈다. @@ -398,7 +398,7 @@ env_keys: required_test: jpa-contract:local-flyway-parity - name: APP_DATASOURCE_POOL_MAX_SIZE - # 출처: feature-env-driven-runtime-configuration "datasource/pool env" + # source: feature-env-driven-runtime-configuration "datasource/pool env" # + feature-persistence-failure-baseline "Hikari metric 노출 기준" type: int default: 10 @@ -412,7 +412,7 @@ env_keys: required_test: env-contract:pool-bounded - name: APP_DATASOURCE_POOL_MIN_IDLE - # 출처: feature-env-driven-runtime-configuration "datasource/pool env" + # source: feature-env-driven-runtime-configuration "datasource/pool env" type: int default: 2 allowed_values: null @@ -425,7 +425,7 @@ env_keys: required_test: env-contract:pool-min-idle-valid - name: APP_DATASOURCE_CONNECTION_TIMEOUT - # 출처: feature-env-driven-runtime-configuration "datasource/pool env" + # source: feature-env-driven-runtime-configuration "datasource/pool env" # + feature-persistence-failure-baseline "Hikari Alert Threshold: pool wait p99 > 100ms" # 단위: 밀리초. 이 값은 spring.datasource.hikari.connection-timeout으로 가고, 그 키는 # HikariConfig#setConnectionTimeout(long)에 바인딩된다 — "5s" 같은 duration 줄임 표기는 바인딩되지 않아 @@ -444,7 +444,7 @@ env_keys: required_test: env-contract:connection-timeout-set - name: APP_DATASOURCE_DRIVER - # 출처: feature-env-driven-runtime-configuration "Required config: datasource" + # source: feature-env-driven-runtime-configuration "Required config: datasource" # (설정한 datasource URL의 JDBC driver class) type: string default: org.postgresql.Driver @@ -458,7 +458,7 @@ env_keys: required_test: env-contract:datasource-driver-set - name: APP_DATASOURCE_DDL_AUTO - # 출처: feature-env-driven-runtime-configuration "Required config: datasource" + # source: feature-env-driven-runtime-configuration "Required config: datasource" # (Hibernate ddl-auto. prod는 validate|none이어야 하고, local은 update가 편하다) type: enum default: validate @@ -472,7 +472,7 @@ env_keys: required_test: env-contract:datasource-ddl-auto-safe - name: APP_DATASOURCE_SHOW_SQL - # 출처: feature-env-driven-runtime-configuration "Required config: datasource" + # source: feature-env-driven-runtime-configuration "Required config: datasource" # (SQL을 로그에 찍는다) type: boolean default: false @@ -486,7 +486,7 @@ env_keys: required_test: env-contract:datasource-show-sql-toggle - name: APP_DATASOURCE_FORMAT_SQL - # 출처: feature-env-driven-runtime-configuration "Required config: datasource" + # source: feature-env-driven-runtime-configuration "Required config: datasource" # (SQL을 보기 좋게 찍는다 — SHOW_SQL=true일 때만 쓸모 있다) type: boolean default: false @@ -500,7 +500,7 @@ env_keys: required_test: env-contract:datasource-format-sql-toggle - name: APP_DATASOURCE_OPEN_IN_VIEW - # 출처: feature-env-driven-runtime-configuration "Required config: datasource" + # source: feature-env-driven-runtime-configuration "Required config: datasource" # (Hibernate OSIV — prod에서 켜지 않는다) type: boolean default: false @@ -514,7 +514,7 @@ env_keys: required_test: env-contract:datasource-open-in-view-toggle - name: APP_DATASOURCE_POOL_IDLE_TIMEOUT - # 출처: feature-env-driven-runtime-configuration "datasource/pool env" + # source: feature-env-driven-runtime-configuration "datasource/pool env" # (Hikari 밀리초. 쉬는 연결을 내보내는 기준) type: int default: 600000 @@ -528,7 +528,7 @@ env_keys: required_test: env-contract:pool-idle-timeout-valid - name: APP_DATASOURCE_POOL_MAX_LIFETIME - # 출처: feature-env-driven-runtime-configuration "datasource/pool env" + # source: feature-env-driven-runtime-configuration "datasource/pool env" # (Hikari 밀리초. 연결 최대 수명 — broker timeout 전에 교체한다) type: int default: 1800000 @@ -544,7 +544,7 @@ env_keys: # === 추적 / 관측 (feature-distributed-tracing-contract) === - name: OTEL_EXPORTER_OTLP_ENDPOINT - # 출처: feature-distributed-tracing-contract 2026-05-22 + # source: feature-distributed-tracing-contract 2026-05-22 # "Micrometer Tracing + OpenTelemetry exporter를 기본 기준으로 둠" # OTLP 기본 주소(OpenTelemetry 규격). TracingEnvironmentPostProcessor가 이 값을 # management.opentelemetry.tracing.export.otlp.endpoint의 /v1/traces(OTLP/HTTP)로 잇는다. @@ -561,7 +561,7 @@ env_keys: required_test: tracing-contract:exporter-endpoint-resolvable - name: APP_TRACING_ENABLED - # 출처: feature-distributed-tracing-contract 2026-05-22 + # source: feature-distributed-tracing-contract 2026-05-22 # "tracing disabled profile에서도 envelope meta.traceId와 log traceId는 유지" type: boolean default: true @@ -575,7 +575,7 @@ env_keys: required_test: tracing-contract:meta-traceid-when-disabled - name: APP_TRACING_SAMPLE_RATE - # 출처: feature-distributed-tracing-contract 2026-05-22 + # source: feature-distributed-tracing-contract 2026-05-22 # "trace sampling rate default = prod 1%, dev/local 100%" # D-1 ISSUE-1 fix (2026-06-16): 빈 값 = profile별 resolver 기본값을 쓴다. # RuntimeEnvironment가 profile의 정본이다. resolver 정책은 prod=0.01, dev/local=1.0. @@ -597,7 +597,7 @@ env_keys: # — feature-log-management-contract가 만든 대로. - name: APP_LOG_LEVEL_ROOT - # 출처: feature-log-management-contract — root logger 레벨 + # source: feature-log-management-contract — root logger 레벨 type: enum default: INFO allowed_values: [TRACE, DEBUG, INFO, WARN, ERROR, OFF] @@ -610,7 +610,7 @@ env_keys: required_test: log-contract:root-level - name: APP_LOG_LEVEL_APP - # 출처: feature-log-management-contract — 애플리케이션 패키지 레벨 + # source: feature-log-management-contract — 애플리케이션 패키지 레벨 type: enum default: INFO allowed_values: [TRACE, DEBUG, INFO, WARN, ERROR, OFF] @@ -623,7 +623,7 @@ env_keys: required_test: log-contract:app-level - name: APP_LOG_LEVEL_SPRING - # 출처: feature-log-management-contract — Spring framework 패키지 레벨 + # source: feature-log-management-contract — Spring framework 패키지 레벨 type: enum default: INFO allowed_values: [TRACE, DEBUG, INFO, WARN, ERROR, OFF] @@ -636,7 +636,7 @@ env_keys: required_test: log-contract:spring-level - name: APP_LOG_LEVEL_WEB - # 출처: feature-log-management-contract — web/MVC 패키지 레벨 + # source: feature-log-management-contract — web/MVC 패키지 레벨 type: enum default: INFO allowed_values: [TRACE, DEBUG, INFO, WARN, ERROR, OFF] @@ -649,7 +649,7 @@ env_keys: required_test: log-contract:web-level - name: APP_LOG_LEVEL_SQL - # 출처: feature-log-management-contract — JPA/JDBC SQL 패키지 레벨 (DEBUG면 SQL을 찍는다) + # source: feature-log-management-contract — JPA/JDBC SQL 패키지 레벨 (DEBUG면 SQL을 찍는다) type: enum default: WARN allowed_values: [TRACE, DEBUG, INFO, WARN, ERROR, OFF] @@ -662,7 +662,7 @@ env_keys: required_test: log-contract:sql-level - name: APP_LOG_FILE_ENABLED - # 출처: feature-log-management-contract — 순환(rolling) JSON 파일 appender 켜고 끄기 + # source: feature-log-management-contract — 순환(rolling) JSON 파일 appender 켜고 끄기 type: boolean default: false allowed_values: [true, false] @@ -675,7 +675,7 @@ env_keys: required_test: log-contract:file-appender-toggle - name: APP_LOG_FILE_PATH - # 출처: feature-log-management-contract — 파일 경로 (bootRun 실행 위치 기준 상대 경로 또는 절대 경로) + # source: feature-log-management-contract — 파일 경로 (bootRun 실행 위치 기준 상대 경로 또는 절대 경로) type: string default: logs/ca-skeleton.json allowed_values: null @@ -688,7 +688,7 @@ env_keys: required_test: log-contract:file-path-set - name: APP_LOG_FILE_MAX_SIZE - # 출처: feature-log-management-contract — 파일 하나의 순환 크기 상한 + # source: feature-log-management-contract — 파일 하나의 순환 크기 상한 type: data_size default: 100MB allowed_values: null @@ -701,7 +701,7 @@ env_keys: required_test: log-contract:file-max-size - name: APP_LOG_FILE_MAX_HISTORY - # 출처: feature-log-management-contract — 남길 순환 보관 파일 수 + # source: feature-log-management-contract — 남길 순환 보관 파일 수 type: int default: 14 allowed_values: null @@ -714,7 +714,7 @@ env_keys: required_test: log-contract:file-max-history - name: APP_LOG_FILE_TOTAL_SIZE_CAP - # 출처: feature-log-management-contract — 순환 파일 전체의 크기 상한 + # source: feature-log-management-contract — 순환 파일 전체의 크기 상한 type: data_size default: 3GB allowed_values: null @@ -727,7 +727,7 @@ env_keys: required_test: log-contract:file-total-size-cap - name: APP_LOG_ASYNC_ENABLED - # 출처: feature-log-management-contract — 막히지 않는 I/O를 위한 AsyncAppender 감싸기 + # source: feature-log-management-contract — 막히지 않는 I/O를 위한 AsyncAppender 감싸기 type: boolean default: true allowed_values: [true, false] @@ -740,7 +740,7 @@ env_keys: required_test: log-contract:async-appender-toggle - name: APP_LOG_ASYNC_QUEUE_SIZE - # 출처: feature-log-management-contract — 역압(back-pressure) 전 메모리 queue 깊이 + # source: feature-log-management-contract — 역압(back-pressure) 전 메모리 queue 깊이 type: int default: 512 allowed_values: null @@ -753,7 +753,7 @@ env_keys: required_test: log-contract:async-queue-size - name: APP_LOG_ASYNC_DISCARDING_THRESHOLD - # 출처: feature-log-management-contract — 남은 용량이 이 값 아래로 내려가면 + # source: feature-log-management-contract — 남은 용량이 이 값 아래로 내려가면 # TRACE/DEBUG/INFO 이벤트를 버린다(WARN/ERROR는 늘 남긴다). 0 = 버리지 않는다. type: int default: 20 @@ -767,7 +767,7 @@ env_keys: required_test: log-contract:async-discarding-threshold - name: APP_LOG_JSON_TIMEZONE - # 출처: feature-log-management-contract — JSON encoder 시각에 쓰는 IANA timezone + # source: feature-log-management-contract — JSON encoder 시각에 쓰는 IANA timezone type: string default: UTC allowed_values: null @@ -780,7 +780,7 @@ env_keys: required_test: log-contract:json-timezone - name: APP_LOG_JSON_TIMESTAMP_PATTERN - # 출처: feature-log-management-contract — JSON encoder 시각 형식 (기본 ISO 8601) + # source: feature-log-management-contract — JSON encoder 시각 형식 (기본 ISO 8601) type: string default: "yyyy-MM-dd'T'HH:mm:ss.SSSXXX" allowed_values: null @@ -793,7 +793,7 @@ env_keys: required_test: log-contract:json-timestamp-pattern - name: APP_LOG_JSON_INCLUDE_CALLER_DATA - # 출처: feature-log-management-contract — 파일·메서드·줄 번호를 넣는다 (성능 비용이 크다) + # source: feature-log-management-contract — 파일·메서드·줄 번호를 넣는다 (성능 비용이 크다) type: boolean default: false allowed_values: [true, false] @@ -806,7 +806,7 @@ env_keys: required_test: log-contract:json-include-caller-data - name: APP_LOG_JSON_LOGGER_NAME_LENGTH - # 출처: feature-log-management-contract — logger 이름 줄이기 (0 = 전체 이름) + # source: feature-log-management-contract — logger 이름 줄이기 (0 = 전체 이름) type: int default: 0 allowed_values: null @@ -819,7 +819,7 @@ env_keys: required_test: log-contract:json-logger-name-length - name: APP_LOG_SAMPLING_RATE - # 출처: feature-log-management-contract 2026-05-22 + # source: feature-log-management-contract 2026-05-22 # "log sampling(prod 10%) > trace sampling(prod 1%)" + Sampling Policy 표 (prod 10%, dev/local 100%) type: string default: "1.0" @@ -835,7 +835,7 @@ env_keys: # === 개인정보: user_principal 가명화 (feature-data-retention-privacy-contract) === - name: APP_PRIVACY_PSEUDONYMIZATION_SALT - # 출처: feature-data-retention-privacy-contract — "pseudonymization key = HMAC-SHA-256 + # source: feature-data-retention-privacy-contract — "pseudonymization key = HMAC-SHA-256 # with rotating salt (90d)" (가명화 키는 90일마다 바뀌는 salt의 HMAC-SHA-256). feature-log-management-contract # (DRIFT-6)가 user_principal을 가명 형태로 남기는 데 쓴다. secret 분류라 secrets-classification.yaml이 행을 # 가진다. @@ -853,7 +853,7 @@ env_keys: # === Security / CORS / JWT (feature-security-operational-baseline) === - name: APP_SECURITY_CORS_ORIGINS - # 출처: feature-security-operational-baseline 2026-05-22 + # source: feature-security-operational-baseline 2026-05-22 # "allowlist origin은 env-driven runtime configuration의 APP_SECURITY_CORS_ORIGINS로 주입" type: csv_list default: null @@ -867,7 +867,7 @@ env_keys: required_test: security-contract:cors-allowlist - name: APP_SECURITY_CORS_ENABLED - # 출처: feature-security-operational-baseline — CORS filter 전체 켜고 끄기 + # source: feature-security-operational-baseline — CORS filter 전체 켜고 끄기 type: boolean default: false allowed_values: [true, false] @@ -880,7 +880,7 @@ env_keys: required_test: security-contract:cors-enabled-toggle - name: APP_SECURITY_CORS_ALLOWED_METHODS - # 출처: feature-security-operational-baseline — 허용 method + # source: feature-security-operational-baseline — 허용 method # (빈 값 -> CorsSettings의 무난한 method 기본값) type: csv_list default: null @@ -894,7 +894,7 @@ env_keys: required_test: security-contract:cors-allowed-methods - name: APP_SECURITY_CORS_ALLOWED_HEADERS - # 출처: feature-security-operational-baseline — 허용 요청 헤더 ("*" = 모두) + # source: feature-security-operational-baseline — 허용 요청 헤더 ("*" = 모두) type: csv_list default: "*" allowed_values: null @@ -907,7 +907,7 @@ env_keys: required_test: security-contract:cors-allowed-headers - name: APP_SECURITY_CORS_ALLOW_CREDENTIALS - # 출처: feature-security-operational-baseline 2026-05-22 + # source: feature-security-operational-baseline 2026-05-22 # "CORS는 allowlist default, credentials false default" / "wildcard with credentials forbidden" type: boolean default: false @@ -921,7 +921,7 @@ env_keys: required_test: security-contract:cors-credentials-policy - name: APP_SECURITY_CORS_MAX_AGE - # 출처: feature-security-operational-baseline 2026-05-22 + # source: feature-security-operational-baseline 2026-05-22 # "preflight max-age 600s default" type: duration default: 600s @@ -1159,7 +1159,7 @@ env_keys: required_test: redis-session-contract:serializer-bounded - name: APP_SECURITY_JWT_ISSUER - # 출처: feature-security-operational-baseline 2026-05-22 + # source: feature-security-operational-baseline 2026-05-22 # "issuer mismatch | 401 | AUTH_ISSUER_MISMATCH" type: url default: null @@ -1173,7 +1173,7 @@ env_keys: required_test: security-contract:jwt-issuer-set - name: APP_SECURITY_JWT_AUDIENCE - # 출처: feature-security-operational-baseline 2026-05-22 + # source: feature-security-operational-baseline 2026-05-22 # "audience mismatch | 401 | AUTH_AUDIENCE_MISMATCH" type: csv_list default: null @@ -2379,7 +2379,7 @@ env_keys: compatibility_impact: additive required_test: redis-sdk:runtime-composition-binds-and-validates - name: APP_CACHE_REDIS_ENABLED - # 출처: feature-integration-adapter-templates 2026-05-22 + # source: feature-integration-adapter-templates 2026-05-22 # "Redis | disabled optional module | cache consistency" + Adapter Template Defaults 표 # 폐기 2026-08-10: 두 번째 Redis 전체 스위치였고, 이를 바인딩하던 settings class를 옛 Redis 세대와 함께 # 지워서 이 키는 어디에도 닿지 않는다. 전역 켜기는 APP_REDIS_ENABLED 하나가 정한다. 캐시 role은 @@ -2420,7 +2420,7 @@ env_keys: # 닿지 않는다. 아직 이 키를 쓰는 배포에 무엇이 대신하는지 알려 주려고 행을 지우지 않고 둔다. deprecated_orphaned: true removal_deadline: 2026-11-30 - # 출처: feature-cache-consistency-contract — Redis adapter (켜면 endpoint가 필요하다) + # source: feature-cache-consistency-contract — Redis adapter (켜면 endpoint가 필요하다) type: string default: null allowed_values: null @@ -2437,7 +2437,7 @@ env_keys: # 닿지 않는다. 아직 이 키를 쓰는 배포에 무엇이 대신하는지 알려 주려고 행을 지우지 않고 둔다. deprecated_orphaned: true removal_deadline: 2026-11-30 - # 출처: feature-cache-consistency-contract — Redis adapter endpoint + # source: feature-cache-consistency-contract — Redis adapter endpoint type: int default: 6379 allowed_values: null @@ -2801,7 +2801,7 @@ env_keys: # 닿지 않는다. 아직 이 키를 쓰는 배포에 무엇이 대신하는지 알려 주려고 행을 지우지 않고 둔다. deprecated_orphaned: true removal_deadline: 2026-11-30 - # 출처: feature-cache-consistency-contract 2026-05-22 + # source: feature-cache-consistency-contract 2026-05-22 # "TTL | explicit per key family | no-cache for sensitive data | immortal cache forbidden" type: duration default: 300s @@ -2819,7 +2819,7 @@ env_keys: # 닿지 않는다. 아직 이 키를 쓰는 배포에 무엇이 대신하는지 알려 주려고 행을 지우지 않고 둔다. deprecated_orphaned: true removal_deadline: 2026-11-30 - # 출처: feature-cache-consistency-contract 2026-05-22 + # source: feature-cache-consistency-contract 2026-05-22 # "negative cache 정책 = 존재하지 않는 row는 짧은 TTL(60s) 캐싱 허용" type: duration default: 60s @@ -2835,7 +2835,7 @@ env_keys: # === 메시징 / Kafka (feature-domain-event-outbox-contract + integration-adapter-templates) === - name: APP_MESSAGING_BROKER - # 출처: messaging multi-broker redesign 2026-06-16 — 활성 broker 하나를 고른다 + # source: messaging multi-broker redesign 2026-06-16 — 활성 broker 하나를 고른다 # (app.messaging.broker=). 들여온 메시징 플랫폼이 읽는다. 옛 Kafka 전용 APP_MESSAGING_KAFKA_ENABLED를 # 대신한다. 애플리케이션 bridge는 이제 읽지 않는다: 읽던 옛 KafkaSender seam은 canonical outbox와 함께 # 지웠다(2026-09-28). @@ -2852,7 +2852,7 @@ env_keys: required_test: adapter-contract:messaging-broker-selection - name: APP_MESSAGING_PRODUCER_ID - # 출처: canonical messaging platform bridge 2026-09-18 + # source: canonical messaging platform bridge 2026-09-18 # IntegrationEventPublishPort가 쓰는, 메시지를 내는 서비스의 논리 이름(명시값). # 비었거나 없음 = canonical 플랫폼 bridge를 내놓지 않는다. 이름을 짐작하지 않는다. # outbox relay를 포함해 모든 발행이 그 bridge를 거치므로, 메시징 모듈이 있고 켜진 상태에서 값이 비면 기동을 @@ -2870,7 +2870,7 @@ env_keys: required_test: adapter-contract:messaging-platform-producer-id - name: APP_MESSAGING_KAFKA_BROKERS - # 출처: feature-domain-event-outbox-contract — "Kafka는 optional integration adapter" + # source: feature-domain-event-outbox-contract — "Kafka는 optional integration adapter" # (broker를 켜면 endpoint가 필요하다) # Kafka 모듈의 config/module-defaults/messaging.yml을 거쳐 app.messaging.brokers.kafka.bootstrap-servers # (메시징 플랫폼의 Kafka transport)로 간다. spring.kafka.bootstrap-servers는 읽지 않는다. @@ -2888,7 +2888,7 @@ env_keys: # === 알림 adapter (feature-integration-adapter-templates) === - name: APP_NOTIFICATION_SLACK_WEBHOOK_ENABLED - # 출처: R0 Slack webhook provider 스위치. app.notification.slack-webhook.enabled로 이어진다 + # source: R0 Slack webhook provider 스위치. app.notification.slack-webhook.enabled로 이어진다 type: boolean default: false allowed_values: [true, false] @@ -2901,7 +2901,7 @@ env_keys: required_test: adapter-contract:notification-slack-provider-selection - name: APP_NOTIFICATION_GOOGLE_EMAIL_ENABLED - # 출처: R0 Google email provider 스위치. app.notification.google-email.enabled로 이어진다 + # source: R0 Google email provider 스위치. app.notification.google-email.enabled로 이어진다 type: boolean default: false allowed_values: [true, false] @@ -3679,7 +3679,7 @@ env_keys: # === 파일 / 업로드 (feature-file-resource-handling-contract) === - name: APP_ASYNC_EXECUTOR_CORE_SIZE - # 출처: feature-background-job-async-contract 2026-05-22 + # source: feature-background-job-async-contract 2026-05-22 # "executor pool sizing default = core=10, max=50, queue=200" type: int default: 10 @@ -3693,7 +3693,7 @@ env_keys: required_test: async-contract:executor-core-size - name: APP_ASYNC_EXECUTOR_MAX_SIZE - # 출처: feature-background-job-async-contract 2026-05-22 + # source: feature-background-job-async-contract 2026-05-22 # "core=10, max=50, queue=200" type: int default: 50 @@ -3707,7 +3707,7 @@ env_keys: required_test: async-contract:executor-max-size - name: APP_ASYNC_EXECUTOR_QUEUE_CAPACITY - # 출처: feature-background-job-async-contract 2026-05-22 + # source: feature-background-job-async-contract 2026-05-22 # "queue=200" + "unbounded queue forbidden" type: int default: 200 @@ -3725,7 +3725,7 @@ env_keys: # 가지므로, 플랫폼을 끈 배포는 아무것도 주지 않아도 된다. 참고: docs/notification/configuration-reference.md. - name: APP_PERSISTENCE_JPA_ENABLED - # 출처: five-adapter-runtime-remediation §5.1 — 관계형 영속성 스위치. persistence-jpa 모듈이 직접 + # source: five-adapter-runtime-remediation §5.1 — 관계형 영속성 스위치. persistence-jpa 모듈이 직접 # 가진다(config/module-defaults/persistence-jpa.yml). 모듈은 빌드 한 줄로 고르고, 있는 동안 켜진다. false면 # 이 모듈의 bean(entity scan, repository, store, 기동 관문)을 끈다. 빌드 줄을 지우면 기능과 이 키를 읽는 유일한 # 곳이 함께 사라진다. 옛 app.jpa-platform.enabled는 이 키처럼 읽혔지만 부가 bean 셋만 막았다. @@ -3817,7 +3817,7 @@ env_keys: - name: APP_PERSISTENCE_MONGO_ENABLED # 2026-09-25 capability 포장: 모듈은 있으면 켜진다(모듈 자신의 설정 yml이 이 키를 기본 true로 잇는다). # false가 명시적으로 끄는 값이다. 빌드에 모듈이 없는 것이 보통의 꺼진 상태다. - # 출처: five-adapter-runtime-remediation §5.1 — MongoDB 영속성 켜고 끄기. + # source: five-adapter-runtime-remediation §5.1 — MongoDB 영속성 켜고 끄기. type: boolean default: true allowed_values: [true, false] @@ -3829,7 +3829,7 @@ env_keys: compatibility_impact: behavior-change required_test: adapter-contract:persistence-mongo-disabled-safe - name: APP_PERSISTENCE_MONGO_ACTIVE_PROFILE - # 출처: five-adapter-runtime-remediation §5.1 — Mongo profile을 정확히 하나 고른다. 런타임은 sync client + # source: five-adapter-runtime-remediation §5.1 — Mongo profile을 정확히 하나 고른다. 런타임은 sync client # 하나와 pool 하나를 만든다. map에 있지만 고르지 않은 profile은 비밀을 풀지도, client를 만들지도 않는다. type: string default: "" @@ -3842,7 +3842,7 @@ env_keys: compatibility_impact: behavior-change required_test: adapter-contract:persistence-mongo-active-profile - name: SPRING_MONGODB_URI - # 출처: persistence-mongo techlead review C1. Spring Boot 4는 이 자체 키를 spring.mongodb.uri로 쓴다. + # source: persistence-mongo techlead review C1. Spring Boot 4는 이 자체 키를 spring.mongodb.uri로 쓴다. # 유효한 연결 출처 둘 중 하나다. 다른 하나는 고른 typed profile의 uri-secret을 MongoCredentialResolver로 푼 # 값이다. type: string @@ -3860,7 +3860,7 @@ env_keys: - name: APP_MESSAGING_ENABLED # 2026-09-25 capability 포장: 모듈은 있으면 켜진다(모듈 자신의 설정 yml이 이 키를 기본 true로 잇는다). # false가 명시적으로 끄는 값이다. 빌드에 모듈이 없는 것이 보통의 꺼진 상태다. - # 출처: five-adapter-runtime-remediation §5.1 — broker 발행 켜고 끄기. + # source: five-adapter-runtime-remediation §5.1 — broker 발행 켜고 끄기. # APP_MESSAGING_BROKER는 어느 transport인지만 고르고, 이제 사실상의 스위치가 아니다. type: boolean default: true @@ -4060,7 +4060,7 @@ env_keys: - name: APP_GRAPHQL_ENABLED # 2026-09-25 capability 포장: 모듈은 있으면 켜진다(모듈 자신의 설정 yml이 이 키를 기본 true로 잇는다). # false가 명시적으로 끄는 값이다. 빌드에 모듈이 없는 것이 보통의 꺼진 상태다. - # 출처: five-adapter-runtime-remediation §5.1 — GraphQL transport 켜고 끄기. + # source: five-adapter-runtime-remediation §5.1 — GraphQL transport 켜고 끄기. # false면 /graphql route를 내지 않는다. Spring GraphQL이 스스로 내는 route도 포함이다. type: boolean default: true @@ -4073,7 +4073,7 @@ env_keys: compatibility_impact: behavior-change required_test: adapter-contract:graphql-disabled-safe - name: APP_GRAPHQL_DEPLOYMENT_MODE - # 출처: five-adapter-runtime-remediation §5.1 / GQL-INT-002 — app.graphql.production과 + # source: five-adapter-runtime-remediation §5.1 / GQL-INT-002 — app.graphql.production과 # app.graphql.environment를 대신한다. 둘의 기본값이 production=false와 environment=PRODUCTION_PUBLIC이라, # 익명 principal과 기본 허용 권한 검사는 한 축을 읽고 다른 축은 production이라 주장했다. type: enum @@ -4238,7 +4238,7 @@ env_keys: required_test: graphql-contract:wired-operator-settings - name: APP_OUTBOX_ENABLED - # 출처: five-adapter-runtime-remediation §6.1 JPA-INT-004 — outbox 기능 스위치. + # source: five-adapter-runtime-remediation §6.1 JPA-INT-004 — outbox 기능 스위치. # 아래 relay-enabled는 scheduler만 시작한다. 둘을 섞으면 relay를 끈 배포도 DB 없는 런타임에는 없는 store # port 위에 outbox metrics를 조립했다. type: boolean @@ -4252,7 +4252,7 @@ env_keys: compatibility_impact: behavior-change required_test: adapter-contract:outbox-capability-disabled-safe - name: APP_OUTBOX_RELAY_ENABLED - # 출처: five-adapter-runtime-remediation §6.3 MSG-INT-001 — relay scheduler를 시작한다. + # source: five-adapter-runtime-remediation §6.3 MSG-INT-001 — relay scheduler를 시작한다. # APP_OUTBOX_ENABLED, APP_PERSISTENCE_JPA_ENABLED, APP_MESSAGING_ENABLED와 APP_MESSAGING_PRODUCER_ID가 # 필요하다. 예전 기본값은 broker가 빈 채로 true라 모든 기동을 거부했다. type: boolean @@ -4269,7 +4269,7 @@ env_keys: # 2026-09-25 capability 포장: notification-platform 모듈은 있으면 켜진다(모듈의 # config/module-defaults/notification.yml이 이 키를 기본 true로 잇는다). false가 명시적으로 끄는 값이고 # 아무것도 바인딩하지 않는다. 빌드에 모듈이 없는 것이 보통의 꺼진 상태다. - # 출처: NTF-025. + # source: NTF-025. type: boolean default: true allowed_values: [true, false] @@ -4296,7 +4296,7 @@ env_keys: required_test: application-contract:notification-default-locale - name: APP_NOTIFICATION_PLATFORM_CONTACT_ENCRYPTION_KEY - # 출처: NTF-INT-007 — 저장된 수신자 연락처(주소와 전화번호)를 암호화한다. + # source: NTF-INT-007 — 저장된 수신자 연락처(주소와 전화번호)를 암호화한다. # 행 전체는 secrets-classification.yaml이 가진다. 바인딩 위치: # app.notification.platform.secrets.contact-encryption-key. 플랫폼이 기동할 때 값을 풀고, # 비었거나 32바이트보다 짧거나 다른 용도의 key와 같으면 기동을 거부한다. @@ -4312,7 +4312,7 @@ env_keys: required_test: adapter-contract:notification-secret-material-required - name: APP_NOTIFICATION_PLATFORM_CONTACT_LOOKUP_HMAC_KEY - # 출처: NTF-INT-007 — 연락처의 blind index. 조회에 평문이 필요 없게 한다. + # source: NTF-INT-007 — 연락처의 blind index. 조회에 평문이 필요 없게 한다. # 행 전체는 secrets-classification.yaml이 가진다. 바인딩 위치: # app.notification.platform.secrets.contact-lookup-hmac-key. 플랫폼이 기동할 때 값을 풀고, # 비었거나 32바이트보다 짧거나 다른 용도의 key와 같으면 기동을 거부한다. @@ -4328,7 +4328,7 @@ env_keys: required_test: adapter-contract:notification-secret-material-required - name: APP_NOTIFICATION_PLATFORM_CALLBACK_SIGNING_KEY - # 출처: NTF-INT-007 — provider가 전달 결과를 보내는 callback URL에 서명한다. + # source: NTF-INT-007 — provider가 전달 결과를 보내는 callback URL에 서명한다. # 행 전체는 secrets-classification.yaml이 가진다. 바인딩 위치: # app.notification.platform.secrets.callback-signing-key. 플랫폼이 기동할 때 값을 풀고, # 비었거나 32바이트보다 짧거나 다른 용도의 key와 같으면 기동을 거부한다. @@ -4344,7 +4344,7 @@ env_keys: required_test: adapter-contract:notification-secret-material-required - name: APP_NOTIFICATION_PLATFORM_PROVIDER_CREDENTIAL_KEY - # 출처: NTF-INT-007 — 저장된 provider 자격 증명(그 자체가 비밀)을 암호화한다. + # source: NTF-INT-007 — 저장된 provider 자격 증명(그 자체가 비밀)을 암호화한다. # 행 전체는 secrets-classification.yaml이 가진다. 바인딩 위치: # app.notification.platform.secrets.provider-credential-key. 플랫폼이 기동할 때 값을 풀고, # 비었거나 32바이트보다 짧거나 다른 용도의 key와 같으면 기동을 거부한다. @@ -4360,7 +4360,7 @@ env_keys: required_test: adapter-contract:notification-secret-material-required - name: APP_NOTIFICATION_PLATFORM_PAYLOAD_ENCRYPTION_KEY - # 출처: NTF-INT-007 — 저장된 알림 변수와 보관한 callback 본문을 암호화한다. + # source: NTF-INT-007 — 저장된 알림 변수와 보관한 callback 본문을 암호화한다. # 행 전체는 secrets-classification.yaml이 가진다. 바인딩 위치: # app.notification.platform.secrets.payload-encryption-key. 플랫폼이 기동할 때 값을 풀고, # 비었거나 32바이트보다 짧거나 다른 용도의 key와 같으면 기동을 거부한다. @@ -4376,7 +4376,7 @@ env_keys: required_test: adapter-contract:notification-secret-material-required - name: APP_NOTIFICATION_PLATFORM_PROVIDER_REQUEST_LOOKUP_HMAC_KEY - # 출처: NTF-INT-007 — provider 쪽 식별자인 provider request id의 key 있는 hash. + # source: NTF-INT-007 — provider 쪽 식별자인 provider request id의 key 있는 hash. # 행 전체는 secrets-classification.yaml이 가진다. 바인딩 위치: # app.notification.platform.secrets.provider-request-lookup-hmac-key. 플랫폼이 기동할 때 값을 풀고, # 비었거나 32바이트보다 짧거나 다른 용도의 key와 같으면 기동을 거부한다. @@ -4392,7 +4392,7 @@ env_keys: required_test: adapter-contract:notification-secret-material-required - name: APP_NOTIFICATION_PLATFORM_CALLBACK_FINGERPRINT_HMAC_KEY - # 출처: NTF-INT-007 — callback 본문의 key 있는 fingerprint. replay를 찾는 데 쓴다. + # source: NTF-INT-007 — callback 본문의 key 있는 fingerprint. replay를 찾는 데 쓴다. # 행 전체는 secrets-classification.yaml이 가진다. 바인딩 위치: # app.notification.platform.secrets.callback-fingerprint-hmac-key. 플랫폼이 기동할 때 값을 풀고, # 비었거나 32바이트보다 짧거나 다른 용도의 key와 같으면 기동을 거부한다. @@ -4408,7 +4408,7 @@ env_keys: required_test: adapter-contract:notification-secret-material-required - name: APP_NOTIFICATION_PLATFORM_CONTACT_ENCRYPTION_KEY_ID - # 출처: NTF-INT-007 — CONTACT_ENCRYPTION key가 만드는 모든 envelope에 적는 id. + # source: NTF-INT-007 — CONTACT_ENCRYPTION key가 만드는 모든 envelope에 적는 id. # key 자료가 아니라 식별자라 public-config다. 자료 자체는 위의 # APP_NOTIFICATION_PLATFORM_CONTACT_ENCRYPTION_KEY 행이다. 바인딩 위치: # app.notification.platform.secrets.active-key-ids.CONTACT_ENCRYPTION. @@ -4424,7 +4424,7 @@ env_keys: required_test: adapter-contract:notification-secret-material-required - name: APP_NOTIFICATION_PLATFORM_CONTACT_LOOKUP_HMAC_KEY_ID - # 출처: NTF-INT-007 — CONTACT_LOOKUP_HMAC key가 만드는 모든 envelope에 적는 id. + # source: NTF-INT-007 — CONTACT_LOOKUP_HMAC key가 만드는 모든 envelope에 적는 id. # key 자료가 아니라 식별자라 public-config다. 자료 자체는 위의 # APP_NOTIFICATION_PLATFORM_CONTACT_LOOKUP_HMAC_KEY 행이다. 바인딩 위치: # app.notification.platform.secrets.active-key-ids.CONTACT_LOOKUP_HMAC. @@ -4440,7 +4440,7 @@ env_keys: required_test: adapter-contract:notification-secret-material-required - name: APP_NOTIFICATION_PLATFORM_CALLBACK_SIGNING_KEY_ID - # 출처: NTF-INT-007 — CALLBACK_SIGNING key가 만드는 모든 envelope에 적는 id. + # source: NTF-INT-007 — CALLBACK_SIGNING key가 만드는 모든 envelope에 적는 id. # key 자료가 아니라 식별자라 public-config다. 자료 자체는 위의 # APP_NOTIFICATION_PLATFORM_CALLBACK_SIGNING_KEY 행이다. 바인딩 위치: # app.notification.platform.secrets.active-key-ids.CALLBACK_SIGNING. @@ -4456,7 +4456,7 @@ env_keys: required_test: adapter-contract:notification-secret-material-required - name: APP_NOTIFICATION_PLATFORM_PROVIDER_CREDENTIAL_KEY_ID - # 출처: NTF-INT-007 — PROVIDER_CREDENTIAL key가 만드는 모든 envelope에 적는 id. + # source: NTF-INT-007 — PROVIDER_CREDENTIAL key가 만드는 모든 envelope에 적는 id. # key 자료가 아니라 식별자라 public-config다. 자료 자체는 위의 # APP_NOTIFICATION_PLATFORM_PROVIDER_CREDENTIAL_KEY 행이다. 바인딩 위치: # app.notification.platform.secrets.active-key-ids.PROVIDER_CREDENTIAL. @@ -4472,7 +4472,7 @@ env_keys: required_test: adapter-contract:notification-secret-material-required - name: APP_NOTIFICATION_PLATFORM_PAYLOAD_ENCRYPTION_KEY_ID - # 출처: NTF-INT-007 — PAYLOAD_ENCRYPTION key가 만드는 모든 envelope에 적는 id. + # source: NTF-INT-007 — PAYLOAD_ENCRYPTION key가 만드는 모든 envelope에 적는 id. # key 자료가 아니라 식별자라 public-config다. 자료 자체는 위의 # APP_NOTIFICATION_PLATFORM_PAYLOAD_ENCRYPTION_KEY 행이다. 바인딩 위치: # app.notification.platform.secrets.active-key-ids.PAYLOAD_ENCRYPTION. @@ -4488,7 +4488,7 @@ env_keys: required_test: adapter-contract:notification-secret-material-required - name: APP_NOTIFICATION_PLATFORM_PROVIDER_REQUEST_LOOKUP_HMAC_KEY_ID - # 출처: NTF-INT-007 — PROVIDER_REQUEST_LOOKUP_HMAC key가 만드는 모든 envelope에 적는 id. + # source: NTF-INT-007 — PROVIDER_REQUEST_LOOKUP_HMAC key가 만드는 모든 envelope에 적는 id. # key 자료가 아니라 식별자라 public-config다. 자료 자체는 위의 # APP_NOTIFICATION_PLATFORM_PROVIDER_REQUEST_LOOKUP_HMAC_KEY 행이다. 바인딩 위치: # app.notification.platform.secrets.active-key-ids.PROVIDER_REQUEST_LOOKUP_HMAC. @@ -4504,7 +4504,7 @@ env_keys: required_test: adapter-contract:notification-secret-material-required - name: APP_NOTIFICATION_PLATFORM_CALLBACK_FINGERPRINT_HMAC_KEY_ID - # 출처: NTF-INT-007 — CALLBACK_FINGERPRINT_HMAC key가 만드는 모든 envelope에 적는 id. + # source: NTF-INT-007 — CALLBACK_FINGERPRINT_HMAC key가 만드는 모든 envelope에 적는 id. # key 자료가 아니라 식별자라 public-config다. 자료 자체는 위의 # APP_NOTIFICATION_PLATFORM_CALLBACK_FINGERPRINT_HMAC_KEY 행이다. 바인딩 위치: # app.notification.platform.secrets.active-key-ids.CALLBACK_FINGERPRINT_HMAC. @@ -4520,7 +4520,7 @@ env_keys: required_test: adapter-contract:notification-secret-material-required - name: APP_NOTIFICATION_PLATFORM_SES_ENABLED - # 출처: notification/fileserver H4-B — 기본으로 들어 있는 SES 발송 조립기. + # source: notification/fileserver H4-B — 기본으로 들어 있는 SES 발송 조립기. type: boolean default: false allowed_values: [true, false] @@ -4533,7 +4533,7 @@ env_keys: required_test: adapter-contract:notification-ses-provider-assembled - name: APP_NOTIFICATION_PLATFORM_SES_PRIMARY - # 출처: notification/fileserver H4-B — 기본으로 들어 있는 SES 발송 조립기. + # source: notification/fileserver H4-B — 기본으로 들어 있는 SES 발송 조립기. type: boolean default: false allowed_values: [true, false] @@ -4546,7 +4546,7 @@ env_keys: required_test: adapter-contract:notification-ses-provider-assembled - name: APP_NOTIFICATION_PLATFORM_SES_ENVIRONMENT - # 출처: notification/fileserver H4-B — 기본으로 들어 있는 SES 발송 조립기. + # source: notification/fileserver H4-B — 기본으로 들어 있는 SES 발송 조립기. type: string default: PRODUCTION allowed_values: null @@ -4559,7 +4559,7 @@ env_keys: required_test: adapter-contract:notification-ses-provider-assembled - name: APP_NOTIFICATION_PLATFORM_SES_CREDENTIAL_KEY_ID - # 출처: notification/fileserver H4-B — 기본으로 들어 있는 SES 발송 조립기. + # source: notification/fileserver H4-B — 기본으로 들어 있는 SES 발송 조립기. type: string default: null allowed_values: null @@ -4572,7 +4572,7 @@ env_keys: required_test: adapter-contract:notification-ses-provider-assembled - name: APP_NOTIFICATION_PLATFORM_SES_TIMEOUT - # 출처: notification/fileserver H4-B — 기본으로 들어 있는 SES 발송 조립기. + # source: notification/fileserver H4-B — 기본으로 들어 있는 SES 발송 조립기. type: duration default: 10s allowed_values: null @@ -4585,7 +4585,7 @@ env_keys: required_test: adapter-contract:notification-ses-provider-assembled - name: APP_NOTIFICATION_PLATFORM_SES_MAX_CONCURRENCY - # 출처: notification/fileserver H4-B — 기본으로 들어 있는 SES 발송 조립기. + # source: notification/fileserver H4-B — 기본으로 들어 있는 SES 발송 조립기. type: int default: 8 allowed_values: null @@ -4598,7 +4598,7 @@ env_keys: required_test: adapter-contract:notification-ses-provider-assembled - name: APP_NOTIFICATION_PLATFORM_SES_RATE_PER_SECOND - # 출처: notification/fileserver H4-B — 기본으로 들어 있는 SES 발송 조립기. + # source: notification/fileserver H4-B — 기본으로 들어 있는 SES 발송 조립기. type: int default: 20 allowed_values: null @@ -4611,7 +4611,7 @@ env_keys: required_test: adapter-contract:notification-ses-provider-assembled - name: APP_NOTIFICATION_PLATFORM_SES_ENDPOINT - # 출처: notification/fileserver H4-B — 기본으로 들어 있는 SES 발송 조립기. + # source: notification/fileserver H4-B — 기본으로 들어 있는 SES 발송 조립기. type: string default: https://email.us-east-1.amazonaws.com allowed_values: null @@ -4624,7 +4624,7 @@ env_keys: required_test: adapter-contract:notification-ses-provider-assembled - name: APP_NOTIFICATION_PLATFORM_SES_REGION - # 출처: notification/fileserver H4-B — 기본으로 들어 있는 SES 발송 조립기. + # source: notification/fileserver H4-B — 기본으로 들어 있는 SES 발송 조립기. type: string default: us-east-1 allowed_values: null @@ -4637,7 +4637,7 @@ env_keys: required_test: adapter-contract:notification-ses-provider-assembled - name: APP_NOTIFICATION_PLATFORM_SES_SENDER_IDENTITY - # 출처: notification/fileserver H4-B — 기본으로 들어 있는 SES 발송 조립기. + # source: notification/fileserver H4-B — 기본으로 들어 있는 SES 발송 조립기. type: string default: null allowed_values: null @@ -4650,7 +4650,7 @@ env_keys: required_test: adapter-contract:notification-ses-provider-assembled - name: APP_NOTIFICATION_PLATFORM_SES_ACCESS_KEY_ID - # 출처: notification/fileserver H4-B — 기본으로 들어 있는 SES 발송 조립기. + # source: notification/fileserver H4-B — 기본으로 들어 있는 SES 발송 조립기. type: string default: null allowed_values: null @@ -4663,7 +4663,7 @@ env_keys: required_test: adapter-contract:notification-ses-provider-assembled - name: APP_NOTIFICATION_PLATFORM_SES_CONFIGURATION_SET - # 출처: notification/fileserver H4-B — 기본으로 들어 있는 SES 발송 조립기. + # source: notification/fileserver H4-B — 기본으로 들어 있는 SES 발송 조립기. type: string default: null allowed_values: null @@ -4676,7 +4676,7 @@ env_keys: required_test: adapter-contract:notification-ses-provider-assembled - name: APP_NOTIFICATION_PLATFORM_SES_ALLOWED_TOPIC_ARNS - # 출처: 2026-09-24 module review Critical #10 — 기본 SES profile이 받는 SES 이벤트 callback의 SNS topic. + # source: 2026-09-24 module review Critical #10 — 기본 SES profile이 받는 SES 이벤트 callback의 SNS topic. # SNS 서명이 맞다는 것은 AWS가 보냈다는 것만 증명하고, topic은 누구나 가질 수 있다. 그래서 callback을 켰는데 # 이 값이 비면 바인딩이 실패한다. type: csv @@ -4691,7 +4691,7 @@ env_keys: required_test: adapter-contract:notification-ses-callback-topic-allowlist - name: APP_NOTIFICATION_PLATFORM_SMTP_ENABLED - # 출처: NTF-INT-001 — 기본 SMTP provider profile 켜고 끄기. false면 조립에서 통째로 뺀다. + # source: NTF-INT-001 — 기본 SMTP provider profile 켜고 끄기. false면 조립에서 통째로 뺀다. type: boolean default: false allowed_values: [true, false] @@ -4704,7 +4704,7 @@ env_keys: required_test: adapter-contract:notification-smtp-provider-assembled - name: APP_NOTIFICATION_PLATFORM_SMTP_PRIMARY - # 출처: NTF-INT-001 — 이 profile이 EMAIL의 주 경로인지. 채널마다 주 경로는 정확히 하나다. + # source: NTF-INT-001 — 이 profile이 EMAIL의 주 경로인지. 채널마다 주 경로는 정확히 하나다. type: boolean default: true allowed_values: [true, false] @@ -4717,7 +4717,7 @@ env_keys: required_test: adapter-contract:notification-smtp-provider-assembled - name: APP_NOTIFICATION_PLATFORM_SMTP_ENVIRONMENT - # 출처: NTF-INT-001 — profile이 밝힌 환경. 모든 발송 기록에 실린다. + # source: NTF-INT-001 — profile이 밝힌 환경. 모든 발송 기록에 실린다. type: string default: local allowed_values: null @@ -4730,7 +4730,7 @@ env_keys: required_test: adapter-contract:notification-smtp-provider-assembled - name: APP_NOTIFICATION_PLATFORM_SMTP_CREDENTIAL_PROFILE - # 출처: NTF-INT-001 — relay 자격 증명을 푸는 credential profile. + # source: NTF-INT-001 — relay 자격 증명을 푸는 credential profile. type: string default: default allowed_values: null @@ -4743,7 +4743,7 @@ env_keys: required_test: adapter-contract:notification-smtp-provider-assembled - name: APP_NOTIFICATION_PLATFORM_SMTP_TIMEOUT - # 출처: NTF-INT-001 — 이 profile의 시도마다 provider timeout. + # source: NTF-INT-001 — 이 profile의 시도마다 provider timeout. type: duration default: 10s allowed_values: null @@ -4756,7 +4756,7 @@ env_keys: required_test: adapter-contract:notification-smtp-provider-assembled - name: APP_NOTIFICATION_PLATFORM_SMTP_MAX_CONCURRENCY - # 출처: NTF-INT-001 — 이 profile이 동시에 처리할 수 있는 시도 수. + # source: NTF-INT-001 — 이 profile이 동시에 처리할 수 있는 시도 수. type: int default: 4 allowed_values: null @@ -4769,7 +4769,7 @@ env_keys: required_test: adapter-contract:notification-smtp-provider-assembled - name: APP_NOTIFICATION_PLATFORM_SMTP_RATE_PER_SECOND - # 출처: NTF-INT-001 — profile의 시도 속도 제한. + # source: NTF-INT-001 — profile의 시도 속도 제한. type: int default: 10 allowed_values: null @@ -4782,7 +4782,7 @@ env_keys: required_test: adapter-contract:notification-smtp-provider-assembled - name: APP_NOTIFICATION_PLATFORM_SMTP_SENDER_IDENTITY - # 출처: NTF-INT-001 — 모든 메시지를 보내는 envelope 발신자. + # source: NTF-INT-001 — 모든 메시지를 보내는 envelope 발신자. type: string default: no-reply@example.invalid allowed_values: null @@ -4795,7 +4795,7 @@ env_keys: required_test: adapter-contract:notification-smtp-provider-assembled - name: APP_NOTIFICATION_PLATFORM_SMTP_DISPATCH_CONCURRENCY - # 출처: NTF-INT-001 — SMTP 발송이 도는, 크기가 정해진 executor의 크기. + # source: NTF-INT-001 — SMTP 발송이 도는, 크기가 정해진 executor의 크기. type: int default: 4 allowed_values: null @@ -4808,7 +4808,7 @@ env_keys: required_test: adapter-contract:notification-smtp-provider-assembled - name: SPRING_MAIL_HOST - # 출처: notification/fileserver techlead review H2 — Spring Mail 자체 transport 설정. 기본 SMTP 조립기가 + # source: notification/fileserver techlead review H2 — Spring Mail 자체 transport 설정. 기본 SMTP 조립기가 # 검증하고 쓰는 JavaMailSender가 읽는다. property: spring.mail.host owner_module: adapter-outbound-notification @@ -4825,7 +4825,7 @@ env_keys: required_test: adapter-contract:notification-smtp-transport - name: SPRING_MAIL_PORT - # 출처: notification/fileserver techlead review H2 — Spring Mail 자체 transport 설정. 기본 SMTP 조립기가 + # source: notification/fileserver techlead review H2 — Spring Mail 자체 transport 설정. 기본 SMTP 조립기가 # 검증하고 쓰는 JavaMailSender가 읽는다. property: spring.mail.port owner_module: adapter-outbound-notification @@ -4842,7 +4842,7 @@ env_keys: required_test: adapter-contract:notification-smtp-transport - name: SPRING_MAIL_USERNAME - # 출처: notification/fileserver techlead review H2 — Spring Mail 자체 transport 설정. 기본 SMTP 조립기가 + # source: notification/fileserver techlead review H2 — Spring Mail 자체 transport 설정. 기본 SMTP 조립기가 # 검증하고 쓰는 JavaMailSender가 읽는다. property: spring.mail.username owner_module: adapter-outbound-notification @@ -4859,7 +4859,7 @@ env_keys: required_test: adapter-contract:notification-smtp-transport - name: SPRING_MAIL_PASSWORD - # 출처: notification/fileserver techlead review H2 — Spring Mail 자체 transport 설정. 기본 SMTP 조립기가 + # source: notification/fileserver techlead review H2 — Spring Mail 자체 transport 설정. 기본 SMTP 조립기가 # 검증하고 쓰는 JavaMailSender가 읽는다. property: spring.mail.password owner_module: adapter-outbound-notification @@ -4876,7 +4876,7 @@ env_keys: required_test: adapter-contract:notification-smtp-transport - name: SPRING_MAIL_PROPERTIES_MAIL_SMTP_STARTTLS_ENABLE - # 출처: notification/fileserver techlead review H2 — Spring Mail 자체 transport 설정. 기본 SMTP 조립기가 + # source: notification/fileserver techlead review H2 — Spring Mail 자체 transport 설정. 기본 SMTP 조립기가 # 검증하고 쓰는 JavaMailSender가 읽는다. property: spring.mail.properties.mail.smtp.starttls.enable owner_module: adapter-outbound-notification @@ -4893,7 +4893,7 @@ env_keys: required_test: adapter-contract:notification-smtp-transport - name: SPRING_MAIL_PROPERTIES_MAIL_SMTP_STARTTLS_REQUIRED - # 출처: notification/fileserver techlead review H2 — Spring Mail 자체 transport 설정. 기본 SMTP 조립기가 + # source: notification/fileserver techlead review H2 — Spring Mail 자체 transport 설정. 기본 SMTP 조립기가 # 검증하고 쓰는 JavaMailSender가 읽는다. property: spring.mail.properties.mail.smtp.starttls.required owner_module: adapter-outbound-notification @@ -4910,7 +4910,7 @@ env_keys: required_test: adapter-contract:notification-smtp-transport - name: SPRING_MAIL_PROPERTIES_MAIL_SMTP_CONNECTIONTIMEOUT - # 출처: notification/fileserver techlead review H2 — Spring Mail 자체 transport 설정. 기본 SMTP 조립기가 + # source: notification/fileserver techlead review H2 — Spring Mail 자체 transport 설정. 기본 SMTP 조립기가 # 검증하고 쓰는 JavaMailSender가 읽는다. property: spring.mail.properties.mail.smtp.connectiontimeout owner_module: adapter-outbound-notification @@ -4927,7 +4927,7 @@ env_keys: required_test: adapter-contract:notification-smtp-transport - name: SPRING_MAIL_PROPERTIES_MAIL_SMTP_TIMEOUT - # 출처: notification/fileserver techlead review H2 — Spring Mail 자체 transport 설정. 기본 SMTP 조립기가 + # source: notification/fileserver techlead review H2 — Spring Mail 자체 transport 설정. 기본 SMTP 조립기가 # 검증하고 쓰는 JavaMailSender가 읽는다. property: spring.mail.properties.mail.smtp.timeout owner_module: adapter-outbound-notification @@ -4944,7 +4944,7 @@ env_keys: required_test: adapter-contract:notification-smtp-transport - name: SPRING_MAIL_PROPERTIES_MAIL_SMTP_WRITETIMEOUT - # 출처: notification/fileserver techlead review H2 — Spring Mail 자체 transport 설정. 기본 SMTP 조립기가 + # source: notification/fileserver techlead review H2 — Spring Mail 자체 transport 설정. 기본 SMTP 조립기가 # 검증하고 쓰는 JavaMailSender가 읽는다. property: spring.mail.properties.mail.smtp.writetimeout owner_module: adapter-outbound-notification @@ -4961,7 +4961,7 @@ env_keys: required_test: adapter-contract:notification-smtp-transport - name: APP_OPENAPI_DOCS_ENABLED - # 출처: five-adapter-runtime-remediation §9 — /v3/api-docs를 내줄지. application-prod.yml이 false로 + # source: five-adapter-runtime-remediation §9 — /v3/api-docs를 내줄지. application-prod.yml이 false로 # 고정한다. 기본값에 맡기지 않고 적는 이유: 배포가 정할 때까지 SpringDoc이 기동마다 경고하고, 기동마다 나는 # 경고는 아무도 읽지 않는다. type: boolean @@ -4976,7 +4976,7 @@ env_keys: required_test: env-contract:openapi-exposure-decided - name: APP_OPENAPI_UI_ENABLED - # 출처: five-adapter-runtime-remediation §9 — Swagger UI를 내줄지. application-prod.yml이 false로 고정한다. + # source: five-adapter-runtime-remediation §9 — Swagger UI를 내줄지. application-prod.yml이 false로 고정한다. # 기본값에 맡기지 않고 적는 이유: 배포가 정할 때까지 SpringDoc이 기동마다 경고하고, 기동마다 나는 경고는 # 아무도 읽지 않는다. type: boolean @@ -4991,7 +4991,7 @@ env_keys: required_test: env-contract:openapi-exposure-decided - name: APP_NOTIFICATION_PLATFORM_MODE - # 출처: NTF-025 — SERVING은 동작하는 provider 없이 기동을 거부한다. INGEST_ONLY는 저장만 하고 보내지 않는다. + # source: NTF-025 — SERVING은 동작하는 provider 없이 기동을 거부한다. INGEST_ONLY는 저장만 하고 보내지 않는다. # 상수는 INGEST_ONLY다. 이 행은 ACCEPT_ONLY라 했는데, NotificationPlatformMode에 그런 이름은 없었다. 그래서 # 레지스트리를 따른 운영자는 문서에 없는 값을 지목하는 바인딩 실패를 받았다. NotificationModeSsotTest가 아래 # 목록을 enum에서 만든다. @@ -5007,7 +5007,7 @@ env_keys: required_test: adapter-contract:notification-platform-mode - name: APP_NOTIFICATION_PLATFORM_CLAIM_BATCH_SIZE - # 출처: NTF-025 — scheduler 한 번이 claim하는 수신자 전달 수. 1..1000이고 밖이면 바인딩에서 거부한다 + # source: NTF-025 — scheduler 한 번이 claim하는 수신자 전달 수. 1..1000이고 밖이면 바인딩에서 거부한다 type: integer default: 50 allowed_values: null @@ -5020,7 +5020,7 @@ env_keys: required_test: adapter-contract:notification-dispatch-bounds - name: APP_NOTIFICATION_PLATFORM_LEASE_DURATION - # 출처: NTF-025 — provider 호출과 그 timeout보다 길어야 한다. 아니면 살아 있는 worker의 전달을 다른 worker가 claim한다 + # source: NTF-025 — provider 호출과 그 timeout보다 길어야 한다. 아니면 살아 있는 worker의 전달을 다른 worker가 claim한다 type: duration default: 2m allowed_values: null @@ -5033,7 +5033,7 @@ env_keys: required_test: adapter-contract:notification-lease-fencing - name: APP_NOTIFICATION_PLATFORM_POLL_INTERVAL - # 출처: NTF-025 — 지난 차례에 claim한 것이 없을 때 scheduler가 일을 다시 묻는 간격 + # source: NTF-025 — 지난 차례에 claim한 것이 없을 때 scheduler가 일을 다시 묻는 간격 type: duration default: 1s allowed_values: null @@ -5046,7 +5046,7 @@ env_keys: required_test: adapter-contract:notification-dispatch-bounds - name: APP_NOTIFICATION_PLATFORM_MAX_CONCURRENCY - # 출처: NTF-025 — 프로세스 전체에서 처리 중인 provider 호출 수 상한 + # source: NTF-025 — 프로세스 전체에서 처리 중인 provider 호출 수 상한 type: integer default: 64 allowed_values: null @@ -5059,7 +5059,7 @@ env_keys: required_test: adapter-contract:notification-dispatch-bounds - name: APP_NOTIFICATION_PLATFORM_MAX_ADDITIONAL_ATTEMPTS - # 출처: NTF-025 — 첫 시도 뒤의 재시도 수. 0이면 한 번 시도하고 재시도하지 않는다 + # source: NTF-025 — 첫 시도 뒤의 재시도 수. 0이면 한 번 시도하고 재시도하지 않는다 type: integer default: 4 allowed_values: null @@ -5072,7 +5072,7 @@ env_keys: required_test: adapter-contract:notification-retry-policy - name: APP_NOTIFICATION_PLATFORM_ESTIMATED_DISPATCH_DURATION - # 출처: NTF-025 — lease·재시도 계획에 쓰는 발송 지연 추정값 + # source: NTF-025 — lease·재시도 계획에 쓰는 발송 지연 추정값 type: duration default: 2s allowed_values: null @@ -5085,7 +5085,7 @@ env_keys: required_test: adapter-contract:notification-dispatch-bounds - name: APP_NOTIFICATION_PLATFORM_MAX_QUEUE_AGE - # 출처: NTF-025 — 이 시간이 지나면 queue의 전달은 늦게 보내지 않고 만료된다 + # source: NTF-025 — 이 시간이 지나면 queue의 전달은 늦게 보내지 않고 만료된다 type: duration default: 24h allowed_values: null @@ -5098,7 +5098,7 @@ env_keys: required_test: adapter-contract:notification-expiry - name: APP_NOTIFICATION_PLATFORM_ALLOW_AMBIGUOUS_FALLBACK - # 출처: NTF-025 — 결과를 읽지 못한 애매한 시도가 provider에 닿았다. 다른 경로로 넘기면 두 번 보낼 위험이 있다 + # source: NTF-025 — 결과를 읽지 못한 애매한 시도가 provider에 닿았다. 다른 경로로 넘기면 두 번 보낼 위험이 있다 type: boolean default: false allowed_values: [true, false] @@ -5113,7 +5113,7 @@ env_keys: - name: APP_NOTIFICATION_PLATFORM_SHUTDOWN_GRACE - # 출처: NTF-025 — 프로세스 종료 때 worker 정리 시간의 상한 + # source: NTF-025 — 프로세스 종료 때 worker 정리 시간의 상한 type: duration default: 20s allowed_values: null @@ -5126,7 +5126,7 @@ env_keys: required_test: adapter-contract:notification-shutdown-grace - name: APP_NOTIFICATION_PLATFORM_MAX_BACKLOG_DEPTH - # 출처: NTF-OBS-001 — 기한이 됐는데 claim되지 않은 전달의 readiness 기준 + # source: NTF-OBS-001 — 기한이 됐는데 claim되지 않은 전달의 readiness 기준 type: integer default: 100000 allowed_values: null @@ -5139,7 +5139,7 @@ env_keys: required_test: adapter-contract:notification-serving-thresholds - name: APP_NOTIFICATION_PLATFORM_MAX_OLDEST_DUE_AGE - # 출처: NTF-OBS-001 — 기한이 된 가장 오래된 전달의 readiness 기준 + # source: NTF-OBS-001 — 기한이 된 가장 오래된 전달의 readiness 기준 type: duration default: 10m allowed_values: null @@ -5152,7 +5152,7 @@ env_keys: required_test: adapter-contract:notification-serving-thresholds - name: APP_NOTIFICATION_PLATFORM_MAX_STUCK_LEASES - # 출처: NTF-OBS-001 — 만료되거나 멈춘 전달 lease의 readiness 기준 + # source: NTF-OBS-001 — 만료되거나 멈춘 전달 lease의 readiness 기준 type: integer default: 50 allowed_values: null @@ -5165,7 +5165,7 @@ env_keys: required_test: adapter-contract:notification-serving-thresholds - name: APP_NOTIFICATION_PLATFORM_MAX_PENDING_PROJECTIONS - # 출처: NTF-OBS-001 — 적용되지 않은 provider 이벤트 projection의 readiness 기준 + # source: NTF-OBS-001 — 적용되지 않은 provider 이벤트 projection의 readiness 기준 type: integer default: 50000 allowed_values: null @@ -5178,7 +5178,7 @@ env_keys: required_test: adapter-contract:notification-serving-thresholds - name: APP_NOTIFICATION_PLATFORM_MAX_FAILED_PROJECTIONS - # 출처: NTF-OBS-001 — 실패한 provider 이벤트 projection의 readiness 기준 + # source: NTF-OBS-001 — 실패한 provider 이벤트 projection의 readiness 기준 type: integer default: 1000 allowed_values: null @@ -5191,7 +5191,7 @@ env_keys: required_test: adapter-contract:notification-serving-thresholds - name: APP_NOTIFICATION_PLATFORM_MAX_OLDEST_PENDING_PROJECTION_AGE - # 출처: NTF-OBS-001 — 가장 오래 기다린 projection의 readiness 기준 + # source: NTF-OBS-001 — 가장 오래 기다린 projection의 readiness 기준 type: duration default: 15m allowed_values: null @@ -5204,7 +5204,7 @@ env_keys: required_test: adapter-contract:notification-serving-thresholds - name: APP_NOTIFICATION_PLATFORM_MAX_OLDEST_RECONCILIATION_AGE - # 출처: NTF-OBS-001 — 가장 오래 풀리지 않은 대조(reconciliation)의 readiness 기준 + # source: NTF-OBS-001 — 가장 오래 풀리지 않은 대조(reconciliation)의 readiness 기준 type: duration default: 30m allowed_values: null @@ -5217,7 +5217,7 @@ env_keys: required_test: adapter-contract:notification-serving-thresholds - name: APP_NOTIFICATION_PLATFORM_CALLBACKS_ENABLED - # 출처: NTF-025 — 플랫폼이 provider callback endpoint를 내놓을지 + # source: NTF-025 — 플랫폼이 provider callback endpoint를 내놓을지 type: boolean default: false allowed_values: [true, false] @@ -5230,7 +5230,7 @@ env_keys: required_test: adapter-contract:notification-callback-ingestion - name: APP_NOTIFICATION_PLATFORM_CALLBACK_MAX_BODY_BYTES - # 출처: NTF-025 — 상한 65251 = 암호문 칸 크기에서 가장 큰 envelope(version, key-id 길이, 255바이트 key id, AES-GCM nonce와 tag)를 뺀 값. 더 크면 바인딩에서 거부한다 + # source: NTF-025 — 상한 65251 = 암호문 칸 크기에서 가장 큰 envelope(version, key-id 길이, 255바이트 key id, AES-GCM nonce와 tag)를 뺀 값. 더 크면 바인딩에서 거부한다 type: integer default: 65251 allowed_values: null @@ -5243,7 +5243,7 @@ env_keys: required_test: adapter-contract:notification-callback-body-bound - name: APP_NOTIFICATION_PLATFORM_CALLBACK_REPLAY_SKEW - # 출처: NTF-025 — callback 시각이 로컬 시각과 이만큼 넘게 다르면 replay로 본다 + # source: NTF-025 — callback 시각이 로컬 시각과 이만큼 넘게 다르면 replay로 본다 # review 05-20 — 1h는 SNS의 HTTP/S 재시도 기간 전체(최대 3,600 s)를 덮는다. 그 안의 replay는 ledger 중복이다 type: duration default: 1h diff --git a/docs/registries/error-codes.yaml b/docs/registries/error-codes.yaml index 929d5a8b..134ffd8f 100644 --- a/docs/registries/error-codes.yaml +++ b/docs/registries/error-codes.yaml @@ -38,7 +38,7 @@ errors: # AUTH (feature-security-operational-baseline / Decision Matrix) # ============================================================ - # 출처: feature-security-operational-baseline L82 — "token 누락 | 401 | AUTH_TOKEN_MISSING | AUTH" + # source: feature-security-operational-baseline L82 — "token 누락 | 401 | AUTH_TOKEN_MISSING | AUTH" - code: AUTH_TOKEN_MISSING category: AUTH http_status: 401 @@ -51,7 +51,7 @@ errors: compatibility_impact: none required_test: contract-verification:auth-category - # 출처: feature-security-operational-baseline L83 — "token malformed (parse fail) | 401 | AUTH_TOKEN_MALFORMED | AUTH" + # source: feature-security-operational-baseline L83 — "token malformed (parse fail) | 401 | AUTH_TOKEN_MALFORMED | AUTH" - code: AUTH_TOKEN_MALFORMED category: AUTH http_status: 401 @@ -64,7 +64,7 @@ errors: compatibility_impact: none required_test: contract-verification:auth-category - # 출처: feature-security-operational-baseline L84 — "token expired (clock skew tolerance 60s 초과) | 401 | AUTH_TOKEN_EXPIRED | AUTH" + # source: feature-security-operational-baseline L84 — "token expired (clock skew tolerance 60s 초과) | 401 | AUTH_TOKEN_EXPIRED | AUTH" - code: AUTH_TOKEN_EXPIRED category: AUTH http_status: 401 @@ -77,7 +77,7 @@ errors: compatibility_impact: none required_test: contract-verification:auth-category - # 출처: feature-security-operational-baseline L85 — "invalid signature | 401 | AUTH_TOKEN_INVALID_SIGNATURE | AUTH" + # source: feature-security-operational-baseline L85 — "invalid signature | 401 | AUTH_TOKEN_INVALID_SIGNATURE | AUTH" - code: AUTH_TOKEN_INVALID_SIGNATURE category: AUTH http_status: 401 @@ -90,7 +90,7 @@ errors: compatibility_impact: none required_test: contract-verification:auth-category - # 출처: feature-security-operational-baseline L86 — "issuer mismatch | 401 | AUTH_ISSUER_MISMATCH | AUTH" + # source: feature-security-operational-baseline L86 — "issuer mismatch | 401 | AUTH_ISSUER_MISMATCH | AUTH" - code: AUTH_ISSUER_MISMATCH category: AUTH http_status: 401 @@ -103,7 +103,7 @@ errors: compatibility_impact: none required_test: contract-verification:auth-category - # 출처: feature-security-operational-baseline L87 — "audience mismatch | 401 | AUTH_AUDIENCE_MISMATCH | AUTH" + # source: feature-security-operational-baseline L87 — "audience mismatch | 401 | AUTH_AUDIENCE_MISMATCH | AUTH" - code: AUTH_AUDIENCE_MISMATCH category: AUTH http_status: 401 @@ -116,7 +116,7 @@ errors: compatibility_impact: none required_test: contract-verification:auth-category - # 출처: feature-security-operational-baseline L88 — "unknown kid (JWKS 미캐시) | 401 + Retry-After 5s | AUTH_KID_UNKNOWN | AUTH" + # source: feature-security-operational-baseline L88 — "unknown kid (JWKS 미캐시) | 401 + Retry-After 5s | AUTH_KID_UNKNOWN | AUTH" - code: AUTH_KID_UNKNOWN category: AUTH http_status: 401 @@ -130,7 +130,7 @@ errors: compatibility_impact: none required_test: contract-verification:auth-category - # 출처: feature-security-operational-baseline L89 — "JWKS endpoint outage ... | AUTH_JWKS_UNAVAILABLE | TRANSIENT_DEPENDENCY" + # source: feature-security-operational-baseline L89 — "JWKS endpoint outage ... | AUTH_JWKS_UNAVAILABLE | TRANSIENT_DEPENDENCY" - code: AUTH_JWKS_UNAVAILABLE category: TRANSIENT_DEPENDENCY http_status: 503 @@ -143,7 +143,7 @@ errors: compatibility_impact: none required_test: contract-verification:auth-category - # 출처: feature-security-operational-baseline L90 — "claim mapping failure ... | 401 | AUTH_CLAIM_MAPPING_FAILED | AUTH" + # source: feature-security-operational-baseline L90 — "claim mapping failure ... | 401 | AUTH_CLAIM_MAPPING_FAILED | AUTH" - code: AUTH_CLAIM_MAPPING_FAILED category: AUTH http_status: 401 @@ -160,7 +160,7 @@ errors: # AUTHZ (feature-security-operational-baseline) # ============================================================ - # 출처: feature-security-operational-baseline L91 — "valid token + 권한 부족 | 403 | AUTHZ_INSUFFICIENT_PERMISSION | AUTHZ" + # source: feature-security-operational-baseline L91 — "valid token + 권한 부족 | 403 | AUTHZ_INSUFFICIENT_PERMISSION | AUTHZ" - code: AUTHZ_INSUFFICIENT_PERMISSION category: AUTHZ http_status: 403 @@ -173,7 +173,7 @@ errors: compatibility_impact: none required_test: contract-verification:authz-category - # 출처: feature-security-operational-baseline L92 — "valid token + tenant cross-access | 403 | AUTHZ_TENANT_MISMATCH | AUTHZ" + # source: feature-security-operational-baseline L92 — "valid token + tenant cross-access | 403 | AUTHZ_TENANT_MISMATCH | AUTHZ" - code: AUTHZ_TENANT_MISMATCH category: AUTHZ http_status: 403 @@ -190,7 +190,7 @@ errors: # INTERNAL (feature-security-operational-baseline + container-runtime) # ============================================================ - # 출처: feature-security-operational-baseline L93 — "public path misconfiguration ... | 500 + P1 alert | INTERNAL_AUTH_MISCONFIGURATION | INTERNAL" + # source: feature-security-operational-baseline L93 — "public path misconfiguration ... | 500 + P1 alert | INTERNAL_AUTH_MISCONFIGURATION | INTERNAL" - code: INTERNAL_AUTH_MISCONFIGURATION category: INTERNAL http_status: 500 @@ -203,7 +203,7 @@ errors: compatibility_impact: none required_test: contract-verification:auth-category - # 출처: feature-container-runtime-contract L113 — "JVM OutOfMemoryError → ExitOnOutOfMemoryError로 137 exit, log에 error.code=JVM_OOM 명시" + # source: feature-container-runtime-contract L113 — "JVM OutOfMemoryError → ExitOnOutOfMemoryError로 137 exit, log에 error.code=JVM_OOM 명시" - code: JVM_OOM category: INTERNAL http_status: 500 @@ -220,7 +220,7 @@ errors: # DB / 영속성 (feature-persistence-failure-baseline / SQLState Matrix) # ============================================================ - # 출처: feature-persistence-failure-baseline L85 — "08* | all | TRANSIENT_DEPENDENCY | DB_UNAVAILABLE | true" + # source: feature-persistence-failure-baseline L85 — "08* | all | TRANSIENT_DEPENDENCY | DB_UNAVAILABLE | true" - code: DB_UNAVAILABLE category: TRANSIENT_DEPENDENCY http_status: 503 @@ -233,7 +233,7 @@ errors: compatibility_impact: none required_test: contract-verification:persistence-mapping - # 출처: feature-persistence-failure-baseline L86 — "40001 | Postgres/MySQL | CONFLICT | DB_SERIALIZATION_FAILURE | true" + # source: feature-persistence-failure-baseline L86 — "40001 | Postgres/MySQL | CONFLICT | DB_SERIALIZATION_FAILURE | true" - code: DB_SERIALIZATION_FAILURE category: CONFLICT http_status: 409 @@ -246,7 +246,7 @@ errors: compatibility_impact: none required_test: contract-verification:persistence-mapping - # 출처: feature-persistence-failure-baseline L87 — "40P01 | Postgres | CONFLICT | DB_DEADLOCK | true (backoff)" + # source: feature-persistence-failure-baseline L87 — "40P01 | Postgres | CONFLICT | DB_DEADLOCK | true (backoff)" - code: DB_DEADLOCK category: CONFLICT http_status: 409 @@ -259,7 +259,7 @@ errors: compatibility_impact: none required_test: contract-verification:persistence-mapping - # 출처: feature-persistence-failure-baseline L88 — "23502 | Postgres | DATA_INTEGRITY | DB_NULL_VIOLATION | false" + # source: feature-persistence-failure-baseline L88 — "23502 | Postgres | DATA_INTEGRITY | DB_NULL_VIOLATION | false" - code: DB_NULL_VIOLATION category: DATA_INTEGRITY http_status: 409 @@ -272,7 +272,7 @@ errors: compatibility_impact: none required_test: contract-verification:persistence-mapping - # 출처: feature-persistence-failure-baseline L89 — "23503 | Postgres | DATA_INTEGRITY | DB_FK_VIOLATION | false" + # source: feature-persistence-failure-baseline L89 — "23503 | Postgres | DATA_INTEGRITY | DB_FK_VIOLATION | false" - code: DB_FK_VIOLATION category: DATA_INTEGRITY http_status: 409 @@ -285,7 +285,7 @@ errors: compatibility_impact: none required_test: contract-verification:persistence-mapping - # 출처: feature-persistence-failure-baseline L90 — "23505 | Postgres | CONFLICT | DB_UNIQUE_VIOLATION | false (business mapping)" + # source: feature-persistence-failure-baseline L90 — "23505 | Postgres | CONFLICT | DB_UNIQUE_VIOLATION | false (business mapping)" - code: DB_UNIQUE_VIOLATION category: CONFLICT http_status: 409 @@ -298,7 +298,7 @@ errors: compatibility_impact: none required_test: contract-verification:persistence-mapping - # 출처: feature-persistence-failure-baseline L91 — "23514 | Postgres | DATA_INTEGRITY | DB_CHECK_VIOLATION | false" + # source: feature-persistence-failure-baseline L91 — "23514 | Postgres | DATA_INTEGRITY | DB_CHECK_VIOLATION | false" - code: DB_CHECK_VIOLATION category: DATA_INTEGRITY http_status: 409 @@ -311,7 +311,7 @@ errors: compatibility_impact: none required_test: contract-verification:persistence-mapping - # 출처: feature-persistence-failure-baseline L92 — "25P03 | Postgres | TRANSIENT_DEPENDENCY | DB_IDLE_IN_TX_TIMEOUT | true" + # source: feature-persistence-failure-baseline L92 — "25P03 | Postgres | TRANSIENT_DEPENDENCY | DB_IDLE_IN_TX_TIMEOUT | true" - code: DB_IDLE_IN_TX_TIMEOUT category: TRANSIENT_DEPENDENCY http_status: 503 @@ -324,7 +324,7 @@ errors: compatibility_impact: none required_test: contract-verification:persistence-mapping - # 출처: feature-persistence-failure-baseline L93 — "57014 | Postgres | TRANSIENT_DEPENDENCY | DB_QUERY_CANCELED | false" + # source: feature-persistence-failure-baseline L93 — "57014 | Postgres | TRANSIENT_DEPENDENCY | DB_QUERY_CANCELED | false" - code: DB_QUERY_CANCELED category: TRANSIENT_DEPENDENCY http_status: 503 @@ -337,7 +337,7 @@ errors: compatibility_impact: none required_test: contract-verification:persistence-mapping - # 출처: review-followup P15 (S2-lead-4) — JPA OPTIMISTIC_CONFLICT (flush·commit 때 @Version 검사 실패) + # source: review-followup P15 (S2-lead-4) — JPA OPTIMISTIC_CONFLICT (flush·commit 때 @Version 검사 실패) - code: DB_OPTIMISTIC_CONFLICT category: CONFLICT http_status: 409 @@ -350,7 +350,7 @@ errors: compatibility_impact: additive required_test: persistence-jpa:JpaPersistenceExceptionCodeTest - # 출처: review-followup P15 (S2-lead-4) — JPA COMPLETION_UNKNOWN (40003 / commit 단계 연결 끊김) + # source: review-followup P15 (S2-lead-4) — JPA COMPLETION_UNKNOWN (40003 / commit 단계 연결 끊김) - code: DB_COMPLETION_UNKNOWN category: DATA_INTEGRITY http_status: 500 @@ -367,7 +367,7 @@ errors: # Rate limit / Idempotency (feature-rate-limit-idempotency-contract) # ============================================================ - # 출처: feature-rate-limit-idempotency-contract — rate limit 응답·로그 기준 / Retry-After 헤더 기준 (scope L29, L33) + # source: feature-rate-limit-idempotency-contract — rate limit 응답·로그 기준 / Retry-After 헤더 기준 (scope L29, L33) - code: RATE_LIMIT_EXCEEDED category: RATE_LIMIT http_status: 429 @@ -380,7 +380,7 @@ errors: compatibility_impact: none required_test: contract-verification:rate-limit - # 출처: docs/web/http-contract.md §2 (2026-11-01 소유자 결정, 리뷰 02-01 대안 A) — 결과 불명. 같은 Idempotency-Key로 Retry-After 뒤 재전송. 새 키 금지. + # source: docs/web/http-contract.md §2 (2026-11-01 소유자 결정, 리뷰 02-01 대안 A) — 결과 불명. 같은 Idempotency-Key로 Retry-After 뒤 재전송. 새 키 금지. # 2초 = 기본 processing lease(30s)보다 짧은 고정값. 이전 "client는 polling"(retryable=false)은 조회 엔드포인트가 없어 폐기. # 값 하나: IdempotencyExecutor.IN_FLIGHT_RETRY_AFTER. processing-lease가 이 값 이하면 기동 실패(재리뷰 RR-02-05). # behavior-change: retryable false→true는 web Envelope뿐 아니라 gRPC trailer error-retryable(status ABORTED)과 @@ -397,7 +397,7 @@ errors: compatibility_impact: behavior-change required_test: contract-verification:idempotency - # 출처: feature-rate-limit-idempotency-contract L72 — "fingerprint mismatch (same key + different body) = 422 IDEMPOTENT_REQUEST_MISMATCH" + # source: feature-rate-limit-idempotency-contract L72 — "fingerprint mismatch (same key + different body) = 422 IDEMPOTENT_REQUEST_MISMATCH" - code: IDEMPOTENT_REQUEST_MISMATCH category: VALIDATION http_status: 422 @@ -410,7 +410,7 @@ errors: compatibility_impact: none required_test: contract-verification:idempotency - # 출처: review-followup P15 (X2-P2-2a) — IdempotencyExecutor가 동작 전에 닫힌 채 거절한다(fail-closed) + # source: review-followup P15 (X2-P2-2a) — IdempotencyExecutor가 동작 전에 닫힌 채 거절한다(fail-closed) - code: IDEMPOTENCY_UNAVAILABLE category: TRANSIENT_DEPENDENCY http_status: 503 @@ -423,7 +423,7 @@ errors: compatibility_impact: additive required_test: contract-verification:idempotency - # 출처: 재리뷰 2026-11-03 README 4절 결정, RR-02-03 — action이 돈 뒤 complete 단계에서 저장소가 응답하지 않음. + # source: 재리뷰 2026-11-03 README 4절 결정, RR-02-03 — action이 돈 뒤 complete 단계에서 저장소가 응답하지 않음. # 실행 전 거부(IDEMPOTENCY_UNAVAILABLE)와 code로 구분한다. 결과 불명: 같은 키로 재전송하면 서버가 replay·in-flight· # recovery-required로 판정한다. 새 키 금지. docs/web/http-contract.md §2. - code: IDEMPOTENCY_COMPLETION_UNKNOWN @@ -438,7 +438,7 @@ errors: compatibility_impact: additive required_test: contract-verification:idempotency - # 출처: review-followup P15 (X2-P2-2a) — replay가 외부 효과가 일어났는지 정할 수 없다 + # source: review-followup P15 (X2-P2-2a) — replay가 외부 효과가 일어났는지 정할 수 없다 - code: IDEMPOTENCY_RECOVERY_REQUIRED category: DATA_INTEGRITY http_status: 500 @@ -455,7 +455,7 @@ errors: # 파일 / 자원 (feature-file-resource-handling-contract) # ============================================================ - # 출처: feature-file-resource-handling-contract L69 — "spring.servlet.multipart.max-file-size 10MB ... Spring 단의 enforcement가 실패 시 envelope 응답 보장" / 테스트 계약 "oversized upload가 generic 500으로 처리되면 실패" + # source: feature-file-resource-handling-contract L69 — "spring.servlet.multipart.max-file-size 10MB ... Spring 단의 enforcement가 실패 시 envelope 응답 보장" / 테스트 계약 "oversized upload가 generic 500으로 처리되면 실패" # ============================================================ # API 계약의 전송 표준 코드 (feature-api-contract-baseline) # ============================================================ @@ -464,7 +464,7 @@ errors: # 그대로 옮긴 것이다. D11 상태 대응 일관성 테스트(소유: 이 branch, 생산자)가 코드의 레지스트리 http_status와 # enum httpStatus()가 어긋나면 빌드를 실패시킨다. - # 출처: feature-api-contract-baseline.md D12 — "405 Method Not Allowed + Allow header 의무" + # source: feature-api-contract-baseline.md D12 — "405 Method Not Allowed + Allow header 의무" - code: METHOD_NOT_ALLOWED category: VALIDATION http_status: 405 @@ -477,7 +477,7 @@ errors: compatibility_impact: none required_test: contract-verification:api-contract-status-mapping - # 출처: feature-api-contract-baseline.md D9 — "406 Not Acceptable = 응답 표현 협상 실패" + # source: feature-api-contract-baseline.md D9 — "406 Not Acceptable = 응답 표현 협상 실패" - code: NOT_ACCEPTABLE category: VALIDATION http_status: 406 @@ -490,7 +490,7 @@ errors: compatibility_impact: none required_test: contract-verification:api-contract-status-mapping - # 출처: feature-api-contract-baseline.md D15 — "If-Match mismatch 시 412 Precondition Failed" + # source: feature-api-contract-baseline.md D15 — "If-Match mismatch 시 412 Precondition Failed" - code: PRECONDITION_FAILED category: CONFLICT http_status: 412 @@ -503,7 +503,7 @@ errors: compatibility_impact: none required_test: contract-verification:api-contract-status-mapping - # 출처: feature-api-contract-baseline.md D8 — "request size limit 실패 분류 (413)" + # source: feature-api-contract-baseline.md D8 — "request size limit 실패 분류 (413)" - code: PAYLOAD_TOO_LARGE category: VALIDATION http_status: 413 @@ -516,7 +516,7 @@ errors: compatibility_impact: none required_test: contract-verification:api-contract-status-mapping - # 출처: feature-api-contract-baseline.md D8 형제 — "URI 길이 실패 분류 (414)" + # source: feature-api-contract-baseline.md D8 형제 — "URI 길이 실패 분류 (414)" # 참고: 강제는 Tomcat·gateway가 한다(Spring dispatch 전에 거절). 이 행과 코드는 상태 대응 일관성을 위해 # 있다. 끝에서 끝까지의 414 계약 테스트는 `planned`다 (gateway/Tomcat maxHttpHeaderSize 8KB 경계). - code: URI_TOO_LONG @@ -531,7 +531,7 @@ errors: compatibility_impact: none required_test: contract-verification:api-contract-status-mapping - # 출처: feature-api-contract-baseline.md D9 — "415 Unsupported Media Type = 요청 본문 format 미지원" + # source: feature-api-contract-baseline.md D9 — "415 Unsupported Media Type = 요청 본문 format 미지원" - code: UNSUPPORTED_MEDIA_TYPE category: VALIDATION http_status: 415 @@ -548,7 +548,7 @@ errors: # Tenant (feature-tenant-context-policy) # ============================================================ - # 출처: feature-tenant-context-policy L71 — "tenant 미지원 모드에서 X-Tenant-Id 헤더 수신 시 400 TENANT_NOT_SUPPORTED (filter 단계)" + # source: feature-tenant-context-policy L71 — "tenant 미지원 모드에서 X-Tenant-Id 헤더 수신 시 400 TENANT_NOT_SUPPORTED (filter 단계)" # ============================================================ # Validation / Business rule (feature-business-rule-validation-contract) # ============================================================ @@ -558,17 +558,17 @@ errors: # (feature-operational-error-observability-foundation L110). 실제 도메인별 code는 # Phase D(도메인 feature 적용) 시 본 registry에 추가. - # 출처: feature-operational-error-observability-foundation L110 — "code: VALIDATION_EMAIL_FORMAT, // registry-registered code" (validation 필드 오류 JSON 모양 예) + # source: feature-operational-error-observability-foundation L110 — "code: VALIDATION_EMAIL_FORMAT, // registry-registered code" (validation 필드 오류 JSON 모양 예) # ============================================================ # 캐시 (feature-cache-consistency-contract) # ============================================================ - # 출처: feature-cache-consistency-contract — Decisionized Work Items "Redis unavailable | degrade only if declared | fail-fast for required cache | generic INTERNAL | unavailable mapping" / 테스트 "Redis unavailable이 degrade 가능 여부 없이 INTERNAL로 처리되면 실패" + # source: feature-cache-consistency-contract — Decisionized Work Items "Redis unavailable | degrade only if declared | fail-fast for required cache | generic INTERNAL | unavailable mapping" / 테스트 "Redis unavailable이 degrade 가능 여부 없이 INTERNAL로 처리되면 실패" # ============================================================ # 외부 HTTP 호출 (feature-outbound-http-client-baseline) # ============================================================ - # 출처: feature-outbound-http-client-baseline L70 — "outbound HTTP timeout default = connect 2s / read 5s / global call 10s" + scope "timeout/connect/DNS failure 분류" / 테스트 "upstream timeout은 retryable dependency failure로 분류되어야 함" + # source: feature-outbound-http-client-baseline L70 — "outbound HTTP timeout default = connect 2s / read 5s / global call 10s" + scope "timeout/connect/DNS failure 분류" / 테스트 "upstream timeout은 retryable dependency failure로 분류되어야 함" - code: DEPENDENCY_TIMEOUT category: TRANSIENT_DEPENDENCY http_status: 504 @@ -581,7 +581,7 @@ errors: compatibility_impact: none required_test: contract-verification:outbound-http - # 출처: feature-outbound-http-client-baseline — scope "timeout/connect/DNS failure 분류" + L70 connect=2s timeout + # source: feature-outbound-http-client-baseline — scope "timeout/connect/DNS failure 분류" + L70 connect=2s timeout - code: DEPENDENCY_CONNECT_FAILED category: TRANSIENT_DEPENDENCY http_status: 503 @@ -594,7 +594,7 @@ errors: compatibility_impact: none required_test: contract-verification:outbound-http - # 출처: feature-outbound-http-client-baseline — scope "timeout/connect/DNS failure 분류" + # source: feature-outbound-http-client-baseline — scope "timeout/connect/DNS failure 분류" - code: DEPENDENCY_DNS_FAILED category: TRANSIENT_DEPENDENCY http_status: 503 @@ -607,7 +607,7 @@ errors: compatibility_impact: none required_test: contract-verification:outbound-http - # 출처: feature-outbound-http-client-baseline — scope "upstream 4xx/5xx 분류" / 테스트 "401/403은 credential/scope/config 문제로 분류되어야 함" + # source: feature-outbound-http-client-baseline — scope "upstream 4xx/5xx 분류" / 테스트 "401/403은 credential/scope/config 문제로 분류되어야 함" - code: DEPENDENCY_4XX_CLIENT category: PERMANENT_DEPENDENCY http_status: 502 @@ -620,7 +620,7 @@ errors: compatibility_impact: none required_test: contract-verification:outbound-http - # 출처: feature-outbound-http-client-baseline — scope "upstream 4xx/5xx 분류" + # source: feature-outbound-http-client-baseline — scope "upstream 4xx/5xx 분류" - code: DEPENDENCY_5XX_SERVER category: TRANSIENT_DEPENDENCY http_status: 502 @@ -633,7 +633,7 @@ errors: compatibility_impact: none required_test: contract-verification:outbound-http - # 출처: feature-outbound-http-client-baseline L69 — "circuit breaker metric은 dependency.name, dependency.type, outcome까지만 tag로 허용" + Decisionized "circuit breaker | Resilience4j optional env" + # source: feature-outbound-http-client-baseline L69 — "circuit breaker metric은 dependency.name, dependency.type, outcome까지만 tag로 허용" + Decisionized "circuit breaker | Resilience4j optional env" - code: DEPENDENCY_CIRCUIT_OPEN category: TRANSIENT_DEPENDENCY http_status: 503 @@ -650,7 +650,7 @@ errors: # Outbox (feature-domain-event-outbox-contract) # ============================================================ - # 출처: feature-domain-event-outbox-contract L67 — "outbox row status enum = PENDING / IN_FLIGHT / PUBLISHED / FAILED / DEAD" + scope "publish 실패 분류" / 판정 "publish 실패가 retry/DLQ/log/runbook 기준 없이 삼켜지면 실패" + # source: feature-domain-event-outbox-contract L67 — "outbox row status enum = PENDING / IN_FLIGHT / PUBLISHED / FAILED / DEAD" + scope "publish 실패 분류" / 판정 "publish 실패가 retry/DLQ/log/runbook 기준 없이 삼켜지면 실패" - code: OUTBOX_PUBLISH_FAILED category: TRANSIENT_DEPENDENCY http_status: 500 @@ -663,7 +663,7 @@ errors: compatibility_impact: none required_test: contract-verification:outbox-publish - # 출처: feature-domain-event-outbox-contract L67 — outbox status enum "DEAD" / Outbox Defaults "DLQ | background-job branch owner" + # source: feature-domain-event-outbox-contract L67 — outbox status enum "DEAD" / Outbox Defaults "DLQ | background-job branch owner" - code: OUTBOX_DEAD_LETTER category: INTERNAL http_status: 500 @@ -680,7 +680,7 @@ errors: # 백그라운드 작업 / 비동기 (feature-background-job-async-contract) # ============================================================ - # 출처: feature-background-job-async-contract — Decisionized "saturation | bounded executor + rejection log" / L72 "saturation policy default = AbortPolicy" / 테스트 "executor rejection이 structured log 없이 발생하면 실패" + # source: feature-background-job-async-contract — Decisionized "saturation | bounded executor + rejection log" / L72 "saturation policy default = AbortPolicy" / 테스트 "executor rejection이 structured log 없이 발생하면 실패" - code: JOB_EXECUTOR_REJECTED category: TRANSIENT_DEPENDENCY http_status: 503 @@ -693,7 +693,7 @@ errors: compatibility_impact: none required_test: contract-verification:async-saturation - # 출처: feature-background-job-async-contract L69 — "기본 backoff는 exponential backoff with jitter, max attempts 3, DLQ after exhausted attempts" + scope "shutdown 중 job 처리 기준" / L73 graceful shutdown ≤19s + # source: feature-background-job-async-contract L69 — "기본 backoff는 exponential backoff with jitter, max attempts 3, DLQ after exhausted attempts" + scope "shutdown 중 job 처리 기준" / L73 graceful shutdown ≤19s - code: JOB_TIMEOUT category: TRANSIENT_DEPENDENCY http_status: 500 @@ -706,7 +706,7 @@ errors: compatibility_impact: none required_test: contract-verification:async-timeout - # 출처: feature-background-job-async-contract L69 — "DLQ after exhausted attempts" + Decisionized "retry/DLQ | exp backoff jitter, max 3, DLQ exhausted | ... | infinite retry" + # source: feature-background-job-async-contract L69 — "DLQ after exhausted attempts" + Decisionized "retry/DLQ | exp backoff jitter, max 3, DLQ exhausted | ... | infinite retry" - code: JOB_DEAD_LETTER category: INTERNAL http_status: 500 @@ -723,7 +723,7 @@ errors: # 분산 lock (feature-distributed-lock-contract) # ============================================================ - # 출처: feature-distributed-lock-contract D7 — "lock 획득 실패/timeout 의 error code = + # source: feature-distributed-lock-contract D7 — "lock 획득 실패/timeout 의 error code = # LOCK_ACQUISITION_TIMEOUT (category CONFLICT, retryable true, client_safe true) + metric # lock.acquisition" / D5 — "try-lock + 유한 waitTime + lease(TTL) 필수, 무한 blocking 금지". # category CONFLICT 는 기존 enum 재사용; retryable=true — 락 보유자가 임계 구역을 빠져나오면 @@ -747,7 +747,7 @@ errors: # Migration / 기동 (feature-migration-startup-contract) # ============================================================ - # 출처: feature-migration-startup-contract L71 — "startup exit code 표준 = ... migration 실패=70 ..." + Decisionized "startup failure log | structured log with startup.phase, error.code, error.category" + # source: feature-migration-startup-contract L71 — "startup exit code 표준 = ... migration 실패=70 ..." + Decisionized "startup failure log | structured log with startup.phase, error.code, error.category" - code: ADAPTER_DISABLED category: INTERNAL http_status: 500 @@ -760,12 +760,12 @@ errors: compatibility_impact: none required_test: adapter-contract:adapter-disabled-runtime-call - # 출처: feature-migration-startup-contract L71 — "startup exit code 표준 = ... profile mismatch=71" / 테스트 "prod profile에서 local-only 설정이 켜지면 실패" + # source: feature-migration-startup-contract L71 — "startup exit code 표준 = ... profile mismatch=71" / 테스트 "prod profile에서 local-only 설정이 켜지면 실패" # ============================================================ # 관리 포트 / Actuator (feature-management-actuator-security-contract) # ============================================================ - # 출처: feature-management-actuator-security-contract — 노출 정책 "env/configprops | forbidden" "heapdump/threaddump | forbidden unless break-glass runbook" "shutdown | forbidden" / 테스트 "prod에서 env/configprops endpoint가 노출되면 실패" + # source: feature-management-actuator-security-contract — Exposure Policy "env/configprops | forbidden" "heapdump/threaddump | forbidden unless break-glass runbook" "shutdown | forbidden" / 테스트 "prod에서 env/configprops endpoint가 노출되면 실패" - code: ACTUATOR_FORBIDDEN category: AUTHZ http_status: 403 diff --git a/docs/registries/headers.yaml b/docs/registries/headers.yaml index 21168e03..5530af1c 100644 --- a/docs/registries/headers.yaml +++ b/docs/registries/headers.yaml @@ -9,7 +9,7 @@ # - envelope_meta_field: camelCase (envelope이 정본) headers: - # 출처: feature-operational-error-observability-foundation.md L97 + # 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 @@ -23,7 +23,7 @@ headers: compatibility_impact: none required_test: contract-verification:envelope-headers - # 출처: feature-api-contract-baseline.md L77 / feature-rate-limit-idempotency-contract.md L66-67 + # 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 @@ -37,7 +37,7 @@ headers: compatibility_impact: additive required_test: contract-verification:idempotency-replay - # 출처: feature-rate-limit-idempotency-contract.md L85 / foundation L85 + # source: feature-rate-limit-idempotency-contract.md L85 / foundation L85 # "RATE_LIMIT | ... | 429 | true (Retry-After 이후)" / "retry-after 기준 없이 429를 반환하면 실패" - name: Retry-After direction: outbound @@ -51,7 +51,7 @@ headers: compatibility_impact: additive required_test: contract-verification:rate-limit-headers - # 출처: feature-rate-limit-idempotency-contract.md scope L26 (rate limit response/log 기준) + # 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 @@ -65,7 +65,7 @@ headers: compatibility_impact: additive required_test: contract-verification:rate-limit-headers - # 출처: feature-rate-limit-idempotency-contract.md scope L26 (rate limit response/log 기준) + # source: feature-rate-limit-idempotency-contract.md scope L26 (rate limit response/log 기준) - name: X-RateLimit-Remaining direction: outbound type: numeric @@ -78,7 +78,7 @@ headers: compatibility_impact: additive required_test: contract-verification:rate-limit-headers - # 출처: feature-rate-limit-idempotency-contract.md scope L26 (rate limit response/log 기준) + # source: feature-rate-limit-idempotency-contract.md scope L26 (rate limit response/log 기준) - name: X-RateLimit-Reset direction: outbound type: rfc3339-date @@ -91,7 +91,7 @@ headers: compatibility_impact: additive required_test: contract-verification:rate-limit-headers - # 출처: feature-api-compatibility-deprecation-contract.md L87 + # source: feature-api-compatibility-deprecation-contract.md L87 # "deprecation marker | OpenAPI deprecated: true + design record | response header optional" - name: Deprecation direction: outbound @@ -105,7 +105,7 @@ headers: compatibility_impact: additive required_test: contract-verification:deprecation-marker - # 출처: feature-api-compatibility-deprecation-contract.md L87 + # 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 @@ -119,7 +119,7 @@ headers: compatibility_impact: additive required_test: contract-verification:deprecation-marker - # 출처: feature-distributed-tracing-contract.md L64, L85 + # source: feature-distributed-tracing-contract.md L64, L85 # "propagation header는 W3C traceparent default" / "HTTP | traceparent, tracestate (W3C)" - name: traceparent direction: both @@ -133,7 +133,7 @@ headers: compatibility_impact: none required_test: contract-verification:trace-propagation - # 출처: feature-distributed-tracing-contract.md L66, L85 + # source: feature-distributed-tracing-contract.md L66, L85 # "propagation format = W3C traceparent + tracestate only. B3 propagation은 forbidden" - name: tracestate direction: both @@ -147,7 +147,7 @@ headers: compatibility_impact: none required_test: contract-verification:trace-propagation - # 출처: feature-operational-error-observability-foundation.md L100 + # 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 @@ -161,7 +161,7 @@ headers: compatibility_impact: none required_test: contract-verification:envelope-headers - # 출처: feature-security-operational-baseline.md L66 + # source: feature-security-operational-baseline.md L66 # "JWT Resource Server를 baseline security model로 둠" (Authorization 헤더의 Bearer 토큰) - name: Authorization direction: inbound @@ -175,7 +175,7 @@ headers: compatibility_impact: none required_test: contract-verification:jwt-resource-server - # 출처: feature-security-operational-baseline.md L83-90 (AuthN/AuthZ 판정 표) + # 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 diff --git a/docs/registries/mdc-keys.yaml b/docs/registries/mdc-keys.yaml index e3944d49..fcf391c2 100644 --- a/docs/registries/mdc-keys.yaml +++ b/docs/registries/mdc-keys.yaml @@ -9,7 +9,7 @@ # - foundation L93-102 표 "MDC Key Standard (final)"의 key들이 핵심 정본이다 mdc_keys: - # 출처: feature-operational-error-observability-foundation.md L97 + # source: feature-operational-error-observability-foundation.md L97 # "request_id | inbound filter (생성 또는 X-Request-Id 헤더) | response header X-Request-Id" - key: request_id type: ulid @@ -24,7 +24,7 @@ mdc_keys: compatibility_impact: none required_test: contract-verification:log-mdc-keys - # 출처: feature-operational-error-observability-foundation.md L98 + # source: feature-operational-error-observability-foundation.md L98 # "trace_id | Micrometer Tracing | W3C traceparent header" - key: trace_id type: string @@ -39,7 +39,7 @@ mdc_keys: compatibility_impact: none required_test: contract-verification:log-mdc-keys - # 출처: feature-operational-error-observability-foundation.md L99 + # source: feature-operational-error-observability-foundation.md L99 # "span_id | Micrometer Tracing | W3C traceparent" # NOTE: background-job-async-contract L71 "span_id는 Micrometer Observation context에서 자동 전파(MDC explicit copy 불필요)" - key: span_id @@ -55,7 +55,7 @@ mdc_keys: compatibility_impact: none required_test: contract-verification:log-mdc-keys - # 출처: feature-operational-error-observability-foundation.md L100 + # source: feature-operational-error-observability-foundation.md L100 # "correlation_id | inbound header X-Correlation-Id 또는 생성 | HTTP X-Correlation-Id, message header correlation_id" - key: correlation_id type: ulid @@ -70,7 +70,7 @@ mdc_keys: compatibility_impact: none required_test: contract-verification:log-mdc-keys - # 출처: feature-operational-error-observability-foundation.md L101 + feature-tenant-context-policy.md L70 + # source: feature-operational-error-observability-foundation.md L101 + feature-tenant-context-policy.md L70 # "tenant_id | tenant context (활성 시) | downstream HTTP X-Tenant-Id (with allowlist)" / # "tenant ID format = opaque ULID (26 chars Crockford base32)" # NOTE: tenant L73 "tenant_id ULID 원본은 metric tag에 직접 사용 금지" @@ -87,7 +87,7 @@ mdc_keys: compatibility_impact: additive required_test: contract-verification:tenant-leakage - # 출처: feature-operational-error-observability-foundation.md L102 + # source: feature-operational-error-observability-foundation.md L102 # "user_principal | security context (pseudonymized only) | log only, headers forbidden" - key: user_principal type: string @@ -104,7 +104,7 @@ mdc_keys: # ── 로그 종류별 확장 (log-management-contract L101-109 "Log Type별 필수 필드") ── - # 출처: feature-log-management-contract.md L105 "request | request_id, trace_id, method, uri_template, status, duration_ms" + # source: feature-log-management-contract.md L105 "request | request_id, trace_id, method, uri_template, status, duration_ms" # 참고: application-port-usecase-contract / 업무 쪽 operation 식별자 (uri_template과 따로 application이 정한다) - key: operation type: string @@ -119,7 +119,7 @@ mdc_keys: compatibility_impact: none required_test: contract-verification:log-fields - # 출처: feature-log-management-contract.md L105 "request | request_id, trace_id, method, uri_template, status, duration_ms" + # source: feature-log-management-contract.md L105 "request | request_id, trace_id, method, uri_template, status, duration_ms" - key: method type: string source: inbound_filter @@ -133,7 +133,7 @@ mdc_keys: compatibility_impact: none required_test: contract-verification:log-fields - # 출처: feature-log-management-contract.md L105 "request | request_id, trace_id, method, uri_template, status, duration_ms" + # source: feature-log-management-contract.md L105 "request | request_id, trace_id, method, uri_template, status, duration_ms" # 참고: metrics L86 "status_code | 7 (1xx-5xx + ok/other)" — 값 개수가 정해져 있다 - key: status type: numeric @@ -148,7 +148,7 @@ mdc_keys: compatibility_impact: none required_test: contract-verification:log-fields - # 출처: feature-log-management-contract.md L105-106 "request | ... duration_ms" / "dependency | ... duration_ms" + # source: feature-log-management-contract.md L105-106 "request | ... duration_ms" / "dependency | ... duration_ms" - key: duration_ms type: numeric source: application_set @@ -162,7 +162,7 @@ mdc_keys: compatibility_impact: none required_test: contract-verification:log-fields - # 출처: feature-log-management-contract.md L106 "dependency | dependency_name, dependency_type, duration_ms, outcome, error_code" + # source: feature-log-management-contract.md L106 "dependency | dependency_name, dependency_type, duration_ms, outcome, error_code" # 참고: metrics L88 "dependency_name | 50" — 값 개수가 정해져 있다 - key: dependency_name type: string @@ -177,7 +177,7 @@ mdc_keys: compatibility_impact: none required_test: contract-verification:log-fields - # 출처: feature-log-management-contract.md L106 "dependency | dependency_name, dependency_type, ..." + # source: feature-log-management-contract.md L106 "dependency | dependency_name, dependency_type, ..." - key: dependency_type type: string source: application_set @@ -191,7 +191,7 @@ mdc_keys: compatibility_impact: none required_test: contract-verification:log-fields - # 출처: feature-log-management-contract.md L106 + metrics L91 "outcome (resilience4j) | 5 (SUCCESS/FAILURE/CIRCUIT_OPEN/TIMEOUT/REJECTED)" + # source: feature-log-management-contract.md L106 + metrics L91 "outcome (resilience4j) | 5 (SUCCESS/FAILURE/CIRCUIT_OPEN/TIMEOUT/REJECTED)" - key: outcome type: string source: application_set @@ -205,7 +205,7 @@ mdc_keys: compatibility_impact: none required_test: contract-verification:log-fields - # 출처: feature-log-management-contract.md L106 "dependency | ... error_code (실패 시)" + # source: feature-log-management-contract.md L106 "dependency | ... error_code (실패 시)" # 참고: metrics L89 "error_code | 100 — error registry row 상한과 정합" — 값 개수가 정해져 있다 - key: error_code type: string @@ -220,7 +220,7 @@ mdc_keys: compatibility_impact: none required_test: contract-verification:log-fields - # 출처: feature-log-management-contract.md L107 + # source: feature-log-management-contract.md L107 # "security | event_type, user_principal (pseudonymized), source_ip (anonymized — last octet zeroed)" - key: event_type type: string @@ -235,7 +235,7 @@ mdc_keys: compatibility_impact: none required_test: contract-verification:log-fields - # 출처: feature-log-management-contract.md L107 "security | ... source_ip (anonymized — last octet zeroed)" + # source: feature-log-management-contract.md L107 "security | ... source_ip (anonymized — last octet zeroed)" # NOTE: metrics L93 "high-cardinality 금지 tag: ... ip_address" - key: source_ip_anon type: string @@ -250,7 +250,7 @@ mdc_keys: compatibility_impact: none required_test: contract-verification:log-fields - # 출처: feature-log-management-contract.md L108 "audit | actor, action, target, before_hash, after_hash, occurred_at" + # source: feature-log-management-contract.md L108 "audit | actor, action, target, before_hash, after_hash, occurred_at" - key: actor type: string source: security_context @@ -264,7 +264,7 @@ mdc_keys: compatibility_impact: none required_test: contract-verification:log-fields - # 출처: feature-log-management-contract.md L108 "audit | actor, action, target, ..." + # source: feature-log-management-contract.md L108 "audit | actor, action, target, ..." - key: action type: string source: application_set @@ -278,7 +278,7 @@ mdc_keys: compatibility_impact: none required_test: contract-verification:log-fields - # 출처: feature-log-management-contract.md L108 "audit | actor, action, target, ..." + # source: feature-log-management-contract.md L108 "audit | actor, action, target, ..." - key: target type: string source: application_set diff --git a/docs/registries/metrics.yaml b/docs/registries/metrics.yaml index 8f7a6164..06f17143 100644 --- a/docs/registries/metrics.yaml +++ b/docs/registries/metrics.yaml @@ -16,7 +16,7 @@ metrics: # === HTTP 서버 (inbound) === - # 출처: feature-metrics-alerting-contract — Metric/Alert Defaults + # source: feature-metrics-alerting-contract — Metric/Alert Defaults # "HTTP metric | http.server.requests with method/status/uri-template | raw URL or user id tag" - name: http.server.requests type: timer @@ -42,7 +42,7 @@ metrics: compatibility_impact: additive required_test: contract-verification:metrics-cardinality - # 출처: feature-metrics-alerting-contract — P1/P2/P3 정량 기준 (HTTP latency p99) + # source: feature-metrics-alerting-contract — P1/P2/P3 정량 기준 (HTTP latency p99) # "P1: p99 > 5s 5분 / P2: p99 > 1s 10분 / P3: p99 > 500ms 30분" - name: http.server.requests.latency type: timer @@ -66,9 +66,9 @@ metrics: required_test: contract-verification:metrics-cardinality # === HTTP client (outbound 의존 대상) === - # 출처: feature-metrics-alerting-contract — Metric/Alert Defaults + # source: feature-metrics-alerting-contract — Metric/Alert Defaults # "dependency metric | dependency.client.requests with dependency.name/type/outcome | endpoint with secret tag" - # 출처: feature-outbound-http-client-baseline — "circuit breaker metric은 dependency.name, dependency.type, outcome까지만 tag로 허용" + # source: feature-outbound-http-client-baseline — "circuit breaker metric은 dependency.name, dependency.type, outcome까지만 tag로 허용" - name: dependency.client.requests type: timer unit: seconds @@ -92,9 +92,9 @@ metrics: compatibility_impact: additive required_test: contract-verification:metrics-cardinality - # 출처: feature-outbound-http-client-baseline — 결정 + # source: feature-outbound-http-client-baseline — decisions # "retry/circuit breaker 기본 라이브러리는 Resilience4j" - # 출처: feature-metrics-alerting-contract — "retry/CB minimum: resilience4j.retry.calls{outcome}" + # source: feature-metrics-alerting-contract — "retry/CB minimum: resilience4j.retry.calls{outcome}" - name: resilience4j.retry.calls type: counter unit: total @@ -113,7 +113,7 @@ metrics: compatibility_impact: additive required_test: contract-verification:metrics-cardinality - # 출처: feature-metrics-alerting-contract — "resilience4j.circuitbreaker.state" + # source: feature-metrics-alerting-contract — "resilience4j.circuitbreaker.state" - name: resilience4j.circuitbreaker.state type: gauge unit: total @@ -133,7 +133,7 @@ metrics: compatibility_impact: additive required_test: contract-verification:metrics-cardinality - # 출처: feature-metrics-alerting-contract — "resilience4j.circuitbreaker.calls{outcome}" + # source: feature-metrics-alerting-contract — "resilience4j.circuitbreaker.calls{outcome}" - name: resilience4j.circuitbreaker.calls type: timer unit: seconds @@ -153,9 +153,9 @@ metrics: required_test: contract-verification:metrics-cardinality # === DB connection pool === - # 출처: feature-persistence-failure-baseline — Hikari Alert Threshold + # source: feature-persistence-failure-baseline — Hikari Alert Threshold # "pool wait p99 > 100ms 5분 지속 → P2 / pool exhaustion (active = max) > 1분 → P1" - # 출처: feature-metrics-alerting-contract — "hikaricp.connections.acquire{outcome='timeout'} p99 > 100ms" + # source: feature-metrics-alerting-contract — "hikaricp.connections.acquire{outcome='timeout'} p99 > 100ms" - name: hikaricp.connections.acquire type: timer unit: seconds @@ -175,7 +175,7 @@ metrics: compatibility_impact: additive required_test: contract-verification:metrics-cardinality - # 출처: feature-persistence-failure-baseline — 범위 안 "Hikari metric 노출 기준" + Hikari Alert Threshold + # source: feature-persistence-failure-baseline — In scope "Hikari metric 노출 기준" + Hikari Alert Threshold - name: hikaricp.connections.usage type: timer unit: seconds @@ -191,7 +191,7 @@ metrics: compatibility_impact: additive required_test: contract-verification:metrics-cardinality - # 출처: feature-persistence-failure-baseline — 범위 안 "Hikari metric 노출 기준" + # source: feature-persistence-failure-baseline — In scope "Hikari metric 노출 기준" - name: hikaricp.connections.active type: gauge unit: total @@ -207,7 +207,7 @@ metrics: compatibility_impact: additive required_test: contract-verification:metrics-cardinality - # 출처: feature-metrics-alerting-contract — Histogram Buckets/Percentile "DB query: same" + # source: feature-metrics-alerting-contract — Histogram Buckets/Percentile "DB query: same" - name: db.query.duration type: timer unit: seconds @@ -228,7 +228,7 @@ metrics: required_test: contract-verification:metrics-cardinality # === 백그라운드 작업 / 비동기 executor === - # 출처: feature-background-job-async-contract — Decisionized Work Items "saturation policy" + # source: feature-background-job-async-contract — Decisionized Work Items "saturation policy" # "AbortPolicy default (core=10, max=50, queue=200)" - name: executor.saturation type: gauge @@ -246,7 +246,7 @@ metrics: compatibility_impact: additive required_test: contract-verification:metrics-cardinality - # 출처: feature-background-job-async-contract — 결정한 작업 항목 "saturation | bounded executor + rejection log" + # source: feature-background-job-async-contract — Decisionized Work Items "saturation | bounded executor + rejection log" - name: executor.rejected.total type: counter unit: total @@ -265,7 +265,7 @@ metrics: compatibility_impact: additive required_test: contract-verification:metrics-cardinality - # 출처: feature-background-job-async-contract — 결정한 작업 항목 "retry/DLQ | exp backoff jitter, max 3, DLQ exhausted" + # source: feature-background-job-async-contract — Decisionized Work Items "retry/DLQ | exp backoff jitter, max 3, DLQ exhausted" - name: job.retry.total type: counter unit: total @@ -284,7 +284,7 @@ metrics: compatibility_impact: additive required_test: contract-verification:metrics-cardinality - # 출처: feature-background-job-async-contract — "DLQ after exhausted attempts" + # source: feature-background-job-async-contract — "DLQ after exhausted attempts" - name: job.dlq.total type: counter unit: total @@ -301,7 +301,7 @@ metrics: required_test: contract-verification:metrics-cardinality # === Distributed lock === - # 출처: feature-distributed-lock-contract D7 — "metric lock.acquisition (tag: outcome = + # source: feature-distributed-lock-contract D7 — "metric lock.acquisition (tag: outcome = # acquired/timeout/error) — 신규 제안" / D5 — try-lock + 유한 waitTime + lease(TTL). 분산 # 상호배제(distributedLockProvider) 획득 시도 결과를 센다. key 는 tag 로 넣지 않는다 # (무한 cardinality — 위 전역 금지 규칙). timeout outcome 은 LOCK_ACQUISITION_TIMEOUT 발생과 1:1. @@ -321,7 +321,7 @@ metrics: compatibility_impact: additive required_test: contract-verification:metrics-cardinality - # 출처: feature-distributed-lock-contract §Edge / D5 (SI-LOCK-C5) — "lease 만료 후 unlock → + # source: feature-distributed-lock-contract §Edge / D5 (SI-LOCK-C5) — "lease 만료 후 unlock → # ConcurrentModificationException — 삼킴 금지, 로그+metric 후 정상 흐름 복귀". lease가 이미 만료된 뒤의 # 해제를 센다(보유자가 close()를 부르기 전에 다른 인스턴스가 JdbcLock 행을 회수함). 0이 아닌 비율이 # 이어지면 lease TTL이 실제 임계 구역 시간보다 짧다는 뜻이다 — APP/lease TTL을 늘리거나 보호하는 일을 @@ -340,7 +340,7 @@ metrics: required_test: contract-verification:metrics-cardinality # === Outbox 발행기 === - # 출처: feature-domain-event-outbox-contract — Outbox Defaults + # source: feature-domain-event-outbox-contract — Outbox Defaults # "DB outbox table with eventId, aggregateId, eventType, payload, occurredAt, status, attemptCount, nextAttemptAt" - name: outbox.publisher.published.total type: counter @@ -363,7 +363,7 @@ metrics: compatibility_impact: additive required_test: contract-verification:metrics-cardinality - # 출처: feature-domain-event-outbox-contract — 행 상태 enum PENDING/IN_FLIGHT/PUBLISHED/FAILED/DEAD + # source: feature-domain-event-outbox-contract — 행 상태 enum PENDING/IN_FLIGHT/PUBLISHED/FAILED/DEAD - name: outbox.publisher.lag type: gauge unit: seconds @@ -380,7 +380,7 @@ metrics: compatibility_impact: additive required_test: contract-verification:metrics-cardinality - # 출처: feature-domain-event-outbox-contract — row status enum + Outbox Defaults attemptCount + # source: feature-domain-event-outbox-contract — row status enum + Outbox Defaults attemptCount # PARKED: 끝없이 재시도되던 행을 운영자가 붙잡아 둠 (re-review 2026-11-03 RR-05-03). - name: outbox.pending.size type: gauge @@ -401,7 +401,7 @@ metrics: compatibility_impact: additive required_test: contract-verification:metrics-cardinality - # 출처: re-review 2026-11-03 RR-05-03 — 지금의 거절과 답이 없는 발행은 끝없이 재시도된다. 이 둘은 + # source: re-review 2026-11-03 RR-05-03 — 지금의 거절과 답이 없는 발행은 끝없이 재시도된다. 이 둘은 # 10번 이상 미뤄진 FAILED 행을 세고(OutboxMetrics LONG_RETRY_DEFERRED_CLAIMS, publish-failed runbook §4.1 # 조회), 그중 가장 오래된 것의 나이를 잰다. - name: outbox.retry.long.size @@ -431,7 +431,7 @@ metrics: required_test: contract-verification:metrics-cardinality # === 캐시 === - # 출처: feature-cache-consistency-contract — Decisionized Work Items "cache pattern | cache-aside default" + # source: feature-cache-consistency-contract — Decisionized Work Items "cache pattern | cache-aside default" - name: cache.gets.total type: counter unit: total @@ -450,7 +450,7 @@ metrics: compatibility_impact: additive required_test: contract-verification:metrics-cardinality - # 출처: feature-cache-consistency-contract — "invalidation = after-commit only", "invalidation 실패가 조용히 무시되면 실패" + # source: feature-cache-consistency-contract — "invalidation = after-commit only", "invalidation 실패가 조용히 무시되면 실패" - name: cache.invalidations.total type: counter unit: total @@ -469,7 +469,7 @@ metrics: compatibility_impact: additive required_test: contract-verification:metrics-cardinality - # 출처: redis-production-capability — 크기가 정해진 캐시 전용 L1 (선택) + # source: redis-production-capability — 크기가 정해진 캐시 전용 L1 (선택) - name: cache.local.requests.total type: counter unit: total @@ -488,7 +488,7 @@ metrics: compatibility_impact: additive required_test: contract-verification:metrics-cardinality - # 출처: redis-production-capability — 로컬 stale 나이 상한 + # source: redis-production-capability — 로컬 stale 나이 상한 - name: cache.local.entry.age.seconds type: timer unit: seconds @@ -504,7 +504,7 @@ metrics: compatibility_impact: additive required_test: contract-verification:metrics-cardinality - # 출처: redis-production-capability — 크기가 정해진 무효화와 세대 대조(reconciliation) + # source: redis-production-capability — 크기가 정해진 무효화와 세대 대조(reconciliation) - name: cache.local.maintenance.total type: counter unit: total @@ -538,7 +538,7 @@ metrics: required_test: contract-verification:metrics-cardinality # === Redis 연결 lane === - # 출처: review 2026-11-03 RR-04-02 — 캐시의 조건부 쓰기는 자기 lane(CACHE_SCRIPT)을 받았다. 캐시 채우기가 + # source: review 2026-11-03 RR-04-02 — 캐시의 조건부 쓰기는 자기 lane(CACHE_SCRIPT)을 받았다. 캐시 채우기가 # idempotency·rate limiting·lease의 SCRIPT lane 연결을 가져가지 못하게 하려는 것이다. 이 meter들이 lane마다 # 그것이 지켜지는지 보여 준다. redis-runtime RedisLaneMetrics가 RedisRuntimeOwner가 pool로 가진 모든 lane에 # 대해, context에 MeterRegistry가 있을 때만 낸다. 모든 counter 계열은 기동 때 0으로 등록한다. @@ -659,7 +659,7 @@ metrics: required_test: contract-verification:metrics-cardinality # === 로그 appender === - # 출처: feature-log-management-contract — Sampling Policy (final) + # source: feature-log-management-contract — Sampling Policy (final) # "async appender overflow default: drop oldest INFO/DEBUG with counter metric (log.appender.dropped.total)" - name: log.appender.dropped.total type: counter @@ -680,7 +680,7 @@ metrics: required_test: contract-verification:metrics-cardinality # === 분산 추적 === - # 출처: feature-distributed-tracing-contract — decisions + # source: feature-distributed-tracing-contract — decisions # "trace sampling rate default = prod 1%, dev/local 100%; shipped runtime profiles are local|dev|prod" - name: tracing.sampling.rate type: gauge @@ -699,7 +699,7 @@ metrics: required_test: contract-verification:metrics-cardinality # === JVM 기본 === - # 출처: feature-metrics-alerting-contract — In scope "JVM/process metric" + # source: feature-metrics-alerting-contract — In scope "JVM/process metric" - name: jvm.memory.used type: gauge unit: bytes @@ -718,7 +718,7 @@ metrics: compatibility_impact: additive required_test: contract-verification:metrics-cardinality - # 출처: feature-metrics-alerting-contract — 범위 안 \"JVM/process metric\" + # source: feature-metrics-alerting-contract — In scope "JVM/process metric" - name: jvm.gc.pause type: timer unit: seconds @@ -736,7 +736,7 @@ metrics: compatibility_impact: additive required_test: contract-verification:metrics-cardinality - # 출처: feature-metrics-alerting-contract — 범위 안 \"JVM/process metric\" + # source: feature-metrics-alerting-contract — In scope "JVM/process metric" - name: jvm.threads.live type: gauge unit: total @@ -750,7 +750,7 @@ metrics: compatibility_impact: additive required_test: contract-verification:metrics-cardinality - # 출처: feature-metrics-alerting-contract — 범위 안 \"JVM/process metric\" (process uptime) + # source: feature-metrics-alerting-contract — In scope "JVM/process metric" (process uptime) - name: process.uptime type: gauge unit: seconds diff --git a/docs/registries/secrets-classification.yaml b/docs/registries/secrets-classification.yaml index 860b33f3..af342bc9 100644 --- a/docs/registries/secrets-classification.yaml +++ b/docs/registries/secrets-classification.yaml @@ -26,7 +26,7 @@ secrets: # === 3등급: secret (진짜 비밀 — password/private-key/HMAC-salt) === - name: APP_DATASOURCE_PASSWORD - # 출처: feature-secrets-config-source-contract 2026-05-22 + # source: feature-secrets-config-source-contract 2026-05-22 # "DB credential은 dual-bind 60s" + "__LOCAL_DEV_FAKE_DB_PASSWORD" 예시 classification: secret source: secret-manager @@ -42,7 +42,7 @@ secrets: required_test: secrets-contract:db-password-no-leak-in-actuator - name: SPRING_MAIL_PASSWORD - # 출처: notification/fileserver techlead review H2 — Spring Mail이 직접 읽는 자격 증명이라 APP_* 별칭을 두지 + # source: notification/fileserver techlead review H2 — Spring Mail이 직접 읽는 자격 증명이라 APP_* 별칭을 두지 # 않고 일부러 SPRING_* 이름을 유지한다. classification: secret source: secret-manager @@ -56,7 +56,7 @@ secrets: required_test: secrets-contract:smtp-password-no-leak - name: APP_CACHE_REDIS_PASSWORD - # 출처: feature-secrets-config-source-contract 2026-05-22 + # source: feature-secrets-config-source-contract 2026-05-22 # 3등급 분류 "secret" + feature-integration-adapter-templates "Redis | disabled optional module" # (Redis를 켜고 인증을 쓰면 secret으로 분류) classification: secret @@ -206,7 +206,7 @@ secrets: required_test: secrets-contract:lease-redis-key-hmac-no-leak - name: APP_PRIVACY_PSEUDONYMIZATION_SALT - # 출처: feature-data-retention-privacy-contract 2026-05-22 + # source: feature-data-retention-privacy-contract 2026-05-22 # "pseudonymization key = HMAC-SHA-256 with rotating salt. salt rotation interval = 90일. # rotation 시 old salt 90일 retain (lookup 가능)." # + feature-tenant-context-policy "tenant identifier는 raw PII가 아니어야 하며 ... pseudonymized id" @@ -328,7 +328,7 @@ secrets: required_test: secrets-contract:notification-callback-fingerprint-hmac-no-leak - name: APP_NOTIFICATION_SLACK_WEBHOOK_URL - # 출처: feature-integration-adapter-templates 2026-05-22 + # source: feature-integration-adapter-templates 2026-05-22 # "Slack | disabled optional module | notification failure policy" # Slack webhook URL은 token을 path에 포함하므로 sensitive-config (URL 형태이지만 secret과 동급 취급) classification: sensitive-config @@ -342,7 +342,7 @@ secrets: required_test: secrets-contract:slack-webhook-no-leak - name: APP_SECURITY_GOOGLE_OAUTH_CLIENT_ID - # 출처: feature-secrets-config-source-contract 2026-05-22 + # source: feature-secrets-config-source-contract 2026-05-22 # "sensitive-config" 등급 (id이지만 노출 제한) # + feature-integration-adapter-templates "Google Email | disabled optional module" classification: sensitive-config @@ -356,7 +356,7 @@ secrets: required_test: secrets-contract:google-oauth-client-id-masked - name: APP_DATASOURCE_USERNAME - # 출처: feature-secrets-config-source-contract 2026-05-22 — "sensitive-config" 등급 + # source: feature-secrets-config-source-contract 2026-05-22 — "sensitive-config" 등급 # (DB user는 password와 함께 노출되면 위험하므로 sensitive-config) classification: sensitive-config source: mounted-env @@ -382,7 +382,7 @@ secrets: required_test: secrets-contract:mongodb-uri-masked - name: APP_DATASOURCE_URL - # 출처: feature-secrets-config-source-contract 2026-05-22 — JDBC URL은 host/db 포함하므로 sensitive-config + # source: feature-secrets-config-source-contract 2026-05-22 — JDBC URL은 host/db 포함하므로 sensitive-config # (env-keys.yaml에서는 public-config 처리; 본 파일에서는 노출 통제 관점에서 sensitive로 재분류 — masking 기준 명시 목적) classification: sensitive-config source: mounted-env @@ -397,7 +397,7 @@ secrets: # === 1등급: public-config (참조만 — 행 전체는 env-keys.yaml에 있다) === - name: APP_PROFILE - # 출처: feature-env-driven-runtime-configuration — public-config 등급 참조 + # source: feature-env-driven-runtime-configuration — public-config 등급 참조 classification: public-config source: application-yml owner_branch: feature-env-driven-runtime-configuration @@ -405,7 +405,7 @@ secrets: reference: env-keys.yaml#APP_PROFILE - name: APP_NAME - # 출처: feature-env-driven-runtime-configuration — public-config 등급 참조 + # source: feature-env-driven-runtime-configuration — public-config 등급 참조 classification: public-config source: application-yml owner_branch: feature-env-driven-runtime-configuration @@ -413,7 +413,7 @@ secrets: reference: env-keys.yaml#APP_NAME - name: SERVER_PORT - # 출처: feature-env-driven-runtime-configuration — Spring 자체 키, public-config 등급 참조 + # source: feature-env-driven-runtime-configuration — Spring 자체 키, public-config 등급 참조 classification: public-config source: application-yml owner_branch: feature-env-driven-runtime-configuration @@ -421,7 +421,7 @@ secrets: reference: env-keys.yaml#SERVER_PORT - name: SPRING_PROFILES_ACTIVE - # 출처: feature-env-driven-runtime-configuration — Spring 자체 키, public-config 등급 참조 + # source: feature-env-driven-runtime-configuration — Spring 자체 키, public-config 등급 참조 classification: public-config source: application-yml owner_branch: feature-env-driven-runtime-configuration @@ -429,7 +429,7 @@ secrets: reference: env-keys.yaml#SPRING_PROFILES_ACTIVE - name: OTEL_EXPORTER_OTLP_ENDPOINT - # 출처: feature-distributed-tracing-contract — public-config 등급 참조 + # source: feature-distributed-tracing-contract — public-config 등급 참조 classification: public-config source: application-yml owner_branch: feature-distributed-tracing-contract