InnerWeb
Přejít na obsah

Přiložení ve špičce: poznámky pro IT skladu

Na začátku směny projde bránou během několika minut stovka lidí a každé přiložení je požadavek ze systému KD do InnerWeb. Tým IT by měl předem ověřit autentizaci, zpracování chyb, identifikaci místa přiložení a požadavky specifikace webhooku. Níže jsou poznámky k nasazení seřazené podle pořadí testů před špičkou.

JWT
token s omezenou platností, obnovovaný automaticky
0,44 /s
průměrné tempo přiložení při 400 osobách za 15 minut, příklad
Zdroj: příkladová kalkulace

Jak integrace funguje a co InnerWeb nedělá

Bodem integrace se stávajícím systémem KD je webhook přiložení karty: systém KD odešle při každém přiložení požadavek HTTP POST. InnerWeb nevyrábí ani nevyměňuje čtečky. Je nezávislým systémem doplňujícím KD, RCP, HR a ERP. Pro IT to znamená, že bodem testů je dodavatel KD a jeho fronta odesílání, nikoli zařízení u brány.

Oznámení obsahuje čas události, místo přiložení a údaje osoby: jméno a příjmení (povinné), zkratku, firmu (název povinný), číslo aktivní karty, telefon, e-mail a jazyk.

Etapa 1: autentizace a obnova tokenu

Volání webhooku vyžaduje token JWT z přihlašovacího endpointu API. Jde o token s omezenou platností, který integrace obnovuje automaticky. Při několika směnách denně musí obnova fungovat bez zásahu člověka, i uprostřed směny. Tým IT by měl ověřit, zda systém KD obnovuje token před vypršením platnosti a co udělá po odpovědi, která požadavek odmítne.

Navrhovaný test: vynuťte obnovu tokenu v testovacím prostředí a sledujte, zda se přiložení z fronty systému KD neztrácejí. Zapište, kolik přiložení bude po obnově zopakováno.

Průměrné tempo přiložení podle doby začátku směny, příklad

Průměrné tempo přiložení podle doby začátku směny, příkladSloupcový graf: 400 osob za 10 minut je 40 přiložení za minutu, za 15 minut 27, za 30 minut 13.010203040přiložení za minutu10 minut: 40 přiložení za minutu4010 minut15 minut: 27 přiložení za minutu2715 minut30 minut: 13 přiložení za minutu1330 minut
Zdroj: Příkladová kalkulace: 400 přiložení rovnoměrně rozložených v daném časovém okně.

Etapa 2: požadavky specifikace pro události z KD

Systém KD posílá události v reálném čase, s časem události načteným z čtečky, směrem (vstup nebo výstup) a identifikátorem události, a InnerWeb je přijímá přes ověřený webhook. Pravidla párování vstupů a výstupů a odmítání duplicit se určují ve specifikaci s dodavatelem KD. Ve špičce to má význam: pokud systém KD sbírá přiložení ve frontě a odesílá je se zpožděním, v InnerWeb rozhoduje čas přiložení z čtečky, nikoli čas odeslání.

Identifikátor události odliší opakovaný požadavek od dalšího přiložení. Tým IT by se proto měl s dodavatelem KD dohodnout na pravidlech opakování, omezit je na situace bez potvrzení přijetí a popsat, jak se systém KD chová. Stavy typu začátek a konec práce nespadají do rozsahu této integrace.

Etapa 3: rozlišení bran a míst přiložení

Dodavatel KD, který přikládá karty na několika místech, je rozlišuje polem místa přiložení. Ve skladu s několika bránami, zámky a vstupy do zón je třeba dohodnout slovník názvů míst a udržovat ho stálý. Změna názvu brány v systému KD bez dohody způsobí rozjetí přehledů.

  • Vypište všechna místa přiložení ze systému KD a jejich názvy.
  • Dohodněte se s administrátorem InnerWeb na rozsahu míst, na která se vztahuje kontrola školení.
  • Otestujte přiložení na každé bráně před špičkou.

Etapa 4: zátěžový test před sezónou

Při předpokladu 400 osob za 15 minut připadá v průměru 400 / 900 sekund, tedy přibližně 0,44 přiložení za sekundu, a v krátkodobé špičce mnohonásobně více. Jde o příkladovou kalkulaci. Test by měl tento vzorec napodobit: sérii požadavků ze systému KD s údaji několika stovek osob, včetně nových, systému neznámých. Sledujte zpoždění odpovědí, odmítnutí a počet založených účtů a firem.

Přiložení osoby neznámé systému založí účet a firmu, takže test s novými osobami ověří i jednotnost zápisu názvů agentur.

Co má tým IT mít připravené před první špičkou

Nejdůležitější jsou tři věci: postup obnovy tokenu, popis chování systému KD při absenci odpovědi a kontakt na administrátora InnerWeb na dobu špičky. Vhodné je také určit, kdo v IT sleduje bránu v prvních 30 minutách směny.

Videomateriál

Často kladené otázky

Jak funguje token pro webhook?

Je to token s omezenou platností, který integrace obnovuje automaticky, takže systém KD by jej měl obnovovat během směny.

Jaká data by měl systém KD posílat?

Události v reálném čase, s časem z čtečky, směrem vstup nebo výstup a identifikátorem události. Pravidla párování a odmítání duplicit se určují ve specifikaci s dodavatelem KD.

Jak InnerWeb pozná, která je to brána?

Z pole místa přiložení v oznámení. Názvy je třeba udržovat stálé.

Lze zátěžový test provést v produkci?

Doporučujeme testovací prostředí, protože test s novými osobami zakládá účty a firmy.

Otestujte integraci před sezónou

Domluvte si konzultaci s týmem IT. Projdeme token, frontu přiložení a slovník míst, než směna začne se stovkami karet.

Pojďme si promluvit