Playbook vizuálních prvků webu

Playbook je stránka s přehledem všech vizuálních prvků veřejného webu. Každý prvek je na ní vykreslený stejným partialem nebo třídou, jakou používá web. Ukazuje proto skutečný stav, ne obrázek.

Slouží vývojářům i agentům (Claude a další): než postavíš nebo upravíš frontend, vezmi prvek odsud a nevymýšlej vlastní variantu.

Kde ho najdeš

Stránka je na adrese /playbook veřejného webu, na každé instanci kromě produkce:

lokálně na doméně z .env (DOMAIN),
na dev, experimental a stagingu na doméně dané instance, viz Prostředí.

Instance v režimu údržby pustí na playbook jen toho, kdo už má nastavený přístup přes tajnou adresu.

Co na něm je

Typografie, barvy, tlačítka, pole formulářů a celý formulář.
Hlášky, karty, štítky a stavy, navigace, výsledky a pořadí.
Pravidla střídání pozadí sekcí, odstupy, ikony a obrázky.
Všechny bloky page builderu s ukázkovým obsahem.
Katalog všech souborů z resources/views/web2/components.

U každého prvku je ukázka, název partialu nebo třídy, cesta k souboru a jedna věta, kdy ho použít a kdy ne.

Pravidla

Prvek použij tak, jak je na playbooku. Nepřidávej vlastní kombinaci tříd ani jednorázové HTML.
Když prvek nebo varianta chybí, nejdřív ji přidej do playbooku, potom na stránku. Obojí v jedné změně.
Playbook popisuje současný stav. Odchylky mezi stránkami při práci na něčem jiném nesjednocuj, patří do samostatného ticketu.
Formuláře na playbooku nic neodesílají. Po odeslání jen ukážou své poděkování.

Stejná pravidla mají agenti zapsaná v .ai/rules/web2.md a .ai/rules/css.md.

Jak playbook rozšířit

Co přidáváš	Kam to zapsat
Nový prvek nebo variantu	Položka v příslušné sekci v `resources/views/web2/playbook/sections/`
Novou sekci playbooku	`App\Support\WebPlaybook::sections()` a soubor sekce se stejným id
Nový partial ve `web2/components`	`App\Support\WebPlaybook::components()`
Nový blok page builderu	`App\Support\WebPlaybook::blockTypes()` a ukázka v `blockSamples()`

Položka se zapisuje přes @component('web2.playbook.entry', [...]). Parametry popisuje komentář na začátku souboru resources/views/web2/playbook/entry.blade.php.

Ukázková data, která nejsou jen text (modely, stránkování), patří do App\Support, ne do šablony.

Co hlídají testy

Test tests/Feature/Web2/PlaybookTest.php neprojde, když:

stránka na produkci nevrátí 404,
typ bloku, který zná renderer nebo nabízí administrace, nemá na playbooku popis a ukázku,
soubor ve web2/components chybí v katalogu,
dvě položky mají stejné id nebo položka neuvádí zdrojový soubor.

Mimo rozsah

Administrace a moderátorský panel na playbooku nejsou.