# 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"
```
