diff --git a/docs/storage-capability-boundary.md b/docs/storage-capability-boundary.md index 130fe99c..9eb6a39a 100644 --- a/docs/storage-capability-boundary.md +++ b/docs/storage-capability-boundary.md @@ -1,32 +1,27 @@ -# Fileserver vs Object Storage +# 파일 서버와 Object Storage -These capabilities overlap at the byte-storage level but own different serving boundaries. They are -not interchangeable providers for one port. +두 capability는 바이트 저장 수준에서 겹치지만 가진 서빙 경계가 다르다. port 하나의 바꿔 끼울 수 있는 provider가 아니다. -| Question | Fileserver HTTP platform | Object Storage | +| 질문 | 파일 서버 HTTP 플랫폼 | Object Storage | |---|---|---| -| Who serves bytes to the client? | This application, through Fileserver HTTP routes | This application, streaming through the semantic transfer port (no direct/presigned transfer exists) | -| Primary application contract | Upload/download/lifecycle HTTP workflow and Fileserver application ports | Provider-neutral managed and staged object-storage ports | -| Storage semantics | Application-owned staging, verification, publication, range/conditional delivery, upload leases | Managed and staged object publication plus remote-store versioning semantics | -| Local filesystem role | Certified backing store for the application-owned Fileserver platform | `filesystem-local-dev` development/provider implementation | -| Remote S3-style semantics | Not its purpose | First-class capability | +| 누가 클라이언트에 바이트를 주나? | 이 애플리케이션이 파일 서버 HTTP route로 준다 | 이 애플리케이션이 의미 수준 transfer port로 stream한다(직접·presigned 전송은 없다) | +| 주된 애플리케이션 계약 | upload/download/lifecycle HTTP 흐름과 파일 서버 애플리케이션 port | provider 중립의 managed·staged object storage port | +| 저장 의미 | 애플리케이션이 가진 staging, 검증, 게시, range·조건부 전달, upload lease | managed·staged 객체 게시와 원격 저장소의 versioning 의미 | +| 로컬 파일 시스템의 역할 | 애플리케이션이 가진 파일 서버 플랫폼의 인증된 backing store | `filesystem-local-dev` 개발용 provider 구현 | +| 원격 S3 방식의 의미 | 목적이 아니다 | 일급 capability | -## Decision rule +## 고르는 규칙 -Use **Fileserver** when the service itself owns upload/download HTTP behavior: authentication, range -and conditional requests, verification/quarantine, resumable upload state, lifecycle/admin routes, -and optional delegated serving such as X-Accel-Redirect. +서비스 자신이 upload/download HTTP 동작을 가질 때 **파일 서버**를 쓴다. 인증, range와 조건부 요청, 검증·격리, 이어 올리는 +upload 상태, lifecycle·관리 route, X-Accel-Redirect 같은 선택적 위임 서빙이다. -Use **Object Storage** when the application needs an object-storage abstraction whose provider owns -the storage semantics, especially S3-compatible managed objects. Direct/presigned transfer and -multipart upload are not implemented: their unassembled code was removed (see -`docs/capability-status.md` 「제거된 코드」). +애플리케이션이 저장 의미를 provider가 가지는 object storage 추상, 특히 S3 호환 managed 객체가 필요할 때 **Object Storage**를 +쓴다. 직접·presigned 전송과 multipart upload는 구현하지 않았다. 조립되지 않던 그 코드는 지웠다(`docs/capability-status.md` +「제거된 코드」). -Do not enable both as two independent sources of truth for the same logical object. If a product -needs both, one capability must own the logical object/control record and the other must be an -explicit transport/provider integration behind that owner; duplicating metadata, retention state, or -publication state across both is not a supported composition. +같은 논리 객체에 대해 둘을 서로 독립된 정본 둘로 켜지 않는다. 제품에 둘 다 필요하면 한 capability가 논리 객체·제어 기록을 +가지고, 다른 하나는 그 소유자 뒤의 명시적 전송·provider 통합이어야 한다. 둘에 메타데이터, 보존 상태, 게시 상태를 겹쳐 두는 것은 +지원하는 조립이 아니다. -Readiness remains independent: `docs/fileserver/support-matrix.md` certifies Fileserver behavior; -`docs/registries/object-storage-readiness.yaml` certifies Object Storage behavior. Evidence from one -does not upgrade the other. +readiness는 따로 남는다. `docs/fileserver/support-matrix.md`가 파일 서버 동작을, `docs/registries/object-storage-readiness.yaml`이 +Object Storage 동작을 인증한다. 한쪽의 증거가 다른 쪽을 올려 주지 않는다. diff --git a/scripts/check-docs-exceptions.txt b/scripts/check-docs-exceptions.txt index 4e569949..1cf71e90 100644 --- a/scripts/check-docs-exceptions.txt +++ b/scripts/check-docs-exceptions.txt @@ -74,7 +74,6 @@ language docs/redis/command-policy.md language docs/redis/operations.md language docs/redis/support-matrix.md language docs/redis/upgrade-guide.md -language docs/storage-capability-boundary.md language docs/web/advanced-capabilities.md language docs/web/openapi-32-compatibility.md language docs/web/patch-contract.md