tomsej/pi-ext/wf-uat

/wf-uat — user acceptance testing

Argument: absolutní cesta ke kontraktu (mimo repo). Nikdy neměň kód, testy ani konfiguraci repa — vadu nahlas, opravy patří do implementace.

UAT NENÍ druhý běh gatů — gate už kritéria dokázal testy a jejich opakování (nebo šťouchání do interních API) vyrábí falešnou jistotu, ne novou informaci. Definice: pohled uživatele, jeho rozhraním, na běžící instanci — CLI jak by ho napsal, UI jak by klikal, API jak by volal.

Samostatná jednotka: pipeline ji volá jako poslední fázi, uživatel na ní iteruje sám. Vstup = cesta ke spec, výstup = český report.

Prostředí

• DISPOSABLE lokální instance, spuštěná obvyklým způsobem projektu (docker

compose, dev server, seedovaná lokální DB) — nikdy sdílené ani produkční prostředí.

• Volný ne-default port — paralelně můžou běžet UAT jiných kontraktů.
• Scénáře měnící stav jsou v sandboxu v pořádku — „neměň" platí na repo,

ne na data sandboxu.

• Všechno timeboxuj, instanci nakonec shoď, nenech běžet watch/dev server.
• Neumí-li projekt disposable instanci, napiš to — ty scénáře jdou do ručního

seznamu.

Postup

1. Přečti kontrakt: sekci UAT a všechna akceptační kritéria.
2. Odvoď scénáře: každé kritérium ≥ 1 scénář, plus explicitní UAT položky.

Jen uživatelský pohled (co vidí, píše, kam kliká). Scénář, který by jen zopakoval gate, přeskoč a označ jako pokrytý gatem.

1. Co umíš, proveď sám proti disposable instanci. Webové UI přes

agent-browser CLI, je-li nainstalované; bez něj jdou UI scénáře do ručního seznamu — nikdy nepředstírej průchod.

1. Report CELÝ ČESKY (PR je anglicky, tenhle report je pro uživatele — záměrně):

• co bylo ověřeno automaticky (scénář → výsledek, přesné příkazy/kroky),
• co pokrývá gate a UAT to neopakuje (kritérium → test),
• Ruční kroky pro uživatele: číslovaný postup — kde kliknout, co

spustit, co přesně čekat (jeden krok = jedno pozorovatelné chování),

• zbytková rizika / co UAT nepokrylo a proč.

1. Report vytiskni (patří do finálního reportu dirigenta), nikdy ho neposílej

jako komentář na PR. Každé kritérium se v něm musí objevit — nenamapované kritérium je nález, ne tiché přeskočení.