문제: High·P1을 고친 뒤에도 P2·P3 약 90건이 남았다. 연결·구독·메시지 크기 상한이 없는 전송(WebSocket·gRPC·GraphQL deadline), 낙관적 충돌의 500, upsert 경쟁, Mongo 무제한 timeout, 샘플 목록 N+1, 갈라진 복사본 (TenantId 3벌, 이벤트 ID 문법 5곳, SQLState 표 2벌), 문서를 읽는 PR 테스트와 캐시를 막는 lane 설정 등이다. 새 기능을 어디에 어떤 순서로 만드는지 알려 주는 문서와 도구가 없었다. MinIO 공식 이미지가 사라져 객체 저장소 lane이 돌지 않았다. 방법: 영역별 묶음으로 실패 테스트를 먼저 쓰고 고쳤다. 고치는 중에 찾은 결함도 함께 고쳤다(durable operation id가 UUIDv4라 이벤트가 전부 DEAD, S3 어댑터 생성·작은 chunk 읽기 실패, Redis 조건부 기록의 EVALSHA 권한). MinIO는 pgsty/minio를 digest로 고정했다(Chainguard는 태그·실행 사용자· mc 이미지 문제로 버림). docs/manual/에 작업 순서와 판단 지점을 쓰고, scripts/new-feature.sh가 5개 leaf에 뼈대를 만든다. 생성→빌드→통과 왕복을 verifyFeatureScaffold가 mainCheck에서 본다. 묶음별 결과와 결정은 리뷰 README 14절에 있다. 위험·한계: 파생 서비스 동작이 바뀐다. JDBC batch 50 기본, 운영 jar에서 H2 제거, 트랜잭션 30초 제한, 격리 수준을 Hikari에서 고정, gRPC· WebSocket·GraphQL 새 한도, correlation ID 규칙 밖이면 서버가 교체, 샘플 키 오류 코드 IDEMPOTENCY_KEY_INVALID. 새 leaf 두 개 (composition:durable-operation, adapter:inbound:messaging)와 새 마이그레이션(postgresql V20·V21, notification V11·V12, sample V8_1, grpc-ledger V002)이 생긴다. V21 유일 인덱스는 기존 중복이 있으면 실패한다(runbook에 확인 쿼리). 검증: ci, mainCheck(생성 명령 왕복 포함), integrationCheck(MinIO 포함 전 컨테이너 lane), -p optional-platforms ci integrationCheck 통과. Refs: docs/reviews/2026-11-01-maturity-review/README.md 14절 BREAKING CHANGE: JDBC batch 기본 켜짐, H2 운영 의존 제거, 트랜잭션 기본 제한 30초, gRPC·WebSocket·GraphQL 서버 한도 기본값 추가, 샘플 Idempotency-Key 오류 코드 변경.
5204 lines
204 KiB
YAML
5204 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 (a StartupRule, run before any other singleton)
|
|
# requires a cross-instance DistributedLockPort bean named distributedLockProvider,
|
|
# else startup fails (exit 72). 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: app.persistence.vendor
|
|
type: enum
|
|
default: postgresql
|
|
allowed_values: [postgresql, h2]
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: persistence-jpa-vendor-composition
|
|
validation: enum_strict
|
|
compatibility_impact: behavior-change
|
|
required_test: jpa-contract:local-vendor-parity
|
|
|
|
- name: APP_REALTIME_REPLAY_ENABLED
|
|
property: app.realtime.replay.enabled
|
|
owner_module: adapter-outbound-persistence-jpa
|
|
type: boolean
|
|
default: false
|
|
allowed_values: [true, false]
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: 2026-09-22-persistence-jpa-review-remediation
|
|
validation: boolean_strict
|
|
compatibility_impact: additive
|
|
required_test: jpa-contract:realtime-replay-env
|
|
|
|
- name: APP_REALTIME_REPLAY_RETENTION
|
|
property: app.realtime.replay.retention
|
|
owner_module: adapter-outbound-persistence-jpa
|
|
type: duration
|
|
default: 1h
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
required_when: APP_REALTIME_REPLAY_ENABLED=true
|
|
reload_policy: restart-only
|
|
owner_branch: 2026-09-22-persistence-jpa-review-remediation
|
|
validation: positive_duration
|
|
compatibility_impact: additive
|
|
required_test: jpa-contract:realtime-replay-env
|
|
|
|
- name: APP_FLYWAY_ENABLED
|
|
# source: 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를 기본 기준으로 둠"
|
|
# OTLP base address (OpenTelemetry spec). TracingEnvironmentPostProcessor bridges it to
|
|
# management.opentelemetry.tracing.export.otlp.endpoint as <value>/v1/traces (OTLP/HTTP);
|
|
# blank = no span exporter bean (review 07-01, 2026-11-01).
|
|
type: url
|
|
default: null
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: feature-distributed-tracing-contract
|
|
validation: url_or_empty
|
|
compatibility_impact: additive
|
|
required_test: tracing-contract:exporter-endpoint-resolvable
|
|
|
|
- name: APP_TRACING_ENABLED
|
|
# source: feature-distributed-tracing-contract 2026-05-22
|
|
# "tracing disabled profile에서도 envelope meta.traceId와 log traceId는 유지"
|
|
type: boolean
|
|
default: true
|
|
allowed_values: [true, false]
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: feature-distributed-tracing-contract
|
|
validation: boolean_strict
|
|
compatibility_impact: behavior-change
|
|
required_test: tracing-contract:meta-traceid-when-disabled
|
|
|
|
- name: APP_TRACING_SAMPLE_RATE
|
|
# source: feature-distributed-tracing-contract 2026-05-22
|
|
# "trace sampling rate default = prod 1%, dev/local 100%"
|
|
# D-1 ISSUE-1 fix (2026-06-16): blank = per-profile resolver 기본값 사용.
|
|
# RuntimeEnvironment is the profile SSOT; resolver policy is prod=0.01, dev/local=1.0.
|
|
# TracingEnvironmentPostProcessor 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 RedisRuntimeAutoConfiguration, 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 RedisRuntimeAutoConfiguration, 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 RedisRuntimeAutoConfiguration, 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 RedisRuntimeAutoConfiguration, 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 RedisRuntimeAutoConfiguration, 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 RedisRuntimeAutoConfiguration, 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 RedisRuntimeAutoConfiguration, 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
|
|
# app.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
|
|
# app.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 runtime settings (app.redis.*) ----------------------------------
|
|
# Bound only by RedisRuntimeAutoConfiguration 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_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
|
|
|
|
# --- Redis runtime composition settings (app.redis.*) ----------------------
|
|
# Authentication, Sentinel discovery, TLS, lifecycle, Cluster routing and capacity. 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_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_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 RedisRuntimeSettings.validate and covered by
|
|
# RedisRuntimeSettingsTest, 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
|
|
# app.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
|
|
# DEPRECATED 2026-11-02: no settings class binds it. Its only reader was a block in
|
|
# sample-portfolio's application.yml that nothing bound either (07-10), removed with it.
|
|
# Kept so a deployment still setting it is told it does nothing.
|
|
deprecated_orphaned: true
|
|
removal_deadline: 2027-02-28
|
|
type: float
|
|
default: 0.10
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: redis-cache-resilience
|
|
validation: decimal_0_to_0_5
|
|
compatibility_impact: additive
|
|
required_test: cache-contract:redis-ttl-jitter-bounded
|
|
|
|
- name: APP_CACHE_REDIS_MINIMUM_HARD_TTL
|
|
type: duration
|
|
default: 1s
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: redis-cache-resilience
|
|
validation: spring_duration_shorthand_non_zero_le_configured_hard_ttls
|
|
compatibility_impact: additive
|
|
required_test: cache-contract:redis-hard-ttl-minimum
|
|
|
|
- name: APP_CACHE_REDIS_NAMESPACE_ENVIRONMENT
|
|
# 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>), read by the vendored messaging platform. Replaces the
|
|
# former Kafka-binary APP_MESSAGING_KAFKA_ENABLED. The application bridge no longer reads it:
|
|
# the legacy KafkaSender seam that did was removed with the canonical outbox (2026-09-28).
|
|
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.
|
|
# Every publication, the outbox relay's included, goes through that bridge, so with the
|
|
# messaging module present and on a blank value refuses startup (2026-09-28 canonical outbox).
|
|
type: string
|
|
default: null
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
required_when: APP_MESSAGING_ENABLED=true
|
|
reload_policy: restart-only
|
|
owner_branch: feature-integration-adapter-templates
|
|
validation: none
|
|
compatibility_impact: additive
|
|
required_test: adapter-contract:messaging-platform-producer-id
|
|
|
|
- name: APP_MESSAGING_KAFKA_BROKERS
|
|
# source: feature-domain-event-outbox-contract — "Kafka는 optional integration adapter"
|
|
# (broker 활성화 시 endpoint 필요)
|
|
# Feeds app.messaging.brokers.kafka.bootstrap-servers (the messaging platform's Kafka
|
|
# transport) through the Kafka module's config/module-defaults/messaging.yml.
|
|
# 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
|
|
# FileAccessPolicyPort 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 app.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: 50
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
required_when: APP_PERSISTENCE_JPA_ENABLED=true
|
|
reload_policy: restart-only
|
|
owner_branch: 2026-09-22-persistence-jpa-review-remediation
|
|
validation: non_negative_integer
|
|
compatibility_impact: behavior-change
|
|
required_test: jpa-contract:hibernate-runtime-settings
|
|
|
|
- name: APP_JPA_HIBERNATE_ORDER_INSERTS
|
|
property: spring.jpa.properties.hibernate.order_inserts
|
|
owner_module: adapter-outbound-persistence-jpa
|
|
type: boolean
|
|
default: true
|
|
allowed_values: [true, false]
|
|
classification: public-config
|
|
required: false
|
|
required_when: APP_PERSISTENCE_JPA_ENABLED=true
|
|
reload_policy: restart-only
|
|
owner_branch: 2026-09-22-persistence-jpa-review-remediation
|
|
validation: boolean_strict
|
|
compatibility_impact: behavior-change
|
|
required_test: jpa-contract:hibernate-runtime-settings
|
|
|
|
- name: APP_JPA_HIBERNATE_ORDER_UPDATES
|
|
property: spring.jpa.properties.hibernate.order_updates
|
|
owner_module: adapter-outbound-persistence-jpa
|
|
type: boolean
|
|
default: true
|
|
allowed_values: [true, false]
|
|
classification: public-config
|
|
required: false
|
|
required_when: APP_PERSISTENCE_JPA_ENABLED=true
|
|
reload_policy: restart-only
|
|
owner_branch: 2026-09-22-persistence-jpa-review-remediation
|
|
validation: boolean_strict
|
|
compatibility_impact: behavior-change
|
|
required_test: jpa-contract:hibernate-runtime-settings
|
|
|
|
- name: APP_JPA_HIBERNATE_DEFAULT_BATCH_FETCH_SIZE
|
|
property: spring.jpa.properties.hibernate.default_batch_fetch_size
|
|
owner_module: adapter-outbound-persistence-jpa
|
|
type: integer
|
|
default: 0
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
required_when: APP_PERSISTENCE_JPA_ENABLED=true
|
|
reload_policy: restart-only
|
|
owner_branch: 2026-09-22-persistence-jpa-review-remediation
|
|
validation: non_negative_integer
|
|
compatibility_impact: additive
|
|
required_test: jpa-contract:hibernate-runtime-settings
|
|
|
|
- name: APP_JPA_HIBERNATE_GENERATE_STATISTICS
|
|
property: spring.jpa.properties.hibernate.generate_statistics
|
|
owner_module: adapter-outbound-persistence-jpa
|
|
type: boolean
|
|
default: false
|
|
allowed_values: [true, false]
|
|
classification: public-config
|
|
required: false
|
|
required_when: APP_PERSISTENCE_JPA_ENABLED=true
|
|
reload_policy: restart-only
|
|
owner_branch: 2026-09-22-persistence-jpa-review-remediation
|
|
validation: boolean_strict
|
|
compatibility_impact: additive
|
|
required_test: jpa-contract:hibernate-runtime-settings
|
|
|
|
- name: APP_PERSISTENCE_MONGO_ENABLED
|
|
# 2026-09-25 capability 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: app.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_WEBSOCKET_MESSAGE_SIZE_LIMIT
|
|
# Spring's own default, now explicit (review 03-06); at most 2147483647 bytes.
|
|
property: app.websocket.message-size-limit
|
|
owner_module: adapter-inbound-websocket
|
|
type: data_size
|
|
default: 64KB
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: 2026-11-01-maturity-review-round2
|
|
validation: positive_data_size
|
|
compatibility_impact: additive
|
|
required_test: websocket-contract:canonical-property-namespace
|
|
|
|
- name: APP_WEBSOCKET_SEND_BUFFER_SIZE_LIMIT
|
|
# Spring's own default, now explicit (review 03-06); at most 2147483647 bytes.
|
|
property: app.websocket.send-buffer-size-limit
|
|
owner_module: adapter-inbound-websocket
|
|
type: data_size
|
|
default: 512KB
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: 2026-11-01-maturity-review-round2
|
|
validation: positive_data_size
|
|
compatibility_impact: additive
|
|
required_test: websocket-contract:canonical-property-namespace
|
|
|
|
- name: APP_WEBSOCKET_SEND_TIME_LIMIT
|
|
# Spring's own default, now explicit (review 03-06); at most 2147483647 ms.
|
|
property: app.websocket.send-time-limit
|
|
owner_module: adapter-inbound-websocket
|
|
type: duration
|
|
default: 10s
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: 2026-11-01-maturity-review-round2
|
|
validation: positive_duration
|
|
compatibility_impact: additive
|
|
required_test: websocket-contract:canonical-property-namespace
|
|
|
|
- name: APP_WEBSOCKET_TIME_TO_FIRST_MESSAGE
|
|
# Spring's own default, now explicit (review 03-06); at most 2147483647 ms.
|
|
property: app.websocket.time-to-first-message
|
|
owner_module: adapter-inbound-websocket
|
|
type: duration
|
|
default: 60s
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: 2026-11-01-maturity-review-round2
|
|
validation: positive_duration
|
|
compatibility_impact: additive
|
|
required_test: websocket-contract:canonical-property-namespace
|
|
|
|
- name: APP_WEBSOCKET_MAX_CONNECTIONS
|
|
# New per-node STOMP session ceiling (review 03-06); the next session is closed with 1013. 1000 x 512KB send buffer bounds worst-case outbound buffering near 512 MiB.
|
|
property: app.websocket.max-connections
|
|
owner_module: adapter-inbound-websocket
|
|
type: integer
|
|
default: 1000
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: 2026-11-01-maturity-review-round2
|
|
validation: positive_integer
|
|
compatibility_impact: behavior-change
|
|
required_test: websocket-contract:canonical-property-namespace
|
|
|
|
- name: APP_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 app.graphql.production
|
|
# and app.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: app.graphql.validation-policy-version
|
|
owner_module: adapter-inbound-graphql
|
|
type: string
|
|
default: v1
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
required_when: APP_GRAPHQL_ENABLED=true
|
|
reload_policy: restart-only
|
|
owner_branch: 2026-09-20-inbound-graphql-review-remediation
|
|
validation: non_empty_string
|
|
compatibility_impact: additive
|
|
required_test: graphql-contract:wired-operator-settings
|
|
|
|
- name: APP_GRAPHQL_OBSERVED_OPERATION_NAMES
|
|
property: app.graphql.observed-operation-names
|
|
owner_module: adapter-inbound-graphql
|
|
type: csv
|
|
default: ""
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
required_when: APP_GRAPHQL_ENABLED=true
|
|
reload_policy: restart-only
|
|
owner_branch: 2026-09-20-inbound-graphql-review-remediation
|
|
validation: csv
|
|
compatibility_impact: additive
|
|
required_test: graphql-contract:wired-operator-settings
|
|
|
|
- name: APP_GRAPHQL_GRAPHIQL_ENABLED
|
|
property: app.graphql.console.graphiql-enabled
|
|
owner_module: adapter-inbound-graphql
|
|
type: boolean
|
|
default: false
|
|
allowed_values: [true, false]
|
|
classification: public-config
|
|
required: false
|
|
required_when: APP_GRAPHQL_ENABLED=true
|
|
reload_policy: restart-only
|
|
owner_branch: 2026-09-20-inbound-graphql-review-remediation
|
|
validation: boolean_strict
|
|
compatibility_impact: additive
|
|
required_test: graphql-contract:wired-operator-settings
|
|
|
|
- name: APP_GRAPHQL_INTROSPECTION_ENABLED
|
|
property: app.graphql.console.introspection-enabled
|
|
owner_module: adapter-inbound-graphql
|
|
type: boolean
|
|
default: false
|
|
allowed_values: [true, false]
|
|
classification: public-config
|
|
required: false
|
|
required_when: APP_GRAPHQL_ENABLED=true
|
|
reload_policy: restart-only
|
|
owner_branch: 2026-09-20-inbound-graphql-review-remediation
|
|
validation: boolean_strict
|
|
compatibility_impact: additive
|
|
required_test: graphql-contract:wired-operator-settings
|
|
|
|
- name: APP_GRAPHQL_MAXIMUM_PAGE_SIZE
|
|
property: app.graphql.limits.maximum-page-size
|
|
owner_module: adapter-inbound-graphql
|
|
type: integer
|
|
default: 100
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
required_when: APP_GRAPHQL_ENABLED=true
|
|
reload_policy: restart-only
|
|
owner_branch: 2026-09-20-inbound-graphql-review-remediation
|
|
validation: positive_integer
|
|
compatibility_impact: additive
|
|
required_test: graphql-contract:wired-operator-settings
|
|
|
|
- name: APP_GRAPHQL_MAXIMUM_COMPLEXITY
|
|
property: app.graphql.limits.maximum-complexity
|
|
owner_module: adapter-inbound-graphql
|
|
type: integer
|
|
default: 10000
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
required_when: APP_GRAPHQL_ENABLED=true
|
|
reload_policy: restart-only
|
|
owner_branch: 2026-09-20-inbound-graphql-review-remediation
|
|
validation: positive_integer
|
|
compatibility_impact: additive
|
|
required_test: graphql-contract:wired-operator-settings
|
|
|
|
- name: APP_GRAPHQL_PREPARSED_CACHE_ENTRIES
|
|
property: app.graphql.limits.preparsed-cache-entries
|
|
owner_module: adapter-inbound-graphql
|
|
type: integer
|
|
default: 1000
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
required_when: APP_GRAPHQL_ENABLED=true
|
|
reload_policy: restart-only
|
|
owner_branch: 2026-09-20-inbound-graphql-review-remediation
|
|
validation: positive_integer
|
|
compatibility_impact: additive
|
|
required_test: graphql-contract:wired-operator-settings
|
|
|
|
- name: APP_GRAPHQL_PREPARSED_CACHE_WEIGHT
|
|
property: app.graphql.limits.preparsed-cache-weight
|
|
owner_module: adapter-inbound-graphql
|
|
type: integer
|
|
default: 10000000
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
required_when: APP_GRAPHQL_ENABLED=true
|
|
reload_policy: restart-only
|
|
owner_branch: 2026-09-20-inbound-graphql-review-remediation
|
|
validation: positive_integer
|
|
compatibility_impact: additive
|
|
required_test: graphql-contract:wired-operator-settings
|
|
|
|
- name: APP_GRAPHQL_PREPARSED_CACHE_EXPIRE_AFTER_ACCESS
|
|
property: app.graphql.limits.preparsed-cache-expire-after-access
|
|
owner_module: adapter-inbound-graphql
|
|
type: duration
|
|
default: 30m
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
required_when: APP_GRAPHQL_ENABLED=true
|
|
reload_policy: restart-only
|
|
owner_branch: 2026-09-20-inbound-graphql-review-remediation
|
|
validation: positive_duration
|
|
compatibility_impact: additive
|
|
required_test: graphql-contract:wired-operator-settings
|
|
|
|
- name: APP_GRAPHQL_PER_PARENT_FETCH_WARNING_THRESHOLD
|
|
property: app.graphql.limits.per-parent-fetch-warning-threshold
|
|
owner_module: adapter-inbound-graphql
|
|
type: integer
|
|
default: 10
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
required_when: APP_GRAPHQL_ENABLED=true
|
|
reload_policy: restart-only
|
|
owner_branch: 2026-11-01-maturity-review-round2
|
|
validation: positive_integer
|
|
compatibility_impact: additive
|
|
required_test: graphql-contract:wired-operator-settings
|
|
|
|
- name: APP_OUTBOX_ENABLED
|
|
# source: five-adapter-runtime-remediation §6.1 JPA-INT-004 — 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_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
|
|
# APP_MESSAGING_PRODUCER_ID; 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_DEFAULT_LOCALE
|
|
# I-6b: the locale a submission that names none is rendered in. The accept use case applies
|
|
# it; the HTTP controller used to pick the host JVM's Locale.getDefault(), so the same request
|
|
# rendered differently per node.
|
|
type: string
|
|
default: ko-KR
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: worktree-notification-platform
|
|
validation: none
|
|
compatibility_impact: behavior-change
|
|
required_test: application-contract:notification-default-locale
|
|
|
|
- name: APP_NOTIFICATION_PLATFORM_CONTACT_ENCRYPTION_KEY
|
|
# source: NTF-INT-007 — Encrypts recipient contact points at rest — addresses and phone numbers.
|
|
# Full row owned by secrets-classification.yaml. Bound by
|
|
# app.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
|
|
# app.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
|
|
# app.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
|
|
# app.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
|
|
# app.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
|
|
# app.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
|
|
# app.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
|
|
# app.notification.platform.secrets.active-key-ids.CONTACT_ENCRYPTION.
|
|
type: string
|
|
default: null
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: worktree-notification-platform
|
|
validation: non_blank_when_platform_enabled
|
|
compatibility_impact: behavior-change
|
|
required_test: adapter-contract:notification-secret-material-required
|
|
|
|
- name: APP_NOTIFICATION_PLATFORM_CONTACT_LOOKUP_HMAC_KEY_ID
|
|
# source: NTF-INT-007 — 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
|
|
# app.notification.platform.secrets.active-key-ids.CONTACT_LOOKUP_HMAC.
|
|
type: string
|
|
default: null
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: worktree-notification-platform
|
|
validation: non_blank_when_platform_enabled
|
|
compatibility_impact: behavior-change
|
|
required_test: adapter-contract:notification-secret-material-required
|
|
|
|
- name: APP_NOTIFICATION_PLATFORM_CALLBACK_SIGNING_KEY_ID
|
|
# source: NTF-INT-007 — 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
|
|
# app.notification.platform.secrets.active-key-ids.CALLBACK_SIGNING.
|
|
type: string
|
|
default: null
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: worktree-notification-platform
|
|
validation: non_blank_when_platform_enabled
|
|
compatibility_impact: behavior-change
|
|
required_test: adapter-contract:notification-secret-material-required
|
|
|
|
- name: APP_NOTIFICATION_PLATFORM_PROVIDER_CREDENTIAL_KEY_ID
|
|
# source: NTF-INT-007 — 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
|
|
# app.notification.platform.secrets.active-key-ids.PROVIDER_CREDENTIAL.
|
|
type: string
|
|
default: null
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: worktree-notification-platform
|
|
validation: non_blank_when_platform_enabled
|
|
compatibility_impact: behavior-change
|
|
required_test: adapter-contract:notification-secret-material-required
|
|
|
|
- name: APP_NOTIFICATION_PLATFORM_PAYLOAD_ENCRYPTION_KEY_ID
|
|
# source: NTF-INT-007 — 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
|
|
# app.notification.platform.secrets.active-key-ids.PAYLOAD_ENCRYPTION.
|
|
type: string
|
|
default: null
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: worktree-notification-platform
|
|
validation: non_blank_when_platform_enabled
|
|
compatibility_impact: behavior-change
|
|
required_test: adapter-contract:notification-secret-material-required
|
|
|
|
- name: APP_NOTIFICATION_PLATFORM_PROVIDER_REQUEST_LOOKUP_HMAC_KEY_ID
|
|
# source: NTF-INT-007 — 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
|
|
# app.notification.platform.secrets.active-key-ids.PROVIDER_REQUEST_LOOKUP_HMAC.
|
|
type: string
|
|
default: null
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: worktree-notification-platform
|
|
validation: non_blank_when_platform_enabled
|
|
compatibility_impact: behavior-change
|
|
required_test: adapter-contract:notification-secret-material-required
|
|
|
|
- name: APP_NOTIFICATION_PLATFORM_CALLBACK_FINGERPRINT_HMAC_KEY_ID
|
|
# source: NTF-INT-007 — 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
|
|
# app.notification.platform.secrets.active-key-ids.CALLBACK_FINGERPRINT_HMAC.
|
|
type: string
|
|
default: null
|
|
allowed_values: null
|
|
classification: public-config
|
|
required: false
|
|
reload_policy: restart-only
|
|
owner_branch: worktree-notification-platform
|
|
validation: non_blank_when_platform_enabled
|
|
compatibility_impact: behavior-change
|
|
required_test: adapter-contract:notification-secret-material-required
|
|
|
|
- name: APP_NOTIFICATION_PLATFORM_SES_ENABLED
|
|
# source: notification/fileserver H4-B — 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_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
|