Bestandsopslag en contentbeheer

Uw applicatie beschikt over een eigen contentbestandssysteem voor het opslaan van door gebruikers geüploade bestanden, zoals afbeeldingen, documenten, pdf's en video's. Dit staat los van uw applicatiecode en is ontworpen voor dynamische content die gebruikers aanmaken of uploaden terwijl ze uw app gebruiken.

Limieten en belangrijke opmerkingen

  • Individuele bestanden kunnen maximaal 500 MB groot zijn
  • Het verwijderen van bestanden is permanent: er is geen prullenbak of herstelmogelijkheid
  • Het opslaggebruik telt mee voor uw accountquotum

Wat het contentbestandssysteem mogelijk maakt

Het contentbestandssysteem biedt krachtige mogelijkheden voor bestandsbeheer voor uw toepassing:

  • Gebruikersavatars, profielfoto's en afbeeldingsgalerijen opslaan
  • Documentuploads accepteren, zoals cv's, contracten of pdf's
  • Functies voor het delen van bestanden bouwen tussen gebruikers in uw app
  • Afbeeldingsrijke applicaties maken met automatische optimalisatie
  • Gebruikers hun eigen bestanden laten downloaden: bestanden die ze hebben geüpload of die bij hen horen
  • Beheertools bouwen waarmee u bestanden namens gebruikers beheert

Hoe het werkt

Wanneer u de AI een functie beschrijft die bestandsopslag nodig heeft, handelt de AI de hele implementatie automatisch af:

Zet de uploadinterface op — Maakt formulieren of drag-and-drop-zones waar gebruikers bestanden op hun apparaat kunnen selecteren

Configureert toegangsbeheer — Bepaalt wie bestanden kan bekijken, uploaden of verwijderen op basis van wat u aan het bouwen bent

Implementeert afbeeldingsoptimalisatie — Past automatisch het formaat aan en levert afbeeldingen efficiënt uit, zodat uw app snel laadt

Maakt de opslagstructuur — Organiseert bestanden in logische mappen zoals /content/uploads/ of /content/avatars/

Regelt de backend — Beheert de daadwerkelijke opslag, het ophalen en de levering van bestanden zonder dat u erover hoeft na te denken

Bestanden worden opgeslagen op paden zoals /content/uploads/photo.jpg en er kan rechtstreeks naar worden verwezen in uw app. Het systeem houdt bij wie elk bestand heeft geüpload, wanneer het is aangemaakt, en past uw toegangsregels toe.

Toegangscontrole voor bestanden

Net als databasetabellen en edge functions hebben bestanden een beveiligingsbeleid dat bepaalt wie er toegang toe heeft. Bestanden zijn standaard privé: niemand heeft er toegang toe totdat u de machtigingen configureert. De AI stelt deze in op basis van wat u bouwt:

Openbare bestanden

Iedereen kan ze bekijken, zelfs zonder in te loggen. Ingelogde gebruikers kunnen uploaden, en alleen de persoon die een bestand heeft geüpload kan het verwijderen. Perfect voor fotogalerijen, het openbaar delen van afbeeldingen of sites met door gebruikers gegenereerde inhoud.

Privébestanden

Alleen de gebruiker die een bestand heeft geüpload, kan het bekijken of verwijderen. Gebruikt voor gevoelige documenten, privéfoto's, medische dossiers of alles wat gebruikers niet willen dat anderen zien.

Organisatie-gedeelde bestanden

Gebruikers uit dezelfde organisatie kunnen bestanden bekijken die door iedereen in hun organisatie zijn geüpload. Individuen kunnen alleen bestanden verwijderen die ze hebben geüpload. Ideaal voor het delen van teamdocumenten, bedrijfsbronnen of samenwerkingswerkplekken.

Alleen toegang voor de eigenaar

Alleen u (de maker van de app) heeft toegang tot deze bestanden, niet uw eindgebruikers. Handig voor het opslaan van systeembestanden, sjablonen of administratieve bronnen die uw app ondersteunen, maar die niet op de gebruiker gericht mogen zijn.

Geavanceerde toegangscontrole

De AI kan geavanceerde toegangsregels opstellen op basis van de metagegevens van bestanden. Bijvoorbeeld:

  • Gepubliceerde artikelen zijn openbaar, maar concepten zijn alleen zichtbaar voor de auteur
  • Bestanden die zijn getagd met een afdeling zijn alleen zichtbaar voor gebruikers in die afdeling
  • Voor premiuminhoud is een abonnementsvlag op het account van de gebruiker vereist
  • Gedeelde bestanden zijn zichtbaar voor bijdragers die worden vermeld in de metagegevens van het bestand

Afbeeldingsoptimalisatie

Afbeeldingen die naar het contentbestandssysteem worden geüpload, worden automatisch geoptimaliseerd voor snel laden. Wanneer u een afbeelding weergeeft, kunt u een specifieke breedte aanvragen en het systeem doet de rest:

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

Hoe optimalisatie werkt

Progressief laden — De eerste keer dat iemand om een geoptimaliseerde grootte vraagt, levert het systeem de dichtstbijzijnde beschikbare versie en genereert het de exacte grootte op de achtergrond. Elk verzoek daarna krijgt de precies passende, geoptimaliseerde afbeelding. Het originele bestand blijft altijd behouden.

Levering van moderne formaten — Het systeem levert automatisch moderne afbeeldingsformaten (AVIF of WebP) aan browsers die deze ondersteunen, met automatische terugval naar JPEG of PNG voor oudere browsers. Dit gebeurt transparant: u geeft gewoon de breedte op en gebruikers krijgen de snelst ladende versie die hun browser aankan.

Prestatieoptimalisatie — Gebruik kleinere breedtes om de prestaties te verbeteren. Een thumbnail van 200 px laadt veel sneller dan de originele 4000 px-afbeelding en gebruikt minder bandbreedte. Kies de breedte die overeenkomt met hoe u de afbeelding weergeeft.

Bestanden gebruiken in uw toepassing

De AI integreert het contentbestandssysteem automatisch in uw React-applicatie. Wanneer u om functies vraagt waarbij bestanden betrokken zijn, worden de UI-componenten gemaakt, wordt de upload-/downloadlogica aangesloten en worden fouten afgehandeld.

Veelgebruikte patronen die de AI implementeert

Avatar uploaden — Een interface voor het uploaden van profielfoto's die afbeeldingstypen valideert, de uploadvoortgang toont, een voorbeeld van de afbeelding weergeeft en het pad naar het gebruikersprofiel opslaat.

Documentgalerij — Een bestandsbrowser die geüploade documenten weergeeft, miniaturen voor afbeeldingen weergeeft, downloadlinks biedt en filteren of zoeken mogelijk maakt.

Uploaden via slepen en neerzetten — Een intuïtieve uploadzone waar gebruikers bestanden vanaf hun bureaublad kunnen slepen, de uploadvoortgang kunnen zien, lopende uploads kunnen annuleren en foutmeldingen kunnen krijgen voor ongeldige bestanden.

Bestandskiezer — Een modaal venster of zijbalk dat bestanden toont die de gebruiker eerder heeft geüpload, waarmee hij er een kan selecteren voor hergebruik, en miniaturen en bestandsnamen weergeeft.

Integratie met edge functions

Edge functions (uw code aan de serverkant) hebben toegang tot het contentbestandssysteem om bestanden te verwerken, programmatisch bestanden te genereren of aangepaste logica voor bestandsafhandeling te implementeren.

Wat edge functions met bestanden kunnen doen

  • PDF-rapporten genereren en opslaan zodat gebruikers ze kunnen downloaden
  • Geüploade afbeeldingen verwerken (watermerken toepassen, miniaturen maken, metadata extraheren)
  • Geüploade documenten op gevoelige gegevens controleren voordat ze worden geaccepteerd
  • Eigen back-up- of archiveringslogica implementeren
  • De inhoud van bestanden analyseren en er gestructureerde gegevens uit halen
  • Workflows starten wanneer specifieke bestanden worden geüpload

Waarschuwing: Belangrijke veiligheidsopmerking

Edge functions omzeilen het normale toegangsbeheer. Wanneer uw functie toegang krijgt tot bestanden, wordt deze niet beperkt door de 'openbare' of 'eigenaar'-regels die van toepassing zijn op gebruikers. Dit betekent dat u uw eigen autorisatiecontroles in de functiecode moet implementeren om ervoor te zorgen dat gebruikers alleen toegang hebben tot bestanden die zij mogen zien.

Als een gebruiker bijvoorbeeld uw functie aanroept en een bestand opvraagt, moet u verifiëren dat hij of zij de eigenaar van dat bestand is of toestemming heeft om het te openen voordat u de inhoud retourneert. De AI handelt dit af bij het bouwen van uw functies, maar het is belangrijk om te begrijpen dat functiecode met verhoogde bevoegdheden wordt uitgevoerd.

Opslagorganisatie

De AI organiseert bestanden in logische mappen op basis van wat u aan het bouwen bent. U hoeft de mapstructuren niet handmatig te maken; beschrijf gewoon wat u nodig heeft, en de AI stelt de juiste paden in.

Veelgebruikte indelingen

  • /content/uploads/ — Algemene gebruikersuploads
  • /content/avatars/ - Gebruikersprofielfoto's
  • /content/documents/ — PDF's en documenten
  • /content/gallery/ — Fotogalerijafbeeldingen
  • /content/private/ — Privégebruikersbestanden
  • /content/public/ — Openbaar toegankelijke bestanden
  • /content/temp/ — Tijdelijke bestanden die kunnen worden verwijderd

De AI kan geneste mappen maken, zoals /content/uploads/2024/ of /content/users/[username]/ wanneer dit passend is voor uw gebruikssituatie. Bestanden worden gevolgd op basis van hun volledige pad, dus als u bestanden verplaatst of hernoemt, worden alle verwijzingen automatisch bijgewerkt.

Monitoring en foutopsporing

Alle bestandsbewerkingen worden geregistreerd: uploads, downloads, toegangsweigeringen en fouten. U kunt deze logboeken bekijken in de beheerinterface om te begrijpen hoe uw bestandsopslag wordt gebruikt:

  • Bekijk welke bestanden het vaakst worden geüpload
  • Identificeer mislukte uploads en wat er mis is gegaan
  • Volg downloadpatronen en populaire bestanden
  • Houd het opslaggebruik en de groei in de loop van de tijd in de gaten
  • Los problemen met toegangscontrole op wanneer gebruikers geen toegang hebben tot bestanden die ze verwachten te zien

Het systeem houdt ook opslagstatistieken bij: het totale aantal opgeslagen bestanden, de totale grootte, de groeisnelheid en de grootste bestanden. Dit helpt u inzicht te krijgen in de opslagvoetafdruk van uw app en plannen te maken voor schaalvergroting.

Grenzen en beperkingen

Standaard kunnen afzonderlijke bestanden maximaal 500 MB zijn. Dit is configureerbaar: de AI kan de limiet aanpassen op basis van wat u bouwt. Voor de meeste toepassingen (uploads van afbeeldingen, delen van documenten, pdf's) is de standaardlimiet ruim voldoende.

Bestanden worden redundant opgeslagen voor betrouwbaarheid. Als u een bestand verwijdert, wordt het permanent van het systeem verwijderd. Er is geen prullenbak of herstelmogelijkheid, dus de verwijdering is onmiddellijk en definitief.

Werken met de AI

Wanneer u functies beschrijft waarvoor bestandsopslag nodig is, wees dan specifiek over:

  • Wie heeft toegang tot de bestanden: openbare, privé-, door de organisatie gedeelde of aangepaste regels
  • Welke soorten bestanden — Alleen afbeeldingen, PDF's, elk bestandstype, maximale grootte
  • Hoe bestanden zijn georganiseerd — Mappen, naamgevingsconventies, of gebruikers submappen kunnen maken
  • Wat er gebeurt na het uploaden — Weergeven in een galerij, bijvoegen bij een record, verwerken met een functie

De AI gebruikt deze informatie om de opslag correct te configureren, toegangsbeleid in te stellen en een interface te creëren die aan uw behoeften voldoet.


Gerelateerde documentatie: