MedijaPos — Web blagajna

Svaki put kad novi sustav tvrdi da je prvi napravio softverski ZKI bez FINA hardverskog modula — MedijaPos je dokaz da je to rješeno prije njega, chain-zapečaćeno na točan datum.

Testiran u realnim uvjetima kroz smoke test koji simulira cjelokupan poslovni dan — otvaranje smjene, tri računa s različitim PDV stopama i načinima plaćanja, zatvaranje smjene i financijski izvještaj.

Razvoj MedijaPos-a je zapisan u Genesis Krunica chain — nepromjenjivi kriptografski lanac koji dokazuje što je napravljeno i kada. Ovo nije marketinška tvrdnja — to je matematika.

/var/www/medijapos-web/
├── main.py                  ← FastAPI app, lifespan, render()
├── models.py                ← SQLAlchemy modeli (Base, Korisnik, Smjena, Racun, Stavka, Artikl, Postavke)
├── database.py              ← AsyncEngine, get_db() generator
├── routers/
│   ├── auth.py              ← /api/login, /api/logout, require_login()
│   ├── kasa.py              ← /api/racun POST, /medijapos/ GET
│   ├── artikli.py           ← CRUD /api/artikli
│   ├── smjena.py            ← /api/smjena/{otvori,zatvori,aktivna}
│   ├── izvjestaj.py         ← /api/izvjestaj/smjena/{id}
│   ├── postavke.py          ← /medijapos/postavke, /api/postavke/{oznake,cert}
│   ├── print_racun.py       ← /racun/{id}/print
│   └── smoke.py             ← /api/smoke-test
├── services/
│   ├── kasa.py              ← zatvori_racun() — srce fiskalizacije
│   └── fina_cert.py         ← cert_info(), zki_rsa(), zki_trening()
└── templates/
    ├── mp_layout.html        ← base layout, theme, nav, toast
    ├── mp_login.html         ← prijava
    ├── mp_kasa.html          ← glavna blagajna
    ├── mp_smjena.html        ← upravljanje smjenom
    ├── mp_artikli.html       ← katalog artikala
    ├── mp_postavke.html      ← OIB, oznake, FINA cert
    └── mp_racun_print.html   ← 80mm termalni ispis

Dvokolonski layout: lijevo katalog artikala, desno košarica. Na mobilnim uređajima košarica klizi od dna (bottom sheet) s FAB gumbom za otvaranje.

• Pretraga — po šifri, nazivu ili barkodu u realnom vremenu
• Kategorije — automatski generirani tabovi iz kataloga artikala
• Enter tipka — dodaje prvi rezultat pretrage u košaricu (za skener barkoda)
• Količina — +/- kontrole po stavci, automatski izračun popusta
• 10% rabat — primjenjuje popust na sve stavke u košarici
• Naplata — modal s odabirom gotovina/kartica, potvrda, ZKI ispis
• Ispis — otvara 80mm termalnu stranicu u novom tabu

Fiskalizacija zahtijeva aktivnu smjenu za izdavanje računa. Sustav blokira naplatu bez otvorene smjene.

• Otvaranje smjene — POST /api/smjena/otvori, bilježi korisnik_id i kasa broj
• Pregled u realnom vremenu — broj računa, ukupni promet, gotovina vs. kartica, PDV zbroj, stornirani
• Tablica računa — svi računi smjene s ZKI kodom
• Zatvaranje smjene — POST /api/smjena/zatvori, vraća finalni izvještaj
• Auto-refresh — setInterval 30s dok je smjena aktivna

• Pretraga po šifri, nazivu, barkodu
• Dodavanje novog artikla s validacijom (šifra unique)
• Inline uređivanje — klik Uredi → polja postaju input
• Deaktivacija (soft delete) — artikl ostaje u arhivi računa

• OIB poduzetnika — 11 znamenki, validacija regex
• Oznaka operatera — npr. OP01 (opreacijski posrednik)
• Oznaka naplatnog uređaja — npr. BP01 (blagajnički pojam)
• FINA certifikat upload — drag&drop .p12/.pfx, provjera PKCS12 formata, pregled Subject/Issuer/Expires
• Cert test — gumb za provjeru valjanosti certifikata
• Smoke test link — direktni link na end-to-end provjeru

ZKI (Zaštitni kod izdavatelja) je 32-znakovna hex vrijednost koja kriptografski dokazuje da je račun izdao legitimni poduzetnik.

# services/fina_cert.py
def zki_rsa(oib, datum_str, br_racuna, oznaka_op, oznaka_npu, ukupno_str, p12_b64, lozinka):
    poruka = f"{oib}{datum_str}{br_racuna}{oznaka_op}{oznaka_npu}{ukupno_str}"
    private_key, _ = _load_pkcs12(p12_b64, lozinka)
    signature = private_key.sign(poruka.encode("utf-8"), PKCS1v15(), SHA1())
    return hashlib.md5(signature[:16]).hexdigest()

Certifikat za fiskalizaciju izdaje FINA (Financijska agencija) na zahtjev obveznika fiskalizacije. Format je PKCS#12 (.p12 ili .pfx).

Bez uploadanog FINA certifikata sustav radi u trening modu. Računi su validni za testiranje ali nisu fiskalno valjani.

Trening mod je vidljiv:

• Na kasusu: narandžasta "TRENING" pilula u search baru
• Na računu za ispis: crni banner "*** TRENING RAČUN — NIJE FISKALNI ***"
• JIR polje je prazno (postoji samo u produkcionom modu)

Autentikacija

Računi & kasa

Artikli

Smjena

Postavke

Dijagnostika

Klikom "Ispis" na receipt modalu otvara se nova stranica /racun/{id}/print u novom tabu. Stranica je optimizirana za 80mm termalne pisače:

GET /api/smoke-test izvodi end-to-end provjeru sustava u 7 koraka. Na kraju se poziva db.rollback() — testni podaci ne ostaju u bazi.

{
  "ok": true,
  "poruka": "SVE ZELENO - sustav spreman",
  "koraci": [
    {"korak": "1. Login (admin korisnik)", "ok": true, "detalj": "id=1"},
    {"korak": "3.1. Racun #3-1/BP01/2026", "ok": true, "detalj": "ukupno=10.00 EUR | ZKI=24cf77ea..."},
    ...
    {"korak": "7. Rollback testnih podataka", "ok": true}
  ]
}

Server

Pokretanje

# .env
DATABASE_URL=postgresql+asyncpg://user:pass@localhost/medijapos_db
SECRET_KEY=...

# Inicijalizacija baze
python3 init_db.py      # CREATE TABLE svi modeli
python3 seed.py         # admin + blagajnik korisnik + demo artikli

# Pokretanje
uvicorn main:app --host 0.0.0.0 --port 8021 --workers 2

# Smoke test
curl https://fina-connect.online/medijapos/api/smoke-test

Nginx konfiguracija (isječak)

location /medijapos/ {
    proxy_pass http://127.0.0.1:8021/;
    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header X-Forwarded-Proto $scheme;
}