파일 저장 및 콘텐츠 관리
애플리케이션에는 이미지, 문서, PDF, 비디오 등 사용자가 업로드한 파일을 저장하기 위한 전용 콘텐츠 파일 시스템이 있습니다. 이는 애플리케이션 코드와 별개이며 사용자가 앱을 사용하는 동안 생성하거나 업로드하는 동적 콘텐츠용으로 설계되었습니다.
제한 사항 및 중요 참고 사항
- 개별 파일의 크기는 최대 500MB까지 가능합니다.
- 파일 삭제는 영구적입니다. 휴지통이나 되돌리기 기능이 없습니다.
- 스토리지 사용량은 계정 할당량에 포함됩니다.
콘텐츠 파일 시스템이 가능하게 하는 것
콘텐츠 파일 시스템은 애플리케이션에 강력한 파일 관리 기능을 제공합니다.
- 사용자 아바타, 프로필 사진, 이미지 갤러리 저장
- 이력서, 계약서, PDF 등 문서 업로드 허용
- 앱 사용자 간 파일 공유 기능 구축
- 자동 최적화를 통해 이미지가 많은 애플리케이션 생성
- 사용자가 자신이 업로드했거나 자신에게 속한 파일을 다운로드하도록 허용
- 사용자를 대신하여 파일을 관리하는 관리 도구 구축
작동 방식
AI에 파일 저장이 필요한 기능을 설명하면 자동으로 전체 구현을 처리합니다.
업로드 인터페이스 설정 — 사용자가 장치에서 파일을 선택할 수 있는 양식 또는 드래그 앤 드롭 영역을 만듭니다.
액세스 제어 구성 — 빌드 중인 항목에 따라 파일을 보고, 업로드하고, 삭제할 수 있는 사람을 결정합니다.
이미지 최적화 구현 — 앱이 빠르게 로드되도록 자동으로 이미지 크기를 조정하고 효율적으로 제공합니다.
저장소 구조 생성 — 파일을/content/uploads/또는/content/avatars/와 같은 논리적 폴더로 구성합니다.
백엔드 처리 — 사용자가 생각할 필요 없이 실제 파일 저장, 검색 및 전달을 관리합니다.
파일은/content/uploads/photo.jpg와 같은 경로에 저장되며 앱에서 직접 참조할 수 있습니다. 시스템은 각 파일을 업로드한 사람과 파일이 생성된 시기를 추적하고 액세스 규칙을 시행합니다.
파일에 대한 액세스 제어
데이터베이스 테이블 및 Edge Function과 마찬가지로 파일에도 액세스할 수 있는 사람을 제어하는 보안 정책이 있습니다. 파일은 기본적으로 비공개입니다 — 권한을 구성할 때까지는 누구도 해당 파일에 액세스할 수 없습니다. AI는 만들고 있는 기능에 맞춰 다음을 설정합니다.
공개 파일
로그인하지 않아도 누구나 볼 수 있습니다. 로그인한 사용자가 업로드할 수 있으며, 파일을 업로드한 사람만 삭제할 수 있습니다. 사진 갤러리, 공개 이미지 공유 또는 사용자 생성 콘텐츠 사이트에 적합합니다.
개인 파일
파일을 업로드한 사용자만 파일을 보거나 삭제할 수 있습니다. 민감한 문서, 개인 사진, 의료 기록 또는 사용자가 다른 사람에게 보여주고 싶지 않은 모든 것에 사용됩니다.
조직 공유 파일
동일한 조직의 사용자는 조직의 모든 사용자가 업로드한 파일을 볼 수 있습니다. 개인은 자신이 업로드한 파일만 삭제할 수 있습니다. 팀 문서 공유, 회사 리소스 또는 공동 작업 공간에 적합합니다.
소유자 전용 액세스
최종 사용자가 아닌 사용자 본인(앱 작성자)만 이러한 파일에 액세스할 수 있습니다. 앱을 강화하지만 사용자에게 공개되어서는 안 되는 시스템 파일, 템플릿 또는 관리 리소스를 저장하는 데 유용합니다.
고급 액세스 제어
AI는 파일 메타데이터를 기반으로 정교한 액세스 규칙을 만들 수 있습니다. 예를 들어:
- 게시된 기사는 공개되지만 초안은 작성자에게만 표시됩니다.
- 부서가 태그된 파일은 해당 부서의 사용자에게만 표시됩니다.
- 프리미엄 콘텐츠를 이용하려면 사용자 계정에 구독 플래그가 필요합니다.
- 공유 파일은 파일의 메타데이터에 나열된 공동작업자에게 표시됩니다.
이미지 최적화
콘텐츠 파일 시스템에 업로드된 이미지는 빠른 로딩을 위해 자동으로 최적화됩니다. 이미지를 표시할 때 특정 너비를 요청할 수 있으며 시스템이 나머지를 처리합니다.
<!-- Thumbnail (200px wide) -->
<img src="/content/gallery/photo.jpg?w=200" />
<!-- Standard display (800px wide) -->
<img src="/content/gallery/photo.jpg?w=800" />
<!-- Hero image (1920px wide) -->
<img src="/content/gallery/photo.jpg?w=1920" />
<!-- Original, full-size image -->
<img src="/content/gallery/photo.jpg" />
최적화 작동 방식
프로그레시브 로딩 — 누군가 최적화된 크기를 처음 요청하면 시스템은 사용 가능한 가장 가까운 버전을 제공하고 백그라운드에서 정확한 크기를 생성합니다. 그 이후의 모든 요청은 완벽하게 크기가 최적화된 이미지를 얻습니다. 원본 파일은 항상 보존됩니다.
최신 형식 제공 — 시스템은 최신 이미지 형식(AVIF 또는 WebP)을 지원하는 브라우저에 자동으로 제공하며, 이전 브라우저의 경우 JPEG 또는 PNG로 자동 대체됩니다. 이는 투명하게 발생합니다. 너비만 지정하면 사용자는 브라우저에서 처리할 수 있는 가장 빠른 로딩 버전을 얻게 됩니다.
성능 최적화 — 성능을 향상하려면 더 작은 너비를 사용하세요. 200px 썸네일은 원본 4000px 이미지보다 훨씬 빠르게 로드되고 더 적은 대역폭을 사용합니다. 이미지를 표시하는 방법에 맞는 너비를 선택하세요.
애플리케이션에서 파일 사용
AI는 콘텐츠 파일 시스템을 React 애플리케이션에 자동으로 통합합니다. 파일과 관련된 기능을 요청하면 UI 구성 요소를 생성하고 업로드/다운로드 로직을 연결하고 오류를 처리합니다.
AI가 구현하는 일반적인 패턴
아바타 업로드 — 이미지 유형을 확인하고, 업로드 진행률을 표시하고, 이미지를 미리 보고, 사용자 프로필 경로를 저장하는 프로필 사진 업로드 인터페이스입니다.
문서 갤러리 — 업로드된 문서를 나열하고, 이미지의 축소판을 표시하고, 다운로드 링크를 제공하고, 필터링 또는 검색을 허용하는 파일 브라우저입니다.
드래그 앤 드롭 업로드 — 사용자가 데스크탑에서 파일을 드래그하고, 업로드 진행 상황을 확인하고, 진행 중인 업로드를 취소하고, 유효하지 않은 파일에 대한 오류 메시지를 받을 수 있는 직관적인 업로드 영역입니다.
파일 선택기 — 사용자가 이전에 업로드한 파일을 표시하고 재사용할 파일을 선택할 수 있도록 하며 썸네일과 파일 이름을 표시하는 모달 또는 사이드바입니다.
Edge Function 통합
Edge Function(서버측 코드)은 콘텐츠 파일 시스템에 액세스하여 파일을 처리하거나 프로그래밍 방식으로 파일을 생성하거나 사용자 정의 파일 처리 논리를 구현할 수 있습니다.
Edge Function이 파일로 할 수 있는 작업
- PDF 보고서를 생성하고 사용자가 다운로드할 수 있도록 저장합니다.
- 업로드된 이미지 처리(워터마크 적용, 썸네일 생성, 메타데이터 추출)
- 업로드된 문서를 수락하기 전에 민감한 데이터가 있는지 스캔하세요.
- 맞춤형 백업 또는 보관 논리 구현
- 파일 내용 분석 및 구조화된 데이터 추출
- 특정 파일이 업로드되면 워크플로 트리거
경고: 중요 보안 참고 사항
Edge Function은 일반적인 접근 제어를 우회합니다. 함수가 파일에 액세스할 때 사용자에게 적용되는 "공개" 또는 "소유자" 규칙에 의해 제한되지 않습니다. 즉, 사용자가 확인해야 하는 파일에만 액세스할 수 있도록 함수 코드에 자체 인증 확인을 구현해야 합니다.
예를 들어 사용자가 파일을 요청하는 함수를 호출하는 경우 콘텐츠를 반환하기 전에 해당 사용자가 해당 파일을 소유하고 있는지 또는 해당 파일에 액세스할 수 있는 권한이 있는지 확인해야 합니다. AI는 함수를 빌드할 때 이를 처리하지만 함수 코드는 높은 권한으로 실행된다는 점을 이해하는 것이 중요합니다.
저장소 구성
AI는 작성 중인 항목에 따라 파일을 논리적 폴더로 구성합니다. 폴더 구조를 수동으로 만들 필요가 없습니다. 필요한 것을 설명하기만 하면 AI가 적절한 경로를 설정합니다.
일반적인 구성 패턴
/content/uploads/— 일반 사용자 업로드/content/avatars/— 사용자 프로필 사진/content/documents/— PDF 및 문서/content/gallery/— 사진 갤러리 이미지/content/private/— 개인 사용자 파일/content/public/— 공개적으로 액세스 가능한 파일/content/temp/— 삭제할 수 있는 임시 파일
AI는 사용 사례에 적합한 경우/content/uploads/2024/또는/content/users/[username]/와 같은 중첩 폴더를 생성할 수 있습니다. 파일은 전체 경로로 추적되므로 파일을 이동하거나 이름을 바꾸면 모든 참조가 자동으로 업데이트됩니다.
모니터링 및 디버깅
업로드, 다운로드, 액세스 거부, 오류 등 모든 파일 작업이 기록됩니다. 관리 인터페이스에서 이러한 로그를 보고 파일 저장소가 어떻게 사용되고 있는지 이해할 수 있습니다.
- 가장 자주 업로드되는 파일 확인
- 실패한 업로드와 무엇이 잘못되었는지 식별
- 다운로드 패턴 및 인기 파일 추적
- 시간 경과에 따른 스토리지 사용량 및 증가 모니터링
- 사용자가 볼 것으로 예상되는 파일에 액세스할 수 없는 경우 액세스 제어 문제를 디버그합니다.
시스템은 또한 저장된 총 파일, 총 크기, 성장률 및 가장 큰 파일과 같은 스토리지 지표를 추적합니다. 이는 앱의 저장소 공간과 확장 계획을 이해하는 데 도움이 됩니다.
한계와 제약
기본적으로 개별 파일의 최대 크기는 500MB입니다. 이는 구성 가능합니다. AI는 빌드 중인 항목에 따라 제한을 조정할 수 있습니다. 대부분의 애플리케이션(이미지 업로드, 문서 공유, PDF)의 경우 기본 제한이면 충분합니다.
안정성을 위해 파일은 중복 저장됩니다. 파일을 삭제하면 해당 파일은 시스템에서 영구적으로 제거됩니다. 휴지통이나 되돌리기 기능이 없으므로 즉시 최종적으로 삭제됩니다.
AI와 협력하기
파일 저장이 필요한 기능을 설명할 때 다음 사항을 구체적으로 설명하세요.
- 파일에 액세스할 수 있는 사람 — 공개, 비공개, 조직 공유 또는 사용자 정의 규칙
- 파일 형식 — 이미지만, PDF, 모든 파일 형식, 크기 제한
- 파일 구성 방법 — 폴더, 명명 규칙, 사용자가 하위 폴더를 만들 수 있는지 여부
- 업로드 후 발생하는 상황 — 갤러리에 표시, 기록에 첨부, 기능 처리
AI는 이 정보를 사용하여 스토리지를 올바르게 구성하고 액세스 정책을 설정하며 요구 사항에 맞는 인터페이스를 만듭니다.
관련 문서: