ファイルストレージとコンテンツ管理

アプリケーションには、画像、ドキュメント、PDF、動画など、ユーザーがアップロードしたファイルを保存するための専用コンテンツファイルシステムがあります。これはアプリケーションコードとは分離されており、ユーザーがアプリを使いながら作成またはアップロードする動的コンテンツ向けに設計されています。

制限と重要な注意

  • 個別ファイルのサイズは最大 500MB です
  • ファイル削除は恒久的です。ごみ箱やリサイクルビンはありません
  • ストレージ使用量はアカウントのクォータに数えられます

コンテンツファイルシステムでできること

コンテンツファイルシステムは、アプリケーションに強力なファイル管理能力を提供します。

  • ユーザーのアバター、プロフィール写真、画像ギャラリーを保存する
  • 履歴書、契約書、PDF などのドキュメントアップロードを受け付ける
  • アプリ内ユーザー間のファイル共有機能を構築する
  • 自動最適化付きの画像中心アプリケーションを作成する
  • ユーザーがアップロードした、または自分に属するファイルをダウンロードできるようにする
  • ユーザーに代わってファイルを管理する管理ツールを構築する

仕組み

ファイルストレージを必要とする機能を AI に説明すると、AI が実装全体を自動的に処理します。

アップロードインターフェイスを設定 — ユーザーが自分のデバイスからファイルを選べるフォームやドラッグアンドドロップ領域を作成します

アクセス制御を構成 — 構築している内容に基づき、誰がファイルを表示、アップロード、削除できるかを決めます

画像最適化を実装 — アプリが速く読み込まれるように、画像を自動的にリサイズし効率的に提供します

ストレージ構造を作成 — /content/uploads/ や /content/avatars/ のような論理フォルダーへファイルを整理します

バックエンドを処理 — あなたが考える必要なく、実際のファイル保存、取得、配信を管理します

ファイルは /content/uploads/photo.jpg のようなパスに保存され、アプリ内で直接参照できます。システムは各ファイルを誰がアップロードしたか、いつ作成されたかを追跡し、アクセスルールを強制します。

ファイルのアクセス制御

データベーステーブルや edge functions と同じように、ファイルには誰がアクセスできるかを制御するセキュリティポリシーがあります。ファイルは初期状態で非公開です。許可を設定するまで、誰もアクセスできません。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 functions(あなたのサーバー側コード)は、ファイル処理、プログラムによるファイル生成、カスタムファイル処理ロジックの実装のために、コンテンツファイルシステムへアクセスできます。

Edge Functions がファイルでできること

  • PDF レポートを生成し、ユーザーがダウンロードできるよう保存する
  • アップロード画像を処理する(透かしの適用、サムネイル作成、メタデータ抽出)
  • 受け入れる前にアップロード文書をスキャンして機密データを探す
  • カスタムのバックアップまたはアーカイブロジックを実装する
  • ファイル内容を分析し、構造化データを抽出する
  • 特定ファイルがアップロードされたときにワークフローを起動する

警告: 重要なセキュリティメモ

Edge functions は通常のアクセス制御を迂回します。function がファイルにアクセスするとき、ユーザーに適用される「public」や「owner」ルールには制限されません。つまり、ユーザーが見るべきファイルだけにアクセスできるように、function コード内で独自の認可チェックを実装する必要があります。

たとえば、ユーザーが function を呼び出してファイルを要求する場合、内容を返す前に、そのユーザーがそのファイルを所有しているか、アクセス許可を持っていることを確認する必要があります。AI は function を構築するときにこれを処理しますが、function コードが高い特権で実行されることを理解しておくことは重要です。

ストレージの整理

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、任意のファイルタイプ、サイズ制限
  • ファイルをどう整理するか — フォルダー、命名規則、ユーザーがサブフォルダーを作成できるか
  • アップロード後に何が起きるか — ギャラリーに表示、レコードに添付、function で処理

AI はこの情報を使ってストレージを正しく構成し、アクセスポリシーを設定し、ニーズに合うインターフェイスを作成します。


関連ドキュメント: