073 · Údržba z dokladu – přesně 500 km před další výměnou oleje vznikne problém¶
Co test ověřuje¶
Že u vozidla vznikne otevřený problém, když do další výměny oleje zbývá přesně 500 km, tedy právě na hranici upozornění. Údržba je zapsaná z dokladu při 10 km s další údržbou za 10 000 km a tachometr pak ukazuje 9 510 km.
Výchozí stav (test si ho připraví sám)¶
- Prázdná databáze, přihlášený je testovací uživatel s rolí administrátor (roli mu test přidělí přes API).
- Značky „Brand 1“ a „Brand 2“ s modely „Model 1“ a „Model 2“, vytvořené přes API.
- Dvě vozidla modelu „Model 1“ s náhodnou SPZ, vytvořená přes API. První vozidlo má ID REX zařízení 10.
- REX v testu nahrazuje simulace. Podle ID REX zařízení vrací připravený stav tachometru, pro zařízení 10 je to 10 km. První vozidlo má tedy najeto 10 km.
- Zakázka „Test Contract“ a k ní dva doklady na 10 000 Kč s náhodně vygenerovanými názvy dodavatelů, vše vytvořené přes API. Oba doklady jsou přes API plně schválené.
- V Nastavení › Obecné test formulářem upraví modul Vozidla: Popis „Test description“ a Zakázka pro vozidla „Test Contract“.
- Na stránce Doklady vozidel (ze stránky Vozidla tlačítkem „Přejít na doklady“) test prvnímu dokladu formulářem „Přiřadit vozidla“ přiřadí nejdřív první a potom druhé vozidlo.
Postup¶
- Test na stránce Doklady vozidel u prvního dokladu klikne na ikonu „Vytvořit údržbu“ a v okně vyplní: Vozidlo první vozidlo, Typ údržby „Výměna oleje a filtrů“, Datum dnešní, Cena 3333, Další údržba (km) 10000, Další údržba (datum) náhodné datum do roka a Najeto (km) 10. Uloží.
- Test otevře stránku Vozidla, detail prvního vozidla a záložku Problémy.
- Ověří: seznam problémů je prázdný („Žádné záznamy“).
- Test otevře záložku Údržba.
- Ověří: v seznamu je záznam s cenou „3 333,00 Kč“, typem „Výměna oleje a filtrů“ a dnešním datem.
- Ověří: Najeto (km) na detailu vozidla je „10“.
- Test přes API nastaví prvnímu vozidlu ID REX zařízení 9510, pro které simulace REX vrací stav tachometru 9 510 km, a obnoví stránku.
- Ověří: Najeto (km) na detailu vozidla je „9510“.
- Ověří: u záložky Problémy je počet „(1)“.
- Test otevře záložku Problémy.
- Ověří: v seznamu je problém s popisem „Údržba nutná: Výměna oleje a filtrů - zbývá 500km“.
- Ověří: problém má Typ „Výměna oleje“, dnešní Datum a Stav „Otevřený“.
Co test neověřuje¶
- Problém při 499 km (scénář 072) ani to, že při 501 km nevznikne (scénář 074).
- Počet řádků v seznamu problémů. Jediný problém ověřuje jen počet „(1)“ u záložky.
- Barvu počtu u záložky a sloupec Přidal.
- Upozornění podle data. Další údržba (datum) je náhodné.
- Vznik problému úlohou na pozadí. Problém vzniká při načtení detailu vozidla, které test vyvolá obnovením stránky.
- Údržbu zapsanou přímo na detailu vozidla (scénář 086).
- Že je k údržbě přiřazený doklad.
- Názvy sloupců a popisky polí formuláře. Test hledá buňky a pole podle interních názvů.
- Jiné role než administrátor.
- Skutečné napojení na REX. Stav tachometru test mění přes ID REX zařízení a simulaci.
Pro vývojáře¶
- Test:
vehicle.spec.ts› „Vehicle maintenance › Vehicle maintenance based on kilometers › should show problem when exactly at maintenance limit“ - Stejně se jmenuje i test v describu „Vehicle maintenance from vehicle detail page › Vehicle maintenance based on kilometers“ (scénář 086), proto oba describy.
- Příprava:
beforeEachdescribů „Vehicle“ (cleanDb,logIntoAppsTEST_EMAIL,assignRolesADMIN, značky a modely přesinvoke-action), „Vehicle receipts“ (createVehicle,createContract,createReceipts ověřenímisSuccess,approveReceiptsesuperApproval: true; modul VEHICLE:descriptionaconfigs.0.value) a „Vehicle maintenance“ (ověří dodavatele a prázdnou buňkuvehicles, přeslink-vehiclespřiřadí obě vozidla,assertVehiclesContainsobě SPZ). - Údržba:
Vehicle.createMaintenanceFromReceipt(test idcreate-maintenancev řádku podle dodavatele prvního dokladu).fillDateAndWaitForMileageAutofillčeká na automatické doplnění najetých km (tlačítko „Uložit“ musí být aktivní),mileageKmse vyplňuje až nakonec. Seznam údržby:assertMaintenanceInGrid(řádek podleprice, buňkytype,date,price). - Najeto:
Vehicle.updateVehicleMileagevoláupdateVehiclesrexDeviceId: 9510(ověříisSuccessa URL detailu vozidla), pak reload aassertDetailMileage. Simulace REX:external-api-mock-responses/rex/config.json(ItinHistorypodleid, souborItinHistory_mileage9510.xml). - Problém:
assertProblemsCount(1)hledá „(1)“ v záložce „Problémy“;calculateProblemDetailsspočítá zbývající km jako 10000 − (9510 − 10) = 500, typ „Výměna oleje“, datumformatTodayDate(), stav „Otevřený“;assertProblemnajde řádek podledata-field="description"a ověří buňky type, description, date, status (toHaveText). - Aplikace:
IssueService(MAINTENANCE_THRESHOLD_KM = 500, problém kdyžmileageKm + nextMaintenanceInKm − najeto ≤ 500, tedy i přesně 500); problémy se generují při každém načtení detailu (VehicleService.get→createIssuesForVehicle). nextMaintenanceDateje náhodné (faker.date.future, do roka). Padne-li do 7 dnů, vznikne hned problém podle data a test spadne na první kontrole „Žádné záznamy“.