LEADER SHOP - SERVER HANDOFF ZA DEV INSTALACIJU
Datum: 2026-07-16

NAMJENA ZIP PAKETA
Ovaj paket je trenutno razvojna verzija Leader Shop platforme.
Prvi cilj je instalacija na dev.leader.ba kao test okruzenje.
Nakon toga se na gsm.leader.ba moze podici posebna instalacija za Mobile/GSM shop temu.

VAZNO
Ovo jos nije finalni installer i nije finalni licence sistem.
Trenutno se radi manual dev install: upload fajlova, podesavanje .env, import SQL migracija i kreiranje admin korisnika.
Finalni installer, licence i Leader Central treba raditi kasnije, kada mobile_shop tema bude stabilnija.

ARHITEKTURA
- Leader Shop Core je glavna aplikacija.
- Teme/moduli idu preko themes foldera.
- Trenutno postoji themes/mobile_shop/theme.json kao pocetak GSM/mobile shop teme.
- Ideja je da jedna firma moze imati svoju instalaciju, a tema dodaje posebna polja i prikaz za djelatnost.
- dev.leader.ba treba biti probna instalacija cijelog sistema.
- gsm.leader.ba treba biti instalacija iste aplikacije, ali podesena kao GSM/Mobile shop.

STA JE DO SADA URADJENO
1. Core struktura aplikacije
   - app/Core: Bootstrap, Router, Database, Auth, helpers.
   - routes/web.php za rute.
   - public/index.php kao ulaz u aplikaciju.

2. Admin dio
   - Login.
   - Dashboard.
   - Admin lista proizvoda.
   - Dodavanje i edit proizvoda.
   - Kategorije.
   - Brendovi.
   - Narudzbe.
   - Stranica "Faze rada" u adminu.

3. Shop dio
   - Pocetna shop lista proizvoda.
   - Product card dizajn prilagodjen za telefone.
   - Product page sa velikom slikom, thumbnails, izborom boje/memorije, cijenom, Mikrofin boxom i tabovima.
   - Cart i checkout osnovni tok.

4. Mobile/GSM tema
   - Pocetni mobile_shop theme config.
   - Product page prilagodjen za mobilne telefone.
   - Izbor BOJA i MEMORIJA.
   - Cijena moze varirati po varijanti.
   - Mikrofin racunanje: puna cijena + 11% / 18 rata.
   - Oznake NOVO i NA 18 RATA.
   - Galerija proizvoda je horizontalni slider; na mobilnom se pomjera prstom lijevo/desno bez vidljivog scrollbara.

5. Import lager liste
   - Dodan StockImport dio.
   - Lager import pokusava prepoznati proizvod, brend, kategoriju, memoriju, boju i cijenu.
   - Problem koji treba dalje doraditi: neki accessories/ruteri/punjaci su ranije zavrsavali u Mobilni telefoni, pa klasifikaciju jos treba testirati i poostriti.
   - Telefoni tipa "Xiaomi Redmi Note 15 6/128 purple" treba da postanu jedan proizvod "Xiaomi Redmi Note 15" sa varijantama memorije/boje, a ne vise posebnih artikala.

6. Import podataka sa stranice proizvoda
   - GSM Arena, Gigatron i drugi automatski importi su ranije probani i nisu dovoljno stabilni.
   - Trenutno je prioritet IQ Mobile paste-code pristup:
     admin zalijepi HTML source stranice, a sistem iz njega cita naziv, cijenu, opis, specifikacije, boje, memorije i slike.
   - Za IQ Mobile parser dodano je mapiranje slika po boji: ako source ima Black/Blue/Grey i vezane image id-jeve, slike se upisuju u product_images.color_name.
   - Product page koristi data-color i na klik boje treba prikazati slike te boje.
   - Poznato za provjeru: zadnji parser test za Samsung Galaxy A17 4G je pokazao boje Black, Blue, Grey i slike Slika-1, Slika-10, Slika-19 kao pocetne slike boja. Treba jos provjeriti da finalni filter ne propusta dodatnu opremu iz related proizvoda.

7. Dizajn
   - Radjen moderniji admin i shop izgled.
   - Akcije u admin listi proizvoda su uredjivane.
   - Roze dugmad treba imati bijeli tekst.
   - Shop card raspored: kategorija, naziv, brend, cijena, "Vec od", dugme Detaljnije.
   - Boje/fontovi u admin temi su zapoceti kroz theme/settings logiku.

BAZA I MIGRACIJE
Migracije su u:
database/migrations/

Redoslijed:
1. 001_create_core_tables.sql
2. 002_products_orders_checkout.sql
3. 003_mobile_shop_foundation.sql
4. 004_product_image_colors.sql

Na serveru kreirati MySQL bazu, zatim importovati SQL fajlove ovim redom.

PRIMJER .env ZA dev.leader.ba
Napraviti fajl .env u root folderu aplikacije:

APP_NAME="Leader Shop DEV"
APP_ENV=production
APP_DEBUG=false
APP_URL=https://dev.leader.ba

DB_HOST=localhost
DB_PORT=3306
DB_DATABASE=OVDJE_DB_NAME
DB_USERNAME=OVDJE_DB_USER
DB_PASSWORD=OVDJE_DB_PASS

Za pocetak na dev okruzenju moze privremeno APP_DEBUG=true ako treba vidjeti gresku, ali poslije vratiti na false.

SERVER ZAHTJEVI
- PHP 8.3 ili noviji.
- MySQL/MariaDB.
- PHP ekstenzije: pdo_mysql, mbstring, json, openssl.
- Document root subdomena treba pokazivati na public folder.
- Ako hosting ne dozvoljava public kao document root, treba podesiti strukturu ili .htaccess tako da javno bude samo public/index.php.

INSTALL KORACI ZA SERVER CODEX
1. Uploadovati ZIP i raspakovati ga u folder aplikacije.
2. Provjeriti da .env iz lokalnog racunara nije prenesen. Ako jeste, ne koristiti ga sa lokalnim podacima.
3. Napraviti novi .env prema primjeru iznad.
4. Ako vendor/autoload.php postoji, app moze odmah raditi. Ako ne postoji, pokrenuti:
   composer install --no-dev --optimize-autoloader
5. Importovati migracije redom u bazu.
6. Kreirati admin korisnika:
   php database/seed_admin.php "Leader Admin" "admin@leader.ba" "JAKA-SIFRA-OVDJE"
7. Otvoriti:
   https://dev.leader.ba
   https://dev.leader.ba/admin/login
8. Testirati login, proizvode, kategorije, product page i checkout.

PREPORUCENA STRUKTURA NA SERVERU
Ako je moguce:
/home/USER/leader-shop-dev/
  app/
  config/
  database/
  public/
  routes/
  themes/
  vendor/
  .env

Document root za dev.leader.ba:
/home/USER/leader-shop-dev/public

ZA gsm.leader.ba
Kada dev.leader.ba proradi:
1. Napraviti drugu bazu.
2. Napraviti drugu kopiju aplikacije ili kasnije jedan shared core.
3. APP_URL=https://gsm.leader.ba
4. APP_NAME="Leader GSM Shop"
5. Aktivirati/podesiti mobile_shop temu.
6. Importovati test telefone i provjeriti:
   - boje,
   - memorije,
   - cijene po varijanti,
   - slike po boji,
   - Mikrofin 18 rata,
   - mobile prikaz.

POZNATI NAREDNI KORACI
1. Zavrsiti stabilan IQ Mobile paste-code import.
2. Dodatno ocistiti import slika da ne ulaze related/dodatna oprema slike.
3. Dovrsiti admin formu za proizvod da boje, memorije, cijene i slike budu jos preglednije.
4. Doraditi lager import da spaja varijante istog telefona u jedan proizvod.
5. Doraditi filtere na shopu: brend, memorija, cijena, novo, na rate.
6. Doraditi theme settings za boje i fontove.
7. Nakon stabilne teme raditi pravi installer.
8. Nakon installera raditi licence sistem i Leader Central.

NAPOMENA ZA SERVER CODEX
Ne tretirati ovaj ZIP kao finalni proizvod. Ovo je razvojni paket za probnu instalaciju.
Prvo treba postaviti dev.leader.ba, pokrenuti migracije, kreirati admina i testirati da app radi.
Tek nakon toga raditi gsm.leader.ba i mobile_shop finalizaciju.
