CZECHAI MASTER PLAN — Absolutni spicka

1. MCP FILESYSTEM — GAMECHANGER

Co to je

MCP (Model Context Protocol) filesystem dava KAZDEMU agentovi pristup k souborum, databazim, API — standardizovane. Misto toho aby kazdy agent mel hardcoded HTTP cally, MCP rika: - Agent se zepta "potrebuju data o nemovitosti" - MCP router najde spravny zdroj (DB, API, soubor) - Vrati data v unifikovane podobe

Co to zmeni

BEZ MCP: Kazdy agent ma svuj kod, sve endpointy, kdyz spadne nikdo nevi. S MCP: Jeden orchestrator, jedna mapa vsech zdroju, kazdy agent vola pres MCP.

Co uz bezi (ale nikdo to nepropojil)

mcp-filesystem (9012) — pristup k souborum
mcp-memory (9011) — perzistentni pamet
mcp-postgres-contacts (9010) — kontakty z DB
mcp-redis (9015) — cache
mcp-server (8091) — hlavni MCP server
mcp-orchestrator (9350) — orchestrace
czechai-mcp-adapter (5055) — 14 MCP sluzeb (finance, AML, registry)
czechai-re-mcp (9200) — real estate MCP

VSECHNO BEZI. Nikdo to nepropojil do agentu.

2. HIERARCHIE SLUZEB — OD ZAKLADU PO SPICKU

VRSTVA 0: INFRASTRUKTURA (musi bezet vzdycky)

Sluzba	Server	Port	Status	Ucel
router-api	179	8090	OK	Gateway — vsechno pres nej
rag-api	179	8095	OK	Knowledge base 2591 docs
redis	179	6379	OK	Cache
qdrant	117	6333	OK	Vector DB
meilisearch	179	7700	OK	Full-text search
tile38	179	9851	OK	Geo DB
uptime-kuma	179	3099	OK	Monitoring (ale nemonitoruje!)
pm2-prometheus	179	9209	OK	Metriky
node-exporter	179	9110	OK	System metriky

VRSTVA 1: DATA ENGINES (jadro ocenovani)

Sluzba	Server	Port	Status	Co dela	Vystup
cenova-mapa-v15	179	5150	OK	363K zaznamu, R2=0.878	Odhad ceny
super-ensemble-v2	179	5111	OK	7 enginu + korekce	Konsenzualni odhad
ocenovac-api	179	5300	OK	GPS/KNN 145K, 31ms	Odhad z GPS
valuo2-vynosovy	179	6002	OK	Vynosova metoda	Yield, cap rate
znalecky-panel	179	5112	OK	3 AI znalci qwen3:32b	Znalecky posudek
v15f-api	179	5310	OK	V15 filtry	Filtrovane odhady
market-intel	179	5400	OK	Trendy, absorpce	Trzni analyza

VRSTVA 2: DATA PIPELINE (scraping + enrichment)

Sluzba	Server	Port	Status	Co dela	Vystup
reality-pipeline	134	9110	OK	209K zaznamu, 22-step	MASTER_LIVE.db
scraping-data-plane	134	5100	OK	Warm pools, 3 mody	Raw data
scout-agent	134	5555	OK	AI crawl portalu	Portal analyza
enrichment-batch	134	5430	OK	Batch enrichment	Obohacena data
bazos-api	134	5212	OK	Bazos scraper	Inzeraty
idnes-api	134	5213	OK	iDNES scraper	Inzeraty
drazby-mega	134	9112	OK	Drazby scraper	Exekucni drazby
mega-price-v7	134	5127	OK	Price engine	Cenove odhady
signal-api	134	5201	OK	Signaly	Alerty

VRSTVA 3: DUE DILIGENCE

Sluzba	Server	Port	Status	Co dela	Vystup
aml-api	179	8093	OK	18 modulu, 1.58M sanctions	PASS/FAIL screening
pravnik-25	179	5710	OK	25-step legal pipeline	Pravni analyza
cuzk-api	179	5251	OK	Katastr CUZK	LV, vlastnici
fraud-guard	179	5101	OK	Fraud detection	Risk score
osint-api	179	5232	PARTIAL	OSINT investigace	Dossier
dd-agent	179	5291	OK	Due diligence	DD report
czechai-hlidac-statu	179	5066	OK	Verejne zakazky	Kontrakty

VRSTVA 4: INTELIGENTNI AGENTI

Sluzba	Server	Port	Status	Co dela	Vystup
hunter-agent	179	5800	OK	Lead hunting	Nalezene leady
leady-ai-agent	179	5005	OK	AI kvalifikace leadu	Kvalifikovane leady
deep-research-agent	179	5199	PARTIAL	Hloubkovy vyzkum	Research report
analyze-api	179	5660	PARTIAL	Analyticka API	Analyza
strands-gpu-agent	179	5281	OK	AWS Strands GPU	AI vystupy
dexter-research	179	5283	PARTIAL	Research	Research

VRSTVA 5: DOCKER AGENT SWARMY (14x healthy)

Sluzba	Port	Status	Kategorie
czechai-real-estate-agents	9102	HEALTHY	Reality
czechai-cenova-mapa	9094/9150/9300	HEALTHY	Ocenovani
czechai-aml-agents	9106	HEALTHY	AML
czechai-banking-agents	9100	HEALTHY	Finance
czechai-legal-agents	9107	HEALTHY	Legal
czechai-compliance-agents	9104	HEALTHY	Compliance
czechai-risk-management-agents	9105	HEALTHY	Risk
czechai-contact-agents	9109	HEALTHY	Kontakty
czechai-data-agents	9108	HEALTHY	Data
czechai-insurance-agents	9103	HEALTHY	Pojisteni
czechai-public-data-agents	9114	HEALTHY	Verejne data
czechai-general-agents	9115	HEALTHY	General
czechai-artifact-agents	9113	HEALTHY	Artefakty
czechai-unified-gateway	-	HEALTHY	Gateway

VRSTVA 6: LANGGRAPH SWARMY (14 swarmu)

Swarm	Endpoint	Agenti	Kategorie
Valuation	/swarm/valuation	price_estimator, market_analyst, comparator	Reality
Reality	/swarm/reality	searcher, filter, presenter	Reality
Banking	/swarm/banking	credit_scorer, loan_advisor, risk_assessor	Finance
Leady	/swarm/leady	router, qualifier, enricher	Sales
Pravni	/swarm/pravni	legal_researcher, contract_analyst	Legal
Zivnostnici	/swarm/zivnostnici	tax_advisor, invoice_helper	Business
Pojisteni	/swarm/pojisteni	risk_assessor, comparator, advisor	Insurance
Reality Intelligence	/swarm/reality-intelligence	market_analyst, trend_detector	Reality
Realitky	/swarm/realitky	listing_optimizer, client_matcher	Reality
ByznysPapa	/swarm/byznyspapa	?	Business
AML	/swarm/aml	?	Compliance
Watchdog	/swarm/watchdog	W01-W04 verifikace cen	Reality
Spion Detektiv	/swarm/spy-detective	extractor (DeepPavlov), investigator	Intelligence
DeepResearchBeast	/swarm/deep-research-beast	planner, researcher (Tongyi 30B)	Research

VRSTVA 7: FRONTEND & REPORTING

Sluzba	Server	Port	Status	Co dela
chat-frontend	179	3002	OK	chat.czechai.io (4x cluster)
aurum-entity	179	3400	OK	entity.czechai.io
swarms-entity	179	3401	OK	25 Swarms agentu, Claude 4.6
leads-dashboard	179	3030	OK	Leady dashboard
property-report	179	5280	OK	Nemovitostni reporty
posudek-pdf	179	5650	PARTIAL	PDF posudky
czechai-kalkulacky	179	5075	OK	Financni kalkulacky
gradio-demos	179	STOPPED	6 demo zalozek	SPUSTIT!
booking-calendar	179	5320	OK	Rezervace
kokoro-tts	179	5225	OK	TTS 54 hlasu

VRSTVA 8: MCP VRSTVA (propojeni)

Sluzba	Port	Status	Co dela
mcp-server	8091	OK	Hlavni MCP
mcp-orchestrator	9350	OK	Orchestrace
mcp-filesystem	9012	OK	Soubory
mcp-memory	9011	OK	Pamet
mcp-postgres-contacts	9010	OK	Kontakty
mcp-redis	9015	OK	Cache
czechai-mcp-adapter	5055	OK	14 financnich MCP
czechai-re-mcp	9200	OK	Real estate MCP

3. TOP SLUZBY — BILY PAPIR

LOVEC (Lead Hunter + Reaper)

Polozka	Hodnota
Sluzba	hunter-agent + LeadReaper + leady-ai-agent
Porty	5800 + 9110 + 5005
Sleduje	uptime-kuma (PRIDAT!)
Orchestruje	swarms-entity (master agent)
Vyuziva	reality-pipeline, super-ensemble, market-intel
Vstup	"Najdi podhodnocene byty Praha >20% discount"
Vystup	Seznam prilezitosti s cenou, odhadem, ROI, kontaktem
Status	FUNKCNI — propojit do Swarms

ZNALEC (Valuation + Znalecky Panel)

Polozka	Hodnota
Sluzba	super-ensemble-v2 + znalecky-panel + cenova-mapa-v15 + ocenovac-api + valuo2-vynosovy
Porty	5111 + 5112 + 5150 + 5300 + 6002
Sleduje	uptime-kuma (PRIDAT!)
Orchestruje	swarms-entity (valuation agent)
Vyuziva	7 enginu, 363K zaznamu, 3 AI znalci
Vstup	"Ocen byt 2+kk Praha Karlin 55m2"
Vystup	Konsenzualni odhad, rozptyl, znalecky posudek
Status	FUNKCNI

STRAZCE (AML + Compliance + Fraud)

Polozka	Hodnota
Sluzba	aml-api + fraud-guard + czechai-compliance-agents + sanctions
Porty	8093 + 5101 + 9104
Sleduje	aml-health-monitor (UZ BEZI)
Orchestruje	swarms-entity (aml agent)
Vyuziva	1.58M sanctions, ARES, ISIR, PEP, exekuce
Vstup	"Prover Jana Novaka, nar. 1985"
Vystup	PASS/FAIL + rizikove skore + detailni report
Status	FUNKCNI

PRAVNIK (Legal Pipeline)

Polozka	Hodnota
Sluzba	pravnik-25 + cuzk-api + czechai-legal-agents + czech-legal-ai
Porty	5710 + 5251 + 9107 + 3000
Sleduje	uptime-kuma (PRIDAT!)
Orchestruje	swarms-entity (pravnik agent) + LangGraph pravni swarm
Vyuziva	25-step pipeline, katastr, zakony
Vstup	"Analyzuj LV 1234 pro KU Praha"
Vystup	Pravni analyza, zastavy, bremena, rizika
Status	FUNKCNI

VYZKUMNIK (Deep Research + OSINT)

Polozka	Hodnota
Sluzba	deep-research-agent + osint-api + dexter-research + DeepResearchBeast swarm + Spion Detektiv swarm
Porty	5199 + 5232 + 5283 + LangGraph
Sleduje	uptime-kuma (PRIDAT!)
Orchestruje	swarms-entity (deep-researcher + osint agents)
Vyuziva	Tongyi 30B, DeepPavlov NER, web search, ARES
Vstup	"Zjisti vse o firme XY a jejim majiteli"
Vystup	Strukturovany dossier, vlastnicke retezce, rizika
Status	CASTECNE — propojit swarmy

BANKIR (Finance + Hypo)

Polozka	Hodnota
Sluzba	czechai-banking-agents + Banking Swarm + czechai-kalkulacky
Porty	9100 + LangGraph + 5075
Sleduje	uptime-kuma (PRIDAT!)
Orchestruje	swarms-entity (banking + quant agents)
Vyuziva	Credit scoring, hypo kalkulacka, investicni analyza
Vstup	"Hypoteka 5M, vlastni 1.5M, prijem 80K"
Vystup	Porovnani bank, splatky, LTV, DSTI, doporuceni
Status	FUNKCNI

SCRAPER (Data Pipeline)

Polozka	Hodnota
Sluzba	reality-pipeline + scraping-data-plane + scout-agent + enrichment + portaly
Porty	9110 + 5100 + 5555 + 5430 + 5212 + 5213
Server	134 (scrapper)
Sleduje	uptime-kuma (PRIDAT!)
Orchestruje	mega_fabric_scraper.py (184 portalu)
Vyuziva	Crawl4AI, Playwright, httpx, warm pools
Vstup	Automaticky cyklus 22 kroku
Vystup	MASTER_LIVE.db — 209K zaznamu
Status	FUNKCNI

KONTAKTAR (Registry + Leady)

Polozka	Hodnota
Sluzba	registry-map + leady-ai-agent + Leady Swarm + czechai-contact-agents + mcp-postgres-contacts
Porty	5500 + 5005 + LangGraph + 9109 + 9010
Sleduje	uptime-kuma (PRIDAT!)
Orchestruje	swarms-entity (leady agent)
Vyuziva	1.15M kontaktu, ARES, kvalifikace
Vstup	"Najdi SVJ v Praze 3 s telefonem"
Vystup	Kvalifikovane kontakty s enrichment
Status	FUNKCNI

GEO ANALYTIK (Geo Intelligence)

Polozka	Hodnota
Sluzba	geo-api + geointel-api + tile38 + GIS MCP
Porty	5250 + 5290 + 9851 + MCP
Sleduje	uptime-kuma (PRIDAT!)
Orchestruje	swarms-entity (novy geo agent)
Vyuziva	Overture Maps, RUIAN, OSM, IPR Praha, Golemio
Vstup	"Analyza lokality Praha Karlin — dostupnost, rizika"
Vystup	Geo skore, povodnove riziko, obcanska vybavenost
Status	STOPPED — SPUSTIT geo-api + geointel-api!

REPORTER (Vystupy)

Polozka	Hodnota
Sluzba	report-generator + property-report + posudek-pdf + gradio-demos
Porty	router + 5280 + 5650 + 5077
Sleduje	uptime-kuma (PRIDAT!)
Orchestruje	swarms-entity (report agent)
Vyuziva	HTML generator, PDF, Gradio UI
Vstup	Data z jinych agentu
Vystup	HTML report s URL, PDF posudek, demo UI
Status	CASTECNE — spustit gradio-demos!

4. CO SPUSTIT (v poradi priority)

OKAMZITE (5 minut)

pm2 restart geo-api — port 5250, geo intelligence
pm2 restart geointel-api — port 5290, unified geo
pm2 restart gradio-demos — port 5077, demo pro klienty
pm2 restart czechai-qr-platby — QR platby
pm2 restart pandasai-query — port 5076, SQL dotazy cesky
pm2 restart spacy-czech — port 5078, NLP extrakce

PRIDAT DO SWARMS (tool wrappery)

geo-api (5250) — geocode, nearby, lokacni skore
geointel-api (5290) — unified geo + SE2
cuzk-api (5251) — katastr, uz bezi!
dd-agent (5291) — due diligence, uz bezi!
fraud-guard (5101) — fraud detection, uz bezi!
hunter-agent (5800) — lead hunting, uz bezi!
leady-ai-agent (5005) — AI leady, uz bezi!
osint-api (5232) — OSINT, uz bezi!
posudek-pdf (5650) — PDF posudky, uz bezi!
property-report (5280) — nemovitostni reporty, uz bezi!
deep-research-agent (5199) — hloubkovy vyzkum, uz bezi!
analyze-api (5660) — analyza, uz bezi!
booking-calendar (5320) — rezervace, uz bezi!
czechai-hlidac-statu (5066) — verejne zakazky, uz bezi!

NESPOUSTET (smazat nebo ignorovat)

czech-real-estate — nahrazeno V15
dorothy — prazdne
g4f-api — zastarale
czechai-realitka — nejasne
enrichment-agent — nahrazeno enrich-v5
perfect-map-v13 — ZAKAZANO
litellm-proxy — 1055 restartu, mrtvy
rag-proxy — zombie
test-cockpit — zombie
claude-worker, claude-desktop-worker — zastavene
gpt-worker — zastavene

OPRAVIT

pandasai-query (5076) — STOPPED, dulezite pro data-analyst
spacy-czech (5078) — STOPPED, dulezite pro NLP
novu-mongodb — RESTARTING (notifikace nefunguji)
docker-worker (Dify) — RESTARTING

5. MONITORING — UPTIME KUMA

Pridat do Uptime Kuma (uz bezi na 3099) monitoring VSECH klicovych sluzeb: - Vsechny porty z Vrstvy 1-7 - Alert pres Telegram/Discord/Email - Kontrola kazdych 60s - Stav: https://router.czechai.io/status/

6. CELKOVE CISLA PO REALIZACI

Metrika	Ted	Po realizaci
Funkcnich agentu ve Swarms	25 (10 s realnym backend)	25 (20+ s realnym backend)
Tool wrapperu	33	50+
Monitorovanych sluzeb	~5	50+
Alert kanaly	0	Telegram + Email
Zastavene sluzby k spusteni	6	0
Zombie procesy	3	0