InnerWeb
Przejdź do treści

Kontrola jakości danych po migracji: poradnik

Audytor wewnętrzny nie ocenia migracji po komunikacie skryptu, że zapis się udał. Ocenia ją niezależną kontrolą, która czyta wynik przez interfejs systemu i porównuje go z oczekiwanym stanem. Poniżej opis tej kontroli krok po kroku oraz protokół odchyleń, który nadaje się do audytu.

0,01 m
maksymalny błąd przeliczenia na 64 punktach kontrolnych
Źródło: karta funkcji struktury lokalizacji
0,1 m²
próg nakładania linii w kontroli
Źródło: karta funkcji struktury lokalizacji

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

Progi kontroli jakości geometriiWykres słupkowy poziomy: margines 1 m, nakładanie linii 0,1 m², błąd przeliczenia 0,01 m.01m lub m²Margines od muru (m)Margines od muru (m): 1 m lub m²1Nakładanie linii (m²)Nakładanie linii (m²): 0,1 m lub m²0,1Błąd przeliczenia (m)Błąd przeliczenia (m): 0,01 m lub m²0,01
Źródło: Karta funkcji struktury lokalizacji

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