InnerWeb
Přejít na obsah

Kontrola kvality dat po migraci: průvodce

Interní auditor nehodnotí migraci podle zprávy skriptu, že zápis proběhl. Hodnotí ji nezávislou kontrolou, která čte výsledek přes rozhraní systému a porovnává ho s očekávaným stavem. Níže je popis této kontroly krok za krokem a protokol odchylek, který se hodí k auditu.

0,01 m
maximální chyba přepočtu na 64 kontrolních bodech
Zdroj: karta funkce struktury lokalit
0,1 m²
práh překryvu čar v kontrole
Zdroj: karta funkce struktury lokalit

Proč je potřeba druhá, nezávislá kontrola

Migrační skript má vlastní kontrolní brány konzistence a nezapíše data, pokud je kterákoli různá od nuly. Každá brána má červený test: vložená stará chyba bránu rozsvítí. To dokazuje, že brána funguje, ale nedokazuje, že skript nemá slepé místo.

Proto vedle skriptu běží druhá kontrola, napsaná samostatně. Nevyužívá funkce skriptu, jen čte výsledek přes rozhraní editoru a hodnotí ho zvenku. Shoda dvou nezávislých mechanismů je silnější důkaz než zelený výsledek jednoho.

Co kontrola přes API ověřuje

Druhá kontrola čte výsledek přes API editoru a ověřuje geometrické a logické jevy. Překryv čar nad 0,1 m² znamená, že dvě čáry leží jedna na druhé. Čáry ve zdi znamenají tvar vybíhající mimo vnitřek budovy. Špendlíky na čáře znamenají místo přiřazené k nesprávné oblasti.

Vnitřek budovy je zmenšen o 1 m od zdi a tvar čáry se ořezává na vnitřek a kontroluje vrchol po vrcholu. Počet čar vybíhajících za zeď musí být 0. Ploché objekty, jako parkoviště, váha nebo plocha, dostávají vlastní těleso, obvykle výšky 1 m, aby nezmizely z mapy.

  • Překryv čar nad 0,1 m²: očekávaná hodnota 0.
  • Čáry ve zdi: očekávaná hodnota 0.
  • Špendlíky na čáře: ověřeno přiřazení.
  • Ploché objekty s vlastním tělesem: přítomny.

Prahy kontroly kvality geometrie

Prahy kontroly kvality geometrieVodorovný sloupcový graf: odstup od zdi 1 m, překryv čar 0,1 m², chyba přepočtu 0,01 m.01m nebo m²Odstup od zdi (m)Odstup od zdi (m): 1 m nebo m²1Překryv čar (m²)Překryv čar (m²): 0,1 m nebo m²0,1Chyba přepočtu (m)Chyba přepočtu (m): 0,01 m nebo m²0,01
Zdroj: Karta funkce struktury lokalit

Porovnání podle obsahu, ne podle identifikátorů

Identifikátory záznamů se mohou po každém spuštění migrace lišit, protože struktura se vytváří znovu. Kontrola proto porovnává stav podle obsahu: název, oblast, úroveň a geometrii. Dva záznamy se stejným obsahem jsou týmž záznamem, i když se číslo liší.

Tato zásada odpovídá opakovatelné migraci. Každé spuštění staví strukturu znovu, zápis probíhá v jedné transakci se zkušebním režimem a před zápisem vznikne záloha struktury do souboru SQL. Auditor může kontrolu zopakovat na záloze a dostat stejný výsledek.

Přepočet souřadnic jako kontrolní bod

Přepočet lokálních metrů na zeměpisné souřadnice má jeden zdroj pravdy. Migrační skript musí být portem 1:1 této funkce a projít ověřením na kontrolních bodech. V popsaném případě byla naměřena maximální chyba 0,01 m na 64 bodech.

Auditor stanoví práh přijetí před kontrolou, ne po ní. Výsledek 0,01 m se zapíše do protokolu spolu s počtem bodů, aby měla další migrace vztažný bod.

Protokol odchylek

Protokol obsahuje seznam kontrol, očekávanou a naměřenou hodnotu a rozhodnutí: přijetí, oprava, nebo zastavení migrace. Odchylka se popisuje konkrétně: co, kde, kolik a jaká je navrhovaná oprava. Odchylky s opravou se vracejí do dalšího spuštění skriptu, neopravují se ručně v systému.

Takový protokol podporuje splnění požadavků auditu, protože poskytuje důkaz, že stav dat po migraci byl změřen nezávisle na autorovi skriptu.

Videomateriál

Často kladené otázky

Proč nestačí porovnání podle identifikátorů?

Protože migrace staví strukturu znovu, takže se čísla mění. Porovnání podle názvu, oblasti, úrovně a geometrie ukazuje, zda je obsah stejný.

Co systém udělá, když brána konzistence není nulová?

Skript data nezapíše. Zápis probíhá v jedné transakci se zkušebním režimem a předchází mu záloha struktury.

Kdo má provést nezávislou kontrolu?

Osoba jiná než autor migračního skriptu, například interní auditor nebo druhá strana implementačního týmu.

Potřebujete protokol kontroly migrace?

Předáme vzor protokolu odchylek a popíšeme, jak zorganizovat nezávislou kontrolu po zápisu.

Pojďme si promluvit