Skip to content

147 · Protokol každého typu založený formulářem uloží všechna pole a v seznamu má kód s prefixem typu, stav V procesu a objednávku

Co test ověřuje

Že protokol každého ze sedmi typů jde k přijaté objednávce založit formulářem se všemi vyplněnými poli a že okno úprav pak ukazuje uložené hodnoty. Protokol je potom v seznamu na stránce Protokoly s kódem s prefixem svého typu, se štítkem svého typu, ve stavu V procesu a u správné objednávky.

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 a s podpisem, role i podpis nastavené přes API. Díky jménu a roli manažer ho formulář zápisu o předání staveniště nabízí v poli Zastupující předávajícího.
  • 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, který přidělila aplikace, test zjistí přes API.

Postup

  1. Test otevře stránku Protokoly z bočního menu a klikne na „Přidat protokol“.
  2. Ověří: otevře se okno „Vyberte objednávku“.
  3. V poli Objednávka vybere z nabídky objednávku podle jejího kódu a klikne na „Vybrat“.
  4. Ověří: otevře se okno „Vyberte typ protokolu“.
  5. U testovaného typu klikne na „Nový“.
  6. Ověří: otevře se formulář protokolu.
  7. Vyplní všechna pole formuláře podle typu:
  8. PP o dílo: Datum vystavení dnešní, Datum vystavení s vady a nedodělky zítřejší, Specifikace převzatých částí díla „Převzaté části díla E2E“, Důvod objednatele k nepřevzetí díla „Důvod nepřevzetí E2E“, Poznámky „Poznámka k předání E2E“ a tlačítkem „Přidat“ kontaktní osobu se jménem „Jan Novák“ a telefonem „+420123456789“.
  9. Zápis o předání staveniště: Datum vyhotovení dnešní, Zastupující předávajícího „Petr Zástupce“ výběrem z nabídky, všech deset textových polí o staveništi texty ve tvaru „Staveniště … E2E“ a tlačítkem „Přidat“ odpovědného TH zaměstnance se jménem „Pavel Stavba“ a telefonem „+420987654321“.
  10. Soupis provedených prací: Datum vystavení dnešní, u první položky Popis položky „Provedené práce E2E“ a Cena položky (bez DPH) 1000, Popis sumarizačního řádku „Souhrn prací E2E“.
  11. Zápis o předání dokumentace: Datum vyhotovení dnešní, Přebírající „Přebírající E2E“ a tlačítkem „Přidat“ položku seznamu dokumentace „Dokument předání E2E“.
  12. P o zaškolení obsluhy: Datum zaškolení dnešní, Místo zaškolení „Místo školení E2E“, Zaškolená osoba „Školená osoba E2E“, Pozice zaškolené osoby „Obsluha zařízení“, Obsah školení „Obsah školení E2E“ a Poznámky „Poznámky ke školení E2E“.
  13. Žádost o KZ: Datum dnešní a Poznámky „Poznámka KZ E2E“.
  14. Žádost o DZ: Datum dnešní a Poznámky „Poznámka DZ E2E“.
  15. Ověří: u zápisu o předání staveniště je v nabídce pole Zastupující předávajícího „Petr Zástupce“.
  16. Klikne na „Uložit“.
  17. Ověří: otevře se detail nového protokolu.
  18. V detailu klikne na „Upravit“.
  19. Ověří: otevře se okno úprav protokolu.
  20. Ověří: všechna pole z kroku 4 mají zadané hodnoty: data se shodují ve dni, měsíci i roce, texty, jména a telefony přesně, cena položky obsahuje „1 000“ (s mezerou i bez) a textové editory obsahují zadaný text.
  21. Klikne na „Zrušit“.
  22. Ověří: okno úprav se zavře.
  23. Znovu otevře stránku Protokoly.
  24. Ověří: v seznamu je právě jeden protokol.
  25. Ověří: jeho kód tvoří prefix typu a za ním osm číslic: PP o dílo „PPD“, Zápis o předání staveniště „ZPS“, Soupis provedených prací „SPP“, Zápis o předání dokumentace „ZPD“, P o zaškolení obsluhy „PZO“, Žádost o KZ „ZKZ“ a Žádost o DZ „ZDZ“.
  26. Ověří: štítek typu odpovídá testovanému typu a stav je V procesu.
  27. Ověří: ve sloupci Objednávka je kód objednávky.

Co test neověřuje

  • Jedinečnost kódu. Test zakládá jediný protokol (dva soupisy k jedné objednávce: scénář 152, všechny typy k jedné objednávce: scénář 157).
  • Že číslice kódu obsahují rok a pořadové číslo. Test kontroluje jen osm číslic za prefixem.
  • Popisky polí a nadpis formuláře. Test hledá pole podle interních názvů, popisky v postupu jsou jen pro orientaci.
  • Hodnoty v detailu protokolu. Test je kontroluje jen v okně úprav.
  • Pole Zastupující přejímajícího u zápisu o předání staveniště a výběr kontaktní osoby ze seznamu kontaktů zákazníka. Test přidá prázdný řádek a vyplní ho ručně.
  • Sloupce Datum a Zakázka v seznamu.
  • Texty a barvy štítků typu a stavu. Test štítky pozná podle interního označení.
  • Povinná pole formuláře (bez objednávky dál nepustí: scénář 151).
  • Protokoly k vystaveným objednávkám (stránka Protokoly VO) a typ Ukončení objednávky.
  • Jednotlivé role zvlášť. Uživatel má najednou roli administrátor, účetní i manažer.

Pro vývojáře

  • Test: protocols.spec.ts › „creates ${label} protocol → all fields persisted, unique code, grid row, chips, order binding“
  • Smyčka přes VARIANTS = 7 testů (label: work-handover, construction-site, completed-work-list, documentation, training, retainage-short, retainage-long). Describe „Protocols (Protokoly)“: viewport 2560×1440, test.setTimeout(120_000).
  • beforeEach: TestControl.cleanDb(), Auth.logIntoApp(TEST_EMAIL, …, PROVIDER_REPRESENTATIVE) („Petr Zástupce“), assignRoles ADMIN, ACCOUNTING, MANAGER, Orders.setupUserSignature, page.reload() (role v menu). afterEach: TestControl.cleanSharePoint().
  • setupReceivedOrder(Orders, Contract, label) přes invoke-action: createAccountingEntity (IČO 10_000_000 + seq), createContract (branch: 2025${900 + seq}, contractPrice: 500000, start před měsícem, konec za rok), createReceivedOrder (totalPrice: 500000, CZK, výchozí KZ a DZ 0,05 a 5 let); u všech expect(isSuccess).toBe(true), kód přes getReceivedOrder.
  • Navigace navigateToProtocols (test id nav-item-finance-module → nav-item-protocols-group → nav-item-protocols), návrat goToProtocolsList = page.goto("/protocols").
  • Tok: clickAddProtocol (dialog s textem „Vyberte objednávku“), selectReceivedOrder (input[name="receivedOrder"], option podle regexu kódu, „Vybrat“, dialog „Vyberte typ protokolu“), chooseVariant (new-protocol-${variant}), fillProtocolFormFully, saveCreateForm (waitForURL(/\/protocols\/\d+\//)).
  • assertProtocolFormPersisted: hodnoty z FORM_SPECS; data přes aria-label Day, Month a Year (ISSUED_DATE dnes, issuedDateWithIssues zítra), texty a autocomplete toHaveValue, cena /1[\s ]?000/, rich texty rich-text-${field} toContainText, kontakty contacts.0.* a providerContacts.0.*, seznam list.0.description; nakonec „Zrušit“ a dialog skrytý. Texty staveniště: Staveniště ${key} E2E pro 10 klíčů CONSTRUCTION_SITE_FIELD_KEYS.
  • Zastupující předávajícího je FormAutocomplete nad getResponsibleEmployees (uživatelé s rolí MANAGER), proto jméno a role testovacího uživatele.
  • Řádek: assertProtocolRowCount(1) (řádky s buňkou data-field="code"), assertProtocolInGrid bez code bere první řádek: buňka code toHaveText(/^PREFIX\d{8}$/), protocol-type-chip-${variant}, protocol-state-chip-IN_PROCESS, buňka data-field="order" toContainText(orderCode).
  • Prefixy z ProtocolService.PROTOCOL_CODE_PREFIX; kód tvoří prefix, rok a čtyřmístné pořadí (constructCodes).