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 §3Jak 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 §4Zpracovaný rozsah
| Zdroj | Řádků od verze 1.5 |
|---|---|
| changelog datového slovníku | 266 |
| changelog katalogu kontrol | 199 |
| changelog datových scénářů | 32 |
| changelog externí datové věty | 71 |
| Výsledek | Stav |
|---|---|
| změn s čistým efektem | 167 |
| z toho vyžaduje práci | 100 |
| kapitol | 16 |
| motivačních karet | 54 |
| nálezů v podkladech | 97 — evidováno pro MPSV |
Snapshot Jiry pořízen 2026-11-02 17:32. Zdrojové dokumenty ve verzích 1.5.0.3 až 1.5.0.4 publikovaných na developers.mpsv.cz.