Przejdź do treści

Artykuły o tematyce Architektura

9 artykułów to nie koniec. Ich ilość ciągle rośnie.

Polecany artykułAI

Czym jest harness engineering? Architektura środowiska agenta AI

Kiedy agent AI popełnia jakiś błąd, pierwszym odruchem bywa poprawienie promptu, zmiana modelu albo ustawienia intensywności rozumowania. Problem może leżeć jednak gdzie indziej, ponieważ agent mógł po prostu nie mieć właściwych danych, otrzymać narzędzia o zbyt szerokim zakresie działania i nie być odpowiednio przygotowany do działania. Projektowanie tego wszystkiego, co otacza model, nazywa się harness engineering. W tym artykule wyjaśniam, skąd wziął się ten termin, czym różni się od prompt i context engineeringu oraz z jakich warstw składa się harness agenta.

Architektura oprogramowania to świadome decyzje o tym, jak podzielić system na części, jak nimi zarządzać i jak mają się komunikować. Dobra architektura ułatwia rozwój, testowanie i utrzymanie, a zła potrafi spowolnić każdy kolejny krok.

W tej sekcji zbieram artykuły o projektowaniu aplikacji webowych: struktura projektu, granice modułów, zależności, wzorce oraz kompromisy, które trzeba świadomie podejmować. Piszę praktycznie, pokazując, jak podejmować decyzje, które dobrze starzeją się wraz z rosnącym projektem i zespołem.

Połączenie perspektywy produktu, dewelopera i marketingu w jednym miejscu

Konsultacje
Payload CMS czy Sanity: który headless CMS wybrać?

Payload i Sanity potrafią obsłużyć ten sam katalog treści, lecz przenoszą ciężar projektu w zupełnie inne miejsce. Payload oddaje zespołowi kod, bazę i odpowiedzialność za produkcję. Sanity dostarcza zarządzany Content Lake oraz rozbudowane środowisko współpracy, ale wiąże system z limitami i modelem usługi. Dobre porównanie nie kończy się na ekranie edytora. Musi objąć dzień publikacji, awarię, zmianę schematu, rachunek przy wzroście oraz możliwość wyprowadzenia danych.

Maciej Sala

Maciej Sala

Founder StriveLab

Jak bezpiecznie obsługiwać formularze w Astro?

Klasyczny formularz bardzo szybko robi się ciężki przez takie elementy jak endpoint, odczytywanie ciała żądania, walidacja, statusy HTTP, fetch po stronie klienta i typy przepisane drugi raz. Na ratunek przybywają Astro Actions: wystarczy, że zdefiniujesz logikę funkcji serwerowej, dodasz schemat Zod i wywołasz ją z klienta bez ręcznego składania REST API.

Maciej Sala

Maciej Sala

Founder StriveLab

Autoryzacja w Astro: middleware, Better Auth i ochrona tras

Każda aplikacja prędzej czy później wymaga zabezpieczenia wybranych ścieżek, takich jak panele użytkownika, profile czy panele administracyjne. Pytanie, gdzie powinna znajdować się bramka? W przypadku Astro najwygodniejszym rozwiązaniem jest middleware, pozwalający na centralne obsłużenie autoryzacji przed wyrenderowaniem strony. W dalszej części pokażę, jak zidentyfikować użytkownika, przekazać jego dane dalej przez context.locals, skonfigurować Better Auth, ograniczyć tempo żądań i czym różni się takie wdrożenie na Node i na Cloudflare Workers.

Maciej Sala

Maciej Sala

Founder StriveLab

Astro Content Collections: blog z walidacją Zod

Dodajesz wpis i lokalnie wszystko wygląda jak należy, ale po publikacji karta artykułu pokazuje pusty opis. Dzięki architekturze Content Collections część tych weryfikacji można przesunąć bezpośrednio do etapu budowania aplikacji. Zasada jest prosta: schemat walidacyjny, struktura nagłówków frontmatter oraz szablony komponentów muszą opierać się na tym samym modelu danych . Poniżej krok po kroku przejdziemy przez konfigurację bloga z wykorzystaniem biblioteki Zod, obsługą autorów i filtrowaniem dat publikacji.

Maciej Sala

Maciej Sala

Founder StriveLab

Architektura wysp i selektywna hydratacja w frameworku Astro

„Zero JavaScript domyślnie” nie jest obietnicą wyniku Lighthouse, lecz regułą kompilacji: komponent Astro i komponent frameworka bez dyrektywy client: nie wysyłają swojego runtime'u do przeglądarki. Skrypty analityczne, widżety, router i jawne nadal mogą zwiększyć budżet JavaScriptu. W artykule pokazuję, jak działają granice wysp, kiedy opóźniać hydratację i jak nie zamienić selektywnej interaktywności w serię „martwych” kliknięć.

Maciej Sala

Maciej Sala

Founder StriveLab

Pages Router do App Router: migracja w Next.js

Masz działający projekt na Pages Router i chcesz wejść w Server Components, streaming albo Server Actions. Tylko że przepisanie wszystkiego naraz to proszenie się o regresję, więc tego lepiej nie robić. Rozwiązaniem jest Pages i App Router obok siebie w jednym repozytorium i przenoszenie strona po stronie, potem testy i bezpieczne wdrożenia.

Maciej Sala

Maciej Sala

Founder StriveLab

Repository i Service Layer w Next.js dla Server Actions

W Next.js traktuj Server Actions i Route Handlers jako cienkie adaptery wejścia: pobierają sesję, walidują payload i mapują odpowiedź. Reguły biznesowe trzymaj w Service Layer, zapytania do bazy w Repository, a transakcje spinaj przez Unit of Work. Taki podział nie jest potrzebny w każdym CRUD-zie, ale zaczyna się zwracać, gdy jedna operacja dotyka kilku tabel, kilku wejść albo kilku reguł.

Maciej Sala

Maciej Sala

Founder StriveLab

Jak organizować kod w dużych projektach Next.js?

Domyślny układ folderów w App Routerze app/ , components/ , lib/ sprawdza się świetnie w małych projektach. Gdy jednak aplikacja rozrasta się do kilkudziesięciu widoków i kilku obszarów biznesowych, lib/ staje się workiem na wszystko, przycisk ląduje obok kalkulatora faktur, a prosta zmiana potrafi zepsuć kod w zupełnie innym miejscu. W tym artykule pokażę, jak podzielić projekt Next.js na niezależne moduły funkcjonalne, uporządkować kierunek zależności, wydzielić bezpieczne shared/ oraz ocenić, kiedy taka architektura faktycznie ma sens.

Maciej Sala

Maciej Sala

Founder StriveLab