Dlaczego trzy zabezpieczenia, a nie jedno
Kopia chroni przed utratą danych, tryb próbny pokazuje skutki bez zapisu, a bramki wychwytują błędy logiczne, których żadna kopia nie naprawi. Każde z nich zamyka inną klasę awarii, dlatego zespół wdrożeniowy łączy je w jedną procedurę.
Migracja struktury jest powtarzalna: każde uruchomienie buduje strukturę od nowa. Dzięki temu próbę można powtarzać do skutku, a zapis docelowy jest tylko jednym z uruchomień.
Praktyka 1: kopia struktury do pliku SQL przed zapisem
Przed każdym zapisem robimy kopię struktury do pliku SQL. Plik ma nazwę z datą i identyfikatorem uruchomienia, a jego obecność i rozmiar sprawdzamy poleceniem listującym katalog, nie zakładamy, że powstał. Kopia pozwala odtworzyć stan sprzed migracji także wtedy, gdy zapis przeszedł, ale wynik okazał się zły dopiero po tygodniu.
Bramki spójności: wynik oczekiwany przed zapisem
- Wartość oczekiwana
- Przykład błędu na próbie
Praktyka 2: zapis w jednej transakcji z trybem próbnym
Zapis idzie w jednej transakcji. Tryb próbny wykonuje wszystkie kroki, liczy bramki i na końcu wycofuje zmiany. Wynik próby to raport: ile rekordów powstałoby, ile zmieniono, ile bramek jest różnych od zera. Dopiero po czystym raporcie uruchamiamy zapis z zatwierdzeniem.
Jedna transakcja oznacza, że przerwanie w połowie nie zostawia struktury w stanie pośrednim. Albo cały zapis przechodzi, albo nie zostaje po nim ślad.
Praktyka 3: bramki spójności z czerwonym testem
Skrypt migracyjny nie zapisuje danych, jeśli którakolwiek bramka spójności jest różna od zera. Przykłady bramek: liczba linii wylewających się poza mur budynku (oczekiwane 0), znaczniki poza polem swojej linii, linie nakładające się na siebie. 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.
Bramka bez testu czerwonego jest hipotezą. Dlatego każda bramka ma test, w którym wstrzykujemy stary błąd i sprawdzamy, że bramka się zapala. Zielony wynik bramki, która nigdy nie świeciła na czerwono, niczego nie dowodzi.
Praktyka 4: druga kontrola przez inną drogę
Po zapisie czytamy wynik niezależną drogą: przez API edytora, a nie przez ten sam skrypt, który zapisywał. Kontrola szuka nakładania się linii powyżej 0,1 m², linii wchodzących w mur i pinezek leżących w linii. Stan porównujemy po treści, czyli nazwie, obszarze, poziomie i geometrii, nie po identyfikatorach, bo te zmieniają się przy każdym uruchomieniu.
Skrypt, który sam siebie ocenia, powtarza własne założenia. Druga kontrola jest tania, a wyłapuje błędy, które pierwsza kontrola uznała za normę.
- nakładanie linii powyżej 0,1 m²,
- linie wchodzące w mur budynku,
- pinezki leżące w obrębie linii,
- porównanie po treści, nie po identyfikatorach.
Kolejność działań w dniu zapisu
Dzień zapisu warto rozpisać na kroki, które odhaczasz po kolei: kopia, tryb próbny, przegląd raportu, zapis, druga kontrola, decyzja o pozostawieniu lub wycofaniu. Każdy krok ma właściciela i dowód, np. nazwę pliku kopii, liczbę bramek równych zeru, wynik kontroli niezależnej.
InnerWeb działa jako niezależny system uzupełniający systemy klienta, więc zapis struktury nie wymaga przerwy w pracy KD, RCP ani ERP.
Lista kontrolna
Materiał wideo
Często zadawane pytania
Czy kopia wystarczy, skoro mam tryb próbny?
Nie. Tryb próbny nie chroni przed błędem wykrytym dopiero po zatwierdzeniu, a kopia pozwala odtworzyć stan sprzed migracji.
Po co test czerwony bramki?
Bramka, która nigdy nie świeciła na czerwono, nie dowodzi, że wykryje błąd. Wstrzyknięty stary błąd potwierdza, że bramka działa.
Dlaczego porównywać po treści, a nie po identyfikatorach?
Identyfikatory zmieniają się przy każdym uruchomieniu, bo struktura jest budowana od nowa. Nazwa, obszar, poziom i geometria są stałe.
Zaplanujmy próbną migrację
Przejdziemy z Twoim zespołem przez kopię, tryb próbny i bramki na danych próbnych. Umów rozmowę lub demo.
Porozmawiajmy