# TO-DO: Mail UI — redizajn i konzistentnost s web stranicom

**Datum:** 2026-09-21
**Status:** ✅ Implementirano i testirano (13/13 mailova poslano na mkopcic@gmail.com)
**Cilj:** Svi mailovi dobivaju isti vizualni identitet kao web stranica — novi SVG logo "Krčma Petrić", bordo/krem paleta, tipografija, footer s kontaktom. Uz vizualni dio revidira se i sadržaj (tekst, jezik, ton).

Povezano: [`docs/MAIL-IMPLEMENTATION.md`](MAIL-IMPLEMENTATION.md) (postojeća funkcionalna dokumentacija mail sustava — ovaj dokument se bavi **izgledom i sadržajem**, ne slanjem).

---

## 1. Popis svih Mailable klasa

Ukupno **10 Mailable klasa** / **13 view datoteka**, sve koriste `markdown:` view (dakle `x-mail::message` komponente). Prije izmjena sve su koristile **default Laravel template** (plavo-sivi, bez brandinga); sada koriste `krcma` temu.

### A. Gost / kupac — najvažnije za redizajn (5 mailova, 8 view datoteka)

| # | Klasa | Subject (HR / EN) | View(ovi) | Šalje se iz | Prima |
|---|---|---|---|---|---|
| 1 | `ReservationConfirmationMail` | Potvrda rezervacije – … / Reservation received – … | `emails.reservation-confirmation`<br>`emails.en.reservation-confirmation` | [ReservationForm.php:102](../app/Livewire/ReservationForm.php#L102) | Gost |
| 2 | `ReservationConfirmedMail` | Rezervacija potvrđena – … / Reservation confirmed – … | `emails.reservation-confirmed`<br>`emails.en.reservation-confirmed` | [ReservationConfirmationController.php:56](../app/Http/Controllers/ReservationConfirmationController.php#L56)<br>[AdminReservationsController.php:71](../app/Http/Controllers/AdminReservationsController.php#L71) | Gost |
| 3 | `ReservationCancelledMail` | Rezervacija otkazana – … / Reservation cancelled – … | `emails.reservation-cancelled`<br>`emails.en.reservation-cancelled` | [ReservationConfirmationController.php:94](../app/Http/Controllers/ReservationConfirmationController.php#L94)<br>[AdminReservationsController.php:108](../app/Http/Controllers/AdminReservationsController.php#L108) | Gost |
| 4 | `ContactFormMail` | Nova poruka s kontakt forme – … | `emails.contact-form` | [ContactForm.php:71](../app/Livewire/ContactForm.php#L71) | Krčma (reply-to gost) |
| 5 | `WelcomeMail` | Dobrodošli / Welcome | `emails.welcome` | [routes/web.php:194](../routes/web.php#L194) (test ruta) | Gost / korisnik |

Klase 1–3 već imaju **HR/EN lokalizaciju** (`$this->locale(...)` u konstruktoru + zaseban `emails/en/` view). Klase 4–5 su samo HR odnosno miješane HR/EN u jednom tekstu.

### B. Interni / operativni (5 mailova, 5 view datoteka)

| # | Klasa | Subject | View | Šalje se iz | Prima |
|---|---|---|---|---|---|
| 6 | `NewReservationNotificationMail` | Nova rezervacija – … | `emails.new-reservation-notification` | [ReservationForm.php:88](../app/Livewire/ReservationForm.php#L88) | Krčma (info@) |
| 7 | `WeeklyReservationReportMail` | Tjedni izvještaj rezervacija / Weekly Reservation Report | `emails.weekly-reservation-report` | [WeeklyReservationReport.php:62](../app/Console/Commands/WeeklyReservationReport.php#L62) (queue) | Krčma |
| 8 | `LogsClearedMail` | Logovi uspješno očišćeni / Logs Cleared Successfully | `emails.logs-cleared` | [ClearLogs.php:97](../app/Console/Commands/ClearLogs.php#L97) (queue) | Krčma |
| 9 | `ServerReportMail` | Server Report — server.krcma-petric.com | `emails.server-report` | [routes/web.php:210](../routes/web.php#L210) | Admin (+3 privatna prilog-mailova) |
| 10 | `MailEnvMail` | Mail Dijagnostika — info@krcma-petric.com | `emails.mail-env` | [routes/web.php:202](../routes/web.php#L202) | Admin |

Klase 9–10 šalju **priloge** (`environment.md`, `mail-env.md`, `server-audit.md` iz `base_path()`) — pazi da redizajn ne dira `attachments()`.

---

## 2. Zatečeno stanje (nalazi prije izmjena)

1. **Nema objavljenih mail komponenti.** `resources/views/vendor/mail/` ne postoji → svi mailovi renderiraju Laravelov default theme (plavi gumb `#2d3748`, sivi okvir, Helvetica). Nula brandinga.
2. **Logo ne postoji u rasterskom formatu.** Postoji samo `public/bistro/images/krcma-logo.svg` (krem `#F1E9D2`, za tamnu podlogu) i `krcma-logo-bordo.svg` (bordo `#7A2E2A`, za svijetlu podlogu). **SVG se ne prikazuje u Gmailu, Outlooku ni većini mail klijenata** — nužna je PNG konverzija.
3. **Paleta stranice** (izvučeno iz `public/bistro/css/style.css` i `layouts/bistro.blade.php`):
   - Bordo (primarna): `#7a2e2a` — 66 pojavljivanja u style.css
   - Krem (logo na tamnom): `#F1E9D2`
   - Tamna podloga / topbar: `#060606` / `#111111`
   - Tekst sekundarni: `#606060`, obrub: `#c0c0c0`
4. **Tipografija stranice:** Bebas Neue (brand/nav), Oranienbaum (naslovi), Playfair Display, Outfit, Open Sans (tijelo). U mailu su web-fontovi nepouzdani → koristiti ih kao *progressive enhancement* uz sigurni fallback stack (Georgia / Helvetica).
5. **Sadržaj je nekonzistentan:**
   - Emoji u naslovima (`## ✅ Potvrdite Vašu rezervaciju`) — nejednako korišteno.
   - `welcome.blade.php` opisuje **Laravel aplikaciju i GitHub repozitorij** gostu ("moderna Laravel aplikacija za upravljanje restoranom", "pogledajte dokumentaciju na GitHub repozitoriju") — to je razvojni tekst koji ne smije ići gostu.
   - Interni mailovi miješaju HR i EN u istom tekstu (`Tjedni izvještaj rezervacija / Weekly Reservation Report`).
   - Potpisi variraju: "Tim Krčme Petrić" vs `{{ config('app.name') }}`.
   - Kontakt podaci (telefon `+385 31 611 072`, adresa, radno vrijeme) hardkodirani su samo u nekim mailovima, nema footera.
6. **Konverzija SVG→PNG je moguća na serveru** — provjereno: `/usr/bin/convert` (ImageMagick) + `imagick` PHP ekstenzija rade, test rendera `440×316` PNG uspješno.

---

## 3. Plan implementacije

### Faza 1 — Priprema loga za mail
- [x] Generirati PNG iz `krcma-logo.svg` (krem verzija, za tamni header): `public/images/mail/krcma-logo-mail.png` @ **2× retina** (npr. 440px široko renderano, prikaz na 220px).
- [x] Generirati i bordo varijantu `krcma-logo-mail-bordo.png` za slučaj svijetlog headera.
- [x] Optimizirati (pngquant/optipng ako postoji) — cilj < 40 kB.
- [x] Odluka: **linkani** `<img src="{{ asset(...) }}">` (jednostavnije, ali blokiran dok gost ne dopusti slike) vs **CID embed** preko `$message->embed()` (uvijek vidljiv, veći mail). *Preporuka: linkani `asset()`, uz `alt="Krčma Petrić"` stiliziran krem bojom da izgleda pristojno i kad je slika blokirana.*

### Faza 2 — Brand mail theme
- [x] `php artisan vendor:publish --tag=laravel-mail` → stvara `resources/views/vendor/mail/{html,text}/`.
- [x] Novi CSS theme `resources/views/vendor/mail/html/themes/krcma.css` + `'theme' => 'krcma'` u `config/mail.php`.
- [x] Paleta u temi: pozadina `#f1e9d2`-ish krem, kartica bijela, gumb bordo `#7a2e2a`, linkovi bordo, naslovi Oranienbaum/Georgia fallback.
- [x] Prilagoditi `html/header.blade.php` → tamni (`#111111`) blok s logom, centriran.
- [x] Prilagoditi `html/footer.blade.php` → kontakt blok: adresa (Ul. Sv. Leopolda B. Mandića 172/A, Osijek), tel `+385 31 611 072`, `info@krcma-petric.com`, link na web, radno vrijeme 08–23.
- [x] Prilagoditi `html/button.blade.php` da `color="success"`/`"error"` mapiraju na brand varijante (potvrdi = zelena/bordo, otkaži = prigušena siva-crvena), a ne Laravel default.
- [x] Provjeriti da `text/` verzije (plain-text fallback) i dalje rade — Laravel ih generira iz istih markdown viewova.

### Faza 3 — Sadržaj (revizija teksta)
- [x] Ujednačiti potpis svih gost-mailova na **"Srdačno, Tim Krčme Petrić"** (EN: "Warm regards, The Krčma Petrić Team").
- [x] Maknuti razvojni tekst iz `welcome.blade.php` (Laravel/GitHub spominjanje) → napisati gostu primjeren pozdrav.
- [x] Ukloniti/ujednačiti emoji — zadržati najviše jedan funkcionalni (npr. ✅ kod potvrde), ostalo maknuti.
- [x] Interne mailove (6–10) **ostaviti samo na hrvatskom** ili samo EN — ne miješati u istom retku; predložak: HR, jer ih čita Krčma.
- [x] Prebaciti hardkodirane kontakt podatke iz tijela mailova u footer teme (jedno mjesto).
- [x] Provjeriti hrvatske dijakritike (č, ć, ž, š, đ) u svim mailovima — UTF-8 subject encoding.

### Faza 4 — Verifikacija
- [x] Render svih 13 view datoteka (HR + EN) preko tinkera — `php artisan tinker` render svih 13 view datoteka (HR + EN) bez slanja.
- [x] **Vizualna provjera u Gmailu** — potvrđeno OK nakon smanjenja headera.
- [ ] Preostalo: Outlook, Apple Mail, Roundcube, Gmail Android.
- [ ] **Dark-mode provjera na tebi** — Gmail/Apple Mail znaju invertirati boje; krem pozadina je rizična točka.
- [x] Testno slanje svih 13 mailova na mkopcic@gmail.com preko tinkera — svi `SENT`, bez greške.
- [x] `vendor/bin/pint --dirty --format agent` nakon PHP izmjena.
- ~~Feature testovi~~ — preskočeno po dogovoru, verifikacija je odrađena tinkerom i stvarnim slanjem.

---

## 4. Donesene odluke

1. **Header:** tamni `#111111` s krem logom — potvrđeno.
2. **Interni mailovi (6–10):** puni brand, isto kao gost-mailovi — potvrđeno.
3. **`WelcomeMail`:** ne šalje se gostima, dio je vlasnikovog testiranja. Zadržan, ali prepisan — maknut razvojni tekst o Laravelu i GitHubu, sada opisuje admin sustav.
4. **Logo u mailu:** linkani `asset()` (PNG, 34 kB, javno dostupan — provjereno HTTP 200).
5. **EN lokalizacija:** ostaje na rezervacijskim mailovima (1–3). Interni mailovi su sada **samo hrvatski** — maknuto miješanje HR/EN iz istog retka.

---

## 5. Dodirnute datoteke (očekivano)

```
NOVO:
  public/images/mail/krcma-logo-mail.png
  public/images/mail/krcma-logo-mail-bordo.png
  resources/views/vendor/mail/html/*          (publish + izmjene)
  resources/views/vendor/mail/text/*          (publish)
  resources/views/vendor/mail/html/themes/krcma.css

IZMJENA:
  config/mail.php                              ('theme' => 'krcma')
  resources/views/emails/*.blade.php           (8 datoteka — sadržaj)
  resources/views/emails/en/*.blade.php        (3 datoteke — sadržaj)
  app/Mail/WelcomeMail.php                     (moguće: subject/lokalizacija)

NE DIRATI:
  attachments() u ServerReportMail i MailEnvMail
  logika slanja u kontrolerima i Livewire komponentama
```


---

## 6. Što je stvarno napravljeno

### Nove datoteke
- `config/contact.php` — jedinstveni izvor kontakt podataka (adresa, dva telefona, email, radno vrijeme, društvene mreže). Footer svih mailova čita odavde.
- `public/images/mail/krcma-logo-mail.png` — krem logo, 320×230 (prikaz 132px, ~2.4× retina), 20 kB. Javno dostupan (HTTP 200, `image/png`).
- `public/images/mail/krcma-logo-mail-bordo.png` — bordo varijanta u rezervi za svijetlu podlogu.
- `resources/views/vendor/mail/html/themes/krcma.css` — brand tema.
- `resources/views/vendor/mail/**` — objavljene Laravel mail komponente (html + text).

### Izmijenjeno
- `config/mail.php` — dodan `markdown.theme => 'krcma'` i `markdown.paths`.
- `vendor/mail/html/header.blade.php` — tamni `#111111` blok, centrirani logo, kurzivni podnaslov ovisan o jeziku.
- `vendor/mail/html/footer.blade.php` — tamni kontakt blok iz `config/contact.php`, lokaliziran HR/EN.
- `vendor/mail/html/message.blade.php` + `text/{footer,message}.blade.php` — lokalizirani copyright, kontakt i u plain-text verziji.
- Svih **13 view datoteka** u `resources/views/emails/` — novi sadržaj.
- **Subjecti** u 6 Mailable klasa — maknuto miješanje HR/EN, ujednačen en-dash, `NewReservationNotificationMail` sada formatira datum (prije je ispisivao cijeli Carbon datetime string).

### Dizajnerske odluke
- **Header:** tamni `#111111` s krem logom — isto kao navigacija na stranici. Logo je nakon prve vizualne provjere smanjen s 200px na **132px** širine, a padding bloka s `28px/22px` na `18px/14px`, jer je header bio previsok pa je sadržaj tražio scroll.
- **Kartica:** ivory `#fffefb` s bordo linijom `4px #7a2e2a` na vrhu, na krem podlozi `#ece3cf`.
- **Naslovi:** Georgia serif (Oranienbaum nije pouzdan u mailu), H1 bordo.
- **Gumbi:** primarna radnja (potvrdi / pogledaj / nova rezervacija) = bordo `#7a2e2a`; poništavajuća (otkaži) = prigušena `#55504b`. Zelena i crvena iz Laravel defaulta su maknute jer nisu brand boje.
- **Detalji rezervacije** idu u `x-mail::panel` (krem okvir s bordo rubom) umjesto u bullet listu.
- **Potpisi** — dvije dosljedne forme: gost-mailovi `Srdačno, Tim Krčme Petrić` (EN: `Warm regards, The Krčma Petrić Team`), sustavski mailovi `Automatska poruka, Sustav Krčme Petrić`.
- **Emoji** su maknuti u potpunosti (a ne djelomično kao u planu) — ne pristaju uz elegantni ton stranice.

### Zamka koja je usput riješena
Markdown **spaja susjedne retke** u jedan odlomak (soft line break → razmak), pa su se detalji rezervacije renderali u jednom redu. Riješeno eksplicitnim `<br>` na kraju svakog retka u panelima, s tim da uvjetni `@if` blokovi koriste inline oblik (`{{ $reservation->people }}@if($reservation->note)<br>`) kako ne bi ostao višak praznine kad uvjet nije ispunjen.

### Verifikacija
- Svih 13 mailova renderano preko tinkera — bez greške, dijakritike (č, ć, ž, š, đ) ispravne.
- Svih 13 poslano na `mkopcic@gmail.com` i `kristijan.cpn@gmail.com` — svi `SENT`.
- **Baza nije dirana** — testne rezervacije su nespremljeni `new Reservation([...])` objekti u memoriji, bez `save()`. Nema migracija, seedova ni brisanja. Provjereno nakon slanja: 20 rezervacija, zadnji id=34, isto kao prije.
- HR i EN verzije provjerene: tagline, footer, radno vrijeme i copyright prate `locale` rezervacije.
- `vendor/bin/pint --dirty` — čisto.

### Napomena o Pintu
`vendor/bin/pint --dirty` je usput formatirao i `app/helpers.php`, `routes/web.php` i `bootstrap/app.php` — te su datoteke već bile izmijenjene prije ove sesije, pa ih je `--dirty` zahvatio. Izmjene su kozmetičke (razmaci, redoslijed importa) uz jedan maknuti neiskorišteni `use Illuminate\Http\Request;` u `routes/web.php`. Provjereno: `Request` se nigdje u toj datoteci ne koristi, aplikacija se diže i svih 62 ruta se učitava.

### Preostalo (na tebi)
- Vizualna provjera u Outlooku, Apple Mailu, Roundcubeu i Gmailu na Androidu (Gmail web je potvrđen).
- Dark-mode provjera — krem podloga `#ece3cf` je rizična točka jer je Gmail i Apple Mail znaju invertirati.
- Ako logo bude blokiran dok se slike ne dopuste: razmotriti CID embed (`$message->embed()`), +34 kB po mailu.
