Vladimir Buzalka
109 lines
4.2 KiB
Markdown
109 lines
4.2 KiB
Markdown
# KdoJeLékař — poznámky k vývoji
|
|
|
|
## Cíl
|
|
|
|
Zjistit pro pacienty z Medicus DB, kdo je jejich registrující **praktický lékař (001)**, **gynekolog (002)** a **stomatolog (014)** — dotazem na VZP B2B portál.
|
|
|
|
---
|
|
|
|
## Stav k 29. 4. 2026 — hotovo
|
|
|
|
- Certifikát ✅, tabulky ✅, produkční skript ✅
|
|
- Připraveno ke spuštění — přepnout `TEST_MODE = False`
|
|
|
|
---
|
|
|
|
## Soubory v tomto adresáři
|
|
|
|
| Soubor | Popis |
|
|
|--------|-------|
|
|
| `kdojelekar_tydenni.py` | Produkční skript — batch všech pacientů, ukládá do MySQL |
|
|
| `_test_temp.py` | Testovací skript — dotaz na jedno RC, výpis XML + parsovaný výsledek |
|
|
| `_test_no_odb.py` | Test bez filtru odborností — sloužil k ověření struktury odpovědi |
|
|
|
|
---
|
|
|
|
## Certifikát
|
|
|
|
**`u:\ordinaceprojekt\Insurance\Certificates\picka.pfx`** / heslo **`Vlado7309208104+`**
|
|
Ověřeno 29. 4. 2026 (HTTP 200). Stejný certifikát používá i `StavPojisteni\zkontroluj_a_odesli_zlomy.py`.
|
|
|
|
---
|
|
|
|
## VZP B2B služba: `RegistracePojistencePZSB2B`
|
|
|
|
### Endpoint (produkce)
|
|
```
|
|
https://prod.b2b.vzp.cz/B2BProxy/HttpProxy/RegistracePojistencePZSB2B
|
|
```
|
|
|
|
### Autentizace
|
|
mTLS — klientský certifikát `.pfx`, stejný mechanismus jako u `stavPojisteniB2B`.
|
|
|
|
### Struktura odpovědi
|
|
Pro každou odbornost kde má pacient lékaře vrátí jeden `<odbornost>` element.
|
|
Pokud lékař není, VZP element vynechá — skript ukládá placeholder řádek s `ma_lekare=0`.
|
|
|
|
| XML tag | Uloženo jako | Popis |
|
|
|---------|-------------|-------|
|
|
| `ICZ` | `ICZ` | IČZ zdravotnického zařízení |
|
|
| `ICP` | `ICP` | IČP lékaře |
|
|
| `nazevICP` | `nazev_lekare` | Název pracoviště |
|
|
| `nazevSZZ` | `nazev_zzz` | Jméno lékaře |
|
|
| `zdravotniPojistovna/kod` | `poj_kod` | Kód pojišťovny pacienta |
|
|
| `zdravotniPojistovna/zkratka` | `poj_zkratka` | Zkratka pojišťovny |
|
|
| `odbornost/kod` | `kod_odbornosti` | Kód odbornosti (001/002/014) |
|
|
| `datumRegistrace` | `datum_registrace` | Kdy pacient podepsal registraci |
|
|
| `datumZahajeni` | `datum_zahajeni` | Od kdy registrace platí u VZP |
|
|
| `datumUkonceni` | `datum_ukonceni` | Do kdy (3000-01-01 = bez konce) |
|
|
| `stavVyrizeniPozadavku` | `stav_vyrizeni` | Stavový kód odpovědi VZP |
|
|
|
|
**Poznámka k parsování:** VZP vrací pro každý nalezený záznam dva `<odbornost>` elementy —
|
|
vnější (s ICZ/ICP/jménem) a vnořený subelement (jen kód+název). Parser používá
|
|
`findall(".//seznamOdbornosti/odbornost")` který zachytí jen vnější.
|
|
|
|
---
|
|
|
|
## MySQL tabulky
|
|
|
|
### `vzp_registrace_lekari`
|
|
Jeden řádek na `(rc, k_datu, kod_odbornosti)`. UNIQUE klíč = `(rc, k_datu, kod_odbornosti)`.
|
|
Historie se hromadí — každý týdenní běh přidá nové řádky.
|
|
|
|
### `vzp_registrace_raw`
|
|
Jeden řádek na `(rc, k_datu)` — celé raw XML odpovědi.
|
|
Slouží k případnému přepočtu bez opakování API dotazů. UNIQUE klíč = `(rc, k_datu)`.
|
|
|
|
---
|
|
|
|
## Produkční skript `kdojelekar_tydenni.py`
|
|
|
|
### Konfigurace (začátek souboru)
|
|
| Proměnná | Výchozí | Popis |
|
|
|----------|---------|-------|
|
|
| `API_PAUSE` | `2` | Sekundy mezi VZP dotazy |
|
|
| `TEST_MODE` | `True` | False = produkční běh |
|
|
| `ODBORNOSTI` | `["001","002","014"]` | Dotazované odbornosti |
|
|
|
|
### Logika
|
|
1. Načte aktivně registrované pacienty z Medicus (přesný select dle SELECTS.md, IČP 09305001)
|
|
2. V produkčním běhu přeskočí pacienty, kteří už mají záznam v `vzp_registrace_raw` pro dnešní datum — **resumovatelný běh**
|
|
3. Pro každého pacienta zavolá VZP B2B, uloží raw XML + parsované záznamy
|
|
4. Placeholdery pro odbornosti bez lékaře ukládá s `ma_lekare=0`
|
|
|
|
### Knihovny
|
|
- `Knihovny/vzpb2b_client.py` → metody `registrace_lekare()` a `parse_registrace_lekare()`
|
|
- `Knihovny/medicus_db.py` → `get_active_registered_patients()` (opraveno 29. 4. 2026)
|
|
- `Knihovny/mysql_db.py` → `connect_mysql()`
|
|
|
|
---
|
|
|
|
## Plán dalšího postupu
|
|
|
|
1. ~~Certifikát~~ — vyřešeno, `picka.pfx` / `Vlado7309208104+`
|
|
2. ~~Ověřit funkčnost~~ — hotovo, HTTP 200 s daty
|
|
3. ~~Produkční skript~~ — hotovo, `kdojelekar_tydenni.py`
|
|
4. ~~MySQL tabulky~~ — hotovo, `vzp_registrace_lekari` + `vzp_registrace_raw`
|
|
5. Naplánovat týdenní spouštění (Windows Task Scheduler nebo Claude schedule)
|
|
6. Zvážit detekci změn lékaře (analogie zlomů u StavPojisteni) — zatím není v plánu
|