Mapa screenshotů a UI
Screenshoty mají vysvětlovat reálné produktové workflow. Nemají stránku jen zdobit. Každý screenshot potřebuje jasný účel, prostředí pořízení a datum review.
Pravidla pro screenshoty
Sekce “Pravidla pro screenshoty”| Pravidlo | Důvod |
|---|---|
| Používat realistická demo data. | Prázdné obrazovky nevysvětlují workflow. |
| Ořezávat jen tehdy, když okolní UI není důležité. | Uživatel potřebuje poznat, kde se nachází. |
| Nepoužívat soukromá klientská data. | Dokumentace se může sdílet s prospecty nebo více klienty. |
| Držet stabilní název souboru. | Existující odkazy mají přežít obnovu obrázku. |
| Zapsat kontext pořízení. | Reviewer musí vědět, jestli je obrázek aktuální. |
Povinný inventář screenshotů
Sekce “Povinný inventář screenshotů”| Oblast | Screenshot | Účel | Navržený soubor |
|---|---|---|---|
| Start | Dashboard company space | Ukazuje první provozní vstup. | /screenshots/client/dashboard.png |
| Uživatelé | Seznam uživatelů s filtry | Vysvětluje hledání, stav, roli a bulk operace. | /screenshots/client/users-list.png |
| Uživatelé | Detail uživatele | Ukazuje roli, stav, metadata, skupiny a školení. | /screenshots/client/user-detail.png |
| Skupiny | Detail skupiny | Ukazuje členství a přiřazený obsah. | /screenshots/client/group-detail.png |
| Obsah | Seznam obsahu | Ukazuje vlastní a koupený obsah v prostoru. | /screenshots/client/content-list.png |
| Obsah | Detail verze | Vysvětluje aktivní verze a riziko upgrade. | /screenshots/client/content-version.png |
| Přiřazení | Formulář nebo detail přiřazení | Ukazuje přímé a skupinové přiřazení. | /screenshots/client/assignment-detail.png |
| Student | Přiřazené školení | Ukazuje, co student dostane. | /screenshots/client/learner-assigned-learning.png |
| Student | Dokončení a certifikát | Ukazuje potvrzení dokončení a stav certifikátu. | /screenshots/client/learner-completion.png |
| Reporting | Report dokončenosti | Ukazuje stav, termín a exportovatelná data. | /screenshots/client/reporting-completion.png |
| Integrace | API credential nebo webhook setting | Ukazuje, co nastavuje administrátor. | /screenshots/client/integration-settings.png |
Checklist pořízení
Sekce “Checklist pořízení”U každého screenshotu zapsat:
- datum pořízení,
- prostředí,
- roli uživatele použitého pro pořízení,
- relevantní feature flag nebo konfiguraci,
- URL zdrojové stránky,
- reviewera,
- jestli screenshot obsahuje generovaná demo data nebo reálná anonymizovaná data.
Mapa UI
Sekce “Mapa UI”flowchart TD Dashboard[Dashboard] --> Users[Uživatelé] Users --> UserDetail[Detail uživatele] Dashboard --> Groups[Skupiny] Groups --> GroupDetail[Detail skupiny] GroupDetail --> GroupAssignments[Přiřazení skupiny] Dashboard --> Content[Obsah] Content --> ContentDetail[Detail obsahu] ContentDetail --> Versions[Verze] Dashboard --> Reporting[Reporting] Reporting --> Exports[Exporty] Dashboard --> Integrations[API credentials a webhooky] UserDetail --> LearnerView[Pohled studenta] LearnerView --> Certificate[Certifikát]
Chybějící screenshoty
Sekce “Chybějící screenshoty”Dokud screenshot není pořízený, má stránka u dané sekce použít tuto formulaci:
Screenshot needed: popsat přesnou obrazovku, roli a stav, který se má zachytit.