Files
clean-architecture-backend-…/docs/registries/env-keys.yaml
T
DongHyeonka afdedabf2a fix(persistence)!: 넘겨받은 claim만 쓰게 fence와 조건부 쓰기를 맞춘다
lease를 넘겨받는 저장소 다섯 곳이 앞 실행의 쓰기를 막지 못한다.
durable operation은 owner만 보고 써서 같은 worker id가 다시 claim하면
앞 실행의 결과가 남는다. 알림 lease 회복은 상태를 다시 읽은 뒤 조건
없이 되돌려 끝난 delivery를 다시 보낸다. 만료 sweep·전체 읽음은
기다린 행의 상태를 다시 보지 않는다. 멱등성 reaper는 앱 시계로 비교하고
한 번에 다 지우며, 같은 키 요청이 되살린 기록까지 지운다. fileserver
recovery enqueue는 동시 삽입에서 25P02로 실패하고, cleanup은 claim
lease가 끝난 뒤에도 항목을 시작한다. 저장소가 행에서 만드는 claim·lease
record는 잘못된 값을 IllegalArgumentException으로 거절해 web이 400으로
바꾼다.

고른 방법: 모든 쓰기를 owner·fence(·상태·만료) 조건을 단 한 문장으로
바꾼다. durable operation은 V23 lease_fence를 더하고 DurableOperationClaim
을 돌려준다. 알림 회복은 requeueAbandoned 한 문장이다. 만료 sweep은
subquery가 SKIP LOCKED로 쥔 행을 건너뛰고 바깥 UPDATE가 상태·만료를 다시
본다. 전체 읽음은 바깥 UPDATE가 상태를 다시 본다. reaper는 DB now()로
1000행씩, 트랜잭션마다 30초(SpringTransaction.DEFAULT_TIMEOUT_SECONDS)이고
바깥 DELETE에도 만료를 둔다. recovery는 INSERT … ON CONFLICT, cleanup은
lease 마지막 2분에 시작하지 않고 시도를 세지 않는 release로 돌려준다.
알림 provider timeout은 lease보다 짧아야 기동한다(호출이 lease를 넘으면
lease 복구가 아직 도는 호출을 맞추기로 넘긴다). 저장소가 만드는 record
일곱은 IllegalStateException으로 거절한다. 버린 대안: 읽고 비교한 뒤
쓰기(경합이 그대로 남음), 앱 쪽 락(인스턴스 사이에서 무의미).

위험·한계: 포트 시그니처가 바뀐다(DurableOperationStorePort,
RecipientLeaseStorePort.expiredDispatching, RecipientDeliveryStorePort
.requeueAbandoned, CleanupQueuePort.release). owner가 없거나 fence가
0인 V4 전 DISPATCHING 행은 회복이 고르지 않는다(안내 4행에 고치는 SQL).
provider timeout 검사는 필요조건일 뿐이고, 호출 전체를 묶는 것은 SES다.

검증: desktop RED(고치기 전 트리 + 새 시험, pr1-red3) 새 시험 13건
실패. GREEN은 PR 본문의 verify.sh pr·PostgreSQL lane 결과.

Refs: RR9-01-02, RR9-01-04, RR9-01-06, RR9-01-12, RR9-01-13, RR9-01-23, RR9-01-24, RR9-01-29, R1 넘김 DurableOperationStoreContractTest
BREAKING CHANGE: DurableOperationStorePort의 heartbeat·reportProgress·succeed·fail이 DurableOperationClaim을 받고 claimNext가 그것을 돌려준다. RecipientLeaseStorePort.expiredDispatching이 List<RecipientLease>를 돌려주고 RecipientDeliveryStorePort.requeueAbandoned, CleanupQueuePort.release가 새로 생긴다. IdempotencyReaper 생성자에서 Clock이 빠진다. 알림 provider timeout이 lease 이상이면 기동이 실패한다. 저장소가 만드는 claim·lease record가 IllegalStateException을 던진다. docs/upgrade/2026-11-round9-claim-fence.md
2026-11-13 13:17:33 +09:00

5460 lines
224 KiB
YAML

# Registry: Env Keys
# Schema owner: feature-contract-registry-governance
# Owner branch: feature-env-driven-runtime-configuration
# Last updated: 2026-11-12
#
# 표기 규칙
# - 애플리케이션이 가진 env는 모두 `APP_` 접두어를 쓴다(D2, 2026-06-05). Spring 속성으로 이어지는
# datasource·server 등의 키도 APP_*로 바꿨다(예: SERVER_PORT -> APP_SERVER_PORT).
# - 원래 이름으로 두는 것: Spring Boot 이름공간(SPRING_*·MANAGEMENT_*·SERVER_*, profile 선택자 SPRING_PROFILES_ACTIVE
# 포함 — D6), OpenTelemetry 규격 이름(OTEL_*), 그리고 APP_ 통일 전에 퍼진 두 이름(SECURITY_PUBLIC_PATHS,
# PRESENTATION_API_BASE_PATH, 맨 아래 절). 새 키는 APP_를 쓴다.
# - 배포 설정의 placeholder는 접두어와 상관없이 모두 행이 있어야 한다(verifyEnvKeys, 2026-11-12부터).
# - `default`는 배포 설정의 placeholder 기본값과 같고, .env.example은 그 값을 쓴다. 기본값이 아닌 권장값을 쓰는
# 행은 `example`에 그 값을 둔다. 빈 줄은 빈 문자열로 들어가 기본값을 덮으므로, 빈 칸은 기본값이 없는 키뿐이다.
# - `deprecated_orphaned: true` 행은 배포 설정이 읽지 않고 .env.example에도 없다(둘 다 verifyEnvKeys가 본다).
# - `classification: secret` 행은 secrets-classification.yaml을 가리키기만 한다. 행 전체는 그 파일이 가진다.
# - reload_policy 기본값 = `restart-only` (env-driven branch "config reload: no runtime reload" — 실행 중
# 다시 읽지 않는다).
# - boolean 값은 true/false만 쓴다 (env-driven branch 2026-05-22).
# - Duration 값은 Spring 줄임 표기(`30s`)다. ISO-8601(`PT30S`)은 쓰지 않는다 (env-driven branch 2026-05-22).
# - DataSize 값은 `10MB` 꼴이다 (env-driven branch 2026-05-22).
# - required_when은 둘 중 하나다. `<속성>=<값>` 꼴(공백 없음)은 테스트가 그 조건에서 기동 실패를 확인하고,
# 공백이 든 설명 꼴은 사람이 읽는 조건이다(RequiredWhenIsEnforcedTest).
env_keys:
# === Profile / 정체성 (feature-env-driven-runtime-configuration) ===
- name: SPRING_PROFILES_ACTIVE
# source: feature-env-driven-runtime-configuration D6 (2026-06-06), five-adapter-runtime-remediation §7.1에서
# 고침. profile 선택자는 Spring 자체 키 하나뿐이다(APP_PROFILE은 지웠다). CSV 목록이 아니라 값 정확히
# 하나다: 두 환경의 안전 규칙이 함께 적용될 수 없고, 진 쪽은 소리 없이 빠졌다.
type: enum
# 기본값이 없다. 짐작한 profile은 아무도 고르지 않은 배포다: 예전에는 profile 없이 띄운 jar가 local이
# 됐고, 영속성을 조건으로 묶기 전에는 재기동 때 쓴 것을 모두 잃는 in-memory DB이기도 했다.
allowed_values: [local, dev, prod]
classification: public-config
required: true
reload_policy: restart-only
owner_branch: feature-env-driven-runtime-configuration
validation: enum_in_allowed_values
compatibility_impact: behavior-change
required_test: env-contract:profile-active
# APP_PROFILE은 일부러 지웠다 (D6, 2026-06-06): profile = SPRING_PROFILES_ACTIVE 하나. APP_PROFILE을
# 따로 두면 같은 정보를 두 번 두고, 어긋날 때 실패하는 비용만 늘어난다. 설계 기록
# feature-env-driven-runtime-configuration Claims (wont-fix) 참고.
- name: APP_NAME
# source: feature-env-driven-runtime-configuration 2026-05-22
# "Required config: APP_NAME, APP_PROFILE..."
type: string
default: null
allowed_values: null
classification: public-config
required: true
reload_policy: restart-only
owner_branch: feature-env-driven-runtime-configuration
validation: non_empty_string
compatibility_impact: behavior-change
required_test: env-contract:app-name-present
# === HTTP 서버 (D2에 따라 APP_로 통일) ===
- name: 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과 분리)
type: int
default: 8080
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: feature-env-driven-runtime-configuration
validation: port_range_1_65535
compatibility_impact: behavior-change
required_test: env-contract:server-port-bound
- name: MANAGEMENT_SERVER_PORT
# 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
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: feature-management-actuator-security-contract
validation: port_range_1_65535
compatibility_impact: behavior-change
required_test: actuator-contract:management-port-separated
- name: MANAGEMENT_SERVER_ADDRESS
# source: W4 red team BE-CONFIG-001 2026-11-11 — management.server.address was unset, so the
# actuator connector bound every interface; health/prometheus/info (permitAll) were reachable
# unauthenticated off-loopback. Default to loopback; remote scraping sets this explicitly.
type: string
default: 127.0.0.1
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: feature-management-actuator-security-contract
validation: host_or_ip_address
compatibility_impact: behavior-change
required_test: actuator-contract:management-address-loopback
- name: APP_SERVER_SHUTDOWN
# source: feature-env-driven-runtime-configuration D2 (2026-06-05) — APP_ 통일
# (server.shutdown 방식. graceful은 처리 중인 요청을 끝내고 내린다)
type: enum
default: graceful
allowed_values: [graceful, immediate]
classification: public-config
required: false
reload_policy: restart-only
owner_branch: feature-env-driven-runtime-configuration
validation: enum_in_allowed_values
compatibility_impact: behavior-change
required_test: env-contract:server-shutdown-mode
- name: APP_SERVER_SHUTDOWN_TIMEOUT
# source: feature-env-driven-runtime-configuration D2 (2026-06-05) — APP_ 통일.
# 옛 APP_SHUTDOWN_TIMEOUT 행을 대신한다. k8s terminationGracePeriod 이하여야 한다
# (feature-container-runtime-contract 참고).
type: duration
default: 30s
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: feature-env-driven-runtime-configuration
validation: spring_duration_shorthand_le_termination_grace
compatibility_impact: behavior-change
required_test: env-contract:server-shutdown-timeout-aligned
- name: APP_SERVER_FORWARD_HEADERS_STRATEGY
# 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가
# 그 값으로는 기동을 거부한다.
type: enum
default: none
allowed_values: [none, native]
classification: public-config
required: false
reload_policy: restart-only
owner_branch: feature-env-driven-runtime-configuration
validation: enum_in_allowed_values
compatibility_impact: behavior-change
required_test: env-contract:server-forward-headers-strategy
- name: APP_SERVER_TOMCAT_MAX_THREADS
# source: feature-env-driven-runtime-configuration D2 (2026-06-05) — APP_ 통일
# (동시 요청 worker 상한)
type: int
default: 200
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: feature-env-driven-runtime-configuration
validation: positive_int
compatibility_impact: behavior-change
required_test: env-contract:tomcat-max-threads-bounded
- name: APP_SERVER_TOMCAT_MIN_SPARE_THREADS
# source: feature-env-driven-runtime-configuration D2 (2026-06-05) — APP_ 통일
# (쉬는 worker pool의 하한)
type: int
default: 10
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: feature-env-driven-runtime-configuration
validation: non_negative_int
compatibility_impact: behavior-change
required_test: env-contract:tomcat-min-spare-threads-valid
- name: APP_SERVER_TOMCAT_ACCEPT_COUNT
# source: feature-env-driven-runtime-configuration D2 (2026-06-05) — APP_ 통일
# (들어오는 TCP 연결의 OS backlog queue 깊이)
type: int
default: 100
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: feature-env-driven-runtime-configuration
validation: non_negative_int
compatibility_impact: behavior-change
required_test: env-contract:tomcat-accept-count-valid
- name: APP_SERVER_TOMCAT_MAX_CONNECTIONS
# source: feature-env-driven-runtime-configuration D2 (2026-06-05) — APP_ 통일
# (동시에 열린 연결 수의 상한)
type: int
default: 8192
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: feature-env-driven-runtime-configuration
validation: positive_int
compatibility_impact: behavior-change
required_test: env-contract:tomcat-max-connections-bounded
- name: APP_SERVER_TOMCAT_CONNECTION_TIMEOUT
# source: feature-env-driven-runtime-configuration D2 (2026-06-05) — APP_ 통일
# (Tomcat connector 연결 timeout)
type: duration
default: 20s
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: feature-env-driven-runtime-configuration
validation: spring_duration_shorthand
compatibility_impact: behavior-change
required_test: env-contract:tomcat-connection-timeout-set
- name: APP_SERVER_COMPRESSION_ENABLED
# source: feature-env-driven-runtime-configuration D2 (2026-06-05) — APP_ 통일
# (server.compression 켜고 끄기)
type: boolean
default: true
allowed_values: [true, false]
classification: public-config
required: false
reload_policy: restart-only
owner_branch: feature-env-driven-runtime-configuration
validation: boolean_strict
compatibility_impact: behavior-change
required_test: env-contract:server-compression-toggle
- name: APP_SERVER_COMPRESSION_MIN_RESPONSE_SIZE
# source: feature-env-driven-runtime-configuration D2 (2026-06-05) — APP_ 통일
# (이 크기보다 작은 응답은 압축하지 않는다)
type: data_size
default: 1KB
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: feature-env-driven-runtime-configuration
validation: spring_data_size
compatibility_impact: behavior-change
required_test: env-contract:server-compression-min-size
- name: APP_SERVER_ERROR_INCLUDE_STACKTRACE
# source: feature-env-driven-runtime-configuration D2 (2026-06-05) — APP_ 통일
# (spring.web.error.include-stacktrace 정책)
type: enum
default: never
allowed_values: [always, never, on_param]
classification: public-config
required: false
reload_policy: restart-only
owner_branch: feature-env-driven-runtime-configuration
validation: enum_in_allowed_values
compatibility_impact: behavior-change
required_test: env-contract:server-error-stacktrace-policy
- name: APP_SERVER_ERROR_INCLUDE_MESSAGE
# source: feature-env-driven-runtime-configuration D2 (2026-06-05) — APP_ 통일
# (spring.web.error.include-message 정책)
type: enum
default: never
allowed_values: [always, never, on_param]
classification: public-config
required: false
reload_policy: restart-only
owner_branch: feature-env-driven-runtime-configuration
validation: enum_in_allowed_values
compatibility_impact: behavior-change
required_test: env-contract:server-error-message-policy
- name: APP_MULTI_INSTANCE_ENABLED
# source: feature-env-driven-runtime-configuration D8 (2026-06-06)
# true면 StartupSafetyValidator(다른 singleton보다 먼저 도는 StartupRule)가 이름이
# distributedLockProvider인 인스턴스 간 DistributedLockPort bean을 요구한다. 없으면 기동이 실패한다
# (exit 72). 이 값을 쓰는 곳: feature-runtime-health-lifecycle-contract,
# feature-background-job-async-contract, feature-cache-consistency-contract,
# feature-domain-event-outbox-contract, feature-rate-limit-idempotency-contract,
# feature-migration-startup-contract.
type: boolean
default: false
allowed_values: [true, false]
classification: public-config
required: false
reload_policy: restart-only
owner_branch: feature-env-driven-runtime-configuration
validation: requires_coordination_beans_when_true
compatibility_impact: behavior-change
required_test: env-contract:multi-instance-beans-present
- name: APP_MIGRATION_ON_STARTUP
# source: feature-migration-startup-contract
# true면 애플리케이션이 기동하면서 Flyway migration을 자동으로 돌린다.
# false면 migration을 건너뛴다(앱 밖의 container·pipeline job에 맡긴다).
type: boolean
default: true
allowed_values: [true, false]
classification: public-config
required: false
reload_policy: restart-only
owner_branch: feature-migration-startup-contract
validation: boolean_strict
compatibility_impact: behavior-change
required_test: env-contract:migration-on-startup-toggle
# === Datasource / pool (env-driven branch "Required config: datasource") ===
- name: APP_DATASOURCE_URL
# 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
default: null
allowed_values: null
classification: public-config
required: true
reload_policy: restart-only
owner_branch: feature-env-driven-runtime-configuration
validation: jdbc_url_pattern
compatibility_impact: behavior-change
required_test: env-contract:datasource-url-resolvable
- name: APP_DATASOURCE_USERNAME
# source: feature-env-driven-runtime-configuration "Required config: datasource"
type: string
default: null
allowed_values: null
classification: sensitive-config
required: true
reload_policy: restart-only
owner_branch: feature-env-driven-runtime-configuration
validation: non_empty_string
compatibility_impact: behavior-change
required_test: env-contract:datasource-credential-present
- name: APP_DATASOURCE_PASSWORD
# source: feature-env-driven-runtime-configuration "Required config: datasource"
# + feature-secrets-config-source-contract — secret 분류라 secrets-classification.yaml이 행을 가진다
type: string
default: null
allowed_values: null
classification: secret
required: true
reload_policy: restart-only
owner_branch: feature-secrets-config-source-contract
validation: must_not_be_local_dev_sentinel_in_prod
compatibility_impact: breaking
required_test: secrets-contract:db-password-not-leaked
- name: APP_PERSISTENCE_VENDOR
# source: application-local.yml과 bootRunH2가 쓰는 영속성 vendor 선택자.
# PostgreSQL이 기본으로 들어 있고, H2는 개발자가 명시적으로 고를 때만 쓴다.
property: app.persistence.vendor
type: enum
default: postgresql
allowed_values: [postgresql, h2]
classification: public-config
required: false
reload_policy: restart-only
owner_branch: persistence-jpa-vendor-composition
validation: enum_strict
compatibility_impact: behavior-change
required_test: jpa-contract:local-vendor-parity
- name: APP_REALTIME_REPLAY_ENABLED
property: app.realtime.replay.enabled
owner_module: adapter-outbound-persistence-jpa
type: boolean
default: false
allowed_values: [true, false]
classification: public-config
required: false
reload_policy: restart-only
owner_branch: 2026-09-22-persistence-jpa-review-remediation
validation: boolean_strict
compatibility_impact: additive
required_test: jpa-contract:realtime-replay-env
- name: APP_REALTIME_REPLAY_RETENTION
property: app.realtime.replay.retention
owner_module: adapter-outbound-persistence-jpa
type: duration
default: 1h
allowed_values: null
classification: public-config
required: false
required_when: APP_REALTIME_REPLAY_ENABLED=true
reload_policy: restart-only
owner_branch: 2026-09-22-persistence-jpa-review-remediation
validation: positive_duration
compatibility_impact: additive
required_test: jpa-contract:realtime-replay-env
- name: APP_FLYWAY_ENABLED
# source: 로컬 PostgreSQL을 운영과 맞춤 / 명시적 H2 개발 lane.
# 모든 profile이 기본으로 migration을 돌린다 — persistence-jpa 모듈 기본값이 이 키를 읽는다
# (07-08; dev/prod가 그 위에 값을 박지 않는다). bootRunH2는 migration tree가 PostgreSQL 전용이라
# 끈다.
property: spring.flyway.enabled
type: boolean
default: true
allowed_values: [true, false]
classification: public-config
required: false
reload_policy: restart-only
owner_branch: persistence-jpa-vendor-composition
validation: boolean_strict
compatibility_impact: behavior-change
required_test: jpa-contract:local-flyway-parity
- name: APP_DATASOURCE_POOL_MAX_SIZE
# source: feature-env-driven-runtime-configuration "datasource/pool env"
# + feature-persistence-failure-baseline "Hikari metric 노출 기준"
type: int
default: 10
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: feature-env-driven-runtime-configuration
validation: positive_int
compatibility_impact: behavior-change
required_test: env-contract:pool-bounded
- name: APP_DATASOURCE_POOL_MIN_IDLE
# source: feature-env-driven-runtime-configuration "datasource/pool env"
type: int
default: 2
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: feature-env-driven-runtime-configuration
validation: non_negative_int
compatibility_impact: behavior-change
required_test: env-contract:pool-min-idle-valid
- name: APP_DATASOURCE_CONNECTION_TIMEOUT
# 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 줄임 표기는 바인딩되지 않아
# 기동이 실패한다. 이 행이 `duration` / `5s`라 했고, application.yml이 그 기본값을 복사했고, 모든 prod·dev
# 배포가 기동을 거부했다. five-adapter-runtime-remediation Wave 2가 prod-smoke lane에서 찾았다. 실제로
# 받는 값으로 고쳤다.
type: integer
default: 5000
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: feature-env-driven-runtime-configuration
validation: positive_integer_milliseconds
compatibility_impact: behavior-change
required_test: env-contract:connection-timeout-set
- name: APP_DATASOURCE_DRIVER
# source: feature-env-driven-runtime-configuration "Required config: datasource"
# (설정한 datasource URL의 JDBC driver class)
type: string
default: org.postgresql.Driver
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: feature-env-driven-runtime-configuration
validation: non_empty_string
compatibility_impact: behavior-change
required_test: env-contract:datasource-driver-set
- name: APP_DATASOURCE_DDL_AUTO
# source: feature-env-driven-runtime-configuration "Required config: datasource"
# (Hibernate ddl-auto. prod는 validate|none이어야 하고, local은 update가 편하다)
type: enum
default: validate
allowed_values: [none, validate, update, create, create-drop]
classification: public-config
required: false
reload_policy: restart-only
owner_branch: feature-env-driven-runtime-configuration
validation: enum_in_allowed_values
compatibility_impact: behavior-change
required_test: env-contract:datasource-ddl-auto-safe
- name: APP_DATASOURCE_SHOW_SQL
# source: feature-env-driven-runtime-configuration "Required config: datasource"
# (SQL을 로그에 찍는다)
type: boolean
default: false
allowed_values: [true, false]
classification: public-config
required: false
reload_policy: restart-only
owner_branch: feature-env-driven-runtime-configuration
validation: boolean_strict
compatibility_impact: behavior-change
required_test: env-contract:datasource-show-sql-toggle
- name: APP_DATASOURCE_FORMAT_SQL
# source: feature-env-driven-runtime-configuration "Required config: datasource"
# (SQL을 보기 좋게 찍는다 — SHOW_SQL=true일 때만 쓸모 있다)
type: boolean
default: false
allowed_values: [true, false]
classification: public-config
required: false
reload_policy: restart-only
owner_branch: feature-env-driven-runtime-configuration
validation: boolean_strict
compatibility_impact: behavior-change
required_test: env-contract:datasource-format-sql-toggle
- name: APP_DATASOURCE_OPEN_IN_VIEW
# source: feature-env-driven-runtime-configuration "Required config: datasource"
# (Hibernate OSIV — prod에서 켜지 않는다)
type: boolean
default: false
allowed_values: [true, false]
classification: public-config
required: false
reload_policy: restart-only
owner_branch: feature-env-driven-runtime-configuration
validation: boolean_strict
compatibility_impact: behavior-change
required_test: env-contract:datasource-open-in-view-toggle
- name: APP_DATASOURCE_POOL_IDLE_TIMEOUT
# source: feature-env-driven-runtime-configuration "datasource/pool env"
# (Hikari 밀리초. 쉬는 연결을 내보내는 기준)
type: int
default: 600000
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: feature-env-driven-runtime-configuration
validation: non_negative_int
compatibility_impact: behavior-change
required_test: env-contract:pool-idle-timeout-valid
- name: APP_DATASOURCE_POOL_MAX_LIFETIME
# source: feature-env-driven-runtime-configuration "datasource/pool env"
# (Hikari 밀리초. 연결 최대 수명 — broker timeout 전에 교체한다)
type: int
default: 1800000
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: feature-env-driven-runtime-configuration
validation: positive_int
compatibility_impact: behavior-change
required_test: env-contract:pool-max-lifetime-valid
# === 추적 / 관측 (feature-distributed-tracing-contract) ===
- name: OTEL_EXPORTER_OTLP_ENDPOINT
# source: feature-distributed-tracing-contract 2026-05-22
# "Micrometer Tracing + OpenTelemetry exporter를 기본 기준으로 둠"
# OTLP 기본 주소(OpenTelemetry 규격). TracingEnvironmentPostProcessor가 이 값을
# management.opentelemetry.tracing.export.otlp.endpoint의 <value>/v1/traces(OTLP/HTTP)로 잇는다.
# 빈 값 = span exporter bean 없음 (review 07-01, 2026-11-01).
type: url
default: null
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: feature-distributed-tracing-contract
validation: url_or_empty
compatibility_impact: additive
required_test: tracing-contract:exporter-endpoint-resolvable
- name: APP_TRACING_ENABLED
# source: feature-distributed-tracing-contract 2026-05-22
# "tracing disabled profile에서도 envelope meta.traceId와 log traceId는 유지"
type: boolean
default: true
allowed_values: [true, false]
classification: public-config
required: false
reload_policy: restart-only
owner_branch: feature-distributed-tracing-contract
validation: boolean_strict
compatibility_impact: behavior-change
required_test: tracing-contract:meta-traceid-when-disabled
- name: APP_TRACING_SAMPLE_RATE
# 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.
# TracingEnvironmentPostProcessor가 정한 비율을 management.tracing.sampling.probability로 잇는다.
type: string
default: ""
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: feature-distributed-tracing-contract
validation: float_between_0_and_1_or_blank
compatibility_impact: behavior-change
required_test: tracing-contract:sample-rate-per-profile
# === 로그 관리 (feature-log-management-contract) ===
# APP_LOG_LEVEL 키 하나를 아래 APP_LOG_LEVEL_* 행 다섯(root / app / spring / web / sql)으로 나눴다
# — feature-log-management-contract가 만든 대로.
- name: APP_LOG_LEVEL_ROOT
# source: feature-log-management-contract — root logger 레벨
type: enum
default: INFO
allowed_values: [TRACE, DEBUG, INFO, WARN, ERROR, OFF]
classification: public-config
required: false
reload_policy: restart-only
owner_branch: feature-log-management-contract
validation: enum_in_allowed_values
compatibility_impact: behavior-change
required_test: log-contract:root-level
- name: APP_LOG_LEVEL_APP
# source: feature-log-management-contract — 애플리케이션 패키지 레벨
type: enum
default: INFO
allowed_values: [TRACE, DEBUG, INFO, WARN, ERROR, OFF]
classification: public-config
required: false
reload_policy: restart-only
owner_branch: feature-log-management-contract
validation: enum_in_allowed_values
compatibility_impact: behavior-change
required_test: log-contract:app-level
- name: APP_LOG_LEVEL_SPRING
# source: feature-log-management-contract — Spring framework 패키지 레벨
type: enum
default: INFO
allowed_values: [TRACE, DEBUG, INFO, WARN, ERROR, OFF]
classification: public-config
required: false
reload_policy: restart-only
owner_branch: feature-log-management-contract
validation: enum_in_allowed_values
compatibility_impact: behavior-change
required_test: log-contract:spring-level
- name: APP_LOG_LEVEL_WEB
# source: feature-log-management-contract — web/MVC 패키지 레벨
type: enum
default: INFO
allowed_values: [TRACE, DEBUG, INFO, WARN, ERROR, OFF]
classification: public-config
required: false
reload_policy: restart-only
owner_branch: feature-log-management-contract
validation: enum_in_allowed_values
compatibility_impact: behavior-change
required_test: log-contract:web-level
- name: APP_LOG_LEVEL_SQL
# source: feature-log-management-contract — JPA/JDBC SQL 패키지 레벨 (DEBUG면 SQL을 찍는다)
type: enum
default: INFO
allowed_values: [TRACE, DEBUG, INFO, WARN, ERROR, OFF]
classification: public-config
required: false
reload_policy: restart-only
owner_branch: feature-log-management-contract
validation: enum_in_allowed_values
compatibility_impact: behavior-change
required_test: log-contract:sql-level
- name: APP_LOG_FILE_ENABLED
# source: feature-log-management-contract — 순환(rolling) JSON 파일 appender 켜고 끄기
type: boolean
default: false
allowed_values: [true, false]
classification: public-config
required: false
reload_policy: restart-only
owner_branch: feature-log-management-contract
validation: boolean_strict
compatibility_impact: behavior-change
required_test: log-contract:file-appender-toggle
- name: APP_LOG_FILE_PATH
# source: feature-log-management-contract — 파일 경로 (bootRun 실행 위치 기준 상대 경로 또는 절대 경로)
type: string
default: logs/ca-skeleton.json
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: feature-log-management-contract
validation: non_empty_string
compatibility_impact: behavior-change
required_test: log-contract:file-path-set
- name: APP_LOG_FILE_MAX_SIZE
# source: feature-log-management-contract — 파일 하나의 순환 크기 상한
type: data_size
default: 100MB
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: feature-log-management-contract
validation: spring_data_size
compatibility_impact: behavior-change
required_test: log-contract:file-max-size
- name: APP_LOG_FILE_MAX_HISTORY
# source: feature-log-management-contract — 남길 순환 보관 파일 수
type: int
default: 14
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: feature-log-management-contract
validation: positive_int
compatibility_impact: behavior-change
required_test: log-contract:file-max-history
- name: APP_LOG_FILE_TOTAL_SIZE_CAP
# source: feature-log-management-contract — 순환 파일 전체의 크기 상한
type: data_size
default: 3GB
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: feature-log-management-contract
validation: spring_data_size
compatibility_impact: behavior-change
required_test: log-contract:file-total-size-cap
- name: APP_LOG_ASYNC_ENABLED
# source: feature-log-management-contract — 막히지 않는 I/O를 위한 AsyncAppender 감싸기
type: boolean
default: true
allowed_values: [true, false]
classification: public-config
required: false
reload_policy: restart-only
owner_branch: feature-log-management-contract
validation: boolean_strict
compatibility_impact: behavior-change
required_test: log-contract:async-appender-toggle
- name: APP_LOG_ASYNC_QUEUE_SIZE
# source: feature-log-management-contract — 역압(back-pressure) 전 메모리 queue 깊이
type: int
default: 512
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: feature-log-management-contract
validation: positive_int
compatibility_impact: behavior-change
required_test: log-contract:async-queue-size
- name: APP_LOG_ASYNC_DISCARDING_THRESHOLD
# source: feature-log-management-contract — 남은 용량이 이 값 아래로 내려가면
# TRACE/DEBUG/INFO 이벤트를 버린다(WARN/ERROR는 늘 남긴다). 0 = 버리지 않는다.
type: int
default: 20
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: feature-log-management-contract
validation: non_negative_int
compatibility_impact: behavior-change
required_test: log-contract:async-discarding-threshold
- name: APP_LOG_JSON_TIMEZONE
# source: feature-log-management-contract — JSON encoder 시각에 쓰는 IANA timezone
type: string
default: UTC
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: feature-log-management-contract
validation: non_empty_string
compatibility_impact: behavior-change
required_test: log-contract:json-timezone
- name: APP_LOG_JSON_TIMESTAMP_PATTERN
# source: feature-log-management-contract — JSON encoder 시각 형식 (기본 ISO 8601)
type: string
default: "yyyy-MM-dd'T'HH:mm:ss.SSSXXX"
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: feature-log-management-contract
validation: non_empty_string
compatibility_impact: behavior-change
required_test: log-contract:json-timestamp-pattern
- name: APP_LOG_JSON_INCLUDE_CALLER_DATA
# source: feature-log-management-contract — 파일·메서드·줄 번호를 넣는다 (성능 비용이 크다)
type: boolean
default: false
allowed_values: [true, false]
classification: public-config
required: false
reload_policy: restart-only
owner_branch: feature-log-management-contract
validation: boolean_strict
compatibility_impact: behavior-change
required_test: log-contract:json-include-caller-data
- name: APP_LOG_JSON_LOGGER_NAME_LENGTH
# source: feature-log-management-contract — logger 이름 줄이기 (0 = 전체 이름)
type: int
default: 0
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: feature-log-management-contract
validation: non_negative_int
compatibility_impact: behavior-change
required_test: log-contract:json-logger-name-length
- name: APP_LOG_SAMPLING_RATE
# 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"
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: feature-log-management-contract
validation: float_between_0_and_1
compatibility_impact: behavior-change
required_test: log-contract:sample-rate-per-profile
# === 개인정보: user_principal 가명화 (feature-data-retention-privacy-contract) ===
- name: APP_PRIVACY_PSEUDONYMIZATION_SALT
# 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이 행을
# 가진다.
type: string
default: null
allowed_values: null
classification: secret
required: false
reload_policy: restart-only
owner_branch: feature-data-retention-privacy-contract
validation: must_not_be_local_dev_sentinel_in_prod
compatibility_impact: breaking
required_test: secrets-contract:pseudonymization-salt-rotation
# === Security / CORS / JWT (feature-security-operational-baseline) ===
- name: APP_SECURITY_CORS_ORIGINS
# source: feature-security-operational-baseline 2026-05-22
# "allowlist origin은 env-driven runtime configuration의 APP_SECURITY_CORS_ORIGINS로 주입"
type: csv_list
default: null
allowed_values: null
classification: public-config
required: true
reload_policy: restart-only
owner_branch: feature-security-operational-baseline
validation: csv_of_origins_no_wildcard_with_credentials
compatibility_impact: behavior-change
required_test: security-contract:cors-allowlist
- name: APP_SECURITY_CORS_ENABLED
# source: feature-security-operational-baseline — CORS filter 전체 켜고 끄기
type: boolean
default: false
allowed_values: [true, false]
classification: public-config
required: false
reload_policy: restart-only
owner_branch: feature-security-operational-baseline
validation: boolean_strict
compatibility_impact: behavior-change
required_test: security-contract:cors-enabled-toggle
- name: APP_SECURITY_CORS_ALLOWED_METHODS
# source: feature-security-operational-baseline — 허용 method
# (빈 값 -> CorsSettings의 무난한 method 기본값)
type: csv_list
default: null
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: feature-security-operational-baseline
validation: csv_of_http_methods_or_empty
compatibility_impact: behavior-change
required_test: security-contract:cors-allowed-methods
- name: APP_SECURITY_CORS_ALLOWED_HEADERS
# source: feature-security-operational-baseline — 허용 요청 헤더 ("*" = 모두)
type: csv_list
default: "*"
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: feature-security-operational-baseline
validation: csv_non_empty
compatibility_impact: behavior-change
required_test: security-contract:cors-allowed-headers
- name: APP_SECURITY_CORS_ALLOW_CREDENTIALS
# source: feature-security-operational-baseline 2026-05-22
# "CORS는 allowlist default, credentials false default" / "wildcard with credentials forbidden"
type: boolean
default: false
allowed_values: [true, false]
classification: public-config
required: false
reload_policy: restart-only
owner_branch: feature-security-operational-baseline
validation: forbid_true_with_wildcard_origin
compatibility_impact: behavior-change
required_test: security-contract:cors-credentials-policy
- name: APP_SECURITY_CORS_MAX_AGE
# source: feature-security-operational-baseline 2026-05-22
# "preflight max-age 600s default"
# 단위: 초. 이 값은 app.cors.max-age-seconds(CorsSettings의 long)로 간다 — "600s"는 바인딩되지 않아
# dev·prod 기동이 실패한다. 이 행이 duration / 600s라 했고 .env.example이 그 값을 복사했다(2026-11-12 리뷰).
type: integer
default: 600
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: feature-security-operational-baseline
validation: non_negative_integer_seconds
compatibility_impact: behavior-change
required_test: security-contract:cors-preflight-max-age
- name: APP_SECURITY_AUTH_MODE
type: enum
default: jwt
allowed_values: [jwt, redis-session]
classification: public-config
required: false
reload_policy: restart-only
owner_branch: redis-production-capability
validation: enum_in_allowed_values
compatibility_impact: additive
required_test: redis-session-contract:auth-mode-exclusive
- name: APP_SESSION_COOKIE_NAME
type: string
default: CA_SESSION
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: redis-production-capability
validation: bounded_cookie_name
compatibility_impact: additive
required_test: redis-session-contract:cookie-hardened
- name: APP_SESSION_COOKIE_SECURE
type: boolean
default: true
allowed_values: [true]
classification: public-config
required: false
reload_policy: restart-only
owner_branch: redis-production-capability
validation: must_be_true
compatibility_impact: additive
required_test: redis-session-contract:cookie-hardened
- name: APP_SESSION_COOKIE_HTTP_ONLY
type: boolean
default: true
allowed_values: [true]
classification: public-config
required: false
reload_policy: restart-only
owner_branch: redis-production-capability
validation: must_be_true
compatibility_impact: additive
required_test: redis-session-contract:cookie-hardened
- name: APP_SESSION_COOKIE_SAME_SITE
type: enum
default: Lax
allowed_values: [Lax, Strict, None]
classification: public-config
required: false
reload_policy: restart-only
owner_branch: redis-production-capability
validation: enum_in_allowed_values
compatibility_impact: additive
required_test: redis-session-contract:cookie-hardened
- name: APP_SESSION_COOKIE_PATH
type: string
default: /
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: redis-production-capability
validation: bounded_absolute_path
compatibility_impact: additive
required_test: redis-session-contract:cookie-hardened
- name: APP_SESSION_CSRF_COOKIE_NAME
type: string
default: XSRF-TOKEN
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: redis-production-capability
validation: bounded_cookie_name
compatibility_impact: additive
required_test: redis-session-contract:csrf-enabled
- name: APP_SESSION_CSRF_HEADER_NAME
type: string
default: X-XSRF-TOKEN
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: redis-production-capability
validation: bounded_header_name
compatibility_impact: additive
required_test: redis-session-contract:csrf-enabled
- name: APP_SESSION_REDIS_NAMESPACE_ENVIRONMENT
# 폐기 2026-08-10: 이 속성을 바인딩하던 settings class를 옛 Redis 세대와 함께 지워서 이 키는 어디에도
# 닿지 않는다. 아직 이 키를 쓰는 배포에 무엇이 대신하는지 알려 주려고 행을 지우지 않고 둔다.
deprecated_orphaned: true
removal_deadline: 2026-11-30
type: string
default: local
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: redis-production-capability
validation: lowercase_slug
compatibility_impact: additive
required_test: redis-session-contract:key-namespace
- name: APP_SESSION_IDLE_TIMEOUT
# 폐기 2026-08-10: 이 속성을 바인딩하던 settings class를 옛 Redis 세대와 함께 지워서 이 키는 어디에도
# 닿지 않는다. 아직 이 키를 쓰는 배포에 무엇이 대신하는지 알려 주려고 행을 지우지 않고 둔다.
deprecated_orphaned: true
removal_deadline: 2026-11-30
type: duration
default: 30m
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: redis-production-capability
validation: positive_duration_le_30d
compatibility_impact: additive
required_test: redis-session-contract:idle-expiry
- name: APP_SESSION_ABSOLUTE_LIFETIME
# 폐기 2026-08-10: 이 속성을 바인딩하던 settings class를 옛 Redis 세대와 함께 지워서 이 키는 어디에도
# 닿지 않는다. 아직 이 키를 쓰는 배포에 무엇이 대신하는지 알려 주려고 행을 지우지 않고 둔다.
deprecated_orphaned: true
removal_deadline: 2026-11-30
type: duration
default: 8h
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: redis-production-capability
validation: positive_duration_le_30d
compatibility_impact: additive
required_test: redis-session-contract:absolute-expiry
- name: APP_SESSION_TOUCH_INTERVAL
# 폐기 2026-08-10: 이 속성을 바인딩하던 settings class를 옛 Redis 세대와 함께 지워서 이 키는 어디에도
# 닿지 않는다. 아직 이 키를 쓰는 배포에 무엇이 대신하는지 알려 주려고 행을 지우지 않고 둔다.
deprecated_orphaned: true
removal_deadline: 2026-11-30
type: duration
default: 1m
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: redis-production-capability
validation: positive_duration_lt_idle
compatibility_impact: additive
required_test: redis-session-contract:bounded-touch
- name: APP_SESSION_TOMBSTONE_TTL
# 폐기 2026-08-10: 이 속성을 바인딩하던 settings class를 옛 Redis 세대와 함께 지워서 이 키는 어디에도
# 닿지 않는다. 아직 이 키를 쓰는 배포에 무엇이 대신하는지 알려 주려고 행을 지우지 않고 둔다.
deprecated_orphaned: true
removal_deadline: 2026-11-30
type: duration
default: 5m
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: redis-production-capability
validation: positive_duration_gt_route_drain
compatibility_impact: additive
required_test: redis-session-contract:logout-tombstone
- name: APP_SESSION_MAXIMUM_ENVELOPE_BYTES
# 폐기 2026-08-10: 이 속성을 바인딩하던 settings class를 옛 Redis 세대와 함께 지워서 이 키는 어디에도
# 닿지 않는다. 아직 이 키를 쓰는 배포에 무엇이 대신하는지 알려 주려고 행을 지우지 않고 둔다.
deprecated_orphaned: true
removal_deadline: 2026-11-30
type: int
default: 32768
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: redis-production-capability
validation: int_range_64_1048576
compatibility_impact: additive
required_test: redis-session-contract:serializer-bounded
- name: APP_SESSION_MAXIMUM_ATTRIBUTES
# 폐기 2026-08-10: 이 속성을 바인딩하던 settings class를 옛 Redis 세대와 함께 지워서 이 키는 어디에도
# 닿지 않는다. 아직 이 키를 쓰는 배포에 무엇이 대신하는지 알려 주려고 행을 지우지 않고 둔다.
deprecated_orphaned: true
removal_deadline: 2026-11-30
type: int
default: 64
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: redis-production-capability
validation: int_range_1_256
compatibility_impact: additive
required_test: redis-session-contract:serializer-bounded
- name: APP_SESSION_MAXIMUM_SCALAR_BYTES
# 폐기 2026-08-10: 이 속성을 바인딩하던 settings class를 옛 Redis 세대와 함께 지워서 이 키는 어디에도
# 닿지 않는다. 아직 이 키를 쓰는 배포에 무엇이 대신하는지 알려 주려고 행을 지우지 않고 둔다.
deprecated_orphaned: true
removal_deadline: 2026-11-30
type: int
default: 8192
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: redis-production-capability
validation: positive_int_le_envelope
compatibility_impact: additive
required_test: redis-session-contract:serializer-bounded
- name: APP_SECURITY_JWT_ISSUER
# source: feature-security-operational-baseline 2026-05-22
# "issuer mismatch | 401 | AUTH_ISSUER_MISMATCH"
type: url
default: null
allowed_values: null
classification: public-config
required: true
reload_policy: restart-only
owner_branch: feature-security-operational-baseline
validation: url_required
compatibility_impact: behavior-change
required_test: security-contract:jwt-issuer-set
- name: APP_SECURITY_JWT_AUDIENCE
# source: feature-security-operational-baseline 2026-05-22
# "audience mismatch | 401 | AUTH_AUDIENCE_MISMATCH"
type: csv_list
default: null
allowed_values: null
classification: public-config
required: true
reload_policy: restart-only
owner_branch: feature-security-operational-baseline
validation: csv_non_empty
compatibility_impact: behavior-change
required_test: security-contract:jwt-audience-set
- name: APP_RATE_LIMIT_ENABLED
# 정확한 provider를 고르기 전까지 inbound 강제는 꺼져 있다.
type: boolean
default: false
allowed_values: [true, false]
classification: public-config
required: false
reload_policy: restart-only
owner_branch: redis-production-capability-completion
validation: boolean_strict
compatibility_impact: additive
required_test: redis-rate-limit-contract:transport-provider-default-pair
# APP_RATE_LIMIT_CLIENT_IP_MODE는 지웠다 (2026-09-25, review follow-up I-5a): 그 값
# forwarded-headers-trusted는 인증하지 않은 호출자를 X-Forwarded-For의 맨 왼쪽 값으로 구분했는데, 그 값은
# 호출자가 쓴다. client IP는 getRemoteAddr()다. proxy 뒤라면
# APP_SERVER_FORWARD_HEADERS_STRATEGY=native와 server.tomcat.remoteip.internal-proxies를 설정한다.
- name: APP_RATE_LIMIT_REDIS_ENABLED
# 폐기 2026-08-10: rate limiter는 이제 자기 Redis client를 갖지 않는다. RedisRuntimeAutoConfiguration이 만든 client 하나가 모든 capability를 맡으므로, 두 번째 endpoint와 두 번째 상한은 그 client와 어긋날 수밖에 없었다.
# 대체: app.redis.enabled (APP_REDIS_ENABLED).
deprecated_orphaned: true
removal_deadline: 2026-11-30
type: boolean
default: false
allowed_values: [true, false]
classification: public-config
required: false
reload_policy: restart-only
owner_branch: redis-distributed-rate-limit
validation: boolean_strict
compatibility_impact: additive
required_test: rate-limit-contract:redis-disabled-zero-side-effect
- name: APP_RATE_LIMIT_PROVIDER
type: enum
default: disabled
allowed_values: [disabled, redis]
classification: public-config
required: false
reload_policy: restart-only
owner_branch: redis-distributed-rate-limit
validation: enum_strict
compatibility_impact: additive
required_test: rate-limit-contract:provider-explicit
- name: APP_RATE_LIMIT_FAILURE_POLICY
type: enum
default: fail-closed
allowed_values: [fail-closed]
classification: public-config
required: false
reload_policy: restart-only
owner_branch: redis-distributed-rate-limit
validation: enum_strict
compatibility_impact: additive
required_test: rate-limit-contract:fail-closed-only
- name: APP_RATE_LIMIT_DEFAULT_POLICY_ID
type: string
default: api-default
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: redis-distributed-rate-limit
validation: lowercase_slug
compatibility_impact: additive
required_test: rate-limit-contract:default-policy-resolves
- name: APP_RATE_LIMIT_FAILURE_RETRY_AFTER
type: duration
default: 100ms
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: redis-distributed-rate-limit
validation: spring_duration_shorthand_non_zero_le_30d
compatibility_impact: additive
required_test: rate-limit-contract:failure-retry-bounded
- name: APP_RATE_LIMIT_HASH_KEY_VERSION
type: int
default: 1
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: redis-distributed-rate-limit
validation: int_1_to_9999
compatibility_impact: additive
required_test: rate-limit-contract:hash-version-bounded
- name: APP_RATE_LIMIT_KEY_VERSION
type: int
default: 1
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: redis-distributed-rate-limit
validation: int_1_to_9999
compatibility_impact: additive
required_test: rate-limit-contract:key-version-bounded
- name: APP_RATE_LIMIT_REDIS_HOST
# 폐기 2026-08-10: rate limiter는 이제 자기 Redis client를 갖지 않는다. RedisRuntimeAutoConfiguration이 만든 client 하나가 모든 capability를 맡으므로, 두 번째 endpoint와 두 번째 상한은 그 client와 어긋날 수밖에 없었다.
# 대체: app.redis.nodes (APP_REDIS_NODES).
deprecated_orphaned: true
removal_deadline: 2026-11-30
type: string
default: null
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: redis-distributed-rate-limit
validation: non_empty_string_when_rate_limit_redis_enabled
compatibility_impact: additive
required_test: rate-limit-contract:redis-host-required
- name: APP_RATE_LIMIT_REDIS_PORT
# 폐기 2026-08-10: rate limiter는 이제 자기 Redis client를 갖지 않는다. RedisRuntimeAutoConfiguration이 만든 client 하나가 모든 capability를 맡으므로, 두 번째 endpoint와 두 번째 상한은 그 client와 어긋날 수밖에 없었다.
# 대체: app.redis.nodes (APP_REDIS_NODES).
deprecated_orphaned: true
removal_deadline: 2026-11-30
type: int
default: 6379
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: redis-distributed-rate-limit
validation: port_range_1_65535
compatibility_impact: additive
required_test: rate-limit-contract:redis-port-bounded
- name: APP_RATE_LIMIT_REDIS_PASSWORD
type: string
default: null
allowed_values: null
classification: secret
required: false
reload_policy: restart-only
owner_branch: redis-distributed-rate-limit
validation: must_not_be_local_dev_sentinel_in_prod
compatibility_impact: additive
required_test: rate-limit-contract:redis-password-no-leak
- name: APP_RATE_LIMIT_REDIS_TRUST_PEM
# 폐기 2026-08-10: rate limiter는 이제 자기 Redis client를 갖지 않는다. RedisRuntimeAutoConfiguration이 만든 client 하나가 모든 capability를 맡으므로, 두 번째 endpoint와 두 번째 상한은 그 client와 어긋날 수밖에 없었다.
# 대체: app.redis.tls.trust-material-resource.
deprecated_orphaned: true
removal_deadline: 2026-11-30
type: string
default: null
allowed_values: null
classification: sensitive-config
required: false
reload_policy: restart-only
owner_branch: redis-production-capability
validation: non_blank_pem_when_coordination_role_is_bound
compatibility_impact: additive
required_test: redis-contract:coordination-trust-material-no-leak
- name: APP_RATE_LIMIT_REDIS_KEY_HMAC_SECRET
type: string
default: null
allowed_values: null
classification: secret
required: false
reload_policy: restart-only
owner_branch: redis-distributed-rate-limit
validation: base64_min_32_bytes_when_rate_limit_redis_enabled
compatibility_impact: additive
required_test: rate-limit-contract:redis-hmac-required
- name: APP_SESSION_REDIS_PASSWORD
type: string
default: null
allowed_values: null
classification: secret
required: false
reload_policy: restart-only
owner_branch: redis-production-capability
validation: non_blank_when_session_role_is_bound
compatibility_impact: additive
required_test: redis-contract:session-password-no-leak
- name: APP_SESSION_REDIS_TRUST_PEM
# 폐기 2026-08-10: 이 값을 바인딩하던 session 세대를 지웠고, 대신한 것도 자기 Redis client를 갖지 않는다.
# 대체: app.redis.tls.trust-material-resource.
deprecated_orphaned: true
removal_deadline: 2026-11-30
type: string
default: null
allowed_values: null
classification: sensitive-config
required: false
reload_policy: restart-only
owner_branch: redis-production-capability
validation: non_blank_pem_when_session_role_is_bound
compatibility_impact: additive
required_test: redis-contract:session-trust-material-no-leak
- name: APP_SESSION_REDIS_KEY_HMAC_SECRET
# 폐기 2026-08-10: 이 속성을 바인딩하던 settings class를 옛 Redis 세대와 함께 지워서 이 키는 어디에도
# 닿지 않는다. 아직 이 키를 쓰는 배포에 무엇이 대신하는지 알려 주려고 행을 지우지 않고 둔다.
deprecated_orphaned: true
removal_deadline: 2026-11-30
type: string
default: null
allowed_values: null
classification: secret
required: false
reload_policy: restart-only
owner_branch: redis-production-capability
validation: base64_min_32_bytes_when_redis_session_enabled
compatibility_impact: additive
required_test: redis-session-contract:key-hmac-no-leak
- name: APP_RATE_LIMIT_REDIS_COMMAND_TIMEOUT
type: duration
default: 200ms
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: redis-distributed-rate-limit
validation: spring_duration_shorthand_non_zero_le_30s
compatibility_impact: additive
required_test: rate-limit-contract:redis-timeout-bounded
- name: APP_RATE_LIMIT_REDIS_MAXIMUM_COMMAND_BYTES
# 폐기 2026-08-10: rate limiter는 이제 자기 Redis client를 갖지 않는다. RedisRuntimeAutoConfiguration이 만든 client 하나가 모든 capability를 맡으므로, 두 번째 endpoint와 두 번째 상한은 그 client와 어긋날 수밖에 없었다.
# 대체: app.redis.limits.max-batch-request-bytes.
deprecated_orphaned: true
removal_deadline: 2026-11-30
type: int
default: 16384
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: redis-distributed-rate-limit
validation: int_16384_to_65536
compatibility_impact: additive
required_test: rate-limit-contract:redis-command-bytes-bounded
- name: APP_RATE_LIMIT_REDIS_MAXIMUM_QUEUED_COMMANDS
# 폐기 2026-08-10: rate limiter는 이제 자기 Redis client를 갖지 않는다. RedisRuntimeAutoConfiguration이 만든 client 하나가 모든 capability를 맡으므로, 두 번째 endpoint와 두 번째 상한은 그 client와 어긋날 수밖에 없었다.
# 대체: app.redis.capacity.maximum-in-flight-commands.
deprecated_orphaned: true
removal_deadline: 2026-11-30
type: int
default: 32
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: redis-distributed-rate-limit
validation: int_1_to_4096
compatibility_impact: additive
required_test: rate-limit-contract:redis-queue-bounded
- name: APP_RATE_LIMIT_REDIS_MAXIMUM_IN_FLIGHT_BYTES
# 폐기 2026-08-10: rate limiter는 이제 자기 Redis client를 갖지 않는다. RedisRuntimeAutoConfiguration이 만든 client 하나가 모든 capability를 맡으므로, 두 번째 endpoint와 두 번째 상한은 그 client와 어긋날 수밖에 없었다.
# 대체: app.redis.capacity.maximum-in-flight-bytes.
deprecated_orphaned: true
removal_deadline: 2026-11-30
type: int
default: 1048576
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: redis-distributed-rate-limit
validation: covers_rate_limit_command_and_le_268435456
compatibility_impact: additive
required_test: rate-limit-contract:redis-byte-admission-bounded
- name: APP_RATE_LIMIT_REDIS_NAMESPACE_ENVIRONMENT
# 폐기 2026-08-10: rate limiter는 이제 key prefix를 스스로 만들지 않는다. capability 넷이 각자 자유 형식 토큰 둘을 이어 prefix 넷이 생겼고, ACL 패턴은 그중 어느 것과도 맞지 않았다.
# 대체: app.redis.namespace.environment (APP_REDIS_NAMESPACE_ENVIRONMENT). 모든 capability가 함께 쓴다.
deprecated_orphaned: true
removal_deadline: 2026-11-30
type: string
default: local
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: redis-distributed-rate-limit
validation: lowercase_slug
compatibility_impact: additive
required_test: rate-limit-contract:redis-namespace-bounded
- name: APP_RATE_LIMIT_POLICY_REVISION
type: string
default: v1
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: redis-distributed-rate-limit
validation: lowercase_slug
compatibility_impact: additive
required_test: rate-limit-contract:policy-revision-bounded
- name: APP_RATE_LIMIT_ALGORITHM
type: enum
default: sliding-counter
allowed_values: [fixed-window, sliding-counter, token-bucket]
classification: public-config
required: false
reload_policy: restart-only
owner_branch: redis-distributed-rate-limit
validation: enum_strict
compatibility_impact: additive
required_test: rate-limit-contract:algorithm-selectable
- name: APP_RATE_LIMIT_LIMIT
type: int
default: 100
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: redis-distributed-rate-limit
validation: positive_lua_exact_integer
compatibility_impact: additive
required_test: rate-limit-contract:limit-bounded
- name: APP_RATE_LIMIT_WINDOW
type: duration
default: 1s
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: redis-distributed-rate-limit
validation: spring_duration_shorthand_non_zero_le_1d
compatibility_impact: additive
required_test: rate-limit-contract:window-bounded
- name: APP_RATE_LIMIT_CAPACITY
type: int
default: 100
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: redis-distributed-rate-limit
validation: positive_lua_exact_integer
compatibility_impact: additive
required_test: rate-limit-contract:capacity-bounded
- name: APP_RATE_LIMIT_REFILL_TOKENS
type: int
default: 100
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: redis-distributed-rate-limit
validation: positive_lua_exact_integer
compatibility_impact: additive
required_test: rate-limit-contract:refill-tokens-bounded
- name: APP_RATE_LIMIT_REFILL_PERIOD
type: duration
default: 1s
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: redis-distributed-rate-limit
validation: spring_duration_shorthand_non_zero_le_1d
compatibility_impact: additive
required_test: rate-limit-contract:refill-period-bounded
- name: APP_RATE_LIMIT_MAXIMUM_COST
type: int
default: 10
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: redis-distributed-rate-limit
validation: positive_lua_exact_integer
compatibility_impact: additive
required_test: rate-limit-contract:maximum-cost-bounded
- name: APP_RATE_LIMIT_CLEANUP_GRACE
type: duration
default: 5s
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: redis-distributed-rate-limit
validation: spring_duration_shorthand_non_zero_le_1d
compatibility_impact: additive
required_test: rate-limit-contract:cleanup-grace-bounded
- name: APP_IDEMPOTENCY_TTL
# app.capabilities.idempotency.replay-ttl: 끝난 응답을 다시 돌려줄 수 있는 기간. 모든 provider가
# 같은 값을 쓴다. IdempotencySettings는 기동할 때 72h보다 길거나, APP_IDEMPOTENCY_PROCESSING_LEASE보다
# 짧거나(re-review 2026-11-04 RR-03-11), APP_IDEMPOTENCY_FAILURE_RETENTION보다 긴 값(RR3-03-02, 소유자
# 결정 2026-11-04)을 거부한다. 이 키만 실패 보관 기간(기본 24h)보다 길게 올리면 기동이 실패하니 둘을 같이
# 올린다(RR5-03-01). 두 저장소 모두에서 기록 하나는 처리 lease에 이 값을 더한 만큼 남는다.
type: duration
default: 24h
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: feature-rate-limit-idempotency-contract
validation: spring_duration_shorthand_le_72h_ge_processing_lease_le_failure_retention
compatibility_impact: behavior-change
required_test: idempotency-contract:ttl-applied
- name: APP_IDEMPOTENCY_PROVIDER
# app.capabilities.idempotency.provider. redis와 postgresql은 각각 저장소만 기여한다. app-bootstrap이
# IdempotencyExecutor 하나를 만들고, 저장소가 정확히 하나가 아니면 기동을 거부한다. postgresql은 주
# data source를 쓰고, 기동할 때 자기 Flyway stream을 적용하고, PostgreSQL이 아닌 data source를 거부한다.
# 그래서 bootRunH2는 disabled나 redis로 돈다. 선택은 명시적이고 기본은 disabled다. classpath에 있다는
# 것만으로 고르는 구현은 없다.
# 2026-09-25: jdbc(V1 저장소)를 지웠다. 아직 이 값을 쓰는 배포는 바인딩에서 실패한다.
type: enum
default: disabled
allowed_values: [disabled, redis, postgresql]
classification: public-config
required: false
reload_policy: restart-only
owner_branch: redis-production-capability-completion
validation: enum_strict
compatibility_impact: breaking
required_test: redis-idempotency-contract:provider-exclusive
- name: APP_IDEMPOTENCY_REDIS_KEY_HMAC_SECRET
# 폐기 2026-09-22: Redis idempotency adapter는 호출자가 준 scope digest를 쓰고 이 비밀을 읽은 적이 없다.
deprecated_orphaned: true
removal_deadline: 2026-12-31
type: string
default: null
allowed_values: null
classification: secret
required: false
reload_policy: restart-only
owner_branch: redis-production-capability-completion
validation: base64_min_32_bytes_when_redis_idempotency_enabled
compatibility_impact: additive
required_test: redis-idempotency-contract:key-hmac-no-leak
- name: APP_IDEMPOTENCY_REDIS_NAMESPACE_ENVIRONMENT
# 폐기 2026-08-10: idempotency store는 이제 key prefix를 스스로 만들지 않는다. capability 넷이 각자 자유 형식 토큰 둘을 이어 prefix 넷이 생겼고, ACL 패턴은 그중 어느 것과도 맞지 않았다.
# 대체: app.redis.namespace.environment (APP_REDIS_NAMESPACE_ENVIRONMENT). 모든 capability가 함께 쓴다.
deprecated_orphaned: true
removal_deadline: 2026-11-30
type: string
default: local
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: redis-production-capability-completion
validation: lowercase_slug
compatibility_impact: additive
required_test: redis-idempotency-contract:key-namespace
- name: APP_IDEMPOTENCY_PROCESSING_LEASE
# app.capabilities.idempotency.processing-lease: 시도 하나가 claim을 쥐는 기간. in-flight
# Retry-After(2s)보다 길고, 최대 1h이며, APP_IDEMPOTENCY_TTL보다 길지 않다. lease가 끝난 claim은 시작하지
# 않았을 때만 넘겨받는다. lease가 끝난 실행은 IDEMPOTENCY_RECOVERY_REQUIRED로 답하고 다시 돌리지 않는다.
type: duration
default: 30s
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: redis-production-capability-completion
validation: duration_gt_in_flight_retry_after_2s_le_1h
compatibility_impact: additive
required_test: redis-idempotency-contract:processing-lease-bounded
- name: APP_IDEMPOTENCY_FAILURE_RETENTION
# app.capabilities.idempotency.failure-retention: executor가 실패로 표시한 기록(결과를 모른 채
# 버렸거나, 결과 없이 다시 시도할 수 있는 것)이 표시한 때부터 남는 기간. 최대 30d이고,
# IdempotencySettings는 기동할 때 APP_IDEMPOTENCY_TTL보다 짧은 값을 거부한다: 더 짧으면 버린 기록이 먼저
# 사라지고, 같은 key로 다시 보낸 요청이 일을 한 번 더 한다(re-review 2026-11-04 RR3-03-02, 소유자 결정
# 2026-11-04).
type: duration
default: 24h
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: redis-production-capability-completion
validation: positive_duration_le_30d_ge_replay_ttl
compatibility_impact: behavior-change
required_test: redis-idempotency-contract:failure-retention-bounded
- name: APP_LEASE_PROVIDER
type: enum
default: disabled
allowed_values: [disabled, redis]
classification: public-config
required: false
reload_policy: restart-only
owner_branch: redis-production-capability-completion
validation: enum_strict
compatibility_impact: additive
required_test: redis-lease-contract:provider-exclusive
- name: APP_LEASE_REDIS_KEY_HMAC_SECRET
# 폐기 2026-09-22: Redis lease adapter는 호출자가 준 resource digest를 쓰고 이 비밀을 읽은 적이 없다.
deprecated_orphaned: true
removal_deadline: 2026-12-31
type: string
default: null
allowed_values: null
classification: secret
required: false
reload_policy: restart-only
owner_branch: redis-production-capability-completion
validation: base64_min_32_bytes_when_redis_lease_enabled
compatibility_impact: additive
required_test: redis-lease-contract:key-hmac-no-leak
- name: APP_LEASE_REDIS_NAMESPACE_ENVIRONMENT
# 폐기 2026-08-10: lease는 이제 key prefix를 스스로 만들지 않는다. capability 넷이 각자 자유 형식 토큰 둘을 이어 prefix 넷이 생겼고, ACL 패턴은 그중 어느 것과도 맞지 않았다.
# 대체: app.redis.namespace.environment (APP_REDIS_NAMESPACE_ENVIRONMENT). 모든 capability가 함께 쓴다.
deprecated_orphaned: true
removal_deadline: 2026-11-30
type: string
default: local
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: redis-production-capability-completion
validation: lowercase_slug
compatibility_impact: additive
required_test: redis-lease-contract:key-namespace
- name: APP_LEASE_REDIS_DRIFT_BUDGET
type: duration
default: 10ms
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: redis-production-capability-completion
validation: non_negative_duration_lt_minimum_lease
compatibility_impact: additive
required_test: redis-lease-contract:drift-budget-bounded
# === 캐시 / Redis (feature-cache-consistency-contract + integration-adapter-templates) ===
- name: APP_CACHE_CANONICAL_DEFAULT_PROVIDER
# 기본 캐시 영역(canonical default semantic region)의 provider 선택. 옛 켜기 키는 따로 옮겨 가는 경로다.
type: enum
default: disabled
allowed_values: [disabled, redis]
classification: public-config
required: false
reload_policy: restart-only
owner_branch: redis-production-capability-completion
validation: enum_strict
compatibility_impact: additive
required_test: redis-cache:canonical-cache-role-composition
- name: APP_REDIS_ENABLED
# 2026-09-25 capability 포장: cache-redis 모듈은 있으면 켜진다(모듈의
# config/module-defaults/cache-redis.yml이 이 키를 기본 true로 잇는다). false가 명시적으로 끄는 값이다.
# 빌드에 모듈이 없는 것이 보통의 꺼진 상태다.
# false면 Redis 설정을 읽지 않고, Redis 비밀을 요구하지 않고, client·연결·thread·health contributor를
# 만들지 않는다. Redis가 켜진 뒤 어떤 capability를 조립할지는 role 선택자가 고른다. 그중 어느 것도 두
# 번째 켜고 끄기 키가 아니다.
property: app.redis.enabled
owner_module: adapter-outbound-cache-redis
type: boolean
default: true
allowed_values: [true, false]
classification: public-config
required: false
required_when: always-optional
reload_policy: restart-only
owner_branch: redis-optionality-and-composition
validation: boolean_strict
compatibility_impact: behavior-change
required_test: redis-capability-activation:the-switch-off-leaves-no-redis-bean-and-needs-no-redis
- name: APP_CACHE_REDIS_POSITIVE_HARD_TTL
# 캐시 항목을 쓸 수 있는 기간. Redis의 실제 TTL은 이 값과 같고 다른 것이 아니다. 그래서 항목이 배포가
# 정한 사용 기간보다 오래 남거나 일찍 버려지지 않는다.
type: duration
default: 5m
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: redis-production-capability-completion
validation: spring_duration_shorthand_ge_minimum_hard_ttl
compatibility_impact: additive
required_test: redis-capability:cache-region-composition
- name: APP_CACHE_REDIS_NEGATIVE_TTL
# 권위 있는 「없음」을 캐시하는 기간. 「원천에 이것이 없다」는 사실은 값과 유통 기한이 달라서 값의
# TTL과 따로 둔다.
type: duration
default: 10s
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: redis-production-capability-completion
validation: spring_duration_shorthand_non_zero
compatibility_impact: additive
required_test: redis-capability:cache-region-composition
- name: APP_CACHE_REDIS_MAXIMUM_SCRIPT_CONNECTIONS
# 캐시 자신의 script lane 연결 수. idempotency·rate limit·lease가 함께 쓰는
# APP_REDIS_CAPACITY_MAXIMUM_SCRIPT_CONNECTIONS와 따로 두어, 캐시 채우기가 그 셋을 굶기지 않게 한다
# (review 2026-11-03 README 4절, RR-04-02).
property: app.capabilities.cache.maximum-script-connections
owner_module: adapter-outbound-cache-redis
type: integer
default: 4
allowed_values: null
classification: public-config
required: false
required_when: app.capabilities.cache.bindings.default=redis
reload_policy: restart-only
owner_branch: refactor/maturity-review-2026-11
validation: positive_integer
compatibility_impact: additive
required_test: redis-capability:cache-script-lane-separate-from-correctness
- name: APP_IDEMPOTENCY_REDIS_COMMAND_TIMEOUT
# owner-safe 전이 하나의 상한.
type: duration
default: 200ms
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: redis-production-capability-completion
validation: spring_duration_shorthand_non_zero
compatibility_impact: additive
required_test: redis-capability:idempotency-store-composition
- name: APP_LEASE_REDIS_COMMAND_TIMEOUT
# lease 연산 하나의 상한.
type: duration
default: 200ms
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: redis-production-capability-completion
validation: spring_duration_shorthand_non_zero
compatibility_impact: additive
required_test: redis-capability:lease-composition
- name: APP_LEASE_REDIS_CONTENTION_RETRY_AFTER
# 경합으로 acquire에 실패한 호출자에게 기다리라고 알려 줄 시간. drift 예산과 다르다: 하나는 진
# 호출자에게 주는 조언이고, 다른 하나는 이긴 쪽이 자기 lease 중 믿지 않는 부분이다.
type: duration
default: 50ms
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: redis-production-capability-completion
validation: spring_duration_shorthand_non_zero
compatibility_impact: additive
required_test: redis-capability:lease-composition
# --- Redis 런타임 설정 (app.redis.*) ----------------------------------
# APP_REDIS_ENABLED가 true일 때만 adapter-outbound-redis-runtime의 RedisRuntimeAutoConfiguration이
# 바인딩한다. application.yml은 Redis 없는 배포에 이 값을 넣지 않는다. .env.example은 운영자가
# 명시적으로 넣을 값을 적어 둘 뿐이다. verifyEnvKeys가 이 레지스트리를 런타임 모듈의 설정 메타데이터와
# 대조한다.
- name: APP_REDIS_DATABASE
# Cluster는 database 0만 지원한다. 0이 아니면 거기서 기동이 실패한다.
property: app.redis.database
owner_module: adapter-outbound-redis-runtime
type: integer
default: 0
allowed_values: null
classification: public-config
required: false
required_when: app.redis.enabled=true
reload_policy: restart-only
owner_branch: redis-optionality-and-composition
validation: positive_integer
compatibility_impact: additive
required_test: redis-sdk:typed-settings-bound-and-validated
- name: APP_REDIS_MODE
# standalone | sentinel | cluster.
property: app.redis.mode
owner_module: adapter-outbound-redis-runtime
type: enum
default: "standalone"
allowed_values: [standalone, sentinel, cluster]
classification: public-config
required: false
required_when: app.redis.enabled=true
reload_policy: restart-only
owner_branch: redis-optionality-and-composition
validation: enum_strict
compatibility_impact: additive
required_test: redis-sdk:typed-settings-bound-and-validated
- name: APP_REDIS_NAMESPACE_DOMAIN
property: app.redis.namespace.domain
owner_module: adapter-outbound-redis-runtime
type: string
default: "shared"
allowed_values: null
classification: public-config
required: false
required_when: app.redis.enabled=true
reload_policy: restart-only
owner_branch: redis-optionality-and-composition
validation: nonblank_when_required
compatibility_impact: additive
required_test: redis-sdk:typed-settings-bound-and-validated
- name: APP_REDIS_NAMESPACE_ENVIRONMENT
property: app.redis.namespace.environment
owner_module: adapter-outbound-redis-runtime
type: string
default: "local"
allowed_values: null
classification: public-config
required: false
required_when: app.redis.enabled=true
reload_policy: restart-only
owner_branch: redis-optionality-and-composition
validation: nonblank_when_required
compatibility_impact: additive
required_test: redis-sdk:typed-settings-bound-and-validated
- name: APP_REDIS_NAMESPACE_SERVICE
property: app.redis.namespace.service
owner_module: adapter-outbound-redis-runtime
type: string
default: "sample-service"
allowed_values: null
classification: public-config
required: false
required_when: app.redis.enabled=true
reload_policy: restart-only
owner_branch: redis-optionality-and-composition
validation: nonblank_when_required
compatibility_impact: additive
required_test: redis-sdk:typed-settings-bound-and-validated
- name: APP_REDIS_NODES
# host:port CSV. Cluster와 Sentinel은 모든 seed node를 받는다.
property: app.redis.nodes
owner_module: adapter-outbound-redis-runtime
type: csv
default: "localhost:6379"
allowed_values: null
classification: public-config
required: false
required_when: app.redis.enabled=true
reload_policy: restart-only
owner_branch: redis-optionality-and-composition
validation: csv_nonempty
compatibility_impact: additive
required_test: redis-sdk:typed-settings-bound-and-validated
- name: APP_REDIS_TIMEOUT_BATCH
property: app.redis.timeout.batch
owner_module: adapter-outbound-redis-runtime
type: duration
default: "2s"
allowed_values: null
classification: public-config
required: false
required_when: app.redis.enabled=true
reload_policy: restart-only
owner_branch: redis-optionality-and-composition
validation: duration_strict
compatibility_impact: additive
required_test: redis-sdk:typed-settings-bound-and-validated
- name: APP_REDIS_TIMEOUT_FAST
# 단일 key 명령 profile. 5s를 넘으면 기동 때 경고를 남긴다.
property: app.redis.timeout.fast
owner_module: adapter-outbound-redis-runtime
type: duration
default: "500ms"
allowed_values: null
classification: public-config
required: false
required_when: app.redis.enabled=true
reload_policy: restart-only
owner_branch: redis-optionality-and-composition
validation: duration_strict
compatibility_impact: additive
required_test: redis-sdk:typed-settings-bound-and-validated
- name: APP_REDIS_TIMEOUT_SCRIPT
property: app.redis.timeout.script
owner_module: adapter-outbound-redis-runtime
type: duration
default: "1s"
allowed_values: null
classification: public-config
required: false
required_when: app.redis.enabled=true
reload_policy: restart-only
owner_branch: redis-optionality-and-composition
validation: duration_strict
compatibility_impact: additive
required_test: redis-sdk:typed-settings-bound-and-validated
# --- Redis 런타임 조립 설정 (app.redis.*) ----------------------
# 인증, Sentinel 탐색, TLS, 수명 주기, Cluster 라우팅, 용량. 다른 app.redis.*와 규칙이 같다:
# APP_REDIS_ENABLED가 true일 때만 바인딩하고, application.yml과 .env에는 일부러 두지 않는다.
- name: APP_REDIS_AUTHENTICATION_ADVANCED_CREDENTIAL_REFERENCE
# 등록된 script가 실행될 계정을 가리키는 참조. 애플리케이션 참조와 같은
# secret://<acl-account>@<source>/<name> 형식이다. 비우면 script가 애플리케이션 계정으로 돌고 기동 때 그렇다고
# 경고를 남긴다. Compose Redis lane은 compose/redis/acl/lane-fixture-accounts.acl의 fixture 계정인
# secret://ca-skeleton-application-advanced@environment/REDIS_LANE_ADVANCED_PASSWORD를 쓴다.
property: app.redis.authentication.advanced-credential-reference
owner_module: adapter-outbound-cache-redis
type: string
default: null
allowed_values: null
classification: sensitive-config
required: false
required_when: app.redis.enabled=true
reload_policy: restart-only
owner_branch: redis-optionality-and-composition
validation: nonblank_when_required
compatibility_impact: additive
required_test: redis-sdk:runtime-composition-binds-and-validates
- name: APP_REDIS_AUTHENTICATION_ANONYMOUS_ACCESS_ACCEPTED
property: app.redis.authentication.anonymous-access-accepted
owner_module: adapter-outbound-cache-redis
# Redis가 자격 증명 없이 돈다는 것을 명시적으로 인정하는 값. 자격 증명 참조가 없을 때 이 값이 없으면
# 기동이 실패한다. 그대로 기동하면 인증 없는 client가 만들어지고, `default` ACL 사용자를 끈 배포에서는
# 명령 하나도 돌리지 못한다 — 실패가 기동에서 첫 요청으로 옮겨 가고, 빠진 설정이 아니라 장애처럼 보인다.
# true로 두면 배포는 돌고 그 trade-off를 로그에 남긴다.
# 이 값을 쓰는 Compose lane은 없다: Redis lane은 대신 fixture 계정으로 인증한다. 이 값이 남기는 경고가 바로
# lane의 「기동은 조용하다」 검사가 잡으려는 것이기 때문이다.
type: boolean
default: false
allowed_values: [true, false]
classification: public-config
required: false
required_when: app.redis.enabled=true이고 자격 증명 참조를 설정하지 않았을 때
reload_policy: restart-only
owner_branch: redis-optionality-and-composition
validation: boolean_strict
compatibility_impact: additive
required_test: redis-sdk:authentication-required-unless-anonymous-accepted
- name: APP_REDIS_AUTHENTICATION_CREDENTIAL_REFERENCE
# 애플리케이션 ACL 계정 자격 증명을 가리키는 참조. 값은 secret manager에 있다.
# 형식: secret://<acl-account>@<source>/<name>. environment source는 변수 <name>을 읽는다. 계정 부분이
# 없으면 client가 `default`로 인증하는데, 단단히 설정한 Redis는 그 사용자를 끈다. Compose Redis lane은
# compose/redis/acl/lane-fixture-accounts.acl의 fixture 계정인
# secret://ca-skeleton-application@environment/REDIS_LANE_APPLICATION_PASSWORD를 쓴다.
property: app.redis.authentication.credential-reference
owner_module: adapter-outbound-cache-redis
type: string
default: null
allowed_values: null
classification: sensitive-config
required: false
required_when: app.redis.enabled=true
reload_policy: restart-only
owner_branch: redis-optionality-and-composition
validation: nonblank_when_required
compatibility_impact: additive
required_test: redis-sdk:runtime-composition-binds-and-validates
- name: APP_REDIS_CAPACITY_MAXIMUM_IN_FLIGHT_COMMANDS
property: app.redis.capacity.maximum-in-flight-commands
owner_module: adapter-outbound-cache-redis
type: integer
default: 64
allowed_values: null
classification: public-config
required: false
required_when: app.redis.enabled=true
reload_policy: restart-only
owner_branch: redis-optionality-and-composition
validation: positive_integer
compatibility_impact: additive
required_test: redis-sdk:runtime-composition-binds-and-validates
- name: APP_REDIS_CAPACITY_MAXIMUM_SCRIPT_CONNECTIONS
# 실제 SCRIPT lane 연결 수는 연결마다의 명령 queue와 따로 제한한다.
property: app.redis.capacity.maximum-script-connections
owner_module: adapter-outbound-redis-runtime
type: integer
default: 8
allowed_values: null
classification: public-config
required: false
required_when: app.redis.enabled=true
reload_policy: restart-only
owner_branch: 2026-09-20-cache-redis-review-remediation
validation: positive_integer
compatibility_impact: additive
required_test: redis-runtime:script-lane-physical-connections-bounded
- name: APP_REDIS_CAPACITY_REJECT_WHEN_DISCONNECTED
# true면 연결이 끊긴 동안 명령을 거부한다. false면 driver의 offline queue를 되살리는데, 다시 연결될 때 쌓인 쓰기를 끊긴 동안의 순서와 상관없이 몰아서 다시 보낸다.
property: app.redis.capacity.reject-when-disconnected
owner_module: adapter-outbound-cache-redis
type: boolean
default: true
allowed_values: [true, false]
classification: public-config
required: false
required_when: app.redis.enabled=true
reload_policy: restart-only
owner_branch: redis-optionality-and-composition
validation: boolean_strict
compatibility_impact: additive
required_test: redis-sdk:runtime-composition-binds-and-validates
- name: APP_REDIS_CLUSTER_MAXIMUM_REDIRECTS
property: app.redis.cluster.maximum-redirects
owner_module: adapter-outbound-cache-redis
type: integer
default: 5
allowed_values: null
classification: public-config
required: false
required_when: app.redis.enabled=true
reload_policy: restart-only
owner_branch: redis-optionality-and-composition
validation: positive_integer
compatibility_impact: additive
required_test: redis-sdk:runtime-composition-binds-and-validates
- name: APP_REDIS_CLUSTER_TOPOLOGY_REFRESH_PERIOD
property: app.redis.cluster.topology-refresh-period
owner_module: adapter-outbound-cache-redis
type: duration
default: "30s"
allowed_values: null
classification: public-config
required: false
required_when: app.redis.enabled=true
reload_policy: restart-only
owner_branch: redis-optionality-and-composition
validation: duration_strict
compatibility_impact: additive
required_test: redis-sdk:runtime-composition-binds-and-validates
- name: APP_REDIS_LIFECYCLE_ACQUIRE_TIMEOUT
# lane이 연결을 빌릴 때, 돌려받은 연결을 기다리는 시간. 넘으면 보내지 않은 것으로 거부한다.
property: app.redis.lifecycle.acquire-timeout
owner_module: adapter-outbound-cache-redis
type: duration
default: "2s"
allowed_values: null
classification: public-config
required: false
required_when: app.redis.enabled=true
reload_policy: restart-only
owner_branch: redis-optionality-and-composition
validation: duration_strict
compatibility_impact: additive
required_test: redis-sdk:runtime-composition-binds-and-validates
- name: APP_REDIS_LIFECYCLE_CLIENT_NAME
property: app.redis.lifecycle.client-name
owner_module: adapter-outbound-cache-redis
type: string
default: "ca-skeleton"
allowed_values: null
classification: public-config
required: false
required_when: app.redis.enabled=true
reload_policy: restart-only
owner_branch: redis-optionality-and-composition
validation: nonblank_when_required
compatibility_impact: additive
required_test: redis-sdk:runtime-composition-binds-and-validates
- name: APP_REDIS_LIFECYCLE_CONNECT_TIMEOUT
property: app.redis.lifecycle.connect-timeout
owner_module: adapter-outbound-cache-redis
type: duration
default: "2s"
allowed_values: null
classification: public-config
required: false
required_when: app.redis.enabled=true
reload_policy: restart-only
owner_branch: redis-optionality-and-composition
validation: duration_strict
compatibility_impact: additive
required_test: redis-sdk:runtime-composition-binds-and-validates
- name: APP_REDIS_LIFECYCLE_DRAIN_TIMEOUT
# 종료할 때 연결을 닫기 전에 처리 중인 명령을 기다리는 시간.
property: app.redis.lifecycle.drain-timeout
owner_module: adapter-outbound-cache-redis
type: duration
default: "6s"
allowed_values: null
classification: public-config
required: false
required_when: app.redis.enabled=true
reload_policy: restart-only
owner_branch: redis-optionality-and-composition
validation: duration_strict
compatibility_impact: additive
required_test: redis-sdk:runtime-composition-binds-and-validates
- name: APP_REDIS_LIFECYCLE_SHUTDOWN_QUIET_PERIOD
property: app.redis.lifecycle.shutdown-quiet-period
owner_module: adapter-outbound-cache-redis
type: duration
default: "100ms"
allowed_values: null
classification: public-config
required: false
required_when: app.redis.enabled=true
reload_policy: restart-only
owner_branch: redis-optionality-and-composition
validation: duration_strict
compatibility_impact: additive
required_test: redis-sdk:runtime-composition-binds-and-validates
- name: APP_REDIS_LIFECYCLE_SHUTDOWN_TIMEOUT
property: app.redis.lifecycle.shutdown-timeout
owner_module: adapter-outbound-cache-redis
type: duration
default: "3s"
allowed_values: null
classification: public-config
required: false
required_when: app.redis.enabled=true
reload_policy: restart-only
owner_branch: redis-optionality-and-composition
validation: duration_strict
compatibility_impact: additive
required_test: redis-sdk:runtime-composition-binds-and-validates
- name: APP_REDIS_SENTINEL_CREDENTIAL_REFERENCE
property: app.redis.sentinel.credential-reference
owner_module: adapter-outbound-cache-redis
type: string
default: null
allowed_values: null
classification: sensitive-config
required: false
# 있을 때만 적용한다: RedisTopologyClientFactory가 sentinel 자격 증명 provider를 ifPresent로 설정한다.
# 그래서 sentinel이 인증 없는 탐색을 받는 Sentinel 배포는 이 값 없이 뜬다. 예전에 적었던 무조건
# "app.redis.mode=sentinel"은 런타임이 강제한 적 없는 요구였다.
required_when: app.redis.mode=sentinel이고 sentinel이 인증을 요구할 때
reload_policy: restart-only
owner_branch: redis-optionality-and-composition
validation: nonblank_when_required
compatibility_impact: additive
required_test: redis-sdk:runtime-composition-binds-and-validates
- name: APP_REDIS_SENTINEL_MASTER_NAME
property: app.redis.sentinel.master-name
owner_module: adapter-outbound-cache-redis
type: string
default: null
allowed_values: null
classification: public-config
required: false
required_when: app.redis.mode=sentinel
reload_policy: restart-only
owner_branch: redis-optionality-and-composition
validation: nonblank_when_required
compatibility_impact: additive
required_test: redis-sdk:runtime-composition-binds-and-validates
- name: APP_REDIS_SENTINEL_NODES
property: app.redis.sentinel.nodes
owner_module: adapter-outbound-cache-redis
type: csv
default: app.redis.nodes
allowed_values: null
classification: public-config
required: false
# 설계상 app.redis.nodes로 돌아간다. 그래서 nodes에 sentinel을 적고 다른 것은 말하지 않은 배포가 잘못된
# 설정이 아니라 흔한 경우다.
required_when: app.redis.mode=sentinel이고 app.redis.nodes에 sentinel이 없을 때
reload_policy: restart-only
owner_branch: redis-optionality-and-composition
validation: csv_nonempty
compatibility_impact: additive
required_test: redis-sdk:runtime-composition-binds-and-validates
- name: APP_REDIS_TLS_CLIENT_CERTIFICATE_RESOURCE
property: app.redis.tls.client-certificate-resource
owner_module: adapter-outbound-cache-redis
type: string
default: null
allowed_values: null
classification: public-config
required: false
# key manager는 이 값이 있을 때만 설정한다. 보통의 단방향 TLS에는 client 인증서가 필요 없으니, TLS가
# 켜질 때마다 요구하는 것은 런타임이 한 적 없는 주장이었다.
required_when: app.redis.tls.enabled=true이고 서버가 mutual TLS를 요구할 때
reload_policy: restart-only
owner_branch: redis-optionality-and-composition
validation: nonblank_when_required
compatibility_impact: additive
required_test: redis-sdk:runtime-composition-binds-and-validates
- name: APP_REDIS_TLS_CLIENT_KEY_REFERENCE
property: app.redis.tls.client-key-reference
owner_module: adapter-outbound-cache-redis
type: string
default: null
allowed_values: null
classification: sensitive-config
required: false
# 켜고 끄는 값이 아니라 두 설정 사이의 관계다: key 없는 client 인증서로는 key manager를 만들 수 없다.
# RedisRuntimeSettings.validate가 강제하고 RedisRuntimeSettingsTest가 다룬다. 레지스트리의 글로 쓴 조건은
# 거기서 증명한다.
required_when: app.redis.tls.client-certificate-resource를 설정했을 때
reload_policy: restart-only
owner_branch: redis-optionality-and-composition
validation: nonblank_when_required
compatibility_impact: additive
required_test: redis-sdk:runtime-composition-binds-and-validates
- name: APP_REDIS_TLS_ENABLED
property: app.redis.tls.enabled
owner_module: adapter-outbound-cache-redis
type: boolean
default: false
allowed_values: [true, false]
classification: public-config
required: false
required_when: app.redis.enabled=true
reload_policy: restart-only
owner_branch: redis-optionality-and-composition
validation: boolean_strict
compatibility_impact: additive
required_test: redis-sdk:runtime-composition-binds-and-validates
- name: APP_REDIS_TLS_HOSTNAME_VERIFICATION
# 이 값을 끄면 trust material이 서명한 모든 인증서를 어떤 host에 대해서도 받는다.
property: app.redis.tls.hostname-verification
owner_module: adapter-outbound-cache-redis
type: boolean
default: true
allowed_values: [true, false]
classification: public-config
required: false
required_when: app.redis.enabled=true
reload_policy: restart-only
owner_branch: redis-optionality-and-composition
validation: boolean_strict
compatibility_impact: additive
required_test: redis-sdk:runtime-composition-binds-and-validates
- name: APP_REDIS_TLS_TRUST_MATERIAL_RESOURCE
property: app.redis.tls.trust-material-resource
owner_module: adapter-outbound-cache-redis
type: string
default: null
allowed_values: null
classification: public-config
required: false
# trust manager는 이 값이 있을 때만 설치한다. 없으면 JDK 기본 신뢰 앵커를 쓰고, 공개 CA가 발급한 서버
# 인증서에는 그것으로 충분하다.
required_when: app.redis.tls.enabled=true이고 서버 인증서가 공개 신뢰 체인에 없을 때
reload_policy: restart-only
owner_branch: redis-optionality-and-composition
validation: nonblank_when_required
compatibility_impact: additive
required_test: redis-sdk:runtime-composition-binds-and-validates
- name: APP_CACHE_REDIS_ENABLED
# 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은
# app.capabilities.cache.bindings.default가 고른다. 아직 이 키를 쓰는 배포에 무엇이 대신하는지 알려 주려고
# 행을 지우지 않고 둔다.
deprecated_orphaned: true
deprecated_alias_for: APP_REDIS_ENABLED
removal_deadline: 2026-11-30
type: boolean
default: false
allowed_values: [true, false]
classification: public-config
required: false
reload_policy: restart-only
owner_branch: feature-integration-adapter-templates
validation: boolean_strict
compatibility_impact: behavior-change
required_test: adapter-contract:redis-disabled-default
- name: APP_CACHE_REDIS_CLIENT_MODE
# 폐기 2026-08-10: 이 속성을 바인딩하던 settings class를 옛 Redis 세대와 함께 지워서 이 키는 어디에도
# 닿지 않는다. 아직 이 키를 쓰는 배포에 무엇이 대신하는지 알려 주려고 행을 지우지 않고 둔다.
deprecated_orphaned: true
removal_deadline: 2026-11-30
type: enum
default: managed
allowed_values: [managed, external]
classification: public-config
required: false
reload_policy: restart-only
owner_branch: redis-production-capability
validation: enum_strict
compatibility_impact: additive
required_test: adapter-contract:redis-client-mode-explicit
- name: APP_CACHE_REDIS_HOST
# 폐기 2026-08-10: 이 속성을 바인딩하던 settings class를 옛 Redis 세대와 함께 지워서 이 키는 어디에도
# 닿지 않는다. 아직 이 키를 쓰는 배포에 무엇이 대신하는지 알려 주려고 행을 지우지 않고 둔다.
deprecated_orphaned: true
removal_deadline: 2026-11-30
# source: feature-cache-consistency-contract — Redis adapter (켜면 endpoint가 필요하다)
type: string
default: null
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: feature-cache-consistency-contract
validation: non_empty_string_when_redis_enabled
compatibility_impact: behavior-change
required_test: cache-contract:redis-host-when-enabled
- name: APP_CACHE_REDIS_PORT
# 폐기 2026-08-10: 이 속성을 바인딩하던 settings class를 옛 Redis 세대와 함께 지워서 이 키는 어디에도
# 닿지 않는다. 아직 이 키를 쓰는 배포에 무엇이 대신하는지 알려 주려고 행을 지우지 않고 둔다.
deprecated_orphaned: true
removal_deadline: 2026-11-30
# source: feature-cache-consistency-contract — Redis adapter endpoint
type: int
default: 6379
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: feature-cache-consistency-contract
validation: port_range_1_65535
compatibility_impact: behavior-change
required_test: cache-contract:redis-port-bound
- name: APP_CACHE_REDIS_PASSWORD
# 폐기 2026-08-10: 이 속성을 바인딩하던 settings class를 옛 Redis 세대와 함께 지워서 이 키는 어디에도
# 닿지 않는다. 아직 이 키를 쓰는 배포에 무엇이 대신하는지 알려 주려고 행을 지우지 않고 둔다.
deprecated_orphaned: true
removal_deadline: 2026-11-30
type: string
default: null
allowed_values: null
classification: secret
required: false
reload_policy: restart-only
owner_branch: codex-phase-a-ci-recovery
validation: must_not_be_local_dev_sentinel_in_prod
compatibility_impact: additive
required_test: secrets-contract:redis-password-no-leak
- name: APP_CACHE_REDIS_TRUST_PEM
# 폐기 2026-08-10: 캐시는 이제 자기 Redis client를 갖지 않아서 이 값을 읽는 코드가 없다.
# 대체: app.redis.tls.trust-material-resource (APP_REDIS_TLS_TRUST_MATERIAL_RESOURCE). Redis client 하나가 모든 capability에 이 값을 쓴다.
deprecated_orphaned: true
removal_deadline: 2026-11-30
type: string
default: null
allowed_values: null
classification: sensitive-config
required: false
reload_policy: restart-only
owner_branch: redis-production-capability
validation: non_blank_pem_when_cache_role_is_bound
compatibility_impact: additive
required_test: redis-contract:cache-trust-material-no-leak
- name: APP_REDIS_SEMANTIC_PROBE_MINIMUM_INTERVAL
# 폐기 2026-08-10: 이 속성을 바인딩하던 settings class를 옛 Redis 세대와 함께 지워서 이 키는 어디에도
# 닿지 않는다. 아직 이 키를 쓰는 배포에 무엇이 대신하는지 알려 주려고 행을 지우지 않고 둔다.
deprecated_orphaned: true
removal_deadline: 2026-11-30
type: duration
default: 5s
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: redis-production-capability-completion
validation: spring_duration_1s_to_60s
compatibility_impact: additive
required_test: redis-contract:semantic-probe-cadence-bounded
- name: APP_REDIS_SENTINEL_DISCOVERY_REFRESH_PERIOD
# 폐기 2026-08-10: 이 속성을 바인딩하던 settings class를 옛 Redis 세대와 함께 지워서 이 키는 어디에도
# 닿지 않는다. 아직 이 키를 쓰는 배포에 무엇이 대신하는지 알려 주려고 행을 지우지 않고 둔다.
deprecated_orphaned: true
removal_deadline: 2026-11-30
type: duration
default: 30s
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: redis-production-capability-completion
validation: spring_duration_5s_to_5m_inclusive
compatibility_impact: additive
required_test: redis-contract:sentinel-discovery-refresh-period-bounded
- name: APP_REDIS_SEMANTIC_PROBE_MAXIMUM_STALENESS
# 폐기 2026-08-10: 이 속성을 바인딩하던 settings class를 옛 Redis 세대와 함께 지워서 이 키는 어디에도
# 닿지 않는다. 아직 이 키를 쓰는 배포에 무엇이 대신하는지 알려 주려고 행을 지우지 않고 둔다.
deprecated_orphaned: true
removal_deadline: 2026-11-30
type: duration
default: 15s
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: redis-production-capability-completion
validation: spring_duration_gte_probe_minimum_and_lte_5m
compatibility_impact: additive
required_test: redis-contract:semantic-probe-staleness-bounded
- name: APP_CACHE_REDIS_KEY_HMAC_SECRET
# 2026-09-25 capability 포장 때 cache-redis 모듈 기본 설정(config/module-defaults/cache-redis.yml)이
# app.capabilities.cache.*에 이 키를 다시 묶었다. 2026-08-10 폐기 표시가 그 뒤로 틀린 채 남아 있었다
# (2026-11-12 리뷰, verifyEnvKeys가 이제 폐기 행을 읽는 placeholder를 잡는다).
type: string
default: null
allowed_values: null
classification: secret
required: false
reload_policy: restart-only
owner_branch: codex-phase-a-ci-recovery
validation: base64_min_32_bytes_when_redis_enabled
compatibility_impact: additive
required_test: cache-contract:redis-hmac-secret-bounded
- name: APP_CACHE_REDIS_COMMAND_TIMEOUT
# 2026-09-25 capability 포장 때 cache-redis 모듈 기본 설정(config/module-defaults/cache-redis.yml)이
# app.capabilities.cache.*에 이 키를 다시 묶었다. 2026-08-10 폐기 표시가 그 뒤로 틀린 채 남아 있었다
# (2026-11-12 리뷰, verifyEnvKeys가 이제 폐기 행을 읽는 placeholder를 잡는다).
type: duration
default: 200ms
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: codex-phase-a-ci-recovery
validation: spring_duration_shorthand_non_zero_le_30s
compatibility_impact: additive
required_test: cache-contract:redis-command-timeout-bounded
- name: APP_CACHE_REDIS_MAXIMUM_QUEUED_COMMANDS
# 폐기 2026-08-10: 이 속성을 바인딩하던 settings class를 옛 Redis 세대와 함께 지워서 이 키는 어디에도
# 닿지 않는다. 아직 이 키를 쓰는 배포에 무엇이 대신하는지 알려 주려고 행을 지우지 않고 둔다.
deprecated_orphaned: true
removal_deadline: 2026-11-30
type: int
default: 8
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: codex-phase-a-ci-recovery
validation: int_1_to_4096
compatibility_impact: additive
required_test: cache-contract:redis-command-queue-bounded
- name: APP_CACHE_REDIS_MAXIMUM_IN_FLIGHT_BYTES
# 폐기 2026-08-10: 이 속성을 바인딩하던 settings class를 옛 Redis 세대와 함께 지워서 이 키는 어디에도
# 닿지 않는다. 아직 이 키를 쓰는 배포에 무엇이 대신하는지 알려 주려고 행을 지우지 않고 둔다.
deprecated_orphaned: true
removal_deadline: 2026-11-30
type: int
default: 16777216
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: codex-phase-a-ci-recovery
validation: covers_maximum_value_and_le_268435456
compatibility_impact: additive
required_test: cache-contract:redis-command-byte-admission-bounded
- name: APP_CACHE_REDIS_POSITIVE_SOFT_TTL
type: duration
default: 30s
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: redis-cache-resilience
validation: optional_spring_duration_non_zero_le_positive_hard_ttl
compatibility_impact: additive
required_test: cache-contract:redis-soft-hard-ttl-order
- name: APP_CACHE_REDIS_TTL_JITTER
# 폐기 2026-11-02: 바인딩하는 settings class가 없다. 읽던 곳은 샘플 모듈 application.yml의 블록 하나뿐이었고
# 그것도 바인딩되지 않았다(07-10). 샘플과 함께 지웠다. 아직 이 키를 쓰는 배포에 아무 일도 하지 않는다고
# 알려 주려고 둔다.
deprecated_orphaned: true
removal_deadline: 2027-02-28
type: float
default: 0.10
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: redis-cache-resilience
validation: decimal_0_to_0_5
compatibility_impact: additive
required_test: cache-contract:redis-ttl-jitter-bounded
- name: APP_CACHE_REDIS_MINIMUM_HARD_TTL
type: duration
default: 1s
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: redis-cache-resilience
validation: spring_duration_shorthand_non_zero_le_configured_hard_ttls
compatibility_impact: additive
required_test: cache-contract:redis-hard-ttl-minimum
- name: APP_CACHE_REDIS_NAMESPACE_ENVIRONMENT
# 폐기 2026-08-10: 캐시는 이제 key prefix를 스스로 만들지 않는다. capability 넷이 각자 자유 형식 토큰 둘을
# 이어 prefix 넷이 생겼고, 배포를 가두려던 ACL 패턴은 그중 어느 것과도 맞지 않았다. 아직 이 키를 쓰는
# 배포에 무엇이 대신하는지 알려 주려고 행을 지우지 않고 둔다.
# 대체: app.redis.namespace.environment (APP_REDIS_NAMESPACE_ENVIRONMENT). 모든 capability가 함께 쓴다.
deprecated_orphaned: true
removal_deadline: 2026-11-30
type: string
default: local
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: codex-phase-a-ci-recovery
validation: lowercase_slug
compatibility_impact: behavior-change
required_test: cache-contract:redis-namespace-environment-bound
- name: APP_CACHE_REDIS_SEMANTIC_REGION
# 2026-09-25 capability 포장 때 cache-redis 모듈 기본 설정(config/module-defaults/cache-redis.yml)이
# app.capabilities.cache.*에 이 키를 다시 묶었다. 2026-08-10 폐기 표시가 그 뒤로 틀린 채 남아 있었다
# (2026-11-12 리뷰, verifyEnvKeys가 이제 폐기 행을 읽는 placeholder를 잡는다).
type: string
default: default
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: codex-phase-a-ci-recovery
validation: lowercase_slug
compatibility_impact: behavior-change
required_test: cache-contract:redis-semantic-region-bound
- name: APP_CACHE_REDIS_MAXIMUM_VALUE_BYTES
# 폐기 2026-08-10: 이 속성을 바인딩하던 settings class를 옛 Redis 세대와 함께 지워서 이 키는 어디에도
# 닿지 않는다. 아직 이 키를 쓰는 배포에 무엇이 대신하는지 알려 주려고 행을 지우지 않고 둔다.
deprecated_orphaned: true
removal_deadline: 2026-11-30
type: int
default: 1048576
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: codex-phase-a-ci-recovery
validation: int_1_to_16777216
compatibility_impact: additive
required_test: cache-contract:redis-value-size-bounded
- name: APP_CACHE_REDIS_L1_ENABLED
# 폐기 2026-08-10: 이 속성을 바인딩하던 settings class를 옛 Redis 세대와 함께 지워서 이 키는 어디에도
# 닿지 않는다. 아직 이 키를 쓰는 배포에 무엇이 대신하는지 알려 주려고 행을 지우지 않고 둔다.
deprecated_orphaned: true
removal_deadline: 2026-11-30
type: boolean
default: false
allowed_values: [true, false]
classification: public-config
required: false
reload_policy: restart-only
owner_branch: redis-production-capability
validation: boolean_strict_cache_only
compatibility_impact: additive
required_test: cache-contract:redis-l1-disabled-default
- name: APP_CACHE_REDIS_L1_MAXIMUM_ENTRIES
# 폐기 2026-08-10: 이 속성을 바인딩하던 settings class를 옛 Redis 세대와 함께 지워서 이 키는 어디에도
# 닿지 않는다. 아직 이 키를 쓰는 배포에 무엇이 대신하는지 알려 주려고 행을 지우지 않고 둔다.
deprecated_orphaned: true
removal_deadline: 2026-11-30
type: int
default: 10000
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: redis-production-capability
validation: int_1_to_1000000
compatibility_impact: additive
required_test: cache-contract:redis-l1-cardinality-bounded
- name: APP_CACHE_REDIS_L1_MAXIMUM_WEIGHT_BYTES
# 폐기 2026-08-10: 이 속성을 바인딩하던 settings class를 옛 Redis 세대와 함께 지워서 이 키는 어디에도
# 닿지 않는다. 아직 이 키를 쓰는 배포에 무엇이 대신하는지 알려 주려고 행을 지우지 않고 둔다.
deprecated_orphaned: true
removal_deadline: 2026-11-30
type: int
default: 67108864
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: redis-production-capability
validation: int_1_to_1073741824_accounting_proxy
compatibility_impact: additive
required_test: cache-contract:redis-l1-weight-bounded
- name: APP_CACHE_REDIS_L1_MAXIMUM_ENTRY_WEIGHT_BYTES
# 폐기 2026-08-10: 이 속성을 바인딩하던 settings class를 옛 Redis 세대와 함께 지워서 이 키는 어디에도
# 닿지 않는다. 아직 이 키를 쓰는 배포에 무엇이 대신하는지 알려 주려고 행을 지우지 않고 둔다.
deprecated_orphaned: true
removal_deadline: 2026-11-30
type: int
default: 1048576
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: redis-production-capability
validation: positive_not_above_l1_maximum_weight
compatibility_impact: additive
required_test: cache-contract:redis-l1-entry-weight-bounded
- name: APP_CACHE_REDIS_L1_TTL
# 폐기 2026-08-10: 이 속성을 바인딩하던 settings class를 옛 Redis 세대와 함께 지워서 이 키는 어디에도
# 닿지 않는다. 아직 이 키를 쓰는 배포에 무엇이 대신하는지 알려 주려고 행을 지우지 않고 둔다.
deprecated_orphaned: true
removal_deadline: 2026-11-30
type: duration
default: 30s
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: redis-production-capability
validation: spring_duration_shorthand_non_zero_le_1h
compatibility_impact: additive
required_test: cache-contract:redis-l1-ttl-bounded
- name: APP_CACHE_REDIS_L1_GENERATION_RECHECK_INTERVAL
# 폐기 2026-08-10: 이 속성을 바인딩하던 settings class를 옛 Redis 세대와 함께 지워서 이 키는 어디에도
# 닿지 않는다. 아직 이 키를 쓰는 배포에 무엇이 대신하는지 알려 주려고 행을 지우지 않고 둔다.
deprecated_orphaned: true
removal_deadline: 2026-11-30
type: duration
default: 5s
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: redis-production-capability
validation: spring_duration_shorthand_non_zero_le_l1_ttl
compatibility_impact: additive
required_test: cache-contract:redis-l1-generation-recheck-bounded
- name: APP_CACHE_REDIS_L1_INVALIDATION_QUEUE_CAPACITY
# 폐기 2026-08-10: 이 속성을 바인딩하던 settings class를 옛 Redis 세대와 함께 지워서 이 키는 어디에도
# 닿지 않는다. 아직 이 키를 쓰는 배포에 무엇이 대신하는지 알려 주려고 행을 지우지 않고 둔다.
deprecated_orphaned: true
removal_deadline: 2026-11-30
type: int
default: 1024
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: redis-production-capability
validation: int_1_to_65536
compatibility_impact: additive
required_test: cache-contract:redis-l1-invalidation-queue-bounded
- name: APP_CACHE_DEFAULT_TTL
# 폐기 2026-08-10: 이 속성을 바인딩하던 settings class를 옛 Redis 세대와 함께 지워서 이 키는 어디에도
# 닿지 않는다. 아직 이 키를 쓰는 배포에 무엇이 대신하는지 알려 주려고 행을 지우지 않고 둔다.
deprecated_orphaned: true
removal_deadline: 2026-11-30
# 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
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: feature-cache-consistency-contract
validation: spring_duration_shorthand_non_zero
compatibility_impact: behavior-change
required_test: cache-contract:default-ttl-bounded
- name: APP_CACHE_NEGATIVE_TTL
# 폐기 2026-08-10: 이 속성을 바인딩하던 settings class를 옛 Redis 세대와 함께 지워서 이 키는 어디에도
# 닿지 않는다. 아직 이 키를 쓰는 배포에 무엇이 대신하는지 알려 주려고 행을 지우지 않고 둔다.
deprecated_orphaned: true
removal_deadline: 2026-11-30
# source: feature-cache-consistency-contract 2026-05-22
# "negative cache 정책 = 존재하지 않는 row는 짧은 TTL(60s) 캐싱 허용"
type: duration
default: 60s
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: feature-cache-consistency-contract
validation: spring_duration_shorthand
compatibility_impact: additive
required_test: cache-contract:negative-ttl-bounded
# === 메시징 / Kafka (feature-domain-event-outbox-contract + integration-adapter-templates) ===
- name: APP_MESSAGING_BROKER
# source: messaging multi-broker redesign 2026-06-16 — 활성 broker 하나를 고른다
# (app.messaging.broker=<brokerId>). 메시징 라이브러리(dev.cakit.messaging)가 읽는다. 옛 Kafka 전용 APP_MESSAGING_KAFKA_ENABLED를
# 대신한다. 애플리케이션 bridge는 이제 읽지 않는다: 읽던 옛 KafkaSender seam은 canonical outbox와 함께
# 지웠다(2026-09-28).
type: string
# Kafka 모듈의 config/module-defaults/messaging.yml이 기본값을 등록된 유일한 broker인 kafka로 둔다.
default: kafka
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: feature-integration-adapter-templates
validation: none
compatibility_impact: behavior-change
required_test: adapter-contract:messaging-broker-selection
- name: APP_MESSAGING_PRODUCER_ID
# source: canonical messaging platform bridge 2026-09-18
# IntegrationEventPublishPort가 쓰는, 메시지를 내는 서비스의 논리 이름(명시값).
# 비었거나 없음 = canonical 플랫폼 bridge를 내놓지 않는다. 이름을 짐작하지 않는다.
# outbox relay를 포함해 모든 발행이 그 bridge를 거치므로, 메시징 모듈이 있고 켜진 상태에서 값이 비면 기동을
# 거부한다(2026-09-28 canonical outbox).
type: string
default: null
allowed_values: null
classification: public-config
required: false
required_when: APP_MESSAGING_ENABLED=true
reload_policy: restart-only
owner_branch: feature-integration-adapter-templates
validation: none
compatibility_impact: additive
required_test: adapter-contract:messaging-platform-producer-id
- name: APP_MESSAGING_KAFKA_BROKERS
# 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는 읽지 않는다.
type: csv_list
default: null
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: feature-integration-adapter-templates
validation: csv_of_host_port_when_kafka_enabled
compatibility_impact: behavior-change
required_test: adapter-contract:kafka-brokers-when-enabled
# === 알림 adapter (feature-integration-adapter-templates) ===
- name: APP_NOTIFICATION_SLACK_WEBHOOK_ENABLED
# source: R0 Slack webhook provider 스위치. app.notification.slack-webhook.enabled로 이어진다
type: boolean
default: false
allowed_values: [true, false]
classification: public-config
required: false
reload_policy: restart-only
owner_branch: feature-integration-adapter-templates
validation: boolean
compatibility_impact: behavior-change
required_test: adapter-contract:notification-slack-provider-selection
- name: APP_NOTIFICATION_GOOGLE_EMAIL_ENABLED
# source: R0 Google email provider 스위치. app.notification.google-email.enabled로 이어진다
type: boolean
default: false
allowed_values: [true, false]
classification: public-config
required: false
reload_policy: restart-only
owner_branch: feature-integration-adapter-templates
validation: boolean
compatibility_impact: behavior-change
required_test: adapter-contract:notification-email-provider-selection
# === HTTP Client 플랫폼 (app.httpclient.*) ===
#
# 여기에는 enabled 키만 등록한다. client별 설정은 index가 붙은 목록이라, application.yml에 틀로 적으면 모든
# 배포에 이름 없는 client가 생긴다. 그래서 배포와 상관없는 값이 없어 이 레지스트리에 둘 것이 없고,
# docs/httpclient/env-fields.yaml에 등록한다. 그 manifest는 HttpClientPlatformSettings에서 나오고 양쪽으로
# 강제된다: 항목이 없는 필드는 HttpClientPlatformEnvManifestTest가 실패하고, 필드가 없는 APP_HTTPCLIENT_
# 변수는 기동이 실패한다.
- name: APP_HTTPCLIENT_ENABLED
# 2026-09-25 capability 포장: 모듈은 있으면 켜진다(모듈 자신의 설정 yml이 이 키를 기본 true로 잇는다).
# false가 명시적으로 끄는 값이다. 빌드에 모듈이 없는 것이 보통의 꺼진 상태다.
# false인 동안 플랫폼 블록을 전혀 바인딩하지 않는다: 바인딩하는 자동 설정을 처리하지 않으므로 bean,
# connection pool, TLS context, 자격 증명, thread, gateway가 생기지 않고, 잘못된 HTTP client 설정이 이 배포의
# 기동을 실패시킬 수 없다.
type: boolean
default: true
allowed_values: [true, false]
classification: public-config
required: false
reload_policy: restart-only
owner_branch: httpclient-platform-activation-boundary
validation: boolean_strict
compatibility_impact: additive
required_test: httpclient-platform:off-state-zero-side-effects-and-env-manifest-parity
- name: APP_HTTPCLIENT_ROTATION_DRAIN_TIMEOUT
# 인증서를 교체한 뒤, 물러난 런타임 세대가 처리 중인 것을 마저 끝낼 수 있는 기간. 이 시간이 지나면
# 그 connection pool을 닫는다. 교체는 자료를 제자리에서 바꾸지 않고 세대를 바꾼다. pool이 옛 신원으로 맺은
# 소켓을 들고 있기 때문이다. 이 값이 옛 신원이 일을 끝낼 수 있는 시간이다.
type: duration
default: 30s
classification: public-config
required: false
reload_policy: restart-only
owner_branch: httpclient-platform-activation-boundary
compatibility_impact: additive
required_test: httpclient-platform:off-state-zero-side-effects-and-env-manifest-parity
# === Fileserver HTTP platform (app.fileserver-platform.*) ===
- name: APP_FILESERVER_PLATFORM_ENABLED
# 2026-09-25 capability 포장: 모듈은 있으면 켜진다(모듈 자신의 설정 yml이 이 키를 기본 true로 잇는다).
# false가 명시적으로 끄는 값이다. 빌드에 모듈이 없는 것이 보통의 꺼진 상태다.
# false인 동안 플랫폼 블록을 전혀 바인딩하지 않는다: 바인딩하는 자동 설정을 처리하지 않으므로 bean, route,
# thread, schema 검사, 파일 시스템 호출이 생기지 않는다.
type: boolean
default: true
allowed_values: [true, false]
classification: public-config
required: false
reload_policy: restart-only
owner_branch: fileserver-http-platform-activation-boundary
validation: boolean_strict
compatibility_impact: additive
required_test: fileserver-platform:off-state-zero-side-effects-and-env-round-trip
- name: APP_FILESERVER_PLATFORM_INSTANCE_ID
# writer lease의 소유자. 인스턴스마다 달라야 한다. 기동 관문은 기본값을 단일 인스턴스로 보고, 지원할 수
# 없는 공유 메타데이터 claim을 거부한다.
type: string
default: local-node
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: fileserver-http-platform-activation-boundary
validation: non_empty_string
compatibility_impact: additive
required_test: fileserver-platform:off-state-zero-side-effects-and-env-round-trip
- name: APP_FILESERVER_PLATFORM_DEFAULT_NAMESPACE
# namespace를 적지 않은 요청에 쓰는 namespace.
type: string
default: default
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: fileserver-http-platform-activation-boundary
validation: non_empty_string
compatibility_impact: additive
required_test: fileserver-platform:off-state-zero-side-effects-and-env-round-trip
- name: APP_FILESERVER_PLATFORM_TARGET_NAMESPACES
# copy와 move가 기본 namespace(늘 허용) 밖에 쓸 수 있는 namespace. 비면 기본 namespace만이고, 다른
# 대상은 ACCESS_DENIED다.
type: csv_list
default: null
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: fileserver-http-platform-activation-boundary
validation: storage_namespace_list
compatibility_impact: additive
required_test: fileserver-platform:off-state-zero-side-effects-and-env-round-trip
- name: APP_FILESERVER_PLATFORM_STORAGE_ROOT
# 자기 volume 위의 절대 경로. 상대 경로는 프로세스 실행 위치를 기준으로 풀리는데, 그 위치가 container와
# 테스트에서 달라서 거부한다.
type: string
default: /var/lib/backend/files
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: fileserver-http-platform-activation-boundary
validation: absolute_path_outside_forbidden_ancestors
compatibility_impact: additive
required_test: fileserver-platform:off-state-zero-side-effects-and-env-round-trip
- name: APP_FILESERVER_PLATFORM_STORAGE_PUBLISH_MODE
# atomic-move-required는 확인 과정이 원자적 이름 바꾸기를 증명하지 못하면 기동을 실패시킨다.
type: string
default: atomic-move-preferred
allowed_values: [atomic-move-required, atomic-move-preferred, metadata-pointer]
classification: public-config
required: false
reload_policy: restart-only
owner_branch: fileserver-http-platform-activation-boundary
validation: enum_in_allowed_values
compatibility_impact: additive
required_test: fileserver-platform:off-state-zero-side-effects-and-env-round-trip
- name: APP_FILESERVER_PLATFORM_STORAGE_BUFFER_SIZE
# 모든 전송의 할당을 제한한다. 그래서 메모리에 머무는 바이트가 파일 크기에 따라 늘지 않는다.
type: data_size
default: 128KB
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: fileserver-http-platform-activation-boundary
validation: between_4kb_and_8mb
compatibility_impact: additive
required_test: fileserver-platform:off-state-zero-side-effects-and-env-round-trip
- name: APP_FILESERVER_PLATFORM_STORAGE_FORBIDDEN_ROOT_ANCESTORS
# web root 아래의 저장소 root는 모든 업로드를 공개 파일로 만들고, config root 아래면 설정 변경으로
# 만든다. 둘 다 바인딩할 때 거부한다.
type: csv_list
default: /app,/etc,/usr/share/nginx/html
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: fileserver-http-platform-activation-boundary
validation: absolute_path_list
compatibility_impact: additive
required_test: fileserver-platform:off-state-zero-side-effects-and-env-round-trip
- name: APP_FILESERVER_PLATFORM_UPLOAD_MAX_FILE_SIZE
# spring.servlet.multipart.max-file-size도 이 값이 정한다. 둘에 자리표시자 하나다: servlet 상한이 더
# 작으면 Fileserver 코드(오류 매핑 포함)에 닿기 전에 업로드를 거부한다.
type: data_size
default: 100MB
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: fileserver-http-platform-activation-boundary
validation: positive_data_size
compatibility_impact: additive
required_test: fileserver-platform:off-state-zero-side-effects-and-env-round-trip
- name: APP_FILESERVER_PLATFORM_UPLOAD_MAX_REQUEST_SIZE
# Also drives spring.servlet.multipart.max-request-size.
type: data_size
default: 110MB
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: fileserver-http-platform-activation-boundary
validation: at_least_max_file_size
compatibility_impact: additive
required_test: fileserver-platform:off-state-zero-side-effects-and-env-round-trip
- name: APP_FILESERVER_PLATFORM_UPLOAD_INITIAL_RESERVATION
# 길이를 밝히지 않은 업로드에 잡아 두는 할당량.
type: data_size
default: 8MB
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: fileserver-http-platform-activation-boundary
validation: at_most_max_file_size
compatibility_impact: additive
required_test: fileserver-platform:off-state-zero-side-effects-and-env-round-trip
- name: APP_FILESERVER_PLATFORM_UPLOAD_MAX_PARTS
# multipart/batch 요청 하나의 part 수 상한.
type: integer
default: 16
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: fileserver-http-platform-activation-boundary
validation: positive_integer
compatibility_impact: additive
required_test: fileserver-platform:off-state-zero-side-effects-and-env-round-trip
- name: APP_FILESERVER_PLATFORM_UPLOAD_TTL
# 업로드 자원을 회수할 수 있게 되기까지의 수명.
type: duration
default: 1h
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: fileserver-http-platform-activation-boundary
validation: positive_duration
compatibility_impact: additive
required_test: fileserver-platform:off-state-zero-side-effects-and-env-round-trip
- name: APP_FILESERVER_PLATFORM_UPLOAD_RESERVATION_TTL
# 업로드가 끝나지 않은 할당량 예약의 수명.
type: duration
default: 24h
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: fileserver-http-platform-activation-boundary
validation: positive_duration
compatibility_impact: additive
required_test: fileserver-platform:off-state-zero-side-effects-and-env-round-trip
- name: APP_FILESERVER_PLATFORM_UPLOAD_LEASE_DURATION
# writer lease. 전송하는 동안 이 값의 1/3마다 갱신한다. 갱신하지 못한 전송은 다음 실제 쓰기 전에
# 막힌다(fenced).
type: duration
default: 30s
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: fileserver-http-platform-activation-boundary
validation: positive_duration
compatibility_impact: additive
required_test: fileserver-platform:off-state-zero-side-effects-and-env-round-trip
- name: APP_FILESERVER_PLATFORM_UPLOAD_REQUIRE_CONTENT_LENGTH
# true면 Content-Length 없는 raw 업로드를 411로 거부한다.
type: boolean
default: false
allowed_values: [true, false]
classification: public-config
required: false
reload_policy: restart-only
owner_branch: fileserver-http-platform-activation-boundary
validation: boolean_strict
compatibility_impact: additive
required_test: fileserver-platform:off-state-zero-side-effects-and-env-round-trip
- name: APP_FILESERVER_PLATFORM_DOWNLOAD_CACHE_CONTROL
# 모든 다운로드 응답에 붙이는 Cache-Control.
type: string
default: private, no-store
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: fileserver-http-platform-activation-boundary
validation: non_empty_string
compatibility_impact: additive
required_test: fileserver-platform:off-state-zero-side-effects-and-env-round-trip
- name: APP_FILESERVER_PLATFORM_DOWNLOAD_INLINE_ALLOWED
# inline 표시는 기본으로 꺼져 있다. script가 돌 수 있는 내용은 설정과 상관없이 attachment로 보낸다.
type: boolean
default: false
allowed_values: [true, false]
classification: public-config
required: false
reload_policy: restart-only
owner_branch: fileserver-http-platform-activation-boundary
validation: boolean_strict
compatibility_impact: additive
required_test: fileserver-platform:off-state-zero-side-effects-and-env-round-trip
- name: APP_FILESERVER_PLATFORM_DOWNLOAD_MAX_RANGES
# 여러 범위 요청은 켜야 쓴다. 둘 이상이면 응답이 multipart/byteranges다.
type: integer
default: 1
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: fileserver-http-platform-activation-boundary
validation: between_1_and_8
compatibility_impact: additive
required_test: fileserver-platform:off-state-zero-side-effects-and-env-round-trip
- name: APP_FILESERVER_PLATFORM_DOWNLOAD_MAX_RANGE_BYTES
# 범위 하나 profile에도 적용한다. 그래서 거의 모든 배포가 쓰는 기본 설정에서도 상한이 실제로
# 작동한다.
type: data_size
default: 100MB
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: fileserver-http-platform-activation-boundary
validation: positive_data_size
compatibility_impact: additive
required_test: fileserver-platform:off-state-zero-side-effects-and-env-round-trip
- name: APP_FILESERVER_PLATFORM_DOWNLOAD_ZERO_COPY_ENABLED
# 바이트를 복사하는 곳만 바꾼다. 헤더나 상태 코드는 바꾸지 않는다.
type: boolean
default: true
allowed_values: [true, false]
classification: public-config
required: false
reload_policy: restart-only
owner_branch: fileserver-http-platform-activation-boundary
validation: boolean_strict
compatibility_impact: additive
required_test: fileserver-platform:off-state-zero-side-effects-and-env-round-trip
- name: APP_FILESERVER_PLATFORM_DOWNLOAD_ZERO_COPY_MINIMUM_BYTES
# 이보다 작으면 syscall 준비 비용이 아끼는 것보다 크다.
type: data_size
default: 16MB
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: fileserver-http-platform-activation-boundary
validation: positive_data_size
compatibility_impact: additive
required_test: fileserver-platform:off-state-zero-side-effects-and-env-round-trip
- name: APP_FILESERVER_PLATFORM_TRANSFER_CORE_SIZE
# 크기가 정해진 전송 pool. 거절은 다시 시도할 수 있는 429가 되고, 호출자 스레드에서 돌리지 않는다.
type: integer
default: 8
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: fileserver-http-platform-activation-boundary
validation: positive_integer_at_most_max_size
compatibility_impact: additive
required_test: fileserver-platform:off-state-zero-side-effects-and-env-round-trip
- name: APP_FILESERVER_PLATFORM_TRANSFER_MAX_SIZE
# 전송 pool의 상한.
type: integer
default: 32
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: fileserver-http-platform-activation-boundary
validation: positive_integer
compatibility_impact: additive
required_test: fileserver-platform:off-state-zero-side-effects-and-env-round-trip
- name: APP_FILESERVER_PLATFORM_TRANSFER_QUEUE_CAPACITY
# 크기가 정해진 queue. 무한 queue는 빠른 429를 결국 heap 고갈로 바꾼다.
type: integer
default: 64
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: fileserver-http-platform-activation-boundary
validation: positive_integer
compatibility_impact: additive
required_test: fileserver-platform:off-state-zero-side-effects-and-env-round-trip
- name: APP_FILESERVER_PLATFORM_TRANSFER_AWAIT_SECONDS
# 종료 때 남은 일 정리 시간과 전송마다 호출자가 기다리는 시간.
type: integer
default: 300
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: fileserver-http-platform-activation-boundary
validation: positive_integer
compatibility_impact: additive
required_test: fileserver-platform:off-state-zero-side-effects-and-env-round-trip
- name: APP_FILESERVER_PLATFORM_SECURITY_ACCESS_POLICY
# 허용하는 기본값이 없다. `required`는 배포가 FileAccessPolicyPort bean을 주지 않으면 기동을
# 실패시킨다. `unenforced`는 production profile에서 거부한다.
type: string
default: required
allowed_values: [required, role-based, unenforced]
classification: public-config
required: false
reload_policy: restart-only
owner_branch: fileserver-http-platform-activation-boundary
validation: enum_in_allowed_values
compatibility_impact: additive
required_test: fileserver-platform:off-state-zero-side-effects-and-env-round-trip
- name: APP_FILESERVER_PLATFORM_SECURITY_READ_ROLES
# role 기반 정책에서 읽기 연산에 받는 role.
type: csv_list
default: ROLE_FILE_READ
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: fileserver-http-platform-activation-boundary
validation: non_empty_role_list
compatibility_impact: additive
required_test: fileserver-platform:off-state-zero-side-effects-and-env-round-trip
- name: APP_FILESERVER_PLATFORM_SECURITY_WRITE_ROLES
# role 기반 정책에서 쓰기 연산에 받는 role.
type: csv_list
default: ROLE_FILE_WRITE
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: fileserver-http-platform-activation-boundary
validation: non_empty_role_list
compatibility_impact: additive
required_test: fileserver-platform:off-state-zero-side-effects-and-env-round-trip
- name: APP_FILESERVER_PLATFORM_SECURITY_ADMIN_ROLES
# 관리 기능(management plane)에 받는 role. admin route는 application 정책만이 아니라 servlet chain에서도
# 이 role을 요구한다.
type: csv_list
default: ROLE_FILE_ADMIN
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: fileserver-http-platform-activation-boundary
validation: non_empty_role_list
compatibility_impact: additive
required_test: fileserver-platform:off-state-zero-side-effects-and-env-round-trip
- name: APP_FILESERVER_PLATFORM_VERIFICATION_TIMEOUT
# 업로드 하나의 검증 사슬 전체 예산.
type: duration
default: 5s
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: fileserver-http-platform-activation-boundary
validation: positive_duration
compatibility_impact: additive
required_test: fileserver-platform:off-state-zero-side-effects-and-env-round-trip
- name: APP_FILESERVER_PLATFORM_VERIFICATION_REQUIRE_MEDIA_TYPE_VERDICT
# true면 형식을 알아내지 못한 파일을 공개하지 않고 거부한다.
type: boolean
default: false
allowed_values: [true, false]
classification: public-config
required: false
reload_policy: restart-only
owner_branch: fileserver-http-platform-activation-boundary
validation: boolean_strict
compatibility_impact: additive
required_test: fileserver-platform:off-state-zero-side-effects-and-env-round-trip
- name: APP_FILESERVER_PLATFORM_VERIFICATION_INLINE_SAFE_PROFILE
# true면 script가 돌 수 있는 내용을 격리하지 않고 받는다. 다운로드를 신뢰하는 origin에서 inline으로
# 절대 내주지 않을 때만 안전하다.
type: boolean
default: false
allowed_values: [true, false]
classification: public-config
required: false
reload_policy: restart-only
owner_branch: fileserver-http-platform-activation-boundary
validation: boolean_strict
compatibility_impact: additive
required_test: fileserver-platform:off-state-zero-side-effects-and-env-round-trip
- name: APP_FILESERVER_PLATFORM_QUOTA_INSTANCE_UPLOAD_PERMITS
# 인스턴스마다 받는 동시 업로드 수.
type: integer
default: 16
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: fileserver-http-platform-activation-boundary
validation: positive_integer
compatibility_impact: additive
required_test: fileserver-platform:off-state-zero-side-effects-and-env-round-trip
- name: APP_FILESERVER_PLATFORM_QUOTA_SCOPE_UPLOAD_PERMITS
# 호출자(principal)마다 받는 동시 업로드 수.
type: integer
default: 4
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: fileserver-http-platform-activation-boundary
validation: positive_integer_at_most_instance_permits
compatibility_impact: additive
required_test: fileserver-platform:off-state-zero-side-effects-and-env-round-trip
- name: APP_FILESERVER_PLATFORM_QUOTA_DIRECT_DOWNLOAD_PERMITS
# 인스턴스마다 받는 동시 직접 다운로드 수.
type: integer
default: 64
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: fileserver-http-platform-activation-boundary
validation: positive_integer
compatibility_impact: additive
required_test: fileserver-platform:off-state-zero-side-effects-and-env-round-trip
- name: APP_FILESERVER_PLATFORM_QUOTA_SOFT_HIGH_WATER
# 새 업로드를 덜어내기 시작하는 저장소 사용 비율.
type: string
default: 0.70
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: fileserver-http-platform-activation-boundary
validation: fraction_below_hard_high_water
compatibility_impact: additive
required_test: fileserver-platform:off-state-zero-side-effects-and-env-round-trip
- name: APP_FILESERVER_PLATFORM_QUOTA_HARD_HIGH_WATER
# 모든 업로드를 거부하는 저장소 사용 비율.
type: string
default: 0.85
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: fileserver-http-platform-activation-boundary
validation: fraction_within_zero_and_one
compatibility_impact: additive
required_test: fileserver-platform:off-state-zero-side-effects-and-env-round-trip
- name: APP_FILESERVER_PLATFORM_QUOTA_NAMESPACE_LIMIT
# namespace 하나가 가질 수 있는 최대 바이트(살아 있는 예약과 확정된 사용량의 합). 비면 무제한이다. 정한
# 상한을 넘는 예약은 QUOTA_EXCEEDED(413)로 거부한다.
type: data_size
default: null
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: fileserver-http-platform-activation-boundary
validation: positive_data_size_when_set
compatibility_impact: additive
required_test: fileserver-platform:off-state-zero-side-effects-and-env-round-trip
- name: APP_FILESERVER_PLATFORM_ADMIN_ENABLED
# 관리 기능(management plane). 데이터 기능과 따로 정한다. APP_FILESERVER_PLATFORM_ENABLED도 켜야 한다:
# 이 값만 켜면 이제 bean 그래프를 반쯤 만들지 않고 아무 일도 하지 않는다.
type: boolean
default: false
allowed_values: [true, false]
classification: public-config
required: false
reload_policy: restart-only
owner_branch: fileserver-http-platform-activation-boundary
validation: boolean_strict
compatibility_impact: additive
required_test: fileserver-platform:off-state-zero-side-effects-and-env-round-trip
- name: APP_FILESERVER_PLATFORM_ADMIN_ORPHAN_MINIMUM_AGE
# 참조가 없는 객체가 scan에 이름이 오르기까지 있어야 하는 기간. 그보다 어린 것은 버려진 것이 아니라
# 확정하는 중이라고 본다.
type: duration
default: 1h
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: fileserver-http-platform-activation-boundary
validation: positive_duration
compatibility_impact: additive
required_test: fileserver-platform:off-state-zero-side-effects-and-env-round-trip
- name: APP_FILESERVER_PLATFORM_CLEANUP_ENABLED
# 뒤에서 도는 회수. 기본으로 켜져 있다: 없으면 취소·만료된 staging과 거부·삭제된 내용이 volume에 남아,
# 결국 높은 수위(high-water mark)가 업로드를 막는다. 끄면 기동 때 경고를 남긴다(다른 노드나 관리 기능이
# 대신 회수해야 한다).
type: boolean
default: true
allowed_values: [true, false]
classification: public-config
required: false
reload_policy: restart-only
owner_branch: fileserver-http-platform-activation-boundary
validation: boolean_strict
compatibility_impact: additive
required_test: fileserver-platform:off-state-zero-side-effects-and-env-round-trip
- name: APP_FILESERVER_PLATFORM_CLEANUP_INTERVAL
# batch 사이의 고정 지연. 일정의 유일한 주인이다. 두 번째 기본값을 가진 @Scheduled 자리표시자를 두지
# 않는다.
type: duration
default: 60s
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: fileserver-http-platform-activation-boundary
validation: positive_duration
compatibility_impact: additive
required_test: fileserver-platform:off-state-zero-side-effects-and-env-round-trip
- name: APP_FILESERVER_PLATFORM_CLEANUP_MAX_ITEMS
# batch 하나의 항목 수 상한. 밀린 일이 scheduler를 독차지하지 못하게 한다.
type: integer
default: 100
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: fileserver-http-platform-activation-boundary
validation: positive_integer
compatibility_impact: additive
required_test: fileserver-platform:off-state-zero-side-effects-and-env-round-trip
- name: APP_FILESERVER_PLATFORM_CLEANUP_MAX_BYTES
# batch 하나의 바이트 상한.
type: data_size
default: 1GB
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: fileserver-http-platform-activation-boundary
validation: positive_data_size
compatibility_impact: additive
required_test: fileserver-platform:off-state-zero-side-effects-and-env-round-trip
- name: APP_FILESERVER_PLATFORM_CLEANUP_RETRY_BACKOFF
# 실패한 정리 항목을 다시 시도하기 전 지연.
type: duration
default: 5m
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: fileserver-http-platform-activation-boundary
validation: positive_duration
compatibility_impact: additive
required_test: fileserver-platform:off-state-zero-side-effects-and-env-round-trip
- name: APP_FILESERVER_PLATFORM_TUS_ENABLED
# tus 1.0. APP_FILESERVER_PLATFORM_ENABLED도 켜야 한다.
type: boolean
default: false
allowed_values: [true, false]
classification: public-config
required: false
reload_policy: restart-only
owner_branch: fileserver-http-platform-activation-boundary
validation: boolean_strict
compatibility_impact: additive
required_test: fileserver-platform:off-state-zero-side-effects-and-env-round-trip
- name: APP_FILESERVER_PLATFORM_HTTPBIS_DRAFT12_ENABLED
# 승인되지 않은 초안이라 계약이 예고 없이 바뀔 수 있다. APP_FILESERVER_PLATFORM_ENABLED도 켜야 한다.
type: boolean
default: false
allowed_values: [true, false]
classification: public-config
required: false
reload_policy: restart-only
owner_branch: fileserver-http-platform-activation-boundary
validation: boolean_strict
compatibility_impact: additive
required_test: fileserver-platform:off-state-zero-side-effects-and-env-round-trip
- name: APP_FILESERVER_PLATFORM_NGINX_ENABLED
# 앞단 proxy에 맡기기. 기동할 때 내부 매핑을 실제로 써 보고 확인한다. proxy가 풀지 못하는 매핑은 빈
# 본문으로 200을 답하므로, 그대로 두지 않고 실패시킨다(fail closed).
type: boolean
default: false
allowed_values: [true, false]
classification: public-config
required: false
reload_policy: restart-only
owner_branch: fileserver-http-platform-activation-boundary
validation: boolean_strict
compatibility_impact: additive
required_test: fileserver-platform:off-state-zero-side-effects-and-env-round-trip
- name: APP_FILESERVER_PLATFORM_NGINX_INTERNAL_PREFIX
# proxy가 저장소 root로 풀어 주는 내부 위치.
type: string
default: /__files/
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: fileserver-http-platform-activation-boundary
validation: internal_uri_prefix
compatibility_impact: additive
required_test: fileserver-platform:off-state-zero-side-effects-and-env-round-trip
- name: APP_FILESERVER_PLATFORM_NGINX_OBJECT_SUFFIX
# 내부 URI에서 shard로 나눈 객체 key 뒤에 붙이는 접미사.
type: string
default: .bin
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: fileserver-http-platform-activation-boundary
validation: non_empty_string
compatibility_impact: additive
required_test: fileserver-platform:off-state-zero-side-effects-and-env-round-trip
- name: APP_FILESERVER_PLATFORM_NGINX_MINIMUM_SIZE
# 이보다 작은 요청은 맡기지 않고 애플리케이션이 직접 내준다.
type: data_size
default: 16MB
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: fileserver-http-platform-activation-boundary
validation: positive_data_size
compatibility_impact: additive
required_test: fileserver-platform:off-state-zero-side-effects-and-env-round-trip
- name: APP_FILESERVER_PLATFORM_OBSERVABILITY_METRICS_ENABLED
# false면 metrics port도 fingerprint도 만들지 않고 key도 요구하지 않는다.
type: boolean
default: true
allowed_values: [true, false]
classification: public-config
required: false
reload_policy: restart-only
owner_branch: fileserver-http-platform-activation-boundary
validation: boolean_strict
compatibility_impact: additive
required_test: fileserver-platform:off-state-zero-side-effects-and-env-round-trip
- name: APP_FILESERVER_PLATFORM_OBSERVABILITY_FINGERPRINT_KEY
# 파일 식별자에 거는 key 있는 HMAC. 셀 수 있는 식별자의 key 없는 digest는 되돌릴 수 있으므로, metrics가
# 켜졌는데 이 값이 비면 기동이 실패한다.
type: string
default: null
allowed_values: null
classification: secret
required: false
reload_policy: restart-only
owner_branch: fileserver-http-platform-activation-boundary
validation: non_empty_when_metrics_enabled
compatibility_impact: additive
required_test: fileserver-platform:off-state-zero-side-effects-and-env-round-trip
# === 파일 / 업로드 (feature-file-resource-handling-contract) ===
- name: APP_ASYNC_EXECUTOR_CORE_SIZE
# source: feature-background-job-async-contract 2026-05-22
# "executor pool sizing default = core=10, max=50, queue=200"
type: int
default: 10
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: feature-background-job-async-contract
validation: positive_int
compatibility_impact: behavior-change
required_test: async-contract:executor-core-size
- name: APP_ASYNC_EXECUTOR_MAX_SIZE
# source: feature-background-job-async-contract 2026-05-22
# "core=10, max=50, queue=200"
type: int
default: 50
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: feature-background-job-async-contract
validation: positive_int_ge_core
compatibility_impact: behavior-change
required_test: async-contract:executor-max-size
- name: APP_ASYNC_EXECUTOR_QUEUE_CAPACITY
# source: feature-background-job-async-contract 2026-05-22
# "queue=200" + "unbounded queue forbidden"
type: int
default: 200
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: feature-background-job-async-contract
validation: positive_int_bounded
compatibility_impact: behavior-change
required_test: async-contract:executor-queue-bounded
# === 알림 전달 플랫폼 (NTF-025 — 설정 표면) ===
# application.yml에 app.notification.platform 트리가 있고 기본으로 꺼져 있다. 모든 키가 같은 줄에 기본값을
# 가지므로, 플랫폼을 끈 배포는 아무것도 주지 않아도 된다. 참고: docs/notification/configuration-reference.md.
- name: APP_PERSISTENCE_JPA_ENABLED
# 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 셋만 막았다.
type: boolean
default: true
allowed_values: [true, false]
classification: public-config
required: false
reload_policy: restart-only
owner_branch: worktree-five-adapter-activation
validation: boolean
compatibility_impact: behavior-change
required_test: adapter-contract:persistence-jpa-disabled-safe
- name: APP_JPA_HIBERNATE_BATCH_SIZE
property: spring.jpa.properties.hibernate.jdbc.batch_size
owner_module: adapter-outbound-persistence-jpa
type: integer
default: 50
allowed_values: null
classification: public-config
required: false
required_when: APP_PERSISTENCE_JPA_ENABLED=true
reload_policy: restart-only
owner_branch: 2026-09-22-persistence-jpa-review-remediation
validation: non_negative_integer
compatibility_impact: behavior-change
required_test: jpa-contract:hibernate-runtime-settings
- name: APP_JPA_HIBERNATE_ORDER_INSERTS
property: spring.jpa.properties.hibernate.order_inserts
owner_module: adapter-outbound-persistence-jpa
type: boolean
default: true
allowed_values: [true, false]
classification: public-config
required: false
required_when: APP_PERSISTENCE_JPA_ENABLED=true
reload_policy: restart-only
owner_branch: 2026-09-22-persistence-jpa-review-remediation
validation: boolean_strict
compatibility_impact: behavior-change
required_test: jpa-contract:hibernate-runtime-settings
- name: APP_JPA_HIBERNATE_ORDER_UPDATES
property: spring.jpa.properties.hibernate.order_updates
owner_module: adapter-outbound-persistence-jpa
type: boolean
default: true
allowed_values: [true, false]
classification: public-config
required: false
required_when: APP_PERSISTENCE_JPA_ENABLED=true
reload_policy: restart-only
owner_branch: 2026-09-22-persistence-jpa-review-remediation
validation: boolean_strict
compatibility_impact: behavior-change
required_test: jpa-contract:hibernate-runtime-settings
- name: APP_JPA_HIBERNATE_DEFAULT_BATCH_FETCH_SIZE
property: spring.jpa.properties.hibernate.default_batch_fetch_size
owner_module: adapter-outbound-persistence-jpa
type: integer
default: 0
allowed_values: null
classification: public-config
required: false
required_when: APP_PERSISTENCE_JPA_ENABLED=true
reload_policy: restart-only
owner_branch: 2026-09-22-persistence-jpa-review-remediation
validation: non_negative_integer
compatibility_impact: additive
required_test: jpa-contract:hibernate-runtime-settings
- name: APP_JPA_HIBERNATE_GENERATE_STATISTICS
property: spring.jpa.properties.hibernate.generate_statistics
owner_module: adapter-outbound-persistence-jpa
type: boolean
default: false
allowed_values: [true, false]
classification: public-config
required: false
required_when: APP_PERSISTENCE_JPA_ENABLED=true
reload_policy: restart-only
owner_branch: 2026-09-22-persistence-jpa-review-remediation
validation: boolean_strict
compatibility_impact: additive
required_test: jpa-contract:hibernate-runtime-settings
- name: APP_PERSISTENCE_MONGO_ENABLED
# 2026-09-25 capability 포장: 모듈은 있으면 켜진다(모듈 자신의 설정 yml이 이 키를 기본 true로 잇는다).
# false가 명시적으로 끄는 값이다. 빌드에 모듈이 없는 것이 보통의 꺼진 상태다.
# source: five-adapter-runtime-remediation §5.1 — MongoDB 영속성 켜고 끄기.
type: boolean
default: true
allowed_values: [true, false]
classification: public-config
required: false
reload_policy: restart-only
owner_branch: worktree-five-adapter-activation
validation: boolean
compatibility_impact: behavior-change
required_test: adapter-contract:persistence-mongo-disabled-safe
- name: APP_PERSISTENCE_MONGO_ACTIVE_PROFILE
# source: five-adapter-runtime-remediation §5.1 — Mongo profile을 정확히 하나 고른다. 런타임은 sync client
# 하나와 pool 하나를 만든다. map에 있지만 고르지 않은 profile은 비밀을 풀지도, client를 만들지도 않는다.
type: string
default: ""
classification: public-config
required: false
required_when: APP_PERSISTENCE_MONGO_ENABLED=true
reload_policy: restart-only
owner_branch: worktree-five-adapter-activation
validation: nonblank-when-required
compatibility_impact: behavior-change
required_test: adapter-contract:persistence-mongo-active-profile
- name: SPRING_MONGODB_URI
# source: persistence-mongo techlead review C1. Spring Boot 4는 이 자체 키를 spring.mongodb.uri로 쓴다.
# 유효한 연결 출처 둘 중 하나다. 다른 하나는 고른 typed profile의 uri-secret을 MongoCredentialResolver로 푼
# 값이다.
property: spring.mongodb.uri
owner_module: adapter-outbound-persistence-mongo
type: string
default: null
allowed_values: null
classification: sensitive-config
required: false
required_when: app.persistence-mongo.enabled=true이고 활성 profile의 uri-secret이 없을 때
reload_policy: restart-only
owner_branch: persistence-mongo-runtime-remediation
validation: mongodb_uri_when_selected_as_connection_source
compatibility_impact: additive
required_test: adapter-contract:persistence-mongo-connection-source
- name: APP_MESSAGING_ENABLED
# 2026-09-25 capability 포장: 모듈은 있으면 켜진다(모듈 자신의 설정 yml이 이 키를 기본 true로 잇는다).
# false가 명시적으로 끄는 값이다. 빌드에 모듈이 없는 것이 보통의 꺼진 상태다.
# source: five-adapter-runtime-remediation §5.1 — broker 발행 켜고 끄기.
# APP_MESSAGING_BROKER는 어느 transport인지만 고르고, 이제 사실상의 스위치가 아니다.
type: boolean
default: true
allowed_values: [true, false]
classification: public-config
required: false
reload_policy: restart-only
owner_branch: worktree-five-adapter-activation
validation: boolean
compatibility_impact: behavior-change
required_test: adapter-contract:messaging-disabled-safe
# === 선택형 WebSocket 빌드 조립 계약 ===
# 고른 조립에 websocket leaf가 있으면 이 키들이 app.websocket.*로 바로 이어진다. 기본 bootJar에는 그 leaf가
# 없다. 있을지는 빌드할 때 정하고, 이 행들이 런타임에 들어 있다는 뜻은 아니다.
- name: APP_WEBSOCKET_ENABLED
# 2026-09-25 capability 포장: 모듈은 있으면 켜진다(모듈 자신의 설정 yml이 이 키를
# 기본 true로 잇는다). false가 명시적으로 끄는 값이다. 빌드에 모듈이 없는 것이
# 보통의 꺼진 상태다.
property: app.websocket.enabled
owner_module: adapter-inbound-websocket
type: boolean
default: true
allowed_values: [true, false]
classification: public-config
required: false
reload_policy: restart-only
owner_branch: 2026-09-20-inbound-realtime-review-remediation
validation: boolean_strict
compatibility_impact: behavior-change
required_test: websocket-contract:canonical-property-namespace
- name: APP_WEBSOCKET_ENDPOINT
property: app.websocket.endpoint
owner_module: adapter-inbound-websocket
type: string
default: /ws
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: 2026-09-20-inbound-realtime-review-remediation
validation: absolute_normalized_path
compatibility_impact: behavior-change
required_test: websocket-contract:canonical-property-namespace
- name: APP_WEBSOCKET_ALLOWED_ORIGINS
property: app.websocket.allowed-origins
owner_module: adapter-inbound-websocket
type: csv
default: http://localhost:3000
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: 2026-09-20-inbound-realtime-review-remediation
validation: explicit_http_origins
compatibility_impact: behavior-change
required_test: websocket-contract:canonical-property-namespace
- name: APP_WEBSOCKET_BROADCAST_DESTINATION
property: app.websocket.broadcast-destination
owner_module: adapter-inbound-websocket
type: string
default: /topic/events
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: 2026-09-20-inbound-realtime-review-remediation
validation: normalized_topic_path
compatibility_impact: behavior-change
required_test: websocket-contract:canonical-property-namespace
- name: APP_WEBSOCKET_CHANNEL_QUEUE_CAPACITY
property: app.websocket.channel-queue-capacity
owner_module: adapter-inbound-websocket
type: integer
default: 10000
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: refactor/review-followup
validation: positive_integer
compatibility_impact: behavior-change
required_test: websocket-contract:canonical-property-namespace
- name: APP_WEBSOCKET_MESSAGE_SIZE_LIMIT
# Spring 자체 기본값을 명시했다(review 03-06). 최대 2147483647 bytes.
property: app.websocket.message-size-limit
owner_module: adapter-inbound-websocket
type: data_size
default: 64KB
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: 2026-11-01-maturity-review-round2
validation: positive_data_size
compatibility_impact: additive
required_test: websocket-contract:canonical-property-namespace
- name: APP_WEBSOCKET_SEND_BUFFER_SIZE_LIMIT
# Spring 자체 기본값을 명시했다(review 03-06). 최대 2147483647 bytes.
property: app.websocket.send-buffer-size-limit
owner_module: adapter-inbound-websocket
type: data_size
default: 512KB
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: 2026-11-01-maturity-review-round2
validation: positive_data_size
compatibility_impact: additive
required_test: websocket-contract:canonical-property-namespace
- name: APP_WEBSOCKET_SEND_TIME_LIMIT
# Spring 자체 기본값을 명시했다(review 03-06). 최대 2147483647 ms.
property: app.websocket.send-time-limit
owner_module: adapter-inbound-websocket
type: duration
default: 10s
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: 2026-11-01-maturity-review-round2
validation: positive_duration
compatibility_impact: additive
required_test: websocket-contract:canonical-property-namespace
- name: APP_WEBSOCKET_TIME_TO_FIRST_MESSAGE
# Spring 자체 기본값을 명시했다(review 03-06). 최대 2147483647 ms.
property: app.websocket.time-to-first-message
owner_module: adapter-inbound-websocket
type: duration
default: 60s
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: 2026-11-01-maturity-review-round2
validation: positive_duration
compatibility_impact: additive
required_test: websocket-contract:canonical-property-namespace
- name: APP_WEBSOCKET_MAX_CONNECTIONS
# 노드마다의 새 STOMP session 상한(review 03-06). 그 다음 session은 1013으로 닫는다. 1000 x 512KB 송신
# 버퍼라 최악의 송신 버퍼링이 512 MiB 근처로 묶인다.
property: app.websocket.max-connections
owner_module: adapter-inbound-websocket
type: integer
default: 1000
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: 2026-11-01-maturity-review-round2
validation: positive_integer
compatibility_impact: behavior-change
required_test: websocket-contract:canonical-property-namespace
- name: APP_OBJECTSTORAGE_ENABLED
# 2026-11-03 RR-06-07: Compose smoke wrapper가 객체 저장소와 상관없는 모든 lane에 거는 명시적 끄기 값.
# relaxed binding으로 바인딩되면서 어느 레지스트리에도 없어, env 계약이 읽히지 않는 이름과 구별하지 못했다.
# 모듈은 있으면 켜진다. 빌드에 모듈이 없는 것이 보통의 꺼진 상태다.
property: app.object-storage.enabled
owner_module: adapter-outbound-objectstorage
type: boolean
default: true
allowed_values: [true, false]
classification: public-config
required: false
reload_policy: restart-only
owner_branch: refactor/maturity-review-2026-11
validation: boolean
compatibility_impact: none
required_test: off-state-zero-side-effects-and-env-round-trip
- name: APP_GRPC_SERVER_ENABLED
# 2026-11-03 RR-06-07: Compose lane이 거는 gRPC 서버의 명시적 끄기 값(아무도 읽지 않던
# CASKELETON_GRPC_ENABLED를 대신했다). 모듈은 있으면 켜진다. 빌드에 모듈이 없는 것이 보통의 꺼진
# 상태다.
property: app.grpc.server.enabled
owner_module: adapter-inbound-grpc
type: boolean
default: true
allowed_values: [true, false]
classification: public-config
required: false
reload_policy: restart-only
owner_branch: refactor/maturity-review-2026-11
validation: boolean
compatibility_impact: none
required_test: off-state-zero-side-effects-and-env-round-trip
- name: APP_GRPC_SERVER_ALLOW_INSECURE_LOCAL
# 2026-11-12 등록: 지금 구현이 여는 listener는 loopback plaintext뿐이라, 모듈을 켠 배포는 이 값을 true로
# 명시해야 기동한다(GrpcServerSettings, grpc README 「켜기와 끄기」). registry에 없어 운영자가 찾을 곳이 없었다.
property: app.grpc.server.allow-insecure-local
owner_module: adapter-inbound-grpc
type: boolean
default: false
allowed_values: [true, false]
classification: security-relevant
required: false
required_when: gRPC 모듈이 런타임에 있고 app.grpc.server.enabled가 true일 때
reload_policy: restart-only
owner_branch: refactor/maturity-review-2026-11
validation: boolean
compatibility_impact: none
required_test: adapter-contract:grpc-plaintext-requires-explicit-opt-in
- name: APP_GRAPHQL_ENABLED
# 2026-09-25 capability 포장: 모듈은 있으면 켜진다(모듈 자신의 설정 yml이 이 키를 기본 true로 잇는다).
# false가 명시적으로 끄는 값이다. 빌드에 모듈이 없는 것이 보통의 꺼진 상태다.
# source: five-adapter-runtime-remediation §5.1 — GraphQL transport 켜고 끄기.
# false면 /graphql route를 내지 않는다. Spring GraphQL이 스스로 내는 route도 포함이다.
type: boolean
default: true
allowed_values: [true, false]
classification: public-config
required: false
reload_policy: restart-only
owner_branch: worktree-five-adapter-activation
validation: boolean
compatibility_impact: behavior-change
required_test: adapter-contract:graphql-disabled-safe
- name: APP_GRAPHQL_DEPLOYMENT_MODE
# 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
default: ""
allowed_values: [LOCAL, DEV, PRODUCTION_INTERNAL, PRODUCTION_PUBLIC]
classification: public-config
required: false
required_when: APP_GRAPHQL_ENABLED=true
reload_policy: restart-only
owner_branch: worktree-five-adapter-activation
validation: enum
compatibility_impact: behavior-change
required_test: adapter-contract:graphql-deployment-mode
- name: APP_GRAPHQL_VALIDATION_POLICY_VERSION
property: app.graphql.validation-policy-version
owner_module: adapter-inbound-graphql
type: string
default: v1
allowed_values: null
classification: public-config
required: false
required_when: APP_GRAPHQL_ENABLED=true
reload_policy: restart-only
owner_branch: 2026-09-20-inbound-graphql-review-remediation
validation: non_empty_string
compatibility_impact: additive
required_test: graphql-contract:wired-operator-settings
- name: APP_GRAPHQL_OBSERVED_OPERATION_NAMES
property: app.graphql.observed-operation-names
owner_module: adapter-inbound-graphql
type: csv
default: ""
allowed_values: null
classification: public-config
required: false
required_when: APP_GRAPHQL_ENABLED=true
reload_policy: restart-only
owner_branch: 2026-09-20-inbound-graphql-review-remediation
validation: csv
compatibility_impact: additive
required_test: graphql-contract:wired-operator-settings
- name: APP_GRAPHQL_GRAPHIQL_ENABLED
property: app.graphql.console.graphiql-enabled
owner_module: adapter-inbound-graphql
type: boolean
default: false
allowed_values: [true, false]
classification: public-config
required: false
required_when: APP_GRAPHQL_ENABLED=true
reload_policy: restart-only
owner_branch: 2026-09-20-inbound-graphql-review-remediation
validation: boolean_strict
compatibility_impact: additive
required_test: graphql-contract:wired-operator-settings
- name: APP_GRAPHQL_INTROSPECTION_ENABLED
property: app.graphql.console.introspection-enabled
owner_module: adapter-inbound-graphql
type: boolean
default: false
allowed_values: [true, false]
classification: public-config
required: false
required_when: APP_GRAPHQL_ENABLED=true
reload_policy: restart-only
owner_branch: 2026-09-20-inbound-graphql-review-remediation
validation: boolean_strict
compatibility_impact: additive
required_test: graphql-contract:wired-operator-settings
- name: APP_GRAPHQL_MAXIMUM_PAGE_SIZE
property: app.graphql.limits.maximum-page-size
owner_module: adapter-inbound-graphql
type: integer
default: 100
allowed_values: null
classification: public-config
required: false
required_when: APP_GRAPHQL_ENABLED=true
reload_policy: restart-only
owner_branch: 2026-09-20-inbound-graphql-review-remediation
validation: positive_integer
compatibility_impact: additive
required_test: graphql-contract:wired-operator-settings
- name: APP_GRAPHQL_MAXIMUM_COMPLEXITY
property: app.graphql.limits.maximum-complexity
owner_module: adapter-inbound-graphql
type: integer
default: 10000
allowed_values: null
classification: public-config
required: false
required_when: APP_GRAPHQL_ENABLED=true
reload_policy: restart-only
owner_branch: 2026-09-20-inbound-graphql-review-remediation
validation: positive_integer
compatibility_impact: additive
required_test: graphql-contract:wired-operator-settings
- name: APP_GRAPHQL_PREPARSED_CACHE_ENTRIES
property: app.graphql.limits.preparsed-cache-entries
owner_module: adapter-inbound-graphql
type: integer
default: 1000
allowed_values: null
classification: public-config
required: false
required_when: APP_GRAPHQL_ENABLED=true
reload_policy: restart-only
owner_branch: 2026-09-20-inbound-graphql-review-remediation
validation: positive_integer
compatibility_impact: additive
required_test: graphql-contract:wired-operator-settings
- name: APP_GRAPHQL_PREPARSED_CACHE_WEIGHT
property: app.graphql.limits.preparsed-cache-weight
owner_module: adapter-inbound-graphql
type: integer
default: 10000000
allowed_values: null
classification: public-config
required: false
required_when: APP_GRAPHQL_ENABLED=true
reload_policy: restart-only
owner_branch: 2026-09-20-inbound-graphql-review-remediation
validation: positive_integer
compatibility_impact: additive
required_test: graphql-contract:wired-operator-settings
- name: APP_GRAPHQL_PREPARSED_CACHE_EXPIRE_AFTER_ACCESS
property: app.graphql.limits.preparsed-cache-expire-after-access
owner_module: adapter-inbound-graphql
type: duration
default: 30m
allowed_values: null
classification: public-config
required: false
required_when: APP_GRAPHQL_ENABLED=true
reload_policy: restart-only
owner_branch: 2026-09-20-inbound-graphql-review-remediation
validation: positive_duration
compatibility_impact: additive
required_test: graphql-contract:wired-operator-settings
- name: APP_GRAPHQL_PER_PARENT_FETCH_WARNING_THRESHOLD
property: app.graphql.limits.per-parent-fetch-warning-threshold
owner_module: adapter-inbound-graphql
type: integer
default: 10
allowed_values: null
classification: public-config
required: false
required_when: APP_GRAPHQL_ENABLED=true
reload_policy: restart-only
owner_branch: 2026-11-01-maturity-review-round2
validation: positive_integer
compatibility_impact: additive
required_test: graphql-contract:wired-operator-settings
- name: APP_OUTBOX_ENABLED
# source: five-adapter-runtime-remediation §6.1 JPA-INT-004 — outbox 기능 스위치.
# 아래 relay-enabled는 scheduler만 시작한다. 둘을 섞으면 relay를 끈 배포도 DB 없는 런타임에는 없는 store
# port 위에 outbox metrics를 조립했다.
type: boolean
default: false
allowed_values: [true, false]
classification: public-config
required: false
reload_policy: restart-only
owner_branch: worktree-five-adapter-activation
validation: boolean
compatibility_impact: behavior-change
required_test: adapter-contract:outbox-capability-disabled-safe
- name: APP_OUTBOX_RELAY_ENABLED
# 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
default: false
allowed_values: [true, false]
classification: public-config
required: false
reload_policy: restart-only
owner_branch: worktree-five-adapter-activation
validation: boolean
compatibility_impact: behavior-change
required_test: adapter-contract:outbox-relay-dependency
- name: APP_NOTIFICATION_PLATFORM_ENABLED
# 2026-09-25 capability 포장: notification-platform 모듈은 있으면 켜진다(모듈의
# config/module-defaults/notification.yml이 이 키를 기본 true로 잇는다). false가 명시적으로 끄는 값이고
# 아무것도 바인딩하지 않는다. 빌드에 모듈이 없는 것이 보통의 꺼진 상태다.
# source: NTF-025.
type: boolean
default: true
allowed_values: [true, false]
classification: public-config
required: false
reload_policy: restart-only
owner_branch: worktree-notification-platform
validation: boolean
compatibility_impact: behavior-change
required_test: adapter-contract:notification-platform-disabled-safe
- name: APP_NOTIFICATION_PLATFORM_DEFAULT_LOCALE
# I-6b: locale을 적지 않은 제출을 그릴 locale. 접수 use case가 적용한다. 예전에는 HTTP controller가 host
# JVM의 Locale.getDefault()를 골라, 같은 요청이 노드마다 다르게 그려졌다.
type: string
default: ko-KR
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: worktree-notification-platform
validation: none
compatibility_impact: behavior-change
required_test: application-contract:notification-default-locale
- name: APP_NOTIFICATION_PLATFORM_CONTACT_ENCRYPTION_KEY
# source: NTF-INT-007 — 저장된 수신자 연락처(주소와 전화번호)를 암호화한다.
# 행 전체는 secrets-classification.yaml이 가진다. 바인딩 위치:
# app.notification.platform.secrets.contact-encryption-key. 플랫폼이 기동할 때 값을 풀고,
# 비었거나 32바이트보다 짧거나 다른 용도의 key와 같으면 기동을 거부한다.
type: string
default: null
allowed_values: null
classification: secret
required: false
reload_policy: restart-only
owner_branch: worktree-notification-platform
validation: base64_at_least_32_bytes_and_distinct_per_purpose
compatibility_impact: behavior-change
required_test: adapter-contract:notification-secret-material-required
- name: APP_NOTIFICATION_PLATFORM_CONTACT_LOOKUP_HMAC_KEY
# source: NTF-INT-007 — 연락처의 blind index. 조회에 평문이 필요 없게 한다.
# 행 전체는 secrets-classification.yaml이 가진다. 바인딩 위치:
# app.notification.platform.secrets.contact-lookup-hmac-key. 플랫폼이 기동할 때 값을 풀고,
# 비었거나 32바이트보다 짧거나 다른 용도의 key와 같으면 기동을 거부한다.
type: string
default: null
allowed_values: null
classification: secret
required: false
reload_policy: restart-only
owner_branch: worktree-notification-platform
validation: base64_at_least_32_bytes_and_distinct_per_purpose
compatibility_impact: behavior-change
required_test: adapter-contract:notification-secret-material-required
- name: APP_NOTIFICATION_PLATFORM_CALLBACK_SIGNING_KEY
# source: NTF-INT-007 — provider가 전달 결과를 보내는 callback URL에 서명한다.
# 행 전체는 secrets-classification.yaml이 가진다. 바인딩 위치:
# app.notification.platform.secrets.callback-signing-key. 플랫폼이 기동할 때 값을 풀고,
# 비었거나 32바이트보다 짧거나 다른 용도의 key와 같으면 기동을 거부한다.
type: string
default: null
allowed_values: null
classification: secret
required: false
reload_policy: restart-only
owner_branch: worktree-notification-platform
validation: base64_at_least_32_bytes_and_distinct_per_purpose
compatibility_impact: behavior-change
required_test: adapter-contract:notification-secret-material-required
- name: APP_NOTIFICATION_PLATFORM_PROVIDER_CREDENTIAL_KEY
# source: NTF-INT-007 — 저장된 provider 자격 증명(그 자체가 비밀)을 암호화한다.
# 행 전체는 secrets-classification.yaml이 가진다. 바인딩 위치:
# app.notification.platform.secrets.provider-credential-key. 플랫폼이 기동할 때 값을 풀고,
# 비었거나 32바이트보다 짧거나 다른 용도의 key와 같으면 기동을 거부한다.
type: string
default: null
allowed_values: null
classification: secret
required: false
reload_policy: restart-only
owner_branch: worktree-notification-platform
validation: base64_at_least_32_bytes_and_distinct_per_purpose
compatibility_impact: behavior-change
required_test: adapter-contract:notification-secret-material-required
- name: APP_NOTIFICATION_PLATFORM_PAYLOAD_ENCRYPTION_KEY
# source: NTF-INT-007 — 저장된 알림 변수와 보관한 callback 본문을 암호화한다.
# 행 전체는 secrets-classification.yaml이 가진다. 바인딩 위치:
# app.notification.platform.secrets.payload-encryption-key. 플랫폼이 기동할 때 값을 풀고,
# 비었거나 32바이트보다 짧거나 다른 용도의 key와 같으면 기동을 거부한다.
type: string
default: null
allowed_values: null
classification: secret
required: false
reload_policy: restart-only
owner_branch: worktree-notification-platform
validation: base64_at_least_32_bytes_and_distinct_per_purpose
compatibility_impact: behavior-change
required_test: adapter-contract:notification-secret-material-required
- name: APP_NOTIFICATION_PLATFORM_PROVIDER_REQUEST_LOOKUP_HMAC_KEY
# source: NTF-INT-007 — provider 쪽 식별자인 provider request id의 key 있는 hash.
# 행 전체는 secrets-classification.yaml이 가진다. 바인딩 위치:
# app.notification.platform.secrets.provider-request-lookup-hmac-key. 플랫폼이 기동할 때 값을 풀고,
# 비었거나 32바이트보다 짧거나 다른 용도의 key와 같으면 기동을 거부한다.
type: string
default: null
allowed_values: null
classification: secret
required: false
reload_policy: restart-only
owner_branch: worktree-notification-platform
validation: base64_at_least_32_bytes_and_distinct_per_purpose
compatibility_impact: behavior-change
required_test: adapter-contract:notification-secret-material-required
- name: APP_NOTIFICATION_PLATFORM_CALLBACK_FINGERPRINT_HMAC_KEY
# source: NTF-INT-007 — callback 본문의 key 있는 fingerprint. replay를 찾는 데 쓴다.
# 행 전체는 secrets-classification.yaml이 가진다. 바인딩 위치:
# app.notification.platform.secrets.callback-fingerprint-hmac-key. 플랫폼이 기동할 때 값을 풀고,
# 비었거나 32바이트보다 짧거나 다른 용도의 key와 같으면 기동을 거부한다.
type: string
default: null
allowed_values: null
classification: secret
required: false
reload_policy: restart-only
owner_branch: worktree-notification-platform
validation: base64_at_least_32_bytes_and_distinct_per_purpose
compatibility_impact: behavior-change
required_test: adapter-contract:notification-secret-material-required
- name: APP_NOTIFICATION_PLATFORM_CONTACT_ENCRYPTION_KEY_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.
type: string
default: null
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: worktree-notification-platform
validation: non_blank_when_platform_enabled
compatibility_impact: behavior-change
required_test: adapter-contract:notification-secret-material-required
- name: APP_NOTIFICATION_PLATFORM_CONTACT_LOOKUP_HMAC_KEY_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.
type: string
default: null
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: worktree-notification-platform
validation: non_blank_when_platform_enabled
compatibility_impact: behavior-change
required_test: adapter-contract:notification-secret-material-required
- name: APP_NOTIFICATION_PLATFORM_CALLBACK_SIGNING_KEY_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.
type: string
default: null
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: worktree-notification-platform
validation: non_blank_when_platform_enabled
compatibility_impact: behavior-change
required_test: adapter-contract:notification-secret-material-required
- name: APP_NOTIFICATION_PLATFORM_PROVIDER_CREDENTIAL_KEY_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.
type: string
default: null
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: worktree-notification-platform
validation: non_blank_when_platform_enabled
compatibility_impact: behavior-change
required_test: adapter-contract:notification-secret-material-required
- name: APP_NOTIFICATION_PLATFORM_PAYLOAD_ENCRYPTION_KEY_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.
type: string
default: null
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: worktree-notification-platform
validation: non_blank_when_platform_enabled
compatibility_impact: behavior-change
required_test: adapter-contract:notification-secret-material-required
- name: APP_NOTIFICATION_PLATFORM_PROVIDER_REQUEST_LOOKUP_HMAC_KEY_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.
type: string
default: null
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: worktree-notification-platform
validation: non_blank_when_platform_enabled
compatibility_impact: behavior-change
required_test: adapter-contract:notification-secret-material-required
- name: APP_NOTIFICATION_PLATFORM_CALLBACK_FINGERPRINT_HMAC_KEY_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.
type: string
default: null
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: worktree-notification-platform
validation: non_blank_when_platform_enabled
compatibility_impact: behavior-change
required_test: adapter-contract:notification-secret-material-required
- name: APP_NOTIFICATION_PLATFORM_SES_ENABLED
# source: notification/fileserver H4-B — 기본으로 들어 있는 SES 발송 조립기.
type: boolean
default: false
allowed_values: [true, false]
classification: public-config
required: false
reload_policy: restart-only
owner_branch: 2026-09-21-notification-review-remediation
validation: boolean
compatibility_impact: additive
required_test: adapter-contract:notification-ses-provider-assembled
- name: APP_NOTIFICATION_PLATFORM_SES_PRIMARY
# source: notification/fileserver H4-B — 기본으로 들어 있는 SES 발송 조립기.
type: boolean
default: false
allowed_values: [true, false]
classification: public-config
required: false
reload_policy: restart-only
owner_branch: 2026-09-21-notification-review-remediation
validation: boolean
compatibility_impact: additive
required_test: adapter-contract:notification-ses-provider-assembled
- name: APP_NOTIFICATION_PLATFORM_SES_ENVIRONMENT
# source: notification/fileserver H4-B — 기본으로 들어 있는 SES 발송 조립기.
type: string
default: PRODUCTION
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: 2026-09-21-notification-review-remediation
validation: non_blank
compatibility_impact: additive
required_test: adapter-contract:notification-ses-provider-assembled
- name: APP_NOTIFICATION_PLATFORM_SES_CREDENTIAL_KEY_ID
# source: notification/fileserver H4-B — 기본으로 들어 있는 SES 발송 조립기.
type: string
default: null
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: 2026-09-21-notification-review-remediation
validation: non_blank_when_ses_enabled
compatibility_impact: additive
required_test: adapter-contract:notification-ses-provider-assembled
- name: APP_NOTIFICATION_PLATFORM_SES_TIMEOUT
# source: notification/fileserver H4-B — 기본으로 들어 있는 SES 발송 조립기.
type: duration
default: 10s
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: 2026-09-21-notification-review-remediation
validation: positive_duration
compatibility_impact: additive
required_test: adapter-contract:notification-ses-provider-assembled
- name: APP_NOTIFICATION_PLATFORM_SES_MAX_CONCURRENCY
# source: notification/fileserver H4-B — 기본으로 들어 있는 SES 발송 조립기.
type: int
default: 8
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: 2026-09-21-notification-review-remediation
validation: positive_int
compatibility_impact: additive
required_test: adapter-contract:notification-ses-provider-assembled
- name: APP_NOTIFICATION_PLATFORM_SES_RATE_PER_SECOND
# source: notification/fileserver H4-B — 기본으로 들어 있는 SES 발송 조립기.
type: int
default: 20
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: 2026-09-21-notification-review-remediation
validation: positive_int
compatibility_impact: additive
required_test: adapter-contract:notification-ses-provider-assembled
- name: APP_NOTIFICATION_PLATFORM_SES_ENDPOINT
# source: notification/fileserver H4-B — 기본으로 들어 있는 SES 발송 조립기.
type: string
default: https://email.us-east-1.amazonaws.com
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: 2026-09-21-notification-review-remediation
validation: absolute_https_or_loopback_uri
compatibility_impact: additive
required_test: adapter-contract:notification-ses-provider-assembled
- name: APP_NOTIFICATION_PLATFORM_SES_REGION
# source: notification/fileserver H4-B — 기본으로 들어 있는 SES 발송 조립기.
type: string
default: us-east-1
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: 2026-09-21-notification-review-remediation
validation: non_blank
compatibility_impact: additive
required_test: adapter-contract:notification-ses-provider-assembled
- name: APP_NOTIFICATION_PLATFORM_SES_SENDER_IDENTITY
# source: notification/fileserver H4-B — 기본으로 들어 있는 SES 발송 조립기.
type: string
default: null
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: 2026-09-21-notification-review-remediation
validation: email_address_when_ses_enabled
compatibility_impact: additive
required_test: adapter-contract:notification-ses-provider-assembled
- name: APP_NOTIFICATION_PLATFORM_SES_ACCESS_KEY_ID
# source: notification/fileserver H4-B — 기본으로 들어 있는 SES 발송 조립기.
type: string
default: null
allowed_values: null
classification: sensitive-config
required: false
reload_policy: restart-only
owner_branch: 2026-09-21-notification-review-remediation
validation: non_blank_when_ses_enabled
compatibility_impact: additive
required_test: adapter-contract:notification-ses-provider-assembled
- name: APP_NOTIFICATION_PLATFORM_SES_CONFIGURATION_SET
# source: notification/fileserver H4-B — 기본으로 들어 있는 SES 발송 조립기.
type: string
default: null
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: 2026-09-21-notification-review-remediation
validation: optional_non_blank
compatibility_impact: additive
required_test: adapter-contract:notification-ses-provider-assembled
- name: APP_NOTIFICATION_PLATFORM_SES_ALLOWED_TOPIC_ARNS
# source: 2026-09-24 module review Critical #10 — 기본 SES profile이 받는 SES 이벤트 callback의 SNS topic.
# SNS 서명이 맞다는 것은 AWS가 보냈다는 것만 증명하고, topic은 누구나 가질 수 있다. 그래서 callback을 켰는데
# 이 값이 비면 바인딩이 실패한다.
type: csv
default: ""
allowed_values: null
classification: security-relevant
required: false
reload_policy: restart-only
owner_branch: 2026-09-24-notification-critical-remediation
validation: non_empty_when_ses_and_callbacks_enabled
compatibility_impact: behavior-change
required_test: adapter-contract:notification-ses-callback-topic-allowlist
- name: APP_NOTIFICATION_PLATFORM_SMTP_ENABLED
# source: NTF-INT-001 — 기본 SMTP provider profile 켜고 끄기. false면 조립에서 통째로 뺀다.
type: boolean
default: false
allowed_values: [true, false]
classification: public-config
required: false
reload_policy: restart-only
owner_branch: worktree-notification-platform
validation: boolean
compatibility_impact: behavior-change
required_test: adapter-contract:notification-smtp-provider-assembled
- name: APP_NOTIFICATION_PLATFORM_SMTP_PRIMARY
# source: NTF-INT-001 — 이 profile이 EMAIL의 주 경로인지. 채널마다 주 경로는 정확히 하나다.
type: boolean
default: true
allowed_values: [true, false]
classification: public-config
required: false
reload_policy: restart-only
owner_branch: worktree-notification-platform
validation: boolean
compatibility_impact: behavior-change
required_test: adapter-contract:notification-smtp-provider-assembled
- name: APP_NOTIFICATION_PLATFORM_SMTP_ENVIRONMENT
# source: NTF-INT-001 — profile이 밝힌 환경. 모든 발송 기록에 실린다.
type: string
default: local
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: worktree-notification-platform
validation: non_blank
compatibility_impact: behavior-change
required_test: adapter-contract:notification-smtp-provider-assembled
- name: APP_NOTIFICATION_PLATFORM_SMTP_CREDENTIAL_PROFILE
# source: NTF-INT-001 — relay 자격 증명을 푸는 credential profile.
type: string
default: default
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: worktree-notification-platform
validation: non_blank
compatibility_impact: behavior-change
required_test: adapter-contract:notification-smtp-provider-assembled
- name: APP_NOTIFICATION_PLATFORM_SMTP_TIMEOUT
# source: NTF-INT-001 — 이 profile의 시도마다 provider timeout.
type: duration
default: 10s
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: worktree-notification-platform
validation: duration_spring_shorthand
compatibility_impact: behavior-change
required_test: adapter-contract:notification-smtp-provider-assembled
- name: APP_NOTIFICATION_PLATFORM_SMTP_MAX_CONCURRENCY
# source: NTF-INT-001 — 이 profile이 동시에 처리할 수 있는 시도 수.
type: int
default: 4
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: worktree-notification-platform
validation: positive_int
compatibility_impact: behavior-change
required_test: adapter-contract:notification-smtp-provider-assembled
- name: APP_NOTIFICATION_PLATFORM_SMTP_RATE_PER_SECOND
# source: NTF-INT-001 — profile의 시도 속도 제한.
type: int
default: 10
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: worktree-notification-platform
validation: positive_int
compatibility_impact: behavior-change
required_test: adapter-contract:notification-smtp-provider-assembled
- name: APP_NOTIFICATION_PLATFORM_SMTP_SENDER_IDENTITY
# source: NTF-INT-001 — 모든 메시지를 보내는 envelope 발신자.
type: string
default: no-reply@example.invalid
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: worktree-notification-platform
validation: email_address
compatibility_impact: behavior-change
required_test: adapter-contract:notification-smtp-provider-assembled
- name: APP_NOTIFICATION_PLATFORM_SMTP_DISPATCH_CONCURRENCY
# source: NTF-INT-001 — SMTP 발송이 도는, 크기가 정해진 executor의 크기.
type: int
default: 4
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: worktree-notification-platform
validation: positive_int
compatibility_impact: behavior-change
required_test: adapter-contract:notification-smtp-provider-assembled
- name: SPRING_MAIL_HOST
# source: notification/fileserver techlead review H2 — Spring Mail 자체 transport 설정. 기본 SMTP 조립기가
# 검증하고 쓰는 JavaMailSender가 읽는다.
property: spring.mail.host
owner_module: adapter-outbound-notification
type: string
default: null
allowed_values: null
classification: public-config
required: false
required_when: APP_NOTIFICATION_PLATFORM_SMTP_ENABLED=true
reload_policy: restart-only
owner_branch: 2026-09-21-notification-review-remediation
validation: non_blank_when_required
compatibility_impact: additive
required_test: adapter-contract:notification-smtp-transport
- name: SPRING_MAIL_PORT
# source: notification/fileserver techlead review H2 — Spring Mail 자체 transport 설정. 기본 SMTP 조립기가
# 검증하고 쓰는 JavaMailSender가 읽는다.
property: spring.mail.port
owner_module: adapter-outbound-notification
type: integer
default: null
example: 587
allowed_values: null
classification: public-config
required: false
required_when: APP_NOTIFICATION_PLATFORM_SMTP_ENABLED=true
reload_policy: restart-only
owner_branch: 2026-09-21-notification-review-remediation
validation: integer_1_to_65535_when_required
compatibility_impact: additive
required_test: adapter-contract:notification-smtp-transport
- name: SPRING_MAIL_USERNAME
# source: notification/fileserver techlead review H2 — Spring Mail 자체 transport 설정. 기본 SMTP 조립기가
# 검증하고 쓰는 JavaMailSender가 읽는다.
property: spring.mail.username
owner_module: adapter-outbound-notification
type: string
default: null
allowed_values: null
classification: sensitive-config
required: false
required_when: APP_NOTIFICATION_PLATFORM_SMTP_ENABLED=true
reload_policy: restart-only
owner_branch: 2026-09-21-notification-review-remediation
validation: optional_non_blank
compatibility_impact: additive
required_test: adapter-contract:notification-smtp-transport
- name: SPRING_MAIL_PASSWORD
# source: notification/fileserver techlead review H2 — Spring Mail 자체 transport 설정. 기본 SMTP 조립기가
# 검증하고 쓰는 JavaMailSender가 읽는다.
property: spring.mail.password
owner_module: adapter-outbound-notification
type: string
default: null
allowed_values: null
classification: secret
required: false
required_when: APP_NOTIFICATION_PLATFORM_SMTP_ENABLED=true
reload_policy: restart-only
owner_branch: 2026-09-21-notification-review-remediation
validation: secret_when_configured
compatibility_impact: additive
required_test: adapter-contract:notification-smtp-transport
- name: SPRING_MAIL_PROPERTIES_MAIL_SMTP_STARTTLS_ENABLE
# source: notification/fileserver techlead review H2 — Spring Mail 자체 transport 설정. 기본 SMTP 조립기가
# 검증하고 쓰는 JavaMailSender가 읽는다.
property: spring.mail.properties.mail.smtp.starttls.enable
owner_module: adapter-outbound-notification
type: boolean
default: null
example: true
allowed_values: null
classification: public-config
required: false
required_when: APP_NOTIFICATION_PLATFORM_SMTP_ENABLED=true
reload_policy: restart-only
owner_branch: 2026-09-21-notification-review-remediation
validation: true_when_smtp_enabled_unless_implicit_tls
compatibility_impact: additive
required_test: adapter-contract:notification-smtp-transport
- name: SPRING_MAIL_PROPERTIES_MAIL_SMTP_STARTTLS_REQUIRED
# source: notification/fileserver techlead review H2 — Spring Mail 자체 transport 설정. 기본 SMTP 조립기가
# 검증하고 쓰는 JavaMailSender가 읽는다.
property: spring.mail.properties.mail.smtp.starttls.required
owner_module: adapter-outbound-notification
type: boolean
default: null
example: true
allowed_values: null
classification: public-config
required: false
required_when: APP_NOTIFICATION_PLATFORM_SMTP_ENABLED=true
reload_policy: restart-only
owner_branch: 2026-09-21-notification-review-remediation
validation: true_when_starttls_enabled
compatibility_impact: additive
required_test: adapter-contract:notification-smtp-transport
- name: SPRING_MAIL_PROPERTIES_MAIL_SMTP_CONNECTIONTIMEOUT
# source: notification/fileserver techlead review H2 — Spring Mail 자체 transport 설정. 기본 SMTP 조립기가
# 검증하고 쓰는 JavaMailSender가 읽는다.
property: spring.mail.properties.mail.smtp.connectiontimeout
owner_module: adapter-outbound-notification
type: integer
default: null
example: 5000
allowed_values: null
classification: public-config
required: false
required_when: APP_NOTIFICATION_PLATFORM_SMTP_ENABLED=true
reload_policy: restart-only
owner_branch: 2026-09-21-notification-review-remediation
validation: positive_millis_when_required
compatibility_impact: additive
required_test: adapter-contract:notification-smtp-transport
- name: SPRING_MAIL_PROPERTIES_MAIL_SMTP_TIMEOUT
# source: notification/fileserver techlead review H2 — Spring Mail 자체 transport 설정. 기본 SMTP 조립기가
# 검증하고 쓰는 JavaMailSender가 읽는다.
property: spring.mail.properties.mail.smtp.timeout
owner_module: adapter-outbound-notification
type: integer
default: null
example: 10000
allowed_values: null
classification: public-config
required: false
required_when: APP_NOTIFICATION_PLATFORM_SMTP_ENABLED=true
reload_policy: restart-only
owner_branch: 2026-09-21-notification-review-remediation
validation: positive_millis_when_required
compatibility_impact: additive
required_test: adapter-contract:notification-smtp-transport
- name: SPRING_MAIL_PROPERTIES_MAIL_SMTP_WRITETIMEOUT
# source: notification/fileserver techlead review H2 — Spring Mail 자체 transport 설정. 기본 SMTP 조립기가
# 검증하고 쓰는 JavaMailSender가 읽는다.
property: spring.mail.properties.mail.smtp.writetimeout
owner_module: adapter-outbound-notification
type: integer
default: null
example: 10000
allowed_values: null
classification: public-config
required: false
required_when: APP_NOTIFICATION_PLATFORM_SMTP_ENABLED=true
reload_policy: restart-only
owner_branch: 2026-09-21-notification-review-remediation
validation: positive_millis_when_required
compatibility_impact: additive
required_test: adapter-contract:notification-smtp-transport
- name: APP_OPENAPI_DOCS_ENABLED
# source: five-adapter-runtime-remediation §9 — /v3/api-docs를 내줄지. application-prod.yml이 false로
# 고정한다. 기본값에 맡기지 않고 적는 이유: 배포가 정할 때까지 SpringDoc이 기동마다 경고하고, 기동마다 나는
# 경고는 아무도 읽지 않는다.
type: boolean
default: true
allowed_values: [true, false]
classification: public-config
required: false
reload_policy: restart-only
owner_branch: main
validation: boolean
compatibility_impact: behavior-change
required_test: env-contract:openapi-exposure-decided
- name: APP_OPENAPI_UI_ENABLED
# source: five-adapter-runtime-remediation §9 — Swagger UI를 내줄지. application-prod.yml이 false로 고정한다.
# 기본값에 맡기지 않고 적는 이유: 배포가 정할 때까지 SpringDoc이 기동마다 경고하고, 기동마다 나는 경고는
# 아무도 읽지 않는다.
type: boolean
default: true
allowed_values: [true, false]
classification: public-config
required: false
reload_policy: restart-only
owner_branch: main
validation: boolean
compatibility_impact: behavior-change
required_test: env-contract:openapi-exposure-decided
- name: APP_NOTIFICATION_PLATFORM_MODE
# source: NTF-025 — SERVING은 동작하는 provider 없이 기동을 거부한다. INGEST_ONLY는 저장만 하고 보내지 않는다.
# 상수는 INGEST_ONLY다. 이 행은 ACCEPT_ONLY라 했는데, NotificationPlatformMode에 그런 이름은 없었다. 그래서
# 레지스트리를 따른 운영자는 문서에 없는 값을 지목하는 바인딩 실패를 받았다. NotificationModeSsotTest가 아래
# 목록을 enum에서 만든다.
type: enum
default: SERVING
allowed_values: [SERVING, INGEST_ONLY]
classification: public-config
required: false
reload_policy: restart-only
owner_branch: worktree-notification-platform
validation: enum_of_notification_platform_mode
compatibility_impact: behavior-change
required_test: adapter-contract:notification-platform-mode
- name: APP_NOTIFICATION_PLATFORM_CLAIM_BATCH_SIZE
# source: NTF-025 — scheduler 한 번이 claim하는 수신자 전달 수. 1..1000이고 밖이면 바인딩에서 거부한다
type: integer
default: 50
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: worktree-notification-platform
validation: integer_1_to_1000
compatibility_impact: behavior-change
required_test: adapter-contract:notification-dispatch-bounds
- name: APP_NOTIFICATION_PLATFORM_LEASE_DURATION
# source: NTF-025 — poll-interval과 켜진 provider profile의 timeout보다 길어야 기동한다(2026-11-13부터 검사).
# 짧으면 살아 있는 worker의 전달을 다른 worker가 claim한다. 넉넉히 길게 둔다: lease는 claim 때 시작한다
type: duration
default: 2m
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: worktree-notification-platform
validation: positive_duration
compatibility_impact: behavior-change
required_test: adapter-contract:notification-lease-fencing
- name: APP_NOTIFICATION_PLATFORM_POLL_INTERVAL
# source: NTF-025 — 지난 차례에 claim한 것이 없을 때 scheduler가 일을 다시 묻는 간격
type: duration
default: 1s
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: worktree-notification-platform
validation: positive_duration
compatibility_impact: behavior-change
required_test: adapter-contract:notification-dispatch-bounds
- name: APP_NOTIFICATION_PLATFORM_MAX_CONCURRENCY
# source: NTF-025 — 프로세스 전체에서 처리 중인 provider 호출 수 상한
type: integer
default: 64
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: worktree-notification-platform
validation: positive_integer
compatibility_impact: behavior-change
required_test: adapter-contract:notification-dispatch-bounds
- name: APP_NOTIFICATION_PLATFORM_MAX_ADDITIONAL_ATTEMPTS
# source: NTF-025 — 첫 시도 뒤의 재시도 수. 0이면 한 번 시도하고 재시도하지 않는다
type: integer
default: 4
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: worktree-notification-platform
validation: non_negative_integer
compatibility_impact: behavior-change
required_test: adapter-contract:notification-retry-policy
- name: APP_NOTIFICATION_PLATFORM_ESTIMATED_DISPATCH_DURATION
# source: NTF-025 — lease·재시도 계획에 쓰는 발송 지연 추정값
type: duration
default: 2s
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: worktree-notification-platform
validation: positive_duration
compatibility_impact: behavior-change
required_test: adapter-contract:notification-dispatch-bounds
- name: APP_NOTIFICATION_PLATFORM_MAX_QUEUE_AGE
# source: NTF-025 — 이 시간이 지나면 queue의 전달은 늦게 보내지 않고 만료된다
type: duration
default: 24h
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: worktree-notification-platform
validation: positive_duration
compatibility_impact: behavior-change
required_test: adapter-contract:notification-expiry
- name: APP_NOTIFICATION_PLATFORM_ALLOW_AMBIGUOUS_FALLBACK
# source: NTF-025 — 결과를 읽지 못한 애매한 시도가 provider에 닿았다. 다른 경로로 넘기면 두 번 보낼 위험이 있다
type: boolean
default: false
allowed_values: [true, false]
classification: public-config
required: false
reload_policy: restart-only
owner_branch: worktree-notification-platform
validation: boolean
compatibility_impact: behavior-change
required_test: adapter-contract:notification-ambiguity
- name: APP_NOTIFICATION_PLATFORM_SHUTDOWN_GRACE
# source: NTF-025 — 프로세스 종료 때 worker 정리 시간의 상한
type: duration
default: 20s
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: worktree-notification-platform
validation: positive_duration
compatibility_impact: behavior-change
required_test: adapter-contract:notification-shutdown-grace
- name: APP_NOTIFICATION_PLATFORM_MAX_BACKLOG_DEPTH
# source: NTF-OBS-001 — 기한이 됐는데 claim되지 않은 전달의 readiness 기준
type: integer
default: 100000
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: worktree-notification-platform
validation: non_negative_integer
compatibility_impact: behavior-change
required_test: adapter-contract:notification-serving-thresholds
- name: APP_NOTIFICATION_PLATFORM_MAX_OLDEST_DUE_AGE
# source: NTF-OBS-001 — 기한이 된 가장 오래된 전달의 readiness 기준
type: duration
default: 10m
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: worktree-notification-platform
validation: non_negative_duration
compatibility_impact: behavior-change
required_test: adapter-contract:notification-serving-thresholds
- name: APP_NOTIFICATION_PLATFORM_MAX_STUCK_LEASES
# source: NTF-OBS-001 — 만료되거나 멈춘 전달 lease의 readiness 기준
type: integer
default: 50
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: worktree-notification-platform
validation: non_negative_integer
compatibility_impact: behavior-change
required_test: adapter-contract:notification-serving-thresholds
- name: APP_NOTIFICATION_PLATFORM_MAX_PENDING_PROJECTIONS
# source: NTF-OBS-001 — 적용되지 않은 provider 이벤트 projection의 readiness 기준
type: integer
default: 50000
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: worktree-notification-platform
validation: non_negative_integer
compatibility_impact: behavior-change
required_test: adapter-contract:notification-serving-thresholds
- name: APP_NOTIFICATION_PLATFORM_MAX_FAILED_PROJECTIONS
# source: NTF-OBS-001 — 실패한 provider 이벤트 projection의 readiness 기준
type: integer
default: 1000
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: worktree-notification-platform
validation: non_negative_integer
compatibility_impact: behavior-change
required_test: adapter-contract:notification-serving-thresholds
- name: APP_NOTIFICATION_PLATFORM_MAX_OLDEST_PENDING_PROJECTION_AGE
# source: NTF-OBS-001 — 가장 오래 기다린 projection의 readiness 기준
type: duration
default: 15m
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: worktree-notification-platform
validation: non_negative_duration
compatibility_impact: behavior-change
required_test: adapter-contract:notification-serving-thresholds
- name: APP_NOTIFICATION_PLATFORM_MAX_OLDEST_RECONCILIATION_AGE
# source: NTF-OBS-001 — 가장 오래 풀리지 않은 대조(reconciliation)의 readiness 기준
type: duration
default: 30m
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: worktree-notification-platform
validation: non_negative_duration
compatibility_impact: behavior-change
required_test: adapter-contract:notification-serving-thresholds
- name: APP_NOTIFICATION_PLATFORM_CALLBACKS_ENABLED
# source: NTF-025 — 플랫폼이 provider callback endpoint를 내놓을지
type: boolean
default: false
allowed_values: [true, false]
classification: public-config
required: false
reload_policy: restart-only
owner_branch: worktree-notification-platform
validation: boolean
compatibility_impact: behavior-change
required_test: adapter-contract:notification-callback-ingestion
- name: APP_NOTIFICATION_PLATFORM_CALLBACK_MAX_BODY_BYTES
# source: NTF-025 — 상한 65251 = 암호문 칸 크기에서 가장 큰 envelope(version, key-id 길이, 255바이트 key id, AES-GCM nonce와 tag)를 뺀 값. 더 크면 바인딩에서 거부한다
type: integer
default: 65251
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: worktree-notification-platform
validation: integer_1_to_65251
compatibility_impact: behavior-change
required_test: adapter-contract:notification-callback-body-bound
- name: APP_NOTIFICATION_PLATFORM_CALLBACK_REPLAY_SKEW
# source: NTF-025 — callback 시각이 로컬 시각과 이만큼 넘게 다르면 replay로 본다
# review 05-20 — 1h는 SNS의 HTTP/S 재시도 기간 전체(최대 3,600 s)를 덮는다. 그 안의 replay는 ledger 중복이다
type: duration
default: 1h
allowed_values: null
classification: security-relevant
required: false
reload_policy: restart-only
owner_branch: worktree-notification-platform
validation: positive_duration
compatibility_impact: behavior-change
required_test: adapter-contract:notification-callback-replay
# === 원래 이름으로 읽는 placeholder (2026-11-12 등록) ===
# 배포 설정이 읽는데 행이 없던 이름이다. verifyEnvKeys가 APP_ 밖 placeholder를 보지 않아 빠졌다. 이름을 APP_로
# 바꾸면 파생 서비스의 배포 env가 소리 없이 무시되므로 지금 이름 그대로 등록한다(바꾸는 것은 소유자 결정).
# SPRING_JACKSON_DESER_*·SPRING_JACKSON_SER_*·SPRING_BANNER_MODE는 Spring relaxed 이름이 아니라 application.yml
# placeholder가 만든 이름이다. relaxed 이름(예: SPRING_JACKSON_DESERIALIZATION_FAIL_ON_UNKNOWN_PROPERTIES,
# SPRING_MAIN_BANNER_MODE)도 같은 속성을 덮고, 둘 다 있으면 relaxed 이름이 이긴다(환경 변수 소스가 yml보다 앞선다).
- name: SECURITY_PUBLIC_PATHS
# 인증을 건너뛰는 경로 CSV(app.security.public-paths). 기본값은 API base path 뒤의 healthcheck 하나이고
# docs/security/public-paths-snapshot.txt가 그 기본값을 고정한다. 운영자 값은 스냅숏 밖이다.
property: app.security.public-paths
type: csv
default: /v1/healthcheck
allowed_values: null
classification: security-relevant
required: false
reload_policy: restart-only
owner_branch: feature-security-operational-baseline
validation: csv_of_absolute_paths
compatibility_impact: behavior-change
required_test: security-contract:public-path-snapshot
- name: PRESENTATION_API_BASE_PATH
# 모든 controller 앞에 붙는 경로(presentation.api-base-path). 빈 값이면 접두어 없음. SECURITY_PUBLIC_PATHS의
# 기본값도 이 값에서 나온다.
type: string
default: /v1
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: feature-api-contract-baseline
validation: leading_slash_path_or_empty
compatibility_impact: behavior-change
required_test: web-contract:api-base-path-prefix
- name: SPRING_BANNER_MODE
property: spring.main.banner-mode
type: enum
default: console
allowed_values: [off, console, log]
classification: public-config
required: false
reload_policy: restart-only
owner_branch: feature-env-driven-runtime-configuration
validation: enum_in_allowed_values
compatibility_impact: behavior-change
required_test: env-contract:spring-runtime-placeholder
- name: SPRING_MAIN_LAZY_INITIALIZATION
property: spring.main.lazy-initialization
type: boolean
default: false
allowed_values: [true, false]
classification: public-config
required: false
reload_policy: restart-only
owner_branch: feature-env-driven-runtime-configuration
validation: boolean
compatibility_impact: behavior-change
required_test: env-contract:spring-runtime-placeholder
- name: SPRING_MAIN_LOG_STARTUP_INFO
property: spring.main.log-startup-info
type: boolean
default: true
allowed_values: [true, false]
classification: public-config
required: false
reload_policy: restart-only
owner_branch: feature-env-driven-runtime-configuration
validation: boolean
compatibility_impact: behavior-change
required_test: env-contract:spring-runtime-placeholder
- name: SPRING_THREADS_VIRTUAL_ENABLED
property: spring.threads.virtual.enabled
type: boolean
default: true
allowed_values: [true, false]
classification: public-config
required: false
reload_policy: restart-only
owner_branch: feature-env-driven-runtime-configuration
validation: boolean
compatibility_impact: behavior-change
required_test: env-contract:spring-runtime-placeholder
- name: SPRING_JACKSON_DESER_FAIL_ON_UNKNOWN_PROPERTIES
# 요청 경계 Jackson 정책(web AGENTS B1). 끄면 잘못된 본문을 조용히 받아들인다.
property: spring.jackson.deserialization.fail-on-unknown-properties
type: boolean
default: true
allowed_values: [true, false]
classification: public-config
required: false
reload_policy: restart-only
owner_branch: feature-env-driven-runtime-configuration
validation: boolean
compatibility_impact: behavior-change
required_test: env-contract:spring-runtime-placeholder
- name: SPRING_JACKSON_DESER_FAIL_ON_NULL_FOR_PRIMITIVES
# 요청 경계 Jackson 정책(web AGENTS B1). 끄면 잘못된 본문을 조용히 받아들인다.
property: spring.jackson.deserialization.fail-on-null-for-primitives
type: boolean
default: true
allowed_values: [true, false]
classification: public-config
required: false
reload_policy: restart-only
owner_branch: feature-env-driven-runtime-configuration
validation: boolean
compatibility_impact: behavior-change
required_test: env-contract:spring-runtime-placeholder
- name: SPRING_JACKSON_DESER_FAIL_ON_IGNORED_PROPERTIES
# 요청 경계 Jackson 정책(web AGENTS B1). 끄면 잘못된 본문을 조용히 받아들인다.
property: spring.jackson.deserialization.fail-on-ignored-properties
type: boolean
default: true
allowed_values: [true, false]
classification: public-config
required: false
reload_policy: restart-only
owner_branch: feature-env-driven-runtime-configuration
validation: boolean
compatibility_impact: behavior-change
required_test: env-contract:spring-runtime-placeholder
- name: SPRING_JACKSON_DESER_READ_UNKNOWN_ENUM_VALUES_AS_NULL
# 요청 경계 Jackson 정책(web AGENTS B1). 끄면 잘못된 본문을 조용히 받아들인다.
property: spring.jackson.datatype.enum.read-unknown-enum-values-as-null
type: boolean
default: false
allowed_values: [true, false]
classification: public-config
required: false
reload_policy: restart-only
owner_branch: feature-env-driven-runtime-configuration
validation: boolean
compatibility_impact: behavior-change
required_test: env-contract:spring-runtime-placeholder
- name: SPRING_JACKSON_SER_WRITE_DATES_AS_TIMESTAMPS
# 요청 경계 Jackson 정책(web AGENTS B1). 끄면 잘못된 본문을 조용히 받아들인다.
property: spring.jackson.datatype.datetime.write-dates-as-timestamps
type: boolean
default: false
allowed_values: [true, false]
classification: public-config
required: false
reload_policy: restart-only
owner_branch: feature-env-driven-runtime-configuration
validation: boolean
compatibility_impact: behavior-change
required_test: env-contract:spring-runtime-placeholder