# DigiPOS

Uputstvo za korišćenje · administrator, konobar, kasir, kuvar

Generisano iz UPUTSTVO.md

# DigiPOS — uputstvo za instalaciju

Proizvođač: S.O.K. doo, Kraljevo

PIB: 105320485 · Proizvod: DigiPOS ver. 2.0

Datum: jul 2026.

> Za Poresku upravu (прилог П3): кратко ćirilica упутство →

> `ESIR-UPUTSTVO-ZA-INSTALACIJU.md` → ODT `DigiPOS-ESIR-instalacija.odt`

> (`npm run docs:esir-prilozi`). Конфигурација (П4): `ESIR-UPUTSTVO-ZA-KONFIGURACIJU.md`.

Instalaciju i prvo puštanje u rad obavlja S.O.K. doo Kraljevo ili ovlašćeni instalater na lokaciji korisnika. Ovo duže uputstvo služi za teren (mreža, HTTPS, MySQL…).

## Sadržaj

1. Preduslovi
2. Instalacija programa
3. Pokretanje servera
4. Konfiguracija nakon instalacije
5. LPFR i fiskalni štampač
6. Mreža — telefoni i tableti
7. HTTPS (opciono, PWA)
8. Provera da sve radi
9. Rešavanje problema

## 1. Preduslovi

# | Zahtev
--- | ---
1 | Računar sa Windows 10/11 (64 bita) ili Linux x64
2 | Node.js — samo ako ne koristite gotov paket (v. INSTALACIJA.md)
3 | Štampač za fiskalne račune: termalni 57–80 mm, ESC/POS, podrška za ćirilicu (CP1251), QR
4 | LPFR (L-PFR ili V-PFR) dostupan u lokalnoj mreži ili na istom računaru
5 | Bezbednosni element za V-PFR (smart kartica / sertifikat) — prema uputstvu proizvođača PFR-a
6 | Za knjigovodstveni režim: MySQL server sa bazom (`sokdooco_knjige` ili ekvivalent)
7 | LAN/Wi‑Fi za telefone konobara (isti mrežni segment kao server)

Minimalan hardver: Celeron / 2 GB RAM / 1 GB slobodnog diska (preporuka: 4 GB RAM, SSD).

## 2. Instalacija programa

### 2.A Preporučeno — paket sa ugrađenim Node-om (bez npm)

Za prodavnice i restorane bez IT na lokaciji koristite samodovoljni ZIP/tar.gz:

Platforma | Paket | Koraci
--- | --- | ---
Windows | `digipos-windows-x64.zip` | Raspakuj → `instaliraj.bat`
Linux | `digipos-linux-x64.tar.gz` | `tar -xzf` → `sudo ./install.sh` ili `./install.sh --user`

Detaljno: INSTALACIJA.md — autostart, systemd, prvi dan, deinstalacija.

Za početnike (bez IT znanja): INSTALACIJA-STANDALONE.md — korak po korak sa objašnjenjem miša, ZIP-a i prvog podešavanja.

Paket uključuje Node runtime i SQLite (`app/digipos.db` pri prvom startu). MySQL nije potreban u standalone režimu.

### 2.B Ručna instalacija (razvoj / knjigovodstvo sa MySQL)

1. Raspakujte distribuciju DigiPOS u folder, npr. `C:\DigiPOS`.
2. Otvorite terminal (PowerShell ili CMD) u tom folderu.
3. Jednom pokrenite:

npm install

1. Proverite da postoje fajlovi:

- `server.js` — glavni program
- `config.json` — podešavanja baze i servera
- `start.bat` — pokretanje na Windows-u

SQLite režim (nova prodavnica): nije potreban MySQL — baza `digipos.db` se kreira pri prvom startu.

MySQL režim (postojeće knjigovodstvo): u `config.json` unesite parametre baze (host, user, password, database).

Primer `config.json`:

{

"port": 3000,

"db": {

"host": "localhost",

"user": "root",

"password": "",

"database": "sokdooco_knjige"

}

}

## 3. Pokretanje servera

1. Dvostruki klik na `start.bat` ili u terminalu:

node server.js

1. U konzoli se ispisuje adresa kase, npr.:

- `http://localhost:3000` — kasa na ovom računaru
- `http://192.168.x.x:3000` — adresa za telefone u mreži

1. Server mora da radi dok je objekat otvoren. Za produkciju preporučuje se automatsko pokretanje pri startu Windows-a (zakazani zadatak / servis).

Adrese:

Uloga | URL
--- | ---
Kasa (konobar, kasir, kuvar) | `http://localhost:3000` ili `http://IP:3000`
Administracija | `http://localhost:3000/admin`
Dokumentacija | `http://localhost:3000/docs/`

## 4. Konfiguracija nakon instalacije

Konfiguraciju obavlja administrator (PIN sa ulogom `admin`) na `/admin` → Podešavanja.

Podešavanje | Objašnjenje
--- | ---
Režim rada | `restoran` ili `prodavnica`
Vlasnik | Firma iz tabele `vlasnik`
Objekat | Prodajno mesto
ESIR broj | Broj iz registra PU (nakon odobrenja verzije za DigiPOS)
LPFR adresa | URL API v3, npr. `http://localhost:8888/api/v3/` ili `DEMO` za probu
LPFR PIN | PIN za endpoint `/pin`
Fiskalni štampač | Ime Windows štampača, `FILE` (test fajl) ili `NONE`
Štampač za kuhinju | Opciono, drugi štampač
Težinski prefiks | Prefiks vage (podrazumevano `28`)

Prvi dan — obavezno:

1. Promeniti početni PIN 1234 (Admin → Korisnici).
2. Dodati zaposlene (ime, PIN, uloga).
3. Sačuvati podešavanja → Proveri LPFR.
4. Uvesti ili proveriti artikle (Admin → Artikli).
5. Restoran: podesiti stolove (Admin → Stolovi).

Detaljnija konfiguracija LPFR-a i bezbednosnog elementa — prema uputstvu proizvođača fiskalnog uređaja.

## 5. LPFR i fiskalni štampač

### 5.1 LPFR

1. Uverite se da LPFR radi (status LED / aplikacija proizvođača).
2. U Admin → Podešavanja unesite `lpfr_url` i `lpfr_pin`.
3. Klik Proveri LPFR — mora vratiti uspeh.
4. Za test bez uređaja: `lpfr_url = DEMO` (simulator, nije za produkciju).

### 5.2 Štampač

1. Instalirajte drajver štampača u Windows-u; štampač mora biti vidljiv u Uređaji i štampači.
2. U DigiPOS unesite tačno ime štampača kao u Windows-u.
3. Probna štampa: izdajte test račun u DEMO režimu ili postavite `FILE` — račun se snima u folder `prints\`.

## 6. Mreža — telefoni i tableti

1. Računar sa DigiPOS serverom i telefoni moraju biti na istom Wi‑Fi / LAN-u.
2. Na telefonu u pregledaču otvorite `http://IP-RAČUNARA:3000` (ne `localhost`).
3. IP adresa se ispisuje pri startu `start.bat`.
4. Opciono: Dodaj na početni ekran (PWA) — pogodno za konobare.

Ako telefon ne otvara kasu: proverite firewall na računaru (dozvoliti ulaz na port 3000).

## 7. HTTPS (opciono, PWA)

Pregledači na telefonu za punu PWA instalaciju traže HTTPS van `localhost`.

U `config.json`:

"https_port": 3443,

"https_key": "cert/digipos.key",

"https_cert": "cert/digipos.crt"

Samopotpisani sertifikat (openssl uz Git for Windows):

mkdir cert

openssl req -x509 -newkey rsa:2048 -nodes -days 3650 -keyout cert/digipos.key -out cert/digipos.crt -subj "/CN=DigiPOS"

Na telefonu: `https://IP:3443` → prihvatiti upozorenje o sertifikatu.

## 8. Provera da sve radi

Checklist posle instalacije:

- ☐ `http://localhost:3000` otvara ekran za PIN
- ☐ Prijava admin PIN-om na `/admin`
- ☐ Proveri LPFR — OK
- ☐ Test prodaja (DEMO) — račun u listi Računi
- ☐ Štampa ili fajl u `prints\` (ako je `FILE`)
- ☐ Telefon otvara `http://IP:3000` sa istog Wi‑Fi-ja

## 9. Rešavanje problema

Problem | Rešenje
--- | ---
`npm install` greška | Proverite Node.js verziju; pokrenite terminal kao administrator
Server ne startuje | Port 3000 zauzet — zatvorite drugi proces ili promenite `port` u config.json
LPFR ne odgovara | Proverite URL, PIN, firewall, da li je PFR uključen
Štampa prazna / ??? | Pogrešno ime štampača; proverite CP1251 podršku
Telefon ne vidi kasu | Isti Wi‑Fi; ispravan IP; Windows firewall
Nema artikala | Admin → Artikli; MySQL režim — proverite `vlasnik` u podešavanjima

Za podršku: S.O.K. doo — sok@sokdoo.com, 063 683 093.

Povezana uputstva:

- Uputstvo za upotrebu
- Uputstvo za zaposlene (kratko)
- ESIR tehničko uputstvo

*S.O.K. doo Kraljevo · DigiPOS · uputstvo za instalaciju*