# Guest Potvrda Rezervacije - Token-Based
**Datum implementacije:** 20.03.2026
**Zadnje ažurirano:** 20.03.2026
**Tip:** Token-based confirmation (Opcija 1)
---
## 📋 Pregled
Implementiran je sustav za **guest potvrdu rezervacija** koji omogućava korisnicima da potvrde ili otkažu rezervaciju **bez potrebe za registracijom ili loginom**. Sustav koristi siguran token-based pristup s automatskim email notifikacijama.
---
## 🔑 Ključne Značajke
✅ **Guest-friendly** - Bez registracije, bez logina
✅ **Siguran token** - Jedinstveni 64-karakterni token za svaku rezervaciju
✅ **Email integracija** - Automatski linkovi u email-ima
✅ **Email notifikacije** - Za potvrde i otkazivanja (guest + admin akcije)
✅ **Fleksibilno** - Korisnik može potvrditi online ili telefonom
✅ **Bistro layout** - Usklađen dizajn s ostatkom stranice
✅ **Status tracking** - Prati stanje rezervacije (pending, confirmed, cancelled)
✅ **Logging** - Sve akcije se logiraju
✅ **Admin dashboard** - Pregled i upravljanje svim rezervacijama
---
## 🗃️ Promjene u Bazi
### Nova polja u `reservations` tablici:
- `confirmation_token` (string, 64, unique, nullable) - Jedinstveni token za potvrdu
- `confirmed_at` (timestamp, nullable) - Vrijeme kada je potvrđena
**Migration:** `2026_03_20_080938_add_confirmation_fields_to_reservations_table.php`
---
## 🏗️ Arhitektura
### 1. **Reservation Model** (`app/Models/Reservation.php`)
#### Automatsko generiranje tokena:
```php
protected static function boot(): void
{
parent::boot();
static::creating(function ($reservation) {
if (! $reservation->confirmation_token) {
$reservation->confirmation_token = Str::random(64);
}
});
}
```
#### Nove metode:
- `isConfirmed(): bool` - Provjerava je li rezervacija potvrđena
- `confirm(): void` - Potvrđuje rezervaciju (status → confirmed, dodaje confirmed_at)
- `cancel(): void` - Otkazuje rezervaciju (status → cancelled)
- `getConfirmationUrlAttribute(): string` - URL za stranicu rezervacije
- `getCancellationUrlAttribute(): string` - URL za stranicu rezervacije (isti kao confirmation)
**Napomena:** Oba URL-a vode na istu stranicu `/potvrdi-rezervaciju/{token}` gdje korisnik vidi detalje i ima gumbe za akcije. Linkovi NISU direktni POST zahtjevi.
---
### 2. **ReservationConfirmationController** (`app/Http/Controllers/ReservationConfirmationController.php`)
#### Metode:
**`show(string $token)`**
- Prikazuje stranicu s detaljima rezervacije
- Guest pristup - ne zahtijeva autentikaciju
**`confirm(Request $request, string $token)`**
- POST metoda za potvrdu rezervacije
- Provjerava je li već potvrđena
- Ažurira status na 'confirmed'
- **ŠALJE EMAIL** korisniku (ReservationConfirmedMail)
- Logira akciju
**`cancel(Request $request, string $token)`**
- POST metoda za otkazivanje
- Provjerava je li već otkazana
- Ažurira status na 'cancelled'
- **ŠALJE EMAIL** korisniku (ReservationCancelledMail)
- Logira akciju
---
### 3. **Admin Dashboard** (`app/Http/Controllers/AdminReservationsController.php`)
#### Ključne Značajke:
- ✅ Pregled svih rezervacija (20 po stranici, paginacija)
- ✅ Filtriranje po statusu (sve, pending, confirmed, cancelled)
- ✅ Filtriranje po datumu (od-do)
- ✅ Ručna potvrda rezervacija
- ✅ Ručno otkazivanje rezervacija
- ✅ Email notifikacije korisniku prilikom admin akcija
- ✅ Logging svih admin akcija
- ✅ Bistro layout integracija
#### Metode:
**`index(Request $request)`**
- Lista rezervacija s filterima i paginacijom
- Prikazuje: ID, ime, kontakt, datum/vrijeme, broj osoba, status, akcije
**`confirm($id)`**
- Admin ručno potvrđuje rezervaciju
- Provjerava validnost statusa
- **ŠALJE EMAIL** korisniku (ReservationConfirmedMail)
- Logira admin akciju s email-om admina
**`cancel($id)`**
- Admin otkazuje rezervaciju
- Provjerava validnost statusa
- **ŠALJE EMAIL** korisniku (ReservationCancelledMail)
- Logira admin akciju s email-om admina
#### Admin Rute:
```php
Route::middleware('auth')->prefix('admin')->name('admin.')->group(function () {
Route::get('/rezervacije', [AdminReservationsController::class, 'index'])
->name('reservations.index');
Route::post('/rezervacije/{id}/potvrdi', [AdminReservationsController::class, 'confirm'])
->name('reservations.confirm');
Route::post('/rezervacije/{id}/otkazi', [AdminReservationsController::class, 'cancel'])
->name('reservations.cancel');
});
```
**Pristup:** `/admin/rezervacije` (samo za autentificirane korisnike)
---
### 4. **Rute** (`routes/web.php`)
#### Guest rute (bez autentikacije):
```php
Route::get('/potvrdi-rezervaciju/{token}', [ReservationConfirmationController::class, 'show'])
->name('reservation.confirm.show');
Route::post('/potvrdi-rezervaciju/{token}', [ReservationConfirmationController::class, 'confirm'])
->name('reservation.confirm');
Route::post('/otkazi-rezervaciju/{token}', [ReservationConfirmationController::class, 'cancel'])
->name('reservation.cancel');
```
---
### 5. **Guest View** (`resources/views/pages/reservation-confirmation.blade.php`)
#### Značajke:
- ✅ Bistro template layout
- ✅ Prikaz svih detalja rezervacije
- ✅ Status badge (POTVRĐENO, NA ČEKANJU, OTKAZANO)
- ✅ Gumbovi za potvrdu/otkazivanje (POST forme, ako nije već potvrđena/otkazana)
- ✅ Kontakt informacije
- ✅ Responsive dizajn (Bootstrap 5)
- ✅ Flash poruke za success/info
#### Prikaz informacija:
- Ime, telefon, email (ako postoji)
- Datum i vrijeme (s danima u tjednu na hrvatskom)
- Broj osoba
- Napomena (ako postoji)
- Status rezervacije
---
### 6. **Admin View** (`resources/views/admin/reservations/index.blade.php`)
#### Značajke:
- ✅ Tablica svih rezervacija
- ✅ Filteri po statusu i datumu
- ✅ Paginacija (20 po stranici)
- ✅ Status badges (crveno/žuto/zeleno)
- ✅ Action gumbi (Potvrdi/Otkaži) s JavaScript confirm-om
- ✅ Responsive design
- ✅ Flash poruke za uspjeh/greške
- ✅ Bistro layout
---
## 📧 Email Sustav
### 1. **Početna rezervacija**
**ReservationConfirmationMail** (`emails/reservation-confirmation.blade.php`)
- Šalje se kod **nove rezervacije**
- **Sadržaj:** Detalji, link za potvrdu, link za otkazivanje
- **Gumbi:** "Potvrdi Rezervaciju" (zeleni), "Otkaži Rezervaciju" (crveni)
**NewReservationNotificationMail** (`emails/new-reservation-notification.blade.php`)
- Šalje se adminu (`info@krcma-petric.com`)
- **Sadržaj:** Svi podaci rezervacije, link za pregled
---
### 2. **Potvrda rezervacije (guest ili admin)**
**ReservationConfirmedMail** (`emails/reservation-confirmed.blade.php`)
- Šalje se nakon potvrde (guest klik ili admin akcija)
- **Subject:** "Rezervacija potvrđena - Krčma Petrić"
- **Sadržaj:**
- ✅ Hvala poruka
- Detalji potvrđene rezervacije
- Status badge
- Link "Pogledaj Rezervaciju" (vodi na `/potvrdi-rezervaciju/{token}`)
- Opcionalno otkazivanje
- Kontakt informacije
**VAŽNO:** Link NE vodi direktno na otkazivanje (ne šalje error), već na stranicu s detaljima gdje korisnik ima POST formu s gumbom za otkaži.
---
### 3. **Otkazivanje rezervacije (guest ili admin)**
**ReservationCancelledMail** (`emails/reservation-cancelled.blade.php`)
- Šalje se nakon otkazivanja (guest klik ili admin akcija)
- **Subject:** "Rezervacija otkazana - Krčma Petrić"
- **Sadržaj:**
- Potvrda otkazivanja
- Detalji otkazane rezervacije
- Link "Nova Rezervacija" (vodi na `/rezerviraj`)
- Kontakt informacije
---
## 🔄 Flow Korištenja
### Scenario 1: Guest potvrđuje rezervaciju
1. **Korisnik podnese rezervaciju** → Status: `pending`
2. **Token se automatski generira** (64 random karaktera)
3. **Email se šalje korisniku** s linkovima
4. **Korisnik klikne "Potvrdi Rezervaciju"** → Stranica `/potvrdi-rezervaciju/{token}`
5. **Korisnik vidi detalje** i klikne gumb "Potvrdi" (POST forma)
6. **Status** → `confirmed`, `confirmed_at` = now()
7. **EMAIL ŠALJE SE** korisniku (ReservationConfirmedMail)
8. **Success poruka** + korisnik vidi potvrđeni status
---
### Scenario 2: Admin potvrđuje rezervaciju
1. **Admin se logira** → `/login`
2. **Admin otvara dashboard** → `/admin/rezervacije`
3. **Admin filtrira** rezervacije (npr. samo "pending")
4. **Admin klikne "Potvrdi"** gumb
5. **Confirm popup** → "Jeste li sigurni?"
6. **POST zahtjev** → `AdminReservationsController@confirm`
7. **Status** → `confirmed`, `confirmed_at` = now()
8. **EMAIL ŠALJE SE** korisniku (ReservationConfirmedMail)
9. **Logging:** Admin akcija, admin email
10. **Flash success** poruka u dashboardu
---
### Scenario 3: Guest otkazuje rezervaciju
1. **Korisnik otvara link iz emaila** → `/potvrdi-rezervaciju/{token}`
2. **Korisnik vidi detalje** i klikne gumb "Otkaži" (POST forma)
3. **Confirm popup** → "Jeste li sigurni?"
4. **Status** → `cancelled`
5. **EMAIL ŠALJE SE** korisniku (ReservationCancelledMail)
6. **Logging** → Guest akcija zabilježena
---
### Scenario 4: Admin otkazuje rezervaciju
1. **Admin u dashboardu** klikne "Otkaži" gumb
2. **Confirm popup** → "Jeste li sigurni?"
3. **Status** → `cancelled`
4. **EMAIL ŠALJE SE** korisniku (ReservationCancelledMail)
5. **Logging:** Admin akcija, admin email
6. **Flash success** poruka
---
## 🔐 Sigurnost
✅ **Unique token** - 64 karaktera = 64^64 mogućnosti
✅ **Database index** - Brzo pretraživanje po tokenu
✅ **404 za nepostojeće tokene** - `firstOrFail()`
✅ **Provjera statusa** - Ne može se dvaput potvrditi/otkazati
✅ **Guest rute** - Ne zahtijevaju autentikaciju
✅ **Admin rute** - Zaštićene `auth` middleware
✅ **CSRF protection** - Na svim POST zahtjevima
✅ **JavaScript confirm** - Za sve akcije (potvrdi/otkaži)
✅ **Error handling** - Try-catch za email slanje
---
## 📊 Status Rezervacije
| Status | Opis | Kako se postiže | Email notifikacija |
|--------|------|-----------------|---------------------|
| `pending` | Čeka potvrdu | Nova rezervacija | ReservationConfirmationMail (inicijalna) |
| `confirmed` | Potvrđeno | Guest/Admin potvrda | ReservationConfirmedMail |
| `cancelled` | Otkazano | Guest/Admin otkazivanje | ReservationCancelledMail |
---
## 👤 Admin Pristup
### Korisnici
**Admin korisnici:**
- `info@krcma-petric.com` / Krčma2026??!!
- `test@example.com` / Krčma2026??!!
### Navigacija
**Topbar** (kada je korisnik prijavljen):
- Prikazuje ime korisnika
- Link "Admin" → `/admin/rezervacije`
- Link "Odjava"
**Main Menu** (kada je korisnik prijavljen):
- Dodana stavka "Admin" (ikonica ⚙️) → `/admin/rezervacije`
### Pristup Dashboardu
1. Idi na `/login`
2. Prijavi se s admin korisnikom
3. Automatski redirect na dashboard ili klikni "Admin" u meniju
4. Dashboard: `/admin/rezervacije`
---
## 🎨 Frontend Promjene
### Homepage Rezervacijska Forma
**Problem:** Forma na homepage je bila "razvaljena" - nije imala istu strukturu kao na `/rezervacija` stranici.
**Rješenje:**
```html
```
**Rezultat:**
- ✅ Scroll na `#order-form` sada RADI
- ✅ Forma centrirana i stilizirana kao na `/rezervacija`
- ✅ Hash linkovi (`href="#order-form"`) rade ispravno
---
### Hrvatski Fontovi (č, ć, š, ž, đ)
**Problem:** Lokalni fontovi (`BebasRegular`, `open_sansregular`) nisu imali UTF-8 podršku za hrvatske znakove.
**Rješenje:** Google Fonts s custom CSS override
**Dodano u `layouts/bistro.blade.php`:**
```html
```
**Kreiran** `public/bistro/css/custom-croatian.css`:
```css
body, p, div, span, a, li, td, th, input, textarea, select, button {
font-family: 'Open Sans', sans-serif !important;
}
h1, h2, h3, h4, h5, h6, .heading {
font-family: 'Bebas Neue', sans-serif !important;
}
```
**Rezultat:**
- ✅ Svi hrvatski znakovi se pravilno prikazuju
- ✅ Konzistentan font kroz cijelu aplikaciju
---
## 🐛 Debugbar
**Problem:** Debugbar nije radio jer je bio `DEBUGBAR_ENABLED=false` u `.env`.
**Rješenje:**
```env
DEBUGBAR_ENABLED=true
```
**Komande izvršene:**
```bash
php artisan vendor:publish --provider="Barryvdh\Debugbar\ServiceProvider"
php artisan config:clear
php artisan cache:clear
```
**Rezultat:**
- ✅ Debugbar vidljiv na dnu stranice (development mode)
---
## 📝 Logging
Sve akcije se logiraju u `storage/logs/laravel.log`:
**Guest akcije:**
```php
Log::info('Rezervacija potvrđena putem guest linka', [
'reservation_id' => $reservation->id,
'name' => $reservation->name,
'date' => $reservation->date,
'time' => $reservation->time,
]);
```
**Admin akcije:**
```php
Log::info('Admin manually confirmed reservation', [
'reservation_id' => $reservation->id,
'name' => $reservation->name,
'email' => $reservation->email,
'admin_user' => auth()->user()->email,
]);
```
**Email slanje:**
```php
Log::info('Confirmation email sent to guest', ['email' => $reservation->email]);
Log::error('Failed to send confirmation email', [
'reservation_id' => $reservation->id,
'error' => $e->getMessage(),
]);
```
---
## ✅ Testiranje
### Testni Podaci
Kreirano 13 testnih rezervacija za dashboard testiranje:
```bash
php artisan tinker --execute "
\$faker = Faker\Factory::create('hr_HR');
for (\$i = 0; \$i < 5; \$i++) {
\App\Models\Reservation::create([...]);
}
"
```
### Testiranje Scenarija
**1. Nova rezervacija**
- ✅ Popuni formu na `/rezerviraj`
- ✅ Provjeri email (potvrda korisniku + notifikacija adminu)
- ✅ Klikni link u emailu
- ✅ Potvrdi ili otkaži rezervaciju
- ✅ Provjeri email nakon akcije
**2. Admin potvrđuje**
- ✅ Logiranje na `/login`
- ✅ Pristup `/admin/rezervacije`
- ✅ Filter by status="pending"
- ✅ Klikni "Potvrdi"
- ✅ Provjeri email korisnika
**3. Admin otkazuje**
- ✅ Admin dashboard
- ✅ Klikni "Otkaži"
- ✅ Provjeri email korisnika
---
## 🔮 Napomene & Best Practices
### Email Linkovi
**IMPORTANT:** Linkovi u email-ima (`$reservation->confirmation_url` i `$reservation->cancellation_url`) **NE ŠALJU** direktno na POST akcije!
**Zašto?** Email linkovi su GET zahtjevi (obični ``), POST rute vraćaju `MethodNotAllowedHttpException`.
**Kako radi:**
- Oba linka vode na **istu stranicu**: `/potvrdi-rezervaciju/{token}` (GET)
- Na stranici korisnik vidi detalje i ima **POST forme** s gumbima "Potvrdi" ili "Otkaži"
- Eventi se šalju POST metodom preko forme (`