Blog on SaaSForge

Spring Modulith v praxi: Od kódu k živým architektonickým diagramům

Mon, 04 May 2026 00:00:00 +0000

Váš architektonický diagram v Confluence je šest měsíců starý. Ten na wiki stále ukazuje Auth modul, který byl sloučen do Usera už v lednu. Tabule v zasedačce? Někdo ji smazal, aby nakreslil retrospektivu sprintu.

Architektonická dokumentace má zásadní problém: udržují ji lidé a lidé zapomínají. Kód se mění denně. Diagramy se mění, když si někdo vzpomene. Nakonec je mezera tak velká, že všichni přestanou diagramům věřit a začnou číst přímo kód — čímž se celý smysl diagramů ztrácí.

Kamal vs Flux CD: Jednoduchost nebo odolnost — vyberte si

Mon, 27 Apr 2026 00:00:00 +0000

Váš kontejner spadl ve 3 ráno. S Flux CD si toho cluster všiml, restartoval pod a sesynchronizoval požadovaný stav z Gitu. Dozvěděli jste se o tom z notifikace na Slacku u ranní kávy. S Kamalem — nikdo si ničeho nevšiml. Vaše aplikace byla čtyři hodiny nedostupná. První, kdo si toho všiml, byl zákazník, a neposlal bug report. Prostě odešel.

Toto je zásadní rozdíl mezi Kamalem a Flux CD a je důležitější, než většina srovnávacích článků připouští. Nejde o to, který nástroj je “lepší.” Jde o to, zda je váš nasazovací nástroj zodpovědný za to, že vaše aplikace běží, nebo jen za to, že ji tam umístí.

Spring Modulith v praxi: Vynucování architektury v rostoucím monolitu

Mon, 20 Apr 2026 00:00:00 +0000

Každá rostoucí Spring Boot aplikace dospěje do bodu, kdy někdo nakreslí hranice modulů na tabuli. Krabičky s čistými šipkami. „Venue závisí na Site, ale ne na internals Useru." Všichni přikývnou. O dva sprinty později vývojář importuje repository z modulu, na kterém by neměl záviset, protože je to nejrychlejší cesta k opravě bugu. Nikdo si toho v code review nevšimne. Diagram na tabuli je teď fikce.

Spring Modulith mění ty šipky na tabuli na selhání buildu.

Mise vs SDKMAN: Proč přecházím po letech s .sdkmanrc

Fri, 17 Apr 2026 00:00:00 +0000

Kolega dnes zmínil Mise. Jsem věrný uživatel SDKMAN už roky — .sdkmanrc v každém projektu, sdk use java 21.0.2-tem vrytý do svalové paměti. Funguje to, je to spolehlivé, nikdy jsem neměl důvod hledat jinde.

Pak jsem se ale podíval, co Mise umí, a nejsem si jistý, jestli se můžu vrátit.

Problém s jedním nástrojem na jazyk

SDKMAN spravuje JDK (a Gradle, Maven a pár dalších JVM nástrojů). Dělá to dobře. Ale moje projekty nepotřebují jen Javu:

Jak používáme Claude Code Skills k formalizaci našich vývojových vzorů

Thu, 16 Apr 2026 00:00:00 +0000

Každý kód má své vzory. Způsob, jakým píšete testy, strukturujete komponenty, propojujete API — tyto konvence žijí v kolektivní paměti týmu, roztroušené mezi code reviews, onboardingovými dokumenty a kmenovou znalostí. Když do mixu přidáte AI asistenta pro kódování, nic z toho nezná. Napíše naprosto validní kód, který poruší každou konvenci, kterou jste zavedli.

Claude Code Skills tento problém řeší tím, že vám umožní zakódovat vaše vzory jako znovupoužitelné šablony, které Claude automaticky načte, když je to relevantní.

Observabilita a optimalizace vašeho GraphQL API

Thu, 09 Apr 2026 00:00:00 +0000

Část 7 série „Production GraphQL with Netflix DGS" — Bonus: Provoz

GraphQL API jsou pro tradiční monitoring neviditelná. Každý request dorazí na stejný endpoint /graphql, vrátí HTTP 200 (i když tělo odpovědi obsahuje chyby) a nenese žádný URL-based kontext pro vaše dashboardy. Pokud monitorujete GraphQL API stejně jako REST, letíte naslepo.

Tento článek pokrývá vrstvu observability a optimalizace nad vaším DGS backendem: federation s GraphQL routerem, identifikace klientů, metriky na úrovni operací, klasifikace chyb, analytika schématu a techniky optimalizace výkonu, které zabrání vašemu API stát se úzkým hrdlem.

Typově bezpečné GraphQL na frontendu

Thu, 02 Apr 2026 00:00:00 +0000

Šestý díl ze sedmi v sérii “Production GraphQL with Netflix DGS” — Bonus: Klientská strana

Předchozích pět článků pokrývalo backend: návrh schématu, data loadery, zabezpečení, subscriptions a škálování. Typová bezpečnost ale nekončí na hranici API. Tento článek ukazuje, jak ji přenést až do Vue (nebo React) komponenty — a jak návrh fragmentů brání tichému zabijákovi výkonu, kterým je overfetching.

Problém se string dotazy

Většina GraphQL tutoriálů začíná nějak takto:

const response = await fetch('/graphql', {
 method: 'POST',
 body: JSON.stringify({
 query: `
 query {
 product(id: "123") {
 id
 name
 price
 }
 }
 `
 })
})
const data = await response.json()
// data.data.product.name — je to string? Objekt? Kdo ví.

Tohle funguje. Je to ale také past na údržbu:

DGS ve velkém měřítku: Testování, evoluce schématu a federation

Thu, 26 Mar 2026 00:00:00 +0000

Část 5 ze 7 v sérii „Production GraphQL with Netflix DGS"

Postavit GraphQL API je jedna věc. Provozovat stovky operací v produkci, spolehlivě je testovat a vyvíjet schéma bez rozbití klientů — to je teprve začátek skutečného inženýrství. Tento závěrečný článek pokrývá postupy, na kterých záleží, jakmile vaše DGS API přeroste pár dotazů.

Testování DGS komponent

DGS data fetchery jsou Spring beany s injektovanými závislostmi. To je činí přímočarými pro unit testování — zamockujte závislosti, zavolejte metodu, ověřte výsledek.

Virtuální vlákna nezabila WebFlux

Mon, 23 Mar 2026 00:00:00 +0000

Každých pár měsíců někdo publikuje benchmark ukazující, že virtuální vlákna zvládnou 100 000 souběžných requestů s jednoduchým imperativním kódem, a dojde k závěru, že WebFlux je zastaralý. Komentáře se plní větami jako „konečně žádné reaktivní špagety." Manažeři přepošlou článek svým týmům: „Můžeme to přepsat na virtuální vlákna?"

Ne. Tedy — záleží na tom, co to „to" dělá. Ale pravděpodobně ne.

Virtuální vlákna a WebFlux řeší různé problémy. Zmatek pochází z toho, že se obě technologie objevují ve větě „efektivně zpracovat mnoho souběžných requestů." To je ale jako říct, že kladivo a šroubovák jsou konkurenti, protože oba „spojují věci dohromady."

Real-time a reaktivní vzory s Netflix DGS

Thu, 19 Mar 2026 00:00:00 +0000

Čtvrtý díl ze sedmi v sérii “Production GraphQL with Netflix DGS”

REST API fungují na principu request-response: klient se zeptá, server odpoví, spojení se zavře. GraphQL subscriptions tento vzor narušují — server posílá aktualizace klientovi v okamžiku, kdy nastanou. Tento článek popisuje, jak DGS implementuje subscriptions, jak fungují reaktivní typy napříč frameworkem a jak to celé monitorovat v produkci.

GraphQL Subscriptions

Subscriptions umožňují klientům přijímat proud aktualizací přes persistentní spojení. Typické případy použití: živé výsledkové tabule, sledování průběhu, notifikace, kolaborativní editace.

Přestaňte bourat dům kvůli výměně nábytku: Proč je GitOps lepší než push-based deployment

Mon, 16 Mar 2026 00:00:00 +0000

Chcete nasadit novou verzi API. Změna jednoho řádku: posunout image tag z v1.4.2 na v1.4.3. S GitOps setupem pushnete do Gitu a za 30 sekund je cluster srovnaný. S push-based přístupem, který stále vidím v produkci — Helm charty publikované Terraformem — spustíte pipeline, která naplánuje celou infrastrukturu, vyhodnotí každý resource, čeká na schválení a pak aplikuje změnu. To je jako bourat dům kvůli výměně nábytku.

A přesto push-based deployment přes Terraform zůstává pozoruhodně populární. Manažeři ho mají rádi, protože vidí tlačítko “Deploy” v CI/CD rozhraní. Inženýři ho používají ze setrvačnosti, protože Terraform už spravuje cluster. Ale cena je reálná — v délce pipeline, v blast radius, v provázanosti a v operační odolnosti.

Zabezpečení GraphQL API s Netflix DGS

Thu, 12 Mar 2026 00:00:00 +0000

Třetí díl ze sedmi v sérii “Production GraphQL with Netflix DGS”

GraphQL dává klientům mimořádnou flexibilitu — sami si volí, která pole načíst, jak hluboko zanořit dotaz a kolik operací poslat naráz. Tato flexibilita je zároveň vaším útočným povrchem. Tento článek pokrývá tři vrstvy obrany, které potřebuje každé produkční GraphQL API: autentizaci a autorizaci, sanitizaci chyb a ochranu proti zneužití dotazů.

Vrstva 1: Autentizace a autorizace

DGS běží uvnitř Spring Bootu, takže máte k dispozici kompletní toolkit Spring Security. Nejpraktičtějším vzorem jsou anotace @PreAuthorize přímo na DGS metodách.

Testování Axon 5 agregátů pomocí Spocku: Praktický průvodce

Mon, 09 Mar 2026 00:00:00 +0000

Event-sourcingový model Axon Frameworku se přirozeně snoubí s expresivním given-when-then stylem Spocku. Přesto většina příkladů online ukazuje JUnit. Tento průvodce pokrývá, jak testovat kompletní stavový automat Axon 5 agregátu pomocí Spocku a AxonTestFixture.

Doména: Agregát objednávky

Použijeme jednoduchý životní cyklus objednávky:

stateDiagram-v2 [*] --> CREATED CREATED --> CONFIRMED: confirm CONFIRMED --> SHIPPED: ship SHIPPED --> DELIVERED: deliver CREATED --> CANCELLED: cancel CONFIRMED --> CANCELLED: cancel

Agregát sleduje stav pomocí @EventSourcingHandler metod, které přehrávají uložené eventy:

Řešení N+1 problému pomocí Data Loaderů a Field Resolverů

Thu, 05 Mar 2026 00:00:00 +0000

Druhý díl ze 7 v sérii „Production GraphQL with Netflix DGS"

GraphQL dává klientům možnost požádat přesně o ta data, která potřebují. To je jeho síla — a zároveň jeho past. Bez pečlivého návrhu backendu může jediný dotaz vyvolat stovky databázových volání. Tento článek ukazuje, jak tomu DGS data loadery a field resolvery zabraňují.

N+1 problém vizuálně

Představte si jednoduchý dotaz, který načítá objednávky s jejich produkty:

query {
 orders(pageNumber: 0, pageSize: 20) {
 items {
 id
 status
 product { # ← This field is the problem
 name
 price
 }
 }
 }
}

Bez optimalizace se na backendu stane následující:

Schema-first GraphQL s Netflix DGS

Thu, 26 Feb 2026 00:00:00 +0000

1. díl ze 7 série “Production GraphQL with Netflix DGS”

Pokud stavíte GraphQL API se Spring Bootem, pravděpodobně jste si všimli dvou velkých frameworků soupeřících o vaši pozornost: Netflix DGS a Spring for GraphQL. Roky si týmy musely vybrat jednu stranu. Tato volba už neexistuje — a příběh toho, jak tyto frameworky splynuly, stojí za pochopení dřív, než napíšete svůj první @DgsQuery.

Dva frameworky se staly jedním

Netflix open-sourcoval framework Domain Graph Service (DGS) v roce 2021. Byl ověřený na Netflixím měřítku — stovky služeb, tisíce dotazů — a nabízel něco, co Spring v té době neměl: propracovaný, anotacemi řízený programovací model pro GraphQL.

Tichá mezera v metadatech: Proč vaše Axon 5 eventy nemají atribuci uživatele

Wed, 25 Feb 2026 00:00:00 +0000

Když jsme migrovali z Axon Framework 4 na 5, pečlivě jsme aktualizovali agregáty na EventAppender, přepsali command handlery na statické tovární metody a upravili event sourcing handlery. Vše se zkompilovalo. Testy prošly. Eventy proudily. Pak jsme během interního QA kola zpozorovali něco zvláštního: timeline historie agregátu ukazovala eventy bez autora — jen časové značky a typy eventů vznášející se v prázdnu.

Příčina? Metadata příkazů v Axonu se automaticky nepropagují do eventů. A když se soustředíte na velké změny migrace na Axon 5, přesně tohle je věc, která vám proklouzne.

Váš MCP Server funguje lokálně. Pak Kubernetes zabije session.

Mon, 23 Feb 2026 00:00:00 +0000

Provozujeme Spring AI MCP server v produkci na GKE. Slouží Claude Code jako klient a vystavuje 60+ nástrojů pro správu lezeckých dat — lokality, cesty, stěny, prostě všechno. Autentizační vrstva je solidní: JWT tokeny perzistované v PostgreSQL, duální validace (HS256 service tokeny, RS256 OAuth uživatelské tokeny), kontrola revokace při každém požadavku.

Pak, občasně, Claude Code začne vyhazovat toto:

Session not found: f4456324-79fb-4d84-ab2b-eebf27c5a475

Token je platný. Server běží. Endpoint odpovídá. Ale session je pryč.

Nahrazení Flux Bootstrap operátorem Flux: GitOps na autopilota

Fri, 20 Feb 2026 00:00:00 +0000

Správa Flux CD v produkci dříve znamenala spuštění flux bootstrap, commitnutí stovek řádků generovaného YAML a manuální koordinaci upgradů napříč clustery. S Flux Operátorem je toto vše nahrazeno jediným Kubernetes custom resource — FluxInstance — který deklaruje celou vaši Flux instalaci jako kód.

V tomto článku projdeme, jak jsme migrovali z tradičního Flux bootstrap přístupu na Flux Operator na GKE Autopilot clusteru, celé řízeno Terraformem.

Co je Flux Operator?

Flux Operator je Kubernetes controller vyvinutý společností ControlPlane, který spravuje životní cyklus instalací Flux CD. Místo bootstrapování Fluxu přes CLI (které generuje a commituje gotk-components.yaml a gotk-sync.yaml do vašeho repozitáře) nainstalujete operátor jednou a pak deklarujete FluxInstance custom resource popisující, co chcete.

Propagace identity uživatele v Axon 5 query handlerech

Wed, 18 Feb 2026 00:00:00 +0000

Aktualizace (březen 2026): Nahlásili jsme tento problém týmu Axon Frameworku. Jádro problému — prázdný ReactiveSecurityContextHolder uvnitř @QueryHandler — je nyní sledováno jako GitHub issue #4207. Viz sekce s aktualizací níže.

Během interního testování nové verze jsme narazili na záhadný bug: vlastníci neviděli své vlastní entity na správcovské stránce. Chybová zpráva byla jednoduše “Unable to load” — přestože záznam v databázi prokazatelně existoval.

Naše aplikace používá Axon Framework 5 se Spring WebFlux a Netflix DGS (GraphQL). Query handler dělal něco zdánlivě rozumného — kontroloval, zda je autentizovaný uživatel vlastníkem, před vrácením INACTIVE záznamů:

Migrace z Axon Framework 4 na 5: Co jsme se naučili

Mon, 16 Feb 2026 00:00:00 +0000

Provozujeme CQRS/Event Sourcing backend — nyní spokojeně na Java 25, Spring Boot 4 a Axon Framework 5. Ale cesta sem z Axon 4.12 nebyla jednoduchá. Codebase obsahuje desítky agregátů, více ság, přes stovku typů událostí a stovky anotovaných handler metod.

Tady je, co jsme se naučili.

Proč jsme chtěli Axon 5

Motivace byla jednoduchá: nativní reaktivní podpora v event handlerech.

Axon 4.x má známý problém se subscribing event procesory. Když @EventHandler vrátí Mono<Void>, framework se na něj nikdy nepřihlásí. Reaktivní řetězec se jednoduše neprovede. Přišli jsme na to tvrdým způsobem, když projekční handlery přestaly tiše zapisovat do databáze.

Proč je OpenTelemetry lepší než proprietární APM agenti

Sat, 14 Feb 2026 00:00:00 +0000

Pokud jste někdy zkoušeli vyměnit svého APM dodavatele, znáte tu bolest. Proprietární agenti od Datadogu, Dynatrace nebo New Relicu se hluboce zaplétají do vašeho deployment pipeline — různé binární agenty pro každý jazyk, vendor-specifická konfigurace, custom SDK ve vašem aplikačním kódu. Přechod znamená vše vytrhnout a začít znovu.

OpenTelemetry nabízí zásadně odlišný přístup: jeden otevřený standard pro instrumentaci všeho se svobodou posílat telemetrická data kamkoli chcete.

Problém s proprietárními agenty

Tradiční APM dodavatelé dodávají své vlastní proprietární agenty. V praxi to znamená: