NTech

Poslovna aplikacija za upravljanje servisom računara, magacinom delova i prodajom. Napravljena u Go-u, radi u brauzeru, ne zahteva internet vezu ni eksterne servise.

⚠️ Projekat je u aktivnom razvoju. Nije spreman za produkcijsku upotrebu.

---

O projektu

NTech je interna aplikacija napravljena za konkretnog korisnika — servis računara koji pored popravki vodi i magacin delova, prodaju komponenti i gotovih konfiguracija, te evidenciju klijenata i dobavljača.

Cilj je jednostavan: sve što servis treba da prati nalazi se na jednom mestu, bez oslanjanja na tabele u Excelu ili papirnu evidenciju.

---

Funkcionalnosti

Implementirano

• Inicijalno podešavanje pri prvom pokretanju (setup wizard)
• Sistem migracija baze podataka
• Osnovna struktura baze: artikli, kategorije, klijenti, dobavljači, servisni nalozi, prodajni nalozi, podsetnici

U razvoju

• Korisničko sučelje — sidebar navigacija, sistem tema, dashboard
• Magacin — praćenje stanja delova, lokacija, količina
• Servisni nalozi — prijem, dijagnostika, statusna traka, cene
• Prodajni nalozi — stavke, obračun, evidencija kupaca
• Klijenti i dobavljači — baza kontakata, istorija

Planirano

• Prijava korisnika — sesije, zaključavanje naloga
• Dvofaktorska autentifikacija (TOTP)
• Izveštaji — prodaja, stanje magacina, prihodi
• Podrška za PostgreSQL (za višekorisničko okruženje)
• Obaveštenja (e-pošta / WhatsApp) — odloženo za kasniju fazu
• Skeniranje barkodova putem kamere — odloženo za kasniju fazu

---

Tehnologije

Tehnologija	Uloga
Go	backend jezik
chi	HTTP ruter
html/template	serverski šabloni
HTMX	interaktivnost bez build procesa
TailwindCSS	stilizovanje
Alpine.js	UI logika na strani klijenta
SQLite + modernc.org/sqlite	glavna baza (čisti Go, bez CGO)
PostgreSQL + pgx/v5	opciona baza za produkciju

---

Pokretanje

Zahtevi

• Go 1.22 ili noviji
• Git

Koraci

# 1. Kloniranje repozitorijuma
git clone <url-repozitorijuma>
cd GoNtech

# 2. Kopiranje i popunjavanje .env fajla
cp .env.example .env
# Otvori .env i postavi vrednosti (videti tabelu ispod)

# 3. Pokretanje u razvojnom okruženju
go run ./cmd/ntech

Program se otvara na http://localhost:8080.

Pri prvom pokretanju automatski se pokreće setup wizard.

Produkcioni build

CGO_ENABLED=0 go build -o ntech ./cmd/ntech
./ntech

Rezultat je jedan statički binarni fajl bez zavisnosti.

---

Promenljive okruženja

Kopirati .env.example u .env i popuniti vrednosti. Fajl .env se ne commituje u Git.

Promenljiva	Podrazumevano	Opis
NTECH_ENV	development	Okruženje: development ili production
NTECH_PORT	8080	HTTP port
NTECH_DB	sqlite	Tip baze: sqlite ili postgres
NTECH_SQLITE	ntech.db	Putanja do SQLite fajla
NTECH_DSN	—	PostgreSQL connection string
NTECH_SECRET	—	Ključ za potpisivanje sesija (min. 32 bajta)

---

Struktura projekta

ntech/
├── cmd/
│   └── ntech/          # ulazna tačka programa
├── internal/
│   ├── auth/           # prijava, sesije, 2FA
│   ├── config/         # podešavanja, setup wizard
│   ├── db/             # sloj baze podataka
│   │   ├── sqlite/     # SQLite implementacija
│   │   └── postgres/   # PostgreSQL implementacija
│   ├── handler/        # HTTP handleri
│   ├── middleware/      # autentifikacija, logovanje, ograničavanje zahteva
│   └── model/          # zajednički tipovi podataka
├── web/
│   ├── static/         # CSS, JavaScript, slike
│   └── templates/      # HTML šabloni
├── migrations/         # SQL migracije (001_opis.sql, 002_opis.sql, ...)
├── .env.example        # primer konfiguracije
├── go.mod
└── go.sum

---

Licenca

© 2026 Dalibor Marković

Slobodno korišćenje i modifikovanje za lične i nekomercijalnu svrhe.
Za komercijalnu upotrebu obavezno kontaktirati autora.