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¶
- Test otevře stránku Protokoly z bočního menu a klikne na „Přidat protokol“.
- Ověří: otevře se okno „Vyberte objednávku“.
- V poli Objednávka vybere z nabídky objednávku podle jejího kódu a klikne na „Vybrat“.
- Ověří: otevře se okno „Vyberte typ protokolu“.
- U testovaného typu klikne na „Nový“.
- Ověří: otevře se formulář protokolu.
- Vyplní všechna pole formuláře podle typu:
- 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“.
- 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“.
- 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“.
- 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“.
- 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“.
- Žádost o KZ: Datum dnešní a Poznámky „Poznámka KZ E2E“.
- Žádost o DZ: Datum dnešní a Poznámky „Poznámka DZ E2E“.
- 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“.
- Klikne na „Uložit“.
- Ověří: otevře se detail nového protokolu.
- V detailu klikne na „Upravit“.
- Ověří: otevře se okno úprav protokolu.
- 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.
- Klikne na „Zrušit“.
- Ověří: okno úprav se zavře.
- Znovu otevře stránku Protokoly.
- Ověří: v seznamu je právě jeden protokol.
- 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“.
- Ověří: štítek typu odpovídá testovanému typu a stav je V procesu.
- 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“),assignRolesADMIN, ACCOUNTING, MANAGER,Orders.setupUserSignature,page.reload()(role v menu).afterEach:TestControl.cleanSharePoint().setupReceivedOrder(Orders, Contract, label)přesinvoke-action:createAccountingEntity(IČO10_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šechexpect(isSuccess).toBe(true), kód přesgetReceivedOrder.- Navigace
navigateToProtocols(test idnav-item-finance-module→nav-item-protocols-group→nav-item-protocols), návratgoToProtocolsList=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 zFORM_SPECS; data přesaria-labelDay, Month a Year (ISSUED_DATEdnes,issuedDateWithIssueszítra), texty a autocompletetoHaveValue, cena/1[\s ]?000/, rich textyrich-text-${field}toContainText, kontaktycontacts.0.*aproviderContacts.0.*, seznamlist.0.description; nakonec „Zrušit“ a dialog skrytý. Texty staveniště:Staveniště ${key} E2Epro 10 klíčůCONSTRUCTION_SITE_FIELD_KEYS.- Zastupující předávajícího je
FormAutocompletenadgetResponsibleEmployees(uživatelé s rolí MANAGER), proto jméno a role testovacího uživatele. - Řádek:
assertProtocolRowCount(1)(řádky s buňkoudata-field="code"),assertProtocolInGridbezcodebere první řádek: buňkacodetoHaveText(/^PREFIX\d{8}$/),protocol-type-chip-${variant},protocol-state-chip-IN_PROCESS, buňkadata-field="order"toContainText(orderCode). - Prefixy z
ProtocolService.PROTOCOL_CODE_PREFIX; kód tvoří prefix, rok a čtyřmístné pořadí (constructCodes).