# DigiPOS — упутство за инсталацију (ЕСИР)

**С.О.К. доо Краљево**  
**ЕСИР:** DigiPOS вер. 2.0  
**Краљево, јул 2026.**

Инсталацију програма врши **власник / овлашћено лице на свом рачунару** (на даљину),
или **С.О.К. доо Краљево** / одобрени инсталатер. Ово упутство описује **потпуно
аутономну** инсталацију — **без доласка** у објекат власника.

**Три режима рада касе** (иста апликација):

1. **Самостални** — нулта инсталација, локална SQLite база (`digipos.db`); без везе са ERP-ом.
   Каса на телефону (PWA) уз **В‑ПФР**. **Важно:** самостална инсталација сервера **на iPhone-у није могућа**
   (види одељак испод); на Android-у је могућа преко Termux-а или преко облака / PC.
2. **ERP у облаку — стална конекција** — сталан рад са ERP-ом; при прекиду везе прво офлајн, па синхронизација;
3. **ERP на захтев** — локални рад; синхронизација са ERP-ом кад се затражи.

Испод је **самостална инсталација на даљину** на рачунару (режим 1). Режим 2 и 3 додају ERP подешавања
(види **Упутство за конфигурацију** и техничко упутство §1.1). Одељак **Самостални на мобилном**
описује употребу на телефону после подизања сервера.

---

## инсталација на даљину на рачунару (препоручено)

Адреса: **https://digi-knjigovodstvo.rs/esir-setup/**

Сервер DigiPOS инсталира се на **Windows** или **Linux** (x64). Телефон је касније само каса (PWA).

### Windows 10/11 (један клик)

1. На рачунару у објекту отворите горњу адресу (или пошаљите линк власнику).
2. Преузмите **`DigiPOS-ESIR-Setup.cmd`** и покрените га  
   (ако Windows прикаже SmartScreen: *More info* → *Run anyway*).
3. Скрипт **сам** преузима пакет, инсталира аутостарт, покреће сервер и отвара
   прегледач на `http://localhost:3000`.
4. Одмах улазите у **прво подешавање**:
   - корак 1: фирма, ПИБ, објекат, врста (малопродаја / угоститељство);
   - корак 2: **В-ПФР / Л-ПФР** адресе, PIN или ПАК, опционо PFX, фискални штампач → **Сачувај и покрени**.
5. Пријава PIN-ом **1234** — одмах променити (Админ → Корисници).

Инсталација се завршава у `%LOCALAPPDATA%\DigiPOS` (обично  
`C:\Users\<korisnik>\AppData\Local\DigiPOS`).

### Linux (x64)

1. Преузмите **`https://digi-knjigovodstvo.rs/download/digipos-linux-x64.tar.gz`**.
2. Распакујте: `tar -xzf digipos-linux-x64.tar.gz && cd digipos`.
3. Системски сервис: `sudo ./install.sh` → `/opt/digipos`  
   или без root: `./install.sh --user` → `~/.local/share/digipos`.
4. Отворите `http://localhost:3000` (или IP рачунара) и завршите исто **прво подешавање**.
5. PIN **1234** — одмах променити.

Пакет садржи уграђени Node и systemd јединицу. Потребан је **x86_64** Linux (ARM није у овом пакету).

**Није потребан** одлазак сервисера у објекат кад власник има интернет, Windows или Linux x64
и податке за ПФР (или користи `DEMO` за обуку).

---

## Самостални на мобилном телефону (инсталација и употреба)

DigiPOS се **може користити** као каса на мобилном телефону (PWA). Сервер (база + PFX ка В‑ПФР)
увек мора негде да ради — на PC у објекту, хостовано у облаку, или (само Android) у Termux-у.

> **НИЈЕ МОГУЋЕ: самостална инсталација на iPhone-у**  
> На iPhone / iPad **не може** да се инсталира DigiPOS сервер (Node + SQLite + PFX) као на
> Windows-у или као на Android-у (Termux). iOS не дозвољава овај модел.  
> iPhone је **само клијент** (Safari → Додај на Почетни екран). Сервер + В‑ПФР морају бити на
> **PC у објекту** или на **хостованој каси** (облак С.О.К.).  
> Не постоји `Setup` / APK / Termux еквивалент за самостални iPhone.

### А) Има рачунар у објекту (Windows / Linux) + телефон као каса

| Корак | Шта урадити |
|-------|-------------|
| 1 | На рачунару инсталирајте DigiPOS (Windows Setup / ZIP или Linux tar.gz). |
| 2 | Унесите **В‑ПФР** (URL, ПАК, PFX). |
| 3 | На телефону отворите `http://<IP>:3000` (Chrome / Safari). |
| 4 | **Додај на почетни екран** (PWA). |
| 5 | Рад преко Wi‑Fi или мобилног интернета (ако је каса јавно доступна HTTPS). |

### Б) Само телефон — Android и iPhone (без рачунара у објекту)

Иста **употреба** касе на Android и iPhone (PWA), али **инсталација сервера** није иста:

- **Android:** могућ облак **или** самостални сервер на телефону (Termux, одељак В).
- **iPhone:** самостална инсталација сервера на уређају је **немогућа**. Обавезан је облак или PC.

За рад без PC у локалу: сервер + В‑ПФР у **облаку С.О.К.**; касиру само мобилни интернет.

| Корак | Android | iPhone |
|-------|---------|--------|
| 1 | С.О.К. подиже хостовану HTTPS касу + В‑ПФР | исто |
| 2 | Chrome → линк касе | Safari → линк касе |
| 3 | ⋮ → **Инсталирај апликацију** / Додај на почетни екран | Дели → **Додај на Почетни екран** |
| 4 | Пријава PIN-ом, рад касе | исто |

Упутство: **https://digi-knjigovodstvo.rs/esir-setup/mobilni.html**  
Хостовање (оператер): `scripts/provision-cloud-kasa.sh`

### В) Android — сервер на самом телефону (Termux)

Опционо, за техничаре: DigiPOS Node ради у Termux-у на Android-у (без облака и без PC).  
`bash <(curl -fsSL https://digi-knjigovodstvo.rs/esir-setup/install-android-termux.sh)`  

> **iPhone:** ова опција **не постоји**. Самостална инсталација на iPhone-у је **немогућа**.

**Није обавезан** локални Л‑ПФР ни ERP. Штампа: мрежни / хостовани штампач, или `FILE` / преглед за тест.

---

## Предуслови

1. Рачунар са **Windows 10/11** (64 бита) **или Linux x64**, и приступом интернету (за преузимање).
2. Штампач (касније или у кораку 2): термални ESC/POS / мрежни; на Windows-у и било који Windows штампач; за тест: `FILE`.
3. **ПФР:** В-ПФР (URL + PFX + ПАК) и/или Л-ПФР (локална адреса + PIN), или `DEMO`.
4. **Безбедносни елемент** за продукцију: ПАК/PFX (В-ПФР) или smart-картица (Л-ПФР).

---

## Алтернатива — ручни пакет

**Windows:** преузмите `digipos-windows-x64.zip` → распакујте → **`instaliraj.bat`**.  
**Linux:** видети одељак изнад (`digipos-linux-x64.tar.gz` → `./install.sh`).

У прегледачу завршите исто **прво подешавање** (фирма → ПФР → штампач).

### Изворни код / развој

`npm install` + `node server.js` / `start.bat` — за С.О.К. развој, не за типичну теренску поставку.

---

## После инсталације

Даља фина подешавања (стопе после првог ПФР синхронизације, корисници, артикли) — **Упутство за конфигурацију**.  
Рад касира — **корисничко упутство**.

---

*С.О.К. доо Краљево · DigiPOS · упутство за инсталацију (ЕСИР)*
