dbPrompt/AGENTS.md

AGENTS.md

Tento subor je prakticky navod pre AI agentov a contributorov v projekte dbPrompt.

1. Ciel projektu

dbPrompt je jednoducha web aplikacia na spustanie SQL dotazov nad MySQL s historiou vykonanych dopytov.

2. Struktura projektu

• dbPrompt.go: backend server (Go, net/http), API endpointy aj praca s historiou.
• index.html: cely frontend (HTML + CSS + JavaScript v jednom subore).
• static/: staticke assety (napr. logo).
• history/: JSON subory s historiou dopytov.
• config.json: DB konfiguracia pre lokalny beh.
• build.bat: build pre Windows/Linux binarky do dist/.

3. Lokalny beh a overenie

1. Skontroluj config.json (lokalne MySQL udaje).
2. Spust aplikaciu:
   • go run dbPrompt.go
3. Otvor:
   • http://localhost:8080
4. Pred odovzdanim zmien spusti:
   • go test ./...

Poznamka: V projekte aktualne nie su unit testy, ale go test ./... overi aspon build.

4. API kontrakt (nezlomit bez poziadavky)

• GET /history/: vracia historiu ako JSON pole, zoradene od najstarsich.
• POST /query: prijme { id, query }, vykona SQL, vrati QueryResult.
• DELETE /history/{id}: zmaze jeden zaznam historie.

QueryResult klucove polia:

• id, query, timestamp
• duration (ms)
• error alebo vysledok (columns, rows) alebo rowsAffected

Ak menis schema odpovede, zosulad backend aj frontend naraz.

5. Pravidla pre zmeny

• Zachovaj jednoduchu architekturu (single-file backend + single-file frontend), pokial nie je explicitna poziadavka na refactor.
• Preferuj male, cielene zmeny bez "cleanupu navyse".
• Pri zmenach endpointov vzdy uprav aj frontend render a nacitanie historie.
• Pri praci s cestami zachovaj sanitizaciu ID (filepath.Base) kvoli directory traversal.
• Nezavadzaj nove zavislosti bez dovodu.

6. Bezpecnost a data

• Nikdy necommituj realne prihlasovacie udaje do DB.
• config.json je lokalny runtime subor; citlive hodnoty maskuj v ukazkach.
• SQL sa vykonava priamo zo vstupu uzivatela. Ak by si pridaval funkcionalitu, zvaz oddelenie read-only rezimu alebo aspon jasne varovanie v UI.

7. Frontend poznamky

• UI je event-delegated cez mainContainer.addEventListener('click', ...).
• Historicke bloky maju tlacidlo Delete; "new-query-block" ho nema, kym query neuspesne/neuspesne neprebehne.
• Collapsible tabulky pouzivaju .collapsible-header a .collapsible-content.

Pri zmenach vizualu zachovaj funkcnost:

• run query
• delete history item
• load history po starte
• collapse/expand individualne aj globalne

8. Definition of done pre kazdu upravu

1. Zmena funguje funkcne v UI/API.
2. go test ./... prejde.
3. Nemas neplanovane zmeny mimo scope zadania.