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