Dlaczego potrzebna jest druga, niezależna kontrola
Skrypt migracyjny ma własne bramki spójności i nie zapisuje danych, jeśli którakolwiek jest różna od zera. Każda bramka ma test czerwony: wstrzyknięty stary błąd zapala bramkę. To dowodzi, że bramka działa, ale nie dowodzi, że skrypt nie ma ślepego punktu.
Dlatego obok skryptu działa druga kontrola, napisana osobno. Ona nie korzysta z funkcji skryptu, tylko czyta wynik przez interfejs edytora i ocenia go od zewnątrz. Zgodność dwóch niezależnych mechanizmów jest mocniejszym dowodem niż zielony wynik jednego.
Co sprawdza kontrola przez API
Druga kontrola czyta wynik przez API edytora i sprawdza zjawiska geometryczne oraz logiczne. Nakładanie linii powyżej 0,1 m² oznacza, że dwie linie leżą na sobie. Linie w murze oznaczają kształt wychodzący poza wnętrze budynku. Pinezki w linii oznaczają miejsce przypisane do złego obszaru.
Wnętrze budynku jest pomniejszone o 1 m od muru, a kształt linii przycinany do wnętrza i sprawdzany wierzchołek po wierzchołku. Liczba linii wylewających się poza mur musi wynosić 0. Obiekty płaskie, takie jak parking, waga czy plac, dostają własną bryłę, zwykle o wysokości 1 m, żeby nie znikały z mapy.
- Nakładanie linii powyżej 0,1 m²: oczekiwane 0.
- Linie w murze: oczekiwane 0.
- Pinezki w linii: sprawdzone co do przypisania.
- Obiekty płaskie z własną bryłą: obecne.
Progi kontroli jakości geometrii
Porównanie po treści, a nie po identyfikatorach
Identyfikatory rekordów po każdym uruchomieniu migracji mogą być inne, bo struktura jest budowana od nowa. Dlatego kontrola porównuje stan po treści: nazwa, obszar, poziom i geometria. Dwa rekordy o tej samej treści są tym samym rekordem, nawet gdy numer się różni.
Ta zasada pasuje do migracji powtarzalnej. Każde uruchomienie buduje strukturę od nowa, zapis idzie w jednej transakcji z trybem próbnym, a przed zapisem powstaje kopia struktury do pliku SQL. Audytor może więc powtórzyć kontrolę na kopii i otrzymać ten sam wynik.
Przeliczenie współrzędnych jako punkt kontrolny
Przeliczenie metrów lokalnych na współrzędne geograficzne ma jedno źródło prawdy. Skrypt migracyjny musi być portem 1:1 tej funkcji i przejść weryfikację na punktach kontrolnych. W opisanym przypadku zmierzony błąd maksymalny wyniósł 0,01 m na 64 punktach.
Audytor ustala próg akceptacji przed kontrolą, a nie po niej. Wynik 0,01 m jest zapisywany w protokole razem z liczbą punktów, żeby kolejna migracja miała punkt odniesienia.
Protokół odchyleń
Protokół zawiera listę kontroli, oczekiwaną i zmierzoną wartość oraz decyzję: akceptacja, poprawka lub zatrzymanie migracji. Odchylenie opisuje się konkretnie: co, gdzie, ile i jaka jest proponowana poprawka. Odchylenia z poprawką wracają do kolejnego uruchomienia skryptu, a nie są poprawiane ręcznie w systemie.
Taki protokół wspiera spełnienie wymogów audytu, bo dostarcza dowodu, że stan danych po migracji został zmierzony niezależnie od autora skryptu.
Materiał wideo
Często zadawane pytania
Dlaczego porównanie po identyfikatorach nie wystarcza?
Bo migracja buduje strukturę od nowa, więc numery się zmieniają. Porównanie po nazwie, obszarze, poziomie i geometrii pokazuje, czy treść jest ta sama.
Co robi system, gdy bramka spójności jest różna od zera?
Skrypt nie zapisuje danych. Zapis idzie w jednej transakcji z trybem próbnym i poprzedza go kopia struktury.
Kto powinien wykonać kontrolę niezależną?
Osoba inna niż autor skryptu migracyjnego, na przykład audytor wewnętrzny lub druga strona zespołu wdrożeniowego.
Potrzebujesz protokołu kontroli migracji?
Przekażemy wzór protokołu odchyleń i opiszemy, jak zorganizować niezależną kontrolę po zapisie.
Porozmawiajmy