Skip to content

101 · Odkaz z QR kódu skladové položky patří této položce a otevře její detail

Co test ověřuje

Že QR kód skladové položky obsahuje odkaz do portálu, který podle aplikace patří této položce, a že otevření odkazu v prohlížeči přesměruje na detail položky.

Výchozí stav (test si ho připraví sám)

  • Prázdná databáze. Test se přihlásí jako testovací uživatel a přes API mu přidělí role administrátor a skladník.
  • Kategorie skladových položek „Nářadí“, „Materiál“ a „Ochranné pomůcky“, vytvořené přes API.

Postup

  1. Test otevře stránku Skladové položky a formulářem „Nová položka“ založí položku „QR Scan Test Item“. Vyplní formulář včetně obrázku (Kategorie „Nářadí“, Jednotka „ks“, Stav „Aktivní“) a klikne na „Uložit“.
  2. Klikne v řádku položky na šipku pro otevření detailu.
  3. Ověří: otevře se detail položky.
  4. Přečte QR kód z obrázku na detailu.
  5. Ověří: kód jde přečíst a je v něm odkaz na QR kód v portálu.
  6. Přímo (bez obrazovky) se aplikace zeptá, komu odkaz z kódu patří.
  7. Ověří: odkaz patří této skladové položce (stejné ID, jaké má otevřený detail).
  8. Otevře odkaz z QR kódu v prohlížeči, jako by kód naskenoval fotoaparát telefonu.
  9. Ověří: aplikace přesměruje na detail téže položky.
  10. Ověří: stránka má nadpis „QR Scan Test Item“.

Co test neověřuje

  • Skutečné skenování. Test kód přečte z obrázku na stránce a odkaz otevře sám.
  • Adresu serveru v QR kódu. Test z odkazu použije jen část za adresou serveru a otevře ji na testovacím serveru.
  • Co odkaz udělá pro nepřihlášeného uživatele. Test je celou dobu přihlášený.
  • Popisek s názvem položky v QR kódu (scénář 098) ani přegenerování kódu (scénář 099).
  • QR kód uskladnění (scénář 103).
  • Cestu přes menu. Test stránku otevírá rovnou adresou.
  • Jiné role. Testovací uživatel má role administrátor a skladník zároveň.

Pro vývojáře

  • Test: storage.spec.ts › „should verify QR code scanning resolves to correct item“
  • Describe „Storage › QR Codes“. Společná příprava z describe „Storage“: cleanDb, logIntoApp(TEST_EMAIL), assignRoles (ADMIN, WAREHOUSEMAN), tři kategorie přes createStorageCategory, page.reload(); afterEach cleanSharePoint.
  • ID položky z URL detailu (/warehouse/items/(\d+), expect(urlIdMatch).not.toBeNull()); detail přes test id detailBtn.
  • getItemQrCodeUrl(itemId): znovu goto detailu, čeká na SVG s prvkem text, dekóduje jsQR; vyhodí chybu, když kód nejde přečíst nebo nekončí na /api/qrcodes/<id>. Vrátí origin testovacího serveru + tuto cestu, takže hostitel v kódu (APP_URL) se neověřuje a expect(qrCodeUrl).toContain("/api/qrcodes/") projde vždy, když projde helper.
  • verifyQrCodeReturnsItem: fetch(url + "?json=true") s credentials: "include", pak entityType: "storageItem" a id = id položky.
  • Přesměrování: page.goto(qrCodeUrl) a waitForURL("**/warehouse/items/<id>") (route /api/qrcodes/[identifier] bez json volá redirect), pak getByRole("heading", { name: "QR Scan Test Item" }).