InnerWeb
Zum Inhalt springen

FAQ: Funktion auf Bestellung und Änderungskontrolle

Ein Werk, das eine eigene Funktion im Sicherheitssystem bestellt, sollte wissen, wie der Anbieter eine Änderung prüft, bevor sie in den Produktivbetrieb geht. Die folgenden Antworten behandeln Änderungskontrolle, Befundklassen, das Limit für Korrekturrunden und die Tests, die belegen, dass die neue Funktion die bestehenden nicht beeinträchtigt.

89
Punkte Bestehensschwelle für Warnungen
2
Korrekturrunden vor dem Entscheidungsmodus
242
E2E-Tests im Paket

Was der Auftraggeber vor der ersten Zeile Code verlangen kann

Der Auftraggeber sollte mit der Beschreibung der Wirkung beginnen, nicht mit der technischen Lösung: Wer soll was tun, in welcher Situation, und was soll das System dann erfassen. Eine solche Beschreibung erlaubt dem Anbieter, die Änderung zu planen und von bestehenden Funktionen zu trennen. InnerWeb ist Hersteller der Software, daher entstehen Funktionen auf Bestellung im selben Repository und auf demselben Kontrollweg wie allgemeine Funktionen.

Im Vertrag sollten drei Dinge festgehalten werden: der Umfang der Änderung, die Abnahmekriterien und die Art des Nachweises, dass die Änderung die Kontrolle durchlaufen hat. Der Nachweis ist begründet, denn bei Funktionen des Arbeitsschutzes genügt bei einer Prüfung die bloße Zusicherung, dass alles funktioniert, nicht.

Umgeht eine bestellte Funktion die Standardkontrolle?

Nein. Jede Änderung im Repository durchläuft statische Analyse, Stilprüfung und Unit-Tests, und das Zusammenführen ist bis zum grünen Ergebnis gesperrt. Eine Funktion auf Bestellung hat keinen verkürzten Weg.

Wie beschreibt man die Abnahmekriterien?

Ein Abnahmekriterium sollte sich durch einen Test prüfen lassen: Benutzerszenario, Eingabedaten und erwartetes Ergebnis. Dieses Szenario kann danach als Regressionstest in das Paket der Browsertests aufgenommen werden, sodass die Funktion auch nach weiteren Updates geschützt bleibt.

Wie die Änderungskontrolle abläuft

Neben den automatischen Tests beschreibt die Dokumentation einen zweiten, unabhängigen Kontroll-Agenten. Er liest jede Änderung in der offenen Zusammenführungsanfrage und bewertet, ob der Code der Beschreibung der Änderung und den fachlichen Regeln entspricht. So bewertet der Autor nicht sich selbst.

Die Kontrolle misst das Ergebnis nach der Zusammenführung mit dem Hauptzweig und nicht nur den Arbeitszweig. Ein Konflikt wird als eigener, blockierender Fehler gemeldet, sodass eine Änderung, die nur isoliert funktioniert, nicht weiterkommt.

Welche Befundklassen verwendet die Kontrolle?

Befunde haben drei Klassen: blockierende Befunde, gewichtete Warnungen und Empfehlungen. Ein einziger blockierender Befund genügt für das Nichtbestehen. Warnungen werden gewichtet, und die Bestehensschwelle liegt bei 89 Punkten. Empfehlungen blockieren niemals.

Wie kann der Autor auf einen Befund antworten?

Nur auf eine von drei festgelegten Arten: behoben, bestritten oder bewusst belassen. Ein bewusst belassenes Risiko wird dem Produktverantwortlichen gemeldet, sodass die Entscheidung über das Risiko sichtbar und einer Person zugeordnet ist.

Wie viele Korrekturrunden sind erlaubt?

Das Limit beträgt zwei Runden. Nach dem zweiten Nichtbestehen wechselt der Autor in den Entscheidungsmodus und berichtet offene Fragen, statt ohne Ende zu iterieren. Der Auftraggeber erhält dann eine klare Liste der Entscheidungen und keine weitere Version ohne Erklärung.

Parameter der Änderungskontrolle

Parameter der ÄnderungskontrolleBalkendiagramm: drei Befundklassen, drei Antwortarten des Autors und zwei Kontrollrunden.0123WertBefundklassenBefundklassen: 3 Wert3Antwortarten des AutorsAntwortarten des Autors: 3 Wert3KontrollrundenKontrollrunden: 2 Wert2
Quelle: und

Tests, die die Sicherheit der Änderung belegen

Das Paket der browserbasierten E2E-Tests umfasst 242 Tests in 31 Dateien und startet einen echten Chromium-Browser auf einem echten Backend. Die Testdatenbank wird pro Testlauf einmal aus den Migrationen neu aufgebaut, sodass das Ergebnis nicht von Daten des vorherigen Laufs abhängt.

Ein Test schlägt automatisch fehl, sobald im Browser eine unbehandelte JavaScript-Ausnahme oder eine Serverantwort 5xx auftritt. Für eine bestellte Funktion ist das wichtig: Ein Fehler auf einem neuen Bildschirm kommt ans Licht, auch wenn das Testszenario ihn nicht prüft.

Ein bekannter, noch nicht behobener Fehler wird im Test als erwartetes Fehlschlagen mit Meldungsnummer markiert, niemals durch Überspringen des Tests. Nach der Behebung meldet der Test selbst, dass die Markierung entfernt werden muss. Nichts verschwindet stillschweigend.

Hinweis zum Stand des Kontrollmechanismus

Aus Gründen der Transparenz weisen wir darauf hin, dass die Dokumentation die Änderungskontrolle durch den unabhängigen Agenten als entworfen und gebaut beschreibt, im Stand von August 2026 aber noch nicht produktiv eingeführt ist. Die statische Analyse, die Stilprüfung und die Unit-Tests, die das Zusammenführen blockieren, sind dagegen die Grundlage der Kontrolle jeder Änderung. Der Auftraggeber sollte den Anbieter nach dem aktuellen Stand beider Schichten fragen, bevor er sie als Anforderung in den Vertrag aufnimmt.

Videomaterial

Häufig gestellte Fragen

Kann ich verlangen, dass eine Änderung die Browsertests besteht?

Ja, das lohnt sich im Vertrag festzuhalten. Das E2E-Paket startet einen echten Browser auf einem echten Backend und bildet Benutzerpfade nach, sodass es Fehler findet, die Unit-Tests nicht sehen.

Was passiert mit einem bekannten, aber nicht behobenen Fehler?

Der Test markiert ihn als erwartetes Fehlschlagen mit Meldungsnummer, ohne den Test zu überspringen. Nach der Behebung meldet der Test selbst, dass die Markierung entfernt werden muss.

Wer sieht, dass der Anbieter ein Risiko bewusst belassen hat?

Das bewusst belassene Risiko wird dem Produktverantwortlichen gemeldet. Die Entscheidung ist also offen und einer Person zugeordnet, nicht in der Änderungshistorie versteckt.

Prüft die Kontrolle die Änderung zusammen mit dem Rest des Systems?

Ja. Die Kontrolle misst das Ergebnis nach der Zusammenführung mit dem Hauptzweig, und ein Konflikt ist ein eigener, blockierender Fehler.

Bestellen Sie Ihre eigene Funktion

Beschreiben Sie die Situation, in der das System etwas erfassen soll, und wir zeigen Ihnen den Weg der Änderung von der Bestellung bis zu den Tests. Vereinbaren Sie ein Gespräch mit InnerWeb.

Sprechen wir