Jak tato dokumentace vznikla
Podklady nejsou psané ručně. Generuje je pipeline ze zdrojových dokumentů a z Jiry a před vydáním prochází automatickými testy.
S-METODIKA §1Hierarchie důvěryhodnosti zdrojů
Nejdůležitější pravidlo. Při rozporu platí toto pořadí.
| Pořadí | Zdroj | Co se z něj bere |
|---|---|---|
| 1. | Master listy dokumentů — SLOVNÍK, MH, Interakce, Slovník EDV | Cílový stav. Název, datový typ, povinnost, oblast, XSD, konzumenti, znění kontroly, chybová hláška, propustnost, zařazení do scénářů |
| 2. | Changelogy dokumentů | Co a proč se změnilo. Typ změny, vazba na požadavek |
| 3. | Jira | Pouze business kontext. Legislativní důvod, kritičnost, téma. Vnitřní členění odpovědností na straně MPSV se do dokumentace nepromítá — dodavateli neříká nic a svádělo by k obcházení oficiální cesty pro dotazy |
Jira je vždy méně důvěryhodná než dokumenty
Tikety obsahují zástupné texty typu „nový atribut 10xxx“, odkazují na paragrafy přečíslované v legislativním procesu a jejich stav neodpovídá stavu specifikace. Technický údaj se z Jiry nepřebírá.
S-METODIKA §2Dvě zásady, na kterých dodávka stojí
Čistá bilance dodávky
Verze 1.5 je první uvolněná. Vše od ní výš je jedna dodávka, ne řada verzí. Pro každý atribut se proto počítá výsledný efekt, ne jednotlivé kroky.
| Průběh v dodávce | Výsledek | Co to znamená |
|---|---|---|
| nebyl → je | nový atribut | doplnit |
| byl → není | zrušený atribut | přestat posílat |
| byl → je, změnil se | změněný | ověřit |
| nebyl → nebyl (vznikl a zanikl) | nevykazuje se | neimplementovat |
12 atributů vzniklo a bylo zase zrušeno uvnitř dodávky
Kdyby se dokumentace řídila jednotlivými řádky changelogu, uváděla by je jako nové atributy k implementaci. Ve výsledné specifikaci ale neexistují.
Osa členění
Kapitola je oblast atributu, ne změnový požadavek.
Požadavek je jednotka práce MPSV; oblast je jednotka práce dodavatele. Data ukazují, že jde o dvě nezávislé osy — jedné oblasti se dotýká až 14 požadavků a jeden velký požadavek se rozpadá do víc než deseti oblastí. Kdyby byl kapitolou požadavek, musel by dodavatel spravující výpočet zálohy na daň projít deset kapitol.
Požadavky proto zůstávají jako motivační karty — nesou důvod, proč změna vzniká, a odkazují do kapitol.
S-METODIKA §3Pravidla těžby
Každé vzniklo z prototypu a řeší chybu, která by bez něj nastala.
| Pravidlo | Proč |
|---|---|
| Kontroly hledat přes ID atributů, ne přes přiřazení k požadavku | Changelog přiřadí jen část kontrol. U jednoho požadavku uváděl 2 kontroly, ve skutečnosti se jeho atributů týkají 4 — a chybějící vynucovala hlavní limit funkce. |
| Interakce a zařazení do scénářů brát ze scénářového slovníku | Changelog řekne, že interakce vznikla; kam atribut patří, je jinde. Ve dvou případech navíc changelog uvádí chybné číslo interakce. |
| Zrušené atributy číst z changelogu, ne z master listu | Z listu SLOVNÍK jsou smazané — join by nevrátil nic. |
| Sečíst čistou bilanci dodávky | 12 atributů vzniklo a zaniklo uvnitř dodávky. |
| Oddělit práci od nepráce | 49 z 149 změn nevyžaduje žádný zásah. |
| U přejmenování rozlišit věcnou změnu od kosmetické | Přejmenování nemění ID ani XSD, ale může změnit, co se do pole počítá — a žádná kontrola to nezachytí. |
| Rozlišit „netýká se“ od „chybí“ | Prázdná sekce vypadá jako nedodělek. |
| U každé kontroly propustnost a chybový kód | Nepropustnost určuje prioritu implementace. |
| V changelogu externí datové věty číst i sedmý sloupec bez hlavičky | Dokument tím vypadá, že vazbu na požadavek neuvádí. Ve skutečnosti ji nese u 38 z 53 změn. Dopočet přes ID atributu, který bez něj musel nastoupit, přiřadil změny požadavkům, jež dokument vůbec nezmiňuje. |
| Pojmenované kontroly datové věty brát z listu Vysvětlivky | Datová věta má vlastní malý katalog kontrol. Atributy se na něj odkazují jen číslem; kterou variantu použít, určuje skupina ID vyjmenovaná v definici. |
| Typ změny v dokumentu ověřit proti obsahu | Dva řádky jsou zatypované špatně a oba jsou podstatné — jeden mění číselník, ne kontrolu; druhý zavádí definici nové kontroly, ne vysvětlivku. |
| Zástupný znak „-“ není ID atributu | Když se s ním zachází jako s ID, sesbírá požadavky ze všech takových řádků napříč dokumenty a testy pak mlčí tam, kde měly hlásit. |
S-METODIKA §4Testy
Nálezy se dělí na dvě třídy podle toho, co s nimi má nastat.
| Třída | Co znamená | Co se stane |
|---|---|---|
| Chyba generátoru — sady A, B, D, E, F | Dokumentace neodpovídá podkladům, něco vypadlo, porušili jsme vlastní pravidla, nebo stránka nesedí na zdrojový dokument | blokuje publikaci |
| Nález ve zdroji — sada C | Podklady v _inputs si odporují | eviduje se pro MPSV |
| Sada | Co ověřuje | Kontrol |
|---|---|---|
| A | Úplnost pokrytí — nevypadlo nic z changelogů od verze 1.5 | 23 |
| B | Věcná správnost — každý údaj sedí se zdrojovým dokumentem, včetně anti-halucinačního testu nad každým číslem v textu | 12 |
| C | Konzistence zdrojů mezi sebou | 17 |
| D | Dodržení pravidel metodiky | 29 |
| E | Odkazy a dohledatelnost, včetně čísel řádků changelogu | 10 |
| F | Kontrola vygenerovaných stránek přímo proti XLSX | 5 |
Sada F obchází vlastní cache
Sady A až E porovnávají vygenerované stránky s tím, co pipeline vytěžila do cache. Kdyby se něco ztratilo už při vytěžení, shodly by se cache i stránka na téže chybě a žádný z nich by to neviděl. Sada F proto otevře zdrojový dokument znovu a porovná ho rovnou s hotovou stránkou.
Testy se ověřují mutací
Test, který nikdy neselže, je horší než žádný — vytváří falešnou jistotu. Po každém přidání kontroly se cíleně rozbije to, co má hlídat, a ověří se, že selže: sníží se počet v manifestu, přepíše se hodnota na stránce, smaže se odkaz z karty požadavku. Aktuálně je takto ověřeno 31 mutací, všechny zachycené.
S-METODIKA §5Jak podat připomínku
Každá stránka má vpravo nahoře kód a každá sekce kód s číslem. Oba se opisují do formuláře pro připomínky.
| Co opsat | Kde to je | Příklad |
|---|---|---|
| kód stránky | modrý pruh vpravo nahoře | K-MH-MZDA |
| kód sekce | rámeček vpravo u nadpisu sekce | K-MH-MZDA §3 |
| konkrétní položku | ID atributu, číslo kontroly nebo kód interakce | 10091 · idk 379 · IN39 |
Kód stránky je odvozený z obsahu, ne z pořadí — nová kapitola tedy nepřečísluje ty stávající a už podané připomínky ukazují dál na stejné místo.
Formulář si zkopírujte
Šablona pripominky_sablona.
S-METODIKA §6Zpracovaný rozsah
| Zdroj | Řádků od verze 1.5 |
|---|---|
| changelog datového slovníku | 243 |
| changelog katalogu kontrol | 125 |
| changelog datových scénářů | 26 |
| changelog externí datové věty | 62 |
| Výsledek | Stav |
|---|---|
| změn s čistým efektem | 149 |
| z toho vyžaduje práci | 100 |
| kapitol | 15 |
| motivačních karet | 51 |
| nálezů v podkladech | 118 — evidováno pro MPSV |
Snapshot Jiry pořízen 2026-09-29 11:44. Zdrojové dokumenty ve verzích 1.5.0.1 až 1.5.0.3 publikovaných na developers.mpsv.cz.