Technická architektura

Aliance Mouidea

Autonomní vývojová platforma na Google Cloud s izolací repozitářů, řízenou orchestrací agentů a automatickou kontrolou kvality kódu.

Veřejný web: mouidea.cz
25
Izolovaných repozitářů
22
Kanonických skillů
0 %
Vendor Lock‑in
europe‑west1
Primární GCP region

Architektura a orchestrace AI agentů

Řízení probíhá v izolovaných pracovních větvích s přesně oddělenou odpovědností mezi strategií, vývojem a verifikací kvality.

Klient Zadání a cíle CEO Agent Strategie a zadání PO & Subagenti Izolovaný vývoj a testy Cloud Run Quality Gate v5.1
Klient Zadání a obchodní cíle
↓
CEO Agent Strategie, architektura a PO Prompt
↓
PO & Subagenti Izolovaný vývoj v .worktrees/
↓
Quality Gate v5.1 & Cloud Run Automatický audit a nasazení

Technické vrstvy systému

3 vrstvy
Orchestrace a pravidla (40 %)
Cloud Run a CI/CD (30 %)
Quality Gate a testy (30 %)

Rozložení 22 kanonických skillů

Řízení a plánování 6 Vývoj, QA a cloud 5 Design, jazyk a SEO 5 Obchod, péče a finance 6
Řízení a plánování (6)
  • smart-router – automaticky volí nejvhodnější AI model podle složitosti úkolu a hlídá náklady i mezipaměť.
  • fast – zrychlený režim pro drobné textové a vizuální úpravy bez zbytečných auditů.
  • brainstorming – strukturované generování nápadů a architektonických konceptů s doptáváním.
  • deep-research – hloubkový průzkum trhu, dokumentace a technologií na uvažovacím modelu Pro.
  • project-provisioning – autonomní založení projektu na disku, přidělení portů a registrace v systému.
  • project-supervision – nezávislá kontrola kvality vývoje (Quality Gate v5.1) před předáním výstupu.
Vývoj, QA a cloud (5)
  • react-performance-standard – optimalizace výkonu React/Next.js aplikací, redukce balíčků a rychlost vykreslení.
  • media-optimization-standard – automatická konverze médií do WebP/AVIF a ochrana Core Web Vitals (LCP/CLS).
  • qa-security-audit – spouštění testů, kontrola zranitelností balíčků a ochrana citlivých údajů (PII).
  • gcp-cloudrun-deploy – standardizované nasazování aplikací na Google Cloud Run bez závislosti na třetích stranách.
  • dns-email-management – správa DNS záznamů, konfigurace e‑mailů a verifikace SPF, DKIM a DMARC.
Design, jazyk a SEO (5)
  • brand-ui-design – jednotný vizuální styl Google Clean Light / Deep Obsidian Dark a vektorové ikony.
  • czech-language-standard – kontrola bezchybné češtiny, pravopisu ÚJČ a odstranění strojových frází.
  • web-typography-standard – nezlomitelné mezery u předložek, české uvozovky, pomlčky a čistá sazba cen.
  • seo-geo-standard – technické SEO, strukturovaná data Schema.org a optimalizace pro AI vyhledávače.
  • prehled-a-naklady – živý přehled reálných nákladů Google Cloud a spotřeby AI modelů z BigQuery.
Obchod, péče a finance (6)
  • sales-proposal – tvorba B2B obchodních nabídek, cenových kalkulací a rozpisu realizace.
  • client-onboarding – řízené převzetí klienta, sběr podkladů a příprava úvodní dokumentace.
  • client-success – proaktivní dohled nad provozem, plnění SLA a pravidelné revize rozvoje.
  • monthly-client-reporting – automatické generování a rozesílání měsíčních manažerských PDF výkazů.
  • finance-report – finanční audit příjmů, výdajů, pohledávek z Fakturoidu a cloudové infrastruktury.
  • antigravity-guide – interní příručka a nápověda pro obsluhu a rozšiřování celého systému.

Životní cyklus a iterativní dodávka

Od prvního oslovení zákazníka po nepřetržitý provoz a měsíční reporting v pěti řízených fázích.

1

Analýza a cíl

Audit obchodních cílů, datových zdrojů a architektury bez předčasného kódování.

2

Studie a nabídka

Zpracování B2B nabídky, cenové kalkulace a kanonického zadání (SSOT).

3

Prototyp a design

Vytvoření UI/UX prototypu v souladu s brandem a schválení klientem.

4

TDD a Cloud Run

Vývoj řízený testy, ověření Quality Gate v5.1 a nasazení na Google Cloud Run.

5

Provoz a reporting

Nepřetržitý monitoring, garance SLA a automatizovaný měsíční finanční i výkonnostní report.

Technická opatření a integrace

Konkrétní mechanismy, kterými zajišťujeme bezpečnost dat, kvalitu kódu, nízkou spotřebu tokenů i průběžné učení systému.

Bezpečnost (Security)

  • Multi‑tenant izolace: Každý klient má vlastní repozitář a GCP projekt mouidea‑<klient>; agenti nemají přístup k cizím datům.
  • Ochrana PII: Osobní a klientská data zpracováváme výhradně v prostředí Google Cloud a Workspace (Gemini Enterprise DPA), nikdy přes externí MCP modely.
  • Staging brána: Automatické nasazení na <klient>.mouidea.cz s X‑Robots‑Tag: noindex a ochranou heslem v STAGING_PASSWORD.
  • Audity: Automatický npm audit, sanitizace PII a kontrola idempotence webhooků přes qa‑security‑audit.

Vývoj a kvalita kódu (Development)

  • TDD a izolace větví: Backend a utility vznikají cyklem Red‑Green‑Refactor v izolovaných pracovních větvích .worktrees/.
  • Modularita: Striktní limit 250 řádků na .tsx/.jsx soubor a kontrola závislostí přes kódový graf.
  • Quality Gate v5.1: Automatická kontrola typů (npx tsc ‑‑noEmit), zdraví aplikace (qa_health_check.mjs) a integrity repozitářů.
  • Nulový Vendor Lock‑in: Standardní otevřený kód (Next.js, React, TypeScript) nasaditelný kamkoliv.

Efektivita agentů a nízké náklady za tokeny

  • Smart Router a režim /fast: Drobné úpravy vyřizuje hlavní agent přímo bez spouštění subagentů a těžkého auditu.
  • Prompt Cache (TTL 300 s): Udržování 5minutového okna mezipaměti; při překročení 180 tis. tokenů (nebo 100 tis. po expiraci cache) systém doporučí /compact.
  • Hierarchie modelů: Složité úlohy běží na modelu Pro, rutinní úkoly delegujeme na úsporné modely Flash a Flash Lite.
  • Úsporné čtení a pravidla: Kód čteme cíleně po blocích a kanonický soubor AGENTS.md držíme pod 20 KB.
  • Reálná spotřeba (90 dnů, BigQuery): Celkem 8,15 mld. tokenů (průměrně ~2,72 mld. / měsíc), z toho 4,33 mld. v cache (53,1 %) a 28,62 mil. výstupních tokenů.
  • Nákladová efektivita: 4 223 zadání (86 567 API volání) při průměrné ceně 5,22 Kč / zadání s DPH; 68 % útraty běží na úsporném modelu Gemini Flash.

Auto‑učení a paměť systému

  • Registr naučených pravidel: Každá oprava nebo nová zkušenost se po schválení ukládá přes /learn do LEARNED_RULES.md.
  • Synchronizace přes symlinky: Změny v pravidlech a skriptech se okamžitě propisují do všech 25 repozitářů bez duplikace.
  • Sjednocený deník: Veškerá rozhodnutí a předávky se zapisují do PROJECT_JOURNAL.md, takže kontext nezmizí ani po komprimaci.

Produkční integrace

  • Google Cloud Platform: Cloud Run (europe‑west1), BigQuery Billing Export pro živé náklady, Secret Manager, Cloud SQL a Firestore.
  • Vývoj a infrastruktura: GitHub (správa kódu a větví), WEDOS DNS API (automatické CNAME záznamy přes wedos_add_cname.mjs).
  • Provoz a analytika: Fakturoid (fakturace a splatnosti), Google Workspace, GA4, GTM a Microsoft Clarity.

Srovnání technického přístupu

Rozdíly mezi klasickým zakázkovým vývojem a naší architekturou na Google Cloud.

Oblast Běžný zakázkový vývoj Technické řešení Mouidea
Rychlost dodání Týdny plánování, ruční předávky Dny; automatizované generování kódu a testů
Vendor Lock‑in Vysoký; uzavřená CMS a vlastní frameworky 0 % (otevřený kód, standardní GCP infrastruktura)
Kontrola kvality Manuální testování před spuštěním Quality Gate v5.1, striktní TS typy a TDD
Náklady na provoz Paušály bez rozpadu spotřeby Měřená spotřeba z BigQuery Billing Exportu
Optimalizace a SEO Dodatečná úprava po dokončení webu Vestavěný standard SEO/GEO a Lighthouse 100
Google Cloud
Cloud Run
BigQuery
GitHub

Strategická osa rozvoje

Přechod od lokálně závislého vývoje k plně cloudové agentní firmě běžící 24/7 na Google Cloud Platform.

✓

Hotovo: Konsolidace architektury a pravidel

Sjednocení 25 repozitářů, 22 kanonických skillů, synchronizace přes symlinky, zavedení Quality Gate v5.1 a živé měření nákladů v BigQuery.
Proč: Vytvoření pevného a opakovatelného základu bez duplicit před dalším škálováním.

✓

Hotovo: Cloud Run a staging brána

Standardizované nasazování aplikací do regionu europe‑west1, automatické DNS přes WEDOS API a izolované staging prostředí.
Proč: Rychlé a bezpečné doručování změn klientům bez ručního nastavování serverů.

3

Další krok: Oddělení prototypování a cloudové orchestrace

Rychlé UI/UX prototypování zůstává v Google AI Studiu a na MacBooku, zatímco hlavní agentní orchestrace a dlouhé úlohy se přesouvají přímo do GCP.
Proč: Odstranění závislosti na lokálním notebooku a možnost paralelního běhu více úloh najednou.

4

Cíl: Autonomní 24/7 cloudová firma

Nepřetržitý provoz agentů v Google Cloud (monitoring, údržba, reporting, bezpečnostní audity) s plným řízením rozpočtu a nulovým zásahem do lokálního hardwaru.
Proč: Maximální dostupnost pro klienty, předvídatelné náklady a škálovatelnost bez navyšování týmu.