Plan witryny

PLAN.md jest zapisywany w chwili zakończenia pierwszej budowy projektu i ma zawsze opisywać witrynę taką, jaka jest teraz — a nie dziennik wszystkiego, co się z nią działo (od tego są zakładka Wersje i Dziennik zmian). Ekran Plan witryny przetwarza ten Markdown na prawdziwy interfejs: tabelę dla stron, listę dla modułów, listę kontrolną dla otwartych pytań oraz zwykły tekst dla faktów o firmie, marki i decyzji.

Dopóki nie zakończy się żadna budowa, nie ma jeszcze nic do odczytania: ekran pokazuje „Brak planu”, jasno wyjaśnia, że plan zapisuje pierwsza budowa projektu, i zawiera link powrotny do strony projektu zamiast pustej tabeli.

Witryna, której pliki przyszły bez planu (opublikowana z innego narzędzia AI przez łącznik, zaimportowana lub przesłana), także dostaje plan: ekran tworzy go na podstawie briefu projektu, wybranych elementów zestawu i zmierzonych stron, a baner Ten plan został utworzony dla Ciebie oferuje przycisk Zapisz ten plan, który zamienia go w prawdziwy plan projektu, dzięki czemu każdą sekcję można edytować. Przejdź do pełnego planu witryny prowadzi do dokumentu planu w zakładce Plan i brief.

Narzędzia dodane później z Zestawu (Dodaj do planu) trafiają na listę Moduły ze statusem Zaplanowane i linkiem Zobacz w Zestawie, nawet gdy tekst planu został napisany przed ich dodaniem.

Pod tytułem jedna linia mówi, kiedy plan był ostatnio aktualizowany: „Plan zaktualizowany 2 paź, 15:04”. Ta data pochodzi z ostatniego pomiaru rzeczywistych plików witryny wykonanego przez aiKit, a ten pomiar odbywa się po każdej zmianie (edycja w czacie, przypięcie, dodanie z Zestawu, przywrócenie, ręczna edycja planu lub publikacja z innego narzędzia AI).

Na górze, gdy plan już istnieje: ogólny pasek postępu w procentach i pod nim trzy kafelki: Zbudowane strony (z zaplanowanych stron), Zbudowane moduły (z wybranych modułów) i Odpowiedzi na pytania (z otwartych pytań z planu). Każdy kafelek to przycisk, który przewija do sekcji, którą liczy. Nic z tego nie jest wpisywane przez samą treść planu: strona liczy się jako zbudowana dopiero wtedy, gdy aiKit znajdzie ją w prawdziwych plikach witryny; moduł liczy się jako zbudowany tylko na podstawie zweryfikowanego raportu budowy lub modułu znalezionego w plikach; a pytanie uznaje się za odpowiedziane, gdy jego pozycja jest odhaczona w planie albo klient odpowiedział na nie na swojej stronie Pytania.

Dwie rzeczy powodują, że plan zostaje w tyle, a ekran mówi, która to: przebieg AI, który przepisuje plan po zmianie, nie został zakończony ("Pisemny plan nie został zaktualizowany po ostatniej zmianie", wraz z przyczyną) albo witryna ma nowszą wersję niż ta, do której plan został sprawdzony ("Witryna zmieniła się po ostatniej aktualizacji tego planu"). W obu przypadkach pojawia się przycisk "Odśwież plan". Strona nigdy nie uruchamia go sama po otwarciu (otwarcie strony nie zużywa AI); silnik i tak w tle wprowadza każdą zmianę do planu, a przycisk jest po to, gdy to się opóźniło. Odśwież plan wprowadza najnowszą zmianę do pisemnego planu i ponownie mierzy witrynę. Jeśli to nadal się nie uda, baner pozostaje z opisem problemu, a Ty możesz nacisnąć Odśwież plan ponownie albo edytować plan ręcznie.

Karta Stan zdrowia ocenia witrynę w skali 0–100 na podstawie reguł, które aiKit sprawdza w prawdziwych plikach, a nie na podstawie opinii AI: brakujący lub powtórzony tytuł strony albo opis dla wyszukiwarek, strona bez nagłówka głównego lub z więcej niż jednym, link do nieistniejącej strony, strona, do której nic nie prowadzi i której nie ma w menu, obrazy bez opisu dla czytników ekranu, bardzo krótkie strony, formularz bez miejsca wysyłki oraz moduł, o który prosił brief, a którego nie ma na stronie. Każdy problem wskazuje stronę i wyjaśnia, dlaczego ma znaczenie, i ma przycisk Napraw: Napraw zgłasza gotową instrukcję problemu jako prośbę i przekazuje ją AI, przycisk pokazuje "Poprawka zgłoszona", gdy trwa praca, a wynik jest ponownie mierzony po wprowadzeniu zmiany. Filtruj listę według ważności licznikami Wysoka, Średnia i Niska, a "Pokaż wszystkie" usuwa filtr.

Mapa witryny rysuje stronę jako drzewo: strona główna na górze, potem menu w kolejności, a dalej strony osiągalne z tych stron. Strony, do których nic nie prowadzi, znajdują się w osobnej grupie. Strony, które plan wymienia, a których jeszcze nie zbudowano, są rysowane przerywaną linią i oznaczone jako Zaplanowana. Zbudowane strony, o których plan nie wspomina, są oznaczone "Nie ma w planie" i mają przycisk "Dodaj do planu", który dodaje je do sekcji Strony.

Kliknij dowolną stronę (na mapie witryny lub na liście Stron), aby otworzyć jej szczegóły obok planu. Pasek adresu zmieni się na ?page=/about, więc link otworzy tę samą stronę dla każdego w zespole. Szczegóły pokazują, jak strona wygląda w Google (tytuł, adres, opis), jej sekcje i nagłówki główne, liczbę słów, obrazy i ile z nich nie ma opisu, jej formularze oraz który moduł zestawu je obsługuje, czy klient zatwierdził stronę oraz ostatnią zmianę: kiedy, kto o nią poprosił i o co poproszono.

Historia pokazuje wersje, które aiKit zachowuje (Oryginał i 10 najnowszych), od najnowszej: numer, rodzaj zmiany (Pierwsza budowa, Czat, Przypięcie, Zestaw, Publikacja, Przywrócenie, Edycja planu), kiedy, o co poproszono, kto poprosił i które strony się zmieniły (kliknij stronę, aby otworzyć jej szczegóły). Najnowsza jest oznaczona jako Aktualna wersja; każda starsza ma przycisk "Przywróć tę wersję", który najpierw pyta o potwierdzenie i zapisuje obecny stan przed przywróceniem witryny, więc przywrócenie można cofnąć. Pierwsze trzy są widoczne; "Pokaż wszystkie" wyświetla resztę.

Sekcja Dane firmy porównuje telefon, e-mail, adres i godziny z Karty klienta z tekstem zbudowanych stron (najpierw strona główna i kontakt). Każda informacja pokazuje "Na stronie" lub "Nie znaleziono na stronie" (wraz z liczbą sprawdzonych stron, ponieważ witryna może pokazywać starą wartość), a link "Edytuj w Karcie klienta" dba o to, by Karta klienta pozostała źródłem prawdy.

• Strony — tabela: Strona, Ścieżka, Cel i Status (Zbudowana lub Zaplanowana), z prawdziwym linkiem "Zobacz" do działającej strony, gdy jest zbudowana i witryna jest na żywo.
• Moduły i narzędzia — każdy moduł z planu, z etykietką Zbudowany lub Zaplanowany i własną notatką.
• Dane firmy — godziny, adres, usługi, ceny i wszystko inne rzeczowe o firmie, zapisane jako zwykły tekst.
• Marka — paleta, ton i wszelkie uwagi dotyczące stylu zapisane w planie.
• Decyzje — rzeczywiste ustalenia, które zostały podjęte i nie powinny być ponownie kwestionowane przy kolejnej edycji.
• Otwarte pytania — lista kontrolna spraw, które naprawdę są jeszcze nierozstrzygnięte, z oznaczeniem odpowiedziano lub nadal otwarte.

Każda karta sekcji ma te same dwa przyciski. "Edytuj" otwiera surowy Markdown tej sekcji w prostym polu tekstowym i zapisuje go bezpośrednio z powrotem do PLAN.md. To prawdziwy, natychmiastowy zapis (przez własny punkt końcowy PUT projektu), ale celowo nie uruchamia budowy ani publikacji; zmienia tylko treść dokumentu planu, tak jak edycja każdej innej notatki.

"Poproś o zmianę" działa inaczej celowo: otwiera małe formularzyk ("Co chcesz zmienić w sekcji <section>?"), a po wysłaniu trafia on jako prawdziwa prośba do zakładki Opinie projektu — oznaczona jako "Plan strony — <Section>: …" — dokładnie tak jak każda pinezka lub prośba z Szybkiej edycji, z własnym cyklem statusów i linkiem "Zobacz prośbę" po wysłaniu. Użyj Edytuj, gdy sam poprawiasz lub przepisujesz tekst planu; użyj Poproś o zmianę, gdy chcesz, aby rzeczywista strona (a w efekcie także plan) została zaktualizowana zgodnie z tym.

Plan ma dwie warstwy. Pomiary (strony, tytuły, sekcje, linki, formularze, moduły, stan) są pobierane przez kod z rzeczywistych plików po każdej zmianie, więc nie mogą się rozjechać. Spisany plan (cele, fakty o firmie, marka, decyzje, otwarte pytania) jest na bieżąco aktualizowany przez przebieg AI, który uruchamia się po każdej zmianie i przepisuje tylko te części, których zmiana dotyczyła. Nigdy nie dodaje dziennika zmian ani wpisów z datami; zapis zmian znajduje się w sekcji Historia.

Jeśli ten przebieg AI się nie powiedzie, spisany plan pozostaje bez zmian, zamiast być napisany w połowie, błąd zostaje zapisany, a ekran pokazuje przycisk Odśwież plan (patrz wyżej) zamiast po cichu wyświetlać nieaktualny plan.

Panel obok planu zawiera działania (na telefonie panel zmienia się w przycisk „Skopiuj link dla klienta” na całą szerokość, tuż pod paskiem postępu, a reszta jest schowana pod „Więcej działań (3)”). „Udostępnij klientowi” kopiuje link tylko do odczytu (aikit.ai/p/<project>/plan) — bez narzędzi dla pracowników, bez przycisków edycji, nic wewnętrznego. „Otwórz działającą stronę” to bezpośredni link do działającej strony, a panel wyraźnie pisze „Jeszcze nie na żywo”, jeśli strony nie ma. „Pliki” pokazuje rzeczywistą liczbę plików z rozwijaną listą ścieżek i rozmiarów każdego pliku. „Pobierz plan” pobiera aktualny plik PLAN.md jako prawdziwy plik .md, dokładnie taki, jaki widać na ekranie — nie wygenerowane od nowa streszczenie.

Strona klienta otwiera się na karcie Plan: ten sam dokument planu strony, który pracownicy widzą na karcie Plan i brief (przegląd i cele, odbiorcy, strategia, mapa strony, każde narzędzie z opisem, co daje ich firmie, i statusem, plan treści, harmonogram, decyzje i otwarte pytania), bez części tylko dla personelu: bez notatek wpisanych przy dodawaniu narzędzia, bez nazwisk osób, które coś dodały, bez linków do Kit aiKit i bez przycisku Napisz plan. Druga karta, Strony i zatwierdzenia, zawiera widok strona po stronie opisany poniżej.

Na karcie Strony i zatwierdzenia, zabezpieczonej tym samym kodem dostępu, którego klienci już używają do zostawiania opinii (bez osobnego logowania), klient widzi ten sam pasek postępu, Mapę strony z listą jego stron, listę Stron z linkami „Zobacz”, moduły, fakty o firmie, markę, decyzje i otwarte pytania oraz linię „Plan zaktualizowany”. Nie widzi Stanu zdrowia, instrukcji napraw, Historii, tego, kto o co poprosił, listy plików ani żadnego przycisku Edytuj lub Poproś o zmianę.

Wszystko, co personel oznaczy dla siebie, jest usuwane na serwerze, zanim strona zostanie wysłana, we wszystkich sekcjach: wiersz zawierający „(internal)”, „[internal]” lub „(staff only)”, wiersz zaczynający się od „Internal:” lub „Staff only:”, każda sekcja, której nagłówek mówi Internal lub Staff only, oraz ukryte komentarze. Te wiersze nigdy nie docierają do przeglądarki klienta, nawet w danych sieciowych strony.

Każda zbudowana strona ma przycisk Zatwierdź. Klient wpisuje swoje imię (i opcjonalną notatkę) i zatwierdza; zatwierdzenie jest powiązane z dokładną treścią tej strony, więc jeśli strona zmieni się później, pojawia się komunikat „Zmieniono od Twojego zatwierdzenia” i prośba pojawia się ponownie. Zatwierdzić może tylko osoba używająca kodu dostępu klienta. Jeśli otworzysz link klienta będąc zalogowanym jako pracownik, widzisz stan zatwierdzenia każdej strony, ale nie widzisz przycisku Zatwierdź, więc nikt nie zatwierdzi w imieniu klienta. Na wewnętrznej karcie Plan strony zatwierdzone strony pokazują „Zatwierdzone przez klienta”, a zmienione „Zmienione od zatwierdzenia”.

Na dole znajduje się przycisk „Wyślij opinię”: jeśli strona jest już na żywo, otwiera rzeczywistą działającą stronę z już włączoną nakładką do opinii (przy użyciu ich własnego kodu dostępu); jeśli nie jest jeszcze na żywo, przenosi do ich strony Ostatnie aktualizacje.