Atlas-Flora to atlas roślin — portal referencyjny z kartami gatunków, poradnikami ogrodniczymi i encyklopedią chorób, zaprojektowany od podstaw pod wyszukiwarki (Google, Bing) oraz wyszukiwanie generatywne (ChatGPT Search, Perplexity, Gemini), w trzech językach.
Wyzwanie
Zbudować serwis skalujący się do tysięcy kart roślin, utrzymujący na każdej z nich jakość merytoryczną i komplet danych strukturalnych — w trzech językach, z kontami użytkowników i synchronizacją między urządzeniami, przy koszcie infrastruktury bliskim zeru.
Technologia
Rdzeń stanowi Astro z Content Collections i walidacją schematem Zod — dane gatunków żyją jako pliki w repozytorium i są sprawdzane przy każdym buildzie. Całość działa na Cloudflare Pages w trybie hybrydowym: ponad 700 stron treści serwuje się statycznie z krawędzi sieci, a kod serwerowy obsługuje wyłącznie API kont. Dane użytkowników trzyma Cloudflare D1 (SQLite) w regionie unijnym. Wyszukiwarka (Pagefind) buduje indeks z gotowego HTML-a — bez serwera wyszukiwania.
Co wyróżnia projekt
- Dane w repozytorium zamiast bazy — schemat Zod przerywa build przy literówce w nazwie gatunku czy nieistniejącej referencji, a każda poprawka merytoryczna przechodzi review jak pull request.
- Trzy języki bez triplikacji treści — kanoniczna karta polska jest jedynym źródłem danych, a tłumaczenia to nakładki nadpisujące wyłącznie prozę, pole po polu. Przetłumaczone są również segmenty adresów (
/roslina/,/de/pflanze/,/en/plant/), spięte kompletnym hreflang. - Konta bez biblioteki auth — własny OAuth (Authorization Code + PKCE) i JWT: token dostępu wyłącznie w pamięci karty przeglądarki, rotujący token odświeżający w ciasteczku HttpOnly, w bazie przechowywany jedynie jako hash.
- Kompletne SEO i GEO — Schema.org (Article, Dataset, FAQPage, HowTo, BreadcrumbList), sitemap, hreflang oraz
llms.txtw trzech językach pod cytowalność przez modele językowe.
Efekt
169 kart gatunków, 70 rodzin botanicznych i 12 poradników — każdy element w trzech językach, razem 711 statycznych stron i 324 autorskie zdjęcia. Lighthouse: SEO 100/100. Koszt infrastruktury mieści się w darmowych limitach Cloudflare — również po wdrożeniu kont i bazy danych.
Zobacz efekt na żywo: atlas-flora.com
Technologie: Astro · TypeScript · Zod · Cloudflare Pages · Cloudflare D1 · Pagefind · generatywne AI.