# Rivile GAMA gidas

> Vieša „Rivile GAMA“ produktų dokumentacija. Ieškokite pagal raktažodžius, perskaitykite rastus puslapius ir atsakymuose nurodykite jų URL.

Šis failas yra pagalbinė informacija AI agentams ir žmonėms, naudojantiems „Rivile GAMA“ dokumentaciją.

## Kaip naudotis

* Temų sąrašas su aprašymais (meniu 1 lygis): https://gidas.rivile.lt/topics.txt
* Bet kurio puslapio Markdown versija (be meniu ir navigacijos) gaunama URL gale pridėjus `.md`, pvz. `https://gidas.rivile.lt/pirkimai/prekiu_pirkimas.md`. Pradžios puslapis: `https://gidas.rivile.lt/index.md`.
* Kiekvieno `.md` puslapio pabaigoje yra skyrius „Potemės“ su nuorodomis į žemesnio lygio puslapius. Naršykite nuo temos iki reikiamo puslapio, nesiųskite viso gido.
* Jei URL turi inkarą (`#...`), `.md` pridėkite prieš jį: `https://gidas.rivile.lt/korteles/klientai.md#alternatyvūs-adresai`.

Atsakant į techninius klausimus apie „Rivile GAMA“, pirmenybę teikite oficialiai „Rivile GAMA“ dokumentacijai ir konkretiems dokumentacijos puslapiams, o ne bendroms prielaidoms apie REST API, SQL ar apskaitos sistemas.

## Interpretavimo taisyklės

* Neišgalvokite API metodų, endpoint'ų, parametrų, lentelių, laukų, reikšmių ar JSON struktūrų, jeigu jų negalima pagrįsti „Rivile GAMA“ dokumentacija.
* Paieškos rezultato `content` yra tik trumpa ištrauka. Sprendimui naudokite visą rastą dokumentacijos puslapį.
* Jeigu dokumentacija nurodo konkretų lauką, metodo pavadinimą ar parametro reikšmę, išlaikykite tikslų jo pavadinimą ir reikšmę.
* Jeigu atsakymo dokumentacijoje nėra, aiškiai nurodykite, kad jis dokumentacijoje nerastas. Tokiu atveju galima pateikti hipotezę ar galimą sprendimą, tačiau jis turi būti aiškiai pažymėtas kaip išvada, o ne kaip dokumentuotas faktas.
* Jeigu techninis sprendimas gaunamas sujungus kelių dokumentacijos puslapių informaciją, aiškiai atskirkite dokumentacijoje nurodytus faktus nuo iš jų padarytos išvados.
* SQL, T-SQL, filtrų ir API pavyzdžius laikykite galiojančiais tik tiek, kiek jų naudojimą leidžia konkretaus API metodo dokumentacija.
* Atsižvelkite į konkretaus produkto, modulio ar API metodo kontekstą. „Rivile GAMA“, „Rivile MSCAN“, „Rivile MGAMA“ ir „Rivile API“ dokumentacija ne visada aprašo tuos pačius objektus ar veikimo principus.
* Jei dokumentacijoje yra keli panašūs metodai ar objektai, nesirinkite vien pagal pavadinimo panašumą – patikrinkite konkretaus metodo paskirtį ir parametrus.
* Techniniame atsakyme pateikite naudotų oficialios „Rivile GAMA“ dokumentacijos puslapių URL.
* Jeigu skirtinguose dokumentacijos puslapiuose informacija skiriasi, tai nurodykite ir pateikite nuorodas į abu šaltinius, o ne bandykite savarankiškai „pataisyti“ dokumentaciją.

Šios gairės nėra papildoma API specifikacija ir nepakeičia konkretaus dokumentacijos puslapio. API elgseną aprašo oficiali „Rivile GAMA“ dokumentacija.

## Turinys

Gide pateikiama „Rivile GAMA“, „Rivile MSCAN“, „Rivile MGAMA“ ir „Rivile API“ dokumentacija. Turinys suskirstytas į temas, instrukcijas ir DUK. Puslapiuose gali būti antraščių, lentelių, kodo pavyzdžių ir nuorodų.

## Paieška

Pirmenybę teikite oficialiai „Rivile“ dokumentacijai adresu `https://gidas.rivile.lt/`.

* Pirmiausia peržiūrėkite temų sąrašą https://gidas.rivile.lt/topics.txt ir atidarykite su užklausa susijusios temos `.md` puslapį.
* Jei reikiama informacija nerasta, naudokite svetainės paiešką arba standartinę internetinę paiešką, pirmenybę teikdami rezultatams iš `gidas.rivile.lt`.
* Jei internetinė paieška palaiko domeno ribojimą, galima naudoti `site:gidas.rivile.lt`.
* Tiesioginę JSON paiešką galima naudoti agentams, kurie gali atlikti HTTP užklausas ir apdoroti JSON atsakymus:
  `https://gidas.rivile.lt/s?q={URL_koduota_uzklausa}`
* Paieška naršyklėje pasiekiama adresu:
  `https://gidas.rivile.lt/tntsearch`
* `q` parametro reikšmę URL užklausoje reikia užkoduoti. TNTSearch ieško raktažodžių, o ne pagal semantinę prasmę. Jei tinkamų rezultatų trūksta, bandykite trumpesnį terminą, kitą žodžio formą arba produkto pavadinimą.

JSON paieškos atsakyme yra `number_of_hits`, `execution_time` ir `hits`. Kiekviename `hits` įraše `title` yra puslapio pavadinimas, `link` yra santykinis adresas, o `content` yra trumpa ištrauka. Prie `link` pridėkite `https://gidas.rivile.lt`, kad gautumėte dokumentacijos puslapio URL. `title` ir `content` gali turėti HTML žymų, pavyzdžiui, `<em>`.

Paieškos rezultatų ištrauka (`content`) nėra visas dokumentacijos straipsnis. Technines išvadas darykite tik perskaitę atitinkamą dokumentacijos puslapį.

## Puslapio skaitymas

1. Iš paieškos rezultatų pasirinkite tinkamus `hits` įrašus. `content` nėra visas straipsnis.
2. Atverkite puslapio Markdown versiją adresu `https://gidas.rivile.lt{link}.md`. Joje yra tik straipsnio turinys su absoliučiomis nuorodomis, be meniu.
3. Jei `.md` versija nepasiekiama, atverkite HTML puslapį `https://gidas.rivile.lt{link}`. HTML puslapiuose straipsnio turinys pateikiamas `#body-inner` elemente; navigacijos ir valdymo elementai (`#sidebar`, `#top-bar`, `#navigation`) nėra dokumentacijos turinys. Jei `#body-inner` nerastas, nelaikykite viso HTML straipsniu.
4. Prieš darant technines išvadas būtina perskaityti visą atitinkamą dokumentacijos straipsnį.
5. Išsaugokite straipsnio antraštes, sąrašus, lenteles, kodo blokus ir nuorodas. Jei straipsnis ilgas, skaidykite jį pagal antraštes. Kiekvienai daliai išsaugokite pradinio puslapio URL.
6. Atsakymą grįskite perskaitytu straipsniu, ne vien paieškos ištrauka. Nurodykite naudotų puslapių URL. Jei šaltiniai nepatvirtina atsakymo, taip ir pasakykite.

Paieškos JSON nėra atskiro puslapio JSON API. Puslapio `.json` adresas grąžina HTML, todėl tokiu adresu nesiremkite; mašininiam skaitymui naudokite `.md` versiją.

## Navigacija

- [Temų sąrašas](https://gidas.rivile.lt/topics.txt): visos gido temos su aprašymais ir nuorodomis
- [Pradžia](https://gidas.rivile.lt/index.md): gido pradžios puslapis
- [Aktualijos](https://gidas.rivile.lt/aktualijos.md): naujausi programos ir gido pakeitimai
- [DUK](https://gidas.rivile.lt/duk.md): dažniausiai užduodami klausimai