DOMS POS Kontrola

Kontrola točenja goriva i POS evidencija.

Početna / Dokumentacija / DOMS POS Kontrola
Nazad na dokumentaciju

⛽ DOMS POS Kontrola

Softver za praćenje DOMS kontrolera pumpi — čitanje transakcija, monitoring statusa pistolja, SQLite arhiva i izvještaji.

Windows 10 / 11 .NET 6+ SQLite baza TXT + XML arhiva Verzija 1.0

1. Pregled sistema

Aplikacija prati DOMS kontroler pumpi čitanjem TXT fajlova koje DOMS automatski kreira pri svakoj završenoj transakciji točenja. Naša aplikacija ne komunicira direktno sa DOMS-om za čitanje transakcija — sav tok ide kroz fajl sistem.

Tok podataka

🔫 Kupac toci gorivo
→
📄 DOMS kreira IGST fajl
→
🔴 App detektuje (crveno)
→
🗑 POS briše fajl
→
🟢 Pistolj slobodan

Format IGST fajla

PoljeOpisPrimjer
Naziv fajlaIGST_AAPP_TTTTTT.TXT
AA=aparat, PP=pistolj, TT=br.transakcije		IGST_0101_131153.TXT
SSŠifra goriva441
KKKoličina u litrima14.880
CCCijena po litri3.36
IIUkupni iznos50.00

Primjer sadržaja fajla: 441;14.880;3.36;50.00

2. Instalacija i pokretanje

Sistemski zahtjevi

ZahtjevDetalji
Operativni sistemWindows 10 ili 11 (64-bit)
.NET runtime.NET 6.0 ili noviji — dotnet.microsoft.com
MrežaIsti LAN segment kao DOMS kontroler
Pristup folderuČitanje/pisanje na C:\FP

Build iz source koda

# U folderu projekta:
dotnet build
# Release verzija:
dotnet publish -c Release -r win-x64 --self-contained false

Prvo pokretanje

  1. Pokrenite DomsReader.exe
  2. Kliknite ⚙ Podešavanja i unesite IP adresu DOMS kontrolera
  3. Provjerite putanju foldera (C:\FP po defaultu)
  4. Kliknite Snimi konfiguraciju i zatvori
  5. Kliknite ▶ Pokreni

3. Korisničko sučelje

Toolbar dugmad

DugmeFunkcija
▶ PokreniPokreće praćenje foldera i periodični scan
■ StopZaustavlja servis
🔍 ScanRučni scan foldera odmah
⚙ PodešavanjaKonfiguracija aplikacije
📋 HistorijaPregled transakcija iz baze

Status pistolja — boje

StatusBoja panelaOpis
🟢 SLOBODAN Zelena Nema IGST fajla. Pumpa je slobodna za novo točenje.
🟡 TOČENJE U TOKU Žuta DOMS upravo kreirao fajl. Točenje u toku (prvih ~2 sek).
🔴 ZAUZETO Crvena Fajl postoji, čeka da POS sistem obriše fajl. Transakcija završena.
⚠ GREŠKA Narandžasta Problem sa čitanjem ili parsingom fajla.

Primjer panela pistolja

🟢 SLOBODAN
Pumpa: 1 / Pistolj 1
Nema aktivne transakcije
🟡 TOČENJE U TOKU
Pumpa: 1 / Pistolj 2
Gorivo: Dizel 10ppm
Količina: 14.880 lit
Iznos: 50.00 KM
🔴 ZAUZETO — čeka obradu
Pumpa: 2 / Pistolj 1
Gorivo: Dizel 10ppm
Iznos: 50.00 KM
IGST_0201_001185.TXT
⚡ RUČNO OSLOBODI PUMPU
⚡ Dugme RUČNO OSLOBODI PUMPU
  • Aktivno SAMO kad je pistolj u stanju 🔴 ZAUZETO
  • Koristi se kada POS sistem ne radi i ne briše fajl automatski
  • Briše IGST fajl iz C:\FP — aplikacija traži potvrdu

4. Podešavanja

Parametri za login na DOMS kontroler

ParametarDefaultOpis
IP adresa192.168.1.150IP adresa DOMS kontrolera na mreži
TCP Port5001Port za TCP komunikaciju (slanje cijena)
POS ID1Identifikator POS sistema
Auto login✔Automatski pokreće servis pri pokretanju

Log datoteke

ParametarDefaultOpis
LokacijaC:\FPFolder gdje DOMS kreira IGST fajlove
PrefixIGST_Prefix naziva fajlova
TXT log formatSS;KK;CC;IIRedosljed polja u IGST fajlu
Decimalni separator.Tačka ili zarez za decimalne brojeve
Kreiraj TXT log✔Arhivska kopija TXT u C:\FP\Archive\
Kreiraj XML log—XML arhivska kopija transakcije

Konverzija šifri goriva

Tabela mapira DOMS šifre na nazive i cijene goriva:

ID gorivaŠifra gorivaNazivCijena (KM/L)
10441Dizel 10ppm3.73
2011Dizel 50ppm3.73
30787BMB 952.80
401964LPG1.40

📡 Slanje cijena u DOMS

Dugme u formi podešavanja šalje cijene iz tabele goriva direktno na DOMS via TCP. Redovi u tabeli postanu zeleni (uspjeh) ili crveni (greška).

⚠ Napomena za PSS protokol
Format TCP komande za slanje cijena ovisi o vašem DOMS modelu. Prilagodite DomsTcpKlijent.cs prema PSS dokumentaciji.

5. Historija transakcija

Kliknite 📋 Historija za pregled svih transakcija iz SQLite baze.

Filteri

FilterOpis
Od / Do datumPeriod pretrage
AparatOdređena pumpa ili sve
GorivoVrsta goriva ili sve
StatusSve / Obrađene / Neobrađene

Status transakcija u bazi

StatusOpis
✅ ObrađenoVanjski POS je obrisao IGST fajl — transakcija kompletna
⏳ ČekaFajl još postoji — POS nije obradio

SQLite baza podataka

Informacije o bazi
  • Lokacija: C:\FP\doms_transakcije.db
  • Format: SQLite 3 — kompatibilno sa DB Browser for SQLite
  • Export: Kliknite 💾 Export CSV za izvoz u Excel

6. Arhiviranje log fajlova

Kad su uključene opcije Kreiraj TXT/XML log, aplikacija kreira arhivske kopije svake transakcije u C:\FP\Archive\.

TipNaziv fajlaSadržaj
TXTIGST_0101_131153.TXTPo konfiguriranom formatu: 441;14.880;3.360;50.00
XMLIGST_0101_131153.XMLStrukturirani XML sa svim podacima + datum/vrijeme

Primjer XML arhivskog fajla

<?xml version="1.0" encoding="utf-8"?>
<Transakcija>
<BrojTransakcije>131153</BrojTransakcije>
<Vrijeme>2026-04-14 10:23:45</Vrijeme>
<Aparat>1</Aparat>
<Pistolj>1</Pistolj>
<NazivGoriva>Dizel 10ppm</NazivGoriva>
<Kolicina>14.88</Kolicina>
<Cijena>3.36</Cijena>
<Iznos>50.00</Iznos>
<OznakaValute>KM</OznakaValute>
</Transakcija>

7. Česti problemi i rješenja

ProblemUzrokRješenje
Pistolj ostaje crven POS nije obrisao fajl Koristite ⚡ RUČNO OSLOBODI PUMPU ili provjerite POS konfiguraciju
Ne detektuju se novi fajlovi Pogrešna putanja foldera Provjerite putanju u ⚙ Podešavanja. Kliknite 🔍 Scan za ručnu provjeru.
Gorivo prikazano kao "Gorivo 441" Šifra nije mapirana Dodajte šifru 441 u tabelu Konverzija šifri goriva u podešavanjima
Slanje cijena vraća NAK Pogrešan PSS format ili IP Provjerite IP adresu, TCP port i prilagodite format u DomsTcpKlijent.cs
Aplikacija se ne pokreće .NET nije instaliran Instalirajte .NET 6.0 Runtime sa dotnet.microsoft.com
Pistolje pokazuje zauzeto pri startu Stari IGST fajl u folderu Koristite ⚡ RUČNO OSLOBODI PUMPU za svaki crveni pistolj, ili ručno obrišite stare IGST fajlove iz C:\FP

8. Kontakt i podrška

RazvijačELSOFT doo, Gradačac
KonfiguracijaČuva se u doms_config.json u folderu aplikacije
Baza podatakadoms_transakcije.db — SQLite, kompatibilno sa DB Browser
Sva uputstva Vrh stranice