026 · Objednávka a PP o dílo založené formulářem vyplní začátek rekl. doby a řádek na stránce Zádržné je zvýrazněný¶
Co test ověřuje¶
Že přijatá objednávka založená formulářem a PP o dílo založený, vygenerovaný a potvrzený na obrazovce vyplní objednávce Začátek rekl. doby datem vystavení protokolu. Faktura objednávky je pak na stránce Zádržné se zvýrazněným řádkem (hranice 2 měsíců před koncem záruky byla včera), se zádržným 121 000 Kč a nárokem 114 950 Kč (95 %).
Výchozí stav (test si ho připraví sám)¶
- Prázdná databáze, přihlášený je testovací uživatel s rolemi administrátor a účetní a s podpisem nastaveným přes API.
- Zákazník „UI Test Customer s.r.o.“ a zakázka „UI Test - Retainage Expiration“ (středisko 2025032, cena 121 000 Kč), vytvořené přes API.
- Trivi v testu nahrazuje simulace. Vrací mimo jiné fakturu „FV2025020007“: 121 000 Kč s DPH, splatnost 20. 3. 2021, nic neuhrazeno, číslo objednávky „OBJ-EXPIRED“, středisko 2025032.
- Datum vystavení objednávky i protokolu test spočítá od dnešního dne tak, aby hranice pro zvýraznění (konec pětileté záruky minus 2 měsíce) byla včera.
Postup¶
- Test otevře seznam přijatých objednávek a klikne na „Nahrát objednávku“.
- Nahraje dokument „test-document.pdf“ a vyplní Zákazník „UI Test Customer s.r.o.“ a Zakázka „UI Test - Retainage Expiration“ (výběrem z nabídky), Datum vystavení (spočítané datum), Externí číslo „OBJ-EXPIRED“, Celková cena bez DPH 121 000, Měna CZK, Roky 5, KZ 5 a DZ 5. Začátek rekl. doby nevyplní.
- Ověří: Začátek rekl. doby je prázdný.
- Klikne na „Uložit“ a z prvního řádku seznamu objednávek si přečte kód objednávky.
- Otevře v menu stránku Protokoly, klikne na „Přidat protokol“, v okně „Vyberte objednávku“ vybere objednávku podle kódu a klikne na „Vybrat“.
- U PP o dílo klikne na „Nový“.
- Ověří: otevře se okno „Vytvořit PP o dílo“.
- Vyplní Datum vystavení (spočítané datum) a klikne na „Uložit“.
- V detailu protokolu klikne na „Vygenerovat a podepsat“ a počká 2 sekundy.
- Klikne na „Nahrát potvrzení“, nahraje „test-document.pdf“ jako potvrzení finálního protokolu a klikne na „Uložit“.
- Otevře seznam přijatých objednávek, dvojklikem na řádek otevře detail objednávky a klikne na „Upravit“.
- Ověří: otevře se detail objednávky a okno úprav s polem Začátek rekl. doby.
- Ověří: Začátek rekl. doby je vyplněný datem vystavení protokolu (den, měsíc i rok).
- Otevře stránku Zádržné.
- Ověří: seznam neukazuje „Žádné záznamy“.
- Ověří: v seznamu je faktura „FV2025020007“ a její řádek je zvýrazněný.
- Zkontroluje souhrnné ukazatele.
- Ověří: „Zádržné - Celkem“ je „121 000,00 Kč“ a součet Celkem v CZK pod ním „121 000,00 Kč“.
- Ověří: „Zádržné - Nárok“ je „114 950,00 Kč“ a zbytek bez nároku pod ním „6 050,00 Kč“.
- Zkontroluje řádek faktury.
- Ověří: Celkem v CZK je „121 000,00 Kč“ a Uhrazeno v CZK „0,00 Kč“.
- Ověří: Zádržné je „121 000,00 Kč“ a Procenta „100,00 %“.
- Ověří: Nárok zádržné je „114 950,00 Kč“ a Nárok procenta „95,00 %“.
Co test neověřuje¶
- Stav protokolu (Podepsáno a potvrzeno). Test ho nekontroluje, jen dopad na objednávku a na stránku Zádržné.
- Odkud se Začátek rekl. doby bere. Objednávka i protokol mají stejné datum vystavení, test je nerozliší.
- Že je Začátek rekl. doby prázdný ještě po uložení protokolu a před nahráním potvrzení. Test ho kontroluje jen ve formuláři nové objednávky a na konci.
- Hlášení po uložení objednávky a protokolu a obsah vygenerovaného PDF.
- Názvy polí formulářů, sloupců a nadpisy ukazatelů. Test hledá pole a hodnoty podle interních názvů.
- Barvu zvýraznění. Test kontroluje jen, že řádek má označení pro zvýraznění.
- Nárok po skončení záruky, kdy je nárokem celé zádržné.
- Sloupec Expirace a ostatní sloupce (Odběratel, Objednávka, ŽKZ, ŽDZ, DUZP, Celkem, Měna).
- PP o dílo potvrzený jen s vady a nedodělky (scénář 027).
- Jiné role než administrátor a účetní.
- Skutečné napojení na Trivi.
Pro vývojáře¶
- Test:
retainage.spec.ts› „UI: Create retainage data via UI and verify expiration highlighting“ - Přes API jen
createAccountingEntityacreateContract(branch: "2025032"), test čekáisSuccess.issuedDate = calculateIssuedDateForExpiration(5, -1). - Objednávka:
navigateToReceivedOrdersList(/orders/received),clickNewReceivedOrderButton,uploadReceivedOrderFile(input[type="file"][name="file"],tests/e2e/test-files/test-document.pdf),fillReceivedOrderFormUI(pole podlename: customer, contract, dateOfIssue, externalNumber, totalPrice, currency, retainageYears, shortRetainage, longRetainage; procenta × 100),assertMuiDatePickerEmpty("warrantyStart")(DD/MM/YYYY),saveReceivedOrder,getOrderCodeFromGrid(první buňkadata-field="code"). - Protokol:
navigateToProtocolsPage(boční menu),clickNewProtocolButton,selectOrderForProtocol(orderCode), test idnew-protocol-WORK_HANDOVER,fillProtocolFormUI(čeká dialog „Vytvořit PP o dílo“, poleissuedDate),saveProtocol,clickGenerateProtocolButton(getByRole("button", { name: "Generovat" })najde podřetězcem „Vygenerovat a podepsat“, pakwaitForTimeout(2000)),clickUploadConfirmationButton,uploadProtocolConfirmation(protocolFinalConfirmation),saveProtocolConfirmation. - Objednávka po protokolu:
doubleClickReceivedOrderRow(waitForURL(/\/orders\/received\/\d+/)),clickEditReceivedOrderButton(dialog swarrantyStartviditelný),page.waitForTimeout(1000),assertWarrantyStartFilled(issuedDate)(spinbuttony Day, Month, Year). - Zádržné:
assertHasRecords,assertInvoiceRowExists("FV2025020007"),assertInvoiceRowExpired(toHaveClass(/expired/)), test id ukazatelů aassertInvoiceRow; hodnoty zcalculateRetainageValues(isAfterExpiration: false).