Aller au contenu
supastack
Parcourir la documentation
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 /fr/docs/web/setup-storage.md (or send Accept: text/markdown).

Configurer le stockage de fichiers

Uploads scopés par workspace en mémoire ou sur tout bucket compatible S3.

Poser une question sur ce guide
Ouvrir dans

Parcours pas à pas pour débuter

Prérequis : Lisez les deux guides pour débutants ci-dessous, terminez la configuration locale du Web et ouvrez ce monorepo à sa racine dans votre éditeur. Les paramètres Web appartiennent à apps/web/.env.local ; Next.js ne lit pas la racine .env. /dashboard dans le mode faux par défaut est une démo sans base de données ; /auth nécessite une base de données migrée.

Termes rapides : un espace de travail est constitué des utilisateurs, des données et des paramètres distincts d'une équipe. Le serveur est le backend de confiance ; gardez les clés du fournisseur hors du code du navigateur et du téléphone. Une migration est une modification de base de données versionnée qui crée ou met à jour des tables. Un modèle d'IA est le moteur qui répond ; le catalogue de modèles est la liste du serveur des identifiants de modèles et des prix disponibles. Un fournisseur est un service externe tel qu'un service d'IA, de messagerie ou de facturation. Un droit est une subvention qui permet à un espace de travail d'utiliser une fonctionnalité. Un webhook est un message qu'un service envoie au URL d'un autre service.

1. Pour un essai sans autorisation, conservez STORAGE_PROVIDER=memory. Si cette extraction n'a aucun contrôle de téléchargement visible, demandez à votre agent de codage d'inspecter 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 et la page des paramètres correspondants avant de câbler un petit exemple d'image.

2. Pour vérifier la persistance, définissez STORAGE_PROVIDER=s3, STORAGE_REGION et STORAGE_BUCKET dans apps/web/.env.local, ajoutez localement les informations d'identification de test réservées au serveur et redémarrez.

3. L'image doit être rechargée depuis le stockage. Les fichiers mémoire disparaissent lorsque le processus redémarre ; pour les erreurs S3, vérifiez le bucket, le point de terminaison et la stratégie d’accès.

Pour le code personnalisé, commencez par le prompts/README.md fourni et copiez l'invite la plus proche : prompts/new-app-screen.md pour un écran d'application ou prompts/new-landing-page.md pour une page publique. Pour le travail sur un serveur, une base de données ou un fournisseur, confiez à votre agent de codage la tâche de ce guide et demandez-lui de lire les miroirs AGENTS.md, .ai/PROJECT_CONTEXT.md et .ai/ correspondants ; inspectez les fichiers sources exacts nommés ici ; lister les fichiers et les vérifications avant de les modifier ; préserver la propriété de l'espace de travail et les secrets du serveur ; et je vous montre la différence. Indiquez-lui le comportement souhaité, les champs d'entrée et de sortie, les rôles autorisés, les succès et erreurs attendus, ainsi que le compte, le fournisseur ou l'appareil de test. Utilisez des exemples de valeurs ; ne collez jamais un vrai secret.

Choisir le backend de stockage

STORAGE_PROVIDER=memory est la valeur par défaut sans identifiants. local écrit les objets sur le disque dans STORAGE_LOCAL_DIR (./.data/storage par défaut, explicitement requis en production) et les diffuse via des URL signées par HMAC à expiration sur /api/storage/local/[...key] (STORAGE_LOCAL_SIGNING_SECRET, avec repli sur AUTH_SECRET) pour les déploiements sur serveur unique. s3 utilise apps/web/src/storage-runtime.ts pour composer le client AWS SDK sur le contrat restreint @supastack/storage, prenant en charge Supabase Storage et MinIO avec les URL par chemin activées par défaut.

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=
# Local MinIO Compose overrides: MINIO_ROOT_USER / MINIO_ROOT_PASSWORD

Réutiliser les frontières d’envoi

Les routes fournies couvrent les objets, les avatars, les logos de profil et les logos d’organisation sous /api/storage/. Elles résolvent l’identité et les permissions de l’espace de travail, puis valident le format du fichier avant le stockage. Examinez la limite de taille et de type de la route choisie au lieu d’accepter des clés d’objet arbitraires fournies par le client.

Les URL publiques servent à la présentation, pas à l’autorisation. Gardez le contenu protégé derrière la vérification de lecture de l’application et configurez la politique du bucket ou du CDN selon les données de votre produit.

Tester le stockage réel

Testez les envois autorisés et refusés, le rejet du type MIME et de la taille, les chemins d’un autre espace de travail, les objets absents et les pannes du fournisseur. Le mode mémoire ne persiste pas entre les processus ; avant la publication, vérifiez l’envoi et la récupération avec le backend choisi.

Configuration et paramètres

1. STORAGE_PROVIDER=memory (le défaut) garde les uploads dans le processus — adapté au développement et aux tests.

2. Pour de vrais fichiers, définissez STORAGE_PROVIDER=s3 avec un bucket et une paire de clés d'accès. STORAGE_ENDPOINT sélectionne tout service compatible S3 — Supabase Storage à https://<ref>.supabase.co/storage/v1/s3, MinIO ou AWS lui-même.

3. STORAGE_FORCE_PATH_STYLE passe à true par défaut dès qu'un endpoint est défini — Supabase et MinIO l'exigent. Ne le mettez à false que pour un endpoint custom en virtual-hosted.

4. Pointez éventuellement STORAGE_PUBLIC_BASE_URL vers un CDN pour que les URL d'objets publics s'y résolvent.

STORAGE_PROVIDER=s3
STORAGE_ENDPOINT=https://<ref>.supabase.co/storage/v1/s3
STORAGE_REGION=us-east-1            # Supabase: project region
STORAGE_BUCKET=<bucket>
STORAGE_ACCESS_KEY_ID=…
STORAGE_SECRET_ACCESS_KEY=…
STORAGE_PUBLIC_BASE_URL=https://cdn.example.com   # optional

# No bucket yet? Local S3-compatible storage ships in compose:
docker compose --profile storage up -d minio    # console on :9001

Processus d’implémentation

Uploads et lectures passent par des routes authentifiées qui résolvent d'abord le workspace — /api/storage/objects plus les routes dédiées avatar et logo. Chaque clé stockée est namespacée en {workspaceId}/{purpose}/{safeName} via buildWorkspaceObjectKey.

Les identifiants restent côté serveur ; le navigateur ne voit jamais le bucket ni les clés.

Uploads fonctionnels ? Continuez vers Configurer l'observabilité.

Vérification et dépannage

Vérifiez qu'un upload fait l'aller-retour, qu'un second workspace ne peut pas lire l'objet, et que les types de contenu surdimensionnés ou interdits échouent. Des erreurs de signature ou 403 contre Supabase ou MinIO signifient généralement que STORAGE_FORCE_PATH_STYLE est faux pour l'endpoint.

Pour poursuivre la configuration, consultez Configurer l'observabilité.

Questions fréquentes

14 questions

Qu'est-ce que supastack ?

supastack est une fondation modulaire pour construire des produits SaaS avec IA. Elle réunit l'infrastructure commune pour que vous puissiez vous concentrer sur les fonctionnalités propres à votre produit.

Prend-il en charge le web et le mobile ?

Oui. supastack inclut des applications Next.js et Expo comme points de départ pour des expériences web et mobile.

Quelle authentification est incluse ?

Better Auth couvre e-mail/mot de passe, OTP et connexion sociale. Les espaces de travail personnels sont provisionnés avec le compte pour que les enregistrements restent délimités dès le premier jour.

Comment l'IA est-elle prise en charge ?

supastack inclut une IA multi-fournisseurs configurable, le suivi d'usage, des budgets, et la prise en charge chiffrée de vos propres clés (BYOK).

Comment les abonnements sont-ils gérés ?

Pour les produits construits sur le kit, la facturation Stripe, les abonnements et les droits d'accès forment la base de l'accès payant. Les secrets fournisseur restent côté serveur.

Où vit le code propre à mon produit ?

Les fonctionnalités propres au produit restent dans un codebase séparé, tandis que le produit configure et intègre les modules de la fondation supastack.

Comment fonctionne la tarification de supastack ?

Le kit est un achat unique avec mises à jour à vie : Un framework à 249 $ (prix de lancement temporaire — 100 $ de réduction par rapport au prix habituel de 349 $) ou Tous les frameworks (Next.js, iOS, Android) à 499 $ (prix de lancement temporaire — 100 $ de réduction par rapport au prix habituel de 599 $), plus 75 $ par siège développeur supplémentaire. Pas d'abonnement au kit. Le paiement sur ce site livre votre clé de licence par e-mail, avec accès au dépôt via invitation GitHub.

Comment les espaces de travail délimitent mes données ?

Les enregistrements appartenant aux utilisateurs sont délimités par workspaceId. Identité, droits d'accès, usage IA, événements de facturation et entrées d'audit restent dans le périmètre de l'espace personnel.

Comment fonctionnent les jobs en arrière-plan ?

Trigger.dev est le runtime de jobs explicite. Le contrat JobRunner ne promet que enqueue, status et cancel — la sémantique de workflow reste propre à Trigger.dev et explicite.

En quoi l'e-mail diffère-t-il de la prospection ?

L'e-mail transactionnel couvre les flux produit comme les avis de fin de tâche. La prospection à froid et les campagnes relèvent du produit, hors du module e-mail de ce kit.

Comment fonctionnent les achats sur mobile ?

Le mobile inclut les achats natifs et leur restauration via RevenueCat, avec un accès vérifié par votre serveur. Configurez les comptes des boutiques et terminez les tests sur appareil avant publication. La facturation web reste séparée.

Où vivent les clés des fournisseurs IA ?

Les identifiants BYOK sont chiffrés et restent côté serveur. Les clés sont masquées dans les journaux ; l'usage et les budgets restent visibles au niveau de l'espace de travail.

Quels moyens de paiement le checkout accepte-t-il ?

Le checkout hébergé par Stripe accepte les cartes et peut aussi proposer Alipay et WeChat Pay une fois ces portefeuilles activés sur le compte Stripe — pratique pour les acheteurs en Chine. Les autorisations de portefeuille se confirment de manière asynchrone : la page de licence se met à jour dès que le paiement est validé.

Puis-je obtenir un remboursement ?

Une fois que vous avez accès au dépôt, supastack vous appartient pour toujours et ne peut donc pas être remboursé. Mais rassurez-vous : vous obtenez le code source complet avec des mises à jour à vie pour créer et déployer un nombre illimité de produits pour vous ou vos clients. Vous ne pouvez simplement pas revendre le code ni redistribuer le dépôt sous forme de kit de démarrage ou de modèle.

FR
Thème