Plán webu

PLAN.md se zapíše v okamžiku, kdy dokončí první sestavení projektu, a má vždy popisovat web tak, jak je právě teď – nejde o záznam všeho, co se s webem kdy stalo (od toho jsou záložka Verze a Changelog). Obrazovka Plán webu převádí tento Markdown na skutečné rozhraní: tabulku pro stránky, seznam pro moduly, zaškrtávací seznam pro otevřené otázky a prostý text pro obchodní údaje, značku a rozhodnutí.

Dokud není dokončeno žádné sestavení, není co číst: obrazovka zobrazí „Zatím žádný plán“, srozumitelně vysvětlí, že plán zapisuje první sestavení projektu, a odkáže zpět na stránku projektu, místo aby ukazovala prázdnou tabulku.

Web, jehož soubory přišly bez plánu (publikované z jiného AI nástroje přes konektor, importované nebo nahrané), plán také dostane: obrazovka ho založí ze zadání projektu, z vybraných položek kitu a změřených stránek a banner Tento plán byl pro vás založen nabídne Uložit tento plán, který z něj udělá skutečný plán projektu, takže každou sekci lze upravit. Odkaz Přečíst celý plán vede k dokumentu plánu na záložce Plán a zadání.

Nástroje přidané později z Kitu (Přidat do plánu) se zapíší do seznamu Moduly se stavem Plánováno a odkazem Zobrazit v Kitu, a to i tehdy, když text plánu vznikl dříve, než byly přidány.

Pod nadpisem je jeden řádek, který říká, kdy byl plán naposledy aktualizován: „Plán aktualizován 2. 10., 15:04“. Tento čas pochází z posledního měření skutečných souborů webu, které aiKit provádí po každé změně (úprava v chatu, připnutí, přidání z Kitu, obnovení, ruční úprava plánu, publikování z jiného AI nástroje).

Nahoře, jakmile plán existuje: celkový pruh s procentem dokončení a pod ním tři dlaždice: Vytvořené stránky (z plánovaných stránek), Vytvořené moduly (z vybraných modulů) a Zodpovězené otázky (z otevřených otázek plánu). Každá dlaždice je tlačítko, které posune na sekci, kterou počítá. Nic z toho nevychází z vlastního hlášení textu plánu: stránka se počítá jako vytvořená, až když ji aiKit najde ve skutečných souborech webu; modul se počítá jako vytvořený jen podle ověřené zprávy o sestavení nebo modulu nalezeného v souborech; a otázka se počítá jako zodpovězená, když je její řádek v plánu odškrtnutý nebo ji klient odpověděl na své stránce Otázky.

Dvě věci způsobují, že plán zaostává, a obrazovka říká, která: průchod AI, který přepisuje plán po změně, neskončil („Psaný plán se po poslední změně neaktualizoval“, s důvodem), nebo web má novější verzi, než vůči které byl plán změřen („Web se změnil od poslední aktualizace plánu“). V obou případech se objeví tlačítko „Obnovit plán“. Stránka ho při otevření nikdy nespustí sama (otevření stránky nikdy nepoužívá AI); engine každou změnu na pozadí už zapracuje do plánu a tlačítko slouží pro případ, kdy to zaostalo. Obnovit plán zapracuje nejnovější změnu do psaného plánu a znovu změří web. Pokud to stále nevyjde, upozornění zůstane s popisem chyby a můžete stisknout Obnovit plán znovu nebo plán upravit ručně.

Karta Stav hodnotí web ze 100 bodů podle pravidel, která aiKit kontroluje ve skutečných souborech, nikdy podle názoru AI: chybějící nebo opakovaný název stránky či popis pro vyhledávače, stránka bez hlavního nadpisu nebo s více nadpisy, odkaz na neexistující stránku, stránka, na kterou nic neodkazuje a v menu chybí, obrázky bez popisu pro čtečky obrazovky, velmi krátké stránky, formulář bez místa, kam odeslat data, a modul, který zadání požaduje, ale na webu chybí. Každý problém uvádí, která stránka je dotčena, proč na tom záleží, a má tlačítko Opravit: Opravit odešle hotový návod k problému jako žádost a předá ji AI; tlačítko během práce zobrazí „Oprava odeslána“ a po provedení změny se skóre znovu změří. Seznam můžete filtrovat podle závažnosti pomocí počtů Vysoká, Střední a Nízká a tlačítko „Zobrazit vše“ filtr zruší.

Mapa webu zobrazuje web jako strom: domovská stránka nahoře, pod ní menu v pořadí, a pod nimi stránky, ke kterým se dá dostat z těchto stránek. Stránky, na které nic neodkazuje, jsou ve vlastní skupině, stránky uvedené v plánu, které ještě nejsou vytvořené, jsou nakresleny přerušovaně a označeny Plánováno, a vytvořené stránky, které plán vůbec nezmiňuje, jsou označeny „Není v plánu“ s tlačítkem „Přidat do plánu“, které je přidá do sekce Stránky.

Klepněte na libovolnou stránku (v mapě webu nebo v seznamu Stránky) a její podrobnosti se otevřou vedle plánu. Adresní řádek se změní na ?page=/about, takže odkaz otevře stejnou stránku komukoli v týmu. Podrobnosti ukazují, jak stránka vypadá ve Googlu (název, adresa, popis), její sekce a hlavní nadpisy, počet slov, obrázky a kolik z nich postrádá popis, její formuláře a který modul kitu je zpracovává, zda ji klient schválil, a poslední změnu: kdy, kdo ji požádal a co se požadovalo.

Historie vypisuje verze, které aiKit uchovává (původní a posledních 10), od nejnovější. U každé je číslo, druh změny (První sestavení, Chat, Připnutí, Kit, Publikováno, Obnovení, Úprava plánu), kdy, co bylo požadováno, kdo požádal, a které stránky se změnily (klepnutím na stránku otevřete její podrobnosti). Nejnovější je označena Aktuální verze; každá starší má tlačítko „Obnovit tuto verzi“, které se nejprve zeptá a před návratem uloží aktuální stav, takže obnovení lze vrátit zpět. První tři se zobrazují; „Zobrazit vše“ vypíše zbytek.

Sekce Údaje o firmě porovnává telefon, e-mail, adresu a otevírací dobu v Kartotéce klienta s textem vytvořených stránek (nejdříve domovská a kontaktní). Každý údaj ukazuje „Na webu“ nebo „Na webu nenalezeno“ (s počtem zkontrolovaných stránek, protože web může zobrazovat starou hodnotu), a odkaz „Upravit v Kartotéce klienta“ udržuje Kartotéku klienta jako zdroj pravdy.

• Stránky — tabulka: Stránka, Cesta, Účel a Stav (Vytvořeno nebo Plánováno), se skutečným odkazem „Zobrazit“ na živou stránku, jakmile je vytvořena a web je spuštěný.
• Moduly a nástroje — každý modul uvedený v plánu, s štítkem Vytvořeno nebo Plánováno a vlastní poznámkou.
• Údaje o firmě — otevírací doba, adresa, služby, ceny a cokoli dalšího věcného o firmě, psané jako prostý text.
• Značka — paleta, tón a případné poznámky ke stylu, které plán zaznamenal.
• Rozhodnutí — skutečná rozhodnutí, která byla učiněna a která by další úprava neměla znovu otevírat.
• Otevřené otázky — seznam úkolů s věcmi, které jsou stále opravdu nerozhodnuté, u každé se zobrazuje zodpovězeno nebo stále otevřeno.

Každá karta sekce má stejná dvě tlačítka. „Upravit“ otevře surový Markdown dané sekce v jednoduchém textovém poli a uloží ho přímo zpět do PLAN.md — jde o skutečný, okamžitý zápis (přes vlastní koncový bod PUT projektu), ale záměrně nespustí sestavení ani nasazení; mění pouze to, co dokument plánu říká, stejně jako úprava jakékoli jiné poznámky.

Tlačítko „Požádat o změnu“ je záměrně jiné: otevře malý formulář („Co byste chtěli v sekci <section> změnit?“) a po odeslání se vytvoří skutečný požadavek v záložce Zpětná vazba projektu – označený „Plán webu — <Section>: …“ – stejně jako každý jiný štítek nebo požadavek na rychlou úpravu, se svým vlastním stavem a odkazem „Zobrazit požadavek“ po odeslání. Použijte Upravit, když sami opravujete nebo přepisujete text samotného plánu; použijte Požádat o změnu, když chcete, aby se skutečný web (a tím i plán) aktualizoval tak, aby odpovídal.

Plán má dvě vrstvy. Měření (stránky, nadpisy, sekce, odkazy, formuláře, moduly, stav) provádí kód po každé změně přímo ze skutečných souborů, takže se nemohou rozejít. Psaný plán (cíle, fakta o firmě, značka, rozhodnutí, otevřené otázky) udržuje aktuální AI krok, který běží po každé změně a přepisuje jen části, kterých se změna týkala. Nikdy nepřidává záznam změn ani datované položky; záznam změn je v sekci Historie.

Pokud tento AI krok selže, psaný plán zůstane tak, jak byl, a nebude napůl přepsán, selhání se zaznamená a obrazovka místo tichého zobrazení zastaralého plánu ukáže Obnovit plán (viz výše).

Vedle plánu je panel s akcemi (na telefonu se panel změní na tlačítko "Zkopírovat odkaz pro klienta" na celou šířku hned pod pruhem postupu, ostatní jsou schované pod "Další akce (3)"). "Sdílet s klientem" zkopíruje odkaz jen pro čtení (aikit.ai/p/<project>/plan) — žádné interní nástroje, žádná tlačítka pro úpravy, nic interního. "Otevřít živý web" je přímý odkaz na živý web, nebo panel jasně napíše "Zatím není online", pokud web online není. "Soubory" ukazují skutečný počet souborů s rozbalitelným seznamem cesty a velikosti každého souboru. "Stáhnout plán" stáhne aktuální soubor PLAN.md jako skutečný soubor .md, bajt po bajtu shodný s tím, co obrazovka čte — ne přegenerované shrnutí.

Klientova stránka se otevře na kartě Plán: stejný dokument plánu webu, jaký vidí zaměstnanci na kartě Plán a zadání (přehled a cíle, publikum, strategie, mapa webu, každý nástroj s tím, co dělá pro jejich firmu, a jeho stav, plán obsahu, časová osa, rozhodnutí a otevřené otázky), bez částí určených jen pro zaměstnance: žádné poznámky zapsané při přidání nástroje, žádná jména toho, kdo co přidal, žádné odkazy do Kitu aiKitu a žádné tlačítko Napsat plán. Druhá karta, Stránky a schválení, uchovává zobrazení stránku po stránce níže.

Na kartě Stránky a schválení, přístupné pod stejným přístupovým kódem, který už klient používá pro zpětnou vazbu (bez samostatného přihlášení), klient vidí stejný pruh postupu, mapu webu se seznamem svých stránek, seznam stránek s odkazy "Zobrazit", moduly, fakta o firmě, značku, rozhodnutí a otevřené otázky, a také řádek "Plán aktualizován". Nedostává zdraví projektu, pokyny k opravám, historii, informace o tom, kdo co požadoval, seznam souborů ani žádné tlačítko Upravit nebo Požádat o změnu.

Vše, co zaměstnanci označí jen pro sebe, se na serveru odstraní dříve, než se stránka odešle, ve všech sekcích: řádek obsahující "(internal)", "[internal]" nebo "(staff only)", řádek začínající "Internal:" nebo "Staff only:", každá sekce, jejíž nadpis říká Internal nebo Staff only, a skryté komentáře. Tyto řádky se do prohlížeče klienta nikdy nedostanou, ani v síťových datech stránky.

Každá vytvořená stránka má tlačítko Schválit. Klient napíše své jméno (a volitelně poznámku) a schválí; schválení je svázáno s přesným obsahem stránky, takže pokud se stránka později změní, zobrazí se "Změněno od vašeho schválení" a klient je požádán znovu. Schválit může jen někdo s přístupovým kódem klienta. Pokud otevřete klientský odkaz přihlášeni jako zaměstnanec, vidíte stav schválení každé stránky, ale žádné tlačítko Schválit, aby nikdo nemohl schvalovat za klienta. Na interním plánu webu zaměstnanci se u schválených stránek zobrazí "Schváleno klientem" a u změněných "Změněno od schválení."

Dole je tlačítko "Odeslat zpětnou vazbu": pokud je web online, otevře skutečný živý web se zapnutou vrstvou pro zpětnou vazbu (pomocí jejich vlastního přístupového kódu); pokud ještě online není, přesměruje na jejich stránku Poslední aktualizace.