Fillagring och innehållshantering

Din app har ett dedikerat innehållsfilsystem för att lagra användaruppladdade filer som bilder, dokument, PDF:er och videor. Det är separerat från appkoden och är utformat för dynamiskt innehåll som användare skapar eller laddar upp medan de använder appen.

Gränser och viktiga noteringar

  • Enskilda filer kan vara upp till 500MB
  • Filradering är permanent — det finns ingen papperskorg
  • Lagringsanvändning räknas mot kontots kvot

Vad innehållsfilsystemet möjliggör

Innehållsfilsystemet ger appen avancerade filhanteringsförmågor:

  • Lagra användaravatarer, profilfoton och bildgallerier
  • Ta emot dokumentuppladdningar som CV:n, avtal eller PDF:er
  • Bygga fildelningsfunktioner mellan användare i appen
  • Skapa bildtunga appar med automatisk optimering
  • Låta användare ladda ned filer som de har laddat upp eller som tillhör dem
  • Bygga administrativa verktyg där du hanterar filer för användares räkning

Så fungerar det

När du beskriver en funktion som behöver fillagring för AI:n hanterar den automatiskt hela implementationen:

Sätter upp uppladdningsgränssnittet — skapar formulär eller drag-and-drop-zoner där användare kan välja filer från sin enhet

Konfigurerar åtkomstkontroll — avgör vem som kan visa, ladda upp eller radera filer baserat på vad du bygger

Implementerar bildoptimering — ändrar automatiskt storlek och serverar bilder effektivt så att appen laddar snabbt

Skapar lagringsstrukturen — organiserar filer i logiska mappar som /content/uploads/ eller /content/avatars/

Hanterar backend — sköter den faktiska fillagringen, hämtningen och leveransen utan att du behöver tänka på det

Filer lagras på paths som /content/uploads/photo.jpg och kan refereras direkt i appen. Systemet spårar vem som laddade upp varje fil, när den skapades och verkställer dina åtkomstregler.

Åtkomstkontroll för filer

Precis som databastabeller och edge functions har filer säkerhetspolicyer som styr vem som kan komma åt dem. Filer är privata som standard — ingen kan komma åt dem förrän du konfigurerar behörigheter. AI:n sätter upp dem baserat på vad du bygger:

Publika filer

Vem som helst kan visa dem, även utan att logga in. Inloggade användare kan ladda upp, och bara personen som laddade upp en fil kan radera den. Perfekt för fotogallerier, publik bilddelning eller webbplatser med användargenererat innehåll.

Privata filer

Bara användaren som laddade upp en fil kan visa eller radera den. Används för känsliga dokument, privata foton, journaler eller sådant användare inte vill att andra ska se.

Organisationsdelade filer

Användare från samma organisation kan visa filer som laddats upp av vem som helst i deras organisation. Enskilda personer kan bara radera filer de själva laddade upp. Bra för teamdokumentdelning, företagsresurser eller samarbetsytor.

Endast ägaråtkomst

Bara du (appskaparen) kan komma åt dessa filer, inte dina slutanvändare. Användbart för att lagra systemfiler, mallar eller administrativa resurser som driver appen men inte ska vara användarnära.

Avancerad åtkomstkontroll

AI:n kan skapa sofistikerade åtkomstregler baserat på filmetadata. Till exempel:

  • Publicerade artiklar är publika, men utkast är bara synliga för författaren
  • Filer taggade med en avdelning är bara synliga för användare i den avdelningen
  • Premiuminnehåll kräver en prenumerationsflagga på användarens konto
  • Delade filer är synliga för medarbetare som listas i filens metadata

Bildoptimering

Bilder som laddas upp till innehållsfilsystemet optimeras automatiskt för snabb laddning. När du visar en bild kan du begära en specifik bredd och systemet hanterar resten:

<!-- 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" />

Så fungerar optimering

Progressiv laddning — första gången någon begär en optimerad storlek serverar systemet den närmaste tillgängliga versionen och genererar den exakta storleken i bakgrunden. Varje begäran efter det får den perfekt dimensionerade, optimerade bilden. Originalfilen bevaras alltid.

Leverans i moderna format — systemet serverar automatiskt moderna bildformat (AVIF eller WebP) till webbläsare som stöder dem, med automatiskt fallback till JPEG eller PNG för äldre webbläsare. Detta sker transparent — du anger bara bredden, och användare får den snabbast laddande versionen som deras webbläsare kan hantera.

Prestandaoptimering — använd mindre bredder för att förbättra prestanda. En 200px-thumbnail laddar mycket snabbare än den ursprungliga 4000px-bilden och använder mindre bandbredd. Välj bredden som matchar hur du visar bilden.

Använda filer i appen

AI:n integrerar innehållsfilsystemet i din React-app automatiskt. När du ber om funktioner som involverar filer skapar den UI-komponenterna, kopplar upp uppladdnings-/nedladdningslogiken och hanterar fel.

Vanliga mönster som AI:n implementerar

Avataruppladdning — ett gränssnitt för profilfotouppladdning som validerar bildtyper, visar uppladdningsförlopp, förhandsvisar bilden och sparar pathen till användarens profil.

Dokumentgalleri — en filbläddrare som listar uppladdade dokument, visar thumbnails för bilder, ger nedladdningslänkar och tillåter filtrering eller sökning.

Drag-and-drop-uppladdning — en intuitiv uppladdningszon där användare kan dra filer från skrivbordet, se uppladdningsförlopp, avbryta pågående uppladdningar och få felmeddelanden för ogiltiga filer.

Filväljare — en modal eller sidopanel som visar filer som användaren tidigare har laddat upp, låter dem välja en för återanvändning och visar thumbnails och filnamn.

Edge Function-integration

Edge functions (din serverkod) kan komma åt innehållsfilsystemet för att bearbeta filer, generera filer programmatiskt eller implementera anpassad filhanteringslogik.

Vad Edge Functions kan göra med filer

  • Generera PDF-rapporter och spara dem så att användare kan ladda ned dem
  • Bearbeta uppladdade bilder (lägga på vattenmärken, skapa thumbnails, extrahera metadata)
  • Skanna uppladdade dokument efter känsliga data innan de accepteras
  • Implementera anpassad backup- eller arkiveringslogik
  • Analysera filinnehåll och extrahera strukturerade data
  • Utlösa workflows när specifika filer laddas upp

Varning: Viktig säkerhetsnotering

Edge functions går runt normal åtkomstkontroll. När din funktion kommer åt filer begränsas den inte av reglerna för "public" eller "owner" som gäller för användare. Det betyder att du måste implementera egna auktoriseringskontroller i funktionskoden för att säkerställa att användare bara kan komma åt filer de ska se.

Om en användare till exempel anropar din funktion och begär en fil behöver du verifiera att de äger filen eller har behörighet att komma åt den innan du returnerar innehållet. AI:n hanterar detta när den bygger dina funktioner, men det är viktigt att förstå att funktionskod körs med förhöjda privilegier.

Lagringsorganisation

AI:n organiserar filer i logiska mappar baserat på vad du bygger. Du behöver inte skapa mappstrukturer manuellt — beskriv bara vad du behöver, så sätter AI:n upp lämpliga paths.

Vanliga organisationsmönster

  • /content/uploads/ — Allmänna användaruppladdningar
  • /content/avatars/ — Användares profilfoton
  • /content/documents/ — PDF:er och dokument
  • /content/gallery/ — Fotogalleribilder
  • /content/private/ — Privata användarfiler
  • /content/public/ — Publikt åtkomliga filer
  • /content/temp/ — Temporära filer som kan raderas

AI:n kan skapa nästlade mappar som /content/uploads/2024/ eller /content/users/[username]/ när det passar ditt use case. Filer spåras med sin fullständiga path, så att flytta eller byta namn på filer uppdaterar alla referenser automatiskt.

Övervakning och felsökning

Alla filoperationer loggas — uppladdningar, nedladdningar, åtkomstnekanden och fel. Du kan visa dessa loggar i adminpanelen för att förstå hur fillagringen används:

  • Se vilka filer som laddas upp oftast
  • Identifiera misslyckade uppladdningar och vad som gick fel
  • Spåra nedladdningsmönster och populära filer
  • Övervaka lagringsanvändning och tillväxt över tid
  • Felsöka åtkomstkontrollproblem när användare inte kan komma åt filer de förväntar sig att se

Systemet spårar också lagringsmått — totalt antal lagrade filer, total storlek, tillväxttakt och största filer. Det hjälper dig att förstå appens lagringsavtryck och planera för skalning.

Gränser och begränsningar

Som standard kan enskilda filer vara upp till 500MB. Detta är konfigurerbart — AI:n kan justera gränsen baserat på vad du bygger. För de flesta appar (bilduppladdningar, dokumentdelning, PDF:er) är standardgränsen mer än tillräcklig.

Filer lagras redundant för tillförlitlighet. Om du raderar en fil tas den permanent bort från systemet — det finns ingen papperskorg, så radering är omedelbar och slutlig.

Arbeta med AI:n

När du beskriver funktioner som behöver fillagring, var specifik om:

  • Vem som kan komma åt filerna — publika, privata, organisationsdelade eller anpassade regler
  • Vilka filtyper — bara bilder, PDF:er, valfri filtyp, storleksgränser
  • Hur filer organiseras — mappar, namngivningskonventioner, om användare kan skapa undermappar
  • Vad som händer efter uppladdning — visa i ett galleri, koppla till en post, bearbeta med en funktion

AI:n använder den informationen för att konfigurera lagringen korrekt, sätta upp åtkomstpolicyer och skapa ett gränssnitt som matchar dina behov.


Relaterad dokumentation: