Přehled API

%% title: Jak API čte a kudy se zapisuje
%% caption: Dnešní cesty pod /api, jen pro přihlášené. Čtení jde přes /api/explore z indexu pohledávek, který se staví z projekce, a každá pohledávka v odpovědi nese dokument, stránku a confidence. Do dat o pohledávkách se zapisuje jen rozhodnutí kontrolora přes /api/review: uloží se do append-only logu rozhodnutí a projekce ho přehraje při další přestavbě. Verzované endpointy /v1 zatím neexistují.
sequenceDiagram
  participant K as Klient
  participant A as API /api
  participant I as Index pohledávek
  participant P as Projekce
  participant Q as Fronta kontroly
  participant L as Log rozhodnutí
  K->>A: GET /api/explore/search
  A->>I: dotaz
  I-->>A: pohledávky + dokument, stránka, confidence
  A-->>K: odpověď s proveniencí
  K->>A: POST /api/review/… rozhodnutí
  A->>Q: rozhodnutí
  Q->>L: typovaná událost (kdo, kdy, co)
  L-->>P: přehrání při přestavbě projekce
  P-->>I: přestavba indexu

%% title: Datový model kolem dílčí pohledávky
%% caption: Přihláška je kontejner, jednotkou je dílčí pohledávka. Její stav je odvozený z uspořádaného seznamu událostí a každá událost odkazuje na dokument a stránku.
erDiagram
  RIZENI ||--o{ PRIHLASKA : "oddíl P"
  VERITEL ||--o{ PRIHLASKA : "podává"
  PRIHLASKA ||--|{ POHLEDAVKA : "obsahuje"
  POHLEDAVKA ||--o{ UDALOST : "historie stavů"
  DOKUMENT ||--o{ UDALOST : "provenience"
  POHLEDAVKA ||--o{ POSTOUPENI : "§18"
  VERITEL ||--o{ POSTOUPENI : "postupitel / nabyvatel"
  RIZENI {
    string spisova_znacka
    string zpusob_reseni
  }
  PRIHLASKA {
    string pozice "P-x"
    date datum
  }
  POHLEDAVKA {
    int poradi
    decimal nominal
    string klasifikace
    string stav "odvozený"
  }
  UDALOST {
    string typ
    date datum
    int stranka
    float confidence
  }
  VERITEL {
    string ico
    string segment
  }