notebookvb

2026-04-18 07:44:30 +02:00
parent 4354285625
commit ed2e7c7c5a
8 changed files with 428 additions and 0 deletions
@@ -0,0 +1,105 @@
 <?xml version="1.0" encoding="UTF-8" ?>
 <xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema"
            xmlns="http://xmlns.gemsystem.cz/CommonB2B"
            targetNamespace="http://xmlns.gemsystem.cz/CommonB2B"
            elementFormDefault="qualified">
 	<xsd:annotation>
 		<xsd:documentation>$Revision: 30974 $</xsd:documentation> 
 		<xsd:documentation>$Date: 2010-12-23 09:43:29 +0100 (čt, 23 XII 2010) $</xsd:documentation> 
 		<xsd:documentation>$Author: jserak $</xsd:documentation> 
 	</xsd:annotation>             
  <xsd:simpleType name="IdZpravyTyp">
    <xsd:annotation>
      <xsd:documentation>
        Datový typ pro identifikátory zpráv protokolu AS2.
        Povolenými hodnotami jsou řetězce délky max. 12 obsahující výhradně
        alfanumerické znaky.
      </xsd:documentation>
    </xsd:annotation>
    <xsd:restriction base="xsd:string">
      <xsd:pattern value="[0-9A-Za-z]{1,12}"/>
    </xsd:restriction>
  </xsd:simpleType>
  <xsd:simpleType name="IdSubjektuTyp">
    <xsd:annotation>
      <xsd:documentation>
        Datový typ pro identifikátory subjektů. Nejdelším identifikátorem
        subjektu je číslo pojištěnce (včetně příznaku), tj. 12 znaků.
      </xsd:documentation>
    </xsd:annotation>
    <xsd:restriction base="xsd:string">
      <xsd:minLength value="1"/>
      <xsd:maxLength value="12"/>
    </xsd:restriction>
  </xsd:simpleType>
  <xsd:simpleType name="TypSubjektuTyp">
    <xsd:annotation>
      <xsd:documentation>
        Datový typ pro typ subjektu. Je definován jako enumerace povolených
        hodnot.
      </xsd:documentation>
    </xsd:annotation>
    <xsd:restriction base="xsd:string">
      <xsd:enumeration value="poj"/>
      <xsd:enumeration value="osvc"/>
      <xsd:enumeration value="zam"/>      
      <xsd:enumeration value="zp"/>
      <xsd:enumeration value="si"/>
      <xsd:enumeration value="se"/>      
      <xsd:enumeration value="fr"/>      
      <xsd:enumeration value="zzp"/>
      <xsd:enumeration value="partner"/>
    </xsd:restriction>
  </xsd:simpleType>
  <xsd:simpleType name="UzemniPracovisteTyp">
    <xsd:restriction base="xsd:string">
      <xsd:pattern value="[1-9][0-9]00"/>
    </xsd:restriction>
  </xsd:simpleType>
  <xsd:simpleType name="CisloPojistenceTyp">
    <xsd:restriction base="xsd:string">
      <xsd:pattern value="\d{9,10}"/>
    </xsd:restriction>
  </xsd:simpleType>
  <xsd:simpleType name="NazevSouboruTyp">
    <xsd:restriction base="NonemptyString">
      <xsd:maxLength value="20"/>
    </xsd:restriction>
  </xsd:simpleType>
  <xsd:simpleType name="MimeTypeTyp">
    <xsd:restriction base="NonemptyString">
      <xsd:maxLength value="50"/>
    </xsd:restriction>
  </xsd:simpleType>
  <xsd:simpleType name="NonemptyString">
    <xsd:restriction base="xsd:string">
      <xsd:minLength value="1"/>
    </xsd:restriction>
  </xsd:simpleType>
  <xsd:simpleType name="StavVyrizeniPozadavkuTyp">
    <xsd:annotation>
      <xsd:documentation>
        <li>0: Data nenalezena</li>
        <li>1: Nalezen jeden záznam nebo obecná návratová hodnota OK</li>
        <li>2: Požadavek byl úspěšně přijat, zpracování bude pokračovat, očekávejte další odpověď</li>
        <li>9: Nalezeno více záznamů</li>
        <li>-1: Technická chyba</li>   
        <li>-2: Chyba vstupních dat</li>   
        <li>-3: Role nemá oprávnění odesílat data</li>   
        <li>-9: Služba přijala požadavek, který bude zpracován později</li>   
        <li>-10: Zpráva je určena pro jiné prostředí</li>           
      </xsd:documentation>
    </xsd:annotation>
    <xsd:restriction base="xsd:integer">
        <xsd:enumeration value="0"/>
        <xsd:enumeration value="1"/>
        <xsd:enumeration value="2"/>
        <xsd:enumeration value="9"/>
        <xsd:enumeration value="-1"/>
        <xsd:enumeration value="-2"/>
        <xsd:enumeration value="-3"/>
        <xsd:enumeration value="-9"/>
        <xsd:enumeration value="-10"/>
    </xsd:restriction>
  </xsd:simpleType>  
 </xsd:schema>
@@ -0,0 +1,53 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <definitions
     name="OverPrukazPojistenceB2B"
     targetNamespace="http://xmlns.gemsystem.cz/OverPrukazPojistenceB2B"
     xmlns="http://schemas.xmlsoap.org/wsdl/"
     xmlns:tns="http://xmlns.gemsystem.cz/OverPrukazPojistenceB2B"
     xmlns:plnk="http://schemas.xmlsoap.org/ws/2003/05/partner-link/"
     xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/"
     xmlns:client="http://xmlns.gemsystem.cz/OverPrukazPojistenceB2B"
    >
    <documentation>$Revision: 28785 $ 
   $Date: 2010-11-08 14:10:25 +0100 (po, 08 XI 2010) $ 
   $Author: jserak $</documentation>
    <types>
        <schema xmlns="http://www.w3.org/2001/XMLSchema">
            <import namespace="http://xmlns.gemsystem.cz/OverPrukazPojistenceB2B" schemaLocation="OverPrukazPojistenceB2B.xsd"/>
        </schema>
    </types>
    <message name="OverPrukazPojistenceB2BRequestMessage">
        <part name="payload" element="tns:OverPrukazPojistenceB2BPozadavek"/>
    </message>
    <message name="OverPrukazPojistenceB2BResponseMessage">
        <part name="payload" element="tns:OverPrukazPojistenceB2BOdpoved"/>
    </message>
    <portType name="OverPrukazPojistenceB2B">
        <operation name="process">
            <input message="tns:OverPrukazPojistenceB2BRequestMessage"/>
            <output message="tns:OverPrukazPojistenceB2BResponseMessage"/>
        </operation>
    </portType>
    <binding name="OverPrukazPojistenceB2BBinding" type="tns:OverPrukazPojistenceB2B">
        <soap:binding style="document" transport="http://schemas.xmlsoap.org/soap/http"/>
        <operation name="process">
            <soap:operation style="document" soapAction="process"/>
            <input>
                <soap:body use="literal"/>
            </input>
            <output>
                <soap:body use="literal"/>
            </output>
        </operation>
    </binding>
    <service name="OverPrukazPojistenceB2B">
        <port name="OverPrukazPojistenceB2BPort" binding="tns:OverPrukazPojistenceB2BBinding">
            <soap:address location="*** SERVICE ENDPOINT LOCATION ***"/>
        </port>
    </service>
  <plnk:partnerLinkType name="OverPrukazPojistenceB2B">
    <plnk:role name="OverPrukazPojistenceB2BProvider">
      <plnk:portType name="tns:OverPrukazPojistenceB2B"/>
    </plnk:role>
  </plnk:partnerLinkType>
 </definitions>
@@ -0,0 +1,49 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <xsd:schema attributeFormDefault="unqualified" elementFormDefault="qualified"
            targetNamespace="http://xmlns.gemsystem.cz/OverPrukazPojistenceB2B"
            xmlns:xsd="http://www.w3.org/2001/XMLSchema"
            xmlns="http://xmlns.gemsystem.cz/OverPrukazPojistenceB2B"
            xmlns:cmn="http://xmlns.gemsystem.cz/CommonB2B">
    <xsd:annotation>
      <xsd:documentation>$Revision: 31458 $</xsd:documentation>
      <xsd:documentation>$Date: 2011-01-06 14:54:58 +0100 (čt, 06 I 2011) $</xsd:documentation>
      <xsd:documentation>$Author: msklenar $</xsd:documentation>
    </xsd:annotation>
  <xsd:import schemaLocation="CommonB2B.xsd" namespace="http://xmlns.gemsystem.cz/CommonB2B"/>
    <xsd:element name="OverPrukazPojistenceB2BPozadavek" type="pozadavekB2B"/>
    <xsd:element name="OverPrukazPojistenceB2BOdpoved" type="odpovedB2B"/>
    <xsd:complexType name="pozadavekB2B">
        <xsd:sequence>
            <xsd:element name="cisloPrukazu" type="xsd:string"/>
            <xsd:element name="kDatu" type="xsd:date" minOccurs="0"/>
        </xsd:sequence>
    </xsd:complexType>
    <xsd:complexType name="odpovedB2B">
        <xsd:sequence>
            <xsd:element name="cisloPrukazu" type="xsd:string" minOccurs="0"/>
            <xsd:element name="priznak" type="xsd:string" minOccurs="0">
                <xsd:annotation>
                    <xsd:documentation>
                        příznak rodného čísla - v případě duplicity udává pořadí
                        duplicitního rodného čísla (standardně je 1)
                    </xsd:documentation>
                </xsd:annotation>
            </xsd:element>
            <xsd:element name="datumPlatnosti" type="xsd:date" minOccurs="0"/>
            <xsd:element name="platnost" type="xsd:string" minOccurs="0">
                <xsd:annotation>
                    <xsd:documentation>
                        „A“ – platný průkaz i vyhovující průběh pojištění
                        „N“ – existující ale neplatný průkaz
                        „P“ – existující a platný průkaz ale nevyhovující průběh pojištění
                        „Y“ – více záznamů o průkazu nebo o průběhu pojištění
                        „X“ – neexistující průkaz v evidenci
                    </xsd:documentation>
                </xsd:annotation>
            </xsd:element>
            <xsd:element name="stavVyrizeniPozadavku"
                         type="cmn:StavVyrizeniPozadavkuTyp" />
        </xsd:sequence>
    </xsd:complexType>
 </xsd:schema>
@@ -0,0 +1,221 @@
 # 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"
 ```