Vladimir Buzalka
222 lines
7.2 KiB
Markdown
222 lines
7.2 KiB
Markdown
# Ověření pojistného statusu pacientů (VZP B2B)
|
||
|
||
Systém pro automatické ověřování, zda jsou registrovaní pacienti platně pojištěni u zdravotní pojišťovny. Dotazuje VZP B2B API, ukládá historii do MySQL a generuje PDF reporty o neshodách.
|
||
|
||
---
|
||
|
||
## Architektura
|
||
|
||
```
|
||
Medicus Firebird DB (192.168.1.4)
|
||
└─ get_active_registered_patients()
|
||
│
|
||
▼
|
||
VZPB2BClient.stav_pojisteni() ←─ mTLS (PFX certifikát)
|
||
prod.b2b.vzp.cz/stavPojisteniB2B
|
||
│
|
||
▼
|
||
MySQL medevio.vzp_stav_pojisteni
|
||
│
|
||
▼
|
||
Reportovací skript
|
||
└─ binární hledání data zlomu pojištění
|
||
└─ Jinja2 + WeasyPrint → PDF
|
||
```
|
||
|
||
---
|
||
|
||
## Soubory
|
||
|
||
```
|
||
20 Ověření proti Medicus/
|
||
├── 10 FinalSaveInsuranceStatusScript(R).py ← sběr dat (spouštět denně)
|
||
├── 10 Ověření proti medicus.py ← generování PDF reportu
|
||
├── insurance_check.log ← log sběru dat
|
||
└── Output/
|
||
└── kontrola_pojisteni_YYYY-MM-DD_HH-MM-SS.pdf
|
||
```
|
||
|
||
### Sdílené knihovny (`knihovny/`)
|
||
|
||
| Soubor | Třída | Popis |
|
||
|---|---|---|
|
||
| `medicus_db.py` | `MedicusDB` | Wrapper pro Firebird připojení k Medicus |
|
||
| `vzpb2b_client.py` | `VZPB2BClient` | VZP B2B SOAP API klient s mTLS |
|
||
|
||
---
|
||
|
||
## Skript 1: FinalSaveInsuranceStatusScript
|
||
|
||
**Soubor:** `10 FinalSaveInsuranceStatusScript(R).py`
|
||
|
||
Inkrementální sběr pojistných stavů. Lze spouštět opakovaně — při druhém spuštění ve stejný den přeskočí již zkontrolované pacienty.
|
||
|
||
### Postup
|
||
|
||
1. Načte všechny aktivně registrované pacienty z Medicus (`registr.priznak IN ('A','D','V')`, `kar.vyrazen <> 'A'`)
|
||
2. Pro každého pacienta zkontroluje `MAX(k_datu)` v MySQL — pokud je dnešní, přeskočí ho
|
||
3. Zavolá VZP B2B `stavPojisteniB2B` SOAP endpoint
|
||
4. Uloží XML odpověď + parsovaná data do tabulky `vzp_stav_pojisteni`
|
||
5. Mezi dotazy čeká 1,4 s (ochrana proti přetížení VZP API)
|
||
|
||
### Konfigurace
|
||
|
||
| Proměnná | Hodnota | Popis |
|
||
|---|---|---|
|
||
| `HOST` | `192.168.1.4` | Medicus Firebird server |
|
||
| `DB_PATH` | `c:\Medicus 3\data\MEDICUS.FDB` | Cesta k Firebird databázi |
|
||
| `PFX_PATH` | `certificates/picka.pfx` | Klientský certifikát pro mTLS |
|
||
| `PFX_PASSWORD` | — | Heslo k PFX souboru |
|
||
| `ENV` | `prod` | Prostředí VZP (`prod` / `simu`) |
|
||
| MySQL host | `192.168.1.76:3306` | MySQL server, databáze `medevio` |
|
||
|
||
### Logování
|
||
|
||
Výstup jde současně do `insurance_check.log` i na konzoli. Formát:
|
||
```
|
||
2026-01-26 08:15:23 [INFO] Loaded 1620 registered patients
|
||
2026-01-26 08:15:23 [INFO] Incremental run: 1620 patients to check today
|
||
2026-01-26 08:15:25 [INFO] [1/1620] Checking Novák Jan (1234567890)
|
||
2026-01-26 08:15:26 [INFO] ✔ OK (VZP)
|
||
```
|
||
|
||
---
|
||
|
||
## Skript 2: Ověření proti medicus (report)
|
||
|
||
**Soubor:** `10 Ověření proti medicus.py`
|
||
|
||
Porovná registrované pacienty v Medicus s posledním zaznamenaným pojistným stavem v MySQL. Pacienty s neaktivním pojištěním (`stav != "1"`) vypíše do PDF reportu včetně přesného data zlomu pojištění.
|
||
|
||
### Postup
|
||
|
||
1. Načte registrované pacienty z Medicus
|
||
2. Z MySQL vezme **poslední** stav pojištění pro každé RC (pomocí `ROW_NUMBER() OVER PARTITION BY rc ORDER BY k_datu DESC`)
|
||
3. Vybere "podezřelé" — registrovaní v Medicus, ale stav `!= "1"`
|
||
4. Pro každého podezřelého provede **binární hledání** data zlomu:
|
||
- hledá mezi `MAX(k_datu WHERE stav='1')` a dneškem
|
||
- výsledek: `insured_to` (poslední den pojištění) a `uninsured_from` (první den bez pojištění)
|
||
5. Vygeneruje HTML přes Jinja2 šablonu a převede na PDF přes WeasyPrint
|
||
6. PDF otevře automaticky v systémovém prohlížeči
|
||
|
||
### Šablona a výstup
|
||
|
||
- Šablona: `Templates/vzp_console_report.html`
|
||
- Fonty: `Templates/fonts/DejaVuSans*.ttf`
|
||
- Výstup: `Output/kontrola_pojisteni_YYYY-MM-DD_HH-MM-SS.pdf`
|
||
|
||
---
|
||
|
||
## Databáze
|
||
|
||
### Tabulka `vzp_stav_pojisteni` (MySQL, `medevio`)
|
||
|
||
| Sloupec | Typ | Popis |
|
||
|---|---|---|
|
||
| `id` | INT AUTO_INCREMENT | Primární klíč |
|
||
| `rc` | VARCHAR(20) | Rodné číslo pacienta |
|
||
| `prijmeni` | VARCHAR(100) | Příjmení |
|
||
| `jmeno` | VARCHAR(100) | Jméno |
|
||
| `k_datu` | DATE | Datum, ke kterému byl stav zjišťován |
|
||
| `stav` | VARCHAR(10) | `"1"` = pojištěn, ostatní = problém |
|
||
| `kod_pojistovny` | VARCHAR(10) | Kód pojišťovny dle VZP odpovědi |
|
||
| `nazev_pojistovny` | VARCHAR(100) | Název pojišťovny |
|
||
| `pojisteni_kod` | VARCHAR(20) | Kód druhu pojištění |
|
||
| `stav_vyrizeni` | INT | `stavVyrizeniPozadavku` ze SOAP odpovědi |
|
||
| `response_xml` | MEDIUMTEXT | Celá SOAP XML odpověď od VZP |
|
||
| `created_at` | TIMESTAMP | Čas vložení záznamu |
|
||
|
||
**Indexy:** `idx_rc (rc)`, `idx_rc_k_datu (rc, k_datu)`, `idx_rc_stav (rc, stav)`
|
||
|
||
### Klíčové SQL dotazy skriptů
|
||
|
||
```sql
|
||
-- Inkrementální filtr (skript 1)
|
||
SELECT MAX(k_datu) AS last_check FROM vzp_stav_pojisteni WHERE rc = ?
|
||
|
||
-- Poslední stav každého pacienta (skript 2)
|
||
SELECT rc, stav FROM (
|
||
SELECT rc, stav,
|
||
ROW_NUMBER() OVER (PARTITION BY rc ORDER BY k_datu DESC) AS rn
|
||
FROM vzp_stav_pojisteni
|
||
) t WHERE rn = 1
|
||
|
||
-- Poslední den aktivního pojištění (pro binární hledání)
|
||
SELECT MAX(k_datu) AS last_insured
|
||
FROM vzp_stav_pojisteni WHERE rc = ? AND stav = '1'
|
||
```
|
||
|
||
---
|
||
|
||
## VZP B2B API
|
||
|
||
### Třída `VZPB2BClient`
|
||
|
||
**Autentizace:** mTLS — klientský PFX certifikát přes `requests_pkcs12.Pkcs12Adapter`
|
||
|
||
**Metody:**
|
||
|
||
| Metoda | SOAP služba | Popis |
|
||
|---|---|---|
|
||
| `stav_pojisteni(rc, k_datu)` | `stavPojisteniB2B` | Ověří pojistný stav pacienta k datu |
|
||
| `parse_stav_pojisteni(xml)` | — | Parsuje XML odpověď na dict |
|
||
| `over_prukaz_pojistence(cislo, k_datu)` | `OverPrukazPojistenceB2B` | Ověří průkaz pojištěnce (EHIC) |
|
||
|
||
**Prostředí:**
|
||
|
||
| ENV | URL |
|
||
|---|---|
|
||
| `prod` | `https://prod.b2b.vzp.cz/B2BProxy/HttpProxy/stavPojisteniB2B` |
|
||
| `simu` | `https://simu.b2b.vzp.cz/B2BProxy/HttpProxy/SIMUstavPojisteniB2B` |
|
||
|
||
**Návratová struktura `parse_stav_pojisteni()`:**
|
||
|
||
```python
|
||
{
|
||
"stavVyrizeni": int, # stavVyrizeniPozadavku ze SOAP
|
||
"stav": str, # "1" = pojištěn
|
||
"kodPojistovny": str, # např. "111"
|
||
"nazevPojistovny": str, # např. "VZP"
|
||
"pojisteniKod": str
|
||
}
|
||
```
|
||
|
||
---
|
||
|
||
## Medicus DB
|
||
|
||
### Třída `MedicusDB`
|
||
|
||
Připojení: Firebird (`fdb`), `192.168.1.4`, charset `WIN1250`, user `SYSDBA`.
|
||
|
||
**Metoda `get_active_registered_patients()`** — vrací pacienty splňující:
|
||
- `registr.datum_zruseni IS NULL` — registrace není zrušená
|
||
- `registr.priznak IN ('A','D','V')` — aktivní typy registrace
|
||
- `kar.rodcis IS NOT NULL AND kar.rodcis <> ''` — má rodné číslo
|
||
- `kar.vyrazen <> 'A'` — pacient není vyřazen
|
||
|
||
---
|
||
|
||
## Kapacitní odhad
|
||
|
||
| Parametr | Hodnota |
|
||
|---|---|
|
||
| Počet pacientů | ~1 600 |
|
||
| Velikost XML odpovědi | ~500–1 500 B |
|
||
| Přírůstek dat | ~1,6 MB/den |
|
||
| Přírůstek řádků | ~1 600/den |
|
||
| Roční objem | ~580 MB / ~580 000 řádků |
|
||
| Limit MEDIUMTEXT | 16 MB/řádek — bez problémů |
|
||
|
||
---
|
||
|
||
## Spuštění
|
||
|
||
```bash
|
||
# 1. Denní sběr dat (ideálně naplánovat přes Task Scheduler)
|
||
python "10 FinalSaveInsuranceStatusScript(R).py"
|
||
|
||
# 2. Vygenerování PDF reportu (na vyžádání)
|
||
python "10 Ověření proti medicus.py"
|
||
```
|