User manual

Public guide to the main Pet Care Diary features.

Getting started and login

A kezdőlapon a Kezdés gombbal választható ki, hogy gazdi vagy orvos/rendelői felhasználó regisztrál.
A regisztráció után a rendszer emailes aktiváló linket küld. A fiók csak az aktiválás után használható teljes értékűen.
Belépéskor MFA használható email kóddal vagy authenticator alkalmazással. Authenticator módnál az OTP oldalon kérhető emailes OTP is tartalék ellenőrzésként.
Az OTP beviteli mező automatikusan fókuszt kap, és 6 számjegy beírása után automatikusan elindítja az ellenőrzést.
A felső menüben váltható a nyelv és az éjszakai mód; ezek cookie-ban tárolódnak.

Public tools

Kiskedvenc-ajánló kvíz: a Kiskedvenc-ajánló életmód, idő, energia, lakókörnyezet és felelős gondozási szempontok alapján ad játékos illeszkedési rangsort. Az eredmény tájékoztató jellegű, nem helyettesíti a konkrét állat temperamentumának és igényeinek felmérését.
Kisállat Kódex: a Kisállat Kódex fajonként és témánként rendezett, kereshető tudástár. Tartalmaz etetési, tartási, költség, gyakori betegség, vészjelzés és forrás fejezeteket.
Oltási könyv és állatútlevél útmutató: a publikus útmutató segít eligazodni az oltási könyv, EU állatútlevél, utazási és baleseti alapteendők között.
Gyors chip keresés: belépés nélkül használható kereső, amely a saját adatbázist és a PetVetData nyilvános kamarai adatforrását is megpróbálja megjeleníteni.

Owner features

Gazdiként a vezérlőpulton szerkeszthetők a saját adatok, kontakt információk és a publikus kontakt beállítások. Innen GDPR törlési kérés is indítható.

Az Állataim menüpontban új kisállat vehető fel. Megadható név, faj, fajta, szín, nem, születési dátum, chip szám, testsúly, valamint kérhető publikus elveszett állat profil.

A gazdi a kezelési ticketekben saját észlelést, megjegyzést, képet és dokumentumot is feltölthet. Ez segíti az orvost a több alkalmas kezelések közötti állapotkövetésben.

Pet profile management

Oltások: oltás neve, sarzsszám, beadási és lejárati dátum, megjegyzés rögzíthető.
Allergiák: allergia neve, súlyossága és megjegyzése menthető. Orvos is módosíthatja.
Eledelnapló: felvihető eledel, mennyiség, dátum, és jelölhető az aktuálisan használt eledel.
Testsúly: minden mérés dátummal mentődik, grafikonon követhető, a lista görgethető.
Dokumentumok és képek: több fájl tölthető fel egyszerre, típusonként tabokba rendezve. Megnyitható, letölthető és gazdi által törölhető.
Profilkép: a feltöltött képek közül kiválasztható, melyik jelenjen meg a publikus profilon.
Kezelő orvos és rendelő: a gazdi kijelölheti, melyik orvos és rendelő láthatja az állat adatait.

Chip search

A publikus chip kereső belépés nélkül használható. A chip szám és captcha megadása után a rendszer jelzi, ha nincs találat. Ha van találat, publikus profil esetén megjelenik a kisállat adatlapja, nem publikus profilnál csak a gazdi kapcsolati adatai látszanak a beállítások szerint.

A saját adatbázis találata alatt külön blokkban megjelenik a külső találat is a Magyar Állatorvosi Kamara nyilvános PetVetData forrásából (ha elérhető adat). Így a keresés egy helyen mutatja a belső és a kamarai publikus eredményt.

Ha a külső adatforrás nem ad találatot vagy ideiglenesen nem elérhető, ezt a rendszer külön üzenetben jelzi.

Clinic search

A rendelőkeresőben név, irányítószám, megye és szolgáltatások alapján lehet szűrni. A Magyarország térképen a kék jelölések mutatják, hol hány rendelő található.

A rendelő kártyájára kattintva modal ablak nyílik: rendelő adatok, képek, nyitvatartás, felszereltség, szakterületek, hozzárendelt orvosok, Google térkép és navigációs link érhető el.

Doctors and assistants

Orvosként vagy asszisztensként a vezérlőpulton a saját profilban megadható profiladat és szakterület. A szakterület automatikusan hozzáadódik a rendelő nyilvános szakterületeihez.

A kezelések oldalon az orvos/asszisztens a már hozzáférhető állatok közül választhat, vagy chip szám alapján veheti fel az állatot kezelésre.

Minden kezelés ticketként működik: külön részletoldala van, ahol idővonalon (timeline) láthatók az események. Egy ticket lehet gyors, egyalkalmas ellátás vagy hosszabb, több fordulós kezelés is.

A ticketben rögzíthető: orvosi kórkép, gyógyszerezési leírás, kezelési utasítás, labor és véreredmény, képek, dokumentumok, valamint általános megjegyzés. A bejegyzések append-only jellegűek: mentés után nem szerkeszthetők, pontosítás új eseménnyel történik.

Kórlap asszisztens: új kezelés nyitásakor vagy folyamatban lévő kezelés timeline eseményénél az orvos/asszisztens szabad szavas tünetet, kórképet vagy gyógyszerhez kapcsolódó kérdést írhat be. A rendszer a feltöltött tünet-, kezelési javaslat- és gyógyszer törzsadatokból keres kontextus alapján, majd javaslatokat mutat. A javaslat döntéstámogató, nem automatikus diagnózis: az orvos választja ki, mit fogad el, és a kiválasztott szöveg kitöltheti a kórkép, gyógyszerezési terv vagy kezelési utasítás mezőket.

Gyógyszer adatbázis: a felső menüből elérhető szakmai adatbázisban gyógyszerek, vitaminok és étrend-kiegészítők kereshetők és bővíthetők kategóriák szerint. Törölni csak super admin tud.

Tünetek és kezelési javaslatok: külön szakmai oldalon kezelhetők a tünetekhez, kórképekhez és javasolt ellátáshoz kapcsolódó bejegyzések. Ezeket a Kórlap asszisztens is használja.

A kezelés állapota folyamatosan frissíthető, lezáráskor megadható kimenet például: meggyógyult, tünetmentes, további kezelésre írva vagy elhunyt.

Az orvos látja a hozzá rendelt vagy általa/rendelője által kezelt állatok adatait, de a gazdai dokumentumokat nem törölheti és nem módosíthatja az állat alap profilját.

How treatments work

Nyisd meg a Kezelések menüpontot, majd hozz létre új ticketet állat kiválasztásával (vagy chip alapján), címmel és prioritással.
Nyisd meg a ticketet a listából. A részletoldalon látszik az állat, az orvos, a státusz és a teljes kezelési idővonal.
Új esemény felvitelekor válassz eseménytípust (például kórkép, gyógyszerezés, labor, véreredmény, megfigyelés), majd töltsd ki a leírást.
Ugyanitt több fájl is feltölthető egyszerre (kép, laborlap, dokumentum). A fájlok a ticket saját fájl-listájába kerülnek.
Az idővonal alapból a legújabb eseményt mutatja felül, de a sorrend átváltható. Az egy eseménnyel együtt feltöltött képek és dokumentumok az adott bejegyzéshez csoportosítva jelennek meg.
Orvosi oldalon státusz is frissíthető esemény rögzítésekor; lezáráskor megadható a kimenet (meggyógyult, tünetmentes, további kezelés, elhunyt).
A mentett orvosi események nem szerkeszthetők utólag, helyesbítés új esemény bejegyzéssel történik.
A gazdi a saját állatához tartozó ticketben csak gazdi észlelést, üzenetet és képet tud hozzáadni, orvosi kórlapot vagy gyógyszerezési utasítást nem rögzíthet.
Orvosi bejegyzés, kezelésnyitás vagy fájlfeltöltés után a rendszer email értesítést küld a gazdinak, ha a gazdi email címe és az SMTP beállítások rendben vannak.
Vény nyomtatás: orvos, asszisztens és rendelő admin a kezelési ticketből modal ablakban indíthat A5 méretű, sorszámozott vényt. A vény a legutóbbi orvosi gyógyszerezési bejegyzés alapján előtölti a gyógyszerezési mezőt, de nyomtatás előtt módosítható.

Scheduling and booking

Rendelő admin – beosztás és szolgáltatások:

A Rendelő / Beosztás és szolgáltatások felületen hozd létre a foglalható szolgáltatásokat, és add meg az időtartamot (percben).
Ugyanezen az oldalon vedd fel a műszakokat orvosokra és asszisztensekre (kezdés, vég, státusz, opcionális helyiség).
A foglalható idősávokat a rendszer a beállított beosztás és a szolgáltatás időigénye alapján kezeli.

Foglalás indítása:

A Rendelők oldalon válassz rendelőt, majd indíts foglalást.
Válaszd ki a szolgáltatást, orvost és időpontot. A rendszer csak olyan időpontot enged, ahol az orvos be van osztva és nincs ütközés.
Foglalás mehet belépett felhasználóval vagy vendégként is. Vendégnél kötelező a név, email, telefon és állatazonosító adat megadása.
A foglalás végén kérhető automatikus regisztráció is, ilyenkor a rendszer ideiglenes jelszót küld emailben.

Orvos/asszisztens nézet: a saját vezérlőpulton látható a beosztás, a hozzárendelt foglalások, valamint a kapcsolódó kezelések.

Clinic admin

A rendelő admin a rendelői felületen szerkeszti a rendelő címét, kontakt adatait, webcímét, nyitvatartását, leírását és képeit.
Checkboxokkal állítható a felszereltség: röntgen, CT, MR, karomvágás, védőoltások, sürgősségi ellátás, fogászat, sebészet, labor, ultrahang.
A dolgozói táblázatban szerkeszthető a munkatárs, törölhető a rendelőből, resetelhető az MFA és a jelszó.
Emailes meghívó küldhető orvosnak, asszisztensnek vagy új rendelő adminnak.
A beosztás és szolgáltatás kezelőben beállítható a foglalható szolgáltatások időtartama, valamint az orvosok és asszisztensek rendelőnkénti műszakbeosztása.
A foglalásoknál módosítható az időpont státusza, illetve szükség esetén átadható másik orvoshoz vagy asszisztenshez.

Settings and integrations

A fogaskerék ikonnal elérhető Beállítások oldalon a rendelő admin a rendelő kommunikációs beállításait kezelheti.

Email sablonok: külön sablon állítható regisztrációhoz, jelszóváltoztatáshoz, MFA resethez, időpontfoglalási értesítésekhez, kezelési bejegyzésekhez és elveszett kiskedvenc megtalálásához.
Helyettesítő szövegek: a sablonokban használhatók például a <<user.name>>, <<user.email>>, <<booking.starts_at>>, <<pet.name>> és kezelési adatokhoz kapcsolódó változók. A rendszer küldéskor automatikusan behelyettesíti az értékeket.
Arculat: módosítható a fejléc logója URL-lel vagy feltöltött képpel, a fejléc és háttér színei, a betűszínek, valamint rendelői aláírás is használható.
Egyedi SMTP: a rendelő saját küldő profilt kapcsolhat be. Ha nincs bekapcsolva, a rendszer a központi SMTP profilt használja, a korábban megadott rendelői adatok megőrzése mellett.
Teszt küldés: az SMTP beállítások és az egyes sablonok mellett is indítható teszt email a bejelentkezett felhasználó címére.
Integrációk: az integrációs tab előkészíti a későbbi webhook, Slack és Microsoft Teams kapcsolatok kezelését.
API kulcsok: super admin rendelői és globális REST API kulcsokat kezelhet, a rendelő admin pedig a saját rendelői kulcsát tudja lekérni vagy újragenerálni.

REST API documentation

A REST API külső kliensekhez készült, például későbbi C# WinForms asztali alkalmazáshoz. A kulcsot a kérésben X-API-Key fejlécben vagy Authorization: Bearer API_KULCS formában kell küldeni. Az új kulcsok PetCare_app_ előtaggal jönnek létre.

Kulcs hatókörök: rendelői kulcs csak a saját rendelő adatait éri el. Globális super admin kulcs minden rendelő és minden felhasználó listázására/lekérésére alkalmas; listázásnál opcionális clinic_id mezővel lehet egy rendelőre szűrni.

Fontos szabály: GET metódussal kizárólag a státusz végpont érhető el. Minden adatlekérés és módosítás POST kérés, JSON törzzsel.

GET /api/status
X-API-Key: PetCare_app_...

{
  "ok": true,
  "service": "Pet Care Diary",
  "clinic_id": 12,
  "clinic_name": "Minta Rendelő",
  "time": "2026-06-04T10:00:00+02:00"
}

Rendelők

POST /api/clinics - rendelők lekérése. Rendelői kulccsal a saját rendelőt adja vissza, globális kulccsal az összes rendelőt.

{
  "action": "list",
  "q": "Budapest",
  "limit": 50
}

Kezelések

POST /api/treatments - kezelési ticketek listázása, napi/heti lekérése, folyamatban lévő kezelések, létrehozás, szerkesztés és timeline esemény rögzítése.

{
  "action": "list",
  "period": "weekly",
  "date": "2026-06-04",
  "status": "in_progress",
  "doctor_user_id": 15,
  "limit": 50
}

{
  "action": "in_progress",
  "limit": 50
}

{
  "action": "summary",
  "period": "daily",
  "date": "2026-06-04"
}

{
  "action": "create",
  "chip_number": "941000021998283",
  "title": "Kontroll vizsgálat",
  "priority": "normal",
  "doctor_user_id": 15
}

{
  "action": "add_event",
  "ticket_id": 123,
  "event_type": "medical_record",
  "body": "Kontroll során állapota javult.",
  "status": "in_progress",
  "is_medical_instruction": true
}

{
  "action": "update",
  "ticket_id": 123,
  "title": "Kontroll és gyógyszeres kezelés",
  "status": "therapy_issued",
  "priority": "high",
  "doctor_user_id": 15
}

Használható státuszok: new, waiting_exam, in_progress, therapy_issued, control_needed, closed, archived.

Beosztás

POST /api/schedules - rendelő teljes dolgozói listája, teljes rendelői beosztás, dolgozónkénti lekérés, konkrét beosztás létrehozása, módosítása és törlése.

{
  "action": "staff"
}

{
  "action": "list",
  "period": "daily",
  "date": "2026-06-10"
}

{
  "action": "list",
  "period": "weekly",
  "week_start": "2026-06-08",
  "user_id": 15
}

{
  "action": "create",
  "user_id": 15,
  "shift_start": "2026-06-10 08:00",
  "shift_end": "2026-06-10 14:00",
  "status": "confirmed",
  "room_name": "1. rendelő"
}

{
  "action": "update",
  "id": 88,
  "shift_start": "2026-06-10 09:00",
  "shift_end": "2026-06-10 15:00",
  "status": "confirmed",
  "note": "Módosított műszak"
}

Időpontok

POST /api/appointments - foglalások napi/heti lekérése, napi/heti összesítése, létrehozása és státusz/orvos/asszisztens/időpont módosítása.

{
  "action": "list",
  "period": "daily",
  "date": "2026-06-10",
  "vet_user_id": 15
}

{
  "action": "summary",
  "period": "weekly",
  "week_start": "2026-06-08"
}

{
  "action": "create",
  "service_id": 4,
  "vet_user_id": 15,
  "appointment_start": "2026-06-10 09:30",
  "duration_minutes": 30,
  "owner_name": "Teszt Gazdi",
  "owner_email": "gazdi@example.com",
  "owner_phone": "+361234567",
  "pet_identifier": "941000021998283",
  "pet_name": "Lili"
}

{
  "action": "update",
  "id": 44,
  "status": "confirmed",
  "vet_user_id": 15,
  "assistant_user_id": 22,
  "appointment_start": "2026-06-10 10:00",
  "duration_minutes": 30
}

Használható státuszok: requested, confirmed, in_progress, completed, cancelled, no_show.

Chip lekérés

POST /api/chip-lookup - chip vagy egyedi azonosító alapján belső jogosult találat és PetVetData külső publikus adatlekérés.

{
  "chip_number": "941000021998283"
}

Felhasználók

POST /api/users - kizárólag a rendelő orvosainak és asszisztenseinek kezelése. Elérhető: listázás, lekérés, felvitel, szerkesztés, rendelőből eltávolítás, MFA reset, MFA beállítás és jelszócsere.

{
  "action": "create",
  "name": "Dr. API Teszt",
  "email": "api.orvos@example.com",
  "staff_role": "vet",
  "professional_specialties": "Belgyógyászat"
}

{
  "action": "update",
  "id": 15,
  "name": "Dr. API Teszt Elek",
  "staff_role": "assistant",
  "professional_specialties": "Labor, aneszteziológia"
}

{
  "action": "mfa_set",
  "id": 15,
  "enabled": true,
  "method": "totp"
}

{
  "action": "password_change",
  "id": 15,
  "password": "Legalabb8Karakter"
}

A mfa_set TOTP esetén visszaadja a kézi secretet, az otpauth URI-t és a QR-kód URL-t. Rendelői kulccsal csak orvos és asszisztens kezelhető; globális super admin kulccsal rendszerszintű felhasználói lekérés, MFA reset/beállítás és jelszócsere is elérhető.

Időzített feladatok

A super admin felületen az Időzített feladatok tabon állítható a globális cron működés: oltási lejárati emlékeztető, időpont előtti email értesítés és időpont utáni értékelés kérés. A szolgáltatói cron kezelőbe egy fő PHP fájlt kell felvenni: cron.php.

A válaszok minden esetben JSON formátumúak. Hibánál a rendszer {"ok":false,"error":"hiba_kod"} választ ad megfelelő HTTP státusszal.

Upcoming developments

Oltás értesítés

Development summary:
Kötelező oltások lejárati idejének és kötelezettségi értesítések e-mail értesítései.

Expected deployment: 2026-06-21

Security and privacy

Az aktiváló és OTP emailek a rendszer email sablonjával érkeznek.
MFA email kóddal vagy Google Authenticator kompatibilis TOTP kóddal használható.
A dokumentumok privát tárhelyen vannak, publikus profilban csak az engedélyezett képek és adatok jelennek meg.
GDPR törlés kérhető gazdiként, super admin felületen pedig kezelt törlés/anonymizálás végezhető.
Mobilon a rendszer PWA-ként telepíthető, ha a böngésző felajánlja a telepítést.