first commit

README.md

@@ -0,0 +1,63 @@
+# 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.