Ukládání souborů a správa obsahu
Vaše aplikace má vyhrazený systém souborů obsahu pro ukládání souborů nahraných uživatelem, jako jsou obrázky, dokumenty, soubory PDF a videa. Toto je oddělené od kódu vaší aplikace a je určeno pro dynamický obsah, který uživatelé vytvářejí nebo nahrávají při používání vaší aplikace.
Limity a důležité poznámky
- Jednotlivé soubory mohou mít velikost až 500 MB
- Smazání souboru je trvalé — není zde žádný koš ani možnost obnovení
- Využití úložiště se započítává do kvóty vašeho účtu
Co umožňuje systém souborů obsahu
Systém souborů obsahu poskytuje výkonné možnosti správy souborů pro vaši aplikaci:
- Ukládání uživatelských avatarů, profilových fotografií a galerií obrázků
- Přijměte nahrané dokumenty, jako jsou životopisy, smlouvy nebo soubory PDF
- Vytvářejte funkce pro sdílení souborů mezi uživateli ve vaší aplikaci
- Vytvářejte aplikace náročné na obraz s automatickou optimalizací
- Umožněte uživatelům stahovat soubory, které nahráli nebo které jim patří
- Vytvářejte nástroje pro správu, kde spravujete soubory jménem uživatelů
Jak to funguje
Když AI popíšete funkci, která potřebuje úložiště souborů, automaticky se postará o celou implementaci:
Nastaví rozhraní pro nahrávání — Vytváří formuláře nebo zóny přetažení, kde mohou uživatelé vybírat soubory ze svého zařízení
Konfiguruje řízení přístupu — Určuje, kdo může prohlížet, nahrávat nebo mazat soubory na základě toho, co vytváříte
Implementuje optimalizaci obrázků – Automaticky mění velikost a efektivně zobrazuje obrázky, takže se vaše aplikace rychle načítá
Vytváří strukturu úložiště — Organizuje soubory do logických složek jako /content/uploads/ nebo /content/avatars/
Zvládá backend – Spravuje skutečné ukládání, načítání a doručování souborů, aniž byste na to museli myslet
Soubory jsou uloženy na cestách jako /content/uploads/photo.jpg a lze na ně odkazovat přímo ve vaší aplikaci. Systém sleduje, kdo nahrál každý soubor, kdy byl vytvořen, a prosazuje vaše pravidla přístupu.
Řízení přístupu k souborům
Stejně jako databázové tabulky a edge funkce mají i soubory zásady zabezpečení, které řídí, kdo k nim může přistupovat. Soubory jsou ve výchozím nastavení soukromé – nikdo k nim nemá přístup, dokud nenakonfigurujete oprávnění. AI je nastavuje na základě toho, co stavíte:
Veřejné soubory
Prohlížet si je může kdokoli, i bez přihlášení. Přihlášení uživatelé mohou nahrávat a pouze ten, kdo soubor nahrál, jej může smazat. Ideální pro fotogalerie, veřejné sdílení obrázků nebo weby s obsahem vytvářeným uživateli.
Soukromé soubory
Pouze uživatel, který nahrál soubor, jej může zobrazit nebo smazat. Používá se pro citlivé dokumenty, soukromé fotografie, lékařské záznamy nebo cokoli, co uživatelé nechtějí, aby viděli ostatní.
Soubory sdílené organizací
Uživatelé ze stejné organizace mohou prohlížet soubory nahrané kýmkoli v jejich organizaci. Jednotlivci mohou smazat pouze soubory, které nahráli. Skvělé pro sdílení týmových dokumentů, firemní zdroje nebo pracovní prostory pro spolupráci.
Přístup pouze pro vlastníka
K těmto souborům máte přístup pouze vy (tvůrce aplikace), nikoli vaši koncoví uživatelé. Užitečné pro ukládání systémových souborů, šablon nebo prostředků pro správu, které pohání vaši aplikaci, ale neměly by být uživatelsky orientované.
Pokročilá kontrola přístupu
AI může vytvářet sofistikovaná pravidla přístupu na základě metadat souborů. Například:
- Publikované články jsou veřejné, ale koncepty jsou viditelné pouze pro autora
- Soubory označené oddělením jsou viditelné pouze pro uživatele v tomto oddělení
- Prémiový obsah vyžaduje příznak předplatného na uživatelském účtu
- Sdílené soubory jsou viditelné pro spolupracovníky uvedené v metadatech souboru
Optimalizace obrázků
Obrázky nahrané do systému souborů obsahu jsou automaticky optimalizovány pro rychlé načítání. Když zobrazíte obrázek, můžete požádat o konkrétní šířku a systém se postará o zbytek:
<!-- 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 funguje optimalizace
Progresivní načítání — Když někdo poprvé požádá o optimalizovanou velikost, systém zobrazí nejbližší dostupnou verzi a vygeneruje přesnou velikost na pozadí. Každý požadavek poté dostane optimalizovaný obraz v dokonalé velikosti. Původní soubor je vždy zachován.
Doručování moderních formátů — Systém automaticky poskytuje moderní obrazové formáty (AVIF nebo WebP) prohlížečům, které je podporují, s automatickým přechodem na JPEG nebo PNG u starších prohlížečů. To se děje transparentně – stačí zadat šířku a uživatelé získají verzi s nejrychlejším načítáním, kterou jejich prohlížeč zvládne.
Optimalizace výkonu — Ke zlepšení výkonu použijte menší šířky. 200px miniatura se načítá mnohem rychleji než původní 4000px obrázek a využívá menší šířku pásma. Vyberte šířku, která odpovídá tomu, jak obrázek zobrazujete.
Používání souborů ve vaší aplikaci
AI integruje systém souborů obsahu do vaší aplikace React automaticky. Když požádáte o funkce, které zahrnují soubory, vytvoří komponenty uživatelského rozhraní, zapojí logiku nahrávání/stahování a zpracovává chyby.
Běžné vzory, které AI implementuje
Nahrání avatara — Rozhraní pro nahrávání profilových fotografií, které ověřuje typy obrázků, ukazuje průběh nahrávání, zobrazuje náhled obrázku a ukládá cestu k profilu uživatele.
Galerie dokumentů — Prohlížeč souborů, který zobrazuje nahrané dokumenty, zobrazuje miniatury obrázků, poskytuje odkazy ke stažení a umožňuje filtrování nebo vyhledávání.
Nahrávání přetažením — Intuitivní zóna pro nahrávání, kde mohou uživatelé přetahovat soubory ze své plochy, sledovat průběh nahrávání, rušit probíhající nahrávání a dostávat chybové zprávy pro neplatné soubory.
Výběr souboru — Modální nebo postranní panel, který zobrazuje soubory, které uživatel dříve nahrál, umožňuje mu vybrat jeden pro opětovné použití a zobrazuje miniatury a názvy souborů.
Integrace s edge funkcemi
Edge funkce (váš kód na straně serveru) mohou přistupovat k systému souborů obsahu, zpracovávat soubory, generovat je programově nebo implementovat vlastní logiku práce se soubory.
Co mohou edge funkce dělat se soubory
- Generování reportů ve formátu PDF a jejich ukládání uživatelům ke stažení
- Zpracování nahraných obrázků (vodoznaky, miniatury, extrakce metadat)
- Kontrola nahraných dokumentů na citlivá data před jejich přijetím
- Vlastní logika zálohování nebo archivace
- Analýza obsahu souborů a extrakce strukturovaných dat
- Spouštění pracovních postupů při nahrání konkrétních souborů
Upozornění: Důležitá bezpečnostní poznámka
Edge funkce obcházejí běžné řízení přístupu. Když vaše funkce přistupuje k souborům, není omezena pravidly „veřejnosti“ nebo „vlastníka“, která platí pro uživatele. To znamená, že musíte implementovat své vlastní kontroly autorizace do kódu funkce, abyste zajistili, že uživatelé budou mít přístup pouze k souborům, které by měli vidět.
Pokud například uživatel zavolá vaši funkci a požaduje soubor, musíte před vrácením obsahu ověřit, že tento soubor vlastní nebo má oprávnění k přístupu k němu. AI to řeší při vytváření vašich funkcí, ale je důležité pochopit, že kód funkce běží se zvýšenými oprávněními.
Organizace úložiště
AI organizuje soubory do logických složek podle toho, co vytváříte. Struktury složek nemusíte vytvářet ručně – stačí popsat, co potřebujete, a AI nastaví vhodné cesty.
Běžné způsoby uspořádání
/content/uploads/— Obecné nahrávky uživatelů/content/avatars/— Profilové fotky uživatele/content/documents/— PDF a dokumenty/content/gallery/— Obrázky ve fotogalerii/content/private/— Soukromé uživatelské soubory/content/public/— Veřejně přístupné soubory/content/temp/— Dočasné soubory, které lze smazat
AI může vytvářet vnořené složky jako /content/uploads/2024/ nebo /content/users/[username]/, pokud je to vhodné pro váš případ použití. Soubory jsou sledovány podle jejich úplné cesty, takže přesunutí nebo přejmenování souborů automaticky aktualizuje všechny odkazy.
Monitorování a ladění
Všechny operace se soubory jsou protokolovány – nahrávání, stahování, odepření přístupu a chyby. Tyto protokoly si můžete prohlédnout v administrátorském rozhraní, abyste pochopili, jak je vaše úložiště souborů využíváno:
- Podívejte se, které soubory se nahrávají nejčastěji
- Identifikujte neúspěšná nahrávání a co se pokazilo
- Sledujte vzory stahování a oblíbené soubory
- Sledujte využití a růst úložiště v průběhu času
- Ladění problémů s řízením přístupu, když uživatelé nemají přístup k souborům, které očekávají, že uvidí
Systém také sleduje metriky úložiště – celkový počet uložených souborů, celkovou velikost, rychlost růstu a největší soubory. To vám pomůže porozumět úložnému prostoru vaší aplikace a naplánovat její škálování.
Limity a omezení
Ve výchozím nastavení mohou mít jednotlivé soubory až 500 MB. Toto je konfigurovatelné – AI může upravit limit na základě toho, co stavíte. Pro většinu aplikací (nahrávání obrázků, sdílení dokumentů, PDF) je výchozí limit více než dostatečný.
Soubory jsou kvůli spolehlivosti ukládány redundantně. Pokud soubor smažete, bude trvale odstraněn ze systému – není zde žádný koš, takže smazání je okamžité a konečné.
Práce s AI
Při popisu funkcí, které vyžadují ukládání souborů, buďte konkrétní:
- Kdo má k souborům přístup — Veřejná, soukromá, sdílená organizací nebo vlastní pravidla
- Jaké typy souborů — Pouze obrázky, PDF, jakýkoli typ souboru, omezení velikosti
- Jak jsou soubory organizovány — Složky, konvence pojmenování, zda mohou uživatelé vytvářet podsložky
- Co se stane po nahrání — Zobrazení v galerii, připojení k záznamu, zpracování pomocí funkce
AI používá tyto informace ke správné konfiguraci úložiště, nastavení zásad přístupu a vytvoření rozhraní, které odpovídá vašim potřebám.
Související dokumentace: