/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
- Přečti kontrakt: sekci UAT a všechna akceptační kritéria.
- 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.
- 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.
- 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č.
- 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í.
1---2name: wf-uat3description: UAT fáze workflow kontraktu — odvodí scénáře z UAT sekce a akceptačních kritérií, spustí je proti disposable instanci a dodá české ruční kroky pro uživatele. Volá ji wf-impl při uat auto, nebo uživatel ručně s cestou ke spec.4---56# /wf-uat — user acceptance testing78Argument: absolutní cesta ke kontraktu (mimo repo). Nikdy neměň kód, testy ani9konfiguraci repa — vadu nahlas, opravy patří do implementace.1011UAT NENÍ druhý běh gatů — gate už kritéria dokázal testy a jejich opakování12(nebo šťouchání do interních API) vyrábí falešnou jistotu, ne novou informaci.13Definice: **pohled uživatele, jeho rozhraním, na běžící instanci** — CLI jak by14ho napsal, UI jak by klikal, API jak by volal.1516Samostatná jednotka: pipeline ji volá jako poslední fázi, uživatel na ní17iteruje sám. Vstup = cesta ke spec, výstup = český report.1819## Prostředí2021- DISPOSABLE lokální instance, spuštěná obvyklým způsobem projektu (docker22 compose, dev server, seedovaná lokální DB) — nikdy sdílené ani produkční23 prostředí.24- Volný ne-default port — paralelně můžou běžet UAT jiných kontraktů.25- Scénáře měnící stav jsou v sandboxu v pořádku — „neměň" platí na repo,26 ne na data sandboxu.27- Všechno timeboxuj, instanci nakonec shoď, nenech běžet watch/dev server.28- Neumí-li projekt disposable instanci, napiš to — ty scénáře jdou do ručního29 seznamu.3031## Postup32331. Přečti kontrakt: sekci **UAT** a všechna **akceptační kritéria**.342. Odvoď scénáře: každé kritérium ≥ 1 scénář, plus explicitní UAT položky.35 Jen uživatelský pohled (co vidí, píše, kam kliká). Scénář, který by jen36 zopakoval gate, přeskoč a označ jako pokrytý gatem.373. Co umíš, proveď sám proti disposable instanci. Webové UI přes38 `agent-browser` CLI, je-li nainstalované; bez něj jdou UI scénáře do39 ručního seznamu — nikdy nepředstírej průchod.404. Report CELÝ ČESKY (PR je anglicky, tenhle report je pro uživatele — záměrně):41 - co bylo ověřeno automaticky (scénář → výsledek, přesné příkazy/kroky),42 - co pokrývá gate a UAT to neopakuje (kritérium → test),43 - **Ruční kroky pro uživatele**: číslovaný postup — kde kliknout, co44 spustit, co přesně čekat (jeden krok = jedno pozorovatelné chování),45 - zbytková rizika / co UAT nepokrylo a proč.465. Report vytiskni (patří do finálního reportu dirigenta), nikdy ho neposílej47 jako komentář na PR. Každé kritérium se v něm musí objevit — nenamapované48 kritérium je nález, ne tiché přeskočení.
tomsej