InnerWeb
Přejít na obsah

FAQ: vývoj funkcí na objednávku a řízení změn

Provozovna, která si objedná vlastní funkci v bezpečnostním systému, by měla vědět, jak dodavatel změnu kontroluje, než se dostane do provozu. Níže odpovídáme na otázky k řízení změn, třídám nálezů, limitu kol oprav a testům, které potvrzují, že nová funkce nerozbíjí stávající.

89
bodů prahu průchodu upozornění
2
kola kontroly před režimem rozhodnutí
242
testů E2E v sadě

Co může objednatel požadovat dříve, než vznikne první řádek programu

Objednatel by měl začít popisem účinku, ne technickým řešením: kdo má něco udělat, v jaké situaci a co má systém v tu chvíli zaznamenat. Takový popis umožňuje dodavateli naplánovat změnu a oddělit ji od stávajících funkcí. InnerWeb je výrobcem softwaru, takže funkce na objednávku vznikají ve stejném repozitáři a ve stejné cestě kontroly jako obecné funkce.

V smlouvě se vyplatí zapsat tři věci: rozsah změny, kritéria přejímky a způsob důkazu, že změna prošla kontrolou. Požadavek na důkaz je oprávněný, protože u funkcí bezpečnosti práce nestačí při auditu pouhé ujištění, že vše funguje.

Obchází objednaná funkce standardní kontrolu?

Ne. Každá změna v repozitáři prochází statickou analýzou, kontrolou stylu a jednotkovými testy a sloučení je zablokované, dokud výsledek není zelený. Funkce na objednávku nemá zkrácenou cestu.

Jak popsat kritéria přejímky?

Kritérium přejímky má jít ověřit testem: scénář uživatele, vstupní data a očekávaný výsledek. Takový scénář lze potom doplnit do sady prohlížečových testů jako regresní test, takže funkce zůstane chráněná i po dalších aktualizacích.

Jak vypadá kontrola změn

Kromě automatických testů dokumentace popisuje druhého, nezávislého agenta kontroly, který čte každou změnu v otevřeném návrhu sloučení a hodnotí, zda program odpovídá popisu změny a doménovým pravidlům. Autor tak nehodnotí sám sebe.

Kontrola měří výsledek po sloučení s hlavní větví, ne samotnou pracovní větev. Konflikt je hlášen jako samostatná, blokující chyba, takže změna, která funguje jen izolovaně, dál nepostoupí.

Jaké třídy nálezů kontrola používá?

Nálezy mají tři třídy: blokující, vážená upozornění a návrhy. Jeden blokující nález stačí k neprůchodu. Upozornění jsou vážená a práh pro průchod je 89 bodů. Návrhy nikdy neblokují.

Jak může autor na nález reagovat?

Jen jedním ze tří stanovených způsobů: opraveno, zpochybňuji, nebo vědomě ponechávám. Vědomé ponechání rizika se hlásí vlastníkovi produktu, takže rozhodnutí o riziku je viditelné a přiřazené ke konkrétní osobě.

Kolik kol oprav je dovoleno?

Limit jsou dvě kola. Po druhém neprůchodu přechází autor do režimu rozhodnutí a hlásí otevřené otázky, místo aby iteroval donekonečna. Objednatel pak dostane jasný seznam rozhodnutí, a ne další verzi bez vysvětlení.

Parametry kontroly změn

Parametry kontroly změnVodorovný sloupcový graf: tři třídy nálezů, tři způsoby reakce autora a dvě kola kontroly.0123hodnotaTřídy nálezůTřídy nálezů: 3 hodnota3Způsoby reakce autoraZpůsoby reakce autora: 3 hodnota3Kola kontrolyKola kontroly: 2 hodnota2
Zdroj: a

Testy, které potvrzují bezpečnost změny

Sada prohlížečových testů E2E obsahuje 242 testů v 31 souborech a spouští skutečný prohlížeč Chromium na skutečném backendu. Testovací databáze se obnovuje z migrací jednou za běh testů, takže výsledek nezávisí na datech z předchozího spuštění.

Test automaticky skončí chybou, když se v prohlížeči objeví neodchycená výjimka JavaScriptu nebo odpověď serveru 5xx. To je důležité pro funkce na objednávku: chyba na nové obrazovce vyjde najevo, i když ji scénář testu přímo nekontroloval.

Známá, dosud neopravená chyba se v testu označí jako očekávané selhání s číslem hlášení, nikdy přeskočením testu. Po opravě test sám oznámí, že anotaci je třeba odstranit. Nic nezmizí potichu.

Poznámka ke stavu zavedení mechanismu kontroly

Kvůli transparentnosti uvádíme, že dokumentace popisuje mechanismus kontroly změn nezávislým agentem jako navržený a vytvořený, ale ke stavu z srpna 2026 zatím nenasazený do produkce. Statická analýza, kontrola stylu a jednotkové testy, které blokují sloučení, jsou naproti tomu základem kontroly každé změny. Objednatel by se měl dodavatele zeptat na aktuální stav obou vrstev, než je zapíše do smlouvy jako požadavek.

Videomateriál

Často kladené otázky

Mohu požadovat, aby změna prošla prohlížečovými testy?

Ano, vyplatí se to zapsat do smlouvy. Sada E2E spouští skutečný prohlížeč na skutečném backendu a opakuje uživatelské cesty, takže zachytí chyby neviditelné v jednotkových testech.

Co se stane se známou, ale neopravenou chybou?

Test ji označí jako očekávané selhání s číslem hlášení, bez přeskočení testu. Po opravě test sám oznámí, že anotaci je třeba odstranit.

Kdo vidí, že dodavatel vědomě ponechal riziko?

Vědomé ponechání rizika se hlásí vlastníkovi produktu. Rozhodnutí je tedy otevřené a přiřazené k osobě, a neskrývá se v historii změn.

Kontroluje se změna spolu se zbytkem systému?

Ano. Kontrola měří výsledek po sloučení s hlavní větví a konflikt je samostatnou, blokující chybou.

Objednejte si vlastní funkci

Popište situaci, ve které má systém něco zaznamenat, a ukážeme vám cestu změny od objednávky k testům. Domluvte si schůzku s InnerWeb.

Pojďme si promluvit