Ugrás a fő tartalomhoz
Was this helpful?

Szószedet

A PrimeCal-ban és ebben a dokumentációban használt legfontosabb fogalmak magyarázata.

A​

Akció (Action) Az automatizálási szabály „ekkor csináld ezt" része. Az akció meghatározza, hogy a PrimeCal mit tesz, amikor egy trigger lefut és a feltételek teljesülnek. Példa: az esemény színének pirosra állítása.

Ügynökprofil (Agent Profile) Egy elnevezett konfiguráció, amely szabályozza, hogy egy AI-ügynök (MCP-n keresztül) mit láthat és tehet a PrimeCal-ban — melyik naptárakhoz férhet hozzá, milyen írási engedélyei vannak, és melyik API-kulcsot használja.

API-kulcs (API Key) Külső rendszerek vagy AI-ügynökök által a PrimeCal API eléréséhez használt hitelesítő adat. A profil beállításaiból generálható. Minden kulcs meghatározott engedélyekre korlátozható.

Automatizálási szabály (Automation Rule) Feltételek és akciók halmaza, amely automatikusan lefut, amikor egy trigger aktiválódik. Példa: amikor egy esemény jön létre, amelynek a címében szerepel a „Doktor" szó (feltétel), az esemény színét pirosra állítja (akció).

C​

Naptár (Calendar) Események elnevezett tárolója, amelynek van egy színe és láthatósági beállítása. Minden felhasználónak van egy „Alapértelmezett" naptára, és további naptárakat hozhat létre (pl. Munka, Személyes, Család). A naptárakat megoszthatod más felhasználókkal vagy csoportokkal.

Naptárcsoport (Calendar Group) Szervezési címke, amellyel több naptárat csoportosíthatsz az oldalsávban egy fejléc alá. A csoportok nem befolyásolják az eseményadatokat — kizárólag a megjelenítés szervezésére szolgálnak. Példa: egy „Család" csoport, amely tartalmazza „Marika naptára", „Péter naptára" és „Norbi naptára" elemeket.

Feltétel (Condition) Szűrő az automatizálási szabályban. A feltételek kiértékelik az esemény mezőit (például a címet vagy az időtartamot) vagy a webhook-payload adatait, olyan operátorokkal, mint a contains (tartalmaz), equals (egyenlő) vagy greater_than (nagyobb mint). Több feltételt ÉS/VAGY logikával lehet kombinálni.

Esemény létrehozása (Create Event) Új ütemezett elem hozzáadása egy naptárhoz. Az eseményeknek van egy címük, kezdési idejük, befejezési idejük, leírásuk, helyszínük, színük és naptár-hozzárendelésük.

E​

Esemény (Event) Ütemezett elem, amelynek kezdési ideje, befejezési ideje, címe és naptár-hozzárendelése van. Az események a PrimeCal alapegységei. Az események lehetnek egész naposak vagy időre rögzítettek, egyiek vagy ismétlődők.

Külső naptárszinkronizálás (External Calendar Sync) Olyan funkció, amely összeköti a Google- vagy Microsoft 365-fiókot a PrimeCal-lal, és importálja az adott fiók naptárából az eseményeket. Lásd: Külső szinkronizálás.

F​

Funkciójelző (Feature Flag) Egy beállítás (amelyet a PrimeCal adminisztrátorai kezelnek), amely engedélyez vagy letilt egy funkciót az összes felhasználó vagy meghatározott előfizetési csomagok számára. Ha egy funkció jelzőjével le van tiltva, annak felhasználói felülete nem jelenik meg.

Fókuszmód / Élő fókusz (Focus Mode / Live Focus) Naptárnézet-szűrő, amely csak az adott naptáraknak vagy címkéknek megfelelő eseményeket mutatja. A Fókuszmód csökkenti a vizuális zajt, ha az időbeosztásod egy meghatározott részére szeretnél koncentrálni. Az Élő fókusz valós időben frissül, ahogy új események érkeznek be.

M​

MCP (Model Context Protocol) Nyílt szabvány AI-asszisztensek és eszközök, valamint adatforrások összekapcsolásához. A PrimeCal az MCP-t a https://api.primecal.eu/api/mcp címen implementálja, lehetővé téve, hogy a Claude, a Claude Desktop és kompatibilis AI-gazdagépek olvassák a naptáradat, és a nevedben eseményeket hozzanak létre. Lásd: MCP áttekintés.

MCP-eszköz (MCP Tool) Egy AI-ügynök számára az MCP-szerveren keresztül elérhető konkrét akció. Példák: primecal_calendars_events_list (események listázása), primecal_reservations_create (foglalás létrehozása).

O​

OAuth Az engedélyezési protokoll, amelyet a PrimeCal a Google- vagy Microsoft-fiókok csatlakoztatásakor használ. Az OAuth lehetővé teszi, hogy hozzáférést hagyj jóvá a jelszavad megosztása nélkül — a Google vagy a Microsoft kezeli a hitelesítést, és tokent bocsát ki a PrimeCal számára.

Szervezet (Organisation) Vállalati szintű csoportosítás, amely a foglalási rendszer erőforrásait és erőforrástípusait kezeli. Egy szervezetnek adminisztrátorai (szerkesztői) vannak, akik konfigurálják az erőforrásokat és az árakat.

P​

Személyek csoportja / Felhasználói csoport (People Group / User Group) PrimeCal-felhasználók elnevezett listája, amellyel egyetlen egységként oszthatod meg a naptárakat. Példa: hozz létre egy „Blate Família" csoportot, amelybe Marika, Péter, Norbi és Zsuzsi tartozik — majd egyetlen lépésben oszd meg bármely naptárat az egész csoporttal.

Személyes napló (Personal Log / Personal Logs) Egy privát tevékenységképernyő, amely csak számodra látható, és a saját tevékenységeidet mutatja (létrehozott események, megosztott naptárak, fiókváltozások), valamint GDPR-adatjogokat (hozzáférési, exportálási, törlési kérések).

Csomag / Előfizetési csomag (Plan / Usage Plan) Előfizetési szint, amely szabályozza, hogy a felhasználó fiókjában mely funkciók érhetők el. Például az automatizálás, a külső szinkronizálás, a foglalások és az API-hozzáférés csomaghoz kötött lehet. A csomagkezelést a PrimeCal adminisztrátorai végzik.

R​

Ismétlődő esemény (Recurring Event) Ütemezetten ismétlődő esemény. A PrimeCal napi, heti, havi és egyéni ismétlődési mintákat támogat. Szerkeszthetsz egyetlen előfordulást vagy a teljes sorozatot.

Erőforrás (Resource) Egy szervezet foglalási rendszerének foglalható eleme — tárgyaló, eszköz, időpontfoglalási slot, úszósáv. Az erőforrások Erőforrástípushoz tartoznak.

Erőforrástípus (Resource Type) Foglalható erőforrások kategóriája — pl. „Tárgyalók" (amelybe az A terem, a B terem és a C terem tartozik). Az erőforrástípusok meghatározzák az elérhetőségi módot (folyamatos vagy műszakos) és az ütközési időt.

Foglalás (Reservation) Egy erőforrás lefoglalása egy adott időre. Az ügyfelek a nyilvános foglalási linken keresztül hozhatnak létre foglalásokat. A fizetős foglalások a Stripe-pal integrálva kezelik a fizetést.

S​

Hely (Seat) Egy előfizetési csomagon belüli felhasználói fiókhelyek, amelyek lehetővé teszik, hogy egy másik felhasználó is igénybe vehesse a csomag funkcióit. A helykezeléssel csapattagokat hívhatsz meg, akik aztán a csomag funkcióit külön előfizetés nélkül használhatják.

Előfizetési csomag (Subscription Plan) Lásd: Csomag / Előfizetési csomag.

T​

Feladat (Task) Teendő a Feladatok munkaterületen. A feladatoknak van egy címük, állapotuk, opcionális határidejük és címkéik. A Feladatok munkaterülete elkülönül a naptárnézettől, de a navigációban egymás mellett helyezkednek el.

Trigger Az automatizálási szabály „amikor ez megtörténik" része. A triggerek közé tartoznak a naptáresemények (létrehozva, frissítve, törölve), időalapú események (az esemény X percen belül kezdődik), webhook-hívások és külső naptárimportálások.

W​

Webhook (bejövő) Automatizálási szabályonként generált egyedi URL, amelyre külső szolgáltatások JSON-t küldhetnek POST-kéréssel. Amikor egy payload megérkezik, a PrimeCal kiértékeli az automatizálási szabály feltételeit a payload-adatokkal szemben, és ha a feltételek teljesülnek, végrehajtja az akciót.

Webhook intelligens értékek (Webhook Smart Values) Pontjelöléses útvonalak a webhook-payload beágyazott adatainak eléréséhez. Példa: a webhook.data.order.status a bejövő JSON-törzsben a data.order elemén belüli status értéket éri el.

Heti nézet / Havi nézet (Week View / Month View) Két naptár-megjelenítési mód. A Heti nézet időslotokat mutat 7 napos időszakon át, és lehetővé teszi a húzással való létrehozást. A Havi nézet napokból álló rácsot jelenít meg az események előnézetével.