Fillagring og innholdsbehandling

Applikasjonen din har et dedikert innholdsfilsystem for lagring av brukeropplastede filer som bilder, dokumenter, PDF-er og videoer. Dette er atskilt fra applikasjonskoden din og er designet for dynamisk innhold som brukere lager eller laster opp mens de bruker appen din.

Begrensninger og viktige merknader

  • Individuelle filer kan være opptil 500MB store
  • Filsletting er permanent — det finnes ingen søppelkasse eller papirkurv
  • Lagringsbruk teller mot kontokvoten din

Hva innholdsfilsystemet muliggjør

Innholdsfilsystemet gir kraftige filbehandlingsfunksjoner for applikasjonen din:

  • Lagre brukeravatarer, profilbilder og bildegallerier
  • Godta dokumentopplastinger som CVer, kontrakter eller PDF-er
  • Bygg fildelingsfunksjoner mellom brukere i appen din
  • Lag bildetunge applikasjoner med automatisk optimalisering
  • La brukere laste ned filer de har lastet opp eller som tilhører dem
  • Bygg administrative verktøy der du administrerer filer på vegne av brukere

Hvordan det fungerer

Når du beskriver en funksjon som trenger fillagring til AI, håndterer den automatisk hele implementeringen:

Setter opp opplastingsgrensesnittet — Oppretter skjemaer eller dra-og-slipp-soner der brukere kan velge filer fra enheten sin

Konfigurerer tilgangskontroll — Bestemmer hvem som kan se, laste opp eller slette filer basert på hva du bygger

Implementerer bildeoptimalisering — Endrer automatisk størrelse og viser bilder effektivt slik at appen din lastes raskt

Oppretter lagringsstrukturen — Organiserer filer i logiske mapper som /content/uploads/ eller /content/avatars/

Håndterer backend — Administrerer selve fillagringen, hentingen og leveringen uten at du trenger å tenke på det

Filer lagres på stier som /content/uploads/photo.jpg og kan refereres direkte i appen din. Systemet sporer hvem som lastet opp hver fil, når den ble opprettet, og håndhever tilgangsreglene dine.

Tilgangskontroll for filer

Akkurat som databasetabeller og edge functions, har filer sikkerhetspolicyer som kontrollerer hvem som har tilgang til dem. Filer er private som standard — ingen har tilgang til dem før du konfigurerer tillatelser. AI setter disse opp basert på hva du bygger:

Offentlige filer

Alle kan se dem, selv uten å logge på. Påloggede brukere kan laste opp, og bare personen som lastet opp en fil kan slette den. Perfekt for fotogallerier, offentlig bildedeling eller brukergenererte innholdssider.

Private filer

Bare brukeren som lastet opp en fil kan se eller slette den. Brukes til sensitive dokumenter, private bilder, medisinske journaler eller noe brukere ikke vil at andre skal se.

Organisasjonsdelte filer

Brukere fra samme organisasjon kan se filer lastet opp av alle i deres organisasjon. Enkeltpersoner kan bare slette filer de lastet opp. Flott for teamdokumentdeling, bedriftsressurser eller samarbeidende arbeidsområder.

Kun eiertilgang

Bare du (appskaperen) har tilgang til disse filene, ikke sluttbrukerne dine. Nyttig for lagring av systemfiler, maler eller administrative ressurser som driver appen din, men som ikke skal være brukervendt.

Avansert tilgangskontroll

AI kan lage sofistikerte tilgangsregler basert på filmetadata. For eksempel:

  • Publiserte artikler er offentlige, men utkast er kun synlige for forfatteren
  • Filer merket med en avdeling er kun synlige for brukere i den avdelingen
  • Premium-innhold krever et abonnementsflagg på brukerens konto
  • Delte filer er synlige for samarbeidspartnere oppført i filens metadata

Bildeoptimalisering

Bilder som lastes opp til innholdsfilsystemet, optimaliseres automatisk for rask lasting. Når du viser et bilde, kan du be om en bestemt bredde og systemet håndterer 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" />

Hvordan optimalisering fungerer

Progressiv lasting — Første gang noen ber om en optimalisert størrelse, serverer systemet den nærmeste tilgjengelige versjonen og genererer den nøyaktige størrelsen i bakgrunnen. Hver forespørsel etter det får det optimaliserte bildet i perfekt størrelse. Den opprinnelige filen er alltid bevart.

Moderne formatlevering — Systemet leverer automatisk moderne bildeformater (AVIF eller WebP) til nettlesere som støtter dem, med automatisk fallback til JPEG eller PNG for eldre nettlesere. Dette skjer transparent - du spesifiserer bare bredden, og brukerne får den raskest lastende versjonen nettleseren deres kan håndtere.

Ytelsesoptimalisering — Bruk mindre bredder for å forbedre ytelsen. Et 200px-miniatyrbilde lastes mye raskere enn det originale 4000px-bildet og bruker mindre båndbredde. Velg bredden som samsvarer med hvordan du viser bildet.

Bruke filer i applikasjonen din

AI integrerer innholdsfilsystemet i React-applikasjonen automatisk. Når du ber om funksjoner som involverer filer, oppretter den UI-komponentene, kobler opp opplastings-/nedlastingslogikken og håndterer feil.

Vanlige mønstre AI implementerer

Avataropplasting — Et grensesnitt for opplasting av profilbilder som validerer bildetyper, viser opplastingsfremdrift, forhåndsviser bildet og lagrer banen til brukerens profil.

Dokumentgalleri — En filbehandler som viser opplastede dokumenter, viser miniatyrbilder for bilder, gir nedlastingskoblinger og tillater filtrering eller søking.

Dra-og-slipp-opplasting — En intuitiv opplastingssone der brukere kan dra filer fra skrivebordet, se opplastingsfremdrift, avbryte opplastinger som pågår og få feilmeldinger for ugyldige filer.

Filvelger — En modal eller sidefelt som viser filer som brukeren tidligere har lastet opp, lar dem velge en for gjenbruk og viser miniatyrbilder og filnavn.

Integrasjon med edge functions

Edge functions (koden din på serversiden) kan få tilgang til innholdsfilsystemet for å behandle filer, generere filer programmatisk eller implementere tilpasset filhåndteringslogikk.

Hva Edge Functions kan gjøre med filer

  • Generer PDF-rapporter og lagre dem slik at brukerne kan laste dem ned
  • Behandle opplastede bilder (bruk vannmerker, lag miniatyrbilder, trekk ut metadata)
  • Skann opplastede dokumenter for sensitive data før du godtar dem
  • Implementer tilpasset sikkerhetskopiering eller arkiveringslogikk
  • Analyser filinnholdet og trekk ut strukturerte data
  • Utløs arbeidsflyter når bestemte filer lastes opp

Advarsel: Viktig sikkerhetsmerknad

Edge functions omgår normal tilgangskontroll. Når funksjonen din får tilgang til filer, er den ikke begrenset av "offentlige" eller "eier"-reglene som gjelder for brukere. Dette betyr at du må implementere dine egne autorisasjonssjekker i funksjonskoden for å sikre at brukere bare kan få tilgang til filer de skal se.

For eksempel, hvis en bruker kaller funksjonen din og ber om en fil, må du bekrefte at vedkommende eier filen eller har tillatelse til å få tilgang til den før du returnerer innholdet. AI håndterer dette når du bygger funksjonene dine, men det er viktig å forstå at funksjonskoden kjører med forhøyede rettigheter.

Organisering av lagring

AI organiserer filer i logiske mapper basert på hva du bygger. Du trenger ikke lage mappestrukturer manuelt - bare beskriv hva du trenger, og AI setter opp passende baner.

Vanlige organisasjonsmønstre

  • /content/uploads/ — Generelle brukeropplastinger
  • /content/avatars/ — Brukerprofilbilder
  • /content/documents/ — PDF-er og dokumenter
  • /content/gallery/ — Bildegalleribilder
  • /content/private/ — Private brukerfiler
  • /content/public/ — Offentlig tilgjengelige filer
  • /content/temp/ — Midlertidige filer som kan slettes

AI kan lage nestede mapper som /content/uploads/2024/ eller /content/users/[username]/ når det passer for ditt bruksområde. Filer spores etter deres fulle bane, så flytting eller omdøping av filer oppdaterer alle referanser automatisk.

Overvåking og feilsøking

Alle filoperasjoner logges – opplastinger, nedlastinger, tilgangsnektelser og feil. Du kan se disse loggene i administrasjonsgrensesnittet for å forstå hvordan fillagringen din blir brukt:

  • Se hvilke filer som lastes opp oftest
  • Identifiser mislykkede opplastinger og hva som gikk galt
  • Spor nedlastingsmønstre og populære filer
  • Overvåk lagringsbruk og vekst over tid
  • Feilsøk problemer med tilgangskontroll når brukere ikke får tilgang til filer de forventer å se

Systemet sporer også lagringsverdier - totalt lagrede filer, total størrelse, veksthastighet og største filer. Dette hjelper deg å forstå appens lagringsfotavtrykk og planlegge for skalering.

Grenser og begrensninger

Som standard kan individuelle filer være opptil 500MB. Dette er konfigurerbart - AI kan justere grensen basert på hva du bygger. For de fleste applikasjoner (bildeopplasting, dokumentdeling, PDF-er) er standardgrensen mer enn tilstrekkelig.

Filer lagres redundant for pålitelighet. Hvis du sletter en fil, blir den permanent fjernet fra systemet – det finnes ingen søppelkasse eller papirkurv, så slettingen er umiddelbar og endelig.

Jobber med AI

Når du beskriver funksjoner som trenger fillagring, vær spesifikk om:

  • Hvem som har tilgang til filene — Offentlige, private, organisasjonsdelte eller tilpassede regler
  • Hvilke typer filer — Kun bilder, PDF-er, alle filtyper, størrelsesgrenser
  • Hvordan filer er organisert — Mapper, navnekonvensjoner, om brukere kan opprette undermapper
  • Hva som skjer etter opplasting — Vis i et galleri, legg ved en post, bearbeid med en funksjon

AI bruker denne informasjonen til å konfigurere lagringen riktig, sette opp tilgangspolicyer og lage et grensesnitt som matcher dine behov.


Relatert dokumentasjon: