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¶
- 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“.
- Ověří: postupně se otevřou okna „Vyberte objednávku“, „Vyberte typ protokolu“ a formulář protokolu.
- Ověří: po uložení se otevře detail nového protokolu.
- V detailu klikne na „Vygenerovat a podepsat“.
- Ověří: stáhne se soubor s koncovkou „.pdf“, větší než 1 000 bajtů, který začíná hlavičkou PDF „%PDF-“.
- Klikne na „Stáhnout“.
- Ověří: znovu se stáhne soubor, který splní stejné tři podmínky.
- Obnoví stránku, klikne na „Upravit“, do pole pro potvrzení finálního protokolu nahraje soubor „test-document.pdf“ a klikne na „Uložit“.
- Ověří: otevře se okno úprav a je v něm pole pro potvrzení finálního protokolu.
- Ověří: po uložení se okno zavře.
- Znovu otevře stránku Protokoly.
- 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.
- Ověří: štítek typu odpovídá testovanému typu a stav je Podepsáno a potvrzeno.
- 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,afterEachasetupReceivedOrder(…, label)jako ve scénáři 147. - Založení
createProtocolViaUi:fillCreateFormvyplní jenissuedDate, u COMPLETED_WORK_LISTitems.0.price1000 a u TRAININGplace. generatePdfAndWaitForDownload(): klik naprotocol-generate-pdfawaitForEvent("download").assertValidPdfDownload:suggestedFilename()odpovídá/\.pdf$/i,download.path(), velikost nad 1000 B, prvních 5 bajtů%PDF-.downloadGeneratedPdf(): tlačítko „Stáhnout“ sexact: 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 sinput[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
OneDriveServicezapisuje na skutečný SharePoint pod prefixem běhu (getUniqueTestRunPrefix); složku smažecleanSharePoint()vafterEach. TEST_PDF=tests/e2e/test-files/test-document.pdf.