KOMPLETNÍ SYSTÉM PRO 10 SLUŽEB CZECHAI

Datum: 2026-01-17 Status: DESIGN & IMPLEMENTATION PLAN

🎯 PŘEHLED 10 SLUŽEB

#	Služba	Databáze	API Endpoint	Frontend	Status
01	LEADY	PostgreSQL	`/api/leads`	leads.czechai.io	✅ LIVE
02	ŽIVNOSTNÍCI	SQLite	`/api/zivnostnici`	TBD	❌ TODO
03	POJIŠTĚNÍ	-	`/api/pojisteni`	TBD	❌ TODO
04	OBECNÉ	-	`/api/obecne`	TBD	❌ TODO
05	REALITNÍ INTELIGENCE	SQLite	`/api/reality`	TBD	🟡 PARTIAL
06	PRÁVNÍ & CORPORATE	-	`/api/pravni`	law.czechai.io	🟡 PARTIAL
07	REALITNÍ KANCELÁŘE	-	`/api/kancelare`	TBD	❌ TODO
08	BANKOVNICTVÍ	-	`/api/banking`	TBD	❌ TODO
09	AUTOMATIZACE	-	n8n workflows	n8n.czechai.io	🟡 PARTIAL
10	FIRMY	PostgreSQL	`/api/firmy`	TBD	🟡 PARTIAL

📊 01. LEADY - Kompletní systém

Co je to

Poptávkový formulář pro generování leadů z podhodnocených nemovitostí a propojování kontaktů.

Databáze

PostgreSQL (Directus - bi.czechai.io)
Tabulka: leady (39,000+ záznamů)
Sloupce: email, phone, message, service_type, created_at, ip_address

API Endpoints

POST /api/leads/submit          # Odeslat nový lead
GET  /api/leads/list            # Seznam leadů (admin)
GET  /api/leads/stats           # Statistiky leadů
POST /api/leads/process         # Zpracovat lead (AI)

AI Agent

Cesta: /opt/leady-ai-agent/
Port: 5005
URL: https://leads.czechai.io/agent/
Funkce:
Extrakce parametrů z inzerátů (GPT-4)
Tržní odhad nemovitosti
Podhodnocení štítky (D10/D15/D20/D30)
Riziková analýza
Doporučení služeb (FIN_HYP15, VAL_TRH...)

Frontend

URL: https://leads.czechai.io
Port: 3030 (PM2)
Tech: Node.js + Express
Features:
2 hlavní produkty (Propojování + Podhodnocené nemovitosti)
10 dalších typů leadů v gridu
Email notifikace (nodemailer)

Workflow

User odešle formulář → Frontend POST na backend
Backend uloží do DB → PostgreSQL (Directus)
Email notifikace → info@bohemiashield.cz, info@czechai.io
AI zpracování (optional) → Agent analyzuje URL/text
CRM import → Export do Twenty CRM

Status: ✅ PLNĚ FUNKČNÍ

🏢 02. ŽIVNOSTNÍCI - Kompletní systém

Co je to

Databáze 2.8M+ živnostníků s kontakty pro B2B prodej, marketing a propojování.

Databáze

SQLite: /opt/contacts/db/MASTER_CONTACTS.db
Záznamy: 2,819,063 osob
Sloupce: jmeno, prijmeni, telefon, email, zivnost, ico, adresa, mesto

API Endpoints (VYTVOŘIT)

GET  /api/zivnostnici/search    # Vyhledávání (jméno, město, obor)
GET  /api/zivnostnici/:id       # Detail živnostníka
POST /api/zivnostnici/export    # Export do CSV/Excel
GET  /api/zivnostnici/stats     # Statistiky (počty podle oborů)

AI Features (IMPLEMENTOVAT)

Scoring živnostníků:
Lead score (pravděpodobnost zájmu)
Bonita (finanční zdraví)
Activity score (aktivita v byznysu)
Segmentace:
Podle oboru (stavebnictví, IT, gastronomie...)
Podle velikosti (OSVČ, 1-10 zaměstnanců...)
Podle lokace (Praha, Brno, Liberec...)

Frontend (VYTVOŘIT)

URL: https://zivnostnici.czechai.io
Tech: React + Tailwind
Features:
Vyhledávání živnostníků
Filtry (obor, město, IČO)
Bulk export
Lead scoring vizualizace

Workflow

User hledá živnostníky → Frontend vyhledávání
API vrací výsledky → Filtrované + scored
Export do CRM → Twenty CRM nebo CSV
Email kampaň → n8n workflow

Status: ❌ TODO

Priority: HIGH (máme data, chybí jen API + frontend)

🏥 03. POJIŠTĚNÍ - Kompletní systém

Co je to

Porovnání pojišťoven, optimalizace pojistek, lead generation pro pojišťovací agenty.

Databáze (VYTVOŘIT)

PostgreSQL tabulka: pojisteni_leads
Sloupce: typ_pojistky, mesicni_platba, pojistovna_aktualni, kontakt, created_at

API Endpoints (VYTVOŘIT)

POST /api/pojisteni/calculate   # Kalkulátor pojistky
GET  /api/pojisteni/compare     # Porovnání pojišťoven
POST /api/pojisteni/lead        # Odeslat poptávku
GET  /api/pojisteni/agents      # Seznam agentů

AI Features

Optimalizace pojistek:
GPT-4 analyzuje aktuální pojistky
Doporučí levnější alternativy
Vypočítá úspory
Risk assessment:
Hodnocení rizika klienta
Doporučená výše pojistného
Chybějící pojistky

Frontend (VYTVOŘIT)

URL: https://pojisteni.czechai.io
Features:
Kalkulátor pojistek
Porovnání pojišťoven (tabulka)
Lead formulář
AI asistent pro optimalizaci

Workflow

User vyplní kalkulátor → Typ pojistky, aktuální platba
AI analyzuje → Porovná trh, najde úspory
Zobrazí nabídky → Top 3 pojišťovny
Lead generation → Odeslat poptávku agentům
CRM → Uložit do Twenty CRM

Status: ❌ TODO

Priority: MEDIUM

📋 04. OBECNÉ - Kompletní systém

Co je to

Obecné služby - AI asistent, chatbot, konzultace, one-time projekty.

Databáze

PostgreSQL: obecne_requests
Sloupce: typ_sluzby, popis, budget, deadline, kontakt

API Endpoints (VYTVOŘIT)

POST /api/obecne/request        # Odeslat požadavek
GET  /api/obecne/services       # Seznam služeb
GET  /api/obecne/pricing        # Ceník
POST /api/obecne/estimate       # Odhad ceny projektu

AI Features

Automatický odhad:
GPT-4 čte popis projektu
Odhadne čas (hodiny)
Vypočítá cenu
Doporučí tým/nástroje
Smart routing:
Podle typu úkolu přiřadí správný tým
Propojí s podobnými projekty

Frontend (VYTVOŘIT)

URL: https://obecne.czechai.io nebo https://konzultace.czechai.io
Features:
Formulář pro popis projektu
AI odhad ceny v real-time
Seznam služeb (AI development, automation, consulting)
Booking systému na konzultace

Workflow

User popíše projekt → Text area
AI odhadne → Čas, cena, složitost
Zobrazí estimate → "Projekt bude stát cca 50-80k Kč"
Lead → Odeslat do CRM
Follow-up → Email s detaily

Status: ❌ TODO

Priority: LOW

🏘️ 05. REALITNÍ INTELIGENCE - Kompletní systém

Co je to

AI analýza reality trhu - podhodnocené nemovitosti, tržní odhady, investiční příležitosti.

Databáze

SQLite: /opt/czechai-cockpit-full/stat_realit.db (13,585)
SQLite: D:/CZECHAI_REALITY_MASTER/PRODUCTION/00_PUBLIC_DATA/excel/ULTIMATE_MASTER.db (98,191)
Sloupce: url, title, price, area, city, gps_lat, gps_lon, lead_score

API Endpoints (ROZŠÍŘIT)

GET  /api/reality/search        # Vyhledávání (město, cena, m²)
GET  /api/reality/undervalued   # Podhodnocené (discount > 15%)
POST /api/reality/estimate      # AI odhad ceny
GET  /api/reality/market        # Tržní analýza (město)
POST /api/reality/scrape        # Re-scrape URL

AI Features (DOKONČIT)

Price estimation (4 modely):
✅ Cenová mapa (Kč/m² × area)
❌ Valuo.cz API
❌ Sreality statistika
❌ CzechAI trained model
Lead scoring:
Discount % (market price vs asking)
Investment potential
Riziková analýza
Market intelligence:
Trend analýza (rostoucí/klesající trhy)
Hotspots (kde nejvíc roste)
Predikce cen (next 6-12 měsíců)

Frontend (VYTVOŘIT)

URL: https://reality.czechai.io
Features:
Vyhledávání nemovitostí
Mapa s pins (GPS)
AI odhad ceny (input URL → output price)
Top podhodnocené (tabulka)
Market dashboard (grafy, trendy)

Workflow

Scraping:
n8n workflow každou noc
Scrape 1000+ nových URL
Uložit do ULTIMATE_MASTER.db
Price estimation:
Spustit 4 AI modely
Vypočítat discount %
Assignovat lead_score
User hledá:
Frontend search → API
Zobrazit top podhodnocené
Možnost exportu
Lead generation:
User klikne "Mám zájem"
Uložit do CRM
Email realitní agentuře

Status: 🟡 PARTIAL (máme data, chybí AI modely + frontend)

Priority: HIGH

⚖️ 06. PRÁVNÍ & CORPORATE - Kompletní systém

Co je to

AI právník, corporate služby, smlouvy, zakladání firem, AML screening.

Databáze

Současné: czech-legal-ai (port 3000)
Nové: PostgreSQL tabulka pravni_requests

API Endpoints

POST /api/pravni/chat           # AI právník chatbot
POST /api/pravni/smlouva        # Generovat smlouvu (GPT-4)
POST /api/pravni/aml            # AML screening (osoba/firma)
POST /api/pravni/zalozeni       # Založení s.r.o./OSVČ
GET  /api/pravni/templates      # Šablony smluv

AI Features

✅ AML Screening:
18 modulů (sanctions, insolvency, PEP...)
3.6M záznamů
Port 8093
https://router.czechai.io:8093/api/aml/screen/complete
❌ AI právník:
GPT-4 + RAG (české právo)
Odpovídá na právní otázky
Generuje smlouvy
❌ Corporate services:
Založení firmy (s.r.o., OSVČ)
Změny v obchodním rejstříku
Smlouvy (zaměstnanec, dodavatel, NDA...)

Frontend

Současný: https://law.czechai.io (port 3000)
Rozšířit o:
AML Quick Search (už existuje na /web/aml-quick.html)
Generátor smluv (formulář → GPT-4 → PDF)
Corporate services (wizard pro založení firmy)

Workflow

User ptá se AI právníka:
Chat interface → GPT-4 + RAG
Vrací právní odpověď + odkazy na zákony
AML screening:
User zadá jméno/IČO
API volání na 18 modulů
Zobrazí report (risk score, firmy, varování)
Generování smlouvy:
User vyplní formulář (typ, strany, podmínky)
GPT-4 vygeneruje smlouvu
PDF download
Založení firmy:
Wizard (název, společníci, předmět podnikání)
Generuje dokumenty
Pomoc s podáním na rejstřík

Status: 🟡 PARTIAL (AML ✅, AI právník ❌, Corporate ❌)

Priority: HIGH

🏢 07. REALITNÍ KANCELÁŘE - Kompletní systém

Co je to

CRM pro realitní kanceláře, správa inzerátů, automatizace, lead management.

Databáze

PostgreSQL: kancelare_clients, kancelare_properties, kancelare_leads
Twenty CRM (už existuje - crm.czechai.io)

API Endpoints (VYTVOŘIT)

POST /api/kancelare/property    # Přidat nemovitost
GET  /api/kancelare/properties  # Seznam nemovitostí
POST /api/kancelare/lead        # Přidat lead
GET  /api/kancelare/leads       # Lead management
POST /api/kancelare/matching    # Matching (lead ↔ property)

AI Features

Automatické matching:
Lead hledá: byt 2+1, Praha, do 5M
AI najde matching nemovitosti v portfoliu
Email notification
Price recommendations:
AI doporučí optimální cenu inzerátu
Porovná s trhem
Lead scoring:
Pravděpodobnost uzavření
Budget confidence
Timeline urgency

Frontend (VYTVOŘIT)

URL: https://kancelare.czechai.io
Tech: React dashboard
Features:
Property management (CRUD)
Lead management (pipeline)
Matching engine (drag & drop)
Automatizace (email campaigns)
Reporting (prodeje, konverze)

Workflow

Realitka přidá nemovitost:
Formulář (adresa, cena, m², fotos)
AI doporučí cenu
Uložit do DB
Lead přijde:
Z formuláře nebo manuálně
AI matching → najde podobné properties
Email agentovi
Agent kontaktuje:
Email/telefon
Sledování v CRM (pipeline)
Uzavření:
Prodáno → stats
Commission tracking

Status: ❌ TODO

Priority: MEDIUM (můžeme použít Twenty CRM)

🏦 08. BANKOVNICTVÍ - Kompletní systém

Co je to

Porovnání hypoték, úvěrů, AI asistent pro finanční produkty.

Databáze (VYTVOŘIT)

PostgreSQL: banking_leads, banking_products
Sloupce products: banka, typ_produktu, urok, splatnost, podmínky

API Endpoints (VYTVOŘIT)

POST /api/banking/hypoteka      # Kalkulátor hypotéky
POST /api/banking/uver          # Kalkulátor úvěru
GET  /api/banking/compare       # Porovnání bank
POST /api/banking/lead          # Lead generation
POST /api/banking/scoring       # Credit scoring (AI)

AI Features

Hypoteční kalkulátor:
Input: cena nemovitosti, vlastní kapitál, příjem
AI doporučí: výše úvěru, měsíční splátka, nejvýhodnější banky
Credit scoring:
Analýza bonity klienta
Pravděpodobnost schválení
Doporučené produkty
Porovnání produktů:
AI najde nejlevnější úvěr/hypotéku
Vypočítá celkové náklady
Upozorní na skryté poplatky

Frontend (VYTVOŘIT)

URL: https://banking.czechai.io nebo https://hypoteky.czechai.io
Features:
Kalkulátor hypotéky (slider, inputs)
Porovnání bank (tabulka)
AI asistent (chat)
Lead formulář

Workflow

User kalkuluje hypotéku:
Vyplní: cena, kapitál, příjem
AI vypočítá: splátka, úrok, schůdnost
Porovnání:
API vrací top 3 banky
Seřazené podle RPSN
Lead:
User klikne "Mám zájem"
Odeslat do bank/brokerům
Follow-up:
Email s nabídkami
Tracking v CRM

Status: ❌ TODO

Priority: MEDIUM

🤖 09. AUTOMATIZACE - Kompletní systém

Co je to

Workflow automation, n8n services, custom integrations.

Platforma

✅ n8n: https://n8n.czechai.io (port 5678)
API Key: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...
Workflows: Context Sync (každých 30 min)

API Endpoints

GET  /api/n8n/workflows         # Seznam workflows
POST /api/n8n/execute/:id       # Spustit workflow
GET  /api/n8n/executions        # Historie spuštění
POST /api/automation/custom     # Custom automation request

Pre-built Workflows (VYTVOŘIT)

Email campaigns:
Segmentace kontaktů
Personalizované emaily
A/B testování
Lead routing:
Lead přijde → AI scoring → route to sales
Data sync:
DB → CRM → Email → Slack
Scraping automation:
Scheduled scraping (sreality, reality.cz...)
Deduplikace
Price monitoring
Reporting:
Denní/týdenní reporty
Export do Google Sheets
Email notifikace

Frontend (VYTVOŘIT)

URL: https://automation.czechai.io
Features:
Marketplace pre-built workflows
Custom automation builder (no-code)
Monitoring dashboard
Execution logs

Workflow

User vybere workflow:
Z marketplace nebo custom
Konfigurace:
Parametry (DB, API keys, trigger)
Aktivace:
n8n webhook/schedule
Monitoring:
Dashboard zobrazuje executions
Alerts při chybách

Status: 🟡 PARTIAL (n8n ✅, marketplace ❌, frontend ❌)

Priority: MEDIUM

🏢 10. FIRMY - Kompletní systém

Co je to

Databáze 3.5M+ firem, B2B lead generation, company intelligence.

Databáze

SQLite: /opt/contacts/firemni/companies_master.db (3,482,845 firem)
Sloupce: ico, nazev, pravni_forma, sídlo, obor, pocet_zamestnancu, trzby

API Endpoints (VYTVOŘIT)

GET  /api/firmy/search          # Vyhledávání (název, IČO, obor)
GET  /api/firmy/:ico            # Detail firmy
POST /api/firmy/export          # Export do CSV
GET  /api/firmy/stats           # Statistiky (top obory)
POST /api/firmy/scoring         # B2B lead scoring
GET  /api/firmy/similar         # Podobné firmy

AI Features

Company scoring:
Finanční zdraví (tržby, zisk, závazky)
Growth potential (růst tržeb YoY)
B2B lead score (pravděpodobnost nákupu)
Segmentace:
Podle velikosti (mikro, malé, střední, velké)
Podle oboru (IT, stavebnictví, obchod...)
Podle lokace
Intelligence:
Konkurenční analýza
Market positioning
Supplier/customer mapping

Frontend (VYTVOŘIT)

URL: https://firmy.czechai.io
Features:
Vyhledávání firem
Filtry (obor, velikost, město)
Company detail (financials, contacts, history)
Bulk export
Lead scoring vizualizace

Workflow

User hledá firmy:
Vyhledávání podle kritérií
AI scoring → top leady
Detail firmy:
Zobrazit IČO, adresu, financials
Kontakty (management, emails)
Podobné firmy
Export:
Bulk export do CSV/Excel
Import do CRM (Twenty)
Outreach:
Email kampaň (n8n)
Tracking responses

Status: 🟡 PARTIAL (máme data, chybí API + frontend)

Priority: HIGH

🚀 IMPLEMENTAČNÍ PLÁN - PRIORITY

FÁZE 1: QUICK WINS (1-2 týdny)

Cíl: Spustit služby kde máme data

✅ LEADY - už funguje
ŽIVNOSTNÍCI (02):
API endpoints (FastAPI)
Frontend (React + Tailwind)
Export do CRM
FIRMY (10):
API endpoints
Search frontend
B2B scoring (GPT-4)

FÁZE 2: AI MODELY (2-3 týdny)

Cíl: Dokončit AI features

REALITNÍ INTELIGENCE (05):
Dokončit 4 price modely
Market intelligence dashboard
Scraping automation (n8n)
PRÁVNÍ & CORPORATE (06):
AI právník (GPT-4 + RAG)
Generátor smluv
Corporate wizard

FÁZE 3: NOVÉ SLUŽBY (3-4 týdny)

Cíl: Vytvořit zbývající služby

POJIŠTĚNÍ (03):
Kalkulátor + porovnání
Lead generation
BANKOVNICTVÍ (08):
Hypoteční kalkulátor
Credit scoring
REALITNÍ KANCELÁŘE (07):
CRM pro realitky
Matching engine

FÁZE 4: AUTOMATIZACE (ongoing)

Cíl: Workflow marketplace

AUTOMATIZACE (09):
Marketplace workflows
Custom builder
Monitoring dashboard
OBECNÉ (04):
- Konzultace booking
- Project estimator

🏗️ TECHNICKÁ ARCHITEKTURA

Backend Stack

FastAPI (Python)        → REST API pro všechny služby
PostgreSQL              → Hlavní databáze (leads, requests)
SQLite                  → Read-heavy data (contacts, companies)
Redis                   → Cache + queue
n8n                     → Workflow automation
PM2                     → Process management

Frontend Stack

React 18                → UI framework
Tailwind CSS            → Styling (ChatGPT minimalist style)
Vite                    → Build tool
React Router            → Routing
TanStack Query          → Data fetching
Zustand                 → State management

AI Stack

GPT-4o                  → Complex reasoning
GPT-4o-mini             → Quick tasks, scoring
Claude Sonnet 4.5       → Code generation, analysis
LangChain               → RAG, agents
Qdrant                  → Vector DB
Mem0                    → Long-term memory

Infrastructure

Nginx                   → Reverse proxy
Docker                  → Containerization
Kong                    → API Gateway
Twenty CRM              → CRM backend
Directus                → Headless CMS

📁 STRUKTURA PROJEKTU

/opt/czechai-services/
├── api/
│   ├── main.py                    # FastAPI entry point
│   ├── routers/
│   │   ├── leady.py               # 01 LEADY endpoints
│   │   ├── zivnostnici.py         # 02 ŽIVNOSTNÍCI
│   │   ├── pojisteni.py           # 03 POJIŠTĚNÍ
│   │   ├── obecne.py              # 04 OBECNÉ
│   │   ├── reality.py             # 05 REALITNÍ INTELIGENCE
│   │   ├── pravni.py              # 06 PRÁVNÍ & CORPORATE
│   │   ├── kancelare.py           # 07 REALITNÍ KANCELÁŘE
│   │   ├── banking.py             # 08 BANKOVNICTVÍ
│   │   ├── automation.py          # 09 AUTOMATIZACE
│   │   └── firmy.py               # 10 FIRMY
│   ├── models/                    # DB models
│   ├── services/                  # Business logic
│   └── ai/                        # AI agents
├── frontend/
│   ├── src/
│   │   ├── pages/
│   │   │   ├── Leady/
│   │   │   ├── Zivnostnici/
│   │   │   ├── Pojisteni/
│   │   │   ├── Obecne/
│   │   │   ├── Reality/
│   │   │   ├── Pravni/
│   │   │   ├── Kancelare/
│   │   │   ├── Banking/
│   │   │   ├── Automation/
│   │   │   └── Firmy/
│   │   ├── components/            # Shared components
│   │   └── utils/                 # Utilities
│   └── public/
├── n8n-workflows/                 # Pre-built workflows
├── databases/
│   ├── migrations/                # DB migrations
│   └── seeds/                     # Seed data
└── docs/
    ├── API.md                     # API dokumentace
    ├── WORKFLOWS.md               # n8n workflows
    └── DEPLOYMENT.md              # Deployment guide

🎯 METRIKY ÚSPĚCHU

Business Metriky

Leads/měsíc: 500+ (všechny služby dohromady)
Conversion rate: 10%+ (lead → customer)
Revenue/měsíc: 200,000+ Kč
Customer LTV: 50,000+ Kč

Technical Metriky

API uptime: 99.9%
Response time: < 500ms (P95)
Error rate: < 0.1%
Test coverage: 80%+

User Metriky

Active users: 1,000+ (unique/měsíc)
Session duration: 5+ minut
Bounce rate: < 40%
NPS score: 50+

📋 NEXT STEPS

Schválit tento plán s uživatelem
Vytvořit GitHub repo /opt/czechai-services
Setup FastAPI project (main.py + routers)
Implementovat FÁZE 1 (Živnostníci + Firmy APIs)
Deploy na server (PM2 + Nginx)
Vytvořit frontend shell (React + routing)
Iterovat podle priorit

Autor: Claude Sonnet 4.5 Datum: 2026-01-17 Status: DESIGN COMPLETE - ČEKÁ NA APPROVAL