Audyt edytowalności: czy całą stronę da się zmienić z panelu
Narzędzie, które porównuje realną treść witryny z tym, co udostępnia panel: sekcje, pola, ustawienia i kolumny podstron.
Po co to jest
Strona zbudowana importem może zawierać treść, której panel nie potrafi pokazać ani zmienić. Audyt odpowiada na pytanie „czy właściciel strony poprawi tu wszystko sam", zanim odpowie na nie klient zgłoszeniem.
Co sprawdza
- Sekcje — czy każdy użyty typ sekcji jest w katalogu „dodaj sekcję" dla danego szablonu.
- Pola sekcji — czy każdy klucz danych ma odpowiadające pole w formularzu, łącznie z kluczami wewnątrz powtarzalnych list.
- Kształt wartości — czy zapisana wartość ma postać, jaką formularz w ogóle potrafi wyprodukować.
- Ustawienia witryny — czy każdy klucz danych firmy (również w wersjach językowych) i każda gałąź ustawień ma swój ekran.
- Kolumny podstron — czy wartości w kolumnach podstrony da się ustawić w edytorze.
Bramki planów liczone są w wariancie najlepszego planu, żeby odróżnić „panel tego nie ma" od „ten zespół ma słabszy plan".
Uruchomienie
php docs/audyty/clickability.php sonto zonto # prosto z bazy
php docs/audyty/export-sites.php sonto > dump.json # zrzut treści (np. z produkcji)
php docs/audyty/clickability.php --dump=dump.json # pomiar zrzutu bieżącym kodem
Wariant ze zrzutem ma znaczenie, gdy produkcja jest o kilka wdrożeń w tyle: mierzy produkcyjne dane kodem z bieżącej gałęzi, zamiast mieszać jedno z drugim.
Jak czytać wynik
Raport podaje dla każdej witryny liczbę sekcji w pełni odtwarzalnych z panelu oraz listy braków w rozbiciu na typ sekcji i klucz. Osobno wypisuje sekcje ze starymi nazwami kluczy — te naprawia normalizacja, nie zmiany w formularzach.
Kolumna „klików" to zgrubna liczba operacji w panelu potrzebnych do zbudowania strony od zera (podstrony plus dodanie i zapis każdej sekcji). Dla dużych katalogów wychodzą tysiące — to sygnał, że stronę i tak stawia się importem, a panel służy do jej późniejszej edycji.
Strona demonstracyjna
Do zrzutów w dokumentacji i do prób służy fikcyjna strona „Świecarnia Nokturn" o strukturze takiej samej jak prawdziwe katalogi: kategorie, karty produktów, panel „Oferta", dwie wersje językowe.
php docs/audyty/demo-nokturn.php # zbuduj demo lokalnie