cry-vetzdravila 1.0.0

package/src/register/stats.ts

@@ -0,0 +1,114 @@
+/**
+ * Statistika učinkovitosti uganiZdravilo
+ *
+ * Izvede teste na zdravilih iz zdravila.json in izpiše statistiko po številu najdenih zadetkov.
+ */
+
+import testData from "../test/zdravila.json";
+import { uganiZdraviloInUtemelji } from "./uganiZdravilo";
+
+interface ZdraviloTest {
+	naziv: string;
+	skupine: string[];
+}
+
+interface TestResult {
+	naziv: string;
+	resultCount: number;
+	topMatches: { ime: string; ocena: number }[];
+}
+
+function runTest(zdravilo: ZdraviloTest): TestResult {
+	const results = uganiZdraviloInUtemelji(zdravilo.naziv, { limit: 5 });
+
+	return {
+		naziv: zdravilo.naziv,
+		resultCount: results.length,
+		topMatches: results.slice(0, 3).map((r) => ({
+			ime: r.zdravilo.ime,
+			ocena: r.utemeljitev.ocena,
+		})),
+	};
+}
+
+async function main() {
+	console.log("═══════════════════════════════════════════════════════════════");
+	console.log("          STATISTIKA UČINKOVITOSTI uganiZdravilo");
+	console.log("═══════════════════════════════════════════════════════════════\n");
+
+	const zdravila = testData as ZdraviloTest[];
+	const results: TestResult[] = [];
+
+	console.log(`Testiram ${zdravila.length} zdravil iz zdravila.json...\n`);
+
+	for (const zdravilo of zdravila) {
+		const result = runTest(zdravilo);
+		results.push(result);
+	}
+
+	// Razvrsti rezultate po številu zadetkov
+	const poSteviluZadetkov: Record<number, TestResult[]> = {};
+
+	for (const result of results) {
+		const count = result.resultCount;
+		if (!poSteviluZadetkov[count]) {
+			poSteviluZadetkov[count] = [];
+		}
+		poSteviluZadetkov[count].push(result);
+	}
+
+	// Izpis statistike
+	console.log("═══════════════════════════════════════════════════════════════");
+	console.log("                 STATISTIKA PO ŠTEVILU ZADETKOV");
+	console.log("═══════════════════════════════════════════════════════════════\n");
+
+	const skupaj = results.length;
+	const stevilke = Object.keys(poSteviluZadetkov)
+		.map(Number)
+		.sort((a, b) => a - b);
+
+	for (const stevilo of stevilke) {
+		const seznam = poSteviluZadetkov[stevilo];
+		const procent = ((seznam.length / skupaj) * 100).toFixed(1);
+		console.log(`  ${stevilo} zadetkov: ${seznam.length} (${procent}%)`);
+	}
+
+	console.log(`\n  SKUPAJ: ${skupaj} zdravil`);
+
+	// Izpis zdravil brez zadetka
+	const brezZadetka = poSteviluZadetkov[0] || [];
+	if (brezZadetka.length > 0) {
+		console.log("\n───────────────────────────────────────────────────────────────");
+		console.log("ZDRAVILA BREZ ZADETKA:");
+		console.log("───────────────────────────────────────────────────────────────\n");
+
+		for (const z of brezZadetka) {
+			console.log(`  • ${z.naziv}`);
+		}
+	}
+
+	// Izpis vzorca zdravil z zadetki
+	const zZadetki = results.filter((r) => r.resultCount > 0).slice(0, 10);
+	if (zZadetki.length > 0) {
+		console.log("\n───────────────────────────────────────────────────────────────");
+		console.log("VZOREC ZDRAVIL Z ZADETKI (prvih 10):");
+		console.log("───────────────────────────────────────────────────────────────\n");
+
+		for (const z of zZadetki) {
+			console.log(`  • ${z.naziv}`);
+			for (let i = 0; i < z.topMatches.length; i++) {
+				const match = z.topMatches[i];
+				console.log(`      ${i + 1}. ${match.ime} (ocena: ${match.ocena})`);
+			}
+		}
+	}
+
+	console.log("\n═══════════════════════════════════════════════════════════════\n");
+}
+
+if (import.meta.main) {
+	main().catch((e) => {
+		console.error("Napaka:", e);
+		process.exit(1);
+	});
+}

package/src/register/types/KarencaZdravila.ts

@@ -0,0 +1,26 @@
+import { ZivalskeVrste } from "./ZivalskeVrste"
+
+import { MozneKarenceZa, PotiAplikacijeZdravila } from "cry-klikvet-logic";
+/**
+ * Karance po živalskih vrsta in morebiti po poteh aplikacije
+ * 
+ * primer 1:
+ *  {
+ *   'prašiči': { meso: 20, 'not. organi': 20 },
+ *   konji: { meso: 10, 'not. organi': 10 },
+ *   govedo: {
+ *     meso: 31,
+ *     'not. organi': 31,
+ *     mleko: 2,
+ *     pot: { IV: { meso: 10, 'not. organi': 10, mleko: 1 } }
+ *   }
+ * }
+ */
+
+type KarencaVrste = {
+	vrsta: keyof typeof ZivalskeVrste;
+	pot?: keyof typeof PotiAplikacijeZdravila;
+	karence: Partial<Record<MozneKarenceZa, number>>;
+};
+
+export type KarencaZdravila = KarencaVrste;

package/src/register/types/PotUporabeZdravila.ts

@@ -0,0 +1,21 @@
+/**
+ * Pot uporabe zdravila
+ * Na primer, za podatek v stolpcu xslx "-1081\Subkutana uporaba"
+ * const potUpora : PotUporabeZdravila = {
+ * sifra: 1081,
+ * opis: "Subkutana uporaba",
+ * koda: "SC"
+ * }
+ */
+export interface PotUporabeZdravila {
+	/** numerična šifra poti uprabe
+	 * primer: 1081
+	*/
+	sifra: number
+	/**
+	 * opis uporabe
+	 * primer: Subkutana uporaba
+	 */
+	opis: string
+	koda: string[]
+}

package/src/register/types/RazclembaZdravila.ts

@@ -0,0 +1,10 @@
+import type { RazclenjeniNaziv } from "../helper/normalizirajNaziv";
+import type { Zdravilo } from "./Zdravilo";
+
+/**
+ * Predpripravljena razčlemba zdravila
+ */
+export interface RazclembaZdravila {
+	zdravilo: Zdravilo;
+	razclemba: RazclenjeniNaziv;
+}

package/src/register/types/RegisterRaw.ts

@@ -0,0 +1,23 @@
+import { Zdravilo } from "./Zdravilo";
+
+/**
+ * Register veterinarskih zdravil
+ *
+ * Vsebuje seznam vseh zdravil in metapodatke o registru.
+ */
+export interface RegisterRaw {
+	/** Datum datoteke iz katere je bil register ustvarjen */
+	datumDatoteke: Date;
+
+	/** Datum in čas parsanja */
+	datumParsanja: Date;
+
+	/** Pot do izvorne xlsx datoteke */
+	izvornaDateteka: string;
+
+	/** Seznam vseh zdravil v registru */
+	zdravila: Zdravilo[];
+
+	/** Število zdravil v registru */
+	steviloZdravil: number;
+}

package/src/register/types/RegisterZdravil.ts

@@ -0,0 +1,3 @@
+import { Zdravilo } from "./Zdravilo";
+
+export type RegisterZdravil = Map<number, Zdravilo>;

package/src/register/types/UcinkovinaZdravila.ts

@@ -0,0 +1,21 @@
+
+/**
+ * Opisuje učinkovino zdravila in njeno količino v pakiranju.
+ * Primer: za stolpca v xslx
+ * 	- " -1\prokainijev benzilpenicilinat monohidrat  -2\dihidrostreptomicinijev sulfat -3\vitamin A palmitat -4\kalcijev pantotenat"
+ *  - " -1\ 1000000,0 IU  -2\ 1000000,0 IU  -3\ 10000,0 IU  -4\ 100,0 mg"
+ * so ucinkovine
+ * const ucinkovine : UcinkovinaZdravila[]  = [
+ * { ucinkovina: "prokainijev benzilpenicilinat monohidrat", kolicina: 1000000.0, enota: "IU" },
+ * { ucinkovina: "dihidrostreptomicinijev sulfat", kolicina: 1000000.0, enota: "IU" },
+ * { ucinkovina: "dihidrostreptomicinijev sulfat", kolicina: 1000000.0, enota: "IU" },
+ * { ucinkovina: "vitamin A palmitat", kolicina: 10000.0, enota: "IU" },
+ * { ucinkovina: "kalcijev pantotenat", kolicina: 100.0, enota: "mg" },
+ * ]
+ */
+export interface UcinkovinaZdravila {
+	ucinkovina: string
+	kolicina?: number  
+	enota: string
+	dodatneInformacije?: string
+}

package/src/register/types/Zdravilo.ts

@@ -0,0 +1,84 @@
+import { UcinkovinaZdravila } from "./UcinkovinaZdravila";
+import { PotUporabeZdravila } from "./PotUporabeZdravila";
+import { KarencaZdravila } from "./KarencaZdravila";
+
+/**
+ * Podatki o veterinarskem zdravilu iz registra JAZMP
+ */
+export interface Zdravilo {
+
+	/** id zdravila, izračunan kot hash */
+	id: number 
+
+	/** Ime zdravila */
+	ime: string;
+
+	/** Imetnik dovoljenja za promet z zdravilom */
+	imetnikDovoljenja: string;
+
+	/** Podatki o sproščanju zdravila */
+	sproscanjeZdravila: string;
+
+	/** Številka dovoljenja za promet */
+	stevilkaDovoljenja: string;
+
+	/** Datum veljavnosti dovoljenja */
+	datumVeljavnosti: string | null;
+
+	/** Režim izdaje (npr. Rp - na recept) */
+	rezimIzdaje: string;
+
+	/** ATC koda zdravila */
+	atcKoda: string;
+
+	/** Poti uporabe zdravila */
+	potiUporabe: PotUporabeZdravila[];
+
+	/** Farmacevtska oblika zdravila */
+	farmacevtskaOblika: string;
+
+	/** Opis pakiranj */
+	pakiranja: string;
+
+	/** Enota količine za sestavo */
+	enotaKolicine: string;
+
+	/** Seznam učinkovin in njihovih količin */
+	ucinkovine: UcinkovinaZdravila[];
+
+	/** Pomožne snovi v zdravilu */
+	pomocneSnovi: string[];
+
+	/** Ciljne živalske vrste */
+	ciljneVrste: string[];
+
+	/** Karenca zdravila po vrstah */
+	karence: KarencaZdravila[];
+
+	/** Če je zdravilo vakcina, proti čemu varuje */
+	vakcinaZa?: string[]
+}
+
+/**
+ * Stolpci v xlsx datoteki JAZMP registra
+ */
+export const XLSX_COLUMNS = {
+	IME_ZDRAVILA: 0,
+	IMETNIK_DOVOLJENJA: 1,
+	SPROSCANJE_ZDRAVILA: 2,
+	STEVILKA_DZP: 3,
+	DATUM_VELJAVNOSTI: 4,
+	REZIM_IZDAJE: 5,
+	ATC: 6,
+	POTI_UPORABE: 7,
+	FARMACEVTSKA_OBLIKA: 8,
+	PAKIRANJA: 9,
+	ENOTA_KOLICINE: 10,
+	UCINKOVINE: 11,
+	KOLICINE_UCINKOVIN: 12,
+	UCINKOVINE_DODATNE_INFO: 13,
+	POMOCNE_SNOVI: 14,
+	CILJNE_VRSTE: 15,
+	KARENCA_START: 16,
+	KARENCA_END: 54,
+} as const;

package/src/register/types/ZdraviloZUtemeljitvijo.ts

@@ -0,0 +1,11 @@
+import type { UtemeljitevOcene } from "../helper/oceniPodobnost";
+import type { Zdravilo } from "./Zdravilo";
+
+/**
+ * Rezultat iskanja zdravila z utemeljitvijo
+ */
+
+export interface ZdraviloZUtemeljitvijo {
+	zdravilo: Zdravilo;
+	utemeljitev: UtemeljitevOcene;
+}

package/src/register/types/ZivalskeVrste.ts

@@ -0,0 +1,7 @@
+import { skupneEntitete  } from "cry-klikvet-logic"
+
+
+/**
+ * Širant živalskih vrst
+ */
+export const ZivalskeVrste = skupneEntitete.vrsteZivali;

package/src/register/uganiZdravilo.ts

@@ -0,0 +1,142 @@
+/**
+ * Iskanje zdravil po imenu
+ *
+ * Omogoča iskanje zdravil iz registra po podobnosti imena.
+ */
+
+import type { Zdravilo } from "./types/Zdravilo";
+import { razcleniNaziv } from "./helper/razcleniNaziv";
+import { oceniPodobnost } from "./helper/oceniPodobnost";
+import { RazclembaZdravila } from "./types/RazclembaZdravila";
+import { ZdraviloZUtemeljitvijo } from "./types/ZdraviloZUtemeljitvijo";
+import { oblikujRezultatIskanja } from "./helper/oblikujRezultatIskanja";
+import { MIN_OCENA_PODOBNOSTI } from "./MIN_OCENA_PODOBNOSTI";
+import { seznamZdravil } from "../generated/seznamZdravil";
+
+/**
+ * Opcije za iskanje zdravil
+ */
+export interface UganiZdraviloOpts {
+	/** Maksimalno število rezultatov (privzeto 10) */
+	limit?: number;
+	/** Minimalna ocena podobnosti (privzeto MIN_OCENA_PODOBNOSTI) */
+	minOcena?: number;
+	/** Išči samo med zdravili s temi ID-ji */
+	isciMed?: number[];
+}
+
+/**
+ * Cache razčlemb registra (module scope)
+ */
+let razclembeRegistra: RazclembaZdravila[] | null = null;
+
+/**
+ * Cache razčlemb registra po ID-ju
+ */
+let razclembeRegistraPoId: Map<number, RazclembaZdravila> | null = null;
+
+/**
+ * Pripravi razčlembe vseh zdravil iz registra
+ */
+function pripraviRazclembeRegistra(): RazclembaZdravila[] {
+	if (razclembeRegistra !== null) {
+		return razclembeRegistra;
+	}
+
+	razclembeRegistra = seznamZdravil.map((zdravilo) => ({
+		zdravilo,
+		razclemba: razcleniNaziv(zdravilo.ime),
+	}));
+
+	// Pripravi tudi mapo po ID-ju
+	razclembeRegistraPoId = new Map();
+	for (const r of razclembeRegistra) {
+		razclembeRegistraPoId.set(r.zdravilo.id, r);
+	}
+
+	return razclembeRegistra;
+}
+
+/**
+ * Vrne razčlembe za dane ID-je zdravil
+ */
+function razclembeZaIdje(idji: number[]): RazclembaZdravila[] {
+	// Zagotovi, da je cache pripravljen
+	pripraviRazclembeRegistra();
+
+	const rezultat: RazclembaZdravila[] = [];
+	for (const id of idji) {
+		const razclemba = razclembeRegistraPoId!.get(id);
+		if (razclemba) {
+			rezultat.push(razclemba);
+		}
+	}
+	return rezultat;
+}
+
+/**
+ * Poišči zdravila po podobnosti imena in vrni z utemeljitvami
+ *
+ * @param vhodniNaziv - Iskalni niz (ime zdravila)
+ * @param opts - Opcije iskanja (limit, minOcena, isciMed)
+ * @returns Seznam zdravil z utemeljitvami, sortirano po oceni padajoče
+ */
+export function uganiZdraviloInUtemelji(
+	vhodniNaziv: string,
+	opts: UganiZdraviloOpts = {}
+): ZdraviloZUtemeljitvijo[] {
+	const { limit = 10, minOcena = MIN_OCENA_PODOBNOSTI, isciMed } = opts;
+
+	// Pripravi razčlembe - če je isciMed podan, išči samo med njimi
+	const razclembe = isciMed
+		? razclembeZaIdje(isciMed)
+		: pripraviRazclembeRegistra();
+
+	// Razčleni vhodni naziv
+	const razclembaVhoda = razcleniNaziv(vhodniNaziv);
+
+	// Izračunaj podobnosti
+	const rezultati: ZdraviloZUtemeljitvijo[] = [];
+
+	for (const { zdravilo, razclemba } of razclembe) {
+		const utemeljitev = oceniPodobnost(razclembaVhoda, razclemba);
+		// Dodaj samo zadetke z oceno >= minOcena
+		if (utemeljitev.ocena >= minOcena) {
+			rezultati.push({ zdravilo, utemeljitev });
+		}
+	}
+
+	// Sortiraj po oceni padajoče
+	rezultati.sort((a, b) => b.utemeljitev.ocena - a.utemeljitev.ocena);
+
+	// Vrni prvih "limit" rezultatov
+	return rezultati.slice(0, limit);
+}
+
+/**
+ * Poišče zdravila v registru zdravil po podobnosti imena.
+ * Vrne seznam `limit` najboljših zadetkov in, če obstaja, najboljši zadetek.
+ *
+ * Zadetek je najboljši, če je edini ali če ima edini najvišjo oceno.
+ *
+ * @param vhodniNaziv - Iskalni niz (ime zdravila)
+ * @param opts - Opcije iskanja (limit, minOcena, isciMed)
+ * @returns { zadetki, najboljsi }
+ */
+export function uganiZdravilo(
+	vhodniNaziv: string,
+	opts: UganiZdraviloOpts = {}
+): {
+	zadetki: { zdravilo: Zdravilo, ocena: number }[],
+	najboljsi: Zdravilo | undefined
+}
+{
+	const rezultati = uganiZdraviloInUtemelji(vhodniNaziv, opts);
+	const { zadetki, najboljsi } = oblikujRezultatIskanja(rezultati);
+
+	return {
+		zadetki,
+		najboljsi,
+	}
+}
+

package/src/register/zdravilaZaAtcVetKodo.ts

@@ -0,0 +1,28 @@
+import { seznamZdravil } from "../generated/seznamZdravil";
+import type { Zdravilo } from "./types/Zdravilo";
+
+/**
+ * Vrne seznam zdravil, ki se začnejo z dano atcVet kodo.
+ * Seznam je urejen po ATCvet kodah.
+ * @param atcVetKoda ATCvet koda ali njen prefiks (npr. "QJ01", "QJ01CA04")
+ * @returns Seznam zdravil z ustrezno ATCvet kodo, urejen po kodah
+ */
+export function zdravilaZaAtcVetKodo(atcVetKoda: string): Zdravilo[] {
+	
+	if (!atcVetKoda) return [];
+	if (!atcVetKoda.toUpperCase().startsWith("Q")) return [];
+
+	const koda = atcVetKoda.toUpperCase();
+	const zdravila = seznamZdravil.filter(z =>
+		z.atcKoda && z.atcKoda.toUpperCase().startsWith(koda)
+	);
+
+	// Uredi po ATCvet kodi
+	zdravila.sort((a, b) => {
+		const kodaA = a.atcKoda || "";
+		const kodaB = b.atcKoda || "";
+		return kodaA.localeCompare(kodaB);
+	});
+
+	return zdravila;
+}