cry-vetzdravila 1.0.0

package/src/importParseAndBuildAll.ts

@@ -0,0 +1,97 @@
+/**
+ * Prenese in sparsa vse podatke
+ *
+ * 1. Prenese register zdravil (xlsx)
+ * 2. Sparsa register v JSON
+ * 3. Prenese ATCVet PDF
+ * 4. Sparsa ATCVet v JSON
+ * 5. Generira TypeScript datoteke
+ */
+
+import { downloadRegister } from "./register/downloadRegister";
+import { parseRegister, saveRegisterToJson } from "./register/parseRegister";
+import { downloadLatestAtcvetPdf } from "./atcvet/downloadLatestAtcvetPdf";
+import { parseAtcvetPdf } from "./atcvet/parseAtcvetPdf";
+import { ensureGeneratedDir, generateRegisterZdravil, generateAtcVet } from "./generate";
+import type { AtcvetFile } from "./atcvet/types/AtcvetFile";
+import fs from "node:fs";
+import path from "node:path";
+
+async function main() {
+	console.log("═══════════════════════════════════════════════════════════════");
+	console.log("              PRENOS IN PARSANJE VSEH PODATKOV");
+	console.log("═══════════════════════════════════════════════════════════════\n");
+
+	const startTime = Date.now();
+
+	// 1. Register zdravil
+	console.log("┌─────────────────────────────────────────────────────────────┐");
+	console.log("│ 1. REGISTER ZDRAVIL                                         │");
+	console.log("└─────────────────────────────────────────────────────────────┘\n");
+
+	console.log("Prenašam register zdravil...");
+	const registerPath = await downloadRegister();
+	if (!registerPath) {
+		console.error("Napaka: Prenos registra ni uspel.");
+		process.exit(1);
+	}
+	console.log(`✓ Register prenesen: ${registerPath}\n`);
+
+	console.log("Parsam register zdravil...");
+	const register = await parseRegister(registerPath);
+	await saveRegisterToJson(register, "./data/register.json");
+	console.log(`✓ Register sparsan: ${register.steviloZdravil} zdravil\n`);
+
+	// 2. ATCVet klasifikacija
+	console.log("┌─────────────────────────────────────────────────────────────┐");
+	console.log("│ 2. ATCVET KLASIFIKACIJA                                     │");
+	console.log("└─────────────────────────────────────────────────────────────┘\n");
+
+	console.log("Prenašam ATCVet PDF...");
+	const atcvetPath = await downloadLatestAtcvetPdf();
+	if (!atcvetPath) {
+		console.error("Napaka: Prenos ATCVet PDF ni uspel.");
+		process.exit(1);
+	}
+	console.log(`✓ ATCVet PDF prenesen: ${atcvetPath}\n`);
+
+	console.log("Parsam ATCVet PDF...");
+	const atcvetRows = await parseAtcvetPdf(atcvetPath);
+	const atcvetPayload: AtcvetFile = {
+		meta: {
+			source: path.basename(atcvetPath),
+			generatedAt: new Date().toISOString(),
+			count: atcvetRows.length,
+		},
+		rows: atcvetRows,
+	};
+	fs.writeFileSync("./data/atcvet.json", JSON.stringify(atcvetPayload, null, 2), "utf8");
+	console.log(`✓ ATCVet sparsan: ${atcvetRows.length} kod\n`);
+
+	// 3. Generiranje TypeScript datotek
+	console.log("┌─────────────────────────────────────────────────────────────┐");
+	console.log("│ 3. GENERIRANJE TYPESCRIPT DATOTEK                          │");
+	console.log("└─────────────────────────────────────────────────────────────┘\n");
+
+	ensureGeneratedDir();
+	generateRegisterZdravil();
+	generateAtcVet();
+	console.log("");
+
+	// Povzetek
+	const elapsed = ((Date.now() - startTime) / 1000).toFixed(1);
+	console.log("═══════════════════════════════════════════════════════════════");
+	console.log("                         POVZETEK");
+	console.log("═══════════════════════════════════════════════════════════════");
+	console.log(`  Register zdravil: ${register.steviloZdravil} zdravil`);
+	console.log(`  ATCVet kode:      ${atcvetRows.length} kod`);
+	console.log(`  Čas izvajanja:    ${elapsed}s`);
+	console.log("═══════════════════════════════════════════════════════════════\n");
+}
+
+if (import.meta.main) {
+	main().catch((e) => {
+		console.error("Napaka:", e);
+		process.exit(1);
+	});
+}

package/src/index.ts

@@ -0,0 +1,289 @@
+/**
+ * Knjižnica veterinarskih zdravil registriranih v Sloveniji in šifrant ATCvet
+ *
+ * @packageDocumentation
+ */
+
+// ============================================================================
+// PODATKI
+// ============================================================================
+
+/**
+ * Šifrant ATCvet klasifikacije
+ * @example
+ * ```typescript
+ * const atc = AtcVet.find(a => a.code === "QJ01CA04");
+ * // { code: "QJ01CA04", level: 5, desc_en: "amoxicillin", desc_si: "amoksicilin" }
+ * ```
+ */
+export { AtcVet } from "./generated/AtcVet";
+
+/**
+ * Register vseh veterinarskih zdravil kot Map<id, Zdravilo>
+ * @example
+ * ```typescript
+ * const zdravilo = registerZdravil.get(123456);
+ * ```
+ */
+export { registerZdravil } from "./register/registerZdravil";
+
+// ============================================================================
+// ISKANJE ZDRAVIL
+// ============================================================================
+
+/**
+ * Poišče zdravila v registru po podobnosti imena
+ *
+ * @param vhodniNaziv - Iskalni niz (ime zdravila)
+ * @param opts - Opcije iskanja: { limit?, minOcena?, isciMed? }
+ * @returns { zadetki, najboljsi } - Seznam zadetkov in najboljši zadetek (če je enolično določen)
+ * @example
+ * ```typescript
+ * const { zadetki, najboljsi } = uganiZdravilo("citramox 500");
+ * if (najboljsi) {
+ *   console.log(najboljsi.ime); // "CITRAMOX 500 mg/g ..."
+ * }
+ * ```
+ */
+export { uganiZdravilo } from "./register/uganiZdravilo";
+
+/**
+ * Poišče zdravila po podobnosti imena in vrne polne utemeljitve
+ *
+ * @param vhodniNaziv - Iskalni niz (ime zdravila)
+ * @param opts - Opcije iskanja: { limit?, minOcena?, isciMed? }
+ * @returns Seznam zdravil z utemeljitvami (ocene po kategorijah), sortirano po oceni padajoče
+ * @example
+ * ```typescript
+ * const rezultati = uganiZdraviloInUtemelji("baytril 50", { limit: 5 });
+ * for (const r of rezultati) {
+ *   console.log(r.zdravilo.ime, r.utemeljitev.ocena);
+ * }
+ * ```
+ */
+export { uganiZdraviloInUtemelji } from "./register/uganiZdravilo";
+
+/**
+ * Minimalna ocena podobnosti za vključitev v rezultate iskanja (privzeto 500)
+ */
+export { MIN_OCENA_PODOBNOSTI } from "./register/MIN_OCENA_PODOBNOSTI";
+
+// ============================================================================
+// NORMALIZACIJA IN ANALIZA IMEN
+// ============================================================================
+
+/**
+ * Normalizira ime zdravila za primerjavo
+ *
+ * Pretvori v male črke, normalizira enote (mg, ml, tbl...), teže, decimalne vejice itd.
+ *
+ * @param naziv - Izvorni naziv zdravila
+ * @returns Normaliziran naziv
+ * @example
+ * ```typescript
+ * normalizirajNaziv("AMOXICILLIN 50,5 mg/ml za pse");
+ * // "amoxicillin 50.5mg/ml pse"
+ * ```
+ */
+export { normalizirajNaziv } from "./register/helper/normalizirajNaziv";
+
+/**
+ * Razčleni ime zdravila na sestavne dele
+ *
+ * Razčleni na besede, doze, težo, količino in živalske vrste.
+ *
+ * @param naziv - Izvorni naziv zdravila
+ * @returns Objekt z razčlenjenimi sestavinami
+ * @example
+ * ```typescript
+ * razcleniNaziv("BAYTRIL 50 mg/ml za pse in mačke 7tbl");
+ * // {
+ * //   izvorni_naziv: "BAYTRIL 50 mg/ml za pse in mačke 7tbl",
+ * //   normaliziran_naziv: "baytril 50mg/ml pse mačke 7tbl",
+ * //   besede: ["baytril"],
+ * //   doze: ["50mg/ml"],
+ * //   teza: null,
+ * //   kolicina: "7tbl",
+ * //   zivalskeVrste: ["pse", "mačke"]
+ * // }
+ * ```
+ */
+export { razcleniNaziv } from "./register/helper/razcleniNaziv";
+
+/**
+ * Oceni podobnost med dvema razčlenjenima nazivoma zdravil
+ *
+ * @param razclembaVhoda - Razčlenjen vhodni naziv (iskalni niz)
+ * @param razclembaRegistra - Razčlenjen naziv iz registra zdravil
+ * @returns Utemeljitev z delnimi ocenami (besede, doze, vrste...) in skupno oceno
+ * @example
+ * ```typescript
+ * const vhod = razcleniNaziv("baytril 50");
+ * const register = razcleniNaziv("BAYTRIL 50 mg/ml raztopina za injiciranje");
+ * const ocena = oceniPodobnost(vhod, register);
+ * console.log(ocena.ocena); // skupna ocena podobnosti
+ * ```
+ */
+export { oceniPodobnost } from "./register/helper/oceniPodobnost";
+
+/**
+ * Pretvori rezultate iskanja v poenostavljeno obliko
+ *
+ * @param rezultati - Rezultati iz uganiZdraviloInUtemelji
+ * @returns { zadetki, najboljsi } - Poenostavljen seznam in najboljši zadetek
+ * @example
+ * ```typescript
+ * const rezultati = uganiZdraviloInUtemelji("citramox");
+ * const { zadetki, najboljsi } = oblikujRezultatIskanja(rezultati);
+ * ```
+ */
+export { oblikujRezultatIskanja } from "./register/helper/oblikujRezultatIskanja";
+
+/**
+ * Vrne seznam zdravil z dano ATCvet kodo (ali prefiksom)
+ *
+ * Seznam je urejen po ATCvet kodah.
+ *
+ * @param atcVetKoda - ATCvet koda ali njen prefiks (npr. "QJ01", "QJ01CA04")
+ * @returns Seznam zdravil z ustrezno ATCvet kodo
+ * @example
+ * ```typescript
+ * const zdravila = zdravilaZaAtcVetKodo("QJ01CA04");
+ * // Vrne vsa zdravila z amoksicilinom
+ *
+ * const antibiotiki = zdravilaZaAtcVetKodo("QJ01");
+ * // Vrne vsa zdravila za sistemsko zdravljenje bakterijskih infekcij
+ * ```
+ */
+export { zdravilaZaAtcVetKodo } from "./register/zdravilaZaAtcVetKodo";
+
+// ============================================================================
+// VAKCINE
+// ============================================================================
+
+/**
+ * Preveri, ali je zdravilo vakcina za določeno živalsko vrsto
+ *
+ * @param zdravilo - Zdravilo iz registra
+ * @param zival - Živalska vrsta (npr. "psi", "mačke", "govedo")
+ * @returns Seznam bolezni, proti katerim ščiti, ali false če ni vakcina
+ * @example
+ * ```typescript
+ * const rabisin = registerZdravil.get(123);
+ * const bolezni = zdraviloJeVakcinaZa(rabisin, "psi");
+ * if (bolezni) {
+ *   console.log(bolezni); // ["steklina"]
+ * }
+ * ```
+ */
+export { zdraviloJeVakcinaZa } from "./register/zdraviloJeVakcinaZa";
+
+// ============================================================================
+// PODOBNA ZDRAVILA
+// ============================================================================
+
+/**
+ * Vrne zdravila z vsaj eno skupno učinkovino
+ *
+ * Učinkovine pridobi iz podatkov zdravila in iz ATCvet kode na nivoju 5.
+ * Seznam je urejen po podobnosti z vhodnim zdravilom.
+ *
+ * @param zdravilo - Zdravilo, za katerega iščemo podobna
+ * @returns Seznam zdravil z vsaj eno skupno učinkovino (brez vhodnega zdravila)
+ * @example
+ * ```typescript
+ * const baytril = registerZdravil.get(123);
+ * const podobna = podobnaZdravilaPoUcinkovinah(baytril);
+ * // Vrne zdravila z enrofloksacinom
+ * ```
+ */
+export { podobnaZdravilaPoUcinkovinah } from "./register/podobnaZdravilaPoUcinkovinah";
+
+/**
+ * Vrne zdravila z enako ATCvet kodo na danem nivoju
+ *
+ * Seznam je urejen po podobnosti z vhodnim zdravilom.
+ *
+ * Nivoji ATCvet:
+ * - 1: anatomska glavna skupina (npr. QJ = zdravila za sistemsko zdravljenje infekcij)
+ * - 2: terapevtska podskupina (npr. QJ01 = antibakterijska zdravila)
+ * - 3: farmakološka podskupina (npr. QJ01C = betalaktamski antibiotiki)
+ * - 4: kemijska podskupina (npr. QJ01CA = širokospektralni penicilini)
+ * - 5: kemijska učinkovina (npr. QJ01CA04 = amoksicilin)
+ *
+ * @param zdravilo - Zdravilo, za katerega iščemo podobna
+ * @param nivo - ATCvet nivo za primerjavo (1-5), privzeto 5
+ * @returns Seznam zdravil z enako ATCvet kodo na danem nivoju (brez vhodnega zdravila)
+ * @example
+ * ```typescript
+ * const zdravilo = registerZdravil.get(123);
+ * const podobna = podobnaZdravilaPoATC(zdravilo, 4);
+ * // Vrne zdravila z enako kemijsko podskupino
+ * ```
+ */
+export { podobnaZdravilaPoATC } from "./register/podobnaZdravilaPoATC";
+
+// ============================================================================
+// ATCvet KLASIFIKACIJA
+// ============================================================================
+
+/**
+ * Vrne opise vseh nivojev za dano ATCvet kodo
+ *
+ * @param koda - ATCvet koda (npr. "QJ01CA04")
+ * @returns Seznam opisov za vsak nivo (0-5)
+ * @example
+ * ```typescript
+ * podatkiATCvetKode("QJ01CA04");
+ * // [
+ * //   { nivo: 0, pomenNivoja: "veterinarska uporaba", opisNivoja: "Veterinarska zdravila" },
+ * //   { nivo: 1, pomenNivoja: "anatomska glavna skupina", opisNivoja: "ZDRAVILA ZA SISTEMSKO ZDRAVLJENJE INFEKCIJ" },
+ * //   { nivo: 2, pomenNivoja: "terapevtska podskupina", opisNivoja: "ZDRAVILA ZA SISTEMSKO ZDRAVLJENJE BAKTERIJSKIH INFEKCIJ" },
+ * //   { nivo: 3, pomenNivoja: "farmakološka podskupina", opisNivoja: "Betalaktamski antibiotiki, penicilini" },
+ * //   { nivo: 4, pomenNivoja: "kemijska podskupina", opisNivoja: "Širokospektralni penicilini" },
+ * //   { nivo: 5, pomenNivoja: "kemijska učinkovina", opisNivoja: "amoksicilin" }
+ * // ]
+ * ```
+ */
+export { podatkiATCvetKode } from "./atcvet/podatkiATCvetKode";
+
+/**
+ * Vrne opis posamezne ATCvet kode (najvišji nivo)
+ *
+ * @param koda - ATCvet koda
+ * @returns Opis za najvišji nivo kode ali null če koda ne obstaja
+ * @example
+ * ```typescript
+ * opisATCvetKode("QJ01CA04");
+ * // { nivo: 5, pomenNivoja: "kemijska učinkovina", opisNivoja: "amoksicilin" }
+ * ```
+ */
+export { opisATCvetKode } from "./atcvet/opisATCvetKode";
+
+/**
+ * Seznam pomenov nivojev ATCvet klasifikacije
+ * @example
+ * ```typescript
+ * // [
+ * //   [0, "veterinarska uporaba"],
+ * //   [1, "anatomska glavna skupina"],
+ * //   [2, "terapevtska podskupina"],
+ * //   [3, "farmakološka podskupina"],
+ * //   [4, "kemijska podskupina"],
+ * //   [5, "kemijska učinkovina"]
+ * // ]
+ * ```
+ */
+export { pomeniNivojevATCvet } from "./atcvet/pomeniNivojevATCvet";
+
+// ============================================================================
+// TIPI
+// ============================================================================
+
+export type { Zdravilo } from "./register/types/Zdravilo";
+export type { RazlagaATCvetKode } from "./atcvet/opisATCvetKode";
+export type { AtcvetRow } from "./atcvet/types/AtcvetFile";
+export type { RegisterZdravil } from "./register/types/RegisterZdravil";
+export type { UganiZdraviloOpts } from "./register/uganiZdravilo";
+export type { RazclenjeniNaziv } from "./register/helper/normalizirajNaziv";
+export type { UtemeljitevOcene } from "./register/helper/oceniPodobnost";