# QRMENU PWA Görsel ve Asset Rehberi

## Zorunlu PWA Bileşenleri

- `manifest.webmanifest`
- `sw.js`
- `offline.html`
- favicon seti
- uygulama ikonları
- tema rengi
- Apple touch icon

## Hazır Gelen İkon Seti

Projede aşağıdaki dosyalar hazır gelir:

- `assets/pwa/icon-72x72.png`
- `assets/pwa/icon-96x96.png`
- `assets/pwa/icon-128x128.png`
- `assets/pwa/icon-144x144.png`
- `assets/pwa/icon-152x152.png`
- `assets/pwa/icon-192x192.png`
- `assets/pwa/icon-384x384.png`
- `assets/pwa/icon-512x512.png`
- `assets/pwa/apple-touch-icon.png`
- `assets/pwa/maskable-512x512.png`
- `assets/pwa/favicon-96x96.png`
- `assets/pwa/favicon-192x192.png`

Bu set, V1 kurulumundan sonra boş PWA görünümü bırakmamak için varsayılan olarak kullanılabilir.

Admin panelindeki `Genel Ayarlar` ekranında şu alanlar kaydedildiğinde mevcut logo dosyasından ikonlar ve `manifest.webmanifest` otomatik yeniden üretilir:

- `PWA Uygulama Adı`
- `PWA Kısa Ad`
- `PWA Tema Rengi`
- `PWA Arka Plan Rengi`

## Önerilen İkon Boyutları

En az şu boyutlar hazır olmalıdır:

- `72x72`
- `96x96`
- `128x128`
- `144x144`
- `152x152`
- `192x192`
- `384x384`
- `512x512`

Kurulum sihirbazı ileride tek kare logo yükleyip bu seti otomatik yeniden üretebilir.

## Tasarım Notları

- kare logo kullanılmalı
- şeffaf arka plan yerine kontrollü bir marka zemini tercih edilmeli
- küçük boyutlarda okunabilir olmalı
- marka rengi ile uyumlu olmalı
- `maskable` versiyon ayrıca üretilmeli

## Manifest Alanları

- `name`
- `short_name`
- `description`
- `id`
- `start_url`
- `scope`
- `display`
- `orientation`
- `theme_color`
- `background_color`
- `icons`
- `shortcuts`

## Header ve Tarayıcı Bağlantıları

Frontend `head` bölümünde en az şu alanlar bulunmalıdır:

- `manifest.webmanifest`
- `theme-color`
- `application-name`
- `apple-mobile-web-app-title`
- `apple-touch-icon`
- favicon bağlantıları

Bu alanlar eksik kalırsa PWA yükleme deneyimi zayıflar.

## Offline Fallback

Offline sayfada en az şu alanlar bulunmalıdır:

- logo veya ikon
- “bağlantı yok” mesajı
- menüye dön butonu
- yeniden dene butonu

Amaç, bağlantı koptuğunda kullanıcıyı boş beyaz sayfada bırakmamaktır.

## Satış İçin Not

PWA ikonları eksikse ürün profesyonel görünmez. V1 satış paketinde şu alanlar zorunlu kabul edilmelidir:

- ikon seti
- manifest
- service worker
- offline fallback
- Apple touch icon

## Installability Notları

- `short_name` alanını mobil kurulum yüzeyinde taşmayacak kadar kısa tut
- manifest içinde `display_override`, `categories`, `dir` ve `prefer_related_applications` alanları kullanılabilir
- `menu_only_mode` aktifse manifest kısayollarında sadece menü aksiyonu yayınlanabilir
- `qr_order_mode` aktifse menü ve rezervasyon kısayolları birlikte yayınlanabilir