# Implementacija Mail Sustava

**Datum implementacije:** 20.03.2026
**Zadnje ažurirano:** 21.09.2026 — brand redizajn mail UI-ja

> **Napomena:** ovaj dokument opisuje **funkcionalnost** mail sustava (tko, kada i čime šalje).
> Za **izgled i sadržaj** mailova (brand tema, logo, footer, tekstovi) vidi
> [`2026-09-21-TO-DO-MAIL-UI.md`](2026-09-21-TO-DO-MAIL-UI.md).

## Pregled

Implementiran je sustav za automatsko slanje email notifikacija za rezervacije. Sustav pokriva nekoliko scenarija:
1. **Nova rezervacija** - Potvrda korisniku + notifikacija adminu
2. **Potvrđena rezervacija** - Email korisniku (guest ili admin akcija)
3. **Otkazana rezervacija** - Email korisniku (guest ili admin akcija)
4. **Kontakt forma** - Poruka s kontakt forme adminu (u upotrebi od `app/Livewire/ContactForm.php`)
5. **Operativni mailovi** - tjedni izvještaj rezervacija, mjesečno čišćenje logova, server izvještaji

Svi mailovi od 21.09.2026 koriste zajedničku **`krcma` brand temu** — tamni header s logom,
bordo/krem paletu i jedinstveni footer s kontakt podacima iz `config/contact.php`.

---

## 📧 Kreirani Mail-ovi

### 1. ReservationConfirmationMail (Inicijalna potvrda)
**Datoteka:** `app/Mail/ReservationConfirmationMail.php`
**View:** `resources/views/emails/reservation-confirmation.blade.php`

**Svrha:** Šalje se korisniku kao potvrda njihove NOVE rezervacije

**Lokalizacija:** HR + EN (`emails.reservation-confirmation` / `emails.en.reservation-confirmation`),
bira se prema `$reservation->locale`.

**Sadržaj:**
- Subject: "Potvrda rezervacije – [ime], [datum]" / "Reservation received – [ime], [datum]"
- Naslov: "Zaprimili smo Vašu rezervaciju"
- Podaci u `x-mail::panel` bloku: datum, vrijeme, broj osoba, napomena
- **Gumbovi:** "Potvrdi rezervaciju" (bordo `#7a2e2a`), "Otkaži rezervaciju" (prigušena `#55504b`)
- **VAŽNO:** Oba gumba vode na `/potvrdi-rezervaciju/{token}` stranicu (GET), NE direktno na POST akcije
- Kontakt informacije dolaze iz zajedničkog footera teme, ne iz tijela maila
- Potpis: "Srdačno, Tim Krčme Petrić" (EN: "Warm regards, The Krčma Petrić Team")

**Primjer korištenja:**
```php
Mail::to($reservation->email)
    ->send(new ReservationConfirmationMail($reservation));
```

---

### 2. NewReservationNotificationMail (Admin notifikacija)
**Datoteka:** `app/Mail/NewReservationNotificationMail.php`
**View:** `resources/views/emails/new-reservation-notification.blade.php`

**Svrha:** Notifikacija administratoru o novoj rezervaciji

**Jezik:** samo hrvatski (interni mail).

**Sadržaj:**
- Subject: "Nova rezervacija – [ime], [datum] u [vrijeme]"
- Svi podaci o rezervaciji u `x-mail::panel` bloku: ime, telefon, email, datum, vrijeme, broj osoba, napomena
- ID rezervacije i vrijeme zaprimanja
- Status rezervacije
- Link "Pogledaj rezervaciju" → `/potvrdi-rezervaciju/{token}`
- Potpis: "Automatska poruka, Sustav Krčme Petrić"

**Primjer korištenja:**
```php
Mail::to(config('mail.from.address'))
    ->send(new NewReservationNotificationMail($reservation));
```

---

### 3. ReservationConfirmedMail (Potvrđena rezervacija) **NOVO!**
**Datoteka:** `app/Mail/ReservationConfirmedMail.php`
**View:** `resources/views/emails/reservation-confirmed.blade.php`

**Svrha:** Šalje se korisniku nakon što potvrdi rezervaciju (guest ili admin akcija)

**Lokalizacija:** HR + EN (`emails.reservation-confirmed` / `emails.en.reservation-confirmed`).

**Sadržaj:**
- Subject: "Rezervacija potvrđena – [ime], [datum]" / "Reservation confirmed – [ime], [datum]"
- Naslov: "Vaša rezervacija je potvrđena"
- Detalji potvrđene rezervacije u `x-mail::panel` bloku (datum, vrijeme, broj osoba, napomena)
- Link "Pogledaj rezervaciju" (za eventualno otkazivanje)
- Kontakt informacije dolaze iz footera teme

**Kada se šalje:**
- Guest klikne "Potvrdi" na `/potvrdi-rezervaciju/{token}` stranici
- Admin klikne "Potvrdi" u dashboardu (`/admin/rezervacije`)

**Primjer korištenja:**
```php
// U ReservationConfirmationController@confirm
Mail::to($reservation->email)->send(new ReservationConfirmedMail($reservation));

// U AdminReservationsController@confirm
Mail::to($reservation->email)->send(new ReservationConfirmedMail($reservation));
```

---

### 4. ReservationCancelledMail (Otkazana rezervacija) **NOVO!**
**Datoteka:** `app/Mail/ReservationCancelledMail.php`
**View:** `resources/views/emails/reservation-cancelled.blade.php`

**Svrha:** Šalje se korisniku nakon što otkaže rezervaciju (guest ili admin akcija)

**Lokalizacija:** HR + EN (`emails.reservation-cancelled` / `emails.en.reservation-cancelled`).

**Sadržaj:**
- Subject: "Rezervacija otkazana – [ime], [datum]" / "Reservation cancelled – [ime], [datum]"
- Naslov: "Vaša rezervacija je otkazana"
- Detalji otkazane rezervacije u `x-mail::panel` bloku
- Link "Nova rezervacija" → `/rezerviraj`
- Kontakt informacije dolaze iz footera teme
- Pozitivna poruka ("Nadamo se da ćemo Vas uskoro vidjeti.")

**Kada se šalje:**
- Guest klikne "Otkaži" na `/potvrdi-rezervaciju/{token}` stranici
- Admin klikne "Otkaži" u dashboardu (`/admin/rezervacije`)

**Primjer korištenja:**
```php
// U ReservationConfirmationController@cancel
Mail::to($reservation->email)->send(new ReservationCancelledMail($reservation));

// U AdminReservationsController@cancel
Mail::to($reservation->email)->send(new ReservationCancelledMail($reservation));
```

---

### 5. ContactFormMail (Kontakt forma)
**Datoteka:** `app/Mail/ContactFormMail.php`
**View:** `resources/views/emails/contact-form.blade.php`

**Svrha:** Šalje poruke s kontakt forme na info email

**Sadržaj:**
- Subject: "Nova poruka s kontakt forme – [ime pošiljatelja]"
- Reply-To: postavljen na email pošiljatelja
- Podaci u `x-mail::panel` bloku: ime, email, telefon (opcionalno), vrijeme zaprimanja
- Tekst poruke i gumb "Odgovori pošiljatelju" (`mailto:`)
- Potpis: "Automatska poruka, Sustav Krčme Petrić"

**Parametri:**
- `$contactName` - Ime i prezime pošiljatelja
- `$contactEmail` - Email pošiljatelja
- `$contactPhone` - Telefon (nullable)
- `$contactMessage` - Tekst poruke

**Primjer korištenja:**
```php
Mail::to(config('mail.from.address'))
    ->send(new ContactFormMail($name, $email, $phone, $message));
```

---

### 6. WeeklyReservationReportMail (Tjedni izvještaj)
**Datoteka:** `app/Mail/WeeklyReservationReportMail.php`
**View:** `resources/views/emails/weekly-reservation-report.blade.php`
**Trigger:** `app/Console/Commands/WeeklyReservationReport.php` (ponedjeljkom, preko `queue()`)

- Subject: "Tjedni izvještaj rezervacija — Krčma Petrić" (samo HR)
- Tablica: ukupno / potvrđene / na čekanju / otkazane, s postocima
- Panel: ukupan broj gostiju i prosjek po rezervaciji
- Prima: `info@krcma-petric.com`

---

### 7. LogsClearedMail (Mjesečno čišćenje logova)
**Datoteka:** `app/Mail/LogsClearedMail.php`
**View:** `resources/views/emails/logs-cleared.blade.php`
**Trigger:** `app/Console/Commands/ClearLogs.php` (prvi dan u mjesecu, preko `queue()`)

- Subject: "Logovi uspješno očišćeni — Krčma Petrić" (samo HR)
- Tablica aplikacijskih logova s veličinom prije čišćenja
- Panel sa zbirom očišćenih server logova (Nginx/Apache)
- Prima: `info@krcma-petric.com`

---

### 8. ServerReportMail i MailEnvMail (Administrativni, s privitcima)
**Datoteke:** `app/Mail/ServerReportMail.php`, `app/Mail/MailEnvMail.php`
**Viewovi:** `emails.server-report`, `emails.mail-env`
**Trigger:** ručne rute u `routes/web.php`

- `ServerReportMail` šalje tri privitka iz `base_path()`: `environment.md`, `mail-env.md`, `server-audit.md`
- `MailEnvMail` šalje `mail-env.md`
- **Pri izmjenama ne dirati `attachments()`** — redizajn se tiče samo viewa

---

### 9. WelcomeMail (test / razvojni)
**Datoteka:** `app/Mail/WelcomeMail.php`
**View:** `resources/views/emails/welcome.blade.php`

- **Ne šalje se gostima.** Ručna test ruta, koristi je vlasnik za provjeru isporuke.
- Sadržaj prepisan 21.09.2026 — maknut razvojni tekst o Laravelu i GitHub repozitoriju,
  sada opisuje mogućnosti admin sustava.

---

## 🔄 Ažurirani Kontroleri

### ReservationForm (Livewire)
**Datoteka:** `app/Livewire/ReservationForm.php`

**Promjene:**
```php
// NOVA rezervacija - šalju se 2 emaila
$reservation = Reservation::create($validated);

// 1. Admin notifikacija (uvijek)
Mail::to(config('mail.from.address'))
    ->send(new NewReservationNotificationMail($reservation));

// 2. Potvrda korisniku (samo ako ima email)
if ($reservation->email) {
    Mail::to($reservation->email)
        ->send(new ReservationConfirmationMail($reservation));
}
```

---

### ReservationConfirmationController (Guest akcije)
**Datoteka:** `app/Http/Controllers/ReservationConfirmationController.php`

**Dodano u `confirm()` metodu:**
```php
$reservation->confirm();

// Šalji confirmation email
try {
    Mail::to($reservation->email)->send(new ReservationConfirmedMail($reservation));
    Log::info('Confirmation email sent to guest');
} catch (\Exception $e) {
    Log::error('Failed to send confirmation email', [...]);
}
```

**Dodano u `cancel()` metodu:**
```php
$reservation->cancel();

// Šalji cancellation email
try {
    Mail::to($reservation->email)->send(new ReservationCancelledMail($reservation));
    Log::info('Cancellation email sent to guest');
} catch (\Exception $e) {
    Log::error('Failed to send cancellation email', [...]);
}
```

---

### AdminReservationsController (Admin akcije) **NOVO!**
**Datoteka:** `app/Http/Controllers/AdminReservationsController.php`

**`confirm()` metoda:**
```php
$reservation->confirm();

// Šalji confirmation email korisniku
try {
    Mail::to($reservation->email)->send(new ReservationConfirmedMail($reservation));
    Log::info('Admin confirmation email sent to guest', [
        'admin_user' => auth()->user()->email,
    ]);
} catch (\Exception $e) {
    Log::error('Failed to send admin confirmation email', [...]);
}
```

**`cancel()` metoda:**
```php
$reservation->cancel();

// Šalji cancellation email korisniku
try {
    Mail::to($reservation->email)->send(new ReservationCancelledMail($reservation));
    Log::info('Admin cancellation email sent to guest', [
        'admin_user' => auth()->user()->email,
    ]);
} catch (\Exception $e) {
    Log::error('Failed to send admin cancellation email', [...]);
}
```

---

## 📁 Struktura Datoteka

```
app/Mail/                                  # 10 Mailable klasa
├── ReservationConfirmationMail.php        # Nova rezervacija → gostu (HR/EN)
├── ReservationConfirmedMail.php           # Potvrđena → gostu (HR/EN)
├── ReservationCancelledMail.php           # Otkazana → gostu (HR/EN)
├── NewReservationNotificationMail.php     # Nova rezervacija → Krčmi
├── ContactFormMail.php                    # Kontakt forma → Krčmi
├── WeeklyReservationReportMail.php        # Tjedni izvještaj → Krčmi
├── LogsClearedMail.php                    # Čišćenje logova → Krčmi
├── ServerReportMail.php                   # Server izvještaj → adminu (3 privitka)
├── MailEnvMail.php                        # Mail dijagnostika → adminu (1 privitak)
└── WelcomeMail.php                        # Test mail (ne šalje se gostima)

resources/views/emails/                    # 13 view datoteka
├── reservation-confirmation.blade.php
├── reservation-confirmed.blade.php
├── reservation-cancelled.blade.php
├── new-reservation-notification.blade.php
├── contact-form.blade.php
├── weekly-reservation-report.blade.php
├── logs-cleared.blade.php
├── server-report.blade.php
├── mail-env.blade.php
├── welcome.blade.php
└── en/                                    # engleske verzije rezervacijskih mailova
    ├── reservation-confirmation.blade.php
    ├── reservation-confirmed.blade.php
    └── reservation-cancelled.blade.php

resources/views/vendor/mail/               # objavljene Laravel mail komponente
├── html/
│   ├── header.blade.php                   # tamni #111111 blok + logo (132px)
│   ├── footer.blade.php                   # kontakt blok iz config/contact.php
│   ├── message.blade.php                  # lokalizirani copyright
│   └── themes/krcma.css                   # BRAND TEMA
└── text/                                  # plain-text fallback (footer + message)

config/contact.php                         # jedinstveni izvor kontakt podataka
public/images/mail/
├── krcma-logo-mail.png                    # krem logo za tamni header (320×230, 20 kB)
└── krcma-logo-mail-bordo.png              # bordo varijanta (rezerva)
```

---

## ⚙️ Konfiguracija

**Mail postavke** (`.env`):
```env
MAIL_MAILER=smtp
MAIL_SCHEME=smtps
MAIL_HOST=mail.krcma-petric.com
MAIL_PORT=465
MAIL_USERNAME=info@krcma-petric.com
MAIL_PASSWORD=***
MAIL_FROM_ADDRESS="info@krcma-petric.com"
MAIL_FROM_NAME="${APP_NAME}"
```

**Brand tema** (`config/mail.php`):
```php
'markdown' => [
    'theme' => 'krcma',
    'paths' => [resource_path('views/vendor/mail')],
],
```

---

## 🎯 Email Flow Matrix

| Akcija | Kome se šalje | Mail klasa | Trigger |
|--------|---------------|------------|---------|
| **Nova rezervacija** | Korisniku | `ReservationConfirmationMail` | `ReservationForm@submit()` |
| **Nova rezervacija** | Adminu | `NewReservationNotificationMail` | `ReservationForm@submit()` |
| **Guest potvrdi** | Korisniku | `ReservationConfirmedMail` | `ReservationConfirmationController@confirm()` |
| **Guest otkaže** | Korisniku | `ReservationCancelledMail` | `ReservationConfirmationController@cancel()` |
| **Admin potvrdi** | Korisniku | `ReservationConfirmedMail` | `AdminReservationsController@confirm()` |
| **Admin otkaže** | Korisniku | `ReservationCancelledMail` | `AdminReservationsController@cancel()` |
| **Kontakt forma** | Krčmi | `ContactFormMail` | `ContactForm@submit()` (Livewire) |
| **Tjedni izvještaj** | Krčmi | `WeeklyReservationReportMail` | `WeeklyReservationReport` (scheduler, queue) |
| **Čišćenje logova** | Krčmi | `LogsClearedMail` | `ClearLogs` (scheduler, queue) |
| **Server izvještaj** | Adminu | `ServerReportMail` | ručna ruta |
| **Mail dijagnostika** | Adminu | `MailEnvMail` | ručna ruta |

---

## 🐛 Error Handling

Svi email slanju koriste **try-catch** blokove:

```php
try {
    Mail::to($email)->send(new SomeMail($data));
    Log::info('Email sent successfully', ['email' => $email]);
} catch (\Exception $e) {
    Log::error('Failed to send email', [
        'email' => $email,
        'error' => $e->getMessage(),
    ]);
}
```

**Benefit:** Greška u slanju emaila **ne prekida** poslovnu logiku (potvrda/otkazivanje i dalje radi)!

---

## 📝 Napomene

- ✅ Svi email templati koriste Laravel Markdown Mailables (`<x-mail::message>`) i `krcma` brand temu
- ✅ Svi mailovi imaju profesionalni, topli ton, bez emojija
- ✅ Kontakt podaci su na jednom mjestu — `config/contact.php` → footer teme
- ⚠️ **Markdown spaja susjedne retke** u jedan odlomak. Detalji unutar `x-mail::panel` bloka
  moraju imati eksplicitan `<br>` na kraju svakog retka, a uvjetni blokovi inline oblik
  (`{{ $reservation->people }}@if($reservation->note)<br>`) da ne ostane višak praznine
- ✅ ContactFormMail ima `replyTo` postavljen na email pošiljatelja
- ✅ Email za potvrdu korisniku šalje se SAMO ako je korisnik ostavio email (opcionalno polje)
- ✅ Admin notifikacija šalje se UVIJEK na `info@krcma-petric.com`
- ✅ **Email linkovi koriste GET metode** - vode na stranicu, ne direktno na POST akcije
- ✅ Logging za sve poslane i neuspjele emailove

---

## ⚠️ Važno: Email Linkovi

**Problem:** Email linkovi (`<a href>`) su GET zahtjevi, ali Laravel rute za potvrdu/otkazivanje koriste POST metodu.

**Rješenje:**
- Linkovi u email-ima vode na **stranicu rezervacije**: `/potvrdi-rezervaciju/{token}` (GET zahtjev)
- Na stranici korisnik ima **POST forme** s gumbovima za potvrdu/otkazivanje
- Nema `MethodNotAllowedHttpException` grešaka!

```php
// Model methods - oba vraćaju istu GET rutu
public function getConfirmationUrlAttribute(): string {
    return route('reservation.confirm.show', ['token' => $this->confirmation_token]);
}

public function getCancellationUrlAttribute(): string {
    return route('reservation.confirm.show', ['token' => $this->confirmation_token]);
}
```

---

## ✅ Status Implementacije

### Brand redizajn — 21.09.2026

- ✅ `krcma` mail tema (`resources/views/vendor/mail/html/themes/krcma.css`)
- ✅ Tamni header `#111111` s krem logom (PNG 132px — SVG ne radi u Gmailu ni Outlooku)
- ✅ Jedinstveni footer s kontakt podacima iz `config/contact.php`, lokaliziran HR/EN
- ✅ Gumbi u brand bojama — bordo `#7a2e2a` za primarnu radnju, `#55504b` za otkazivanje
- ✅ Sadržaj svih 13 viewova prepisan — maknuti emoji, ujednačeni potpisi, interni mailovi samo HR
- ✅ Subjecti ujednačeni u 6 klasa; `NewReservationNotificationMail` više ne ispisuje sirovi Carbon datetime
- ✅ Svih 13 mailova renderano i testno poslano na `mkopcic@gmail.com` i `kristijan.cpn@gmail.com`
- ✅ Gmail web vizualno potvrđen
- ⏳ Preostaje provjera: Outlook, Apple Mail, Roundcube, Gmail Android, dark mode

Detalji: [`2026-09-21-TO-DO-MAIL-UI.md`](2026-09-21-TO-DO-MAIL-UI.md)

### Funkcionalnost — 20.03.2026

- ✅ 4 Mail klase kreirane (confirmation, notification, confirmed, cancelled)
- ✅ 4 Email view-a kreirani (Markdown)
- ✅ Email integracija u ReservationForm (Livewire)
- ✅ Email integracija u ReservationConfirmationController (guest)
- ✅ Email integracija u AdminReservationsController (admin)
- ✅ Try-catch error handling za sve emailove
- ✅ Logging svih email akcija
- ✅ Email linkovi ispravljeni (GET, ne POST)
- ✅ Testirano i funkcionalno

**Sve radi! 🚀**

Kontakt forma je u međuvremenu implementirana — `app/Livewire/ContactForm.php` šalje
`ContactFormMail` na `config('mail.from.address')` s `replyTo` postavljenim na pošiljatelja.
