Files
clean-architecture-backend-…/docs/registries/env-keys.yaml
T
DongHyeonkaandClaude Opus 5.5 016597ac78 review-followup Wave 2: 정합성 수정 통합과 검증, 현황표·재개 프롬프트
13개 작업 묶음(P1–P13)의 W2 커밋을 합치고 전체 게이트로 검증했다.

- 묶음별 정합성 수정(notification dispatch·recovery, object storage staged
  publication, fileserver 복구·정리, gRPC 플랫폼, Redis 분류·lease TTL, JPA
  outbox claim 순서·durable operation HTTP, web 요청 id·category 필수, graphql
  에러 mapper, Mongo profile 바인딩, build 소스 보존 게이트·compose smoke info 확인)
- 통합 때 드러난 3건 수정: outbox claim 테스트 fixture의 가짜 envelope hash,
  sample scan이 새 operation controller를 등록하던 문제, SpotBugs aux classpath
  파일이 truncate되지 않아 로컬에서 ".jar.jar"로 실패하던 문제
- 현황표: 묶음 결과 반영, 소유자 결정 21–27, 후속 발견 결함 47행, 요약 갱신
- docs/capability-status.md 「제거된 코드」에 85행 추가
- 묶음 결과 파일·에이전트 지시·스크립트를 docs로 옮기고 desktop 재개 프롬프트 추가

검증: check, ci verifyDependencyLocks, mainCheck, architecture/public path/env
keys/config contract, bootstrap·sample integration/system, build-logic·build-tools
test, optional-platforms ci, qualificationBootJar 통과. integrationCheck는 이번
작업 전에도 실패하던 lane(Redis topology 모드 인자, httpclient failure
injection, AWS 보호 lane)만 실패.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
2026-09-28 14:46:30 +09:00

5208 lines
204 KiB
YAML

# Registry: Env Keys
# Schema owner: feature-contract-registry-governance
# Owner branch: feature-env-driven-runtime-configuration
# Last updated: 2026-09-25
#
# Conventions:
# - Application-owned env uses `APP_` prefix, fully unified (D2, 2026-06-05):
# datasource/server/etc. keys that map onto Spring properties are renamed APP_*
# as well (e.g. SERVER_PORT -> APP_SERVER_PORT).
# - Only env the Spring runtime reads natively stays native: SPRING_* and
# SPRING_PROFILES_ACTIVE (D6 — profile selector is Spring-native, not APP_).
# - `classification: secret` rows only reference secrets-classification.yaml; full row owned there.
# - reload_policy default = `restart-only` (env-driven branch "config reload: no runtime reload").
# - boolean encoding = true/false only (env-driven branch 2026-05-22).
# - Duration encoding = Spring shorthand (`30s`); ISO-8601 (`PT30S`) forbidden (env-driven branch 2026-05-22).
# - DataSize encoding = `10MB` (env-driven branch 2026-05-22).
env_keys:
# === Profile / Identity (feature-env-driven-runtime-configuration) ===
- name: SPRING_PROFILES_ACTIVE
# source: feature-env-driven-runtime-configuration D6 (2026-06-06), amended by
# five-adapter-runtime-remediation §7.1. Profile selector is Spring-native and sole
# (APP_PROFILE was dropped). Exactly one value, not a CSV list: two environments cannot both
# have their safety rules apply, and whichever lost did so silently.
type: enum
# No default. A profile that is guessed is a deployment nobody chose: a jar started
# with none used to become local, which before persistence was gated also meant an
# in-memory database that loses every write on restart.
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 intentionally removed (D6, 2026-06-06): profile = SPRING_PROFILES_ACTIVE
# alone. A duplicate APP_PROFILE would only add information doubling + mismatch-fail
# cost. See design record 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 server (APP_ unified per D2) ===
- name: APP_SERVER_PORT
# source: feature-env-driven-runtime-configuration D2 (2026-06-05) — full APP_
# unification; server.port maps from APP_SERVER_PORT.
# + feature-management-actuator-security-contract 2026-05-22 "management port default = 9001 (separate from app 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: APP_SERVER_SHUTDOWN
# source: feature-env-driven-runtime-configuration D2 (2026-06-05) — APP_ unification
# (server.shutdown mode; graceful drains in-flight requests)
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_ unification.
# Supersedes the old APP_SHUTDOWN_TIMEOUT row. Must stay <= k8s
# terminationGracePeriod (cross-ref 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_ unification.
# Fail closed: forwarded headers are trusted only when a deployment opts in behind a
# sanitizing/trusted proxy. native = Tomcat RemoteIpValve, which honours them only from
# peers matching server.tomcat.remoteip.internal-proxies. framework is not allowed: its
# ForwardedHeaderFilter believes every peer, and the rate limiter refuses to start on it.
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_ unification
# (ceiling on concurrent request workers)
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_ unification
# (idle worker pool floor)
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_ unification
# (OS-level backlog queue depth for incoming TCP connections)
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_ unification
# (hard cap on simultaneously open connections)
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_ unification
# (connection timeout for the Tomcat connector)
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_ unification
# (server.compression toggle)
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_ unification
# (payloads below this threshold are not compressed)
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_ unification
# (spring.web.error.include-stacktrace policy)
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_ unification
# (spring.web.error.include-message policy)
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)
# When true, StartupSafetyValidator (SmartInitializingSingleton) requires the 5
# instance-coordination beans (distributed lock / cache-stampede / outbox leader
# / rate-limiter / migration runner) to be present, else startup fails. Consumed
# by 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
# When true, Flyway migrations are executed automatically during application startup.
# When false, migrations are bypassed (delegated to out-of-app container/pipeline jobs).
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"
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에서 owns
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: persistence vendor selector used by application-local.yml and bootRunH2.
# PostgreSQL is the shipped default; H2 is an explicit developer-only selection.
property: ca-skeleton.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: ca-skeleton.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: ca-skeleton.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: local PostgreSQL parity / explicit H2 developer lane.
# Local PostgreSQL runs migrations by default; bootRunH2 disables them because the migration
# tree is PostgreSQL-specific.
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"
# unit: milliseconds. It feeds spring.datasource.hikari.connection-timeout, which binds onto
# HikariConfig#setConnectionTimeout(long) — a duration shorthand such as "5s" does not bind and
# fails the boot. This row said `duration` / `5s`, application.yml copied that default, and
# every prod and dev deployment refused to start; five-adapter-runtime-remediation Wave 2 found
# it in the prod-smoke lane. Corrected to what the property actually accepts.
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"
# (JDBC driver class for the configured datasource URL)
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 must be validate|none, local update convenient)
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"
# (echo SQL to logs)
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"
# (pretty-print SQL — only useful when 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 — don't enable in 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 milliseconds; idle connection eviction threshold)
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 milliseconds; max lifetime — rotate before 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
# === Tracing / Observability (feature-distributed-tracing-contract) ===
- name: OTEL_EXPORTER_OTLP_ENDPOINT
# source: feature-distributed-tracing-contract 2026-05-22
# "Micrometer Tracing + OpenTelemetry exporter를 기본 기준으로 둠"
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): blank = per-profile resolver 기본값 사용.
# RuntimeEnvironment is the profile SSOT; resolver policy is prod=0.01, dev/local=1.0.
# TracingSamplingEnvironmentPostProcessor bridges resolved rate to
# 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
# === Log management (feature-log-management-contract) ===
# APP_LOG_LEVEL (single key) replaced by the 5 granular APP_LOG_LEVEL_* rows below
# (root / app / spring / web / sql) — as built by feature-log-management-contract.
- name: APP_LOG_LEVEL_ROOT
# source: feature-log-management-contract — root logger level
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 — application package level
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 package level
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 package level
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 package level (DEBUG prints SQL)
type: enum
default: WARN
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 file appender toggle
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 — file path (relative to bootRun cwd or absolute)
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 — per-file rolling size cap
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 — number of rolled archives to retain
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 — total size cap across rolled files
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 — AsyncAppender wrap for non-blocking I/O
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 — in-memory queue depth before back-pressure
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 — remaining-capacity floor below which
# TRACE/DEBUG/INFO events drop (WARN/ERROR always kept). 0 = never drop.
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 — IANA timezone for JSON encoder timestamps
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 timestamp pattern (ISO 8601 default)
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 — include file/method/line (significant perf cost)
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 name abbreviation (0 = full name)
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
# === Privacy: user_principal pseudonymization (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)". Consumed by feature-log-management-contract (DRIFT-6)
# to record user_principal in pseudonymized form. secret 분류로 secrets-classification.yaml에서 owns.
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 master toggle
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 — allowed methods
# (empty -> sensible method defaults in CorsSettings)
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 — allowed request headers ("*" = any)
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"
type: duration
default: 600s
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: feature-security-operational-baseline
validation: spring_duration_shorthand
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
# DEPRECATED 2026-08-10: the settings class that bound this property was removed
# with the previous Redis generation, so the key reached nothing. The row is kept
# (not deleted) so a deployment still setting it can be told what replaced it.
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
# DEPRECATED 2026-08-10: the settings class that bound this property was removed
# with the previous Redis generation, so the key reached nothing. The row is kept
# (not deleted) so a deployment still setting it can be told what replaced it.
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
# DEPRECATED 2026-08-10: the settings class that bound this property was removed
# with the previous Redis generation, so the key reached nothing. The row is kept
# (not deleted) so a deployment still setting it can be told what replaced it.
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
# DEPRECATED 2026-08-10: the settings class that bound this property was removed
# with the previous Redis generation, so the key reached nothing. The row is kept
# (not deleted) so a deployment still setting it can be told what replaced it.
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
# DEPRECATED 2026-08-10: the settings class that bound this property was removed
# with the previous Redis generation, so the key reached nothing. The row is kept
# (not deleted) so a deployment still setting it can be told what replaced it.
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
# DEPRECATED 2026-08-10: the settings class that bound this property was removed
# with the previous Redis generation, so the key reached nothing. The row is kept
# (not deleted) so a deployment still setting it can be told what replaced it.
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
# DEPRECATED 2026-08-10: the settings class that bound this property was removed
# with the previous Redis generation, so the key reached nothing. The row is kept
# (not deleted) so a deployment still setting it can be told what replaced it.
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
# DEPRECATED 2026-08-10: the settings class that bound this property was removed
# with the previous Redis generation, so the key reached nothing. The row is kept
# (not deleted) so a deployment still setting it can be told what replaced it.
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
# Inbound enforcement stays disabled until an exact provider is selected.
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 removed (2026-09-25, review follow-up I-5a): its
# forwarded-headers-trusted value keyed unauthenticated callers by the leftmost X-Forwarded-For
# entry, which the caller writes. The client IP is getRemoteAddr(); behind a proxy set
# APP_SERVER_FORWARD_HEADERS_STRATEGY=native and server.tomcat.remoteip.internal-proxies.
- name: APP_RATE_LIMIT_REDIS_ENABLED
# DEPRECATED 2026-08-10: the rate limiter no longer owns a Redis client of its own. One client, built by RedisSdkAutoConfiguration, serves every capability, so a second endpoint and a second set of ceilings could only ever disagree with it.
# Replaced by: 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
# DEPRECATED 2026-08-10: the rate limiter no longer owns a Redis client of its own. One client, built by RedisSdkAutoConfiguration, serves every capability, so a second endpoint and a second set of ceilings could only ever disagree with it.
# Replaced by: 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
# DEPRECATED 2026-08-10: the rate limiter no longer owns a Redis client of its own. One client, built by RedisSdkAutoConfiguration, serves every capability, so a second endpoint and a second set of ceilings could only ever disagree with it.
# Replaced by: 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
# DEPRECATED 2026-08-10: the rate limiter no longer owns a Redis client of its own. One client, built by RedisSdkAutoConfiguration, serves every capability, so a second endpoint and a second set of ceilings could only ever disagree with it.
# Replaced by: 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
# DEPRECATED 2026-08-10: the session generation that bound this was removed, and the replacement does not own a Redis client of its own either.
# Replaced by: 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
# DEPRECATED 2026-08-10: the settings class that bound this property was removed
# with the previous Redis generation, so the key reached nothing. The row is kept
# (not deleted) so a deployment still setting it can be told what replaced it.
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: 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_30s
compatibility_impact: additive
required_test: rate-limit-contract:redis-timeout-bounded
- name: APP_RATE_LIMIT_REDIS_MAXIMUM_COMMAND_BYTES
# DEPRECATED 2026-08-10: the rate limiter no longer owns a Redis client of its own. One client, built by RedisSdkAutoConfiguration, serves every capability, so a second endpoint and a second set of ceilings could only ever disagree with it.
# Replaced by: 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
# DEPRECATED 2026-08-10: the rate limiter no longer owns a Redis client of its own. One client, built by RedisSdkAutoConfiguration, serves every capability, so a second endpoint and a second set of ceilings could only ever disagree with it.
# Replaced by: 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
# DEPRECATED 2026-08-10: the rate limiter no longer owns a Redis client of its own. One client, built by RedisSdkAutoConfiguration, serves every capability, so a second endpoint and a second set of ceilings could only ever disagree with it.
# Replaced by: 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
# DEPRECATED 2026-08-10: the rate limiter no longer renders its own key prefix. Four capabilities each joining two free-form tokens produced four prefixes, and the ACL pattern matched none of them.
# Replaced by: app.redis.namespace.environment (APP_REDIS_NAMESPACE_ENVIRONMENT), shared by every 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
# ca-skeleton.capabilities.idempotency.replay-ttl: how long a completed response stays
# replayable. One value for every provider; IdempotencySettings refuses more than 72h at startup.
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
compatibility_impact: behavior-change
required_test: idempotency-contract:ttl-applied
- name: APP_IDEMPOTENCY_PROVIDER
# ca-skeleton.capabilities.idempotency.provider. redis and postgresql each contribute only the
# store; app-bootstrap builds the one IdempotencyExecutor and refuses startup unless exactly one
# store exists. postgresql uses the primary data source, applies its Flyway streams at startup
# and refuses a non-PostgreSQL data source, so bootRunH2 runs with disabled or redis. Selection
# is explicit and disabled by default; no implementation wins merely by being on the classpath.
# 2026-09-25: jdbc (the V1 store) was removed; a deployment still setting it fails to bind.
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
# DEPRECATED 2026-09-22: the Redis idempotency adapter consumes caller-supplied scope digests and never read this secret.
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
# DEPRECATED 2026-08-10: the idempotency store no longer renders its own key prefix. Four capabilities each joining two free-form tokens produced four prefixes, and the ACL pattern matched none of them.
# Replaced by: app.redis.namespace.environment (APP_REDIS_NAMESPACE_ENVIRONMENT), shared by every 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
type: duration
default: 30s
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: redis-production-capability-completion
validation: positive_duration_le_1h
compatibility_impact: additive
required_test: redis-idempotency-contract:processing-lease-bounded
- name: APP_IDEMPOTENCY_FAILURE_RETENTION
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
compatibility_impact: additive
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
# DEPRECATED 2026-09-22: the Redis lease adapter consumes caller-supplied resource digests and never read this secret.
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
# DEPRECATED 2026-08-10: the lease no longer renders its own key prefix. Four capabilities each joining two free-form tokens produced four prefixes, and the ACL pattern matched none of them.
# Replaced by: app.redis.namespace.environment (APP_REDIS_NAMESPACE_ENVIRONMENT), shared by every 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
# === Cache / Redis (feature-cache-consistency-contract + integration-adapter-templates) ===
- name: APP_CACHE_CANONICAL_DEFAULT_PROVIDER
# Canonical default semantic region provider selection; legacy enable is a separate migration path.
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 packaging: the cache-redis module is on when present (its
# config/module-defaults/cache-redis.yml maps this key with default true); false is the explicit
# off. Absent from the build is the ordinary off state.
# False loads no Redis settings, requires no Redis secret, and creates no client, connection,
# thread or health contributor. Role selectors choose which capabilities compose once Redis is
# on; none of them is a second on/off key.
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
# How long a cache entry stays usable. The physical Redis TTL equals this and nothing else, so
# an entry can never outlive the deployment's own notion of usability or be discarded early.
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
# How long an authoritative absence is cached. Separate from the positive TTL because "the
# source says this does not exist" is a fact with a different shelf life from a value.
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_IDEMPOTENCY_REDIS_COMMAND_TIMEOUT
# The ceiling on one owner-safe transition.
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
# The ceiling on one lease operation.
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
# What a contended acquire tells the caller to wait. Distinct from the drift budget: one is
# advice to a caller that lost, the other is how much of its own lease a winner does not trust.
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 SDK typed settings (app.redis.*) -------------------------------
# Bound only by RedisSdkAutoConfiguration in adapter-outbound-redis-runtime while
# APP_REDIS_ENABLED is true. application.yml does not force these values into Redis-free
# deployments; src/.env.example merely documents explicit operator inputs. verifyEnvKeys checks
# the registry against the runtime module's configuration metadata.
- name: APP_REDIS_ADMIN_CREDENTIAL_REFERENCE
property: app.redis.admin.credential-reference
owner_module: adapter-outbound-redis-runtime
type: string
default: null
allowed_values: null
classification: sensitive-config
required: false
required_when: app.redis.admin.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_ADMIN_ENABLED
property: app.redis.admin.enabled
owner_module: adapter-outbound-redis-runtime
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:typed-settings-bound-and-validated
- name: APP_REDIS_BLOCKING_MAX_CONNECTIONS
property: app.redis.blocking.max-connections
owner_module: adapter-outbound-redis-runtime
type: integer
default: 32
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_DATABASE
# Cluster supports database 0 only; a non-zero value fails startup there.
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
# CSV of host:port. Cluster and Sentinel take every 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
# Single-key command profile; above 5s produces a startup warning.
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
- name: APP_REDIS_TRANSACTION_MAX_CONNECTIONS
property: app.redis.transaction.max-connections
owner_module: adapter-outbound-redis-runtime
type: integer
default: 16
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
# --- Redis runtime composition settings (app.redis.*) ----------------------
# Authentication, Sentinel discovery, TLS, lifecycle, Cluster routing, capacity and
# subscription delivery. Same rule as the rest of app.redis.*: bound only while
# APP_REDIS_ENABLED is true, and deliberately absent from application.yml and .env.
- name: APP_REDIS_AUTHENTICATION_ADVANCED_CREDENTIAL_REFERENCE
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
# Explicit acknowledgement that Redis runs with no credential. Startup fails without it when
# no credential reference is set, because booting anyway builds an unauthenticated client that
# cannot run a single command on any deployment which disabled the `default` ACL user — the
# failure moves from startup to the first request, where it reads as an outage rather than a
# missing setting. Setting this to true keeps the deployment running and logs the trade.
type: boolean
default: false
allowed_values: [true, false]
classification: public-config
required: false
required_when: app.redis.enabled=true and no credential reference is configured
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
# Pointer to the application ACL account credential. The value lives in the secret manager.
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_AUTHENTICATION_PUBSUB_CREDENTIAL_REFERENCE
property: app.redis.authentication.pubsub-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
# Physical SCRIPT lane connections are bounded separately from the per-connection command 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 refuses commands while disconnected. False restores the driver offline queue, which replays a burst of writes on reconnect in arbitrary order relative to the outage.
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
# How long a lane borrow waits for a returned connection before it is refused as not sent.
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
# How long shutdown waits for in-flight commands before closing connections.
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_PUBSUB_BUFFER_CAPACITY
property: app.redis.pubsub.buffer-capacity
owner_module: adapter-outbound-cache-redis
type: integer
default: 1024
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_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
# Applied only when present: RedisTopologyClientFactory sets the sentinel credentials provider
# through ifPresent, so a Sentinel deployment whose sentinels accept unauthenticated discovery
# starts without it. The unconditional "app.redis.mode=sentinel" this used to declare was a
# requirement the runtime never enforced.
required_when: app.redis.mode=sentinel and the sentinels require authentication
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
# Falls back to app.redis.nodes by design, so a deployment that points nodes at its sentinels
# and says nothing else is the common case rather than a misconfiguration.
required_when: app.redis.mode=sentinel and app.redis.nodes does not list the sentinels
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
# A key manager is configured only when this is present. Ordinary one-way TLS needs no client
# certificate, so requiring one whenever TLS is on was a claim the runtime never made.
required_when: app.redis.tls.enabled=true and the server requires 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
# A relationship between two settings rather than a switch: a client certificate without its
# key cannot build a key manager. Enforced in RedisSdkSettings.validate and covered by
# RedisSdkSettingsTest, which is where the registry's prose conditions are proven.
required_when: app.redis.tls.client-certificate-resource is configured
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
# Disabling this accepts any certificate the trust material signs, for any 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
# A trust manager is installed only when this is present; otherwise the JDK default trust
# anchors apply, which is enough for a server certificate from a public CA.
required_when: app.redis.tls.enabled=true and the server certificate is not publicly trusted
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 표
# DEPRECATED 2026-08-10: this was a second Redis master switch, and the settings class that
# bound it was removed with the previous Redis generation, so the key reached nothing.
# APP_REDIS_ENABLED is the sole global activation authority; the cache role is selected by
# ca-skeleton.capabilities.cache.bindings.default. The row is kept rather than deleted so a
# deployment still setting this key can be told what replaced it.
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
# DEPRECATED 2026-08-10: the settings class that bound this property was removed
# with the previous Redis generation, so the key reached nothing. The row is kept
# (not deleted) so a deployment still setting it can be told what replaced it.
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
# DEPRECATED 2026-08-10: the settings class that bound this property was removed
# with the previous Redis generation, so the key reached nothing. The row is kept
# (not deleted) so a deployment still setting it can be told what replaced it.
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
# DEPRECATED 2026-08-10: the settings class that bound this property was removed
# with the previous Redis generation, so the key reached nothing. The row is kept
# (not deleted) so a deployment still setting it can be told what replaced it.
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
# DEPRECATED 2026-08-10: the settings class that bound this property was removed
# with the previous Redis generation, so the key reached nothing. The row is kept
# (not deleted) so a deployment still setting it can be told what replaced it.
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
# DEPRECATED 2026-08-10: the cache no longer owns a Redis client of its own, so no code reads this.
# Replaced by: app.redis.tls.trust-material-resource (APP_REDIS_TLS_TRUST_MATERIAL_RESOURCE), which the one Redis client uses for every 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
# DEPRECATED 2026-08-10: the settings class that bound this property was removed
# with the previous Redis generation, so the key reached nothing. The row is kept
# (not deleted) so a deployment still setting it can be told what replaced it.
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
# DEPRECATED 2026-08-10: the settings class that bound this property was removed
# with the previous Redis generation, so the key reached nothing. The row is kept
# (not deleted) so a deployment still setting it can be told what replaced it.
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
# DEPRECATED 2026-08-10: the settings class that bound this property was removed
# with the previous Redis generation, so the key reached nothing. The row is kept
# (not deleted) so a deployment still setting it can be told what replaced it.
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
# DEPRECATED 2026-08-10: the settings class that bound this property was removed
# with the previous Redis generation, so the key reached nothing. The row is kept
# (not deleted) so a deployment still setting it can be told what replaced it.
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: base64_min_32_bytes_when_redis_enabled
compatibility_impact: additive
required_test: cache-contract:redis-hmac-secret-bounded
- name: APP_CACHE_REDIS_COMMAND_TIMEOUT
# DEPRECATED 2026-08-10: the settings class that bound this property was removed
# with the previous Redis generation, so the key reached nothing. The row is kept
# (not deleted) so a deployment still setting it can be told what replaced it.
deprecated_orphaned: true
removal_deadline: 2026-11-30
type: duration
default: 2s
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
# DEPRECATED 2026-08-10: the settings class that bound this property was removed
# with the previous Redis generation, so the key reached nothing. The row is kept
# (not deleted) so a deployment still setting it can be told what replaced it.
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
# DEPRECATED 2026-08-10: the settings class that bound this property was removed
# with the previous Redis generation, so the key reached nothing. The row is kept
# (not deleted) so a deployment still setting it can be told what replaced it.
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: null
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
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
# DEPRECATED 2026-08-10: the cache no longer renders its own key prefix. Four capabilities
# each joining two free-form tokens produced four prefixes, and the ACL pattern that was meant
# to fence the deployment in matched none of them. The row is kept (not deleted) so a
# deployment still setting it can be told what replaced it.
# Replaced by: app.redis.namespace.environment (APP_REDIS_NAMESPACE_ENVIRONMENT), shared by
# every 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
# DEPRECATED 2026-08-10: the settings class that bound this property was removed
# with the previous Redis generation, so the key reached nothing. The row is kept
# (not deleted) so a deployment still setting it can be told what replaced it.
deprecated_orphaned: true
removal_deadline: 2026-11-30
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
# DEPRECATED 2026-08-10: the settings class that bound this property was removed
# with the previous Redis generation, so the key reached nothing. The row is kept
# (not deleted) so a deployment still setting it can be told what replaced it.
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
# DEPRECATED 2026-08-10: the settings class that bound this property was removed
# with the previous Redis generation, so the key reached nothing. The row is kept
# (not deleted) so a deployment still setting it can be told what replaced it.
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
# DEPRECATED 2026-08-10: the settings class that bound this property was removed
# with the previous Redis generation, so the key reached nothing. The row is kept
# (not deleted) so a deployment still setting it can be told what replaced it.
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
# DEPRECATED 2026-08-10: the settings class that bound this property was removed
# with the previous Redis generation, so the key reached nothing. The row is kept
# (not deleted) so a deployment still setting it can be told what replaced it.
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
# DEPRECATED 2026-08-10: the settings class that bound this property was removed
# with the previous Redis generation, so the key reached nothing. The row is kept
# (not deleted) so a deployment still setting it can be told what replaced it.
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
# DEPRECATED 2026-08-10: the settings class that bound this property was removed
# with the previous Redis generation, so the key reached nothing. The row is kept
# (not deleted) so a deployment still setting it can be told what replaced it.
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
# DEPRECATED 2026-08-10: the settings class that bound this property was removed
# with the previous Redis generation, so the key reached nothing. The row is kept
# (not deleted) so a deployment still setting it can be told what replaced it.
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
# DEPRECATED 2026-08-10: the settings class that bound this property was removed
# with the previous Redis generation, so the key reached nothing. The row is kept
# (not deleted) so a deployment still setting it can be told what replaced it.
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
# DEPRECATED 2026-08-10: the settings class that bound this property was removed
# with the previous Redis generation, so the key reached nothing. The row is kept
# (not deleted) so a deployment still setting it can be told what replaced it.
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
# DEPRECATED 2026-08-10: the settings class that bound this property was removed
# with the previous Redis generation, so the key reached nothing. The row is kept
# (not deleted) so a deployment still setting it can be told what replaced it.
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
# === Messaging / Kafka (feature-domain-event-outbox-contract + integration-adapter-templates) ===
- name: APP_MESSAGING_BROKER
# source: messaging multi-broker redesign 2026-06-16 — single active broker selection
# (app.messaging.broker=<brokerId>); blank = messaging disabled. Replaces the former
# Kafka-binary APP_MESSAGING_KAFKA_ENABLED. Adding a broker is new files only.
type: string
# The Kafka module's config/module-defaults/messaging.yml defaults it to kafka, the only registered broker.
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
# Explicit logical producing-service identity for IntegrationEventPublishPort.
# Blank/absent = canonical platform bridge is not exposed; identity is never inferred.
type: string
default: null
allowed_values: null
classification: public-config
required: false
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 필요)
# Also feeds app.messaging.brokers.kafka.bootstrap-servers (the messaging platform's Kafka
# transport) through the Kafka module's config/module-defaults/messaging.yml, so one key
# addresses both paths. spring.kafka.bootstrap-servers is not read.
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
# === Notification adapters (feature-integration-adapter-templates) ===
- name: APP_NOTIFICATION_SLACK_WEBHOOK_ENABLED
# source: R0 Slack webhook provider gate; maps to 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 gate; maps to 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 platform (app.httpclient.*) ===
#
# Only the enabled key is registered here. The per-client surface is an indexed list whose
# element cannot be templated in application.yml without materialising a nameless client in every
# deployment, so it has no deployment-independent value for this registry to hold and is
# registered in docs/httpclient/env-fields.yaml instead. That manifest is derived from
# HttpClientPlatformSettings and enforced in both directions: a field with no entry fails
# HttpClientPlatformEnvManifestTest, and an APP_HTTPCLIENT_ variable with no field fails startup.
- name: APP_HTTPCLIENT_ENABLED
# 2026-09-25 capability packaging: the module is on when present (its own config yml maps
# this key with default true); false is the explicit off. Absent from the build is the
# ordinary off state.
# While false the platform block is not bound at all: the auto-configuration that
# binds it is not processed, so no bean, connection pool, TLS context, credential, thread or
# gateway exists, and a malformed HTTP client setting cannot fail this deployment's startup.
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
# How long a retired runtime generation may keep draining after a certificate rotation before
# its connection pool is closed underneath whatever is still in flight. Rotation replaces a
# generation rather than mutating material in place, because a pool holds sockets established
# under the previous identity; this value is how long the old identity is allowed to finish.
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 packaging: the module is on when present (its own config yml maps
# this key with default true); false is the explicit off. Absent from the build is the
# ordinary off state.
# While false the platform block is not bound at all: the auto-configuration that
# binds it is not processed, so no bean, route, thread, schema check or filesystem call exists.
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 owner; must be unique per instance. The startup gate treats the default as
# single-instance and refuses a shared-metadata claim it cannot support.
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 applied to a request that does not name one.
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_STORAGE_ROOT
# Absolute path on its own volume. A relative root resolves against the process working
# directory, which differs between a container and a test, so it is refused.
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 fails startup when the probe cannot prove an atomic rename.
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
# Bounds every transfer allocation, so resident bytes never scale with file 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
# A storage root under a web root turns every upload into a published file; under a config
# root, into a configuration change. Both are refused at binding time.
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
# Also drives spring.servlet.multipart.max-file-size. One placeholder for both: a smaller
# servlet ceiling rejects the upload before any Fileserver code, including its error mapping.
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
# Quota reserved for an upload that does not declare its length.
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
# Ceiling on parts in one multipart/batch request.
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
# Lifetime of an upload resource before it is reclaimable.
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
# Lifetime of a quota reservation whose upload never completed.
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. Renewed at one third of this while a transfer runs; a transfer that cannot
# renew is fenced out before its next physical write.
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
# When true a raw upload without Content-Length is refused with 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 emitted on every download response.
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 rendering is off by default; scriptable content is forced to attachment regardless.
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
# Multi-range is opt-in; above one the response is 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
# Applies to the single-range profile too, so the ceiling is not inert in the default
# configuration that almost every deployment runs.
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
# Changes only where bytes are copied, never a header or a status.
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
# Below this the syscall setup costs more than it saves.
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
# Bounded transfer pool; rejection becomes a retryable 429, never caller-runs.
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
# Upper bound of the transfer 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
# Bounded queue; an unbounded one trades a fast 429 for eventual heap exhaustion.
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
# Shutdown drain and per-transfer caller wait.
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
# No permissive default. `required` fails startup unless the deployment supplies a
# FileAccessPolicy bean; `unenforced` is refused under a 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
# Roles accepted for read operations under the role-based policy.
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
# Roles accepted for write operations under the role-based policy.
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
# Roles accepted for the management plane. Admin routes additionally require this role at the
# servlet chain, not only in application policy.
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
# Whole-chain verification budget for one upload.
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
# When true a file whose type could not be determined is refused rather than published.
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
# When true scriptable content is accepted instead of quarantined; only safe when downloads
# are never served inline from a trusted origin.
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
# Concurrent uploads admitted per instance.
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
# Concurrent uploads admitted per caller (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
# Concurrent direct downloads admitted per instance.
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
# Storage fraction at which new uploads start being shed.
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
# Storage fraction at which every upload is refused.
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_ADMIN_ENABLED
# Management plane, a separate decision from the data plane. Requires APP_FILESERVER_PLATFORM_ENABLED too:
# enabling it alone now does nothing instead of half-building a bean graph.
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
# How long an unreferenced object must exist before a scan may name it; anything younger is
# assumed mid-commit rather than abandoned.
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
# Background reclamation. Off by default because the worker deletes physical objects.
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_CLEANUP_INTERVAL
# Fixed delay between batches; sole owner of the schedule, with no @Scheduled placeholder
# carrying a second default.
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
# Item ceiling for one batch, so a backlog cannot monopolise the 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
# Byte ceiling for one 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
# Delay before a failed cleanup item is retried.
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. Requires APP_FILESERVER_PLATFORM_ENABLED too.
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
# Unratified draft whose contract can change without notice. Requires APP_FILESERVER_PLATFORM_ENABLED too.
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
# Front-proxy delegation. Startup attests the internal mapping by exercising it; a mapping the
# proxy cannot resolve answers 200 with an empty body, so it fails closed instead.
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
# Internal location the proxy resolves to the storage 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
# Suffix appended to the sharded object key in the internal URI.
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
# Below this the request is served by the application rather than delegated.
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
# When false neither the metrics port nor the fingerprint is created, and no key is required.
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
# Keyed HMAC over file identifiers. An unkeyed digest of an enumerable identifier is
# reversible, so startup fails while metrics are on and this is blank.
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
# === File / Upload (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
# === Notification delivery platform (NTF-025 — configuration surface) ===
# The tree exists in application.yml as ca-skeleton.notification.platform, disabled by
# default. Every key carries an inline default so a deployment that leaves the platform off
# supplies nothing. Reference: docs/notification/configuration.md.
- name: APP_PERSISTENCE_JPA_ENABLED
# source: five-adapter-runtime-remediation §5.1 — switch for relational persistence, shipped by
# the persistence-jpa module itself (config/module-defaults/persistence-jpa.yml). The module is
# selected by one build line and is on while present; false switches off this module's beans
# (entity scan, repositories, stores, startup guards). Removing the build line removes the
# capability and this key's only reader. The old app.jpa-platform.enabled gated three add-on
# beans while reading like this one.
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: 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_ORDER_INSERTS
property: spring.jpa.properties.hibernate.order_inserts
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_JPA_HIBERNATE_ORDER_UPDATES
property: spring.jpa.properties.hibernate.order_updates
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_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 packaging: the module is on when present (its own config yml maps
# this key with default true); false is the explicit off. Absent from the build is the
# ordinary off state.
# source: five-adapter-runtime-remediation §5.1 — on/off key for MongoDB persistence.
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 — selects exactly one Mongo profile. The runtime
# builds one sync client and one pool; a profile present in the map but not selected has neither
# its secret resolved nor a client created.
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 consumes this native key as
# spring.mongodb.uri. It is one of two valid connection sources; the alternate is the selected
# typed profile's uri-secret resolved through MongoCredentialResolver.
type: string
default: null
allowed_values: null
classification: sensitive-config
required: false
required_when: ca-skeleton.persistence-mongo.enabled=true AND no active-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 packaging: the module is on when present (its own config yml maps
# this key with default true); false is the explicit off. Absent from the build is the
# ordinary off state.
# source: five-adapter-runtime-remediation §5.1 — on/off key for broker publication.
# APP_MESSAGING_BROKER selects which transport and is no longer the de-facto switch.
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
# === Optional WebSocket build-composition contract ===
# These keys map directly to app.websocket.* when the websocket leaf is present in a chosen
# composition. The default bootJar does not contain that leaf; presence remains a build-time
# decision and these rows do not imply runtime membership.
- name: APP_WEBSOCKET_ENABLED
# 2026-09-25 capability packaging: the module is on when present (its own config yml maps
# this key with default true); false is the explicit off. Absent from the build is the
# ordinary off state.
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_GRAPHQL_ENABLED
# 2026-09-25 capability packaging: the module is on when present (its own config yml maps
# this key with default true); false is the explicit off. Absent from the build is the
# ordinary off state.
# source: five-adapter-runtime-remediation §5.1 — on/off key for the GraphQL transport.
# false publishes no /graphql route, including the one Spring GraphQL would publish by itself.
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 — replaces backend.graphql.production
# and backend.graphql.environment, which defaulted to production=false with
# environment=PRODUCTION_PUBLIC and let anonymous-principal and allow-by-default authorization
# read one axis while the other claimed 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: backend.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: backend.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: backend.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: backend.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: backend.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: backend.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: backend.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: backend.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: backend.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_OUTBOX_ENABLED
# source: five-adapter-runtime-remediation §6.1 JPA-INT-004 — the outbox capability switch.
# relay-enabled below only starts the scheduler; conflating the two meant a relay-off deployment
# still assembled outbox metrics over a store port a database-less runtime does not have.
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_CANONICAL_TRANSPORT_ENABLED
# source: MSG-015 transport-only cutover 2026-09-18
# Enables canonical outbox rows/platform transport without switching publication authority.
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: additive
required_test: app-bootstrap:outbox-canonical-transport-gate
- name: APP_OUTBOX_RELAY_ENABLED
# source: five-adapter-runtime-remediation §6.3 MSG-INT-001 — starts the relay scheduler.
# Requires APP_OUTBOX_ENABLED, APP_PERSISTENCE_JPA_ENABLED and APP_MESSAGING_ENABLED with a
# broker; the shipped default was true beside a blank broker, which refused every startup.
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 packaging: the notification-platform module is on when present (its
# config/module-defaults/notification.yml maps this key with default true); false is the
# explicit off and binds nothing at all. Absent from the build is the ordinary off state.
# 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_CONTACT_ENCRYPTION_KEY
# source: NTF-INT-007 — Encrypts recipient contact points at rest — addresses and phone numbers.
# Full row owned by secrets-classification.yaml. Bound by
# ca-skeleton.notification.platform.secrets.contact-encryption-key; the platform decodes it at startup and
# refuses to boot if it is blank, shorter than 32 bytes, or equal to another purpose's 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 over contact points, so a lookup never needs the plaintext.
# Full row owned by secrets-classification.yaml. Bound by
# ca-skeleton.notification.platform.secrets.contact-lookup-hmac-key; the platform decodes it at startup and
# refuses to boot if it is blank, shorter than 32 bytes, or equal to another purpose's 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 — Signs the callback URLs a provider posts delivery outcomes back to.
# Full row owned by secrets-classification.yaml. Bound by
# ca-skeleton.notification.platform.secrets.callback-signing-key; the platform decodes it at startup and
# refuses to boot if it is blank, shorter than 32 bytes, or equal to another purpose's 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 — Encrypts stored provider credentials, which are themselves secrets.
# Full row owned by secrets-classification.yaml. Bound by
# ca-skeleton.notification.platform.secrets.provider-credential-key; the platform decodes it at startup and
# refuses to boot if it is blank, shorter than 32 bytes, or equal to another purpose's 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 — Encrypts notification variables and retained callback bodies at rest.
# Full row owned by secrets-classification.yaml. Bound by
# ca-skeleton.notification.platform.secrets.payload-encryption-key; the platform decodes it at startup and
# refuses to boot if it is blank, shorter than 32 bytes, or equal to another purpose's 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 — Keyed hash of provider request ids, which are provider-side identifiers.
# Full row owned by secrets-classification.yaml. Bound by
# ca-skeleton.notification.platform.secrets.provider-request-lookup-hmac-key; the platform decodes it at startup and
# refuses to boot if it is blank, shorter than 32 bytes, or equal to another purpose's 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 — Keyed fingerprint of callback bodies, used to detect replays.
# Full row owned by secrets-classification.yaml. Bound by
# ca-skeleton.notification.platform.secrets.callback-fingerprint-hmac-key; the platform decodes it at startup and
# refuses to boot if it is blank, shorter than 32 bytes, or equal to another purpose's 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 — the id written into every envelope the CONTACT_ENCRYPTION key produces.
# An identifier, not key material, so it is public-config; the material itself is the
# APP_NOTIFICATION_PLATFORM_CONTACT_ENCRYPTION_KEY row above. Bound into
# ca-skeleton.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 — the id written into every envelope the CONTACT_LOOKUP_HMAC key produces.
# An identifier, not key material, so it is public-config; the material itself is the
# APP_NOTIFICATION_PLATFORM_CONTACT_LOOKUP_HMAC_KEY row above. Bound into
# ca-skeleton.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 — the id written into every envelope the CALLBACK_SIGNING key produces.
# An identifier, not key material, so it is public-config; the material itself is the
# APP_NOTIFICATION_PLATFORM_CALLBACK_SIGNING_KEY row above. Bound into
# ca-skeleton.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 — the id written into every envelope the PROVIDER_CREDENTIAL key produces.
# An identifier, not key material, so it is public-config; the material itself is the
# APP_NOTIFICATION_PLATFORM_PROVIDER_CREDENTIAL_KEY row above. Bound into
# ca-skeleton.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 — the id written into every envelope the PAYLOAD_ENCRYPTION key produces.
# An identifier, not key material, so it is public-config; the material itself is the
# APP_NOTIFICATION_PLATFORM_PAYLOAD_ENCRYPTION_KEY row above. Bound into
# ca-skeleton.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 — the id written into every envelope the PROVIDER_REQUEST_LOOKUP_HMAC key produces.
# An identifier, not key material, so it is public-config; the material itself is the
# APP_NOTIFICATION_PLATFORM_PROVIDER_REQUEST_LOOKUP_HMAC_KEY row above. Bound into
# ca-skeleton.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 — the id written into every envelope the CALLBACK_FINGERPRINT_HMAC key produces.
# An identifier, not key material, so it is public-config; the material itself is the
# APP_NOTIFICATION_PLATFORM_CALLBACK_FINGERPRINT_HMAC_KEY row above. Bound into
# ca-skeleton.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 — shipped SES dispatch assembler.
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 — shipped SES dispatch assembler.
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 — shipped SES dispatch assembler.
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 — shipped SES dispatch assembler.
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 — shipped SES dispatch assembler.
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 — shipped SES dispatch assembler.
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 — shipped SES dispatch assembler.
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 — shipped SES dispatch assembler.
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 — shipped SES dispatch assembler.
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 — shipped SES dispatch assembler.
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 — shipped SES dispatch assembler.
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 — shipped SES dispatch assembler.
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 — SNS topics whose SES event callbacks the
# shipped SES profile accepts. A valid SNS signature only proves AWS sent the message and
# anyone can own a topic, so binding fails when callbacks are enabled and this is empty.
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 — on/off key of the shipped SMTP provider profile; false means assembly skips it entirely.
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 — whether this profile is the primary route for EMAIL; exactly one primary per channel.
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 — the profile's declared environment, carried on every dispatch record.
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 — the credential profile the relay's credentials are resolved through.
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 — per-attempt provider timeout for this profile.
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 — how many attempts this profile may have in flight.
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 — the profile's attempt rate limit.
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 — the envelope sender every message is sent as.
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 — size of the bounded executor SMTP sends run on.
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 — native Spring Mail transport
# consumed by the JavaMailSender that the shipped SMTP assembler validates and uses.
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 — native Spring Mail transport
# consumed by the JavaMailSender that the shipped SMTP assembler validates and uses.
property: spring.mail.port
owner_module: adapter-outbound-notification
type: integer
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: 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 — native Spring Mail transport
# consumed by the JavaMailSender that the shipped SMTP assembler validates and uses.
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 — native Spring Mail transport
# consumed by the JavaMailSender that the shipped SMTP assembler validates and uses.
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 — native Spring Mail transport
# consumed by the JavaMailSender that the shipped SMTP assembler validates and uses.
property: spring.mail.properties.mail.smtp.starttls.enable
owner_module: adapter-outbound-notification
type: boolean
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: 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 — native Spring Mail transport
# consumed by the JavaMailSender that the shipped SMTP assembler validates and uses.
property: spring.mail.properties.mail.smtp.starttls.required
owner_module: adapter-outbound-notification
type: boolean
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: 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 — native Spring Mail transport
# consumed by the JavaMailSender that the shipped SMTP assembler validates and uses.
property: spring.mail.properties.mail.smtp.connectiontimeout
owner_module: adapter-outbound-notification
type: integer
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: 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 — native Spring Mail transport
# consumed by the JavaMailSender that the shipped SMTP assembler validates and uses.
property: spring.mail.properties.mail.smtp.timeout
owner_module: adapter-outbound-notification
type: integer
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: 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 — native Spring Mail transport
# consumed by the JavaMailSender that the shipped SMTP assembler validates and uses.
property: spring.mail.properties.mail.smtp.writetimeout
owner_module: adapter-outbound-notification
type: integer
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: 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 — whether /v3/api-docs is served; application-prod.yml pins it false. Stated rather than defaulted because
# SpringDoc warns on every startup until a deployment decides, and a warning on every start is
# one nobody reads.
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 — whether the Swagger UI is served; application-prod.yml pins it false. Stated rather than defaulted because
# SpringDoc warns on every startup until a deployment decides, and a warning on every start is
# one nobody reads.
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 refuses to start without a working provider; INGEST_ONLY stores and does not dispatch.
# The constant is INGEST_ONLY. This row said ACCEPT_ONLY, a name NotificationPlatformMode has
# never had, so an operator following the registry got a binding failure naming a value the
# documentation does not mention. NotificationModeSsotTest derives the list below from the 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 — how many recipient deliveries one scheduler pass claims; 1..1000, refused outside that at binding
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 — must outlast a provider call plus its timeout, or a live worker's delivery is claimed by a second one
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 — how often the scheduler asks for work when the last pass claimed nothing
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 — ceiling on in-flight provider calls across the whole process
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 — retries after the first attempt; 0 means one attempt and no retry
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 — dispatch latency estimate used by lease/retry planning
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 — after this, a queued delivery expires rather than being sent late
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 — an ambiguous attempt reached the provider with an unread outcome; falling back risks a duplicate send
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 — upper bound for worker drain during process termination
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 — readiness threshold for due and unclaimed deliveries
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 threshold for the oldest due delivery
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 — readiness threshold for expired/stuck delivery leases
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 — readiness threshold for unapplied provider-event projections
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 — readiness threshold for failed provider-event projections
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 — readiness threshold for the oldest pending projection
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 — readiness threshold for the oldest unresolved reconciliation
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 — whether the platform exposes provider callback endpoints
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 — ceiling is 65508 = ciphertext column minus AES-GCM nonce and tag; larger is refused at binding
type: integer
default: 65508
allowed_values: null
classification: public-config
required: false
reload_policy: restart-only
owner_branch: worktree-notification-platform
validation: integer_1_to_65508
compatibility_impact: behavior-change
required_test: adapter-contract:notification-callback-body-bound
- name: APP_NOTIFICATION_PLATFORM_CALLBACK_TRUSTED_PROXIES
# source: NTF-001 — peers whose forwarded headers may be believed when reconstructing the URL a
# provider signed. Empty means the resolver uses what the container observed; honouring
# forwarded headers unconditionally would let any caller pick the URL its signature is checked
# against, which defeats the signature.
type: csv
default: ""
allowed_values: null
classification: security-relevant
required: false
reload_policy: restart-only
owner_branch: worktree-notification-platform
validation: none
compatibility_impact: behavior-change
required_test: adapter-contract:notification-callback-url-resolution
- name: APP_NOTIFICATION_PLATFORM_CALLBACK_REPLAY_SKEW
# source: NTF-025 — how far a callback timestamp may differ from local time before it is treated as a replay
type: duration
default: 5m
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