InnerWeb
Przejdź do treści

FAQ: rozwój funkcji na zamówienie i kontrola zmian

Zakład, który zamawia własną funkcję w systemie bezpieczeństwa, powinien wiedzieć, jak dostawca sprawdza zmianę, zanim trafi ona na produkcję. Poniżej odpowiadamy na pytania o kontrolę zmian, klasy uwag, limit rund poprawek i testy, które potwierdzają, że nowa funkcja nie psuje istniejących.

89
punktów progu zaliczenia ostrzeżeń
2
rundy kontroli przed trybem decyzji
242
testów E2E w pakiecie

Co zamawiający może wymagać przed pierwszą linią kodu

Zamawiający powinien zacząć od opisu skutku, nie rozwiązania technicznego: kto ma coś zrobić, w jakiej sytuacji i co system ma wtedy zarejestrować. Taki opis pozwala dostawcy zaplanować zmianę i oddzielić ją od istniejących funkcji. InnerWeb jest producentem oprogramowania, więc funkcje na zamówienie powstają w tym samym repozytorium i tej samej ścieżce kontroli co funkcje ogólne.

W umowie warto zapisać trzy rzeczy: zakres zmiany, kryteria odbioru i sposób dowodu, że zmiana przeszła kontrolę. Wymaganie dowodu jest uzasadnione, bo dla funkcji bezpieczeństwa pracy zwykłe zapewnienie, że wszystko działa, nie wystarcza przy audycie.

Czy zamówiona funkcja omija standardową kontrolę?

Nie. Każda zmiana w repozytorium przechodzi analizę statyczną, kontrolę stylu i testy jednostkowe, a scalenie jest zablokowane do zielonego wyniku. Funkcja na zamówienie nie ma ścieżki skróconej.

Jak opisać kryteria odbioru?

Kryterium odbioru powinno dać się sprawdzić testem: scenariusz użytkownika, dane wejściowe i oczekiwany wynik. Taki scenariusz można potem dopisać do pakietu testów przeglądarkowych jako test regresji, więc funkcja pozostaje chroniona także po kolejnych aktualizacjach.

Jak wygląda kontrola zmian

Poza testami automatycznymi dokumentacja opisuje drugi, niezależny agent kontroli, który czyta każdą zmianę na otwartej propozycji scalenia i ocenia, czy kod zgadza się z opisem zmiany i regułami domenowymi. Dzięki temu autor nie ocenia samego siebie.

Kontrola mierzy wynik po scaleniu z gałęzią główną, a nie samą gałąź roboczą. Konflikt jest zgłaszany jako osobny, blokujący błąd, więc zmiana, która działa tylko w izolacji, nie przejdzie dalej.

Jakie klasy uwag stosuje kontrola?

Uwagi mają trzy klasy: blokujące, ostrzeżenia ważone i sugestie. Jedna uwaga blokująca wystarcza do niezaliczenia. Ostrzeżenia są ważone, a próg zaliczenia wynosi 89 punktów. Sugestie nigdy nie blokują.

Jak autor może odpowiedzieć na uwagę?

Tylko jednym z trzech ustalonych sposobów: poprawiono, kwestionuję albo świadomie zostawiam. Świadome pozostawienie ryzyka jest zgłaszane właścicielowi produktu, więc decyzja o ryzyku jest widoczna i przypisana do osoby.

Ile rund poprawek jest dozwolone?

Limit wynosi dwie rundy. Po drugim niezaliczeniu autor przechodzi w tryb decyzji i raportuje otwarte pytania zamiast iterować bez końca. Zamawiający dostaje wtedy jasną listę rozstrzygnięć, a nie kolejną wersję bez wyjaśnienia.

Parametry kontroli zmian

Parametry kontroli zmianWykres poziomy: trzy klasy uwag, trzy sposoby odpowiedzi autora i dwie rundy kontroli.0123wartośćKlasy uwagKlasy uwag: 3 wartość3Sposoby odpowiedzi autoraSposoby odpowiedzi autora: 3 wartość3Rundy kontroliRundy kontroli: 2 wartość2
Źródło: i

Testy, które potwierdzają bezpieczeństwo zmiany

Pakiet testów przeglądarkowych E2E obejmuje 242 testy w 31 plikach i uruchamia prawdziwą przeglądarkę Chromium na prawdziwym backendzie. Baza testowa jest odtwarzana z migracji raz na przebieg testów, dzięki czemu wynik nie zależy od danych z poprzedniego uruchomienia.

Test kończy się błędem automatycznie, gdy w przeglądarce pojawi się nieprzechwycony wyjątek JavaScript albo odpowiedź serwera 5xx. To ważne dla funkcji na zamówienie: błąd w nowym ekranie wychodzi na jaw, nawet jeśli scenariusz testu go nie sprawdzał.

Znany, jeszcze nienaprawiony błąd jest oznaczany w teście jako oczekiwane niepowodzenie z numerem zgłoszenia, nigdy pominięciem testu. Po naprawie test sam zgłasza, że adnotację trzeba usunąć. Nic nie znika po cichu.

Uwaga o stanie wdrożenia mechanizmu kontroli

W interesie przejrzystości zaznaczamy, że dokumentacja opisuje mechanizm kontroli zmian przez niezależnego agenta jako zaprojektowany i zbudowany, ale w stanie z sierpnia 2026 jeszcze niewdrożony produkcyjnie. Analiza statyczna, kontrola stylu i testy jednostkowe, które blokują scalenie, są natomiast podstawą kontroli każdej zmiany. Zamawiający powinien zapytać dostawcę o aktualny stan obu warstw, zanim wpisze je do umowy jako wymaganie.

Materiał wideo

Często zadawane pytania

Czy mogę wymagać, aby zmiana przeszła testy przeglądarkowe?

Tak, warto wpisać to do umowy. Pakiet E2E uruchamia prawdziwą przeglądarkę na prawdziwym backendzie i odtwarza ścieżki użytkownika, więc wykrywa błędy niewidoczne w testach jednostkowych.

Co się dzieje z błędem znanym, ale nienaprawionym?

Test oznacza go jako oczekiwane niepowodzenie z numerem zgłoszenia, bez pominięcia testu. Po naprawie test sam zgłasza, że adnotację trzeba usunąć.

Kto widzi, że dostawca świadomie zostawił ryzyko?

Świadome pozostawienie ryzyka jest zgłaszane właścicielowi produktu. Decyzja jest więc jawna i przypisana do osoby, a nie ukryta w historii zmian.

Czy kontrola sprawdza zmianę razem z resztą systemu?

Tak. Kontrola mierzy wynik po scaleniu z gałęzią główną, a konflikt jest osobnym, blokującym błędem.

Zamów własną funkcję

Opisz sytuację, w której system ma coś zarejestrować, a my pokażemy ścieżkę zmiany od zamówienia do testów. Umów rozmowę z InnerWeb.

Porozmawiajmy