Files
clean-architecture-backend-…/docs/storage-capability-boundary.md
DongHyeonka 54383d3f45 docs(storage): 파일 서버와 Object Storage 경계 문서를 한국어로 옮긴다
문제: `docs/storage-capability-boundary.md`가 영어였다.

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

검증: 최종 트리 기준(첫 커밋 본문 참고).
2026-11-07 17:56:35 +09:00

2.3 KiB

파일 서버와 Object Storage

두 capability는 바이트 저장 수준에서 겹치지만 가진 서빙 경계가 다르다. port 하나의 바꿔 끼울 수 있는 provider가 아니다.

질문 파일 서버 HTTP 플랫폼 Object Storage
누가 클라이언트에 바이트를 주나? 이 애플리케이션이 파일 서버 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

고르는 규칙

서비스 자신이 upload/download HTTP 동작을 가질 때 파일 서버를 쓴다. 인증, range와 조건부 요청, 검증·격리, 이어 올리는 upload 상태, lifecycle·관리 route, X-Accel-Redirect 같은 선택적 위임 서빙이다.

애플리케이션이 저장 의미를 provider가 가지는 object storage 추상, 특히 S3 호환 managed 객체가 필요할 때 Object Storage를 쓴다. 직접·presigned 전송과 multipart upload는 구현하지 않았다. 조립되지 않던 그 코드는 지웠다(docs/capability-status.md 「제거된 코드」).

같은 논리 객체에 대해 둘을 서로 독립된 정본 둘로 켜지 않는다. 제품에 둘 다 필요하면 한 capability가 논리 객체·제어 기록을 가지고, 다른 하나는 그 소유자 뒤의 명시적 전송·provider 통합이어야 한다. 둘에 메타데이터, 보존 상태, 게시 상태를 겹쳐 두는 것은 지원하는 조립이 아니다.

readiness는 따로 남는다. docs/fileserver/support-matrix.md가 파일 서버 동작을, docs/registries/object-storage-readiness.yaml이 Object Storage 동작을 인증한다. 한쪽의 증거가 다른 쪽을 올려 주지 않는다.