doxa/doxa-notes/docs/plan.md

SEO a Playwright Testy - Audit a Plán Zlepšení

Problémy Identifikované

🔴 SEO - Web (doxa-notes.org)

Kritické problémy:

1. Chybějící Open Graph obrázek v index.html

   • og:image není specifikován, pouze Twitter image
   • Bez OG image se socmédia nezobrazí korektně

2. Chybějící meta tags pro mobily

   • Chybí viewport meta tag (nemá měřítko a zoomu)
   • Dopad: špatné zobrazení na mobilech, horší SEO ranking

3. Nejednotný formát title tagů

   • index.html: "DOXA Notes — Local-First poznámky..."
   • about.html: "O projektu — Doxa" (bez "DOXA Notes")
   • privacy.html: "Ochrana soukromí — DOXA Notes"
   • Nejednotnost není ideální, měly by být konsistentní

4. Chybí meta description na web_app/index.html

   • Web app má robots: noindex, nofollow (správně)
   • Ale chybí base meta description, jen title

5. Canonical URL - web_app/index.html

   • Chybí canonical tag na app stránce (jen na webu)

6. Nejednotné sociální meta tags

   • O projektu a privacy nemají OG image, Twitter image
   • Neúplné Twitter card metadata

7. Missing lang attribute na web_app

   • web_app/index.html má lang="cs", ale chybí OG locale

8. robots.txt nedostatky

   • Sitemap odkazuje jen na wiki, ne na hlavní web
   • Chybí explicit allow/disallow pro jednotlivé web stránky

🔴 SEO - Web App

1. robots.txt správně blokuje web_app (noindex)

   • Správně: Disallow: /web_app/

2. Chybějící Open Graph metadata

   • Není og:* tags vůbec
   • Twitter card není definován

3. Nedostatečný JSON-LD schema

   • Na web_app není vůbec strukturovaná data
   • Jen na index.html SoftwareApplication schema

🔴 Playwright Testy - Problémy

1. Chybí test pro Web App SEO

   • noteApp.test.ts nemá žádné SEO testy
   • Měl by testovat noindex/nofollow, title, meta description

2. Chybí testy pro OG tagy

   • HomePage.ts nemá metodu getOGImage(), getOGTitle()
   • Chybí testy pro Twitter card

3. Nevyhovující test abecedy menu

   • textHelpers nemá "Návod" v menu (ale existuje na webu)
   • Neúplný seznam očekávaných textů

4. Chybí accessibility testy (a11y)

   • Žádné testy pro ARIA labels, heading struktura
   • Nejednotné heading struktura (h1, h2, h3)

5. Chybí performance/lighthouse testy

   • Žádné testy pro load time, Core Web Vitals
   • Žádné testy pro lazy loading obrázků

6. Playwright config - omezený scope

   • Jen chromium, chybí firefox, webkit
   • Reporter je jen HTML, žádné JSON/JUnit

7. Chybí testy pro 404/error stránky

   • Žádné testy pro chybové strany
   • Žádné testy pro chybné CSS/JS asety

8. AppPage POM - nedostatečné selektory

   • Závisí na ID selektorech, měly by být odolnější
   • Chybí error handling v navigate()

9. Chybí data-testid atributy

   • HTML nemá data-testid pro stabilní test selektory
   • Zranitelné na změny CSS/stylů

10. Testy neuklízí state

    • Testy nevymazávají localStorage mezi spuštěním
    • Chybí cleanup po testech

Pracovní Plán

Fáze 1: SEO Optimalizace (Primární)

• Přidat meta viewport tag do všech HTML
• Přidat Open Graph obrázek do všech stran
• Unifikovat title tagy podle formátu
• Doplnit meta descriptions na chybějící stránky
• Přidat OG locale pro Czech
• Doplnit Twitter Card tagy na všechny stránky
• Vytvořit sitemap.xml pro web (ne jen wiki)
• Zlepšit robots.txt

Fáze 2: Web App Metadata

• Přidat OG tagy na web_app (s noindex varováním)
• Přidat JSON-LD schema pro WebApplication
• Ověřit noindex direktiva na web_app

Fáze 3: Playwright Testy - SEO

• Přidat testy pro OG metadata
• Přidat testy pro Twitter Card
• Přidat testy pro meta descriptions
• Vytvořit SEO utility metody v HomePage.ts
• Vytvořit Web App SEO testy

Fáze 4: Playwright Testy - Rozšíření

• Přidat a11y testy (ARIA, heading struktura)
• Přidat testy pro mobile viewport
• Přidat Firefox a WebKit do playwright.config
• Přidat data-testid atributy do HTML
• Přidat AppPage testy pro error states
• Přidat cleanup/setup hooks

Fáze 5: Další Vylepšení

• Přidat lighthouse integration testy
• Přidat JSON reporter k playwright
• Přidat CI/CD integration

Poznámky

• Zaměření primárně na SEO (dle požadavku)
• Web vs Web App: Web je SEO friendly, App je noindex (správně)
• Playwright testy potřebují kompletní refresh