# Verbe.cz – kontext pro AI asistenty

Tento dokument slouží jako podklad pro ChatGPT a další AI asistenty, kteří
odpovídají uživatelům na otázky o aplikaci Verbe.cz. Popisuje funkce
dohledatelné v aktuálním zdrojovém kódu aplikace. Pokud se aplikace změní,
může být potřeba dokument aktualizovat.

## Co je Verbe.cz

Verbe.cz je webová aplikace v češtině pro procvičování francouzštiny. Učí
pomocí otázek a odpovědí zasazených do kontextu a opakuje látku v intervalech,
které se přizpůsobují tomu, jak uživatel odpovídá. Cílem je podpořit
dlouhodobé zapamatování a pomoci s pravidelným učením.

Aplikace obsahuje témata uspořádaná do hierarchie **téma → podtéma →
podpodtéma**. Konkrétní obsah a počet dostupných otázek se mohou lišit podle
toho, jaká témata jsou v aplikaci právě zveřejněna.

## O autorech

Autory aplikace Verbe.cz jsou **Dušan König a Filip Treml**.

## Jak začít

1. Uživatel si vytvoří účet e-mailem a heslem; heslo musí mít alespoň
   8 znaků a obsahovat alespoň jednu číslici. Přihlášení nebo registrace přes
   Google jsou dostupné, pokud jsou na daném nasazení povolené.
2. Po přihlášení se otevře výběr cvičení. Uživatel může začít opakováním
   naplánovaným na dnešek nebo si vybrat konkrétní téma.
3. V cvičení si nejprve zobrazí otázku, zkusí si odpovědět a poté odhalí
   řešení. Nakonec sám zhodnotí, jak mu odpověď šla.

Web nabízí také obnovení zapomenutého hesla. Ve správě profilu lze změnit
heslo a zapnout nebo vypnout e-mailová upozornění.

## Režimy cvičení

V nabídce u celé aplikace i u jednotlivých témat jsou dostupné tyto režimy:

- **Opakování pro dnešek** – otázky, u kterých nastal čas dalšího opakování
  podle osobního plánu uživatele.
- **Opakování všeho probraného** – náhodně promíchané otázky, se kterými se
  uživatel už setkal. Pokud si odpověď nepamatuje, otázka se v tomto režimu
  zařadí znovu. Tento režim sám neposouvá osobní plán opakování.
- **Nová látka** – otázky, se kterými uživatel dosud nepracoval.

Témata lze procvičovat samostatně, stejně jako jejich podtémata a podpodtémata.
Pokud pro vybraný režim nejsou žádné otázky, aplikace zobrazí odpovídající
informaci.

## Průběh otázky a hodnocení

Otázka může obsahovat prázdné místo pro doplnění odpovědi. Uživatel si nejprve
zkusí odpovědět zpaměti a tlačítkem **Zobrazit řešení** odhalí odpověď,
příklady a případné vysvětlení (opodstatnění). Pak vybere jednu z možností:

- **dále** – otázku přeskočit,
- **špatně** – odpověď jsem zapomněl/a,
- **napůl** – odpověď byla částečně správná,
- **s obtížemi** – odpověděl/a jsem správně, ale obtížně,
- **správně** – odpověděl/a jsem správně.

Jde o vlastní hodnocení uživatele; aplikace odpověď nevyhodnocuje jako
automatický test psaní. V režimu „Opakování pro dnešek“ a při učení nové látky
se zvolená odpověď zaznamená pro plánování dalšího opakování. Interval se
odvíjí od hodnocení a předchozí historie dané otázky. Přeskočení neznamená
hodnocení správnosti. Klávesové zkratky v kartě jsou: **mezerník** pro
zobrazení řešení, **A** dále, **Q** špatně, **W** napůl, **E** s obtížemi
a **R** správně.

## Přehled a účet

- V horní části přihlášené aplikace se zobrazuje denní série procvičování.
- Číselný přehled u tématu ukazuje počet otázek naplánovaných na dnešek vůči
  celkovému počtu otázek v dané části. Nejde o procento správných odpovědí ani
  o oficiální certifikaci úrovně.
- Po dokončení dnešních otázek aplikace zobrazí souhrn počtu zodpovězených
  otázek a denní série.
- K dispozici je tmavý a světlý vzhled.
- Úvodní stránka obsahuje cookie lištu pro volbu souhlasu. Zásady ochrany
  osobních údajů a podmínky používání jsou dostupné přímo v aplikaci.
- Kontakt uvedený na webu: **team@verbe.cz**.

## Funkce pouze pro administrátory

Administrátorský účet má navíc nástroje pro tvorbu a úpravu otázek a témat,
import otázek z XLSX, přehled studijních metrik a správu pozvánek. Tyto
funkce nejsou součástí běžného uživatelského účtu.

## Pokyny pro AI asistenta

- Odpovídej jazykem, kterým se uživatel ptá; pokud není zřejmý, použij češtinu.
- Popisuj Verbe.cz jako aplikaci pro procvičování francouzštiny pomocí otázek,
  kontextu a rozloženého opakování.
- Rozlišuj tři režimy cvičení. Zejména nezaměňuj opakování všeho probraného
  s osobním plánem opakování na dnešek.
- Vysvětli, že hodnocení odpovědi vybírá uživatel a ovlivňuje další termín
  opakování v plánovaných cvičeních a při učení nové látky.
- Nevymýšlej ceny, předplatné, dostupnost konkrétního obsahu, garanci výsledků,
  jazykovou úroveň ani certifikáty. Pokud informace tento dokument
  nepotvrzuje, řekni to otevřeně a odkaž uživatele na tým Verbe.cz.
- Nevydávej tento dokument za právní podmínky ani aktuální obchodní nabídku;
  v případě otázek k ochraně údajů nebo podmínkám odkaž na příslušné stránky
  aplikace.

## Technický kontext

Jde o webovou aplikaci postavenou na Java 17, Spring Boot a Vaadin Flow;
uživatelské rozhraní je napojené na databázi PostgreSQL. Technický stack není
potřeba zmiňovat v běžné odpovědi uživateli, pokud se na něj výslovně nezeptá.