ordinaceprojekt/Medevio/60 ScansProcessing/naming_rules.md

Pravidla pro přejmenování souborů

Tato pravidla platí vždy při generování polí poznamka a nazev_souboru.

1. Název souboru má vždy tvar: RODNECISLO YYYY-MM-DD Příjmení, Jméno [TYP ODBORNOST] [popis].pdf

   • TYP je vždy buď LZ (lékařská zpráva / ambulantní zpráva) nebo PZ (propouštěcí zpráva z hospitalizace).
   • Jiné typy dokumentů (Laboratoř, CT, MRI, kolonoskopie, poukaz FT apod.) nemají TYP prefix — píší se celým názvem: [Laboratoř], [CT břicha] atd.
   • Příklady: [LZ chirurgie], [PZ interna], [Laboratoř], [CT břicha]

2. Když je typ dokumentu PZ (propouštěcí zpráva), umísti do druhé závorky jako první věc data hospitalizace ve tvaru DDMMMYYYY–DDMMMYYYY (měsíc třemi písmeny anglicky, velká, bez mezer), za pomlčkou pak popis.

   • Příklad: [PZ interna] [12–15APR2026 srdeční selhání]
   • Pokud je datum přijetí a propuštění ve stejném měsíci, stačí: [12–15APR2026 ...]
   • Pokud datum hospitalizace nelze určit, druhou závorku napiš bez datumu.

3. Když je dokument typ "Laboratoř", do poznamka uváděj POUZE hodnoty mimo normu (patologické nálezy) — hodnoty v normě vynech. Osmolalitu séra (Osmolalita, Osm, osmolality) NIKDY nezmiňuj — ani když je mimo normu, ani v jakékoli zkratce. Toto je absolutní výjimka: osmolalita se do názvu souboru ani do poznámky nepíše nikdy za žádných okolností. Chybně: C_Osmolalita 293 (↑) — správně: tuto hodnotu zcela vynech.

4. Pokud laboratorní výsledky obsahují glomerulární filtraci — bývá označena jako eGFR, CKD-EPI nebo CK-EPI — do poznamka nikdy nepiš číselnou hodnotu eGFR. Místo toho uveď pouze klasifikaci dle stadií CHRIG1–CHRIG5.

   • NEJDŮLEŽITĚJŠÍ — jednotka: Hodnota glomerulární filtrace bývá v ČR uvedena ve dvou různých jednotkách a klasifikace stadia se MUSÍ dělat až po převodu na ml/min:
     • ml/s (resp. ml/sec, ml/s/1.73m²) — typicky malá čísla cca 0.2–2.3 (např. 0.8, 1.27, 1.5). Tuto hodnotu přenásob ×60, abys dostal ml/min.
     • ml/min (resp. ml/min/1.73m²) — typicky velká čísla 5–140 (např. 55, 68, 90). Použij přímo.
   • POZOR na typickou chybu: malé číslo jako 1.27 je v ml/s, tj. 1.27 × 60 = 76 ml/min → CHRIG2. NIKDY ho neklasifikuj jako by bylo v ml/min (76 by jinak vyšlo špatně jako CHRIG5). Pokud je hodnota menší než ~3, je téměř jistě v ml/s a patří přenásobit ×60.
   • Klasifikace (vždy až v ml/min/1.73m²): ≥ 90 → CHRIG1, 60–89 → CHRIG2, 45–59 → CHRIG3a, 30–44 → CHRIG3b, 15–29 → CHRIG4, < 15 → CHRIG5.
   • Prahové hodnoty pro orientaci přímo při jednotce ml/s: ≥ 1.50 → G1, 1.00–1.49 → G2, 0.75–0.99 → G3a, 0.50–0.74 → G3b, 0.25–0.49 → G4, < 0.25 → G5.
   • Klasifikaci uváděj pouze pokud je CHRIG2 nebo horší (tj. eGFR < 90 ml/min nebo < 1.50 ml/s) — CHRIG1 je v normě, nezmiňuj ho.
   • Příklady: 1.27 ml/s → CHRIG2, 0.92 ml/s → CHRIG3a, 0.55 ml/s → CHRIG3b, 68 ml/min → CHRIG2, 38 ml/min → CHRIG3b.

5. Když je dokument typ "Laboratoř" a zpráva obsahuje diagnózu (dg., dg:, diagnóza), umísti ji do nazev_souboru jako první část druhé závorky, tedy: [Laboratoř] [dg. XY00 - stručná poznamka].

6. Zkratky a pojmenování: slovo „sono" (sonografie/ultrazvuk) piš vždy malými písmeny — sono břicha, sono ŠŽ, nikoli SONO. Štítnou žlázu označuj vždy zkratkou ŠŽ. Sonografii prsu/prsů (sono mamm., sono mamografie, sono mamma apod.) piš vždy jako sono prsů. Denzitometrii (DEXA, DXA, denzitometrie) piš vždy pouze jako [DXA] — bez prefixu LZ. Algologii piš vždy jako [LZ léčba bolesti]. Dermatovenerologii (dermatologie, dermatovenerologie, kožní) piš vždy jako [LZ kožní]. Angiologii piš vždy jako [LZ cévní].

7. V číselných hodnotách VŽDY používej desetinnou tečku, nikoli desetinnou čárku. Toto pravidlo platí absolutně pro všechna čísla v poznamka i nazev_souboru — např. TG 4.73, nikoli TG 4,73.

8. Rozpoznávání vzorců — sideropenická anémie: Pokud laboratorní výsledky splňují typický obraz sideropenické (železo-deficitní) anémie, přidej diagnózu jako první část druhé závorky ve tvaru [sideropenická anémie, ...]. Typický obraz (stačí kombinace několika z těchto nálezů):

   • Krevní obraz: ↓ Hb, ↓ Htk, ↓ MCV (mikrocytóza), ↓ MCH nebo ↓ MCHC (hypochromie), ↑ RDW (anisocytóza)
   • Metabolismus železa: ↓ sérové Fe (železo), ↓ ferritin, ↑ transferrin (nebo TIBC), ↓ saturace transferrinu
   • Diagnózu uveď pouze pokud je obraz dostatečně přesvědčivý (alespoň ↓ Hb + ↓ MCV nebo ↓ Fe/ferritin).
   • Příklad výsledného názvu: [Laboratoř] [sideropenická anémie, Hb 98, MCV 71, Fe 5.2]

9. Jaterní enzymy (ALT, AST, GGT, ALP, LD/LDH) a bilirubin — hodnoty pod dolní hranicí normy (snížené) nezmiňuj v poznamka ani v nazev_souboru. Uváděj pouze hodnoty nad normu (zvýšené).

10. Druhá závorka pro LZ a PZ — obsah a pořadí: Pro dokumenty typu LZ (lékařská zpráva) a PZ (propouštěcí zpráva) tvoří druhou závorku tyto části v tomto pořadí (oddělené čárkou): a) Typ návštěvy — uveď pouze pokud je explicitně rozpoznatelný ze zprávy:

    • kontrola — plánovaná kontrola (např. „plánovaná kontrola", „přichází na kontrolu")
    • neplánovaná kontrola — pokud je výslovně uvedeno, že kontrola nebyla plánovaná
    • akutní — pacient přichází do akutní ambulance nebo cestou RZS/záchranné služby
    • Pokud typ návštěvy není ve zprávě uveden, tuto část zcela vynech (nepsat žádný fallback). b) Hlavní diagnóza — získej z části „Diagnózy", „Závěr" nebo „Dg." — uveď první (hlavní) diagnózu, která je obvykle důvodem návštěvy. Stručně, výstižně. c) Termín příští plánované kontroly — pokud je na konci dokumentu uveden konkrétní plánovaný termín příští kontroly (např. „jaro 2027", „za 3 měsíce", „ročně"), umísti ho jako poslední část druhé závorky.
    • Uváděj pouze explicitně naplánované termíny — formát: ko + termín bez mezery, např. ko jaro2027, ko za6m, ko ročně.
    • Nezahrn podmíněné návštěvy jako „dle obtíží", „při zhoršení", „při hematurii ihned" apod. — ty jsou samozřejmé a do názvu nepatří.
    • Pokud dokument žádný plánovaný termín neobsahuje, tuto část vynech.
    • Příklad (s typem návštěvy): [LZ kardiologie] [kontrola, ICHS, ko za3m]
    • Příklad (bez typu návštěvy): [LZ neurologie] [migréna, pokračovat v léčbě]
    • Příklad akutní: [LZ interna] [akutní, dekompenzovaná hypertenze, hospitalizace]
    • Příklad s termínem kontroly: [LZ urologie] [kontrola, hematurie microsc., angiomyolipoma renis, ko jaro2027]
    • Pro PZ zůstává datum hospitalizace jako první (před typem návštěvy), viz pravidlo 2.

11. Datum v názvu souboru nesmí být v budoucnosti: Pokud datum nalezené na zprávě a navrhované pro název souboru je pozdější než dnešní datum, je to chyba (např. špatně rozpoznané číslo). Hledej na zprávě jiné datum. Pokud žádné vhodné datum nenajdeš, použij dnešní datum.

12. Poukaz domácí péče (DP): Dokument nadepsaný „POUKAZ NA VYŠETŘENÍ / OŠETŘENÍ DP" nebo „poukaz domácí péče" se pojmenovává takto:

    • První závorka: vždy [domácí péče] (bez prefixu LZ/PZ).
    • Datum souboru: pole „Datum" na poukazu (datum vystavení), ve formátu YYYY-MM-DD.
    • Druhá závorka obsahuje v tomto pořadí, odděleno čárkou: a) Číslo poukazu — pole „Pořadové číslo poukazu" (celé číslo, např. 1). b) Platnost — „do DDMMMYYYY" kde datum je z pole „Platnost do" (měsíc třemi velkými písmeny anglicky, bez mezer), např. do 30JUN2026. c) Výkony — každý výkon (kód ze sloupce „Požadováno") se uvede jako:
      • {kód} ad hoc — pokud je u výkonu uvedeno 0x týdně (bez ohledu na četnost denně); znamená to výkon pouze dle potřeby, ne na pravidelné bázi.
      • {kód} {N}xd{M}xt — pokud je týdenní četnost M > 0; N = četnost denně, M = četnost týdně. Např. pro 1x denně 3x týdně: 06313 1xd3xt.
    • Příklad (oba výkony ad hoc): [domácí péče] [1 do 30JUN2026, 06313 ad hoc, 06323 ad hoc]
    • Příklad (pravidelné výkony): [domácí péče] [2 do 31AUG2026, 06313 1xd5xt, 06321 2xd7xt]

13. Posudek na řidičské oprávnění: Lékařský posudek o zdravotní způsobilosti k řízení motorových vozidel má v první závorce vždy [posudek ŘP] — bez prefixu LZ, nikdy varianty jako [lékařský posudek řidič], [posudek řidičský průkaz] apod.

    • Příklad: 400828108 2026-06-09 Šebek, Josef [posudek ŘP] [zdravotně způsobilý s podmínkou A1, AM, B1, B s brýlemi, platnost do 09.06.2028]

14. Prohlášení posuzované osoby ke zdravotní způsobilosti pro řidičské oprávnění: První závorka je vždy [prohlášení ŘP] — nikdy varianty jako [Prohlášení zdravotní způsobilosti], [prohlášení posuzované osoby] apod.

    • Příklad: 400828108 2026-06-09 Šebek, Josef [prohlášení ŘP] [cítí se zdráv, užívá metformin, ACI, léky na kyselinu močovou, na tuky]