Specifikace

SPEC.md je odvozený z klientského zadání APS-200 a přepsaný jako závazný rozsah tohoto repozitáře. Zadání samo je označené jako návrh k diskusi, takže dokument důsledně odlišuje, co je převzaté a co je vlastní rozhodnutí — každé takové místo je označené jako [decision].

Původ

klientské zadání APS-200 v1.0, stav: návrh k diskusi

Moduly

pohledávky, věřitelé, účetní závěrky věřitelů

Rozsah MVP

konkursy právnických a podnikajících fyzických osob od 1. 1. 2018

Otevřené otázky

šest ze zadání, další doplněné tímto repozitářem

Stav

dokument hotový; žádný ze tří modulů zatím není implementovaný

Co dokument fixuje

První část je popis zdrojů a jejich mezí: WS ISIR dává metadata a odkaz na dokument, nikoli částky, zajištění, výsledky přezkumu ani identitu věřitele. Ty jsou uvnitř PDF, a proto je celý zbytek specifikace stavěný kolem vytěžování dokumentů.

Následuje mapa typů dokumentů podle oddílů spisu — přihláška v oddílu P, zpráva o přezkumu a rozvrhové usnesení v oddílu B, incidenční spor v oddílu C — a k ní seznam údajů, které se z každého typu berou. Tahle tabulka je zadáním pro extrakci.

Modul 3 (účetní závěrky ze Sbírky listin) je zúžený na segment ostatních právnických osob a prioritizovaný podle nominálu držených pohledávek. Stahovat závěrku k věřiteli s pohledávkou za 20 000 Kč nemá smysl.

Fáze a rozhodnutí o roce 2018

Zadání nechalo počáteční rok MVP nevyplněný a navrhlo 2018+. Repozitář přijal 1. 1. 2018 a napsal proč: novela z roku 2017 (vyhl. 191/2017 Sb.) změnila formulář přihlášky i režim přezkumu, takže jedna generace parserů pokrývá rok 2018 a novější beze zbytku, zatímco starší případy potřebují cestu přes protokoly z přezkumného jednání.

%% title: Mapa roadmapy a závislostí
%% caption: Plná šipka vede od položky k té, která na ní podle roadmapy staví; přerušovaná od toho, co postup blokuje. Uzly bez šipky nemají na roadmapě uvedenou závislost. Klikněte na uzel pro detail položky.
flowchart LR
  subgraph F0["Základ"]
    direction TB
    KON["Ověření kontraktu zdroje"]
    DOM["Doménový model"]
    API0["FastAPI skeleton"]
    ARCH["Archiv feedu a projekce"]
  end
  subgraph F1["Fáze 1 — MVP"]
    direction TB
    KLI["Klient WS ISIR a limity"] --> REP["Replika a checkpoint"]
    REP --> PRJ["Projekce"]
    REP --> DOC["Dokumentová pipeline"]
    DOC --> FRO["Fronta lidské kontroly"]
    DOC --> ER["Entity resolution věřitelů"]
    PRJ --> API["Čtecí API"]
  end
  subgraph F2["Fáze 2 a 3"]
    direction TB
    ROZ["Rozvrhy a výtěžnosti"]
    SEK["Sekundární trh §18"]
    INC["Incidenční spory"]
    UZ["Účetní závěrky a skóring"]
  end
  subgraph BLK["Blokuje"]
    direction TB
    NAK["Nákladový model"]
    PRA["Právní review"]
  end
  KON --> KLI
  PRJ --> ROZ
  DOC --> ROZ
  PRJ --> SEK
  ER --> SEK
  ER --> UZ
  NAK -. "rozsah backfillu" .-> FULL(["Provoz v plném rozsahu"])
  PRA -. "potvrzený právní titul" .-> FULL
  click KON href "/roadmap/overeni-kontraktu-zdroje"
  click DOM href "/roadmap/domenovy-model"
  click API0 href "/roadmap/fastapi-skeleton"
  click ARCH href "/roadmap/archiv-feedu-a-projekce"
  click KLI href "/roadmap/klient-ws-isir-a-limity"
  click REP href "/roadmap/replika-a-checkpoint"
  click PRJ href "/roadmap/projekce"
  click DOC href "/roadmap/dokumentova-pipeline"
  click FRO href "/roadmap/fronta-lidske-kontroly"
  click ER href "/roadmap/entity-resolution-veritelu"
  click API href "/roadmap/cteci-api"
  click ROZ href "/roadmap/rozvrhy-a-vyteznosti"
  click SEK href "/roadmap/sekundarni-trh"
  click INC href "/roadmap/incidencni-spory"
  click UZ href "/roadmap/ucetni-zaverky-a-skoring"
  click NAK href "/roadmap/nakladovy-model"
  click PRA href "/roadmap/pravni-review"
  class KON st-available
  class DOM st-available
  class API0 st-available
  class ARCH st-available
  class KLI st-available
  class REP st-available
  class PRJ st-in_progress
  class DOC st-in_progress
  class FRO st-in_progress
  class ER st-in_progress
  class API st-in_progress
  class ROZ st-planned
  class SEK st-planned
  class INC st-planned
  class UZ st-planned
  class NAK st-in_progress

Co zůstává nerozhodnuté

Rozsah backfillu je především nákladová otázka a specifikace to říká otevřeně: čeká se na měřený odhad nákladu na dokument. Dokud v nákladovém modelu nejsou čísla, je volba rozsahu volbou naslepo.

• Náklad na dokument a na celý backfill — otevřené, blokuje rozhodnutí o rozsahu fáze 1.
• Strategie pro nestandardní přihlášky a přílohy o stovkách stran — otevřené.
• Párování rozvrhových usnesení na jednotlivé pohledávky — otevřené a nejtěžší; rozvrhy odkazují pořadová čísla ze seznamu, ne P-pozice.
• SLA na zpoždění za rejstříkem je 24 hodin, dostupnost API dohodnutá není.
• Forma předání (provoz u dodavatele versus infrastruktura klienta) — otevřené, má důsledky pro úložiště dokumentů i pro GDPR.

Kde to v repozitáři žije

• docs/SPEC.md — cíl, zdroje, tři moduly, entity, fázování, akceptační kritéria, otevřené otázky
• docs/development/OPEN-QUESTIONS.md — stav odpovědi u každé otevřené otázky
• docs/development/COST-MODEL.md — nákladový model — záměrně prázdný, dokud se čísla nezměří

Souvisí

Zpět na sekci Dokumentace