InnerWeb
Przejdź do treści

Kopia i próba przed zapisem migracji: dobre praktyki

Zapis struktury zakładu na środowisku docelowym powinien dać się cofnąć i sprawdzić przed zatwierdzeniem. Najpewniej zapewniają to trzy elementy razem: kopia do pliku SQL, tryb próbny z wycofaniem zmian oraz bramki spójności z czerwonymi testami.

1 m
pomniejszenie wnętrza budynku od muru przy kontroli linii
Źródło: dokumentacja migracji
0,1 m²
próg nakładania linii w kontroli niezależnej
Źródło: dokumentacja migracji

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

Bramki spójności: wynik oczekiwany przed zapisemWykres poziomy: oczekiwane zero w każdej bramce i przykładowy wynik z błędami na próbie.01020304050sztukLinie poza muremWartość oczekiwana (Linie poza murem): 0 sztuk0Przykład błędu na próbie (Linie poza murem): 3 sztuk3Znaczniki poza liniąWartość oczekiwana (Znaczniki poza linią): 0 sztuk0Przykład błędu na próbie (Znaczniki poza linią): 44 sztuk44Nakładające się linieWartość oczekiwana (Nakładające się linie): 0 sztuk0Przykład błędu na próbie (Nakładające się linie): 2 sztuk2
  • Wartość oczekiwana
  • Przykład błędu na próbie
Źródło: Wartości oczekiwane z zasad bramek; przykład błędu to ilustracja (znaczniki: 44 z dokumentacji migracji, pozostałe założone)

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