← Deck

Lurki

Backend Architektura — Produkce — únor 2026

Co se změnilo od poslední verze
115 migrací +12
543 testů +92
12 Workerů +5
NOVÉ lurki-api (18 endpointů, Scalar docs)
NOVÉ lurki-mcp (7 tools, Durable Objects)
NOVÉ lurki-whisper (Groq transkripce)
NOVÉ lurki-analyze (AI batch analýza)
NOVÉ lurki-tail (centrální observability)
UPD Public API LIVE (api.lurki.io)
UPD MCP Server LIVE (mcp.lurki.io)
UPD Whisper 593+ transkriptů
UPD AI pipeline plně běží
UPD Circuit breaker v2 (billing)
UPD Tail Worker R2 logs + Telegram
12
CF Workerů
33
Edge Funkcí
30
Cron Úloh
115
DB Migrací
6
Platforem
4 300+
Příspěvků
543
Testů
32
Backoffice str.
Klientská vrstva
Co to je: Vše, co vidí a používá koncový uživatel — landing pages, SaaS dashboard, admin panel, API a mobilní aplikace. Aktuálně běží landing page (3 domény + waiting list) a admin backoffice (32 stránek, React + Shadcn).
CF Worker
Landing Page (lurki-web) nové
Veřejné stránky s waiting list formulářem. 3 jazyky (EN/CZ/SK) dle domény. Cookie consent, privacy, terms.
www.lurki.io (EN) live
www.lurki.cz (CZ) live
www.lurki.sk (SK) live
Waiting list → Supabase + welcome email
Redirecty: lurki.ai, non-www → www
plán
Dashboard (SaaS)
Hlavní aplikace pro platící zákazníky — správa tvůrců, feed, stories prohlížeč, grafy a reporty.
Správa tvůrců + analytika
Feed + Stories prohlížeč
Detail profilu + grafy
app.lurki.io
CF Worker
Admin Backoffice upd
Interní panel pro náš tým — 32 stránek, React 19 + Shadcn/ui + TailwindCSS 4. Kompletní CRUD, grafy, řízení provozu.
14 hlavních stránek (Feed, Stories, Discovery, ...)
18 admin stránek (Profiles, Queue, Costs, Health, ...)
Brand Onboarding wizard (5 kroků + AI)
Notification center + preferences
backoffice.lurki.io live
plán
Veřejný web (Public Stats)
SEO stránky s veřejnými statistikami tvůrců — přístup z Googlu, profily, trendy, žebříčky.
SEO stránky /[platforma]/[username]
Trendy, porovnání, kategorie
lurki.io/creators
2 Workery
API + MCP Server nové
Veřejné REST API (18 endpointů, Scalar docs) + MCP Server (7 tools, Durable Objects) pro AI nástroje.
api.lurki.io — 18 endpointů, 92 testů live
mcp.lurki.io — 7 tools, 24 testů live
OpenAPI 3.1 + Scalar docs
Streamable HTTP + Durable Objects
plán
Mobilní aplikace (iOS)
Nativní iOS appka pro rychlý přehled — push notifikace, stories prohlížeč.
Dashboard + feed (nativní)
Push notifikace
App Store + TestFlight
Přihlašování — Magic Links + OAuth + 4 role
Vícejazyčnost — EN + CZ + SK (dle domény)
UI — Shadcn/ui + TailwindCSS 4
Uživatel → HTTPS → Cloudflare Worker
Exekuční vrstva — 12 Cloudflare Workers
Co to je: Serverless funkce na Cloudflare (300+ datových center). Každý Worker má jednu úlohu — jeden dodává data pro dashboard (51ms odezva), druhý stahuje příspěvky, třetí hledá profily (country-aware), čtvrtý generuje embeddings a sémantické vyhledávání. Nové: lurki-api (18 REST endpointů), lurki-mcp (7 MCP tools), lurki-whisper + lurki-analyze (AI pipeline), lurki-tail (observability), lurki-deck (team prezentace).
$5/měs
social-media-api
Rychlé API pro dashboard — data se cachují v KV, odezva 51ms místo 228ms.
workers/social-media-api/
/api/feed 300s cache
/api/creators 300s cache
/api/stories 120s cache
/api/metrics 300s cache
51ms průměr live
v ceně
scrape-executor upd
Jádro scrapingu — 6 platforem, 16 routes. Start-then-poll Apify. Stories batch mode.
workers/scrape-executor/src/
IG posts + stories + stories-batch nové
FB, YT, TikTok, X, LinkedIn
16 routes → Apify (start-then-poll)
CPU limit 300s, Observability ON
451 testů live
v ceně
social-discovery upd
Automatické hledání profilů — country-aware (CZ/_cz/_czsk), distributor DB lookup, sync + async mód.
workers/social-discovery/src/
Step 0: Distributor DB lookup nové
Firecrawl + Google (country-aware)
AI confidence scoring (0-100)
Sync mode (brand onboarding) live
v ceně
social-ai upd
Embeddings + semantic search — Workers AI (bge-base-en-v1.5, FREE) + Cloudflare Vectorize.
workers/social-ai/src/
POST /embed — single post
POST /batch — batch embed
POST /search — semantic search
Vectorize (768d, cosine) live
v ceně
lurki-backoffice upd
Interní admin dashboard — React 19 + Shadcn/ui + TailwindCSS 4, 32 stránek, CF Worker [assets].
apps/backoffice/
backoffice.lurki.io
Creator/Brand/Profile management
Queue, Costs, Health, Logs, Scraping
32 stránek + testy live
v ceně
lurki-web nové
Landing pages pro 3 domény. i18n (EN/CZ/SK), redirecty (www, .ai), waiting list formulář.
workers/lurki-web/
lurki.io / lurki.cz / lurki.sk
Redirecty: non-www, lurki.ai → www
Waiting list → Supabase DB
Cookie consent + legal pages live
v ceně
lurki-api nové
Veřejné REST API — Hono framework, OpenAPI 3.1, Scalar docs. 18 endpointů, API keys.
workers/lurki-api/
api.lurki.io — 18 endpointů
Scalar interactive docs
Rate limiting + API key auth
92 testů live
v ceně
lurki-mcp nové
MCP Server pro AI agenty — McpAgent + Durable Objects, Streamable HTTP transport.
workers/lurki-mcp/
mcp.lurki.io/mcp — 7 tools
1 resource (profiles)
Durable Objects (session state)
24 testů live
v ceně
lurki-tail nové
Centrální observability — Tail Worker sbírá logy z 6 Workerů, ukládá do R2, Telegram alerty.
workers/lurki-tail/
R2: lurki-tail-logs bucket
Telegram admin alerty (rate 1/min)
Exception + error tracking
6 consumer bindings live
v ceně
lurki-deck nové
Team Deck — 7 HTML prezentací + dashboard (deck.lurki.io). Interní sdílení architektur.
workers/lurki-deck/
7 prezentací (architecture, revenue…)
Dashboard grid s preview live
v ceně
lurki-whisper nové
Groq Whisper transkripce — paralelní zpracování, 5min CPU timeout, 593+ transkriptů.
workers/lurki-whisper/
Groq API (whisper-large-v3-turbo)
Parallel chunk processing
593+ hotových transkriptů live
v ceně
lurki-analyze nové
AI content analýza — paralelní OpenRouter batch, claude-haiku-4.5, 5min CPU timeout.
workers/lurki-analyze/
OpenRouter (claude-haiku-4.5)
Batch mode (~$0.003/post)
Sentiment, topics, hooks live
Data z cache / výsledky scrapingu → Supabase
Orchestrační vrstva — 33 Edge Functions + 30 cron úloh
Co to je: Řídící centrum. 33 Edge Functions zpracovává business logiku — scraping pipeline, media download, AI analýza, notification hub, brand onboarding, video processing, stories batch. ~30 pg_cron úloh běží každých 5–15 minut. Self-healing + circuit breaker v2 (billing-aware).
$25/měs
33 Edge Functions (8 skupin)
Každá funkce má jednu odpovědnost. V supabase/functions/
SCRAPING PIPELINE
NOTIFIKACE (hub)
dispatch-scrape
send-notification
dispatch-stories-batch n
telegram-webhook
scrape-callback
in-app-notifications
download-media
notification-preferences
add-profile
notification-templates
onboard-brand
notification-log
rescrape-post
send-digest
verify-profile
resend-webhook
DATA & API
unsubscribe
get-feed
detect-events
get-stories
AI & PŘEKLADY
metrics-api (14 typů)
analyze-post (batch v3) u
admin-api
analyze-thumbnail
YOUTUBE
translate
yt-channel-setup
auto-translate
yt-rss-monitor
whisper-transcribe
yt-enrich-dispatch
HEALTH & OPS
VIDEO
system-health-check (16 checků) u
download-videos
sync-apify-logs
extract-video-urls
Podporované platformy
6 sociálních sítí — všech 6 live (LinkedIn nestabilní).
Instagram posts + stories + batch live
Facebook příspěvky live
YouTube videa + shorts live
TikTok videa live
X/Twitter příspěvky live
LinkedIn příspěvky nestabilní
Self-Healing v2 upd
Samo-oprava + circuit breaker v2 (billing-aware). Nevině nepauznuje profily při billing erroru.
Zombie detect (20min) + re-queue
Circuit breaker: 5 failů → pause
Billing errory = skip (nepenalizuje) n
Apify API balance check (#16) n
Nečinný systém check (#12) n
YouTube Pipeline
RSS monitoring + obohacování + Whisper transkripce (593 hotových).
yt-channel-setup
yt-rss-monitor každých 6h
yt-enrich-dispatch každých 15m
593 transkriptů (Whisper) live
Tok dat: Jak probíhá stahování příspěvků
Jak to funguje: Každých 15 minut se naplní fronta úloh. Každých 5 minut se úlohy odesílají. Worker spustí Apify (start-then-poll), výsledek se zpracuje, uloží do DB a stáhnou se média na R2. Plně automatické.
Každých 15 min Naplní frontu
Každých 5 min Odešle úlohu
CF Worker Start-then-poll
Externí služba Apify stáhne data
Edge Function Callback + DB
Edge Function Stáhne média
Úložiště Cloudflare R2
Tok dat: Stories Batch Pipeline nové
Co to je: Dedikovaný pipeline pro Instagram Stories. 1 Apify call = 30 profilů (místo 30 single volání). Úspora ~65% Apify costů. Stories expirují za 24h — nesmí soutěžit s posts o queue sloty. Oddělený cron, dispatcher a handler. Škáluje na 1000+ profilů.
Každých 10 min dispatch-stories-batch
RPC get_stories_due (200)
CF Worker Batch 30 profilů
1 Apify call 30 usernames
Routing user.username → profile
Média R2 per profil
Tok dat: AI Pipeline (4 kroky) plně live
Co to dělá: Kompletní AI pipeline od raw obsahu po sémantický search. 1. Whisper transkripce (593 hotových). 2. Auto-translate do CZ/SK (471 přeloženo). 3. AI analýza (claude-haiku-4.5, batch mode, ~$0.003/post). 4. Embeddings (Workers AI FREE) + Vectorize sémantický search.
Nový post Trigger
1. Transkripce Whisper (593)
2. Překlad gemini-flash CZ/SK
3. AI analýza claude-haiku-4.5
4. Embeddings Workers AI (FREE)
Vectorize Semantic search
Knowledge Workspace — Content intelligence (plánované)
Co to bude dělat: Uživatel si ukládá obsah do kolekcí. Nad kolekcí spustí AI chat — „analyzuj tyto posty a navrhni content plán“. Výstup: hotový YouTube script, IG post, LinkedIn post.
plán
Kolekce & knihovna
Kolekce (složky + smart filtry)
Hodnocení + tagy
Multi-format: YT, IG, TikTok, PDF
plán
AI Chat nad kolekcí
„Co mají tyto posty společné?“
„Navrhni content plán“
OpenRouter (Claude / GPT)
plán
Content Plan výstupy
YouTube script + outline
Instagram post / Reel script
Content kalendář
Všechna data → PostgreSQL + R2 + KV + Vectorize
Datová vrstva — 4 typy úložišť
v ceně
PostgreSQL
Hlavní databáze — profily, příspěvky, metriky, fronta, logy. 115 migrací.
26+ aktivních profilů (6 platforem)
4 300+ příspěvků + stories
593 transkriptů
4 materializované pohledy
brand_distributors tabulka n
waiting_list tabulka n
115 migrací live
~$0.04/měs
Cloudflare Vectorize upd
Vektorová DB pro semantic search — bge-base-en-v1.5 (768d, cosine). Nahradilo plánovaný pgvector.
Index: social-content
768 dimenzí, cosine metric
Chunking: 400 tokens, 50 overlap
Eventually consistent (WAL) live
$5–20/měs
Cloudflare R2
Úložiště médií — obrázky, videa, avatary. $0 za stahování.
Náhledy příspěvků
Profilové fotky (avatary)
Stories média
Stažená videa
lurki-tail-logs n
5 bucketů live
v ceně
Cloudflare KV
Cache — 11 endpointů, 4× rychlejší než DB.
11 cachovaných endpointů
Platnost: 2–15 minut
Z cache: 51ms
Z databáze: 228ms live
Externí služby
Externí služby
~$217/měs (Scale)
Apify — 6 platforem + transkripty upd
Scale plan ($2,600/rok). Start-then-poll. Billing monitoring + alert (check #16). Budget $40/den, $200/měs.
IG posts + stories + batch live
Facebook live
YouTube + transkripty live
TikTok live
X/Twitter live
LinkedIn nestabilní
API balance check (health #16) n
dle použití
Firecrawl + OpenRouter
Firecrawl = web discovery. OpenRouter = AI (gemini-flash, claude-haiku-4.5).
Auto-discovery (country-aware) live
Brand enrichment + confidence live
AI analýza (claude-haiku-4.5) live
Auto-translate (gemini-flash) live
free tier
Resend (e-mail) upd
Transakční i marketingové e-maily. Split from adres: noreply@ vs hello@.
noreply@mail.lurki.io (transakční)
hello@mail.lurki.io/cz/sk (marketing)
Waitlist welcome email n
Webhook tracking live
Systém plánování — kdy a jak často stahovat
Dvoupruhová fronta + Stories batch
Posts/profile → generic queue (2-pruhová). Stories → dedikovaný batch pipeline (oddělený).
Běžný pruh: 2 sloty (pravidelné stahy)
Doplňovací pruh: 1/2 sloty (den/noc)
Stories batch: oddělený pipeline (*/10) n
Noční boost: 22:00–06:00 CET
Zaseknutá úloha: auto-reset po 20 min
Rozpočet: $40/den, $200/měsíc u
Smart Scheduling upd
Automatické intervaly dle frekvence příspěvků. Širší intervaly pro neaktivní (úspora costů).
Frekvence
Interval
Profilů
multiple_daily
6h
1
daily
12h
3
weekly
48h
9
sporadic
168h (7d)
6
inactive
720h (30d)
7
Per-profile cost tracking (trigger) n
Monthly cost reset (1. v měsíci)
Notification Hub — 3 kanály live
Telegram Bot (přímý) live
Přímý Telegram Bot API. 2 boty: @lurki_app_bot (uživatelé) + @lurki_admin_bot (ops).
16 health checků (česky) u
Budget + billing alerty (1h cooldown)
Ranní report (8:00 CET)
Nový obsah / virální post
E-mail (Resend) live
Waitlist welcome email n
Onboarding sekvence
Týdenní digest
Webhook tracking + unsubscribe
Detect Events + In-App live
Nová data → alert
Virální post detekce
Self-healing eskalace
Notification templates + preferences
Událost detect-events
Routování send-notification
Telegram Bot API
+
E-mail Resend
+
In-App Dashboard UI
Záznam notification-log
Měsíční náklady na provoz
Vše běží na serverless — žádné vlastní servery, platíme jen za skutečné použití
$25 Supabase
+
$5 Workers
+
$5–20 R2
+
~$217 Apify (Scale)
+
$5–30 AI/LLM
+
$0 Resend
=
~$260–300/měs

Lurki — 12 Workerů • 33 Edge Funkcí • ~30 Cron Úloh • 115 Migrací • 6 Platforem • 543 Testů • 32 Backoffice str. • API + MCP • Únor 2026