Dokumentacja Architektury: Kreator Stron i Zarządzanie Domenami

Poniższa dokumentacja opisuje architekturę danych oraz zautomatyzowane przepływy logiczne dla modułów kreatora stron internetowych i obsługi niestandardowych domen w platformie SaaS EnterSlot.

1. Architektura Wizytówki (Multi-Tenancy)

System stron internetowych został zaprojektowany z rygorystycznym podziałem na globalny kontekst witryny oraz jej wyizolowane podstrony.

• Kontekst Globalny: Architektura wielodostępna (Multi-Tenancy) bezpiecznie przechowuje globalne ustawienia przypisane do konkretnego najemcy. Kluczowym elementem jest elastyczna struktura danych (obiekty JSONB), która służy do wstrzykiwania globalnych danych biznesowych. Informacje te są bezpiecznie modyfikowane za pośrednictwem dedykowanych akcji i służą jako ustandaryzowany wektor wiedzy dla asystentów AI wewnątrz aplikacji.
• Wielostronicowość i Routing: Pojedyncza witryna może składać się z nieskończonej liczby podstron. Każdy wpis w bazie dziedziczy identyfikator najemcy i definiuje własny schemat routingu (slug), podlegający ścisłej walidacji unikalności w obrębie danego środowiska.

2. Silnik Renderujący (Block-Based Rendering)

Wygląd i struktura stron w kreatorze nie opierają się na statycznych, przestarzałych szablonach, lecz na dynamicznym procesie renderowania bloków (Block-Based Rendering Engine).

• Model Bezschematowy: Definicje bloków, cała konfiguracja wizualna, tekstowa oraz zagnieżdżone drzewa nawigacji są zapisywane bez sztywnego schematu relacyjnego, wykorzystując wysoce zoptymalizowane struktury JSONB.
• Silnik Kompozytowy: Dedykowany moduł frontendowy pełni rolę inteligentnego dekodera. W czasie rzeczywistym parsuje on obiekty JSON i bezpiecznie mapuje je na odpowiadające im, interaktywne komponenty interfejsu użytkownika (UI).
• Izolacja Globalnych Komponentów: Elementy strukturalne (np. nagłówek i stopka) są traktowane architektonicznie jako byty globalne i pomijane w głównych pętlach iteracyjnych silnika, co drastycznie redukuje powielanie kodu (zgodność z zasadą DRY) i optymalizuje czas renderowania.

3. Modele Publikacji i Zarządzanie Infrastrukturą

Platforma EnterSlot obsługuje trzy niezależne strategie publikacji, zarządzane przez zautomatyzowaną maszynę stanów (State Machine).

• Subdomena Platformy (Wildcard Routing): Organizacja może natychmiastowo zająć darmową subdomenę w obrębie głównej domeny SaaS. Mechanizm ten opiera się na wydajnym routingu na poziomie węzłów brzegowych (Edge Network / Wildcard Routing), gwarantując dostępność witryny z pominięciem opóźnień związanych z globalną propagacją DNS.
• Własna Domena (BYOD - Bring Your Own Domain): Użytkownik może bezproblemowo zintegrować zewnętrzną domenę. Backend asynchronicznie odpytuje natywne API infrastruktury chmurowej, weryfikuje poprawne przekierowania rekordów A/CNAME, dopina domenę do odpowiedniego projektu i całkowicie automatyzuje proces wydawania oraz odnawiania certyfikatów bezpieczeństwa (Automated SSL Offloading).
• Zautomatyzowana Rejestracja (API Integration): Platforma oferuje w pełni bezobsługowy proces zakupu i konfiguracji domen prosto z panelu. System automatycznie przechodzi przez stany płatności, delegacji zlecenia do operatora (via REST API) i weryfikacji aktywacji.

4. Integracje Zewnętrzne i Procesy w Tle

Zarządzanie tak rozproszoną infrastrukturą opiera się na bezawaryjnej komunikacji międzyoperacyjnej.

• Rozliczenia i Rejestracja: System transakcyjnie koreluje zdarzenia płatnicze z zewnętrznych bramek finansowych z identyfikatorami zamówień u globalnych rejestratorów domen.
• Asynchroniczna Propagacja DNS (Cron Jobs): Przechodzenie domen przez fazy globalnej propagacji DNS jest nadzorowane przez zautomatyzowane procesy w tle. Skrypty te cyklicznie i bezpiecznie weryfikują status bezpośrednio przez API rejestratora, wdrażając polityki ponownych prób (Retry Policies). W przypadku aktywacji, automatycznie wstrzykują niezbędne rekordy strefy DNS.
• Zarządzanie Transferami: Architektura pozwala najemcom na samodzielne żądanie kodów autoryzacyjnych (AuthInfo) przez interfejs API. Zaimplementowano również zautomatyzowany system rezerwowy (Fallback) – w przypadku braku odpowiedzi od zewnętrznego API rejestratora, system automatycznie eskaluje proces, generując zgłoszenie w wewnętrznym systemie pomocy technicznej (Ticketing System).