コンテンツへスキップ
supastack
ドキュメントを閲覧
WebNext.js

For AI agents: fetch the complete documentation index at /llms.txt, the full documentation corpus at /llms-full.txt, the agent skill at /skill.md, or this page as Markdown at /ja/docs/modules/storage.md (or send Accept: text/markdown).

ストレージモジュール

一つの ObjectStorage コントラクト、memory と S3 互換アダプター。

このガイドについて質問
開くアプリ

初心者向けのウォークスルー

前提条件: 以下の 2 つの初心者向けガイドを読み、Web ローカルのセットアップを完了し、エディターでルートにあるこのモノリポジトリを開きます。 Web 設定は apps/web/.env.local に属します。 Next.js はルート .env を読み取りません。デフォルトのフェイク モードの /dashboard はデータベースなしのデモです。 /auth には移行されたデータベースが必要です。

簡単に説明すると、ワークスペースは 1 つのチームの個別のユーザー、データ、設定です。サーバーは信頼できるバックエンドです。プロバイダー キーがブラウザーや電話コードに含まれないようにします。移行は、テーブルを作成または更新する、バージョン管理されたデータベースの変更です。 AI モデルは答えを返すエンジンです。モデル カタログは、使用可能なモデル ID と価格のサーバーのリストです。プロバイダーは、AI、電子メール、請求サービスなどの外部サービスです。資格は、ワークスペースで機能を使用できるようにする付与です。 Webhook は、あるサービスが別のサービスの URL に送信するメッセージです。

1. 認証情報なしのトライアルの場合は、STORAGE_PROVIDER=memory を保持します。このチェックアウトに表示されるアップロード コントロールがない場合は、小さなサンプル イメージをワイヤリングする前に、コーディング エージェントに apps/web/app/api/storage/avatar/route.ts、apps/web/app/api/storage/logo/route.ts、apps/web/app/api/storage/organization-logo/route.ts、および一致する設定ページを検査するよう依頼してください。

2. 永続性を確認するには、apps/web/.env.local で STORAGE_PROVIDER=s3、STORAGE_REGION、および STORAGE_BUCKET を設定し、サーバーのみのテスト資格情報をローカルに追加して、再起動します。

3. イメージがストレージから再ロードされます。メモリ ファイルはプロセスが再起動されると消えます。 S3 エラーについては、バケット、エンドポイント、アクセス ポリシーを確認してください。

カスタム コードの場合は、提供された prompts/README.md から始めて、最も近いプロンプト (アプリ画面の場合は prompts/new-app-screen.md、パブリック ページの場合は prompts/new-landing-page.md) をコピーします。サーバー、データベース、またはプロバイダーの作業については、コーディング エージェントにこのガイドのタスクを与え、AGENTS.md、.ai/PROJECT_CONTEXT.md、および一致する .ai/ ミラーを読み取るように依頼します。ここで指定されている正確なソース ファイルを調べてください。ファイルをリストし、編集前にチェックします。ワークスペースの所有権とサーバーのみの秘密を保持します。そして差分を見せてください。必要な動作、入力フィールドと出力フィールド、許可されるロール、予想される成功とエラー、テスト アカウント、プロバイダー、またはデバイスを指定します。サンプル値を使用します。絶対に本当の秘密を貼り付けないでください。

【端末の基本】(/docs/web/terminal-basics)

ストレージ バックエンドを選択します

STORAGE_PROVIDER=memory は認証情報不要のデフォルトです。local は STORAGE_LOCAL_DIR（デフォルトは ./.data/storage、本番環境では明示的な指定が必須）配下のディスクにオブジェクトを書き込み、単一サーバー構成向けに /api/storage/local/[...key] の HMAC 署名付き期限付き URL（STORAGE_LOCAL_SIGNING_SECRET、未設定時は AUTH_SECRET にフォールバック）経由で配信します。s3 は apps/web/src/storage-runtime.ts を使用して @supastack/storage コントラクト上に AWS SDK クライアントを構成し、デフォルトでパススタイル URL が有効な Supabase Storage や MinIO をサポートします。

STORAGE_PROVIDER=s3
STORAGE_REGION=us-east-1
STORAGE_BUCKET=your-product-bucket
# Set STORAGE_ACCESS_KEY_ID and STORAGE_SECRET_ACCESS_KEY on the server.
# Optional: STORAGE_ENDPOINT, STORAGE_FORCE_PATH_STYLE, STORAGE_PUBLIC_BASE_URL
# Self-hosted single-server disk storage:
# STORAGE_PROVIDER=local
# STORAGE_LOCAL_DIR=./.data/storage
# STORAGE_LOCAL_SIGNING_SECRET=

アップロード境界を再利用する

出荷されるルートには、/api/storage/ の下のオブジェクト、アバター、プロフィール ロゴ、および組織ロゴが含まれます。 ID/ワークスペースの権限を解決し、保存する前にアップロードの形式を検証します。任意のクライアント オブジェクト キーを受け入れるのではなく、選択したルートのサイズ/タイプ ポリシーを検査します。

パブリック URL はプレゼンテーションであり、承認ではありません。保護されたコンテンツをアプリケーションの検証済み読み取り境界の内側に保持し、製品データのバケット/CDN ポリシーを構成します。

実際のストレージの動作をテストする

アップロードの許可/拒否、MIME とサイズの拒否、外部ワークスペースのパス、オブジェクトの欠落、プロバイダーの障害をテストします。メモリ モードはプロセス間で持続しません。リリース前に、選択したバックエンドに対してストレージと取得を検証します。

インストールとセットアップ

packages/storage は ObjectStorage インターフェース(オブジェクトロケーターへの put、get、delete)を定義し、決定的テスト用の MemoryObjectStorage と本番バケット用の S3CompatibleObjectStorage を提供します。

オブジェクトキーは buildWorkspaceObjectKey で構築され assertWorkspaceObjectKey で検査されるため、保存されるすべてのファイルがワークスペースと目的(avatar、file、logo)で名前空間化されます。キーがワークスペースを逸脱すると WorkspaceScopedStorageError が発火します。

interface ObjectStorage {
  putObject(input: PutObjectInput): Promise<StoredObject>
  getObject(locator: ObjectLocator): Promise<StoredObject | undefined>
  deleteObject(locator: ObjectLocator): Promise<boolean>
  getPublicUrl(locator: ObjectLocator): string
}

key = {workspaceId}/{purpose}/{safeName}

実装ワークフロー

アプリケーションルートはワークスペースを解決し、アップロードを検証し、スコープ付きキーを構築してアダプターを呼びます — ストレージは生のクライアントパスを見ません。アダプターは STORAGE_PROVIDER とその認証情報でサーバー環境で選択します。

読み取りは同じ認可境界を経由して公開し、公開 URL はプロダクトが意図的に公開するオブジェクトにのみ提供します。

検証とトラブルシューティング

MemoryObjectStorage がユニットテストを決定的に保ちます — キー、コンテンツタイプ、ワークスペース間拒否をそこでアサートします。S3 アダプターはアップロードをリリースする前に、実バケットに対するオプションの smoke パスで検証してください。

よくある質問

14 件の質問

supastack とは何ですか？

supastack は AI SaaS 製品を構築するためのモジュラー基盤です。共通インフラをまとめて提供するので、製品固有の機能に集中できます。

Web とモバイルに対応していますか？

はい。supastack には Web とモバイル体験の出発点として Next.js アプリと Expo アプリが含まれています。

どの認証が含まれていますか？

Better Auth がメール/パスワード、OTP、ソーシャルログインをカバーします。個人ワークスペースはアカウントと一緒にプロビジョニングされ、初日からレコードが境界内に収まります。

AI はどうサポートされていますか？

supastack には設定可能なマルチプロバイダー AI、使用量追跡、予算、暗号化された自前キー（BYOK）サポートが含まれています。

サブスクリプションはどう管理されますか？

このキット上に構築された製品では、Stripe 課金・サブスクリプション・権限が有料アクセスの基盤になります。プロバイダーの秘密はサーバー側に留まります。

製品固有のコードはどこに置きますか？

製品固有の機能は別のコードベースに置き、製品側が supastack の基本モジュールを設定・統合します。

supastack の価格は？

キットは生涯アップデート付きの一回払いです：単一フレームワーク 249 ドル（期間限定のローンチ価格 — 通常価格 349 ドルから 100 ドル割引）、または全フレームワーク（Next.js・iOS・Android）499 ドル（期間限定のローンチ価格 — 通常価格 599 ドルから 100 ドル割引）、追加開発者シート 1 席 75 ドル。キットのサブスクリプションはありません。このサイトのチェックアウトはライセンスキーをメールで配信し、GitHub 招待でリポジトリアクセスを提供します。

ワークスペースはどうデータを囲いますか？

ユーザーレコードは workspaceId でスコープされます。認証、権限、AI 使用量、課金イベント、監査エントリは個人ワークスペースの境界内に留まります。

バックグラウンドジョブはどう機能しますか？

Trigger.dev が明示的なジョブランタイムです。JobRunner コントラクトは enqueue・status・cancel のみを約束し、ワークフロー意味論は Trigger.dev 固有で明示的です。

メールとアウトリーチの違いは？

トランザクションメールはタスク完了通知などの製品ワークフローをカバーします。コールドアウトリーチやキャンペーンは製品自身に属し、このキットのメールモジュールの外です。

モバイルの購入はどのように機能しますか？

モバイルでは RevenueCat によるネイティブ購入と復元に対応し、アクセス権をサーバーで検証します。公開前にストアアカウントを設定し、実機テストを完了してください。Web 課金は別に管理します。

AI プロバイダーのキーはどこにありますか？

BYOK 認証情報は暗号化され、サーバー側に留まります。キーはログでサニタイズされ、使用量と予算はワークスペースレベルで可視です。

チェックアウトで使える支払い方法は？

Stripe ホストのチェックアウトはカードを受け付け、Stripe アカウントでウォレットを有効にすれば Alipay と WeChat Pay も提供できます——中国の購入者に便利です。ウォレット認可は非同期で確定するため、決済完了と同時にライセンスページが更新されます。

返金を受けることはできますか？

リポジトリへのアクセス権を取得した後は、supastack は永久にあなたのものとなるため、返金はできません。ですがご安心ください。生涯アップデートを含む完全なソースコードを入手し、ご自身やクライアントのために無制限にプロダクトを構築・公開できます。コードの転売や、リポジトリをスターターキットやテンプレートとして再配布することのみ禁止されています。

JA
テーマ