Rozpracováno

Fronta lidské kontroly

Fronta kontroly je místo, kudy do systému vstupuje lidská práce. Její návrh proto rozhoduje o tom, jestli jsou cíle přesnosti vůbec dosažitelné — a jestli se den práce analytika promítne do kvality, nebo se vypaří.

Položky fáze

1.9 směrování podle spolehlivosti, 1.12 rozhraní fronty

Práh

0,85; u pohledávek od 1 000 000 Kč 0,95

Typy rozhodnutí

po jednotlivých tvrzeních pohledávky: potvrdit, opravit s dokladem, nedostatek podkladů, nejednoznačné, nečitelné, zamítnout; u částek od 1 000 000 Kč potvrzení schvaluje druhá osoba

Vždy do fronty

porušené validační pravidlo nebo účetní identita, bez ohledu na skóre

Stav

obrazovka /app/kontrola a rozhraní /api/review jsou postavené a otestované (ADR 0017); od 7. 10. 2026 ověří citaci už při výběru a částku, kterou žádná strana nepíše, umí doložit výpočtem ze dvou citovaných částek (ADR 0022); od 26. 10. 2026 smí kontrolovat i osoba přihlášená přes Keycloak s klientskou rolí reviewer nebo approver (ADR 0032); 26. 10. 2026: potvrzení nebo opravu lze vrátit ke kontrole s povinným důvodem — kontrolor vlastní („vzít zpět“), schvalovatel kohokoli, i už schválené nebo jednofázové; nic se nemaže, vrácení se připíše do historie a pohledávka se v součtech vrátí mezi pohledávky ke kontrole; vlastní rozhodnutí dál nikdo neschválí. Celá smyčka (fronta, položka, text strany, citace, rozhodnutí, schválení nebo vrácení, přestavba indexu, součty v přehledu a průzkumu) je ověřená end-to-end na lokálním skutečném stacku. Kdo frontu obsluhuje, je ústně dohodnuté 26. 10. 2026: od listopadu pracovníci zadavatele. Do provozu ji uvedou produkční účty kontrolorů; produkční data uvidí až po právní review (položka 0.12)

Co musí být na obrazovce

Zdrojový dokument otevřený na správné stránce, vedle něj předvyplněné kandidátní hodnoty i s jejich skóre a vyznačeným místem, odkud pocházejí. Analytik nesmí důkaz hledat — hledání je většina času a zdroj chyb.

Ovládání bude klávesové. Kdo za den posuzuje stovky položek, nemá sahat po myši.

Rozhodnutí jsou data

Každé rozhodnutí se zapíše jako událost — typovaná, s identitou toho, kdo ji učinil, a s časem. Při přehrání projekce se přehrají i adjudikace.

„Nečitelné“ je plnohodnotný výsledek, který se zaznamenává. Systém, kde tahle možnost chybí, tlačí analytika k tomu, aby něco tipnul, což je přesně to, čemu se práh spolehlivosti snaží zabránit.

%% title: Rozhodnutí o jedné vytěžené hodnotě
%% caption: Práh je vázaný na cenu chyby: 0,85 pro běžnou pohledávku, 0,95 nad 1 000 000 Kč. Rozhodnutí analytika je typovaná událost a při přehrání projekce se přehraje taky. Prahy jsou v konfiguraci aplikace; fronta kontroly je na roadmapě.
flowchart TD
  F["Vytěžená hodnota pole<br/>skóre, metoda, stránka"] --> V{"Validační pravidlo<br/>nebo bilanční rovnice<br/>porušena?"}
  V -- "ano" --> Q["Fronta lidské kontroly"]
  V -- "ne" --> N{"Nominál<br/>nad 1 000 000 Kč?"}
  N -- "ano" --> T95["práh 0,95"]
  N -- "ne" --> T85["práh 0,85"]
  T95 --> S{"Skóre ≥ práh?"}
  T85 --> S
  S -- "ano" --> W[("Zapsat do projekce")]
  S -- "ne" --> Q
  Q --> D1["Potvrdit"]
  Q --> D2["Opravit<br/>s uvedením hodnoty"]
  Q --> D3["Nečitelné"]
  D1 --> EV[("Událost rozhodnutí<br/>kdo, kdy, co")]
  D2 --> EV
  D3 --> EV
  EV --> W
  click F href "/architecture/confidence-je-plnohodnotne-pole" "Confidence je plnohodnotné pole"
  click Q href "/roadmap/fronta-lidske-kontroly" "Fronta lidské kontroly"
  click S href "/docs/extrakce" "Extrakce"
  click W href "/roadmap/projekce" "Projekce"
  click D3 href "/about/nevedet-je-lepsi-nez-hadat" "Nevědět je lepší než hádat"
  click EV href "/about/log-je-pravda-projekce-je-odvozena" "Log je pravda, projekce je odvozená"
  class Q st-in_progress
  class W st-in_progress

Aby se práce analytika neztratila

Opravy budou plnit zlatou sadu — ručně anotovaný vzorek, na kterém se měří přesnost každé verze extraktoru. Fáze 1 s ní počítá v položce 1.13 v rozsahu nejméně 500 přihlášek.

Zátěž fronty je zároveň metrika, kterou nelze obejít: přesnost se vždy vykazuje spolu s pokrytím a hloubkou fronty, protože zvednutím prahu se dá vylepšit každé jedno číslo o kvalitě a produkt tím zničit.

Kde to v repozitáři žije

• docs/APP.md — obrazovky aplikace a požadavky na frontu kontroly
• docs/EXTRACTION.md — směrování podle spolehlivosti a případy, které jdou do fronty vždy
• docs/ACCEPTANCE.md — zlatá sada, cíle přesnosti a past ve způsobu měření
• src/progresus_isir/config.py — prahy spolehlivosti a hranice vysokého nominálu

Souvisí

Zpět na sekci Roadmapa