CzechAI Cenová Mapa — Kompletní Program Dokumentace¶

Klient (web / API call)
        │
        ▼
┌───────────────────────────────────────────┐
│         Router Tower (router.czechai.io)   │
│  /v1/cenova/v23/estimate                  │
│  /v1/cenova/v24/estimate                  │
│  /v1/cenova/se/estimate                   │
└──────┬───────────────────────────────┬────┘
       │                               │
       ▼                               ▼
┌──────────────┐             ┌──────────────────────────┐
│  V23 :5153   │             │  Super-Ensemble v2.3 :5111│
│  V24 :5154   │             │  7+ engines kombinovaně   │
│  (shared     │             │  Výstup: konsenzus cena  │
│   geocoder)  │             └──────────────────────────┘
└──────┬───────┘
       │
       ▼
┌─────────────────────────────┐
│  czech_geocoder.py          │
│  /opt/czechai-shared/       │
│  80+ měst, fuzzy matching   │
│  diacritika, aliasy         │
└─────────────────────────────┘
       │
       ▼
┌─────────────────────────────┐
│  XGBoost + LightGBM + RF    │
│  Trénováno na 227K+ záznamů │
│  z MASTER_LIVE.db           │
└─────────────────────────────┘

def geocode(city: str) -> tuple:
    # 1. Exact match (stripped diacritics, lowercase)
    #    "Hradec Králové" → strip → "hradec kralove" → hit

    # 2. Alias lookup
    #    "HK" → alias → "hradec kralove" → hit
    #    "CB" → "ceske budejovice"
    #    "KV" → "karlovy vary"

    # 3. Partial substring match
    #    "Praha 6" → contains "praha" → hit (50.1047, 14.3928)
    #    "Frýdek" → contained in "frydek mistek" → hit

    # 4. Word-by-word match (>4 chars)
    #    Fallback Praha se LOGUJE jako warning

    return (lat, lon, canonical_name, confidence)
    # confidence: 1.0=exact, 0.8=alias, 0.6=partial, 0.4=word, 0.0=fallback

# V souboru /opt/czechai-shared/czech_geocoder.py
# Do CITY_COORDS dict přidej:
'nove mesto na morave': (49.5606, 16.0745, 'Nové Město na Moravě', 10_000),
# Klíč = stripped lowercase (bez diakritiky, malá písmena)
# Value = (lat, lon, canonical_name, population)

Parametry:
  typ      = byt | dum | pozemek | komercni
  mesto    = název města (česky, s/bez diakritiky)
  plocha   = číslo m²
  lat, lon = GPS (optional, přepíše město)
  ai_comment = true | false (default true, false = rychlejší)

Příklad:
  GET /api/estimate?typ=byt&mesto=Liberec&plocha=60

Odpověď:
{
  "cena": 3693000,
  "cena_m2": 61557,
  "lat": 50.7663,
  "lon": 15.0543,
  "model": "V23",
  "plocha": 60.0,
  "typ": "byt"
}

Parametry (stejné jako V23, navíc):
  dispozice  = 1 | 2 | 3 | 4 (1+kk, 2+kk, 3+kk, 4+kk)
  condition  = novostavba (aplikuje multiplier)

Příklad:
  GET /api/estimate?typ=byt&mesto=Praha&plocha=75&dispozice=3

Odpověď:
{
  "cena": 16823100,
  "cena_m2": 224308,
  "debug": {
    "lgb": 181072, "rf": 222846, "xgb": 202362,
    "weights": {"lgb": 0.336, "rf": 0.328, "xgb": 0.336},
    "dispozice": 3,
    "condition_mult": 1.0
  },
  "lat": 50.0755,
  "lon": 14.4378,
  "model": "V24"
}

Parametry: stejné jako V24
  ai_comment = false  ← VŽDY pro batch operace (jinak 4+ sec)

Příklad:
  GET /api/estimate?typ=byt&mesto=Olomouc&plocha=55&ai_comment=false

Odpověď:
{
  "cena": 5227086,
  "cena_m2": 95038,
  "method": "SUPER_ENSEMBLE_V2.3",
  "confidence": 0.74,
  "engines_used": 11,
  "spread_pct": 109,
  "tri_pristupy": {
    "trzni": 5100000,
    "vynosovy": 4800000,
    "nakladovy": 5800000
  }
}

/v1/cenova/v23/estimate  →  localhost:5153
/v1/cenova/v24/estimate  →  localhost:5154
/v1/cenova/v24/health    →  localhost:5154/health
/v1/cenova/se/estimate   →  localhost:5111

IF město IN (Praha, Brno, Ostrava, Plzeň):
    → Použij V24 (85ms, R²=0.9478, nejpřesnější ML)
    → Pro batch/reporty: ai_comment=false

ELIF potřebuješ více jistoty OR regionální město:
    → Použij SE v2.3 (239ms, správný geocoding, konsenzus)
    → ai_comment=false VŽDY pro batch

ELIF top příležitost (>100K Kč podhodnocení):
    → Znalecký Panel :5112 (4min, 3 AI znalci, nejvyšší přesnost)

Pro real-time web UI:
    → V24 primary + SE jako confidence check
    → Zobraz: V24 cena + SE confidence score

Server: 46.224.121.179

/opt/czechai-shared/
├── czech_geocoder.py        # Geocoder modul (sdílený)
└── GEOCODER_README.md       # Tato dokumentace

/opt/cenova_mapa/
├── v23_serve_5153.py        # V23 API server
├── v23_serve_5153.py.bak    # Záloha před opravou
├── v24_serve_5154.py        # V24 API server
└── v24_serve_5154.py.bak    # Záloha před opravou

/opt/super-ensemble-v2/
└── ensemble_server.py       # SE v2.3 API server

PM2:
  cenova-mapa-v23  → id=67, port 5153
  cenova-mapa-v24  → id=73, port 5154
  super-ensemble-v2 → id=37, port 5111

# Rychlý smoke test všech 3 modelů
ssh root@46.224.121.179 "
echo '=== V23 Liberec ===' && curl -s 'http://localhost:5153/api/estimate?typ=byt&mesto=Liberec&plocha=60' | python3 -c 'import sys,json; d=json.load(sys.stdin); print(d[\"cena_m2\"], \"Kc/m2\")'
echo '=== V24 Hradec ===' && curl -s 'http://localhost:5154/api/estimate?typ=byt&mesto=Hradec+Kralove&plocha=60' | python3 -c 'import sys,json; d=json.load(sys.stdin); print(d[\"cena_m2\"], \"Kc/m2\")'
echo '=== SE Olomouc ===' && curl -s 'http://localhost:5111/api/estimate?typ=byt&mesto=Olomouc&plocha=60&ai_comment=false' | python3 -c 'import sys,json; d=json.load(sys.stdin); print(d[\"cena_m2\"], \"Kc/m2\")'
"
# Očekávané výsledky: V23~61k, V24~95k, SE~95k — NE 203k (Praha fallback)