Technologie

Pod kapotou.Bez tajemství.

Jak je MyBoard postavený: od monorepa v TypeScriptu přes Microsoft Graph a lokální modely na vlastním hardwaru až po stavový automat, který hlídá, aby nic neodešlo dvakrát ani bez souhlasu.

Architektura

Pět vrstev, jedna odpovědnost na každé.

Rozhraní nikdy nemluví přímo s modely. Vše jde přes API, které vlastní stav. Worker synchronizuje, Brain navrhuje, a teprve schválená akce opustí systém.

01 Rozhraní

Webová aplikaceReact 19 · PWA
TelefonPWA a notifikace ntfy
Notebookpřes VPN odkudkoli

02 Brána

nginxHTTPS jen v privátní síti, vlastní CA
Jen přes VPNTailscale, WireGuard, OpenVPN · žádné otevřené porty

03 Aplikace

APINestJS 11 · REST · Socket.IO
WorkerBullMQ · synchronizace Graph
Brainagentní vrstva · třídění · návrhy

04 Data a fronty

MariaDB 11.8Prisma 7 · migrace
Redis 7fronty, realtime události
Znalostní bázeMarkdown · Obsidian

05 Modely

llama.cpp · VulkanGemma 4 26B MoE · bge-m3
ClaudeHaiku · Sonnet · Opus
Codeximplementace ve worktree

Monorepo a stack

Jeden repozitář, jeden jazyk, sdílené typy.

Celý systém je jedno monorepo v TypeScriptu spravované přes pnpm. Sdílené balíčky drží databázové schéma, typy, překlady a typovaného klienta API, takže změna se projeví všude najednou.

myboard · monorepo
  • apps/
  • apiNestJS 11, REST a Socket.IO, OAuth, schvalování
  • webReact 19, Vite, Tailwind, PWA
  • workerBullMQ, synchronizace schránek a Trella
  • braintřídění, kontext, návrhy, eskalace
  • packages/
  • dbPrisma schéma, migrace, obnova tokenů
  • sharedtypy a validace
  • i18nčeština a angličtina, kontrola klíčů
  • api-clienttypovaný klient API
  • infra/nginx, zálohy, služby lokálních modelů
  • Backend

    • NestJS 11
    • TypeScript
    • Socket.IO 4.8
    • MSAL
  • Frontend

    • React 19
    • Vite 6
    • Tailwind 4
    • PWA
    • Tiptap 3
  • Data

    • MariaDB 11.8
    • Prisma 7
    • Redis 7
    • BullMQ 5
  • AI

    • llama.cpp
    • Vulkan
    • Gemma 4 26B MoE
    • bge-m3
    • Claude
    • Codex
  • Provoz

    • Docker Compose
    • nginx
    • ZFS
    • Tailscale
    • WireGuard
    • OpenVPN
    • systemd
    • ntfy
  • Testy

    • Vitest
    • Jest
    • Supertest
    • Testing Library
    • Playwright

Microsoft Graph a OAuth

Pošta, kalendář a kontakty přes oficiální API.

Přihlášení probíhá výhradně přes účet Microsoft. Žádná hesla k poště, žádné IMAP. Synchronizace je přírůstková a zvládá výpadky i omezení rychlosti na straně Microsoftu.

Přihlášení a tokeny

  • Authorization code flow s PKCE, důvěrný klient registrovaný v Microsoft Entra.
  • Jeden seznam oprávnění pro přihlášení i obnovu: pošta, odesílání, kalendář, kontakty, nastavení schránky.
  • Přístupové i obnovovací tokeny šifrované AES-256-GCM, náhodný inicializační vektor pro každé šifrování.
  • Rotovaný refresh token se vždy uloží. Když obnova selže, účet se označí k novému přihlášení, nic se nesmaže.

Přírůstková synchronizace

  • Delta dotazy po složkách, uložený odkaz na poslední stav, stránkování až do konce.
  • Ztracený delta stav (HTTP 410) spustí úplnou resynchronizaci jen dané složky.
  • Odpovědi 429 a 503 respektují hlavičku Retry-After.
  • Více schránek na jednoho uživatele, každá s vlastním pravidlem zpracování.

Živé rozhraní

  • Socket.IO s Redis adaptérem: nový návrh se ve frontě objeví bez obnovení stránky.
  • Worker posílá události přes Redis emitter, API a worker mohou běžet ve více procesech.
  • Koncepty odpovědí vznikají přímo ve vlákně v Outlooku, se správnými příjemci.
  • Přílohy přes podepsané odkazy s omezenou platností.

Lokální AI

Vlastní server, vlastní modely.

Třídění pošty, kontrola osobních údajů, souhrny i učení běží na hardwaru ve firmě. Tři lokální modely mají každý svou roli. Běží v llama.cpp na integrované grafice přes Vulkan a jejich rozhraní kompatibilní s OpenAI poslouchá jen na localhostu.

  • AMD Ryzen AI Max+ 39516 jader, 32 vláken, NPU
  • 128 GB sdílené pamětiCPU i GPU nad jednou pamětí, modely bez kopírování
  • Radeon 8060Sintegrovaná grafika, backend Vulkan
  • ZFS zrcadlodva disky, snapshoty každých 15 minut

třídění, souhrny a učení

Gemma 4 26B MoE

Mixture of Experts (26B-A4B): z 26 miliard parametrů je pro každý token aktivních jen asi 4 miliardy, proto je rychlá i na integrované grafice. Třídí každou příchozí zprávu, píše souhrny historie klientů, kontroluje osobní údaje a v noci se učí z odeslaných odpovědí. Hustou Gemmu 4 31B jsme naměřili na stejné sadě, přesnější nebyla a byla čtyřikrát pomalejší.

Generování
46 tokenů/s
Klasifikace zprávy
2,1 s
Přesnost kategorie
90 %

embeddingy a vyhledávání

bge-m3

Vícejazyčný model pro embeddingy, který rozumí češtině. Vektory o 1 024 dimenzích pro sémantické hledání v historii klientů, nabídkách a znalostní bázi.

Dimenze vektoru
1 024
Kontext
8 192 tokenů
Kvantizace
8 bitů

Rozdělení rolí: Gemma 4 MoE třídí, shrnuje a učí se, bge-m3 indexuje pro vyhledávání. Modely porovnáváme na stejné sadě syntetických zpráv: přesnost, rychlost a kvalita češtiny.

Stupňování modelů

Nejlevnější schopný model. Silnější jen když je potřeba.

Brain podle složitosti zprávy vybere model a úroveň uvažování. Když si návrh není jistý nebo chybí podklady, jednou eskaluje o stupeň výš. Použitý model se ukládá k návrhu.

  1. Lokální

    Gemma 4 26B MoE

    Třídění, kontrola osobních údajů, souhrny a noční učení. Data neopustí server.

  2. Haiku

    Rychlé odpovědi

    Jednoduché zprávy bez manuálu a bez nabídky, záložní klasifikace.

  3. Sonnet

    Běžná práce

    Odpovědi klientům a podpoře, na vyšší úrovni uvažování licence, platby a projekty.

  4. Opus

    Plány a nabídky

    Průzkum kódu se souhlasem, plán k issue, složité nabídky. Jen čtení, žádné zápisy.

  5. Codex

    Implementace

    Schválené úkoly ve vlastním worktree. Druhý pohled a nezávislé review.

Claude i Codex běží jako oficiální nástroje příkazové řádky s minimálními oprávněními: model, který píše odpověď, smí jen číst podklady. Žádný shell, žádný web, žádné odesílání.

Politika autonomie

Čtyři úrovně důvěry. Zapínané měřením.

Každá kategorie zpráv má vlastní úroveň. Úspěšnost se měří na skutečných rozhodnutích: kolik návrhů odešlo beze změny, kolik bylo upraveno a kolik zahozeno.

  1. L0

    Jen třídění

    Kategorie, štítky, souhrn. Nic se nepíše ani neodesílá.

    zapnuto pro vše
  2. L1

    Koncept a notifikace

    Brain připraví návrh a pošle notifikaci. Odesílá člověk.

    výchozí úroveň
  3. L2

    Odeslání s upozorněním

    Odpověď odejde sama, notifikace přijde po odeslání. Jen pro kategorie bez závazků, kde za poslední 4 týdny odešlo aspoň 95 % návrhů beze změny.

    po kategoriích, podle měření
  4. L3

    Samostatné vyřízení

    Včetně navazujících kroků. Jen pro výslovně vybrané typy úloh.

    jen výslovně vybrané

Nikdy automaticky, na žádné úrovni

  • ceny a nabídky
  • smlouvy
  • platby a licence
  • právní a GDPR otázky
  • stížnosti
  • data klienta v příloze
  • první kontakt nového klienta

Stavový automat schvalování

Odeslat se dá jen jednou. I když kliknete dvakrát.

Každý návrh prochází jasnými stavy. Přechod drží zámek řádku v databázi, externí volání probíhá mimo transakci a opakovaný požadavek vrátí aktuální stav místo druhého odeslání.

pendingčeká na vás renderingPDF nabídky pending_senddruhé schválení sendingzámek řádku sentuloženo do historie
discardedzahozeno z pending failedověří člověk, bez automatického opakování

Idempotence

  • Každý návrh má klíč idempotence. Stejný klíč vrátí stejný záznam, změna cíle skončí chybou 409.
  • Komentáře k issue mají klíč z repozitáře, čísla a revize. Opakované doručení nic nezmění.
  • Přílohy se rezervují před externím voláním a kontrolují kontrolním součtem.
  • Odeslání, které spadlo v půlce, se samo neopakuje. Výsledek ověří člověk, aby nevznikl duplikát.

Podepsané akce v notifikacích

{ resource, action, audience, iat, exp, nonce }.HMAC-SHA256
  • Tlačítko v notifikaci nese token podepsaný HMAC-SHA256 s cílovou akcí a adresou.
  • Výchozí platnost 15 minut, nejvýše 24 hodin. Jednorázové číslo nonce se spotřebuje ve stejné transakci jako změna stavu.
  • Opakované použití vrátí 409. Otevření odkazu nic nezmění, akci provede až potvrzení.

Agenti, izolace a testy

Agent píše kód. Do produkce ho pustí člověk.

Vývojoví agenti pracují v oddělených zónách. Agent, který čte poštu, nemá k dispozici shell ani repozitáře. Agent, který píše kód, nikdy neuvidí syrový e-mail, jen schválené a přepsané zadání.

  • 1 450+automatických testů v pěti sadách
  • 187end-to-end testů API proti skutečné databázi MariaDB
  • 806překladových klíčů kontrolovaných v češtině a angličtině
  • 4šířkyvizuální kontrola v Playwrightu: 360, 390, 768 a 1440 px
  • Vitest a JestBrain, webové rozhraní, API i worker mají vlastní sady.
  • Brána před commitemTesty a review řídícím agentem, teprve pak commit.
  • Paralelní agentiNikdy dva agenti na stejné soubory, každý ve svém worktree.
  • Citlivý kódPlatby, přihlášení, šifrování a uploady vždy nejsilnější model a review člověkem.

Provoz a zálohy

Nudný provoz je dobrý provoz.

Kontejnery, databáze a modely běží na jednom výkonném serveru. Přístup je jen přes VPN, do internetu nevede žádný otevřený port a ven nic nevystavujeme.

  • Docker Compose

    API, worker, web a Redis jako kontejnery z vícestupňových buildů. Migrace databáze proběhnou při startu API.

  • MariaDB a Redis

    MariaDB 11.8 se striktním SQL režimem jako produkce, Redis pro fronty BullMQ a realtime události.

  • ZFS snapshoty

    Zrcadlo disků, snapshoty každých 15 minut, hodinové a denní. Před riskantní změnou ruční snapshot.

  • Zálohy databáze

    Konzistentní dump v jedné transakci a archiv příloh, posledních 14 záloh, kopie na samostatný diskový pool.

  • Přístup jen přes VPN

    Tailscale, WireGuard a OpenVPN. Žádné otevřené porty do internetu, služby poslouchají jen v privátní síti nebo na localhostu.

  • Vlastní ntfy

    Notifikace na telefon z vlastního serveru: návrhy ke schválení, hotová práce agentů, ranní souhrn.

MyWebdesign.cz · aplikace na míru

Tohle umíme postavit i pro vás.

MyBoard je naše vlastní provozní centrum. Stejným postupem navrhneme a postavíme automatizaci vašich procesů: od analýzy přes pilot až po provoz, s AI, která připravuje, a lidmi, kteří rozhodují.