Skip to content

148 · Protokol každého typu jde vygenerovat do PDF a po nahrání podepsaného potvrzení je ve stavu Podepsáno a potvrzeno

Co test ověřuje

Že u protokolu každého ze sedmi typů stáhne tlačítko „Vygenerovat a podepsat“ v detailu platné PDF a že vygenerované PDF jde stáhnout znovu tlačítkem „Stáhnout“. Po nahrání podepsaného potvrzení finálního protokolu je protokol v seznamu ve stavu Podepsáno a potvrzeno.

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

  • Test běží zvlášť pro každý typ protokolu: PP o dílo, Zápis o předání staveniště, Soupis provedených prací, Zápis o předání dokumentace, P o zaškolení obsluhy, Žádost o KZ a Žádost o DZ. Každý běh začíná s prázdnou databází.
  • Přihlášený je testovací uživatel Petr Zástupce s rolemi administrátor, účetní a manažer. Role i podpis uživatele, bez kterého generování neprojde, test nastaví přes API.
  • Zakázka „Protocol Contract [typ]“ (cena 500 000 Kč) a k ní přijatá objednávka zákazníka „Protocol Customer [typ]“ na 500 000 Kč s dnešním datem vystavení, vše vytvořené přes API. [typ] je anglické označení typu, např. „work-handover“. Kód objednávky test zjistí přes API.
  • Vygenerovaná a nahraná PDF se ukládají na skutečný SharePoint do testovací složky, kterou test po skončení smaže.

Postup

  1. Test otevře stránku Protokoly z bočního menu a formulářem založí k objednávce protokol testovaného typu: „Přidat protokol“, v okně „Vyberte objednávku“ výběr objednávky podle kódu a „Vybrat“, u typu „Nový“, dnešní datum a „Uložit“. U soupisu provedených prací vyplní i cenu první položky 1000, u protokolu o zaškolení Místo zaškolení „Místo školení E2E“.
  2. Ověří: postupně se otevřou okna „Vyberte objednávku“, „Vyberte typ protokolu“ a formulář protokolu.
  3. Ověří: po uložení se otevře detail nového protokolu.
  4. V detailu klikne na „Vygenerovat a podepsat“.
  5. Ověří: stáhne se soubor s koncovkou „.pdf“, větší než 1 000 bajtů, který začíná hlavičkou PDF „%PDF-“.
  6. Klikne na „Stáhnout“.
  7. Ověří: znovu se stáhne soubor, který splní stejné tři podmínky.
  8. Obnoví stránku, klikne na „Upravit“, do pole pro potvrzení finálního protokolu nahraje soubor „test-document.pdf“ a klikne na „Uložit“.
  9. Ověří: otevře se okno úprav a je v něm pole pro potvrzení finálního protokolu.
  10. Ověří: po uložení se okno zavře.
  11. Znovu otevře stránku Protokoly.
  12. Ověří: kód protokolu v prvním řádku tvoří prefix typu (PPD, ZPS, SPP, ZPD, PZO, ZKZ nebo ZDZ, přiřazení jako ve scénáři 147) a za ním osm číslic.
  13. Ověří: štítek typu odpovídá testovanému typu a stav je Podepsáno a potvrzeno.
  14. Ověří: ve sloupci Objednávka je kód objednávky.

Co test neověřuje

  • Obsah PDF: údaje protokolu, podpis ani název souboru. Test kontroluje jen koncovku, velikost a hlavičku souboru.
  • Že druhé stažení je tentýž soubor jako první.
  • Že protokol po vygenerování zůstane ve stavu V procesu. Stav test kontroluje až po nahrání potvrzení.
  • Tlačítko „Nahrát potvrzení“. Potvrzení test nahrává v okně úprav přes „Upravit“.
  • Stažení nahraného potvrzení („Stáhnout potvrzení“) a údaj Potvrzen finální protokol v detailu.
  • Generování bez nastaveného podpisu.
  • Že potvrzení PP o dílo vyplní objednávce Začátek rekl. doby (scénář 026).
  • Stav Podepsáno a potvrzeno s vady a nedodělky (scénář 149).
  • Popisky polí a texty a barvy štítků. Test pole i štítky hledá podle interních názvů.
  • Jednotlivé role zvlášť. Uživatel má najednou roli administrátor, účetní i manažer.

Pro vývojáře

  • Test: protocols.spec.ts › „generates PDF for ${label} and transitions to SIGNED_AND_CONFIRMED“
  • Smyčka přes VARIANTS = 7 testů; beforeEach, afterEach a setupReceivedOrder(…, label) jako ve scénáři 147.
  • Založení createProtocolViaUi: fillCreateForm vyplní jen issuedDate, u COMPLETED_WORK_LIST items.0.price 1000 a u TRAINING place.
  • generatePdfAndWaitForDownload(): klik na protocol-generate-pdf a waitForEvent("download"). assertValidPdfDownload: suggestedFilename() odpovídá /\.pdf$/i, download.path(), velikost nad 1000 B, prvních 5 bajtů %PDF-. downloadGeneratedPdf(): tlačítko „Stáhnout“ s exact: true (ne „Stáhnout potvrzení“).
  • uploadConfirmationFile(TEST_PDF): page.reload() (generování invaliduje jen dotaz na soubor z OneDrive, ne protokol, a pole potvrzení je podmíněné protocolFinal), „Upravit“, dialog s input[name="issuedDate"] viditelný, input[type="file"][name="protocolFinalConfirmation"], „Uložit“, dialog skrytý. Stav mění až nahrání potvrzení (ProtocolService → SIGNED_AND_CONFIRMED), generování nechá IN_PROCESS.
  • Grid: assertProtocolInGrid (první řádek, codePrefix, protocol-type-chip-${variant}, protocol-state-chip-SIGNED_AND_CONFIRMED, data-field="order").
  • Soubory: komentář ve spec mluví o mocku OneDrive / SharePoint, v e2e ale OneDriveService zapisuje na skutečný SharePoint pod prefixem běhu (getUniqueTestRunPrefix); složku smaže cleanSharePoint() v afterEach.
  • TEST_PDF = tests/e2e/test-files/test-document.pdf.