Instalacija i prvi koraci

Instalacija i prvi koraci

Ovaj vodič pokriva cijeli put od prazne instalacije do prvog stvarnog administratora koji preuzima sustav.

1. Preduvjeti

Prije instalacije provjeri da je okruženje spremno:

1. PHP 8.2+
2. Composer 2+
3. MySQL 8+
4. Node.js 18+ i npm
5. web server (Apache/Nginx) ili lokalno php artisan serve

2. Osnovna instalacija projekta

U rootu projekta pokreni:

composer install
cp .env.example .env
php artisan key:generate

Zatim u .env postavi barem osnovne stavke:

APP_NAME="Archery Club"
APP_ENV=local
APP_DEBUG=false
APP_URL=http://localhost

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=your_database
DB_USERNAME=your_user
DB_PASSWORD=your_password

3. Baza, seed i asseti

Pokreni migracije i početni seed:

php artisan migrate --seed

Napravi storage link:

php artisan storage:link

Složi frontend assete:

npm install
npm run build

Za lokalni razvoj može i:

npm run dev
php artisan serve

4. Što seed automatski postavlja

Početni seed postavlja ključne početne podatke, između ostalog:

1. stilove luka (stilovis)
2. kategorije (kategorijes)
3. tipove turnira i polja za unos rezultata (tipovi_turniras, polja_za_tipove_turniras)
4. početne teme i aktivnu default temu
5. bootstrap administratorski račun

Bootstrap admin podaci:

1. e-mail: administrator@archery.local
2. lozinka: poklonOdSKDubrava

5. Prvi ulaz i obavezni handover administratora

Nakon seeda početna stranica je funkcionalna, ali sustav je još uvijek na privremenom bootstrap administratoru.

Na slici ispod prikazano je: Početna nakon instalacije.

Prvo registriraj stvarnog korisnika kluba (osoba koja će trajno biti administrator):

Na slici ispod prikazano je: Registracija. Na slici ispod prikazano je: Nakon registracije.

Zatim se prijavi bootstrap admin računom i otvori Admin -> Korisnici:

Na slici ispod prikazano je: Bootstrap admin - korisnici.

Uredi stvarno registriranog korisnika i postavi mu rolu 1 - Admin, pa spremi:

Na slici ispod prikazano je: Promocija korisnika u admina.

Nakon spremanja sustav automatski:

1. odjavljuje bootstrap admin sesiju,
2. briše bootstrap korisnika,
3. traži prijavu novog administratora.

Na slici ispod prikazano je: Bootstrap korisnik uklonjen. Na slici ispod prikazano je: Novi admin prijavljen.

6. Produkcija (preporučeni oblik instalacije)

Za produkcijski deploy koristi:

composer install --no-dev --optimize-autoloader
php artisan migrate --seed --force
npm ci
npm run build

Ako deploy pipeline odvojeno rješava migracije/seed, prilagodi naredbe prema procesu tima.

7. Uvoz nadolazećih turnira (archery.hr)

Za uvoz kalendara koristi artisan komandu:

php artisan turniri:import-archery

Česti primjeri:

# pregled bez upisa
php artisan turniri:import-archery --year=2026 --dry-run

# uvoz nadolazećih turnira za godinu
php artisan turniri:import-archery --year=2026

# samo novi zapisi
php artisan turniri:import-archery --year=2026 --skip-existing

# uključi i prošle turnire
php artisan turniri:import-archery --year=2026 --include-past

8. Kratka provjera nakon instalacije

Instalacija se smatra uspješnom kada su ispunjena sva četiri uvjeta:

1. aplikacija se otvara bez greške,
2. stvarni korisnik je promoviran u admina,
3. bootstrap admin više ne postoji,
4. Admin izbornik je vidljiv novom administratoru.