✏️ Uredi ovu stranicu 📋 Povijest izmjena

Vodič za sudionike radne skupine

Ovaj vodič opisuje kako je organiziran proces pregleda i potvrde dokumentacije. Namijenjen je stručnjacima — programerima, računovođama, poreznim savjetnicima i predstavnicima Porezne uprave — koji žele doprinijeti reviziji sadržaja.

Sadržaj

1. Što je cilj procesa?

Dokumentacija obrađuje datumska polja, porezni tretman i prijedloge za validator u Fiskalizaciji 2.0. Svaki segment (H2 ili H3 sekcija) predstavlja jedno zaokruženo tumačenje koje može biti:

Konačni cilj jest da dokumentacija postane jedinstveni izvor istine koji i programeri, računovođe i Porezna uprava mogu navoditi s povjerenjem.

2. Kako je sve organizirano u GitHubu

Cijeli proces teče kroz GitHub — javno, transparentno i s trajnim audit trailom. Evo ključnih pojmova:

Pojam Značenje
Issue Jedan “zahtjev za reviziju” — postoji po jedan za svaki segment dokumentacije
Pull Request (PR) Prijedlog izmjene dokumenta — referencira Issue, nakon odobrenja se primjenjuje
Label Oznaka na Issue-u (stranica, tip, status, prioritet) — omogućuje filtriranje
Milestone Grupa Issueova vezana za konkretan sastanak (npr. “Sastanak 1 — 20.04.2026.”)
Project Board Kanban tablica sa stupcima koja prikazuje gdje je koji Issue

Svaki segment dokumentacije ima stabilni ID u obliku sec-xxx koji se ne mijenja čak i kada se naslov ispravi. ID je osnova za povezivanje Issueova, PR-ova i segmenata.

3. Stanja revizije (Kanban stupci)

Svaki segment prolazi kroz jedno od sljedećih stanja:

Stanje Kada ovdje Tko djeluje
🟡 Za pregled Segment postoji, nitko još nije započeo pregled Bilo tko može započeti
🔵 U reviziji Aktivna rasprava u Issue-u Sudionici rasprave
⏸️ Čeka Poreznu upravu Raspravljeno, čeka službeno pojašnjenje PU Predstavnik PU
🟢 Potvrđeno Odobreno i primijenjeno u dokumentaciji —
⚠️ Traži izmjenu Uočeno da segment treba ispraviti Autor PR-a
⚪ Izvan revizije Autorski sadržaj, uvod, vodič — po defaultu ne traži reviziju Opcionalno
❌ Odbačeno Odlučeno da se segment briše ili ne uključuje —

4. Kada koristiti Issue, a kada Discussion?

GitHub nudi dva različita alata za komunikaciju: Issues i Discussions. Oba su dostupna u ovom projektu i imaju različite svrhe.

Kriterij Issues Discussions
Vezano za Konkretan segment (H2 / H3 s ID-em sec-xxx) Opću temu, pitanje, iskustvo
Životni ciklus Otvoren → U reviziji → Potvrđeno / Zatvoreno Nema — rasprava teče dok god postoji interes
Automatizacija Ulazi u Kanban ploču, mijenja badge na stranici, broji se u dashboard Nema automatskog praćenja statusa
Kada koristiti Traženje pregleda, ispravak, potvrda, prijedlog promjene jednog segmenta Šira pitanja, iskustva iz prakse, prijedlozi za nove sekcije, “brain-storming”
Pretraga Filtrirati se može po oznakama (label) — stranica, status, tip Filtrirati se može po kategorijama
Tko odgovara Urednik ili recenzent donosi odluku Cijela zajednica diskutira

Primjeri kada koristiti Issue

Primjeri kada koristiti Discussion

Što ako nisam siguran?

Pravilo palca: ako se tvoja napomena veže za konkretan naslov sekcije, otvori Issue. Ako se veže za širu temu ili više segmenata istovremeno, otvori Discussion. Ako kasnije ispadne da trebaš drugo, moderator može prebaciti Discussion u Issue (ili obratno).

Otvori ih ovdje:

5. Kako započeti reviziju jednog segmenta

Korak 1: Pronađite segment koji vas zanima

Otvorite listu Issueova:

→ github.com/dageci/eracun-fiskalizacija-datumi/issues

Filtrirati možete po:

Korak 2: Pročitajte segment u dokumentaciji

U Issue-u se nalazi poveznica na točnu sekciju dokumentacije. Klik na nju otvara stranicu pozicioniranu na odgovarajući naslov.

Korak 3: Ostavite komentar na Issue-u

Ovdje postoje tri mogućnosti:

A) Potvrda ispravnosti

Ako smatrate da je sadržaj ispravan:

“Potvrđujemo. Sadržaj odgovara važećim propisima i praksi.”

Ako želite, dodajte kratko obrazloženje i izvor (npr. članak zakona, odluku CJEU, službenu uputu).

B) Prijedlog izmjene

Ako uočite pogrešku ili predlažete poboljšanje:

“Predlažemo izmjenu: [opis što biste promijenili]. Razlog: [tehnički/pravni/praktični]. Izvor: [poveznica na zakon, specifikaciju, odluku].”

C) Zahtjev za pojašnjenje

Ako niste sigurni što autor misli:

“Molimo pojašnjenje: [pitanje].”

Korak 4: Rasprava

Ostali sudionici mogu odgovoriti, potvrditi vaše stajalište ili predložiti alternativu. Cilj je postići konsenzus prije bilo kakve izmjene dokumenta.

Korak 5: Izmjena

Kada se postigne konsenzus, izmjena se primjenjuje kroz Pull Request. Autor dokumentacije ili bilo koji drugi sudionik otvara PR koji:

PR mora biti odobren od odgovornog recenzenta prije nego što se spoji u glavnu verziju.

6. Kako sudjelovati u PR reviziji

Ako ste označeni kao recenzent Pull Requesta:

Pregled promjene

Davanje povratne informacije

Kliknite Review changes i odaberite jednu od tri opcije:

Komentari se mogu ostaviti na konkretne linije diff-a — klik na broj linije → strelica → polje za komentar.

7. Kako otvoriti novi Issue (ako još ne postoji)

Većina Issueova je već automatski generirana za postojeće segmente. Ako uočite:

možete otvoriti novi Issue:

→ github.com/dageci/eracun-fiskalizacija-datumi/issues/new/choose

Odaberite template “Revizija segmenta dokumentacije” i ispunite polja.

8. Sastanci radne skupine

Organizacija

Periodično se organiziraju radni sastanci (uživo ili putem video poziva) na kojima se prolazi skupina segmenata. Svaki sastanak ima Milestone u GitHubu (npr. Sastanak 1 — 20.04.2026.) s popisom Issueova za obradu.

Prije sastanka

Tijekom sastanka

Nakon sastanka

9. Kako se AI asistenti uključuju u proces

Za tehnički složenije izmjene — osobito kod Mermaid dijagrama, tablica, XML primjera ili HTML vizualizacija — sudionici mogu zatražiti pomoć autora koji se služi modernim AI asistentima (umjetna inteligencija specijalizirana za razvoj softvera i dokumentacije) za primjenu dogovorenih izmjena.

Tipičan tok:

  1. U Issue-u se postigne konsenzus
  2. Autor otvara AI asistenta s pristupom repozitoriju
  3. Referencira Issue i opisuje dogovorenu izmjenu
  4. AI primjenjuje izmjenu, sprema (commit) i otvara PR koji referencira Issue
  5. Sudionici pregledavaju PR i odobravaju ili traže daljnje izmjene

Ovaj pristup je posebno koristan kada izmjena zahvaća Mermaid dijagrame ili druge vizualne elemente koje je teško editirati ručno. Krajnju odluku o prihvaćanju izmjene uvijek donose ljudi — AI je samo alat koji ubrzava mehanički dio posla.

10. Česta pitanja

Trebam li biti programer da sudjelujem?

Ne. GitHub korisničko sučelje omogućuje komentiranje, potvrdu i otvaranje Issueova bez ikakvog programerskog znanja. Potrebno je samo:

Trebam li instalirati nešto?

Ne. Sve se radi kroz web preglednik na github.com.

Što ako primijetim pogrešku izvan svog stručnog područja?

Ostavite komentar na odgovarajućem Issue-u. Netko tko razumije temu će pristupiti raspravi.

Kako mogu pratiti što se događa?

Na GitHubu kliknite Watch na repozitoriju i odaberite razinu obavijesti. Dobivat ćete email za svaku aktivnost ili samo za teme u kojima sudjelujete. Detalji: Email obavijesti.

Što ako se ne slažem s donesenom odlukom?

Otvorite novi Issue ili komentirajte postojeći. Odluke se mogu preispitati. Git povijest čuva sve prethodne verzije.

11. Dodatni resursi

Hvala što doprinosite ovoj inicijativi. Svaka stručna potvrda, ispravka ili pitanje doprinosi da dokumentacija postane pouzdan referentni izvor za sve koji rade s eRačunima u Hrvatskoj.

Je li ova stranica bila korisna?

👍 Da, korisno 👎 Može bolje 💬 Imam pitanje