botcorpus — kvalita dát: prečo faktom veriť

Anatómia faktu

Každý fakt nesie dôveryhodnostnú obálku.

Toto je reálny tvar faktu z korpusu — nielen hodnota, ale aj odkiaľ je, dokedy platí a ako veľmi mu veriť. Agent dostane všetko, čo potrebuje na rozhodnutie aj na citáciu.

// GET /facts/sk/contributions/employee-rate
{
  "id": "sk/contributions/employee-rate",
  "title": "Odvody zamestnanca — sadzba",
  "value": 14.4,
  "unit": "%",
  "period": "2026",
  "valid_from": "2026-01-01",
  "valid_to": null,
  "applies_to": "SK",
  "confidence": "high",
  "status": "ok",
  "source": "Podnikajte.sk — odvody 2026",
  "source_url": "https://podnikajte.sk/...",
  "sources_count": 3
}

idStabilný kanonický identifikátor faktu.

value · unitSamotná hodnota a jej jednotka.

periodObdobie, ktorého sa hodnota týka.

valid_from · valid_toČasová platnosť — odkedy dokedy fakt platí.

applies_toÚzemná pôsobnosť (SK, neskôr CZ/EÚ).

confidenceMiera istoty: high / medium / low.

statusStav: ok / needs_review / deprecated.

source · source_urlPrimárny zdroj a odkaz naň.

sources_countPočet zdrojov, ktorými je fakt podložený.

Metodika overovania

Od oficiálneho zdroja po publikovaný fakt.

Primárny zdroj

Každý fakt vychádza z oficiálneho zdroja — register, vestník, web inštitúcie alebo zákon. Žiadny fakt sa nepíše „z pamäte" modelu.

Kurátorská verifikácia

Hodnota sa krížovo overí (často viacerými zdrojmi — sources_count). Fakt čakajúci na overenie dostane status=needs_review a do korpusu sa nepublikuje ako platný.

Datovanie

K hodnote sa priradí časová platnosť (valid_from / valid_to) a obdobie. Agent tak vie nielen číslo, ale aj odkedy platí a či už nie je nahradené.

Publikácia & monitoring

Overený fakt ide do korpusu so zdrojom a confidence. Civic fakty sledujeme a obnovujeme do 7 dní od zmeny predpisu; zmeny idú do changelogu.

Confidence & status

Stav faktu je vždy explicitný.

Nikdy nemusíš hádať, či je údaj spoľahlivý — fakt to hovorí sám. Agent sa môže rozhodnúť konzumovať len ok + high.

status: ok

Overený

Skontrolovaný proti primárnemu zdroju, platný a publikovaný. Všetkých 6478 faktov je dnes v tomto stave.

needs_review

Čaká na overenie

Kandidát, ktorý ešte neprešiel verifikáciou. Nekonzumuje sa ako platný fakt, kým sa nepotvrdí.

deprecated

Nahradený

Fakt, ktorý prestal platiť (napr. sadzba zmenená od nového roka). Drží sa pre historické verzie a audit.

Verziovanie & changelog

Keď sa fakt zmení, vidíš čo a kedy.

Pri daniach, mzdách a lehotách je dôležité nielen aktuálne číslo, ale aj kedy sa zmenilo. Zmeny faktov vedieme v changelogu — agent aj človek vie dohľadať históriu hodnoty a oprieť sa o správnu verziu pre dané obdobie. Staré hodnoty sa neprepisujú potichu; dostanú valid_to a status deprecated.

Príklad — zmena základnej sadzby DPH (sk/tax/vat-standard):

sk/tax/vat-standarddeprecated

20 % · valid_from 2011-01-01 · valid_to 2024-12-31

Pôvodná sadzba. Pri zmene dostala valid_to a status deprecated — neprepísala sa potichu.

sk/tax/vat-standardstatus: ok

23 % · valid_from 2025-01-01 · valid_to —

Aktuálna sadzba (konsolidačný balíček, platná od 2025). Agent pre obdobie 2024 dostane starú verziu, pre 2025 aktuálnu.

Odkiaľ dáta sú

Primárne SK zdroje.

Súčasný korpus stojí na oficiálnych slovenských zdrojoch a zákonoch:

Finančná správa SR Sociálna poisťovňa MPSVR SR VšZP Národná rada SR Úrad vlády SR Český statistický úřad Ministerstvo financí ČR Statistik Austria Destatis KSH GUS Eurostat EUR-Lex Zákon č. 595/2003 Z. z. (daň z príjmov) Zákon č. 222/2004 Z. z. (DPH) Ústava SR č. 460/1992 Zb. + oficiálne zdroje pre 30+ krajín

Disclaimer. botcorpus poskytuje informačné údaje so zdrojom a dátumom platnosti — nie je to právne ani daňové poradenstvo. Pre záväzné rozhodnutia over fakt u príslušného úradu alebo odborníka. Plná metodika je strojovo popísaná v llms.txt.

Over si to sám.

Prelistuj korpus, alebo pripoj agenta cez MCP a pozri, ako vyzerá overený fakt v praxi.

Prelistovať korpus Pripojiť cez /mcp →

Žiadny fakt bez zdroja.