# Vývoj s AI

> Ako použiť dokumentáciu eKasy s AI asistentmi: stránky v Markdowne, llms.txt a llms-full.txt, špecifikácia OpenAPI a odporúčania pre zadanie.

Zdroj: https://ekasa.ninedigit.sk/docs/build-with-ai

Integráciu s eKasou môžete písať s pomocou AI asistenta, napríklad Claude, ChatGPT, GitHub Copilot alebo Cursor.
Asistent však o eKase vie len to, čo mu dáte. Dokumentácia je preto dostupná aj v čistom texte, ktorý mu jednoducho
vložíte.

## Dokumentácia pre asistenta

| Čo | Adresa | Kedy |
|---|---|---|
| jedna stránka | ikonka kopírovania vedľa prepínača jazyka, alebo adresa s príponou `.md`, napr. [`/docs/receipt-registration.md`](https://ekasa.ninedigit.sk/docs/receipt-registration.md) | otázka na konkrétnu tému |
| prehľad | [`/llms.txt`](https://ekasa.ninedigit.sk/llms.txt) | asistent si sám vyberie, ktoré stránky potrebuje |
| celá dokumentácia | [`/llms-full.txt`](https://ekasa.ninedigit.sk/llms-full.txt) | väčšia úloha, napríklad celá integrácia |
| popis API | `http://localhost:3010/swagger/v1/swagger.json` v nainštalovanej službe | presné názvy polí a typov |

Markdown verzie majú absolútne odkazy, pri variantoch označenie HTTP API alebo .NET knižnica a namiesto obrázkov
ich popis.

1. **Vyberte zdroj**
   Pre jednu tému skopírujte stránku, pre celú integráciu priložte `llms-full.txt` alebo jeho adresu.
2. **Pridajte kontext**
   Napíšte jazyk a prostredie vášho softvéru a či použijete HTTP API alebo .NET knižnicu.
3. **Overte výsledok**
   Kód vyskúšajte v integračnom prostredí s úložiskom In-Memory, nie na ostrej pokladnici.

## Príklad zadania

**HTTP API:**

```text
Pracujem na pokladničnom softvéri v PHP 8.3 pre slovenských podnikateľov. Tržby treba evidovať podľa slovenského zákona č. 384/2025 Z. z. o evidencii tržieb cez Nine Digit eKasu, certifikovaný pokladničný program eKasa klient. Napájam ju cez HTTP API na http://localhost:3010. Dokumentácia Nine Digit eKasy je na https://ekasa.ninedigit.sk/llms-full.txt (ak ju nevieš načítať, priložím ju).

Napíš funkciu, ktorá zaregistruje pokladničný doklad s položkami a platbami z môjho objektu Order, vyhodnotí isSuccessful (true, null, false) a uloží k objednávke unikátny identifikátor alebo OKP. Chyby spracuj podľa poľa code. Drž sa len toho, čo je v dokumentácii.
```

**.NET knižnica:**

```text
Pracujem na pokladničnom softvéri v C# (.NET 8) pre slovenských podnikateľov. Tržby treba evidovať podľa slovenského zákona č. 384/2025 Z. z. o evidencii tržieb cez Nine Digit eKasu, certifikovaný pokladničný program eKasa klient. Používam ju ako .NET knižnicu z NuGet balíka NineDigit.eKasa. Dokumentácia Nine Digit eKasy je na https://ekasa.ninedigit.sk/llms-full.txt (ak ju nevieš načítať, priložím ju).

Napíš metódu, ktorá zaregistruje pokladničný doklad s položkami a platbami z mojej triedy Order cez client.RegisterReceiptAsync, vyhodnotí IsSuccessful (true, null, false) a uloží k objednávke unikátny identifikátor alebo OKP. Klienta vytvor raz pre celú aplikáciu. Drž sa len toho, čo je v dokumentácii.
```

## Na čo pamätať

- **Kontrolujte, čo asistent napíše.** Za zaevidované tržby zodpovedá podnikateľ a za integráciu vy. Overte hlavne
  sadzby DPH, zľavy a vyhodnotenie výsledku.
- **Neposielajte asistentovi skutočné údaje** podnikateľa, autentifikačné údaje ani heslá. Na vývoj stačí
  integračný inicializačný balík.
- **Dokumentácia sa vyvíja.** Pri novej verzii eKasy dajte asistentovi aktuálny súbor, nie starú kópiu.

## Kam ďalej

- [Príprava prostredia](https://ekasa.ninedigit.sk/docs/environment-setup): Integračné prostredie a In-Memory úložisko na skúšanie.
- [Rozsah integrácie](https://ekasa.ninedigit.sk/docs/integration-scope): Čo má váš softvér vedieť.
- [HTTP API](https://ekasa.ninedigit.sk/docs/rest-api): Pravidlá komunikácie a referencia API.
