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
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