# eSodisce / GURS batch helper

Neuradna Firefox WebExtension za pomoč pri ponavljajočem se izpolnjevanju obrazca eSodisce/GURS. Različica `0.2.0` uporablja številčno šifro katastrske občine (KO), ne njenega imena.

## Varnostni obseg

- Razširitev ne obravnava certifikatov, zasebnih ključev, gesel ali PIN-ov.
- Ne avtomatizira prijav in ne poskuša zaobiti opozoril, CAPTCHA ali varnostnih kontrol.
- Izrecno dejanje uporabnika za zagon je potrebno v trenutnem zavihku.
- Razširitev je omejena na `https://esodisce.si/*`.
- Razširitev ne uporablja Firefox Downloads API-ja in ne shranjuje PDF-datotek; samo izpolni obrazec in pritisne gumb `btn_pdf`.

## Namestitev v Firefox

1. Odprite `about:debugging`.
2. Izberite **This Firefox** / **Ta Firefox**.
3. Kliknite **Load Temporary Add-on…**.
4. Izberite `manifest.json` v tej mapi oziroma v razširjenem ZIP-u.
5. Odprite ciljno stran `https://esodisce.si/evlozisce/javni_izpisi/list.html` in preverite, da je obrazec že dosegljiv.
6. Kliknite ikono razširitve; odpre se sidebar. Izberite TXT/CSV in zaženite obdelavo za trenutno aktivni zavihek v istem oknu.

Za spremembe datotek razširitev odstranite in jo znova naložite v `about:debugging`. Sidebar ostane odprt med uporabo strani in izbiro datoteke; zadnja uspešno prebrana datoteka se shrani v lokalno shrambo razširitve.

## Vhodna datoteka

Vsaka vrstica vsebuje dve polji: **številčno šifro KO** in **parcelno številko**. Podprta so ločila `;`, tabulator in vejica. Prvo polje mora biti pozitivno celo število; vodilne ničle se ohranijo kot del niza. Drugo polje ostane niz, zato so podprte oblike, kot je `901/29`.

```text
Šifra KO;Parcelna številka
2491;901/29
2491;901/30
0107;1820
```

Primeri v `example-input.txt` so samo formatni primeri. Ne predstavljajo preverjeno veljavnih parcelnih številk ali šifer KO. Prazne vrstice in vrstice, ki se začnejo z `#`, se preskočijo; prikazana glava se obravnava kot neveljavna vrstica.

## Kaj naredi

- poišče polji z dobesednima ID-jema `idZnakNep.katastrskaObcina.idsrcsifrant` in `idZnakNep.parcelnaStevilka`;
- v prvo polje neposredno vnese šifro KO ter sproži `input` in `change`;
- v drugo polje vnese parcelno številko;
- poišče gumb z dobesednim ID-jem `btn_pdf` in ga pritisne;
- ne prestreza, preimenuje ali shranjuje PDF-prenosov;
- podpira ročno potrjevanje pred vsakim zapisom ali samodejni način.

Če stran uporablja drug ID, iframe ali shadow DOM, bo potrebna prilagoditev. Trenutno je gumb namenoma izbran izključno z `document.getElementById('btn_pdf')`.

## Testni postopek

1. Zaženite `node --check` za `background.js`, `content-script.js` in `popup.js`.
2. Preverite, da je `manifest.json` veljaven JSON in da je različica `0.2.0`.
3. Najprej preverite en formatni testni zapis v načinu **ročno**.
4. V Firefox Developer Tools konzoli na strani `https://esodisce.si/evlozisce/javni_izpisi/list.html` preverite:
   ```javascript
   document.getElementById('idZnakNep.katastrskaObcina.idsrcsifrant')
   document.getElementById('idZnakNep.parcelnaStevilka')
   document.getElementById('btn_pdf')
   ```
5. Preverite, da se šifra KO in parcelna številka neposredno vneseta v obe polji, brez zahteve po izbiri autocomplete rezultata.
6. Preverite, da se vrednosti vnesejo v obe polji in da se pritisne gumb `btn_pdf`, brez ustvarjanja ali preimenovanja PDF-datotek.
7. Preverite napačen format šifre KO, manjkajoče polje in prekinitev med batchom.

Brez testiranja na dejanski strani ni mogoče potrditi popolne združljivosti z vsemi različicami obrazca.