Vissza — Műszakütemező API
Termék-újdonságok

Újdonságok

A motor minden verziója, amely a nyilvános API-t megváltoztatta — új mezők és végpontok, validáció, törő változások, a kiadás dátumával. A motor jelez és indokol; megfelelőséget nem garantál.

10 fejlesztésmotor-verziónként egy bejegyzés

2026. november

2
Fejlesztés

v0.9.0 — ⚠️ TÖRŐ VÁLTOZÁS: két minta-kulcs átnevezve

Két műszak-minta, amely eddig cégről volt elnevezve, mostantól a szerkezetét leíró kulcsot kap: az egyik a 28 napos 8 órás „7,3,7,3,7,1” ciklus (8h-7-3-7-3-7-1), a másik a 8 órás reggel–délután–éjszaka rotáció 12 órás napokkal (8h-rde-12h). A ciklusok karakterre azonosak, a beosztás nem változik. Alias nincs: a régi kulcs mostantól ismeretlen minta, és 422-t ad — aki tárolta, a /v1/patterns listájából válassza újra. A v1 séma nem változott, csak az elfogadott kulcs-értékek.

  • Régi kulcs → 422 (ismeretlen minta); új kulcs: 8h-7-3-7-3-7-1 és 8h-rde-12h
  • Minta-könyvtár verziója: 2026-11-12
Funkció

v0.8.0 — munkaviszony-időszak dolgozónként

A dolgozó új, opcionális employed_from / employed_until mezője (inkluzív; fordított sorrend → 422) a hó közben belépőt és kilépőt írja le. Az időszakon kívüli nap -, nem számít a lefedettségbe, az assignments arra a napra nem hat, a megfelelőség-ellenőrzés csak a munkaviszonyos napokat értékeli, és a munkaidőkeret elvárt órája (expected_hours) személyenként csak az időszakon belüli munkanapokból számol. Mindkét build-végponton; mezők nélkül a válasz a korábbival azonos.

2026. szeptember

7
Funkció

v0.7.0 — beosztás tetszőleges időszakra: POST /v1/schedule:build-range

Az új végpont egy tetszőleges, inkluzív dátumtartományra (legfeljebb 366 nap) épít beosztást, nem csak egy naptári hónapra. A gördülő megfelelőségi ablakok a TELJES tartományon futnak; a visszafelé megadott vagy túl hosszú tartomány 422. A havi /v1/schedule:build változatlan.

Biztonság

v0.6.2 — bemenet-méretkorlátok

A kérés mezői felső korlátot kaptak (pl. a névsor legfeljebb 500 fő, az ünnepnap-lista 400 tétel, a rule_overrides 50×50, az assignments 500 fő × 62 nap); a túlméretes kérés tiszta 422-t ad, nem terheli a szervert.

Biztonság

v0.6.1 — hibás bemenet: 422 szerverhiba helyett

A tartományon kívüli műszakcsoport-szám, a REST-en nem támogatott LEAN dolgozó, az ismétlődő staff_id és a rule_overrides nem véges száma (NaN, Infinity) mostantól érthető 422-t ad, nem 5xx-et.

Fejlesztés

v0.6.0 — a statisztika a csúszó és az ünnepi pihenőnapot is számolja

A személyenkénti statisztika két új mezője: flex_days (csúszó, CS) és holiday_rest_days (ünnepi pihenő, Üp).

Funkció

v0.5.0 — munkaidőkeret: elvárt óra és egyenleg

Új work_time_frame szabálytípus és a magyar szabálykönyv munkaidokeret szabálya (Mt. 93–94. §, paraméterek: weekly_hours 40, frame_months 4 — a rule_overrides-szal állíthatók). A statisztika a hó elvárt óráját (expected_hours: általános munkanapok × napi óra, ünnep levonva) és a személyenkénti egyenleget (balance = ledolgozott − elvárt) is adja. Jelez és indokol — megfelelőséget nem garantál.

Funkció

v0.4.0 — személyenkénti statisztika a válaszban

A beosztás-válasz új statistics mezője személyenként: ledolgozott óra (worked_hours), éjszakák (night_count), műszakok (shift_count) és szabadságnapok (vacation_days) — a felülírásokkal együtt számolva.

Funkció

v0.3.0 — napi felülírás a rotáció fölött: assignments

A kérés új assignments mezője (staff_id → {nap → jel}) egy-egy dolgozó adott napi jelét írja felül a rotáció fölött; a lefedettség és a megfelelőség-ellenőrzés a felülírt jelekből számol. A felülírás a bemenet része, így a kimenet továbbra is determinisztikus; az ismeretlen jel 422.

2026. augusztus

1
Funkció

v0.2.0 — saját ünnepnaptár, szabály-felülírás, időzóna és óraátállítás

A kérés holidays mezőjében a tényleges ünnepnaptár adható meg, a rule_overrides pedig kérésenként állítja a szabályok küszöbeit és be/ki kapcsolását (a motor nem tárol semmit). A telephely timezone mezője (IANA, alap Europe/Budapest) a valós munkaórát adja: az óraátállítás éjszakája 11 vagy 13 óra. Két új alapadat-végpont: GET /v1/holidays?year= és GET /v1/rules.

Hírlevél

Kövesd az OPEREX fejlődését

Új modulok, ipari műszaknapló-tippek és ISO 45001-es gyakorlatok — havonta legfeljebb egyszer, spam nélkül.

Bármikor leiratkozhatsz — minden levél alján ott a link.