SEOCatalog — to strukturalna baza katalogów

Projekt: SEOcatalog (seocatalog.com.ua)
Typ: platforma SEO / katalog miejsc + zgłoszenia i "koszyk" (jak w małym sklepie internetowym)

Co zostało zrobione:

1) Strona "od zera" z szybkim SSR
• Zrealizowana architektura na Cloudflare Pages Functions (serwerowe generowanie stron).
• Strony są dostarczane już z gotowym HTML (SSR), dlatego strona jest szybka i dobrze indeksowana.
• Struktura kodu — MVC: kontrolery zbierają dane, widoki renderują HTML, wspólne komponenty są wielokrotnie wykorzystywane.

2) Katalog z sekcjami, kartami i filtrami
• Strona główna katalogu + strony sekcji (tematy) + strony kart (szczegóły miejsca).
• Filtrowanie i sortowanie (w tym zakres cenowy) z poprawnym zachowaniem dla SEO:
– dla stron z filtrami ustawiane jest robots noindex,follow
– dla "czystych" stron — index,follow
• Przygotowane canonical URL, aby unikać duplikatów w wyszukiwaniu.

3) Koszyk i składanie zamówienia (jak w e-commerce)
• Dodany scenariusz wyboru miejsc do "koszyka".
• Zrealizowany formularz składania zamówienia z walidacją (imię, kontakt, komentarz, lista pozycji).
• Po stronie backendu — normalizacja pól, ochrona przed niepoprawnymi danymi, ograniczenia długości, stabilne przetwarzanie.

4) Integracja z Google Sheets (CRM-podobne zaplecze)
• Podłączone Google Apps Script API jako "panel administracyjny" bez osobnego backendu:
– zgłoszenia na dodanie nowego katalogu → arkusz drafts
– zamówienia z koszyka → arkusz orders
• Token-dostęp + kontrole, aby nie można było pisać do tabeli bez autoryzacji.
• Logi i statusy zamówień/zgłoszeń są przechowywane w tabeli do ręcznego przetwarzania przez menedżera.

5) SEO-optymalizacja "pod wyszukiwanie"
• Meta-tag: title/description, OpenGraph, Twitter Card.
• Dublin Core metadane dla wzmocnienia struktury dokumentu.
• JSON-LD (Schema.org) dla poprawy zrozumienia kart przez wyszukiwarki/AI:
– Organization/LocalBusiness w zależności od typu karty
– sameAs (oficjalna strona), url, description, address (jeśli jest)
• Generacja sitemap.xml przez funkcję (pod indeksację i szybki crawl).

6) UX i mobilna adaptacja
• Jedna warstwa UI na main.css + site-ui.js: modale, menu/filtry, zachowanie strony.
• Poprawki mobilnych niuansów (scroll/overlay, stan "no-scroll", panele filtrów).
• Szablony stron zaprojektowane jako "długie czytanie", staranna typografia, poprawne nagłówki, listy.

7) Dokumentacja dla szybkiej pracy z projektem
• Prowadzony jest rejestr funkcji i odpowiedniości "route → plik → kontroler/widok" (function-registry.md),
aby szybko znaleźć potrzebne miejsce poprawek bez przeszukiwania całego archiwum.

Wynik dla biznesu
• Właściciel otrzymuje szybki, przyjazny SEO katalog/produkt przypominający sklep, gdzie:
– klient może wybrać pozycje (miejsca), dodać do koszyka, wysłać zamówienie
– menedżer otrzymuje wszystko w Google Sheets, bez skomplikowanego panelu administracyjnego
– wyszukiwanie dobrze indeksuje strony dzięki SSR, metadanym, sitemap i schema.org
• Rozwiązanie łatwe do skalowania: dodawanie sekcji, nowych pól karty, nowych scenariuszy płatności/biura.