Przechowywanie plików i zarządzanie treścią
Twoja aplikacja ma dedykowany system plików treści do przechowywania plików przesyłanych przez użytkowników, takich jak obrazy, dokumenty, pliki PDF i filmy. Jest on oddzielony od kodu aplikacji i przeznaczony na treści dynamiczne, które użytkownicy tworzą lub przesyłają podczas korzystania z aplikacji.
Limity i ważne uwagi
- Pojedyncze pliki mogą mieć rozmiar do 500 MB
- Usunięcie pliku jest trwałe — nie ma kosza
- Wykorzystane miejsce wlicza się do limitu Twojego konta
Co umożliwia system plików treści
System plików treści daje Twojej aplikacji rozbudowane możliwości zarządzania plikami:
- Przechowywanie awatarów użytkowników, zdjęć profilowych i galerii obrazów
- Przyjmowanie przesyłanych dokumentów, takich jak CV, umowy czy pliki PDF
- Budowanie funkcji udostępniania plików między użytkownikami Twojej aplikacji
- Tworzenie aplikacji intensywnie wykorzystujących obrazy z automatyczną optymalizacją
- Pobieranie plików przez użytkowników, które sami przesłali lub które do nich należą
- Budowanie narzędzi administracyjnych, w których zarządzasz plikami w imieniu użytkowników
Jak to działa
Gdy opiszesz AI funkcję wymagającą przechowywania plików, AI automatycznie zajmuje się całą implementacją:
Ustawia interfejs przesyłania — tworzy formularze lub strefy przeciągania i upuszczania, w których użytkownicy wybierają pliki ze swojego urządzenia
Konfiguruje kontrolę dostępu — określa, kto może wyświetlać, przesyłać lub usuwać pliki, w zależności od tego, co budujesz
Wdraża optymalizację obrazów — automatycznie zmienia rozmiar i sprawnie serwuje obrazy, dzięki czemu aplikacja ładuje się szybko
Tworzy strukturę przechowywania — porządkuje pliki w logiczne foldery, takie jak /content/uploads/ czy /content/avatars/
Obsługuje backend — zarządza faktycznym przechowywaniem, pobieraniem i dostarczaniem plików, więc nie musisz się tym zajmować
Pliki są przechowywane w ścieżkach takich jak /content/uploads/photo.jpg i można się do nich odwoływać bezpośrednio w aplikacji. System śledzi, kto przesłał każdy plik i kiedy został utworzony, oraz egzekwuje Twoje reguły dostępu.
Kontrola dostępu do plików
Tak jak tabele bazy danych i funkcje brzegowe, pliki mają zasady bezpieczeństwa określające, kto może mieć do nich dostęp. Pliki są domyślnie prywatne — nikt nie ma do nich dostępu, dopóki nie skonfigurujesz uprawnień. AI ustawia je na podstawie tego, co budujesz:
Pliki publiczne
Każdy może je wyświetlać, nawet bez logowania. Zalogowani użytkownicy mogą przesyłać pliki, a usunąć plik może tylko osoba, która go przesłała. Idealne do galerii zdjęć, publicznego udostępniania obrazów lub serwisów z treściami tworzonymi przez użytkowników.
Pliki prywatne
Tylko użytkownik, który przesłał plik, może go wyświetlić lub usunąć. Stosowane do poufnych dokumentów, prywatnych zdjęć, dokumentacji medycznej i wszystkiego, czego użytkownicy nie chcieliby pokazywać innym.
Pliki udostępniane w organizacji
Użytkownicy z tej samej organizacji mogą wyświetlać pliki przesłane przez każdego w ich organizacji. Poszczególne osoby mogą usuwać tylko pliki, które same przesłały. Świetne do wspólnych dokumentów zespołu, zasobów firmy lub przestrzeni do współpracy.
Dostęp tylko dla właściciela
Tylko Ty (twórca aplikacji) masz dostęp do tych plików, a Twoi użytkownicy końcowi nie. Przydatne do przechowywania plików systemowych, szablonów lub zasobów administracyjnych, które napędzają aplikację, ale nie powinny być widoczne dla użytkowników.
Zaawansowana kontrola dostępu
AI może tworzyć rozbudowane reguły dostępu oparte na metadanych plików. Na przykład:
- Opublikowane artykuły są publiczne, ale wersje robocze widzi tylko autor
- Pliki oznaczone działem są widoczne tylko dla użytkowników z tego działu
- Treści premium wymagają flagi subskrypcji na koncie użytkownika
- Udostępnione pliki są widoczne dla współpracowników wymienionych w metadanych pliku
Optymalizacja obrazów
Obrazy przesłane do systemu plików treści są automatycznie optymalizowane pod kątem szybkiego ładowania. Przy wyświetlaniu obrazu możesz zażądać określonej szerokości, a resztą zajmie się 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" />
Jak działa optymalizacja
Ładowanie progresywne — gdy ktoś po raz pierwszy zażąda zoptymalizowanego rozmiaru, system podaje najbliższą dostępną wersję, a dokładny rozmiar generuje w tle. Każde kolejne żądanie dostaje obraz o idealnym, zoptymalizowanym rozmiarze. Oryginalny plik jest zawsze zachowywany.
Dostarczanie w nowoczesnych formatach — system automatycznie serwuje nowoczesne formaty obrazów (AVIF lub WebP) przeglądarkom, które je obsługują, a starszym przeglądarkom automatycznie podaje JPEG lub PNG. Dzieje się to w sposób niewidoczny — wystarczy podać szerokość, a użytkownicy dostaną najszybciej ładującą się wersję, jaką obsługuje ich przeglądarka.
Optymalizacja wydajności — używaj mniejszych szerokości, aby poprawić wydajność. Miniatura o szerokości 200 px ładuje się znacznie szybciej niż oryginał o szerokości 4000 px i zużywa mniej transferu. Wybierz szerokość odpowiadającą temu, jak wyświetlasz obraz.
Korzystanie z plików w aplikacji
AI automatycznie integruje system plików treści z Twoją aplikacją React. Gdy prosisz o funkcje związane z plikami, tworzy komponenty interfejsu, podłącza logikę przesyłania i pobierania oraz obsługuje błędy.
Typowe wzorce wdrażane przez AI
Przesyłanie awatara — interfejs przesyłania zdjęcia profilowego, który sprawdza typ obrazu, pokazuje postęp przesyłania, wyświetla podgląd i zapisuje ścieżkę w profilu użytkownika.
Galeria dokumentów — przeglądarka plików, która wyświetla listę przesłanych dokumentów, pokazuje miniatury obrazów, udostępnia linki do pobrania i pozwala filtrować lub wyszukiwać.
Przesyłanie metodą przeciągnij i upuść — intuicyjna strefa przesyłania, w której użytkownicy mogą przeciągać pliki z pulpitu, widzieć postęp, anulować trwające przesyłanie i otrzymywać komunikaty o błędach dla nieprawidłowych plików.
Wybór pliku — okno modalne lub panel boczny pokazujący pliki, które użytkownik wcześniej przesłał, pozwalający wybrać jeden do ponownego użycia i wyświetlający miniatury oraz nazwy plików.
Integracja z funkcjami brzegowymi
Funkcje brzegowe (Twój kod po stronie serwera) mogą korzystać z systemu plików treści, aby przetwarzać pliki, generować je programowo lub realizować niestandardową logikę obsługi plików.
Co funkcje brzegowe mogą robić z plikami
- Generować raporty PDF i zapisywać je, aby użytkownicy mogli je pobrać
- Przetwarzać przesłane obrazy (nakładać znaki wodne, tworzyć miniatury, wyodrębniać metadane)
- Skanować przesłane dokumenty pod kątem danych wrażliwych, zanim zostaną zaakceptowane
- Realizować niestandardową logikę kopii zapasowych lub archiwizacji
- Analizować zawartość plików i wyodrębniać z nich dane ustrukturyzowane
- Uruchamiać przepływy pracy po przesłaniu określonych plików
Ostrzeżenie: Ważna uwaga dotycząca bezpieczeństwa
Funkcje brzegowe omijają zwykłą kontrolę dostępu. Gdy Twoja funkcja korzysta z plików, nie ograniczają jej reguły „publiczne” ani „właściciela”, które obowiązują użytkowników. Oznacza to, że musisz zaimplementować własne sprawdzanie uprawnień w kodzie funkcji, aby użytkownicy mieli dostęp tylko do plików, które powinni widzieć.
Na przykład, jeśli użytkownik wywołuje Twoją funkcję, prosząc o plik, musisz sprawdzić, czy jest właścicielem tego pliku lub ma uprawnienia dostępu do niego, zanim zwrócisz zawartość. AI robi to podczas budowania Twoich funkcji, ale warto wiedzieć, że kod funkcji działa z podwyższonymi uprawnieniami.
Organizacja przechowywania
AI porządkuje pliki w logiczne foldery, w zależności od tego, co budujesz. Nie musisz ręcznie tworzyć struktury folderów — wystarczy, że opiszesz, czego potrzebujesz, a AI ustawi odpowiednie ścieżki.
Typowe wzorce organizacji
/content/uploads/— ogólne pliki przesłane przez użytkowników/content/avatars/— zdjęcia profilowe użytkowników/content/documents/— pliki PDF i dokumenty/content/gallery/— obrazy z galerii zdjęć/content/private/— prywatne pliki użytkowników/content/public/— pliki dostępne publicznie/content/temp/— pliki tymczasowe, które można usunąć
AI może tworzyć zagnieżdżone foldery, takie jak /content/uploads/2024/ lub /content/users/[username]/, gdy pasuje to do Twojego przypadku. Pliki są śledzone według pełnej ścieżki, więc przeniesienie lub zmiana nazwy pliku automatycznie aktualizuje wszystkie odwołania.
Monitorowanie i debugowanie
Rejestrowane są wszystkie operacje na plikach — przesyłanie, pobieranie, odmowy dostępu i błędy. Te dzienniki możesz przeglądać w interfejsie administratora, aby zrozumieć, jak wykorzystywane jest Twoje przechowywanie plików:
- Zobacz, które pliki są przesyłane najczęściej
- Znajdź nieudane przesyłania i sprawdź, co poszło nie tak
- Śledź wzorce pobierania i popularne pliki
- Monitoruj wykorzystanie miejsca i jego wzrost w czasie
- Debuguj problemy z kontrolą dostępu, gdy użytkownicy nie mają dostępu do plików, których się spodziewają
System śledzi też metryki przechowywania — łączną liczbę plików, łączny rozmiar, tempo wzrostu i największe pliki. Pomaga to zrozumieć, ile miejsca zajmuje Twoja aplikacja, i zaplanować skalowanie.
Limity i ograniczenia
Domyślnie pojedyncze pliki mogą mieć rozmiar do 500 MB. Można to skonfigurować — AI może dostosować limit do tego, co budujesz. W większości aplikacji (przesyłanie obrazów, udostępnianie dokumentów, pliki PDF) domyślny limit w zupełności wystarcza.
Pliki są przechowywane redundantnie dla niezawodności. Jeśli usuniesz plik, zostaje on trwale usunięty z systemu — nie ma kosza, więc usunięcie jest natychmiastowe i ostateczne.
Praca z AI
Opisując funkcje wymagające przechowywania plików, określ dokładnie:
- Kto ma dostęp do plików — publiczny, prywatny, udostępniany w organizacji lub własne reguły
- Jakie typy plików — tylko obrazy, pliki PDF, dowolny typ pliku, limity rozmiaru
- Jak pliki są zorganizowane — foldery, konwencje nazewnictwa, czy użytkownicy mogą tworzyć podfoldery
- Co dzieje się po przesłaniu — wyświetlenie w galerii, dołączenie do rekordu, przetworzenie przez funkcję
AI wykorzystuje te informacje, aby poprawnie skonfigurować przechowywanie, ustawić zasady dostępu i stworzyć interfejs odpowiadający Twoim potrzebom.
Powiązana dokumentacja: