Kontroly kondice
Všechny packy a všechny kontroly, které spouštějí, vypsané ze stejného kódu, jaký spouští CLI, takže seznam odpovídá verzi, kterou si nainstalujete. Kontroly kondice jen radí: plachta je ukazuje na kartě Kondice a verdikt kroku ani běhu nikdy nemění. Když na kontrole vašemu týmu záleží, převezměte ji jako kritérium (kaloko health adopt <krok>:<kontrola>); od té chvíle se počítá do přijetí.
Krok si packy zapne přes packs: [seo, a11y] v souboru scénáře (Přidat kritéria a packy). Druhy kontrol, jejich volby a id najdete v Kritéria, kontroly a packy.
Závažnost neúspěšné kontroly: chyba, když stránka zavře dveře lidem nebo vyhledávačům, jinak varování. Odpověď, kterou si evaluátor nebyl jistý, se ukáže jako nejisté.
Základy SEO (seo)
Co si ze stránky přečtou vyhledávače: titulek, popis, kanonickou adresu, hreflang, Open Graph, robots, viewport a strukturovaná data. Na kroku typu stack navíc porovná stránky mezi sebou.
Na designových prostředích, kde jsou kroky vaše vlastní HTML ze složky, je vypnutý. Pokud ho tam chcete, uveďte ho ve scénáři v health: { design_packs: [...] }.
| Id | Kontrola | Proč na ní záleží | Závažnost | Kde platí |
|---|---|---|---|---|
| HC101 | Právě jeden nadpis H1 | Vyhledávače i čtečky obrazovky berou H1 jako název stránky; žádný nebo několik ho znejasní. | varování | každý krok s packem |
| HC102 | Titulek má 10 až 70 znaků | Titulek je modrý odkaz ve výsledcích hledání; příliš krátký nic neřekne, příliš dlouhý se ořízne. | varování | každý krok s packem |
| HC103 | Popis stránky má 50 až 160 znaků | Meta popis je úryvek pod odkazem; bez něj vyhledávač vybere náhodný text. | varování | každý krok s packem |
| HC104 | Kanonický odkaz je uvedený | Bez kanonické adresy si kopie stránky (parametry, filtry) konkurují ve vyhledávání. | varování | každý krok s packem |
| HC105 | hreflang pro každý jazyk | hreflang říká vyhledávačům, kterou jazykovou verzi komu ukázat. | varování | scénáře s více jazyky |
| HC106 | Open Graph titulek a popis | Sdílené odkazy na sítích a v chatech berou náhled z Open Graph. | varování | každý krok s packem |
| HC107 | Stránka není vyřazená z indexace | Značka robots s noindex stránku úplně vyřadí z výsledků hledání. | chyba | každý krok s packem |
| HC108 | Viewport pro telefony | Bez značky viewport ukazují telefony zmenšenou desktopovou stránku. | chyba | každý krok s packem |
| HC109 | Atribut lang u html | Čtečky obrazovky podle <html lang> volí hlas a vyhledávače jazyk. | varování | každý krok s packem |
| HC110 | Nic nepřetéká do strany | Obsah širší než obrazovka nutí telefony posouvat stránku do strany a rozbíjí rozvržení. | chyba | každý krok s packem |
| HC111 | V konzoli nejsou chyby | Chyby v konzoli často znamenají, že něco tiše nefunguje. | chyba | každý krok s packem |
| HC112 | Strukturovaná data (JSON-LD) jsou na stránce | Strukturovaná data říkají vyhledávačům a AI asistentům, co stránka je (produkt s cenou, článek, FAQ), a otevírají rozšířené výsledky hledání. | varování | každý krok s packem |
| HC113 | Každý blok JSON-LD je platný JSON | Blok, který nejde přečíst, se ignoruje celý: cena, drobečková navigace ani FAQ z něj se do výsledků hledání nedostanou. | varování | každý krok s packem |
| HC121 | Titulky se v rámci jazyka neopakují | Stránky se stejným titulkem vypadají pro vyhledávač jako duplicity; vybere jednu a ostatní schová. | varování | kroky typu stack, napříč stránkami |
| HC122 | Meta popisy se v rámci jazyka neopakují | Popis zkopírovaný na více stránek hledajícímu nic neřekne o té, kterou se chystá otevřít. | varování | kroky typu stack, napříč stránkami |
| HC123 | Nadpisy H1 se v rámci jazyka neopakují | Dvě stránky se stejným H1 si konkurují ve stejném hledání a matou lidi, kteří přijdou na tu druhou. | varování | kroky typu stack, napříč stránkami |
| HC124 | Každá stránka je svou kanonickou adresou | Kanonická adresa jinam žádá vyhledávač, aby stránku vynechal; když míří na chybovou stránku nebo noindex, vypadnou obě. | varování | kroky typu stack, napříč stránkami |
| HC125 | Jazykové verze na sebe přes hreflang odkazují navzájem | Vyhledávač hreflang bez potvrzení z druhé strany ignoruje a ve výsledcích se ukáže špatný jazyk. | varování | kroky typu stack, napříč stránkami |
| HC126 | Stránky ze sitemapy odpovídají 200, nepřesměrují a jdou indexovat | Sitemapa je seznam stránek, které chcete nechat najít; přesměrování, chyby a noindex v ní plýtvají procházením a podkopávají důvěru v celý seznam. | varování | stacky načtené ze sitemapy |
| HC127 | Často zobrazované stránky nemají výrazně nižší míru prokliku | Lidé stránku ve výsledcích vidí, ale kliknou jinam: titulek a popis ve výsledcích neslibují to, co hledají. | varování | stacky s daty o návštěvnosti |
Odpovědní vyhledávače (aeo)
Co převezmou AI vyhledávače a asistenti: strukturovaná data FAQ, krátkou odpověď pod H1, llms.txt, meta popis a stránku tak, jak ji bez JavaScriptu dostane GPTBot. Levné signály ze stránky, ne pozice v žádném asistentovi.
Na designových prostředích, kde jsou kroky vaše vlastní HTML ze složky, je vypnutý. Pokud ho tam chcete, uveďte ho ve scénáři v health: { design_packs: [...] }.
| Id | Kontrola | Proč na ní záleží | Závažnost | Kde platí |
|---|---|---|---|---|
| HC901 | Otázky a odpovědi na stránce mají strukturovaná data FAQPage nebo QAPage | Odpovědní vyhledávače i rozšířené výsledky převezmou otázky a odpovědi mnohem spolehlivěji, když je stránka označí jako FAQPage nebo QAPage. | varování | každý krok s packem |
| HC902 | Pod H1 je krátký odstavec s odpovědí (40 až 320 znaků) | AI asistenti citují první jasnou odpověď, kterou najdou; krátký odstavec hned pod nadpisem je ten, který si vezmou. | varování | každý krok s packem |
| HC903 | Soubor llms.txt je v kořeni webu | llms.txt dává jazykovým modelům krátkou mapu webu: co nabízí a které stránky číst. | varování | každý krok s packem |
| HC904 | Stránka má meta popis | Bez meta popisu si vyhledávače i asistenti napíšou vlastní shrnutí z náhodného textu. | varování | každý krok s packem |
| HC905 | I bez JavaScriptu dostane GPTBot titulek, kanonickou adresu, H1, strukturovaná data a většinu textu | Většina AI crawlerů JavaScript nespouští. Co se objeví až po skriptech, pro ně neexistuje, i když stránka v prohlížeči vypadá hotová. | varování | každý krok s packem |
Přístupnost (a11y)
Část WCAG 2.2 AA, kterou jde na stránce změřit, průchod tabulátorem (bez klikání a psaní) a strom přístupnosti. Audit se čtečkou obrazovky nenahradí.
Běží i na designových prostředích.
| Id | Kontrola | Proč na ní záleží | Závažnost | Kde platí |
|---|---|---|---|---|
| HC301 | Obrázky mají alternativní text | Bez alt textu nevidomí ani vyhledávače nevědí, co obrázek ukazuje. | chyba | každý krok s packem |
| HC302 | Odkazy a tlačítka mají přístupný název | Tlačítko s ikonou bez názvu čtečka přečte jen jako „tlačítko“. | chyba | každý krok s packem |
| HC303 | Formulářová pole mají popisky | Uživatel čtečky uslyší u pole bez popisku jen „editační pole“. | chyba | každý krok s packem |
| HC304 | Úrovně nadpisů se nepřeskakují | Lidé se pohybují po nadpisech; skok z H2 na H4 zamlží strukturu. | varování | každý krok s packem |
| HC305 | Text splňuje kontrast WCAG AA | Text s nízkým kontrastem se špatně čte na slunci i lidem se slabším zrakem. | chyba | každý krok s packem |
| HC306 | Stránka má hlavní oblast (main) | Uživatelé čteček skáčou rovnou na <main>, aby přeskočili navigaci. | varování | každý krok s packem |
| HC307 | Id prvků jsou jedinečná | Duplicitní id rozbijí popisky, kotvy i skripty, které prvky hledají podle id. | varování | každý krok s packem |
| HC308 | Pořadí tabulátoru odpovídá stránce a dojde ke každému prvku | Kdo ovládá web klávesnicí, posouvá se tabulátorem; když fokus skáče nebo tlačítko vynechá, ztratí se nebo nemůže dál. | varování | každý krok s packem |
| HC309 | Fokus klávesnice je dobře vidět (kontrast aspoň 3 : 1) | Bez viditelného rámečku fokusu uživatel klávesnice neví, kde na stránce je. | varování | každý krok s packem |
| HC310 | Klávesnice nikde neuvízne | Prvek, který tabulátor nepustí ven (vložený přehrávač, vlastní menu), uživatele klávesnice uvězní. | chyba | každý krok s packem |
| HC311 | Odkaz pro přeskočení na obsah nebo rychlá cesta k němu | Bez odkazu „Přeskočit na obsah“ musí uživatelé klávesnice a čteček na každé stránce protabovat celé menu. | varování | každý krok s packem |
| HC312 | Ovládací prvky mají název ve stromu přístupnosti | Strom přístupnosti je to, co čtečky skutečně čtou; prvek bez názvu ohlásí jen jako „tlačítko“. | chyba | každý krok s packem |
| HC313 | Orientační oblasti jsou úplné a pojmenované | Uživatelé čteček skáčou mezi hlavičkou, navigací, obsahem a patičkou; neoznačené duplicity znějí všechny stejně. | varování | každý krok s packem |
| HC314 | Role a atributy ARIA jsou platné | Chybná ARIA je horší než žádná: čtečky jí věří a ohlašují, co na stránce není. | varování | každý krok s packem |
Použitelnost (usability)
Otázky pro evaluátor vybrané podle typu stránky kroku (page: landing, work, list, settings, form, doc) a popsaná formulářová pole.
Běží i na designových prostředích.
| Id | Kontrola | Proč na ní záleží | Závažnost | Kde platí |
|---|---|---|---|---|
| HC201 | Účel stránky je jasný hned na první obrazovce | Návštěvník se během pár vteřin rozhodne, jestli je na správném místě. | varování | typy stránek landing, doc |
| HC202 | Jedna jasná hlavní akce | Několik stejně výrazných tlačítek lidi zdrží; žádné je nechá bez dalšího kroku. | varování | typ stránky landing |
| HC203 | Formulářová pole mají viditelný popisek | Placeholder při psaní zmizí a lidé zapomenou, co do pole patří. | varování | každý krok s packem |
| HC204 | Odkazy a tlačítka říkají, co udělají | „Klikněte zde“ nebo „Více“ neřekne, kam vede, zvlášť mimo kontext nebo ve čtečce. | varování | každý krok s packem |
| HC205 | Z nadpisu je jasné, k čemu obrazovka je | Lidé mezi obrazovkami přepínají celý den; s mlhavým nadpisem musí hledat, kde vlastně jsou. | varování | typy stránek work, list, settings, form |
| HC207 | Každá položka seznamu říká, co je zač a jak ji otevřít | Řádek jen s identifikátorem nebo datem nutí lidi otevírat položky jednu po druhé. | varování | typ stránky list |
| HC208 | Každé nastavení říká, co změní a jak se uloží | Lidé odcházejí z nastavení a nevědí, jestli se změna projevila. | varování | typ stránky settings |
| HC206 | Je jasné, jak formulář odeslat a co bude dál | Když není jasné odesílací tlačítko nebo další krok, lidé odešlou dvakrát nebo to vzdají. | varování | typ stránky form |
| HC209 | Text jde rychle projít: nadpisy a krátké odstavce | Čtenář dokumentace hledá svou otázku očima; souvislý text odpověď schová. | varování | typ stránky doc |
Výkon (perf)
Laboratorní hodnoty změřené v prohlížeči průchodu: LCP, CLS, TTFB a velikost stránky. Skuteční návštěvníci na pomalejších telefonech mohou vidět jiná čísla.
Na designových prostředích, kde jsou kroky vaše vlastní HTML ze složky, je vypnutý. Pokud ho tam chcete, uveďte ho ve scénáři v health: { design_packs: [...] }.
| Id | Kontrola | Proč na ní záleží | Závažnost | Kde platí |
|---|---|---|---|---|
| HC401 | Největší obsah se vykreslí do 2,5 s | LCP je doba, než stránka působí hotově; Google ho používá při řazení. | varování | každý krok s packem |
| HC402 | Rozvržení se při načítání nehýbe (CLS pod 0,1) | Obsah, který při načítání poskakuje, svádí k ťuknutí vedle. | varování | každý krok s packem |
| HC403 | Server odpoví do 800 ms | Pomalý první bajt zdrží všechno ostatní na stránce. | varování | každý krok s packem |
| HC404 | Stránka má do 3 MB | Těžké stránky jsou pomalé a drahé na mobilních datech. | varování | každý krok s packem |
Konzole (console)
Evaluátor přečte chyby v konzoli kroku a řekne, jestli se týkají toho, co krok přijímá, nebo jde o šum cizích skriptů.
Na designových prostředích, kde jsou kroky vaše vlastní HTML ze složky, je vypnutý. Pokud ho tam chcete, uveďte ho ve scénáři v health: { design_packs: [...] }.
| Id | Kontrola | Proč na ní záleží | Závažnost | Kde platí |
|---|---|---|---|---|
| HC501 | Chyby v konzoli se netýkají toho, co krok přijímá | Odděluje skutečné chyby od šumu cizích skriptů (analytika, rozšíření). | chyba | každý krok s packem |
Chybové stránky (errors)
Pro stránky 404, 410, 500 a údržbu: skutečný chybový stav, cesta zpět a žádné technické podrobnosti navenek. Patří na kroky, které jsou chybovými stránkami.
Na designových prostředích, kde jsou kroky vaše vlastní HTML ze složky, je vypnutý. Pokud ho tam chcete, uveďte ho ve scénáři v health: { design_packs: [...] }.
| Id | Kontrola | Proč na ní záleží | Závažnost | Kde platí |
|---|---|---|---|---|
| HC601 | Odpovídá chybovým stavem (4xx/5xx), ne „měkkou“ 200 | Chybějící stránka s odpovědí 200 se zaindexuje jako obsah a skryje rozbité odkazy před monitoringem. | chyba | jen chybové stránky (expect_status nebo stránka s odpovědí 4xx/5xx) |
| HC602 | Odkazuje zpět na úvod | Slepá ulička návštěvníka ztratí. | varování | každý krok s packem |
| HC603 | Navigace nebo hledání zůstává dostupné | Lidé na chybové stránce chtějí najít, pro co přišli. | varování | každý krok s packem |
| HC604 | Žádný výpis chyby, SQL ani ladicí stránka | Výpisy chyb prozradí cesty, verze a dotazy, které pomáhají útočníkům. | chyba | každý krok s packem |
| HC605 | Chybu vysvětlí lidsky a nabídne cestu dál | Klidné vysvětlení udrží lidi na webu, místo aby odešli. | varování | jen chybové stránky (expect_status nebo stránka s odpovědí 4xx/5xx) |
| HC606 | V konzoli nejsou chyby | Skripty, které na chybové stránce padají, často rozbijí i její navigaci. | chyba | každý krok s packem |
Jazykové verze (locale)
Pro vícejazyčné weby: html lang, vlastní hreflang stránky, jazyk textu a desetinný oddělovač cen odpovídají procházenému jazyku. Jen ve scénářích, které uvádějí locales.
Běží i na designových prostředích.
| Id | Kontrola | Proč na ní záleží | Závažnost | Kde platí |
|---|---|---|---|---|
| HC1001 | html lang odpovídá procházenému jazyku | Čtečky podle html lang volí hlas a vyhledávače jazyk; německou stránku označenou jako anglickou čtečka přečte anglickým přízvukem. | varování | každý krok s packem |
| HC1002 | Vlastní hreflang stránky odpovídá jazyku, kódy jsou platné a sedí k adresám | Špatný vlastní hreflang nebo kód typu en_UK způsobí, že vyhledávač celou sadu jazykových verzí přeskočí. | varování | každý krok s packem |
| HC1003 | Text je v jazyce procházené verze | Nepřeložená stránka v jazykové verzi ztratí návštěvníky a pro vyhledávač vypadá jako duplicita zdrojového jazyka. | varování | každý krok s packem |
| HC1004 | Ceny používají desetinný oddělovač daného jazyka | Zápis 12.50 € působí na německého nebo českého zákazníka divně a 12,50 $ na amerického; vypadá to, že obchod nebyl dělaný pro ně. | varování | každý krok s packem |
| HC1005 | Každá stránka má v každém jazyce vlastní verzi (hreflang) | Stránka bez překladu pošle návštěvníky toho jazyka jinam a vyhledávač jim ukáže, co zbude; když víc stránek míří na jednu verzi, jde obvykle o náhradu výpisem nebo úvodní stránkou. | varování | stacky s items.variants: hreflang |
Obrazovky aplikací (app)
Nativní aplikace na Androidu, iOS a desktopu: popsané ovládací prvky, dotykové plochy, oříznutý text, pády a jasný další krok.
| Id | Kontrola | Proč na ní záleží | Závažnost | Kde platí |
|---|---|---|---|---|
| HC701 | Každý ovládací prvek má přístupný popisek | VoiceOver a TalkBack přečtou prvek bez popisku jen jako „tlačítko“. | chyba | každý krok s packem |
| HC702 | Dotykové plochy aspoň 48 dp / 44 pt | Malé plochy se minou, hlavně palcem a u starších lidí. | varování | každý krok s packem |
| HC703 | Žádné oříznuté texty (…) | Oříznutý text skryje ceny, jména nebo pokyny, často jen v delších jazycích. | varování | každý krok s packem |
| HC704 | Aplikace nespadla ani nezamrzla | Pád nebo hlášení „aplikace nereaguje“ ukončí práci. | chyba | každý krok s packem |
| HC705 | Účel obrazovky a další krok jsou jasné | Na malé obrazovce potřebují lidé hned vidět, co dál. | varování | každý krok s packem |
Reference designu (design)
Implementace proti schválené verzi designu: pixely, struktura a tokeny. Jediný pack, který se vždy počítá do přijetí, proto má id AC.
| Id | Kontrola | Proč na ní záleží | Závažnost | Kde platí |
|---|---|---|---|---|
| AC801 | Vypadá jako reference designu (rozdíl pod 3 % pixelů) | Viditelné rozdíly od schváleného designu znamenají, že se postavilo jinak, než se domluvilo. | akceptační kritérium | každý krok s packem |
| AC802 | Stejná struktura jako reference designu | Chybějící nadpisy, akce nebo pole mění, co lidé mohou udělat, i když to vypadá podobně. | akceptační kritérium | každý krok s packem |
| AC803 | Barvy, písma, velikosti a mezery pocházejí z tokenů | Ruční hodnoty se odchylují od design systému a zdražují pozdější změny. | akceptační kritérium | každý krok s packem |
Kontroly webu (site)
Jednou za web a běh, ne za krok: robots.txt, sitemapy, které uvádí, llms.txt a přesměrování na https a na jednu podobu domény. Vypnuté, dokud scénář nenastaví health: { site: true }, protože posílají vlastní požadavky. Nejde je převzít jako kritéria.
| Id | Kontrola | Proč na ní záleží | Závažnost | Kde platí |
|---|---|---|---|---|
| HC1101 | robots.txt odpovídá 200 a každý řádek dává smysl | Roboti přeskočí řádky, kterým nerozumí, takže překlep jako „Disalow“ potichu otevře nebo zavře část webu; chyba serveru procházení úplně zastaví. | varování | jednou za web |
| HC1102 | robots.txt neblokuje procházené úvodní stránky | Disallow, který zakryje úvodní stránku nebo kořen jazykové verze, vyřadí web z vyhledávání; často jde o nastavení ze stagingu, které se dostalo na produkci. | chyba na production, jinde varování | jednou za web |
| HC1103 | robots.txt neblokuje AI roboty | GPTBot, ClaudeBot, PerplexityBot a další se řídí robots.txt; když jsou zablokovaní, web se v odpovědích AI neobjeví a asistenti jeho stránky uživatelům neotevřou. | varování | jednou za web, jen na production |
| HC1104 | Sitemapy odpovídají, jsou platné a uvádějí úplné adresy z vlastní domény | Rozbitou nebo useknutou sitemapu, relativní adresy nebo cizí doménu vyhledávač ignoruje; vymyšlená data lastmod ho naučí ignorovat i je. | varování | jednou za web |
| HC1105 | Soubor llms.txt je v kořeni webu | llms.txt dává jazykovým modelům krátkou mapu webu: co nabízí a které stránky číst. | varování | jednou za web |
| HC1106 | http:// přesměruje na https:// jedním skokem | Každé přesměrování navíc stojí čas při každé první návštěvě a stránka dostupná přes http:// dělí odkazy i pozice mezi dvě adresy. | varování | jednou za web |
| HC1107 | Druhá podoba domény (s www nebo bez) přesměruje jedním skokem | Když odpovídá example.com i www.example.com, vidí vyhledávač dvě kopie webu; řetěz přesměrování zdrží každou návštěvu, která přijde druhou cestou. | varování | jednou za web |