Lab · Studium przypadku
Dwa landingi i jeden kontrakt wizualny
W skrócie: Rozbudowując 4digital o oferty AI i Engineering, chciałem zachować ich odrębność i wspólny język wizualny serwisu. Kolejne poprawki doprowadziły do kontraktu oraz pomiarów geometrii w przeglądarkach. Końcowy zapis obejmował 1340 przypadków bez zgłoszonych naruszeń, lecz pełny odbiór E2E pozostał częściowy. Przypadek pokazuje, co trzeba sprawdzić między zapisaniem reguły, wykonaniem interfejsu i decyzją o publikacji.
01 / 1340 przypadków i nadal częściowy odbiór
Po ujednoliceniu elementów witryn 4digital końcowy zapis obejmował 1340 przypadków pomiarowych bez zgłoszonych naruszeń. Sprawdzono między innymi geometrię nagłówków, logo, wyrównanie treści i przepełnienie dokumentu.
Pełny odbiór E2E nadal miał status PARTIAL.
Pozostawały wymagania, których te pomiary nie obejmowały: komplet ocenionych obrazów referencyjnych oraz część ręcznych scenariuszy klawiatury, powiększenia i przejść między domenami. Wynik pomiarów pozwalał zamknąć określone zgłoszenia. Nie zamykał automatycznie całego odbioru.
Do tego rozróżnienia doprowadziła praca, która zaczęła się znacznie prościej — od dwóch landingów i elementów, które powinny być równo.
02 / Trzy karty, które trudno było porównać
Rozbudowywałem stronę 4digital o oferty AI i Engineering. Landing AI miał zachować własną propozycję wartości, działać w polskiej i angielskiej wersji serwisu oraz umożliwiać późniejsze wydzielenie do subdomeny. Nie wymagałem osobnego repozytorium ani wdrożenia.
Zależało mi również na tym, żeby przejście między nową ofertą, stroną główną i Labem zachowywało spójność marki.
W sekcji współpracy trzy karty przedstawiały diagnozę, realizację i weryfikację. Każda miała tytuł, opis i część „CO OTRZYMUJESZ”. Środkowy tytuł zajmował więcej linii, opis był dłuższy, a separator i rezultat zaczynały się niżej niż w sąsiednich kartach.
Patrząc w poprzek rzędu, trafiało się na treści pełniące różne funkcje. Porównanie etapów wymagało szukania odpowiedniego fragmentu osobno w każdej kolumnie.
Poprosiłem o wspólną wysokość początków opisów, separatorów i części z rezultatami. Dłuższy tytuł lub opis miał wpływać na układ całego rzędu.
Podobne uwagi pojawiały się przy logo, nagłówkach i odstępach. Zestawienie stron pokazywało, że te same role wizualne otrzymały różne proporcje. Kolejna lokalna poprawka mogła uporządkować jeden fragment, ale nadal potrzebne były zasady dla następnych zmian.
03 / Od uwagi do reguły
Zdecydowałem o opracowaniu wspólnego kontraktu wizualnego. Punktem odniesienia były istniejące 4digital.cloud oraz identyfikacja Labu. Odrębna treść ofert i układ właściwy publikacjom miały pozostać zachowane.
Kontrakt określił relacje, które można było później sprawdzić. Opisy kart w tym samym rzędzie miały zaczynać się na jednej wysokości, także przy różnej liczbie linii tytułów. Wspólną wysokość miały zachowywać separatory i części z rezultatami.
Osobna reguła dotyczyła listy realizacji: początki kolumny opisów w kolejnych wierszach miały leżeć na tej samej osi pionowej. W pierwszym przypadku porównywano współrzędną Y, w drugim X.
Logo wymagało jeszcze innego kryterium. Znaki specjalizacji zawierały dodatkową ramkę, więc jednakowa szerokość plików nie zapewniała jednakowej skali sygnetu i napisu. Wybrałem wyrównanie do istniejącego Labu. W kontrakcie odniesiono skalę do wysokości i geometrii wewnętrznej znaków.
W kodzie pojawiła się wspólna warstwa nagłówka, nawigacji i ścieżki bieżącej strony. Siatki przejęły odpowiedzialność za wyrównania. Przy przejściu do jednej kolumny treść mogła rosnąć naturalnie, bez pustych akapitów i sztywnych wysokości tekstu.
Pozostawało sprawdzić, czy przeglądarka rzeczywiście układa te elementy zgodnie z regułami.
04 / Co wykryła kontrola geometrii
Kontrola plików mogła potwierdzić obecność komponentu, deklaracji CSS albo właściwego zasobu. Ostateczne położenie elementu zależało jednak także od kaskady stylów, fontu, długości tekstu i szerokości ekranu.
Do pomiarów przygotowano panel otwierający strony w ramkach o zadanych wymiarach. Zapisywał współrzędne wybranych elementów, szerokość dokumentu, wyniki kontroli i skróty badanych artefaktów. Dzięki temu wynik odnosił się do konkretnej wersji strony.
Poniższa tabela łączy obserwacje sprzed korekt zapisane w raporcie odbioru z wynikami odczytanymi z końcowego rejestru pomiarów. Wymiary podano w pikselach CSS.
| Problem | Obserwacja | Przyczyna lub rozpoznanie | Korekta | Wynik kontroli po zmianach |
|---|---|---|---|---|
| G05 — kolumna opisów realizacji AI | Raport: różnica początku kolumny 27,289 px | Każdy wiersz wyznaczał szerokości własnej siatki, zależne od treści | Wspólne kolumny rodzica dziedziczone przez subgrid | AI PL, Chrome, 1440 px: trzy początki X = 574,344 px po zaokrągleniu; rozrzut 0 px, oba motywy |
| G06 — treść sekcji AI względem nagłówka | Raport: przesunięcie 10 px | Margines treści nie odpowiadał geometrii siatki nagłówka 1:2 i jej odstępowi | Skorygowano obliczenie marginesu i próg przejścia do jednej kolumny | AI PL, Chrome, 1440 px: nagłówek i treść X = 518,664 px po zaokrągleniu; różnica 0 px w obu sekcjach i motywach |
| G09 — formularz strony głównej PL | Raport: 2 px przepełnienia przy szerokości 761 px | Kolumny i elementy akcji formularza nie mieściły się w dostępnej szerokości | Dopuszczono kurczenie kolumn oraz zawijanie akcji i tekstu przycisków | Przy 761 px dokument ma 761 px szerokości; brak przepełnienia w Chrome, Firefox i Safari, oba motywy |
| G07 — opisy kart Engineering EN | Zgłoszone rozjechanie przy dwuwierszowym tytule | Nie odtworzono w badanym zakresie; istniejący subgrid wyrównywał opisy | Bez dodatkowej poprawki CSS dla tego zgłoszenia | Engineering EN, Chrome, 1440 px: rozrzut Y opisów pierwszego rzędu 0 px, oba motywy; pozostałe badane szerokości spełniają tolerancję |
Wartości „przed” pochodzą z raportu wykonawcy. Podczas przygotowania wpisu nie odtworzono niezależnie starej wersji. Wyniki „po” pochodzą ze wskazanych próbek końcowego pomiaru.
W G05 wspólna siatka usunęła zależność początku kolumny od treści pojedynczego wiersza. W G06 trzeba było dopasować obliczenie marginesu do geometrii sąsiedniej sekcji. G09 pokazał znaczenie kontroli tuż przy granicy zmiany układu: formularz rozpychał dokument przy szerokości 761 px.
G07 zakończył się inaczej. Zgłoszonego rozjechania opisów Engineering EN nie odtworzono w badanym zakresie. Istniejący subgrid spełniał tolerancję. Zgłoszenie zachowało status „nie odtworzono”, bez dodatkowej poprawki CSS.
Brak odtworzenia zgłoszenia jest innym wynikiem niż potwierdzenie skuteczności poprawki.
05 / Co obejmował pozytywny wynik
Liczba 1340 oznacza przypadki pomiarowe z określonej macierzy stron, motywów i szerokości.
Chrome objął pełną macierz adresów stron, dwóch motywów i podstawowych rozmiarów desktop/mobile. W Chrome, Firefox i Safari wykonano też pomiary przedstawicieli rodzin stron przy granicach szerokości. Zakresy przeglądarek nie były identyczne.
Pomiary pozwalały porównać współrzędne i wykryć przepełnienie. Nie zastępowały wszystkich prób korzystania z interfejsu. Do pełnego odbioru nadal brakowało między innymi kompletu ręcznych scenariuszy klawiatury i powiększenia oraz ocenionych obrazów referencyjnych.
Dlatego pozytywny wynik tej macierzy i status PARTIAL mogły obowiązywać jednocześnie. Dotyczyły różnych zakresów.
Wynik kontroli ma znaczenie dopiero razem z informacją, co ta kontrola obejmowała.
06 / Od jednorazowego pomiaru do narzędzia wielokrotnego użytku
Zdecydowałem o wyodrębnieniu aparatury do Web Factory, aby wykorzystać ją w kolejnych projektach.
Wyodrębniono mechanizm pomiarowy, konfigurację profili i przykład syntetyczny. Profil określał rodziny stron i kryteria kontroli. Przykład pozwalał sprawdzać narzędzie bez kopiowania całego serwisu.
Ekstrakcja otrzymała własną walidację: testy narzędzia oraz 604 przypadki przeglądarkowe w Chromium. Wcześniejsze wyniki Firefoksa i Safari dotyczyły wersji osadzonej w projekcie. Nie zostały uznane za testy kodu po przeniesieniu.
Powstała możliwość ponownego sprawdzania tych samych relacji w kolejnych wdrożeniach. Nie zmierzono jeszcze wpływu narzędzia na czas tych prac.
Pytanie do kolejnego eksperymentu brzmi: czy zastosowanie gotowej aparatury pomiarowej w kolejnym, niezależnym projekcie skróci czas kwalifikacji i zmniejszy liczbę ręcznych poprawek względem dotychczasowego procesu?
07 / Osobna granica przed produkcją
Podczas przygotowania wydania pojawiło się niezależne wymaganie. Na DEV działał eksperymentalny asystent Discovery. Chciałem kontynuować jego testy i zachować osobną decyzję o publicznym uruchomieniu.
Pomiary geometrii nie rozstrzygały tej kwestii. Potrzebna była kontrola ścieżki publikacji.
Dodano sprawdzanie gotowego artefaktu przez obsługiwane buildy i skrypty wdrożeniowe, także przy przywracaniu historycznej wersji. Wykrycie plików lub znanych znaczników asystenta zatrzymuje tę ścieżkę. Widget i API otrzymały dodatkowo ograniczenia hosta, a DEV nadal wymaga autoryzacji.
W teście negatywnym skrypt otrzymał historyczny artefakt zawierający asystenta. Zatrzymał się przed połączeniem SFTP. Osobny odczyt produkcji potwierdził brak znaczników funkcji na 31 badanych stronach oraz odpowiedzi 404 pod trzema sprawdzanymi adresami asystenta.
Następnie zdecydowałem o zamrożeniu przetestowanej wersji tagiem DEV. Zachowano punkt odniesienia do kolejnych zmian, wraz z dowodami i otwartymi kryteriami odbioru.
Ta decyzja pozwalała kontynuować testy. Nie stanowiła zgody na publiczne uruchomienie Discovery.
08 / Co zostało rozstrzygnięte
Początkowy problem dotyczył spójności nowych ofert z istniejącym serwisem. W toku prac powstały wspólne reguły, implementacja i sposób pomiaru ich wykonania.
Zamknięto konkretne różnice geometrii. Jednego zgłoszenia nie odtworzono. Pełny odbiór pozostał częściowy, a narzędzie pomiarowe otrzymało osobną walidację po wyodrębnieniu do kolejnych zastosowań.
Każdy z tych wyników miał własny zakres. Zachowanie go w raporcie pozwalało ustalić, które prace można zakończyć, co wymaga dalszego sprawdzenia i jaka decyzja nadal pozostaje do podjęcia.
W tym przypadku dało się zamrozić użyteczny stan DEV bez ogłaszania pełnej gotowości produkcyjnej. Ograniczenia odbioru pozostały częścią wyniku.
09 / Ograniczenia
Opis dotyczy prac nad serwisem 4digital i stanu zamrożonego 3 listopada 2026 roku. To historia przedsięwzięcia inżynierskiego, a nie kontrolowany eksperyment porównujący efektywność dwóch procesów tworzenia witryn.
Pomiary obejmują określone strony, szerokości i kontrole. Nie stanowią pełnego audytu dostępności ani dowodu poprawności wszystkich interakcji. Nie zmierzono zmiany konwersji, czasu czytania ani kosztu utrzymania.
Blokada Discovery dotyczy badanego kodu i obsługiwanych ścieżek wydania. Nie zastępuje uprawnień do hostingu i kontroli celowych zmian samej blokady. Odczyt produkcji opisuje stan z chwili kontroli, a nie stały monitoring.
10 / Pochodzenie materiału
Cel prac i opisane decyzje mają oparcie w zachowanej rozmowie z okresu rozbudowy serwisu. Do implementacji, przygotowania aparatury i wykonania kontroli wykorzystywany był agent programistyczny AI.
Przy redakcji wpisu porównano te ustalenia z kodem, historią zmian i zapisanymi raportami. Nie uruchamiano ponownie pomiarów witryn. Liczby sprzed korekt przypisano raportowi wykonawcy, a wskazane wyniki końcowe sprawdzono w zachowanym rejestrze pomiarów.
Materiały wykonawcze i pełne raporty pozostają w wewnętrznym archiwum. Wpis nie dostarcza kompletnego pakietu do publicznego odtworzenia przebiegu.
11 / Od autora
Chciałem tylko, żeby trzy karty na stronie były równo.
Naprawdę. Nie planowałem opracowania kontraktu wizualnego, budowy aparatury pomiarowej ani wyodrębniania narzędzia do osobnego projektu. Chciałem, żeby tytuły, opisy i separatory zaczynały się na tych samych wysokościach.
Kilka iteracji później miałem 1340 przypadków pomiarowych, własne narzędzie do kolejnych projektów i raport, który mimo pozytywnych wyników nadal mówił PARTIAL.
Po drodze znaleźliśmy również dwa piksele przepełnienia, których najwyraźniej nie mogłem pozostawić bez opieki.
Najzabawniejsze jest to, że technicznie wszystko ma sens. Każda kolejna decyzja wynikała z poprzedniej, a powstałe narzędzie może się jeszcze przydać.
Czy było warto? Zobaczymy przy kolejnym projekcie.
Czy dało się po prostu wyrównać trzy karty i pójść dalej?
Oczywiście.
Ale wtedy nie byłoby tego artykułu.
Jak cytować
Bartłomiej Pietrzyk, „Dwa landingi i jeden kontrakt wizualny”
4digital Lab, 03.11.2026, https://lab.4digital.cloud/pl/dwa-landingi-i-jeden-kontrakt-wizualny/
Warunki wykorzystania opracowań i danych ustalane są indywidualnie.