docs(storage): 파일 서버와 Object Storage 경계 문서를 한국어로 옮긴다

문제: `docs/storage-capability-boundary.md`가 영어였다.

고친 것: 번역했다. 주장은 바꾸지 않았다. 예외 목록에서 이 파일의 language 줄을 지웠다.
이 커밋으로 이 작업 범위(runbook·알림·JPA·관측·호환·storage)의 language·number 예외
줄이 0이 된다.

검증: 최종 트리 기준(첫 커밋 본문 참고).
This commit is contained in:
DongHyeonka
2026-11-07 17:56:35 +09:00
parent 119c8d6e5a
commit 54383d3f45
2 changed files with 19 additions and 25 deletions
+19 -24
View File
@@ -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 동작을 인증한다. 한쪽의 증거가 다른 쪽을 올려 주지 않는다.
-1
View File
@@ -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