Dateispeicherung und Content-Management
Ihre Anwendung verfügt über ein spezielles Inhaltsdateisystem zum Speichern von vom Benutzer hochgeladenen Dateien wie Bildern, Dokumenten, PDFs und Videos. Dies ist von Ihrem Anwendungscode getrennt und für dynamische Inhalte konzipiert, die Benutzer erstellen oder hochladen, während sie Ihre App verwenden.
Grenzen und wichtige Hinweise
- Einzelne Dateien können bis zu 500 MB groß sein
- Das Löschen von Dateien ist dauerhaft – es gibt keinen Papierkorb
- Die Speichernutzung wird auf Ihr Kontokontingent angerechnet
Was das Content-Dateisystem ermöglicht
Das Inhaltsdateisystem bietet leistungsstarke Dateiverwaltungsfunktionen für Ihre Anwendung:
- Benutzeravatare, Profilfotos und Bildergalerien speichern
- Akzeptieren Sie Dokument-Uploads wie Lebensläufe, Verträge oder PDFs
- Erstellen Sie Dateifreigabefunktionen zwischen Benutzern in Ihrer App
- Erstellen Sie bildintensive Anwendungen mit automatischer Optimierung
- Benutzern erlauben, Dateien herunterzuladen, die sie hochgeladen haben oder die ihnen gehören
- Erstellen Sie Verwaltungstools, mit denen Sie Dateien im Auftrag von Benutzern verwalten
Wie es funktioniert
Wenn Sie der KI eine Funktion beschreiben, die Dateispeicherung benötigt, übernimmt diese automatisch die gesamte Implementierung:
Richte die Upload-Schnittstelle ein – Erstellt Formulare oder Drag-and-Drop-Zonen, in denen Benutzer Dateien von ihrem Gerät auswählen können
Konfiguriert die Zugriffskontrolle – Legt fest, wer Dateien basierend auf dem, was Sie erstellen, anzeigen, hochladen oder löschen kann
Implementiert die Bildoptimierung – Passt die Größe automatisch an und stellt Bilder effizient bereit, sodass Ihre App schnell geladen wird
Erstellt die Speicherstruktur – Organisiert Dateien in logischen Ordnern wie /content/uploads/ oder /content/avatars/
Verwaltet das Backend – Verwaltet die eigentliche Dateispeicherung, den Abruf und die Bereitstellung, ohne dass Sie darüber nachdenken müssen
Dateien werden unter Pfaden wie /content/uploads/photo.jpg gespeichert und können direkt in Ihrer App referenziert werden. Das System verfolgt, wer die einzelnen Dateien hochgeladen hat, wann sie erstellt wurden, und setzt Ihre Zugriffsregeln durch.
Zugriffskontrolle für Dateien
Genau wie Datenbanktabellen und Edge Functions verfügen Dateien über Sicherheitsrichtlinien, die steuern, wer auf sie zugreifen kann. Dateien sind standardmäßig privat – niemand kann darauf zugreifen, bis Sie Berechtigungen konfigurieren. Die KI richtet diese basierend auf dem ein, was Sie erstellen:
Öffentliche Dateien
Jeder kann sie sehen, auch ohne sich anzumelden. Angemeldete Benutzer können Dateien hochladen, und nur die Person, die eine Datei hochgeladen hat, kann sie löschen. Perfekt für Fotogalerien, öffentliche Bildfreigabe oder Websites mit benutzergenerierten Inhalten.
Private Dateien
Nur der Benutzer, der eine Datei hochgeladen hat, kann sie anzeigen oder löschen. Wird für vertrauliche Dokumente, private Fotos, Krankenakten oder alles andere verwendet, was Benutzer nicht möchten, dass andere es sehen.
Von der Organisation freigegebene Dateien
Benutzer aus derselben Organisation können von jedem in ihrer Organisation hochgeladene Dateien anzeigen. Einzelpersonen können nur Dateien löschen, die sie hochgeladen haben. Ideal für die gemeinsame Nutzung von Teamdokumenten, Unternehmensressourcen oder kollaborativen Arbeitsbereichen.
Zugriff nur für Eigentümer
Nur Sie (der App-Ersteller) können auf diese Dateien zugreifen, nicht Ihre Endbenutzer. Nützlich zum Speichern von Systemdateien, Vorlagen oder Verwaltungsressourcen, die Ihre App unterstützen, aber nicht für den Benutzer zugänglich sein sollten.
Erweiterte Zugangskontrolle
Die KI kann auf Basis von Dateimetadaten ausgefeilte Zugriffsregeln erstellen. Zum Beispiel:
- Veröffentlichte Artikel sind öffentlich, Entwürfe sind jedoch nur für den Autor sichtbar
- Mit einer Abteilung gekennzeichnete Dateien sind nur für Benutzer in dieser Abteilung sichtbar
- Premium-Inhalte erfordern eine Abonnementkennzeichnung im Benutzerkonto
- Freigegebene Dateien sind für die in den Metadaten der Datei aufgeführten Mitarbeiter sichtbar
Bildoptimierung
In das Inhaltsdateisystem hochgeladene Bilder werden automatisch für schnelles Laden optimiert. Wenn Sie ein Bild anzeigen, können Sie eine bestimmte Breite anfordern, den Rest erledigt das System:
<!-- 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" />
Wie Optimierung funktioniert
Progressives Laden – Wenn jemand zum ersten Mal eine optimierte Größe anfordert, stellt das System die nächstgelegene verfügbare Version bereit und generiert die genaue Größe im Hintergrund. Jede weitere Anfrage erhält das perfekt dimensionierte, optimierte Bild. Die Originaldatei bleibt immer erhalten.
Bereitstellung moderner Formate – Das System stellt Browsern, die diese unterstützen, automatisch moderne Bildformate (AVIF oder WebP) bereit, mit automatischem Fallback auf JPEG oder PNG für ältere Browser. Dies geschieht transparent – Sie geben einfach die Breite an und Benutzer erhalten die am schnellsten ladende Version, die ihr Browser verarbeiten kann.
Leistungsoptimierung – Verwenden Sie kleinere Breiten, um die Leistung zu verbessern. Ein 200-Pixel-Miniaturbild wird viel schneller geladen als das ursprüngliche 4000-Pixel-Bild und verbraucht weniger Bandbreite. Wählen Sie die Breite, die der Darstellung des Bildes entspricht.
Verwenden von Dateien in Ihrer Anwendung
Die KI integriert das Inhaltsdateisystem automatisch in Ihre React-Anwendung. Wenn Sie nach Funktionen fragen, die Dateien beinhalten, werden die UI-Komponenten erstellt, die Upload-/Download-Logik verknüpft und Fehler behandelt.
Gemeinsame Muster, die die KI implementiert
Avatar-Upload – Eine Schnittstelle zum Hochladen von Profilfotos, die Bildtypen validiert, den Upload-Fortschritt anzeigt, eine Vorschau des Bildes anzeigt und den Pfad zum Profil des Benutzers speichert.
Dokumentengalerie – Ein Dateibrowser, der hochgeladene Dokumente auflistet, Miniaturansichten für Bilder anzeigt, Download-Links bereitstellt und das Filtern oder Suchen ermöglicht.
Drag-and-Drop-Upload – Eine intuitive Upload-Zone, in der Benutzer Dateien von ihrem Desktop ziehen, den Upload-Fortschritt sehen, laufende Uploads abbrechen und Fehlermeldungen für ungültige Dateien erhalten können.
Dateiauswahl – Eine modale oder Seitenleiste, die Dateien anzeigt, die der Benutzer zuvor hochgeladen hat, es ihm ermöglicht, eine Datei zur Wiederverwendung auszuwählen und Miniaturansichten und Dateinamen anzuzeigen.
Integration mit Edge Functions
Edge Functions (Ihr serverseitiger Code) können auf das Inhaltsdateisystem zugreifen, um Dateien zu verarbeiten, Dateien programmgesteuert zu generieren oder benutzerdefinierte Dateiverarbeitungslogik zu implementieren.
Was Edge Functions mit Dateien machen können
- Erstellen Sie PDF-Berichte und speichern Sie sie, damit Benutzer sie herunterladen können
- Hochgeladene Bilder verarbeiten (Wasserzeichen anwenden, Miniaturansichten erstellen, Metadaten extrahieren)
- Scannen Sie hochgeladene Dokumente auf sensible Daten, bevor Sie sie akzeptieren
- Implementieren Sie benutzerdefinierte Sicherungs- oder Archivierungslogik
- Analysieren Sie Dateiinhalte und extrahieren Sie strukturierte Daten
- Lösen Sie Workflows aus, wenn bestimmte Dateien hochgeladen werden
Warnung: Wichtiger Sicherheitshinweis
Edge Functions umgehen die normale Zugangskontrolle. Wenn Ihre Funktion auf Dateien zugreift, ist sie nicht durch die für Benutzer geltenden „öffentlichen“ oder „Eigentümer“-Regeln eingeschränkt. Das bedeutet, dass Sie Ihre eigenen Berechtigungsprüfungen im Funktionscode implementieren müssen, um sicherzustellen, dass Benutzer nur auf Dateien zugreifen können, die sie sehen sollten.
Wenn beispielsweise ein Benutzer Ihre Funktion aufruft und eine Datei anfordert, müssen Sie überprüfen, ob er der Eigentümer dieser Datei ist oder über die Berechtigung zum Zugriff darauf verfügt, bevor Sie den Inhalt zurückgeben. Die KI übernimmt dies beim Erstellen Ihrer Funktionen. Es ist jedoch wichtig zu verstehen, dass Funktionscode mit erhöhten Berechtigungen ausgeführt wird.
Organisation des Speichers
Die KI organisiert Dateien basierend auf dem, was Sie erstellen, in logischen Ordnern. Sie müssen Ordnerstrukturen nicht manuell erstellen – beschreiben Sie einfach, was Sie benötigen, und die KI richtet die entsprechenden Pfade ein.
Gemeinsame Organisationsmuster
/content/uploads/– Allgemeine Benutzer-Uploads/content/avatars/– Benutzerprofilfotos/content/documents/– PDFs und Dokumente/content/gallery/– Bilder in der Fotogalerie/content/private/– Private Benutzerdateien/content/public/– Öffentlich zugängliche Dateien/content/temp/– Temporäre Dateien, die gelöscht werden können
Die KI kann verschachtelte Ordner wie /content/uploads/2024/ oder /content/users/[username]/ erstellen, wenn dies für Ihren Anwendungsfall angemessen ist. Dateien werden anhand ihres vollständigen Pfads verfolgt, sodass beim Verschieben oder Umbenennen von Dateien alle Referenzen automatisch aktualisiert werden.
Überwachung und Debugging
Alle Dateivorgänge werden protokolliert – Uploads, Downloads, Zugriffsverweigerungen und Fehler. Sie können diese Protokolle in der Admin-Oberfläche anzeigen, um zu verstehen, wie Ihr Dateispeicher verwendet wird:
- Sehen Sie, welche Dateien am häufigsten hochgeladen werden
- Identifizieren Sie fehlgeschlagene Uploads und was schief gelaufen ist
- Verfolgen Sie Downloadmuster und beliebte Dateien
- Überwachen Sie die Speichernutzung und das Speicherwachstum im Laufe der Zeit
- Beheben Sie Probleme bei der Zugriffskontrolle, wenn Benutzer nicht auf die erwarteten Dateien zugreifen können
Das System verfolgt auch Speichermetriken – insgesamt gespeicherte Dateien, Gesamtgröße, Wachstumsrate und größte Dateien. Dies hilft Ihnen, den Speicherbedarf Ihrer App zu verstehen und die Skalierung zu planen.
Grenzen und Einschränkungen
Standardmäßig können einzelne Dateien bis zu 500 MB groß sein. Dies ist konfigurierbar – die KI kann das Limit basierend auf dem, was Sie bauen, anpassen. Für die meisten Anwendungen (Bild-Uploads, Dokumentfreigabe, PDFs) ist das Standardlimit mehr als ausreichend.
Aus Gründen der Zuverlässigkeit werden Dateien redundant gespeichert. Wenn Sie eine Datei löschen, wird sie dauerhaft aus dem System entfernt. Es gibt keinen Papierkorb, sodass die Löschung sofort und endgültig erfolgt.
Arbeiten mit der KI
Achten Sie bei der Beschreibung von Funktionen, die Dateispeicherung erfordern, genau auf Folgendes:
- Wer kann auf die Dateien zugreifen – Öffentliche, private, von der Organisation freigegebene oder benutzerdefinierte Regeln
- Welche Dateitypen – Nur Bilder, PDFs, alle Dateitypen, Größenbeschränkungen
- Wie Dateien organisiert sind – Ordner, Namenskonventionen, ob Benutzer Unterordner erstellen können
- Was passiert nach dem Hochladen – In einer Galerie anzeigen, an einen Datensatz anhängen, mit einer Funktion verarbeiten
Die KI verwendet diese Informationen, um den Speicher richtig zu konfigurieren, Zugriffsrichtlinien einzurichten und eine Schnittstelle zu erstellen, die Ihren Anforderungen entspricht.
Zugehörige Dokumentation: