Időgazdálkodás eszközök

Áttekintés

Az Időgazdálkodás eszközkategória két eszközt ad. A manage_shift mindent lefed, amit a Saját műszakok és az Összes műszak oldalakon tennél — műszak indítása és zárása, műszak rögzítése egy csapattársnak, időpontok javítása, órabér módosítása, véglegesítés a bérszámfejtéshez. A get_shift_report a Jelentések oldal egyetlen hívásban: óra- és bérösszesítés ügyintézőnként tetszőleges időszakra.

Az irányítópulton ez a funkció Műszakok néven fut, és egy Csapat nevű menücsoportban ül — keresd a Csapat → Műszakok alatt, benne az Összes műszak, Saját műszakok, Műszaktípusok és Jelentések sorokkal. A háttérben Time Management néven fut: a jogosultság neve Time Management, az eszközkategória Időgazdálkodás, és a webcímek /dashboard/time-management/… formájúak.

A műszakadatok az Adathozzáférés eszközökön keresztül is olvashatók — a list_records és a get_record elfogadja a shifts és shift_types erőforrástípusokat.

Szükséges jogosultságok:Time Management a manage_shift-hez; a Reports aljogosultság a get_shift_report-hoz. Mások műszakjainak megtekintéséhez vagy módosításához ezen felül az All Shifts aljogosultság kell — ugyanaz a felosztás, mint az irányítópult oldalain.

Új bejelentkezési jogosultság. Az időgazdálkodás eszközök saját copilot:time_management hatókör mögött ülnek — külön jelölőnégyzet a bejelentkezési képernyőn, amikor MCP klienst csatlakoztatsz. Ha még azelőtt csatlakoztál, hogy ezek az eszközök léteztek, csatlakozz újra egyszer, hogy megadd.

A te műszakjaid vs mindenki műszakjai. A műszakok béradatokat hordoznak. Az All Shifts aljogosultság nélkül csak a saját műszakjaidat látod és módosíthatod — egy kolléga műszakja pontosan úgy válaszol, mint egy nem létező műszak. Vele az egész szervezet látható, beleértve az órabéreket és a naplót is.

Kulcsfogalmak

A véglegesítés egy zár

A véglegesített műszak bérszámfejtés — minden módosítást visszautasít. Az egyetlen kivétel: a finalized: false önmagában átadva újra feloldja. A véglegesített műszak törléséhez is előbb fel kell oldani. A véglegesítéshez All Shifts aljogosultság és ténylegesen lezárt műszak kell.

Hogyan számolódik a bér

Minden műszak bére: órák × a műszaktípus szorzója × a műszakra a létrehozásakor rögzített órabér. Egy tag órabérének későbbi módosítása nem írja át a régi műszakokat — az adminok ehelyett egyedi műszakon írhatják felül az órabért. A még futó műszaknak még nincs bére.

Egyszerre egy futó műszak

A műszakindítás visszautasításra kerül, amíg már van futó műszakod, és az ügyintézők csak azokba a műszaktípusokba jelentkezhetnek be, amelyeket megkaptak. A más nevében műszakot rögzítő adminokat nem korlátozzák a típus-hozzárendelések.

manage_shift

Műszakot indít és zár, műszakot rögzít bármely ügyintézőnek, javítja az időpontokat, megjegyzéseket, órabért és véglegesítést, vagy töröl egy műszakot.

Paraméterek

Paraméter	Típus	Kötelező	Leírás
`action`	string	Igen	`"start"`, `"end"`, `"create"`, `"update"` vagy `"delete"`.
`id`	string	Feltételes	A műszak, amelyen dolgozol. Kötelező az `update` és `delete` esetén; opcionális az `end`-nél.
`shiftTypeId`	string	Feltételes	Kötelező a `start` és `create` esetén. Azonosítókat a `list_records`-szal találsz (table: `shift_types`).
`userId`	string	Feltételes	Csak `create` — az ügyintéző, akinek a műszak szól.
`startTime`	string	Feltételes	ISO 8601. Kötelező a `create`-nél; az `update`-nél a kezdést módosítja.
`endTime`	string	Nem	ISO 8601. Opcionális a `create`-nél (hagyd el, hogy a műszak fusson); az `update`-nél a zárást állítja.
`comments`	string vagy null	Nem	Megjegyzés a műszakon. `null` átadásával törölhető.
`payRate`	number	Nem	Órabér ehhez az egy műszakhoz — `All Shifts` kell hozzá. Az új műszakok a tag órabérét kapják.
`finalized`	boolean	Nem	A műszak zárolása (`true`) vagy feloldása (`false`) a bérszámfejtéshez — `All Shifts` kell hozzá.

Hogyan működik

Műszak indítása — az action: "start" futó műszakot nyit neked, azonnal, a megnevezett műszaktípussal. Az aktuális órabéred rögzítésre kerül rajta.

Műszak zárása — az action: "end" lezárja a futó műszakodat. Az adminok id átadásával más futó műszakját is lezárhatják.

Műszak rögzítése — az action: "create" teljes műszakot ír bármely ügyintézőnek (All Shifts kell hozzá), bérszámfejtési pótlásokhoz és javításokhoz. A naplóban kézzel létrehozottként jelenik meg.

Műszak javítása — az action: "update" csak az átadott mezőket módosítja. Az idő- és órabér-javítások szerkesztettként jelölik a műszakot, ami figyelmeztető jelzésként látszik az irányítópulton. Egy műszak legfeljebb 31 napos lehet.

Törlés — az action: "delete" végleges, és a műszak naplóját is eltávolítja. A véglegesített műszakokat előbb fel kell oldani.

Minden naplózva van. Minden módosítás ugyanabba a műszaknaplóba ír, amelyet az irányítópult mutat — ki mit változtatott, régi és új értékek — a bejelentkezett felhasználóhoz rendelve és Copilot/MCP eredetűként megjelölve.

A Copilot előbb kérdez. Az irányítópult Copilotjában a manage_shift futtatás előtt mindig Megerősítés gombot mutat — bérszámfejtési adatokhoz nyúl, ezért soha nem cselekszik kérdezés nélkül.

get_shift_report

Egy időszak összes műszakját bérszámfejtési és beosztási számokká összesíti — ugyanazok az adatok, mint az irányítópult Riportok oldalán, nyers műszakok lapozgatása nélkül.

Paraméterek

Paraméter	Típus	Kötelező	Leírás
`startDate`	string	Igen	ISO dátum — az ekkor vagy ez után kezdődő műszakok kerülnek bele.
`endDate`	string	Nem	ISO dátum — az eddig kezdődő műszakok kerülnek bele. Alapértelmezés: most.
`shiftTypeIds`	string tömb	Nem	A riport szűkítése ezekre a műszaktípusokra.
`userId`	string	Nem	A riport szűkítése egy ügyintézőre.
`includeDaily`	boolean	Nem	Napi bontás visszaadása is.

Mit ad vissza

Ügyintézőnként: műszakszám, összes óra, átlagos óra műszakonként, összes bér, plusz hány műszak fut még, lett kézzel szerkesztve vagy véglegesítve.
Összesítés: ügyintézők, műszakok, órák és bér a teljes időszakra.
Műszaktípusonként: műszakok, órák és bér típusonként.
Naponta (az includeDaily-vel): az összegzett munkaórák a lefedett órák mellett — az átfedő műszakok összevonva, így látod, volt-e valaki szolgálatban, nem csak azt, mennyi összidő gyűlt. A napok UTC éjfélnél válnak el.

A még futó műszakok külön számolódnak, és nem adnak órát vagy bért. A bérösszegek egyszerű számok — az irányítópult dollárjellel jeleníti meg őket.

Példa promptok

"Indíts nekem chat ügyeleti műszakot."
"Zárd le a műszakomat."
"Tegnap elfelejtettem kijelentkezni — állítsd a műszakom végét 18 órára."
"Rögzíts Annának egy 8 órás műszakot múlt keddre."
"Ki van most bejelentkezve műszakba?"
"Hány órát dolgozott minden ügyintéző múlt hónapban, és mennyivel tartozunk nekik?"
"Mutasd a kézzel szerkesztett műszakokat ebben a hónapban."
"Véglegesítsd ezt a műszakot a bérszámfejtéshez."
"Milyen volt a beosztási lefedettségünk múlt héten, napi bontásban?"

Gyakori munkafolyamat minták

Hó végi bérszámfejtés

Kérd le a számokat → get_shift_report a hónapra
Szűrd ki, ami még nyitott vagy nincs véglegesítve → list_records a table: "shifts", finalized: false beállítással
Javíts és zárolj → manage_shift az idők javításához, majd finalized: true

Példa prompt: "Futtasd le a júliusi műszakriportot, mutasd a nem véglegesített műszakokat, és véglegesítsd azokat, amelyek teljesnek tűnnek."

Elfelejtett kijelentkezés javítása

Keresd meg a futó műszakot → list_records a table: "shifts", running: true beállítással
Zárd le a megfelelő időpontban → manage_shift az endTime-mal

Példa prompt: "Keresd meg a futó műszakomat, és zárd le tegnap 18 órakor."

Beosztás áttekintése

Kérd le a napi bontást → get_shift_report az includeDaily: true beállítással
Vesd össze a munkaórákat a lefedett órákkal — a nagy különbség átfedő műszakokat jelent; a kevés lefedett óra lefedettségi lyukakat

Példa prompt: "Mutasd a múlt heti lefedettséget napi bontásban — volt olyan óra, amikor senki nem volt szolgálatban?"

A nyers műszakok böngészését az Adathozzáférés eszközök fedik le — szűrés ügyintézőre, műszaktípusra, futó, véglegesített vagy szerkesztett állapotra és időszakra; egy műszak lekérése az All Shifts birtokosoknak a naplóját is visszaadja. A funkció irányítópulti oldalát a Műszakok írja le.