Skip to main content
ENSK
PraxElektrikProJARVISBlog
Referencia · Stack

Šesť vrstiev. Každý default obhájený.

Toto je stack, ktorý Sebrona štandardne prevádzkuje v každej vrstve. Za každou bunkou je ADR v projektovom repozitári, každá výmena je zdokumentovaná. Domovská stránka §06 ten istý šesťvrstvový stack rozpráva v próze; táto stránka je URL, ktorú pošlete svojmu CTO a bezpečnostnému tímu.

Naposledy skontrolované · 24. 5. 2026Nasledujúca revízia · 24. 8. 2026Zrevidoval: Miroslav Striško
Vrstva po vrstve

Čo beží na každom poschodí a prečo.

L5 · ROZHRANIE
Web · React/TS·Mobile · React Native·Chat · copilot·Dashboards · embeds

React + TypeScript pre web, React Native pre mobilných klientov. Component primitives sú zdieľané naprieč oboma povrchmi: design systém nedubľujeme.

Prečo:React + RN zdieľajú tie isté komponentové primitíva, takže nedvojstaviame dizajnový systém. tRPC typy dosiahnu na props na oboch klientoch; jedna zmena schémy, jedna typová chyba na opravu.

L4 · API BRÁNA
tRPC + Zod·REST · OpenAPI·Webhooks·Auth · RLS

tRPC + Zod je východisko: jeden kontrakt z DB riadku až do React propu. K REST-u prejdeme vtedy, keď externý spotrebiteľ potrebuje OpenAPI; disciplína validácie je v oboch prípadoch rovnaká.

Prečo:tRPC + Zod dáva jeden validovaný kontrakt od DB riadku po React prop bez codegenu. Na REST + OpenAPI klesneme len vtedy, keď to externý konzument vyžaduje; Zod schémy slúžia aj ako vstup pre OpenAPI generátor.

L3 · ORCHESTRÁCIA
LangGraph · MCP servers·Langfuse · OTel·Promptfoo · Inspect AI·n8n · queues

LangGraph pre stavové agentné toky, ktoré vedieme od špecifikácie po cutover; LiteLLM ako router za routing.policy.yaml, odsúhlaseným v prvom týždni. Nástrojové povrchy štandardizujeme cez Model Context Protocol: rovnaký server kontrakt pre Claude, lokálne modely aj IDE. n8n za frontou pre automatizácie smerujúce k analytikom, ktoré si klient bude sám upravovať. Langfuse pre observabilitu na úrovni trace a diffov verzií promptov; Promptfoo ako brána v CI. Eval harness a registry promptov aj modelov žijú v tejto vrstve, nie ako dodatok.

Prečo:LangGraph pre stateful agent flow, ktoré potrebujú explicitné riadenie grafu. MCP pre tool surfaces, lebo jeden server kontrakt zasiahne Claude, lokálne OSS aj IDE. Langfuse pre diff verzií promptov a trace-level observability; Promptfoo ako CI brána, takže červený eval blokuje merge.

L2 · MODELOVÁ VRSTVA
Claude · GPT·Local OSS·Cohere rerank-3·Voyage-3 · BGE-M3

Routing policy rozhoduje, ktorý model vidí ktorý prompt. Hostovaná špička vtedy, keď je reasoning náročný a dáta nie sú citlivé; lokálny open-weight tam, kde má prednosť suverenita: za cenu investície do GPU a reálnej medzery pri tých najťažších promptoch.

Prečo:Hostovaný Claude alebo GPT, keď je vysoká záťaž na uvažovanie a dáta nie sú citlivé. Lokálne OSS (Qwen 3, Mistral Small 3.2, obe Apache-2.0), keď vyhráva suverenita: akceptujeme GPU capex a reálnu medzeru na najťažších promptoch. Voyage-3 + BGE-M3 sedia na vrchu MTEB retrieval leaderboardu v roku 2026; v základe používame Voyage-3 hostovaný pre anglické a kódové korpusy a BGE-M3 self-hosted, keď vyhráva suverenita. Cohere rerank-3 na top-50.

L1 · DÁTA
Postgres·pgvector·Object store·Event stream

Jedna databáza, kým nedokážeme, že potrebujeme dve. pgvector drží retrieval pri riadku, ktorý ho ukotvuje; k dedikovanému vector store sa pohneme až vtedy, keď nás k tomu donúti škála, a napíšeme ADR, ktoré vysvetlí prečo.

Prečo:Jedna databáza, kým nedokážeme, že potrebujeme dve. pgvector drží retrieval vedľa riadku, ktorý ho ukotvuje: žiadny druhý store na synchronizáciu. Na dedikovaný vektorový store sa pohneme až keď nás k tomu donúti scale, a ADR vysvetlí, prečo.

L0 · INFRAŠTRUKTÚRA
Cloudflare · EU·Supabase · Frankfurt·OTel + SLOs·Vault · KMS

EÚ dátová hranica v základe, on-prem vtedy, keď to vyžaduje regulátor. Secrets v KMS, nikdy nie v env súboroch. SLO a error budgety odsúhlasené v prvom týždni: čo nemeriame, to neúčtujeme.

Prečo:EÚ dátová hranica v základe. On-prem, keď to regulátor vyžaduje. KMS pre tajomstvá, nikdy nie env súbory. SLO a error budgety dohodnuté v prvom týždni, takže on-call záväzok je ohraničený niečím, čo obe strany podpísali.

Disciplína

Čo platí naprieč všetkými vrstvami.

Typová bezpečnosť naprieč celým stackom (tRPC + Zod, žiadne netypované JSON cez sieťový skok). Eval harness na každom prompt route, držaný v CI cez Promptfoo alebo Inspect AI. Registry promptov aj modelov: každý route pripnutý na verziu, rollback na jeden príkaz. OpenTelemetry traces od edge po model a späť, s tokenmi a nákladom ako atribúty spanu. Default-deny dátové politiky, maskovanie PII na hranici siete, egress allowlist. ADR v repozitári pre každé architektonické rozhodnutie, ktoré sa oplatí obhajovať. Z preview do main na Cloudflare Pages pod šesť minút; rollback je `git revert`; migrácie databázy sú reverzibilné, alebo nejdú do produkcie.

Chcete tento stack pre projekt, ktorý ide do produkcie?

Prečítali ste si defaulty. Otváracia konverzácia je o tom, ktoré bunky váš tím vymení za existujúci nástroj, ktoré ADR-ká spolu napíšeme v prvom týždni a čo už vaše evaly pokrývajú, kým sa do CI zapojí náš harness. Príďte s otázkami z architektonického review: odpovieme na hovore.