Files
clean-architecture-backend-…/docs/objectstorage/env-fields.yaml
donghyeon-kaandClaude Opus 5.5 64a8391889 review-followup Wave 3 라운드 2(P24): fileserver·object storage 구조, S3 조건부 retire, 소유자 결정 28–31 기록
- object storage: legacy `ObjectStoragePort` 세대(byte[] 포트·legacy S3/filesystem 어댑터·`app.object-storage.legacy.*`) 삭제,
  router 어댑터 `routing/`·managed publish `kernel/`, 식별자 record 4개·bounded-token guard 하나
- S3 retire를 버전 ID 조건 삭제로 구현(MinIO에서 DELETE가 If-Match를 무시함을 확인), versioning 미사용 bucket 거부(P14-new-4)
- S3 응답 bridge 순서 경합 수정(P24-new-1 — P14-new-2·P16-new-4 간헐 실패의 원인)
- fileserver: 전이표를 `FileState`로, 구현 1개 인터페이스·content SPI 확장 4개·통과 gateway 삭제, 예외 17개 → `FileserverException`+코드,
  outbound 포트 `*Port`, `UploadPolicy`가 namespace·만료 결정, admin force-delete도 진행 중 upload 정리(P14-new-1)
- 보류(결정 필요): S1-#6b(fileserver 연산을 use case로 → `@RequiresPermission` 이중 gate), S1-#18b inbound 절반
- 현황표: 소유자 결정 28–31(INTERNAL_ERROR retryable=false, messaging 테스트 snakeyaml, 변경 모듈만 실행 안 함, cosign 서명), P27·P28 묶음 추가

검증: ./gradlew check architectureCheck verifyDependencyLocks verifyPublicPathSnapshot :sample-portfolio:systemTest
:app-bootstrap:integrationTest --continue 통과(652 task, sample spotlessApply 1건 후). 묶음 worktree에서 fileserver PG lane·MinIO lane 통과

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

116 lines
7.0 KiB
YAML

# Object Storage capability — Spring field path to environment-variable template.
#
# SSOT for deployment-facing app.object-storage.* names. Map placeholders are symbolic:
# PROVIDER, DESTINATION and PROFILE are replaced by the configured map key.
#
# The Java records remain the type/default authority. ObjectStorageEnvManifestTest derives their
# field paths and fails when this manifest drifts. scan-maintenance.enabled is a conditional-only
# property and is therefore listed as an explicit extra.
fields:
- field: enabled
env: APP_OBJECT_STORAGE_ENABLED
- field: default-destination
env: APP_OBJECT_STORAGE_DEFAULT_DESTINATION
- field: providers[PROVIDER].type
env: APP_OBJECT_STORAGE_PROVIDERS_PROVIDER_TYPE
- field: providers[PROVIDER].version
env: APP_OBJECT_STORAGE_PROVIDERS_PROVIDER_VERSION
- field: providers[PROVIDER].root
env: APP_OBJECT_STORAGE_PROVIDERS_PROVIDER_ROOT
- field: providers[PROVIDER].maximum-object-bytes
env: APP_OBJECT_STORAGE_PROVIDERS_PROVIDER_MAXIMUM_OBJECT_BYTES
- field: providers[PROVIDER].chunk-bytes
env: APP_OBJECT_STORAGE_PROVIDERS_PROVIDER_CHUNK_BYTES
- field: providers[PROVIDER].s3.provider-version
env: APP_OBJECT_STORAGE_PROVIDERS_PROVIDER_S3_PROVIDER_VERSION
- field: providers[PROVIDER].s3.bucket
env: APP_OBJECT_STORAGE_PROVIDERS_PROVIDER_S3_BUCKET
- field: providers[PROVIDER].s3.region
env: APP_OBJECT_STORAGE_PROVIDERS_PROVIDER_S3_REGION
- field: providers[PROVIDER].s3.expected-owner
env: APP_OBJECT_STORAGE_PROVIDERS_PROVIDER_S3_EXPECTED_OWNER
- field: providers[PROVIDER].s3.deployment-identity
env: APP_OBJECT_STORAGE_PROVIDERS_PROVIDER_S3_DEPLOYMENT_IDENTITY
- field: providers[PROVIDER].s3.endpoint-override
env: APP_OBJECT_STORAGE_PROVIDERS_PROVIDER_S3_ENDPOINT_OVERRIDE
- field: providers[PROVIDER].s3.addressing
env: APP_OBJECT_STORAGE_PROVIDERS_PROVIDER_S3_ADDRESSING
- field: providers[PROVIDER].s3.auto-create-bucket
env: APP_OBJECT_STORAGE_PROVIDERS_PROVIDER_S3_AUTO_CREATE_BUCKET
- field: providers[PROVIDER].s3.public-acl
env: APP_OBJECT_STORAGE_PROVIDERS_PROVIDER_S3_PUBLIC_ACL
- field: providers[PROVIDER].s3.credentials.mode
env: APP_OBJECT_STORAGE_PROVIDERS_PROVIDER_S3_CREDENTIALS_MODE
- field: providers[PROVIDER].s3.credentials.access-key-environment
env: APP_OBJECT_STORAGE_PROVIDERS_PROVIDER_S3_CREDENTIALS_ACCESS_KEY_ENVIRONMENT
- field: providers[PROVIDER].s3.credentials.secret-key-environment
env: APP_OBJECT_STORAGE_PROVIDERS_PROVIDER_S3_CREDENTIALS_SECRET_KEY_ENVIRONMENT
- field: providers[PROVIDER].s3.timeouts.api-call
env: APP_OBJECT_STORAGE_PROVIDERS_PROVIDER_S3_TIMEOUTS_API_CALL
- field: providers[PROVIDER].s3.timeouts.api-attempt
env: APP_OBJECT_STORAGE_PROVIDERS_PROVIDER_S3_TIMEOUTS_API_ATTEMPT
- field: providers[PROVIDER].s3.timeouts.connect
env: APP_OBJECT_STORAGE_PROVIDERS_PROVIDER_S3_TIMEOUTS_CONNECT
- field: providers[PROVIDER].s3.timeouts.tls-negotiation
env: APP_OBJECT_STORAGE_PROVIDERS_PROVIDER_S3_TIMEOUTS_TLS_NEGOTIATION
- field: providers[PROVIDER].s3.timeouts.acquire
env: APP_OBJECT_STORAGE_PROVIDERS_PROVIDER_S3_TIMEOUTS_ACQUIRE
- field: providers[PROVIDER].s3.timeouts.read
env: APP_OBJECT_STORAGE_PROVIDERS_PROVIDER_S3_TIMEOUTS_READ
- field: providers[PROVIDER].s3.timeouts.write
env: APP_OBJECT_STORAGE_PROVIDERS_PROVIDER_S3_TIMEOUTS_WRITE
- field: providers[PROVIDER].s3.pool.maximum-concurrency
env: APP_OBJECT_STORAGE_PROVIDERS_PROVIDER_S3_POOL_MAXIMUM_CONCURRENCY
- field: providers[PROVIDER].s3.pool.maximum-pending-acquires
env: APP_OBJECT_STORAGE_PROVIDERS_PROVIDER_S3_POOL_MAXIMUM_PENDING_ACQUIRES
- field: providers[PROVIDER].s3.retry.maximum-attempts
env: APP_OBJECT_STORAGE_PROVIDERS_PROVIDER_S3_RETRY_MAXIMUM_ATTEMPTS
- field: providers[PROVIDER].s3.retry.base-delay
env: APP_OBJECT_STORAGE_PROVIDERS_PROVIDER_S3_RETRY_BASE_DELAY
- field: providers[PROVIDER].s3.retry.maximum-backoff
env: APP_OBJECT_STORAGE_PROVIDERS_PROVIDER_S3_RETRY_MAXIMUM_BACKOFF
- field: providers[PROVIDER].s3.shutdown-grace
env: APP_OBJECT_STORAGE_PROVIDERS_PROVIDER_S3_SHUTDOWN_GRACE
- field: providers[PROVIDER].s3.binding-revision
env: APP_OBJECT_STORAGE_PROVIDERS_PROVIDER_S3_BINDING_REVISION
- field: providers[PROVIDER].s3.evidence-revision
env: APP_OBJECT_STORAGE_PROVIDERS_PROVIDER_S3_EVIDENCE_REVISION
- field: providers[PROVIDER].s3.capability-profiles[PROFILE].status
env: APP_OBJECT_STORAGE_PROVIDERS_PROVIDER_S3_CAPABILITY_PROFILES_PROFILE_STATUS
- field: providers[PROVIDER].s3.capability-profiles[PROFILE].source
env: APP_OBJECT_STORAGE_PROVIDERS_PROVIDER_S3_CAPABILITY_PROFILES_PROFILE_SOURCE
- field: providers[PROVIDER].s3.capability-profiles[PROFILE].evidence-digest
env: APP_OBJECT_STORAGE_PROVIDERS_PROVIDER_S3_CAPABILITY_PROFILES_PROFILE_EVIDENCE_DIGEST
- field: providers[PROVIDER].s3.capability-profiles[PROFILE].observed-at
env: APP_OBJECT_STORAGE_PROVIDERS_PROVIDER_S3_CAPABILITY_PROFILES_PROFILE_OBSERVED_AT
- field: providers[PROVIDER].s3.capability-profiles[PROFILE].valid-until
env: APP_OBJECT_STORAGE_PROVIDERS_PROVIDER_S3_CAPABILITY_PROFILES_PROFILE_VALID_UNTIL
- field: providers[PROVIDER].s3.capability-profiles[PROFILE].provider-and-deployment-identity
env: APP_OBJECT_STORAGE_PROVIDERS_PROVIDER_S3_CAPABILITY_PROFILES_PROFILE_PROVIDER_AND_DEPLOYMENT_IDENTITY
- field: providers[PROVIDER].s3.capability-profiles[PROFILE].capabilities
env: APP_OBJECT_STORAGE_PROVIDERS_PROVIDER_S3_CAPABILITY_PROFILES_PROFILE_CAPABILITIES
- field: providers[PROVIDER].s3.capability-profiles[PROFILE].limitations
env: APP_OBJECT_STORAGE_PROVIDERS_PROVIDER_S3_CAPABILITY_PROFILES_PROFILE_LIMITATIONS
- field: destinations[DESTINATION].provider-ref
env: APP_OBJECT_STORAGE_DESTINATIONS_DESTINATION_PROVIDER_REF
- field: destinations[DESTINATION].route-token
env: APP_OBJECT_STORAGE_DESTINATIONS_DESTINATION_ROUTE_TOKEN
- field: destinations[DESTINATION].binding-revision
env: APP_OBJECT_STORAGE_DESTINATIONS_DESTINATION_BINDING_REVISION
- field: destinations[DESTINATION].policy-revision
env: APP_OBJECT_STORAGE_DESTINATIONS_DESTINATION_POLICY_REVISION
- field: destinations[DESTINATION].publication-requirement
env: APP_OBJECT_STORAGE_DESTINATIONS_DESTINATION_PUBLICATION_REQUIREMENT
- field: destinations[DESTINATION].retention-requirement
env: APP_OBJECT_STORAGE_DESTINATIONS_DESTINATION_RETENTION_REQUIREMENT
- field: destinations[DESTINATION].encryption-requirement
env: APP_OBJECT_STORAGE_DESTINATIONS_DESTINATION_ENCRYPTION_REQUIREMENT
- field: destinations[DESTINATION].capability-requirements
env: APP_OBJECT_STORAGE_DESTINATIONS_DESTINATION_CAPABILITY_REQUIREMENTS
- field: destinations[DESTINATION].minimum-replay-horizon
env: APP_OBJECT_STORAGE_DESTINATIONS_DESTINATION_MINIMUM_REPLAY_HORIZON
- field: destinations[DESTINATION].operation-profile
env: APP_OBJECT_STORAGE_DESTINATIONS_DESTINATION_OPERATION_PROFILE
- field: scan-maintenance.enabled
env: APP_OBJECT_STORAGE_SCAN_MAINTENANCE_ENABLED