Ministerstvo práce a sociálních věcí · JMHZverze 2.0 (major)S-METODIKA
Metodika

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íZdrojCo se z něj bere
1.Master listy dokumentů — SLOVNÍK, MH, Interakce, Slovník EDVCí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.JiraPouze 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ávceVýsledekCo to znamená
nebyl → jenový atributdoplnit
byl → nenízrušený atributpřestat posílat
byl → je, změnil sezměněnýověřit
nebyl → nebyl (vznikl a zanikl)nevykazuje seneimplementovat

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 opsatKde to jePříklad
kód stránkymodrý pruh vpravo nahořeK-MH-MZDA
kód sekcerámeček vpravo u nadpisu sekceK-MH-MZDA §3
konkrétní položkuID atributu, číslo kontroly nebo kód interakce10091 · 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.xlsx se přepisuje při každém sestavení dokumentace. Vyplňujte vlastní kopii pod svým jménem.

S-METODIKA §4Zpracovaný rozsah

ZdrojŘádků od verze 1.5
changelog datového slovníku266
changelog katalogu kontrol199
changelog datových scénářů32
changelog externí datové věty71
VýsledekStav
změn s čistým efektem167
z toho vyžaduje práci100
kapitol16
motivačních karet54
nálezů v podkladech97 — 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.