agent-enderun 1.0.2 → 1.0.4

package/docs/yap/304/261.md

@@ -0,0 +1,2150 @@
+# KENTİM — Sayfa Yapısı ve İşlemler Belgesi (MVP Sürümü)
+
+> Bu belge, proje çekirdeği belgesi (proje.md) ile birlikte okunmalıdır.  
+> Her panelin hangi sayfalardan oluştuğunu, sayfa bazında URL yapısını, erişim kurallarını, içerikleri, form alanlarını ve işlemleri tanımlar.
+
+---
+
+## Genel Kurallar (Tüm Paneller İçin Geçerli)
+
+### URL Yapısı
+
+| Panel | Temel URL |
+| :--- | :--- |
+| Vatandaş Web | `kentim.com.tr/` |
+| Belediye Paneli | `panel.kentim.com.tr/` |
+| Central Panel | `central.kentim.com.tr/` |
+
+### Ortak Sayfalama Kuralları
+
+- Tüm listeleme sayfalarında varsayılan sayfa başına kayıt: **20**
+- Seçenekler: 20 / 50 / 100
+- URL'de `?page=2&limit=50` parametreleriyle yönetilir
+- Toplam kayıt sayısı listenin üstünde gösterilir
+
+### Ortak Form Validasyon Kuralları
+
+| Alan Tipi | Kural |
+| :--- | :--- |
+| Kısa metin (başlık, ad) | Min 3 — Max 150 karakter |
+| Uzun metin (açıklama, not) | Max 2000 karakter |
+| E-posta | RFC 5321 formatı, max 254 karakter |
+| TC Kimlik | 11 hane, T.C. kimlik no algoritması (tek hane kontrolü) uyarınca geçerli |
+| Telefon | `05XXXXXXXXX` formatı (11 hane, Türkiye) |
+| Şifre | Min 8 karakter, en az 1 büyük harf + 1 rakam |
+| Fotoğraf dosyası | JPG / PNG / WEBP, max **5 MB / dosya**, max **5 dosya** |
+| Zorunlu alan | Boş bırakılamaz; kaydet/gönder düğmesi tıklanana kadar hata gösterilmez |
+| Karakter sayacı | 2000 karakterli alanlarda kalan sayaç gösterilir |
+| **Spam Koruması** | Anonim raporlarda Google reCAPTCHA v3 doğrulaması zorunludur. |
+
+### Ortak API ve Güvenlik Kuralları
+
+- **ID Mimarisi:** Tüm kamuya açık ve API bazlı kimlikleyiciler (iş emri, rapor, kullanıcı vb.) için **UUIDv4** kullanımı zorunludur. Sıralı tamsayı (autoincrement ID) kullanımı güvenlik (IDOR) ve veri sayma saldırılarını önlemek amacıyla yasaktır.
+- **Tekilleştirme (Idempotency):** `POST` ve `PATCH` isteklerinde `x-idempotency-key` (UUID) kullanımı zorunludur. Aynı anahtar 24 saat boyunca saklanır.
+- **Eşzamanlılık (Concurrency):** Kayıt güncellemelerinde `ETag` veya `x-version` header'ı ile iyimser kilitleme uygulanır. Sürüm uyuşmazlığında `409 Conflict` dönülür. **Mobil Çevrimdışı / Çakışma Yönetimi:** Çevrimdışı çalışan bir saha personeli internete bağlandığında elindeki eski sürümlü (`x-version` uyuşmazlığı) görev güncellemesini gönderirse ve `409 Conflict` hatası alırsa, mobil uygulama personelin yerel verilerini (taslağı) kesinlikle silmez. Personel arayüzde bir uyarı penceresiyle bilgilendirilir; yerel veri taslak olarak korunur ve iş otomatik olarak "Senkronizasyon Uyuşmazlık Havuzuna" (`dispute_logs`) gönderilerek şefin veya müdürün onayına sunulur.
+- **Veri İzolasyonu ve Güvenlik Uygulaması:**
+  - **Sorgu Kapsamı (Query Scoping):** API seviyesinde (ORM/SQL), kullanıcının JWT token'ından çözülen rol ve ID bilgilerine göre otomatik `WHERE` filtreleri eklenir. (Örn: Müdür için `department_id`, Şef için `team_id`, Personel için `assigned_worker_id` filtreleri).
+  - **Yetki Kontrol Katmanı (RBAC Middleware):** Her kaynak erişiminde (`/work-orders/:id`) kullanıcının ilgili kaydı görme/değiştirme hakkı kontrol edilir; eşleşme sağlanmazsa `403 Forbidden` hatası dönülür.
+  - **Satır Bazlı Güvenlik (Row-Level Security):** Veritabanı seviyesinde (PostgreSQL RLS), rollere göre okuma/yazma politikaları tanımlanarak uygulama katmanından bağımsız bir güvenlik katmanı sağlanır.
+- **Central Reverse Proxy Entegrasyonu:** Tüm panel, mobil ve dış entegrasyon istekleri `api.kentim.com.tr` (Central Gateway / Proxy) üzerinden ilgili belediyenin izole backend sunucusuna (`http://muni-x-backend.internal`) güvenli tünellerle yönlendirilir. Proxy katmanı, `Authorization` başlığındaki JWT token'ından `tenant_id`'yi çözerek isteği ilgili belediyeye iletir ve HTTP isteklerine otomatik `x-tenant-id` başlığını ekler.
+- **Dahili Not Düzenleme / Silme Politikası:** Moderatör, müdür veya şef tarafından rapor veya iş emirlerine eklenen dahili notlar, ekleyen kişi tarafından **yalnızca ilk 15 dakika içerisinde** düzenlenebilir veya silinebilir. 15 dakika dolduktan sonra denetim loglarının bütünlüğü ve geçmiş izlenebilirlik (audit trail) açısından notlar kalıcı olarak kilitlenir; düzenleme veya silme eylemleri tamamen engellenir.
+- **İş Emri ve Rapor Fiziksel Silme Politikası (Hard Delete Forbidden):** İş emirleri ve vatandaş raporları veritabanından hiçbir koşulda fiziksel olarak silinemez (Hard delete yasaktır). `rejected` veya `resolved` durumlarında arşivlenmiş olarak saklanır. KVKK silme/unutup silinme taleplerinde dahi veritabanı satırı korunur; yalnızca kişisel veriler maskelenir/anonimleştirilir (`citizen_id = null`, `description` maskelenir, fotoğraflar fiziksel olarak silinir ve CDN üzerinde bulunan fotoğraf URL'leri invalidate edilir) ancak iş emri bütünlüğü ve istatistiksel raporlama satırı korunmaya devam eder.
+- **Hız Sınırlama (Rate Limiting):** 
+  - Vatandaş API: IP başına 100 istek / 15 dakika.
+  - Anonim Rapor: IP başına 2 rapor / 1 dakika, 10 rapor / gün.
+  - Public API: IP başına 60 istek / 1 dakika.
+  - Belediye Paneli: Kullanıcı başına 1000 istek / 15 dakika.
+  - **Panik Butonu / Acil Sinyal:** Rate limiting kurallarından muaftır; düşük bant genişliği için sadece GPS koordinat paketi (lightweight) iletilir. **DDoS ve İstismar Koruması:** Sahte acil durum sinyali botlarını ve spam girişimlerini engellemek amacıyla, IP-tabanlı olmasa dahi cihaz bazlı (Device ID) hafif bir rate limit katmanı sunucu tarafında doğrulanır. Aynı Device ID'den dakikada **maksimum 5 panik sinyali** kabul edilir; bu limiti aşan istekler HTTP 429 Too Many Requests ile istemci seviyesinde sessizce reddedilir.
+- **Coğrafi Doğrulama (Geofencing) & Sınır Sürüm Kilidi:** Raporlama API'si, koordinatların belediye sınırları (`boundaries`) içerisinde olup olmadığını sunucu tarafında kontrol eder. Depolama alanı şişmesini (bloating) engellemek amacıyla sınır geometrisi her satıra kopyalanmaz. İş emri oluşturulurken, o anki belediye sınır poligonunun sürüm referansı **"Boundary Version"** (`boundary_version_id` UUID'si) olarak iş emri satırına atanır ve kilitlenir. Saha çalışanının işi tamamladığı andaki geofence doğrulaması (`ST_Contains`), `municipal_boundary_versions` tablosu JOIN edilerek, işin oluşturulduğu andaki bu kilitli sürüm poligonu üzerinden gerçekleştirilir. Böylece personel sınır daralmalarından dolayı lockout hatası almaz.
+
+### Tasarım ve Görsel Standartlar
+
+| Element | Renk Kodu | Kullanım Amacı |
+| :--- | :--- | :--- |
+| **Danger Red** | `#a44a3f` | SLA aşımı, kritik hatalar, silme butonları, devre kesici uyarıları |
+| **Forest Green** | `#2C5F2D` | Başarılı işlemler, `resolved` durumları, onay butonları |
+| **Lime** | `#97BC62` | İkincil başarılar, aktif durumdaki olumlu rozetler |
+| **Sage** | `#e8f0e1` | Arka plan zeminleri, ikincil bilgi kartları (göz yormayan) |
+| **Cream** | `#f9fbf7` | Genel sayfa zemini, ana listeleme alanları |
+
+- **İkonografi:** Karmaşıklığı azaltmak için minimalist, yuvarlatılmış köşeli düz (flat) vektör ikonlar tercih edilmelidir.
+- **Bilişsel Yük:** Ekranlardaki metin yoğunluğu ikonlar ve renk kodlarıyla dengelenerek operasyonel okuma hızı maksimize edilmelidir.
+
+### Bildirim Merkezi (Belediye ve Central Paneli)
+
+Panelin üst çubuğunda zil simgesi yer alır:
+- Okunmamış bildirim varsa kırmızı rozet sayısıyla gösterilir
+- Zile tıklanınca sağ üstten açılan liste (dropdown) görünür; son 20 bildirim listelenir
+- Her bildirim: başlık + kısa açıklama + zaman damgası + ilgili iş emrine bağlantı
+- "Tümünü okundu işaretle" butonu
+- "Tüm bildirimler" bağlantısı tam bildirim sayfasına yönlendirir
+- **Gerçek zamanlı:** Belediye paneli WebSocket (veya SSE) bağlantısıyla anlık güncelleme alır; Central Panel 60 saniyede bir polling yapar
+
+### Hata Sayfaları (Tüm Paneller)
+
+| Hata | Sayfa İçeriği |
+| :--- | :--- |
+| **404 Sayfa Bulunamadı** | Logo, hata mesajı, ana sayfaya / panele dön butonu |
+| **403 Yetkisiz Erişim** | Logo, "Bu sayfaya erişim yetkiniz yok" mesajı, panele dön butonu |
+| **402 Abonelik Süresi Doldu** | Belediye logosu, bitiş tarihi, "Yenileme için lütfen merkezi yönetimle iletişime geçin" mesajı; vatandaş ve panel erişimi **kısıtlı salt-okunur moda geçer**. Yeni rapor, iş emri ve **sıfırdan (yeni) atama** yapılamaz. Ancak hali hazırda devam eden ve personel tarafından yarıda bırakılan veya devredilen mevcut aktif işlerin başka bir personele yeniden atanmasına (re-assign) 7 günlük süre boyunca izin verilir. **Saha Uygulaması:** Mevcut işlerin tamamlanması ve şef onayı için 7 gün boyunca "salt-tamamlama" modunda çalışmaya devam eder (yeni iş ataması kabul edilmez). **Grace Period'da Kaynak Tipine Göre Davranış:** Yeni vatandaş raporu (`citizen_report`) kabul edilmez. IoT telemetri (`integration`) kabul edilir ama eşik aşılsa bile yeni iş emri tetiklenmez. Periyodik scheduler (`scheduled`) askıya alınır. |
+| **Public Harita Pasif** | "Bu belediye için halka açık harita henüz etkin değildir. Rapor oluşturmak için [buraya](/?modal=report) tıklayabilir veya belediye ile iletişime geçebilirsiniz." uyarılı graceful fallback sayfası; sitemap ve SEO için robots meta noindex uygulanır. |
+| **500 Sunucu Hatası** | Logo, teknik hata mesajı, sayfayı yenile butonu |
+| **Ağ / Bağlantı Hatası** | Offline banner; mevcut veriler önbellekten gösterilir, yeni veri çekilemez uyarısı |
+
+### Oturum Yönetimi
+
+- JWT tabanlı token; Access token süresi: **15 dakika** (Saha personeli mobil uygulaması için **2 saat**, şef (`muni_team_chief`) mobil: **2 saat**, web paneli: **1 saat**), Refresh token süresi: **7 gün**
+- "Beni hatırla" seçeneği: refresh token süresi **30 güne** uzar
+- Oturum süresi dolduğunda sayfa yenilenmeden toast mesajıyla uyarılır; kullanıcı bir sonraki API isteğinde giriş sayfasına yönlendirilir
+- Aynı hesap birden fazla cihazda aktif olabilir
+- Çıkış yapıldığında yalnızca ilgili cihazın token'ı geçersiz kılınır; "Tüm cihazlardan çıkış" seçeneği profil sayfasında mevcuttur
+
+---
+
+## BÖLÜM 1: Vatandaş Web — `kentim.com.tr`
+
+### 1.0 Kimlik Doğrulama Akışları
+
+#### 1.0.1 Kayıt Akışı
+
+```
+Kullanıcı → "Hesap Oluştur" butonuna tıklar
+    ↓
+[Adım 1 — İletişim Bilgisi]
+  E-posta adresi girişi (zorunlu - SMS maliyet ve bot riskini sıfırlamak için telefon numarası kullanılmaz)
+  KVKK Açık Rıza metni onay kutusu (Zorunlu; "Raporunuz anonim olarak halka açık haritada görünebilir" uyarısını içerir)
+  İsteğe bağlı e-posta bildirim izni kutusu (Tüm OTP kodları strictly asenkron e-posta ile iletilir)
+    ↓
+[Adım 2 — E-posta OTP Doğrulama]
+  6 haneli OTP kodu (E-posta ile gönderilir); 5 dakika geçerli
+  "Kodu tekrar gönder" butonu: 60 saniye bekleme süresi ile aktif olur
+  3 yanlış denemede 15 dakika bekleme kilidi
+    ↓
+[Adım 3 — Şifre Oluşturma]
+  Şifre (min 8 karakter, 1 büyük harf, 1 rakam)
+  Şifre tekrar — eşleşme anlık kontrol edilir
+    ↓
+[Adım 4 — İsteğe Bağlı Profil & MERNIS]
+   Ad, soyad (displays adı / nickname) (opsiyonel)
+   Mahalle seçimi — bölge → şehir → ilçe → mahalle hiyerarşisi (opsiyonel)
+   TC Kimlik Doğrulama Formu (opsiyonel, fikir oylama/fikir oluşturma için gereklidir)
+   Resmi T.C. Kimlik Doğrulama Modal'ı — displays adı (takma ad) korunarak MERNIS doğrulaması resmi bilgilerle (TCKN, resmi Ad, resmi Soyad, Doğum Yılı) asenkron tamamlanır. Profil `is_identity_verified = true` olur.
+     ↓
+ Kayıt tamamlandı → Dashboard'a yönlendir
+```
+
+#### 1.0.2 Giriş Akışı
+
+```
+E-posta + şifre girişi (telefon girişi kesinlikle bulunmaz)
+  → Hatalı giriş: 5 denemede 15 dakika kilidi
+  → Başarılı: Dashboard'a yönlendir
+  → "Şifremi unuttum" bağlantısı
+```
+
+#### 1.0.3 Şifre Sıfırlama Akışı
+
+```
+[Adım 1] E-posta adresini gir
+    ↓
+[Adım 2] E-posta OTP kodu gönderilir (5 dakika geçerli)
+    ↓
+[Adım 3] Yeni şifre belirle (validasyon kuralları aynı)
+    ↓
+Giriş sayfasına yönlendir + "Şifreniz başarıyla güncellendi" bildirimi
+```
+
+---
+
+### 1.1 Ana Sayfa (Home) — Map-First Deneyim
+
+**URL:** `/`  
+**Erişim:** Herkese açık (anonim + hesaplı)  
+**Amaç:** Vatandaşın ilk açtığı sayfa **doğrudan tam teşekküllü Halka Açık Sorun Haritası**'dır. Harita sayfanın ana ve baskın öğesidir. Diğer tüm vatandaş akışları (rapor oluşturma, takip, duyurular, fikirler vb.) bu harita üzerinde **modal / slide-over** olarak açılır.
+
+#### Sayfa Yapısı ve Davranış
+
+**A. Üst Çubuk (Header)**
+- Sol: KENTİM logosu + aktif belediye adı (otomatik veya manuel seçim)
+- Sağ: Giriş / Kayıt veya Profil dropdown
+- Hızlı aksiyon butonları (header veya floating):
+  - **Yeni Rapor Oluştur** → Harita üzerinde konum seçili olarak **modal** açılır
+  - **Raporumu Takip Et** → Takip kodu girişi **modal** olarak açılır
+  - **Halka Açık İstatistikler** → Harita üzerinde sol alt köşede yüzen, anlık dinamik verileri sunan şeffaf bilgi paneli (Widget)
+  - Panik / Acil Butonu (her zaman görünür)
+
+**B. Baskın Halka Açık Harita (Ana Alan)**
+- Tam ekran veya çok büyük Leaflet haritası (CartoDB Positron)
+- **Başlangıç Görünümü:** Harita ilk açıldığında **Türkiye geneli** (ülke seviyesi, yaklaşık Zoom 6-8) gösterilir. Bu seviyede büyük bölgesel cluster’lar veya il bazlı özet sayıları görünür.
+- Kullanıcı zoom yaptıkça ve haritayı kaydırdıkça sistem otomatik olarak detay seviyesini artırır:
+  - Düşük zoom (Zoom 5-10): Türkiye geneli / İl bazlı özet cluster’lar
+  - Orta zoom (Zoom 11-14): İlçe ve mahalle seviyesinde cluster + pin karışımı
+  - Yüksek zoom (Zoom 15-17+): Mahalle ve sokak bazlı tekil pinler (fuzzing uygulanmış)
+- Serbest pan + zoom ile dinamik veri yükleme (BBOX + zoom seviyesine göre cluster/pin)
+- Viewport bazlı pin yükleme, `Leaflet.markercluster`, ısı haritası toggle
+- Konum bazlı başlangıç zoom (GPS / profil / belediye) ancak ilk açılış her zaman Türkiye geneli ile başlar
+- Çok belediyeli geçiş: Harita kaydırıldığında diğer belediye sınırına girince banner ile yönlendirme
+- Pin tıklanınca hafif popup → "Detayları Gör" ile **drawer/modal** açılır (fotoğraflar, zaman çizelgesi, +1 desteği)
+
+**C. Harita Üzerinden Açılan Modal / Drawer Akışları**
+Tüm diğer vatandaş özellikleri harita üzerinde modal olarak yönetilir:
+
+- **Rapor Oluşturma** (`/report/new` artık bağımsız sayfa değil): Haritadan konum seç → "Rapor Oluştur" butonu → Adım adım form **modal** içinde
+- **Rapor Takip**: Takip kodu modalı → Sonuç **drawer/modal** içinde gösterilir
+- **Duyurular**: "Duyurular" butonu → Liste + detay **modal** olarak açılır
+- **Fikir Önerileri**: Liste + oy + yeni fikir **modal** olarak yönetilir
+- **Geri Dönüşüm Haritası**: Katman toggle veya ayrı **modal** ile gösterilir
+- **Profil / Dashboard**: Giriş yapmış vatandaş için profil ve kişisel raporlar **modal** içinde
+
+**D. Panik / Acil Durum**
+- Her zaman erişilebilir buton → Konum izni sonrası onay modalı → Acil sinyal doğrudan haritaya yansır (kriz katmanı aktifleşir)
+
+**E. Footer**
+- Sadece temel bağlantılar (KVKK, Gizlilik, İletişim). Ana navigasyon harita ve modal'lar üzerinden yapılır.
+
+**Not:** Afet modu aktif olduğunda harita otomatik olarak afet katmanlarını (toplanma alanları, tahliye rotaları) gösterir ve panik butonu öne çıkar.
+
+---
+
+### 1.1.1 Halka Açık Sorun Haritası (Artık Ayrı Sayfa Değil)
+
+**Not (MVP UX):**  
+Vatandaş web’inde **ayrı bir `/map` sayfası yoktur**. Halka açık sorun haritası artık **Ana Sayfa (`/`)** ’ın baskın ve ana öğesidir. 
+
+Tüm vatandaş etkileşimleri (rapor oluşturma, takip, duyurular, fikirler, geri dönüşüm haritası vb.) bu harita üzerinde **modal / slide-over drawer** olarak açılır. 
+
+Ayrıntılı harita davranışı (viewport bazlı yükleme, zoom seviyelerine göre granülarite, serbest pan/zoom, çok belediyeli geçiş, pin etkileşimi) yukarıdaki **1.1 Ana Sayfa (Home) — Map-First Deneyim** bölümünde tanımlanmıştır.
+
+Eski `/map` rotası kaldırılmış veya `/` adresine yönlendirilmektedir.
+
+---
+
+### 1.1.2 Halka Açık İstatistik Widget'ı (Public Statistics Widget)
+
+Ana sayfa (`/`) üzerinde yüzen veya sol alt köşede konumlandırılmış olan bu widget, vatandaşlara ve ziyaretçilere KENTİM platformunun şeffaflık vizyonunu anlık verilerle sunar. `GET /v1/public/statistics` API ucundan beslenen widget aşağıdaki dinamik özet metrikleri içerir:
+
+1. **Aktif Çözülen Sorun Sayısı (Resolved Counts):** Platform genelinde (veya seçili belediye sınırlarında) başarıyla çözüme kavuşturulmuş ve `resolved` durumuna getirilmiş toplam sorun sayısı.
+2. **Saha Çalışması Sürenler (In-progress):** Ekipler tarafından onaylanmış, iş emri atanmış ve sahada aktif müdahale aşamasında (`in_progress`, `on_the_way`) olan güncel iş adedi.
+3. **Vatandaş Desteği (+1):** Vatandaşlar tarafından "+1 Beni de Etkiliyor" butonu kullanılarak desteklenen ve topluluk duyarlılığını gösteren toplam destek oyu sayısı.
+4. **Ortalama Çözüm Süresi (Avg SLA / SLA Compliance):** İlgili belediyenin son 30 gün içinde tamamlanan iş emirlerinde hedef SLA sürelerine uyum yüzdesi veya ortalama sorun kapatma süresi (gün/saat bazında).
+
+*Görsel ve UX Kuralları:*
+- Widget, koyu modda yarı saydam (glassmorphic) yapıda, `backdrop-filter: blur(8px)` ve sage/forest green tonlarında ince bir çerçeve ile tasarlanmıştır.
+- Her metrik kartı, üzerine gelindiğinde (hover) hafifçe yukarı doğru hareket eden (micro-animation) ve açıklayıcı bir ikon barındıran mikro kartlardan oluşur.
+- Mobil cihazlarda ekran alanını kaplamaması için otomatik olarak katlanabilir (collapsible) mini modül yapısına bürünür.
+
+---
+
+### 1.2 Rapor Oluşturma
+
+**Tetiklenme:** Home haritası üzerinde "Yeni Rapor Oluştur" butonu ile açılır  
+**Amaç:** Vatandaşın harita üzerinden konum seçerek sorun bildirmesi.  
+**Not:** Artık ayrı tam sayfa değildir. Harita üzerinde konum seçildikten sonra **adım adım modal** içinde tamamlanır.
+
+#### Adımlı Form Yapısı (3 Adım)
+
+**Adım 1 — Konum Seçimi**
+
+> **Harita Davranışı:** Rapor oluşturma modal'ı açıldığında, modal içinde modal-özgü (ayrı Leaflet nesnesi) tam genişlikte bir harita görünür. Ana sayfa haritası arka planda donuk kalır. Modal haritası başlangıç olarak kullanıcının GPS konumuna (varsa) veya belediye merkezine odaklanır.
+
+| Alan | Tür | Kural |
+| :--- | :--- | :--- |
+| Harita | Leaflet interaktif harita | Tıklama ile pin bırakma; "Konumumu Kullan" butonu ile GPS |
+| İl | Otomatik dolu (haritadan) | Değiştirilebilir dropdown |
+| İlçe | Otomatik dolu (haritadan) | Değiştirilebilir dropdown |
+| Mahalle | Otomatik dolu (haritadan) | Değiştirilebilir dropdown |
+| Sokak / Adres Notu | Metin | Opsiyonel, max 200 karakter |
+
+- **Önleyici Mükerrer Kontrolü:** Harita üzerinde konum seçildiği (pin bırakıldığı) anda sunucu 50–100m yarıçapındaki aktif public raporları tarar. Eşleşme bulunursa sarı uyarı pinleri ve bilgi kutusu açılır. Vatandaş "+1 Beni de Etkiliyor" seçeneğini tıklarsa form kapatılır ve teşekkür modalı gösterilir. "Hayır, farklı sorun" derse normal forma devam edilmesine izin verilir.
+
+**Adım 2 — Rapor Detayı**
+
+| Alan | Tür | Kural |
+| :--- | :--- | :--- |
+| Kategori | Dropdown | Zorunlu; global + belediye kategorileri listelenir |
+| Başlık | Metin | Zorunlu; min 3, max 150 karakter |
+| Açıklama | Textarea | Zorunlu; min 10, max 2000 karakter; karakter sayacı gösterilir |
+| Fotoğraf | Dosya yükleme (çoklu) | Opsiyonel; JPG/PNG/WEBP; max 5 dosya, max 5 MB/dosya; önizleme gösterilir; kategoriye göre zorunlu olabilir (muni_admin tarafından belirlenir) |
+
+**Adım 3 — Onay ve Gönderim**
+
+| Alan | Tür | Kural |
+| :--- | :--- | :--- |
+| KVKK Açık Rıza metni | Onay kutusu | Zorunlu; metin scrollable modal içinde gösterilir ("Raporunuz anonim olarak halka açık haritada görünebilir ve girdiğiniz opsiyonel iletişim bilgileri asenkron bildirimler amacıyla işlenebilir" uyarısını içerir) |
+| SMS bildirimi (anonim) | Telefon + onay kutusu | Opsiyonel; anonim kullanıcı "SMS ile Çözüm Bildirimi Al" checkbox'ını seçerse telefon giriş alanı aktifleşir ve doğrulanır |
+| E-posta bildirimi (anonim) | E-posta + onay kutusu | Opsiyonel; anonim kullanıcı "E-posta ile Çözüm Bildirimi Al" checkbox'ını seçerse e-posta giriş alanı aktifleşir ve doğrulanır |
+| **Güvenlik Doğrulaması** | CAPTCHA | Anonim raporlarda Google reCAPTCHA v3 (arka plan doğrulaması) |
+
+- **Spam Koruması:** IP bazlı hız sınırlaması (2 rapor/dakika) aşıldığında "Çok fazla istek, lütfen bekleyin" uyarısı gösterilir.
+- **Anonim Kullanıcı Bildirim Tercihi:** Anonim kullanıcılar isteğe bağlı olarak SMS veya E-posta kanallarını işaretleyerek iletişim bilgilerini girer. Bu bilgiler KVKK Açık Rıza Onayı kapsamında strictly asenkron bilet bilgilendirmeleri için saklanır.
+- Hesaplı kullanıcı: bildirim tercihleri profilden otomatik alınır, 3. adımda yalnızca onay kutusu gösterilir
+- Gönder butonu → Başarı sayfasına yönlendir
+
+**Başarı Durumu**
+- Takip kodu büyük ve belirgin gösterilir: `KENT-[plaka]-XXXXXXXX`
+- "Kodu Cihazıma PDF/Resim Olarak İndir" butonu
+- "Kopyala" butonu
+- "Rapora git" butonu → `/?modal=track&code=:trackingCode` modal/drawer'ını açar
+- "Yeni Rapor Oluştur" butonu → `/?modal=report` modal'ını açar konum seçilmiş olarak
+
+---
+
+### 1.3 Rapor Takip
+
+**Tetiklenme:** Home haritası header veya floating aksiyonlardan "Raporumu Takip Et" ile açılır  
+**Amaç:** Anonim veya hesaplı kullanıcının raporunun anlık durumunu sorgulaması.  
+**Not:** Artık ayrı sayfa değildir. Takip kodu girişi ve sonuçlar **modal / drawer** içinde gösterilir.
+
+#### Sayfa İçeriği
+
+**Üst Bölüm — Durum Özeti**
+- Takip kodu
+- Mevcut durum: büyük renkli rozet (Beklemede / İncelemede / Yönlendirildi / Devam Ediyor / Çözüldü / Reddedildi / **Yeniden Açıldı** / **Mükerrer Kayıt**)
+- İlgili müdürlük adı (dispatched_to_department'dan itibaren gösterilir)
+- Son güncelleme tarihi ve saati
+
+**Mükerrer Kayıt Uyarısı:** Rapor "Mükerrer" olarak kapatıldıysa: "Bu bölgede aynı konuda aktif bir iş emrimiz zaten bulunmaktadır. Takibiniz bu ana iş emri [Kayıt No] üzerinden birleştirilmiştir." mesajı ve ana iş emrine yönlendiren bir buton gösterilir.
+
+**Zaman Çizelgesi**  
+Durumların geçiş sırası, tarih-saat damgasıyla dikey zaman çizelgesi olarak gösterilir.  
+Gösterilen bilgi: durum adı + tarih (personel adı veya müdürlük içi detay gösterilmez — vatandaşa yalnızca hangi aşamada olduğu bilgisi verilir).
+
+**Rapor Detayları**
+- Kategori, başlık, açıklama
+- Konum (Statik harita yerine küçük interaktif Leaflet haritası; aynı 100m içindeki diğer aktif public raporları da sarı pinlerle gösterir)
+- Vatandaşın yüklediği fotoğraflar (lightbox ile görüntülenebilir)
+- **"Bu sorunu bende de gördüm"** butonu: Giriş yapmış vatandaşların çözülmemiş rapora "+1 Beni de Etkiliyor" desteği vermesini (veya geri almasını) sağlayan buton entegrasyonu.
+
+
+**Tamamlanma Fotoğrafları**  
+`resolved` durumundaysa saha personelinin yüklediği fotoğraflar gösterilir.
+
+**Geri Bildirim Bölümü** (yalnızca `resolved` durumunda)
+
+- **Yıldız Puanlama:** 1–5 yıldız arası görsel seçim (tıklanınca highlight). Giriş yapmış kullanıcı JWT ile, anonim kullanıcı `x-tracking-code` header'ı ile yetkilendirilir.
+- **Yorum Alanı:** Opsiyonel metin (max 500 karakter); puan seçildikten sonra gösterilir.
+- **[Gönder] butonu:** Yorum + puan gönderi. 1–2 yıldız verilirse arka planda iş otomatik olarak şefin **Kalite Denetim (QA)** kuyruğuna düşer (vatandaşa bilgi verilmez). 3–5 yıldız verilirse iş `resolved` olarak kalır.
+- Puan bir kez gönderildikten sonra değiştirilemez.
+
+**"Sorun Devam Ediyor" — Yeniden Açma (Reopen)**
+- Yalnızca `resolved` veya `rejected` durumundaki `citizen_report` kaynaklı işlerde görünür.
+- Maksimum **2 kez** kullanılabilir; limit dolduğunda buton gizlenir ve `"Bu rapor için maksimum yeniden açma sayısına ulaşıldı. Yeni bir sorun bildirmek için Rapor Oluştur'a tıklayın."` mesajı gösterilir.
+- **Kronik/Tarihsel Bağlantı Flag'i:** 2. reopen limitinin dolmasının ardından vatandaş `"Rapor Oluştur"` bağlantısına tıkladığında, sistem otomatik olarak yeni oluşturulacak vatandaş raporuna `parent_reopened_work_order_id` parametresini (eski raporun UUID'sini) geçirir. Bu sayede yeni oluşturulan rapor veritabanında eski rapora bağlanarak bir **kronik sorun zinciri** oluşturur. Admin panelindeki analitik ekranlarında bu durumlar "Kronik Arızalar" başlığı altında gruplanır.
+- **Akış:**
+  ```
+  [Kullanıcı] → "Sorun Devam Ediyor" butonuna tıklar
+      ↓
+  [Neden Yeniden Açıyorsunuz?] — dropdown + serbest metin alanı
+    Seçenekler: Sorun tekrar oluştu / Hiç çözülmedi / Eksik çözüm / Diğer
+    Açıklama: Zorunlu, max 500 karakter
+      ↓
+  [Onay]
+  Giriş yapmış kullanıcı: JWT ile doğrulanır
+  Anonim kullanıcı: `x-tracking-code` header'ı ile doğrulanır
+      ↓
+  [Sistem]
+    İş durumu `reopened` olarak güncellenir
+    Moderatörün "Karar Bekleyenler" kuyruğuna geri döner
+    Kullanıcıya başarı mesajı: "Raporunuz yeniden incelemeye alındı."
+    Re-open sayacı 1 artırılır
+    SLA Sayacı Sıfırlama: Rapor reopened durumuna geçtiğinde, eski SLA geçmişi denetim amacıyla saklanır; moderatör sevk ettiği andan itibaren ilgili kategori için tanımlanmış standart SLA süresinin %50'si kadar yeni bir "Reopen SLA" süresi başlatılır.
+    2. Reopen dolduğunda: Buton pasifleştirilir, "Yeni Rapor Oluştur" yönlendirmesine `parent_reopened_work_order_id` UUID parametresi bağlanır.
+  ```
+
+
+
+---
+
+### 1.4 Duyurular
+
+**Tetiklenme:** Home haritası üzerinden "Duyurular" aksiyonu ile açılır  
+**Amaç:** Belediyenin yayınladığı bilgi, uyarı ve acil duyuruları listelemek.  
+**Not:** Artık ayrı tam sayfa değildir. Liste ve detay **modal / drawer** olarak harita üzerinde gösterilir.
+
+#### Sayfa İçeriği
+
+**Filtreler (sol panel veya üst bant)**
+
+| Filtre | Seçenekler |
+| :--- | :--- |
+| Tür | Tümü / Bilgi / Uyarı / Acil |
+| Mahalle | Dropdown — il → ilçe → mahalle |
+| Tarih Aralığı | Başlangıç ve bitiş tarihi |
+
+**Liste**
+- Her kart: tür rozeti, başlık, özet (max 200 karakter), tarih, yayımlayan müdürlük
+- Karta tıklanınca `/?modal=announcement&id=:id` detay drawer/modal'ını açar
+
+**Detay Modalı / Drawer** — `/?modal=announcement&id=:id`
+- Tam içerik, tarih aralığı, etkilenen mahalleler listesi
+- Varsa ek dosya / bağlantı
+
+---
+
+### 1.5 Fikir Önerileri
+
+**Tetiklenme:** Home haritası üzerinden "Fikirler" aksiyonu ile açılır  
+**Erişim:** Oy vermek ve öneri oluşturmak için **E-posta Onaylı** hesap gerekir.  
+**Amaç:** Vatandaşların şehir iyileştirme önerileri sunması ve oylaması.  
+**Not:** Liste, detay, oy ve yeni fikir oluşturma **modal** içinde yönetilir.
+
+#### Liste Sayfası
+
+**Sıralama**
+
+| Seçenek | Açıklama |
+| :--- | :--- |
+| En Çok Oy | Varsayılan |
+| En Yeni | Oluşturulma tarihine göre azalan |
+| Yanıtlananlar | Belediyenin resmi yanıt verdiği fikirler |
+
+**Filtreler**
+- Durum: Tümü / Beklemede / Onaylandı / Yanıtlandı / Reddedildi
+- Kategori: Ulaşım, Park, Çevre vb.
+
+**Fikir Kartı**
+- Başlık, kısa açıklama, oy sayısı (+1/-1 net), durum rozeti, oluşturulma tarihi
+- +1 / -1 oylama butonları (giriş yapılmamışsa tıklandığında giriş sayfasına yönlendirir)
+
+- **Fikir Detay Modalı** — `/?modal=idea&id=:id`
+- Tam açıklama
+- Oy butonları (+1 / -1; kullanıcı başına bir oy; **oy değiştirme:** Kullanıcı +1 oy vermişse "-1" butonuna tıkladığında oyu "-1"e dönüştürülür; aynı butona tekrar tıklarsa oyu tamamen geri çekilir (toggle mantığı). Her değişiklikte buton görseli anlık güncellenir.) **Oy için yalnızca E-posta onaylı hesap gereklidir; TC Kimlik doğrulaması gerekmez.**
+- Belediyenin resmi yanıtı (varsa, zaman damgasıyla)
+- Durum rozeti
+
+#### Fikir Oluşturma Modalı — `/?modal=idea-new`
+
+**Erişim:** E-posta Onaylı hesaplı kullanıcı; anonim → giriş sayfasına yönlendir. **TC Kimlik doğrulaması (`is_identity_verified = true`) zorunludur** (yalnızca fikir oluşturma için; oy vermek için TC Kimlik gerekmez).
+- **Kimlik Doğrulama UX Akışı (Nick-Name Lockout Koruması):** Fikir oluşturma modalı açıldığında, eğer kullanıcının hesabı kimlik doğrulamalı değilse (`is_identity_verified = false`), fikir giriş alanları (başlık, açıklama, kategori) pasifleştirilmiş/kilitli olarak gösterilir. Formun üzerinde net ve anlaşılır bir HSL Danger Red çerçeveli **"Fikir oluşturabilmek için T.C. Kimlik doğrulaması yapmanız gerekmektedir. [Şimdi Doğrula]"** uyarı şeridi (alert banner) yer alır. Vatandaş "Şimdi Doğrula" butonuna tıkladığında modal kapatılmadan doğrudan T.C. Kimlik Doğrulama modal formu (TCKN, resmi Ad, resmi Soyad, Doğum Yılı alanları) açılır. Doğrulama başarıyla tamamlandığında, profil `is_identity_verified = true` durumuna çekilir, displays adı (takma ad) korunur, uyarı şeridi kalkar ve form alanları aktifleşerek veri girişine izin verilir.
+
+| Alan | Tür | Kural |
+| :--- | :--- | :--- |
+| Başlık | Metin | Zorunlu; min 5, max 150 karakter |
+| Açıklama | Textarea | Zorunlu; min 20, max 2000 karakter |
+| Kategori | Dropdown | Zorunlu |
+| İlgili Mahalle | Dropdown — il → ilçe → mahalle | Opsiyonel |
+| TC Kimlik No | Metin | E-posta onaylı hesapta zorunlu; NVI doğrulaması (tek seferlik, otomatik) |
+
+- Gönderimden sonra moderasyon onayı beklenir (`muni_admin` onaylar)
+- Kullanıcıya "Öneriniz incelemeye alındı" bildirimi
+
+---
+
+### 1.6 Geri Dönüşüm Haritası
+
+**Tetiklenme:** Home ana haritası üzerinden katman toggle veya "Geri Dönüşüm" aksiyonu ile açılır  
+**Erişim:** Herkese açık  
+**Amaç:** Cam, kâğıt, pil, tekstil vb. atık türlerine göre en yakın toplama noktalarını haritada göstermek.  
+**Not:** Artık ayrı sayfa değildir. Ana harita üzerine katman olarak veya **modal** içinde gösterilir.
+
+#### Sayfa İçeriği
+
+- Leaflet haritası tam ekran (header hariç)
+- Sol panel: Atık türü filtresi (çoklu seçim: Cam / Kâğıt / Plastik / Pil / Tekstil / Elektronik / Organik)
+- "Konumumu Kullan" butonu: GPS ile merkezi konuma taşır
+- Haritada her nokta için pin; tıklanınca popup: nokta adı, adres, kabul edilen atık türleri, açılış saatleri (varsa)
+- Popup'ta "Navigasyonu Başlat" butonu: Google Maps / Apple Maps / Yandex Maps seçim modal'ı açar; seçilen uygulama koordinatlarla dış uygulamada açılır
+
+---
+
+### 1.7 Hesaplı Kullanıcı Dashboard'u
+
+**Tetiklenme:** Giriş yapmış vatandaş profil menüsünden veya home haritası üzerinden açılır  
+**Erişim:** Yalnızca giriş yapmış vatandaşlar (citizen)  
+**Amaç:** Kullanıcının tüm raporlarını, oy geçmişini ve bildirim tercihlerini yönetmesi.  
+**Not:** Artık ayrı tam sayfa değildir. **Modal / drawer** olarak harita üzerinde açılır.
+
+#### Sayfa Sekmeleri
+
+**Sekmem: Raporlarım** (`/?modal=dashboard&tab=reports`)
+- Tablo / Kart görünümü (kullanıcı tercihi, LocalStorage'da saklanır)
+- Her satır: takip kodu, başlık, kategori, durum rozeti, oluşturulma tarihi, son güncelleme
+- Filtreler: Durum (Tümü / Aktif / Çözüldü / Reddedildi), Tarih Aralığı
+- "Yeni Rapor Oluştur" butonu
+- Rapor satırına tıklanınca `/?modal=track&code=:trackingCode` modal/drawer'ını açar
+
+**Sekmem: Oy Geçmişim** (`/?modal=dashboard&tab=votes`)
+- Oy verilen fikir önerileri listesi (başlık, oy tipi, tarih)
+- Her satıra tıklanınca `/?modal=idea&id=:id` detay modal'ını açar
+
+**Sekmem: Desteklediklerim** (`/?modal=dashboard&tab=supported`)
+- Kullanıcının "+1 Beni de Etkiliyor" desteği verdiği public raporların listesi (takip kodu, kategori, başlık, mevcut durum, destek tarihi).
+- Destek oylarına tıklanınca `/?modal=track&code=:trackingCode` modal/drawer'ını açar.
+- Her satırın yanında "Desteği Geri Al" butonu mevcuttur.
+  - **Davranış:** `DELETE /public/reports/:public_id/support` çağrılır. İşlem idempotenttir. `resolved` durumuna geçmiş raporlarda destek geri alınamaz. Geri alma işlemi sonrası `support_count` asenkron debounced worker ile güncellenir ve ilgili public cache satırları invalidate edilir.
+
+**Sekmem: Bildirim Tercihleri**
+
+| Tercih | Seçenek |
+| :--- | :--- |
+| E-posta Bildirimleri | Açık / Kapalı |
+| SMS Bildirimleri | Açık / Kapalı |
+| Mobil Push Bildirimleri | Açık / Kapalı |
+| Hangi durum değişikliklerinde bildirim | Tümü / Yalnızca Çözüldü / Yalnızca Yönlendirildi (dispatched) / Yalnızca Re-open |
+
+---
+
+### 1.8 Profil ve Hesap Ayarları
+
+**Tetiklenme:** Giriş yapmış vatandaşın profil avatarından açılır  
+**Erişim:** Yalnızca giriş yapmış vatandaşlar  
+**Amaç:** Kişisel bilgilerin düzenlenmesi, şifre değiştirme, hesap silme.  
+**Not:** Artık ayrı sayfa değildir. **Modal** içinde yönetilir.
+
+#### Sayfa Bölümleri
+
+> **Modal Sekme Yapısı:** Profil modal'ı (`/?modal=profile`) iki sekme içerir: **"Bilgilerim"** (kişisel bilgiler + şifre) ve **"Güvenlik"** (cihazdan çıkış + hesap sil). Sekmeler modal üstünde tab bar ile yapılandırılır.
+
+**Kişisel Bilgiler**
+
+| Alan | Tür | Kural |
+| :--- | :--- | :--- |
+| Ad | Metin | Opsiyonel, max 100 karakter |
+| Soyad | Metin | Opsiyonel, max 100 karakter |
+| E-posta | Metin | Değiştirilebilir; yeni e-postaya OTP doğrulaması yapılır |
+| Telefon | Metin | Değiştirilebilir; yeni telefona OTP doğrulaması yapılır |
+| Mahalle | Dropdown | Opsiyonel |
+
+**Şifre Değiştirme**
+- Mevcut şifre + yeni şifre + yeni şifre tekrar
+
+**Tüm Cihazlardan Çıkış**
+- Tıklanınca onay modal'ı açılır; tüm refresh token'lar geçersiz kılınır
+
+**Hesabımı Sil (KVKK)**
+- Kırmızı, dikkat çekici buton
+- Tıklanınca onay modal'ı açılır: "Hesabınız silinecek. Raporlarınız anonim olarak sistemde saklanmaya devam edecektir. Ayrıca, verdiğiniz tüm +1 destek oyları silinecek ve ilgili işlerin support_count alanları güncellenecektir. Bu işlem geri alınamaz. (Vatandaş hesabı Central SaaS DB düzeyinde silinir; belediye şemalarındaki ilişkisel veriler asenkron olarak maskelenir. `audit_logs` tablosundaki old_value/new_value alanlarındaki kişisel veriler, indeksli `citizen_id` filtresiyle full table scan yapmadan asenkron regex job'ı ile temizlenir.)"
+- Onay için kullanıcıdan mevcut şifresi veya OTP istenir
+- Silme işlemi başlatılır; kullanıcı oturumu kapatılır ve ana sayfaya yönlendirilir
+
+### 1.9 Panik / Acil Durum Bildirimi
+
+**URL:** Ayrı sayfa yoktur; Ana Sayfa'daki (/) butonla tetiklenir  
+**Hizmet Taahhüdü ve Sorumluluk Reddi:** Bu buton bir "Hayati Tehlike Müdahale Hattı" (112) değildir. Belediye koordinasyonu ve afet toplanma süreçleri için tasarlanmıştır. Belediye, sinyalin 7/24 canlı bir operatör tarafından izlendiğini taahhüt etmez; müdahale süresi o anki belediye kaynaklarına ve afet durumuna bağlıdır.
+
+**Akış:**
+
+```
+[Kullanıcı] → "Acil Durum Bildir" butonuna tıklar
+    ↓
+[Yasal Uyarı Modal'ı]
+  "DİKKAT: Bu hat 112 Acil Çağrı Merkezi'nin alternatifi değildir.
+   Hayati tehlike durumunda ÖNCE 112'Yİ ARAYIN.
+   Bu buton yalnızca belediye koordinasyon ekiplerine konum bildirir."
+  [İptal] [Anladım, Devam Et]
+    ↓
+[Konum İzni]
+  Tarayıcı konum izni istenir
+  İzin verilmezse: Manuel adres girişi formu açılır (il/ilçe/mahalle/adres notu)
+    ↓
+[Onay Modal'ı]
+  Konum haritada gösterilir
+  "Bu konumu paylaş" butonu
+    ↓
+[Sistem] → Sinyal asenkron olarak PostgreSQL unlogged panik kuyruğuna yazılır (Moderatör kuyruğu bypass edilir)
+           Kuyruk worker'ları gelen sinyalleri debounced bulk update ile DB'ye yansıtır
+           Kullanıcıya anında 202 HTTP koduyla takip kodu verilir
+    ↓
+[Kriz Masası Aktivasyonu]
+  Sinyal kuyruktan tüketilerek anlık olarak "Kriz Masası Canlı Haritası"na yansıtılır.
+  Haritada "Resmi Toplanma Alanları" katmanı otomatik aktifleşir.
+  Kullanıcıya en yakın 3 toplanma alanı yeşil ikonlarla gösterilir.
+  En yakın noktaya yönelik tahliye rotası çizilir.
+```
+
+---
+
+### 1.10 Statik ve Bilgilendirici İçerikler (Modal Üzerinden)
+
+Yeni Map-First + Modal mimarisine uygun olarak, yasal ve bilgilendirici içerikler (Hakkımızda, SSS, Gizlilik, KVKK, Kullanım Koşulları, İletişim) ayrı tam sayfa olarak değil, ana sayfadaki public harita üzerinden **modal / slide-over** şeklinde açılır.
+
+**Public Web Yol Haritası Gösterimi (Geliştirme Rehberi Seviyesi)**
+
+**Tetiklenme:**
+- Footer’da “Sistem Yol Haritası” linki
+- URL: `/?modal=roadmap`
+
+**Modal Davranış Kuralları:**
+
+- Modal açıldığında sistem önce `public_web_roadmap_mvp` ve `public_web_roadmap_v1` içeriklerini çeker.
+- Sadece `is_active = true` olan sürümler sekmelerde görünür.
+- Eğer her iki sürüm de aktifse → default olarak **MVP** sekmesi seçili gelir.
+- Eğer sadece biri aktifse → o sürüm doğrudan açılır (sekme görünmez).
+- Eğer hiçbir sürüm aktif değilse → “Yol haritası şu anda yayınlanmamıştır” mesajı gösterilir.
+
+**Modal İçeriği (Bileşen Yapısı):**
+- Başlık: “KENTİM Yol Haritası”
+- Sekmeler: MVP Sürümü / V1 Sürümü (sadece aktif olanlar)
+- İçerik: Markdown → HTML olarak render edilir (XSS korumalı)
+- Alt bilgi: “Son güncelleme: [tarih]”
+- Kapat butonu (Esc tuşu ile de kapanır)
+
+**Edge Cases:**
+- İçerik çok uzunsa → modal içinde scroll aktif olur.
+- Markdown içinde link varsa → yeni sekmede açılır.
+- Mobil cihazda → modal tam ekran bottom sheet olarak açılır (snap point %95).
+
+**Responsive Kurallar:**
+- Desktop: Normal modal (max-width 720px)
+- Tablet/Mobil: Bottom sheet, %95 yüksekliğe kadar açılır
+- İçerik 800px’den uzunsa scroll bar görünür
+
+**Performans:**
+- İçerik ilk açılışta cache’lenir (30 dakika).
+- Her 30 dakikada bir arka planda güncellenir.
+
+#### URL Yapısı (Modal Stratejisi)
+- `/?modal=about` → Hakkımızda modal'ı açılır
+- `/?modal=faq` → SSS modal'ı açılır
+- `/?modal=privacy` → Gizlilik Politikası modal'ı açılır
+- `/?modal=kvkk` → KVKK Aydınlatma Metni modal'ı açılır
+- `/?modal=terms` → Kullanım Koşulları modal'ı açılır
+- `/?modal=contact` → İletişim / Destek modal'ı açılır
+
+**Not:** Bu modalların başlık ve içerikleri, merkezi olarak yönetilen `GET /public/static-contents/:key` API endpoint'inden dinamik olarak çekilir.
+
+#### 1.10.1 Hakkımızda
+
+**Tetiklenme:** Footer veya header menüsünden "Hakkımızda" linkine tıklanır.  
+**URL:** `/?modal=about`  
+**Erişim:** Herkese açık  
+**Amaç:** Platformun amacı, vizyonu ve çalışma şeklini tanıtmak.
+
+**Modal İçeriği (Önerilen):**
+- KENTİM nedir?
+- Hangi sorunları çözüyor?
+- Vizyon ve değerler
+- Hangi belediyelerde hizmet veriyor?
+
+**Not:** Ayrı sayfa yerine modal olarak tasarlanır. SEO için ana sayfa indexlenir.
+
+#### 1.10.2 SSS (Sıkça Sorulan Sorular)
+
+**Tetiklenme:** Footer'dan "SSS" veya "Yardım" linkine tıklanır.  
+**URL:** `/?modal=faq`  
+**Erişim:** Herkese açık  
+**Amaç:** Vatandaşların en sık sorduğu soruları cevaplamak.
+
+**Modal İçeriği:**
+- Kategorili soru-cevap listesi (Raporlama, Harita, Gizlilik, Teknik vb.)
+- Arama kutusu (opsiyonel)
+
+**Not:** Modal içinde accordion veya sekme ile gösterilir.
+
+#### 1.10.3 Gizlilik Politikası
+
+**Tetiklenme:** Footer'dan "Gizlilik Politikası" linkine tıklanır.  
+**URL:** `/?modal=privacy`  
+**Erişim:** Herkese açık  
+**Amaç:** Kişisel verilerin nasıl işlendiğini açıklamak.
+
+**Not:** Uzun metin modal içinde scrollable olarak gösterilir.
+
+#### 1.10.4 KVKK Aydınlatma Metni
+
+**Tetiklenme:** Footer'dan "KVKK" linkine tıklanır.  
+**URL:** `/?modal=kvkk`  
+**Erişim:** Herkese açık  
+**Amaç:** Kişisel verilerin işlenmesine ilişkin aydınlatma yükümlülüğünü yerine getirmek.
+
+**Not:** Rapor oluşturma sırasında da kısa versiyonu modal içinde gösterilebilir.
+
+#### 1.10.5 Kullanım Koşulları
+
+**Tetiklenme:** Footer'dan "Kullanım Koşulları" linkine tıklanır.  
+**URL:** `/?modal=terms`  
+**Erişim:** Herkese açık  
+**Amaç:** Platformun kullanım şartlarını tanımlamak.
+
+#### 1.10.6 İletişim / Destek
+
+**Tetiklenme:** Footer'dan "İletişim" veya "Destek" linkine tıklanır.  
+**URL:** `/?modal=contact`  
+**Erişim:** Herkese açık  
+**Amaç:** Vatandaşların soru, öneri veya şikayetlerini iletmesini sağlamak.
+
+**Modal İçeriği:**
+- İletişim formu (isim, e-posta, konu, mesaj)
+- Belediye iletişim bilgileri (opsiyonel)
+
+**Not:** Bu modal diğerlerine göre daha etkileşimli olabilir.
+
+---
+
+**Genel Kurallar (Bu İçerikler İçin):**
+- Tüm içerikler **modal** içinde açılır. Ayrı tam sayfa kullanılmaz.
+- Footer üzerinden kolay erişim sağlanır.
+- Mobil cihazlarda alt taraftan yukarı doğru kayan drawer olarak açılabilir.
+- İçerikler belediye bazında özelleştirilebilir.
+- SEO açısından ana sayfa (`/`) indexlenir; modal içerikler indexlenmez.
+
+## BÖLÜM 2: Belediye Paneli — `panel.kentim.com.tr`
+
+### 2.0 Kimlik Doğrulama
+
+**URL:** `/login`
+
+```
+E-posta + şifre girişi
+  → 1. Giriş Bilgileri Doğrulama: Hatalı girişlerde 5 denemede 15 dakika kilidi ve hata mesajı gösterilir.
+  → 2. Merkezi SaaS Onay Kontrolü (SaaS Lockout Pipeline):
+     - Belediye "active" (aktif/onaylı) ise: Token alınarak rol bazlı yönlendirme yapılır:
+       - muni_moderator   → /moderator/queue
+       - muni_department_manager → /manager/work-orders
+       - muni_team_chief  → /chief/work-orders
+       - muni_worker      → /worker/tasks
+       - muni_admin       → /admin/dashboard
+     - Belediye "active" değilse (Askıda/Onay Bekliyor/Pasif): Giriş engellenir ve ekranda HSL Orman Yeşili/Kırmızı tonlarında "Hata: Belediyeniz henüz merkez (Central SaaS) tarafından onaylanmamıştır veya aboneliği askıdadır. Lütfen merkez yönetici ile irtibata geçiniz." uyarısı yansıtılır.
+```
+
+Giriş sayfasında "Şifremi Unuttum" bağlantısı: e-posta gir → OTP → yeni şifre akışı (vatandaş ile aynı mekanizma).
+
+#### 2.0.2 Yetkisiz Erişim
+
+Bir kullanıcı kendi rolüne ait olmayan URL'e gitmeye çalışırsa → `403` sayfasına yönlendirilir.
+
+---
+
+### 2.1 Moderatör Paneli
+
+#### 2.1.1 Bekleyen Raporlar Kuyruğu
+
+**URL:** `/moderator/queue`  
+**Erişim:** `muni_moderator`, `muni_admin`  
+**Amaç:** `pending`, `moderation`, `reopened` ve re-dispatch geri dönen (`dispatched_to_department` → moderatör) durumlarındaki raporları listeleyip incelemek.
+
+> **Not:** Müdür veya admin tarafından re-dispatch edilen işler, ping-pong korumasına kadar moderasyona döner ve bu kuyrukta **"Karar Bekleyen (moderation)"** olarak görünür; ancak işin kökeni re-dispatch olduğundan liste satırında `RE-DISPATCH` rozeti gösterilir.
+
+**Filtreler**
+
+| Filtre | Seçenekler |
+| :--- | :--- |
+| Durum | Tümü / Yeni (pending) / Yeniden Açılan (reopened) / Karar Bekleyen (moderation) / **Re-dispatch Dönüşü** |
+| Kategori | Tüm kategoriler; dropdown |
+| İlçe / Mahalle | Dropdown |
+| Öncelik | Tümü / Düşük / Normal / Yüksek / Acil / **Kriz** |
+| Kaynak | Tümü / Vatandaş Raporu / Re-dispatch Dönüşü |
+| Destekçi Sayısı | Tümü / En Çok Desteklenen (sıralı listeleme) |
+| Tarih | Bugün / Bu Hafta / Bu Ay / Özel Aralık |
+| Arama | Takip kodu veya başlık ile metin araması |
+
+**Liste Sütunları**
+- Takip kodu · Başlık · Kategori · Mahalle · Oluşturulma tarihi · Durum rozeti · Atanan müdürlük (re-dispatch durumunda gösterilir) · **Destekçi Sayısı (+X)** · **Re-dispatch sayacı** (re-dispatch gönderme varsa)
+- Satır tıklanınca `/moderator/reports/:id` sayfasına gider
+
+**Toplu İşlem**
+- Birden fazla rapor seçilerek toplu müdürlük atama yapılabilir (tüm seçili raporlar aynı müdürlüğe yönlendirilir)
+- Toplu işlem yalnızca `pending` durumdaki raporlara uygulanabilir
+
+#### 2.1.2 Rapor Detay
+
+**URL:** `/moderator/reports/:id`  
+**Erişim:** `muni_moderator`, `muni_admin`  
+**Amaç:** Tekil raporun tüm detaylarıyla incelenip yönlendirilmesi.
+
+**Sayfa Düzeni (iki sütun)**
+
+Sol sütun — Rapor Bilgisi:
+- Takip kodu, kategori, başlık, açıklama
+- Vatandaşın yüklediği fotoğraflar (lightbox ile büyütülebilir; her fotoğraf için bağımsız "Public Haritada Göster/Gizle" toggle kontrolü bulunur)
+- Leaflet haritası — rapor pinlenmiş konumu gösterir
+Sağ sütun — Moderasyon Paneli:
+- **Mükerrer Kayıt Kontrolü:** Sistem, aynı koordinat ve kategorideki aktif işleri otomatik listeler. 
+- [Mükerrer Olarak İşaretle] butonu → Ana İş Emri seçim modal'ı açılır. Seçildiğinde rapor "Mükerrer" olarak kapanır ve ana iş emrine bağlanır.
+- **Halka Açık Harita Görünürlük Kontrolü:** "Public Haritada Göster" toggle (`is_public_visible` boolean). Gizleme durumunda gerekçe dropdown'u (KVKK, uygunsuz içerik vb.) zorunludur. Görünürlük değişiklikleri denetim loguna kaydedilir.  
+  **Not:** `public_map_cache` invalidation mekanizması entegre edilmiştir. Görünürlük değiştiğinde ilgili önbellek otomatik olarak temizlenir.
+- Sistem tarafından önerilen birincil müdürlük (kategori eşleşmesine göre); değiştirilebilir dropdown
+...
+
+- Çok müdürlüklü durumlarda ikincil bildirim müdürlüklerini seçme (çoklu checkbox)
+- Öncelik seçimi: Normal / Yüksek / Acil / **Kriz** (SLA çarpanı: **Yüksek = x0.5**, **Acil = x0.25**, **Kriz = x0.1 (7/24 kesintisiz)**). **Kritik SLA Kuralı:** `Acil` veya `Kriz` durumlarındaki iş emirlerinde müdürlüğün mesai takvimi (Business Hours) bypass edilir; SLA sayacı hafta sonu ve resmi tatil ayrımı olmaksızın **7/24 kesintisiz** çalıştırılır.
+- Dahili Not alanı (max 500 karakter; vatandaşa gösterilmez)
+- [Müdürlüğe Yönlendir] butonu → durum `dispatched_to_department` olur; moderatöre başarı toast'ı
+- [Reddet] butonu → gerekçe modalı açılır (gerekçe zorunlu; max 500 karakter)
+
+**Öncelik Değiştirme Yetki Sınırı:**
+- Moderatör, rapor inceleme aşamasında (**moderation**) öncelik atayabilir.
+- İş **dispatched_to_department** veya sonraki aşamalara geçtikten sonra öncelik yalnızca **müdür (`muni_department_manager`)** veya **admin (`muni_admin`)** tarafından değiştirilebilir. Moderatörün öncelik değiştirme yetkisi bu aşamada sona erer.
+- Değişiklikler denetim loguna `STATUS_CHANGED` olarak kaydedilir.
+
+**Re-dispatch (yeniden yönlendirme)**  
+Raporun mevcut durumu `dispatched_to_department` veya üzerindeyse:
+- Moderatör: yalnızca `dispatched_to_department` aşamasında re-dispatch yapabilir
+- Müdür ve muni_admin: herhangi bir aşamada re-dispatch yapabilir
+- Re-dispatch butonu → müdürlük seçim modal'ı → onay → `REPORT_REDISPATCHED` olayı denetim loguna kaydedilir
+
+**Manuel İş Emri Oluştur** (moderatör için) — **Sınırlı Yetki**  
+- Sağ üst köşede buton: "Manuel İş Emri Oluştur" → `/moderator/work-orders/new` formuna yönlendirir  
+- **Kısıtlar:** Sadece "vatandaş raporu olarak açılamayan" durumlar için kullanılabilir. Formda zorunlu "Gerekçe" alanı vardır (min 20 karakter). İş oluşturulduğunda kaynak tipi otomatik `manual_internal` olur ve `MANUAL_WORK_ORDER_BY_MODERATOR` audit event'i yazılır. Moderatör, kendi oluşturduğu işi moderasyon kuyruğuna alamaz; doğrudan ilgili müdürlüğe sevk edilir.
+
+---
+
+### 2.2 Müdür Paneli (muni_department_manager)
+
+#### 2.2.1 İş Emirleri Listesi
+
+**URL:** `/manager/work-orders`  
+**Erişim:** `muni_department_manager`, `muni_admin`  
+**Amaç:** Müdürlüğe havale edilen tüm kaynak tiplerindeki iş emirlerini yönetmek.
+
+**Sekmeler**
+- **Birincil İş Emirleri** (işlem yapılabilir): Varsayılan sekme
+- **İkincil Bildirimler** (yalnızca bilgi amaçlı): Başka müdürlük tarafından yönetilir; atama yapılamaz; okundu / okunmadı durumu gösterilir
+
+**Filtreler (Birincil sekme için)**
+
+| Filtre | Seçenekler |
+| :--- | :--- |
+| Durum | Tümü / Atama Bekliyor / Devam Ediyor / Şef Onayı Bekliyor / Müdür İncelemesi / Çözüldü / Reddedildi |
+| Havuz | Tümü / Atanmamış Havuzu (Sadece müdürlük veya ekibe atanmış, personel bekleyenler) |
+| Kaynak Tipi | Tümü / Vatandaş Raporu / Dahili / Entegrasyon / Periyodik |
+| Öncelik | Tümü / Düşük / Normal / Yüksek / Acil / **Kriz** |
+| SLA Durumu | Tümü / SLA Aşıldı / SLA Kritik (son 24 saat) / Normal |
+| Ekip / Şef | Dropdown |
+| Tarih Aralığı | Bugün / Bu Hafta / Bu Ay / Özel |
+| Arama | İş emri numarası veya başlık ile metin araması |
+
+**Liste Sütunları**
+- No · Başlık · Kaynak (ikon) · Kategori · Durum · Öncelik · Atanan Şef · SLA Durumu (renk kodlu) · Tarih
+
+**İşlemler**
+- Satır tıklanınca `/manager/work-orders/:id` detay sayfasına gider
+- Satır üzerinde hızlı işlem ikonu: Şefe Ata
+
+#### 2.2.2 İş Emri Detay
+
+**URL:** `/manager/work-orders/:id`  
+**Erişim:** `muni_department_manager`, `muni_admin`  
+**Amaç:** Tekil iş emrini atamak, izlemek ve gerektiğinde re-dispatch yapmak.
+
+**Sayfa Düzeni (iki sütun)**
+
+Sol sütun — İş Emri Bilgisi:
+- No, kaynak tipi rozeti, kategori, başlık, açıklama
+- Konum (harita)
+- Vatandaşın fotoğrafları
+- Moderatörün dahili notu (varsa)
+
+Sağ sütun — Yönetim Paneli:
+- Mevcut durum rozeti
+- SLA bilgisi: kalan süre veya aşım miktarı (kırmızı / sarı / yeşil)
+- **Şefe Ata** dropdown: kendi müdürlüğündeki şeflerin listesi → [Ata] butonu (durum `assigned_to_team`)
+- **Doğrudan Personele Ata** dropdown: şefi atlayarak müdürlük altındaki personeller → [Ata] butonu (durum `assigned_to_worker`); atanan şef bilgi bildirimi alır. **Kritik Kural:** Müdür doğrudan atama yaptığında, iş tamamlandığında onay bekleyen kişi olarak şef yerine doğrudan **Müdür** belirlenir.
+- **Üst Yetkiyle Onayla (Force Approve):** Müdürler, şeflerin onay bekleyen tüm işlerini (`pending_chief_approval`) doğrudan onaylama (`resolved`) yetkisine sahiptir; şefin sahada veya izinli olduğu durumlarda kilitlenmeyi önler.
+- **Müdür İnceleme Aksiyonları:** İş emri `pending_manager_review` durumundaysa, detay sayfasında şu butonlar belirir:
+  - [Zorla Çözüldü Yap] (`force_resolve`)
+  - [Personel Değiştir] (`reassign_worker`) → Personel seçim dropdown'ı açılır. **Dropdown, işin şu an atanmış olduğu şefin ekibindeki aktif personelleri listeler** (ret sayacı sıfırlanır; iş şefin atanmamış havuzuna düşer ve şef yeni atamayı yapar).
+  - [İşi İptal Et] (`reject`)
+  - [Manuel Onayla] (`manual_approval`) → `pending_manager_review` durumundaki işin mevcut fotoğraflarını yeterli kabul ederek şef onay aşamasını bypass eder ve iş emrini doğrudan `resolved` durumuna çeker.
+- **Re-dispatch (Yeniden Yönlendirme)** butonu: Gerekçe modal'ı açılır → onay → İş emri **Moderatörün Karar Bekleyenler (`moderation`)** kuyruğuna geri gönderilir. (Ping-pong koruması: müdür/admin seviyesinde 3. re-dispatch gerçekleştiğinde (sayıç `> 2`) iş otomatik olarak `muni_admin`'in Anlaşmazlık Çözüm kuyruğuna taşınır).
+- Dahili Not Ekle (max 500 karakter; yalnızca belediye personeli görebilir)
+- Manuel iş emri oluştur butonu
+
+**Durum Geçmişi Sekmesi**
+- Tüm durum değişikliklerinin kronolojik listesi: tarih-saat, kim değiştirdi, eski durum → yeni durum
+
+**Denetim Logu Sekmesi**
+- Re-dispatch, atama değişikliği, not ekleme gibi kritik olayların listesi
+
+**Fotoğraflar Sekmesi**
+- Saha personelinin yüklediği tamamlama fotoğrafları (lightbox); GPS konum ve zaman damgası etiketi
+
+#### 2.2.3 Manuel İş Emri Oluşturma
+
+**URL:** `/manager/work-orders/new`  
+**Erişim:** `muni_department_manager`, `muni_admin`
+
+| Alan | Tür | Kural |
+| :--- | :--- | :--- |
+| Başlık | Metin | Zorunlu, max 150 karakter |
+| Açıklama | Textarea | Zorunlu, max 2000 karakter |
+| Kategori | Dropdown | Zorunlu |
+| Öncelik | Radio | Zorunlu; Normal (varsayılan) / Yüksek / Acil / **Kriz** |
+| Konum | Harita + adres alanları | Zorunlu |
+| Şef / Personel Ata | Dropdown | Opsiyonel; atanırsa `assigned_to_team`, atanmazsa `dispatched_to_department` |
+
+- Kaydet → `dispatched_to_department` durumunda açılır; kaynak `manual_internal` olarak işaretlenir; moderatör onayına gitmez
+
+---
+
+### 2.3 Ekip Şefi Paneli (muni_team_chief)
+
+#### 2.3.1 İş Emirleri Listesi
+
+**URL:** `/chief/work-orders`  
+**Erişim:** `muni_team_chief`  
+**Amaç:** Şefin ekibine atanan tüm iş emirlerini görmek ve personele dağıtmak.
+
+**Sekmeler**
+- **Aktif İşler:** Personele atanmış veya atanmayı bekleyen işler.
+- **Onay Bekleyenler:** Personelin tamamladığı (`pending_chief_approval`) işler.
+- **Kalite Denetim (QA):** Vatandaşın 1-2 yıldız verdiği, şefin tekrar incelemesi gereken çözülmüş işler.
+
+**Filtreler**
+
+| Filtre | Seçenekler |
+| :--- | :--- |
+| Durum | Tümü / Atanmamış (Bekliyor) / Devam Ediyor / Şef Onayı Bekliyor / Kalite Denetim (QA) / Çözüldü |
+| Personel | Dropdown — kendi ekibi |
+| Öncelik | Tümü / Normal / Yüksek / Acil / **Kriz** |
+| Tarih | Bugün / Bu Hafta / Özel |
+
+**Atanmamış Havuzu:** Şefe atanmış ancak henüz bir personele yönlendirilmemiş (`assigned_to_team`) veya personel tarafından yarıda bırakılmış tüm işler bu listede "Atanmamış" durumuyla en üstte listelenir.
+
+**Hızlı İşlem**
+- Satır üzerinde: Personele Ata ikonu; dropdown açılır
+
+#### 2.3.2 İş Emri Detay ve Fotoğraf Onayı
+
+**URL:** `/chief/work-orders/:id`  
+**Erişim:** `muni_team_chief`  
+**Amaç:** İş emrini incelemek, personele atamak ve tamamlama fotoğraflarını onaylamak.
+
+**Yönetim Paneli:**
+- **Personele Ata** dropdown → [Ata] butonu (durum `assigned_to_worker` olur).
+- **Geofence Bypass Talepleri:** Personelden gelen geofence bypass talebi (EXIF konum ve gerekçe) detayda gösterilir. Şef [Geofence Bypass Onayla] butonuna basarak koordinatı personelin fiili EXIF konumuyla güncelleyebilir ve geofence'i bypass edebilir.
+
+**Fotoğraf Onay Bölümü** (durum `pending_chief_approval` ise aktif)
+- Tüm fotoğraflar ızgara görünümünde listelenir; her fotoğrafın altında:
+  - GPS koordinatı (harita linki ile)
+  - Çekim tarihi ve saati
+- [Onayla] butonu → durum `resolved`; vatandaş raporu ise bildirim gönderilir
+- [Reddet] butonu → gerekçe alanı (zorunlu, max 500 karakter) → durum `in_progress`; personele bildirim gönderilir
+
+**Kalite Denetim (QA) Bölümü** (Vatandaş düşük puan verdiyse aktif)
+- Vatandaşın verdiği puan ve yorumu en üstte kırmızı bir uyarı kutusuyla gösterilir.
+- [Çözümü Kesinleştir] butonu → Şef işin çözüldüğüne ikna olursa; kayıt QA kuyruğundan kalkar.
+- [Yetersiz - İşe Döndür] butonu → Gerekçe alanı (zorunlu) → İş emri tekrar `in_progress` olur ve ilgili personele bildirim gider.
+
+**Devre Kesici:** 3. kez üst üste ret verilirse, sistem işi otomatik olarak `pending_manager_review` durumuna çeker ve müdüre "Sürekli Fotoğraf Reddi - İnceleme Gerekiyor" bildirimi gönderir. Şefin ekranında "Eskalasyona Gönderildi" uyarısı çıkar. Müdür bu aşamada; zorla kapatma (`force_resolve`), yeniden atama (`reassign_worker`), manuel onay (`manual_approval`) veya iptal (`reject`) aksiyonlarından birini alarak döngüyü kırar.
+
+**Dahili Not Ekleme**
+- Metin alanı (max 500 karakter; yalnızca belediye personeli görebilir, vatandaşa gösterilmez)
+- [Not Ekle] butonu
+- Eklenen notlar kronolojik olarak listelenir (tüm dahili notlar)
+- Kendi eklediği notu ilk 15 dakika içinde düzenleyebilir veya silebilir (genel kural)
+- Not ekleme işlemi denetim loguna kaydedilir
+
+#### 2.3.3 Günlük İş Planı
+
+**URL:** `/chief/daily-plan`  
+**Erişim:** `muni_team_chief`  
+**Amaç:** Ekipteki her personelin günlük iş listesini planlamak ve optimize etmek.
+
+**Sayfa Düzeni**
+
+- Tarih seçici (varsayılan: bugün; 7 güne kadar ileri planlama)
+- Her personel için sütun: personel adı, o güne atanan iş emirleri listesi (sürükle-bırak ile sıralama ve atama yeniden düzenleme)
+- Harita görünümü sekmesi: tüm açık iş emirlerini haritada pinler olarak gösterir; personele atamak için pin üzerine sağ tıkla → personel seçimi
+- [Personele Ata] butonu: listedeki atanmamış iş emirleri için personel seçme dropdown'u
+- Rota Optimizasyonu Hesapla butonu: seçili personelin iş emirlerini OSRM algoritmasıyla en kısa rota sırasına dizer; sıralama güncelleme onayı istenir
+
+#### 2.3.4 Ekip Performansı
+
+**URL:** `/chief/team-stats`  
+**Erişim:** `muni_team_chief`
+
+- Günlük / Haftalık / Aylık sekmeleri
+- Her personel için: tamamlanan iş sayısı, ortalama tamamlanma süresi (saat), reddedilen fotoğraf sayısı
+- Grafik: son 7/30 günün tamamlanma trendi
+
+#### 2.3.5 Manuel İş Emri Oluşturma
+
+**URL:** `/chief/work-orders/new`  
+**Erişim:** `muni_team_chief`
+
+- Müdür formuna özdeş; ek olarak: oluşturma anında kendi ekibinden personel atayabilir.
+- Personel atanırsa `assigned_to_worker`; atanmazsa müdürlüğün havuzuna `dispatched_to_department` olarak düşer.
+- **Şef Kendi İşinde Onay Kuralı:** Şef, kendi oluşturduğu işe doğrudan personel atadığında (şef bypass yok — şef zaten işin sahibidir) ve personel işi tamamlayıp fotoğraf yüklediğinde onay yetkisi **şefin kendisine** düşer (`pending_chief_approval`). Müdür bypass kuralı (onayın müdüre düşmesi) yalnızca müdürün şefi atlayıp doğrudan atama yaptığı durum içindir.
+
+#### 2.3.6 Çevrimdışı Senkronizasyon Uyuşmazlık Havuzu
+
+**URL:** `/chief/disputes`  
+**Erişim:** `muni_team_chief`  
+**Amaç:** Çevrimdışı çalışan saha personelinin internete bağlandığında gönderdiği çakışan veya sürüm uyuşmazlığı olan görev güncelleme taleplerini (`dispute_logs`) incelemek, hak edişlerini (performans puanlarını) yönetmek ve onay/ret kararı vermek.
+
+**Sayfa Düzeni ve Görsel Elemanlar:**
+- **Uyuşmazlık Özeti Kartı:** Çakışan iş emrinin detayları, çevrimdışı personelin adı, yerel tamamlama saati (`local_completed_at`), conflict türü (`AUTO_HANDOVER`, `REASSIGNED`, `DOUBLE_COMPLETE`) ve çevrimdışı çekilen kanıt fotoğrafları listelenir.
+- **Çift Hak Ediş Uyarısı (Double Payout Alert) Şeridi:**
+  - **Tetiklenme Koşulu:** İş emri canlı sistemde başka bir personel tarafından zaten çözülmüş (`resolved`) ve puanı yazılmışsa, sayfa üstünde belirir.
+  - **Görsel Tasarım:** HSL Danger Red (`#a44a3f`) arka planlı, kontrastı yüksek beyaz yazılı, sol tarafında yanıp sönen bir ünlem ikonu (`⚠️`) bulunan dikkat çekici bir üst uyarı şeridi.
+  - **Uyarı Metni:** `"DİKKAT: Bu iş emri daha önce canlı sistemde başka bir personel tarafından başarıyla tamamlanmış ve hak ediş puanı yazılmıştır. Bu uyuşmazlığı onaylamanız durumunda mükerrer (çift) hak ediş/ödeme tetiklenecektir!"`
+- **İşlem Butonları:**
+  - **[Emeği Onayla] (Forest Green - `#2C5F2D`):** Çevrimdışı emeğin hak edişini onaylar.
+    - *UX Akışı / Modal:* Eğer Çift Hak Ediş Uyarısı aktifse, butona basıldığında şefe onay öncesi bir teyit modalı gösterilir: `"Çift Hak Ediş Uyarısına rağmen bu emeği onaylamak istediğinizden emin misiniz? Onayınız 'approved_override' olarak denetim geçmişine kaydedilecek ve personelin hanesine performans puanı asenkron olarak yazılacaktır."` Şef onay verirse durum `approved_override` olarak güncellenir. Çift hak ediş yoksa durum doğrudan `approved` olur.
+  - **[Emeği Reddet] (Danger Red - `#a44a3f`):** Çevrimdışı emeği gerekçe göstererek reddeder. Şefin zorunlu ret notu (`notes`) girmesi istenir. Durum `rejected` olur.
+
+---
+
+### 2.4 Saha Personeli Görünümü (muni_worker)
+
+> **Not:** Personel ağırlıklı olarak mobil uygulamayı kullanır. Belediye panelinin web sürümünde de aynı sayfalar mevcuttur; tasarım mobil öncelikli (responsive) olarak yapılır.
+
+#### 2.4.1 Görev Listesi
+
+**URL:** `/worker/tasks`  
+**Erişim:** `muni_worker`  
+**Amaç:** Personele atanmış iş emirlerini görüntülemek ve yönetmek.
+
+**Sıralama (varsayılan):** Öncelik (azalan) → Konum (en yakın)
+
+**Filtreler**
+
+| Filtre | Seçenekler |
+| :--- | :--- |
+| Durum | Tümü / Bekliyor / Devam Ediyor / Şef Onayı Bekliyor |
+| Tarih | Bugün / Bu Hafta |
+
+**Liste Kartı**
+- Başlık, adres, öncelik rozeti, durum rozeti, beklenen tamamlanma saati (günlük plandan geliyorsa)
+- [İşi Üstlen] butonu: durum `in_progress` olur; onay toast'ı gösterilir
+
+#### 2.4.2 Görev Detay ve Tamamlama
+
+**URL:** `/worker/tasks/:id`  
+**Erişim:** `muni_worker`
+
+**Sayfa İçeriği**
+- Başlık, açıklama, adres, konum haritası
+- Moderatörün notu (varsa)
+- İşi haritada göster → Navigasyon başlat (dış uygulama seçim modal'ı)
+- Not Ekle alanı (max 500 karakter)
+
+**İşi Tamamla Akışı**
+```
+[Personel] → "İşi Tamamla" butonuna tıklar
+    ↓
+[Geofence Kontrolü]
+  Sistem personelin GPS konumunu iş emri koordinatı ile karşılaştırır.
+  Mesafe > 50 metre ise: "Konumunuz iş emri noktasından uzakta. Tamamlama için noktaya yaklaşmanız gerekmektedir." uyarısı gösterilir. Personelin bu engeli aşması için "Konum Düzeltme / Geofence Bypass Talebi" butonu aktifleşir. Personel gerçek sahadan EXIF konumlu fotoğrafı ve gerekçeyi sisteme yükleyerek şefe gönderir. Şef onaylayana kadar form kilitli kalır.
+    ↓
+
+**[Fotoğraf Yükleme Ekranı]**
+
+| Alan | Kural |
+| :--- | :--- |
+| Fotoğraf ekleme | Min 1, max 5 fotoğraf; JPG / PNG / WEBP; max 5 MB / dosya |
+| GPS damgası | Sunucu EXIF'ten GPS koordinatını okur; koordinat yoksa yükleme reddedilir (`422`) |
+| Çekim zamanı | EXIF `DateTimeOriginal` alanı zorunludur; cihaz saatiyle ±15 dakika tolerans |
+| Önizleme | Yüklenen fotoğraflar küçük önizleme kareli grid olarak gösterilir; üzerine çarpı ikonu ile silinebilir |
+| Fotoğraf notu | Her fotoğraf için opsiyonel kısa açıklama (max 200 karakter) |
+| Yükleme ilerleme çubuğu | Her dosya için ayrı ilerleme çubuğu; başarı → yeşil tik, hata → kırmızı uyarı |
+
+- Geofence başarılı ve en az 1 fotoğraf yüklenmiş ise **[İşi Tamamla]** butonu aktifleşir.
+- [İşi Tamamla] tıklanınca onay modal'ı: "Bu işi tamamlandı olarak işaretlemek istediğinizden emin misiniz?" → [Evet, Tamamla] / [Hayır, Geri Dön]
+- Onaylanınca:
+  - Durum `pending_chief_approval` olarak güncellenir
+  - Şefe push bildirimi gönderilir: "Onayınızı bekleyen iş tamamlandı."
+  - Personelin ekranında işin durumu "Şef Onayı Bekliyor" olarak görünür; yeni işlem butonu kalmaz (salt görüntüleme)
+- Çevrimdışı durumlarda fotoğraflar yerel kuyruğa alınır; internet gelince otomatik gönderilir (idempotency key ile)
+
+**Yarıda Bırakma**
+- "Yarıda Bırak" butonu: not alanı (zorunlu, max 500 karakter) → onay.
+- **Otomatik Re-assign:** İş otomatik olarak personelin üzerinden alınır, durum `assigned_to_team` (personel atanmamış) olarak güncellenir ve şefin atanmamış havuzuna geri düşer (Müdür bypass atamasında iş assigned_to_team yerine dispatched_to_department'a döner, müdür havuzuna gider). Şefe "Görev Yarıda Bırakıldı: [Gerekçe]" bildirimi gider.
+
+**Vardiyayı Kapat ve Görev Devri (Handover)**
+- [Vardiyayı Kapat] butonu (Profil veya Görev Listesi ekranında):
+- Sistem, personelin üzerinde `in_progress` durumda iş olup olmadığını kontrol eder.
+- Eğer varsa: "Üzerinizde devam eden X adet iş bulunmaktadır (Fotoğrafları yüklenip onay bekleyen `pending_chief_approval` işler bu listeden hariç tutulur ve üzerinizde kalmaya devam eder). Vardiyayı kapatırsanız sadece `in_progress` durumundaki aktif işler şef havuzuna devredilecektir. Devir notu eklemek ister misiniz?" modalı açılır.
+- Onaylandığında: Tüm aktif (`in_progress`) işler personelden düşer, şef havuzuna `assigned_to_team` olarak döner ve personelin konumuyla birlikte "Handover" logu oluşturulur (Şef onayı bekleyen işler personelden geri alınmaz).
+- **Otomatik Vardiya Kapatma (Auto-Handover):** Arka plan cron servisi, personelin GPS hareketliliğini ve son işlem zamanını izler. 8 saat boyunca GPS sinyali gönderilmeyen veya 12 saattir açık olan aktif vardiyaları otomatik kapatır; üzerindeki `in_progress` işleri şef havuzuna devrederek Handover logu oluşturur.
+
+---
+
+### 2.5 Admin Paneli (muni_admin)
+
+#### 2.5.1 Admin Dashboard
+
+**URL:** `/admin/dashboard`  
+**Erişim:** `muni_admin`  
+**Amaç:** Belediyenin genel durumunu tek sayfadan izlemek.
+
+**Widget'lar (özet kartlar)**
+- Bekleyen raporlar / Devam eden işler / Bu ay çözülen işler
+- SLA aşılan aktif iş emirleri (kırmızı uyarı)
+- Halka Açık Harita Metrikleri (Toplam public görünür rapor adedi, son 24 saatteki +1 oyları, PostgreSQL cache hit/miss oranı)
+- En Çok Destek Alan 10 Rapor Listesi (Tıklanınca ilgili iş detayına giden interaktif trend listesi)
+- Müdürlük bazında aktif iş dağılımı (yatay bar grafik)
+- Kaynak tipine göre iş emri dağılımı (pasta grafik): Vatandaş / Dahili / Entegrasyon / Periyodik
+- Son 30 günün günlük iş emri tamamlanma grafiği
+- Sistem uyarıları: Başarısız periyodik işler, entegrasyon hataları
+
+Tüm widget kartları tıklanabilir; ilgili detay sayfasına yönlendirir.
+
+#### 2.5.2 Müdürlük Yönetimi
+
+**URL:** `/admin/departments`  
+**Erişim:** `muni_admin`
+
+**Liste**
+- Tüm müdürlükler: ad, müdür sayısı, ekip sayısı, personel sayısı, durum (Aktif / Pasif)
+- [+ Müdürlük Ekle] butonu
+
+**Oluşturma / Düzenleme Formu**
+
+| Alan | Tür | Kural |
+| :--- | :--- | :--- |
+| Müdürlük Adı | Metin | Zorunlu, max 150 karakter |
+| Kısa Kod | Metin | Zorunlu, max 10 karakter, benzersiz, büyük harf |
+| Açıklama | Textarea | Opsiyonel, max 500 karakter |
+| Durum | Toggle | Aktif / Pasif |
+
+**Silme:** Aktif iş emri olan müdürlük silinemez; yalnızca Pasif yapılabilir.
+
+#### 2.5.3 Ekip ve Personel Yönetimi
+
+**URL:** `/admin/teams`  
+**Erişim:** `muni_admin`
+
+**Hiyerarşik Yapı:** Müdürlük seçimi → Ekipler → Ekip altındaki personel
+
+**Ekip Oluşturma / Düzenleme**
+
+| Alan | Tür | Kural |
+| :--- | :--- | :--- |
+| Ekip Adı | Metin | Zorunlu, max 100 karakter |
+| Bağlı Müdürlük | Dropdown | Zorunlu |
+| Ekip Şefi | Kullanıcı arama | Zorunlu; sistemdeki `muni_team_chief` rolündeki kullanıcılar listelenir |
+
+**Personel Ekleme**
+- Mevcut kullanıcı ara ve ekle, VEYA
+- Yeni kullanıcı davet et: e-posta gönderilir; kullanıcı ilk girişte şifre oluşturur
+- Her personel için rol ata: `muni_worker` / `muni_team_chief` / `muni_department_manager`
+
+**Ekip Silme ve Pasif Etme Kuralları:**
+- **Silme:** Ekip üzerinde aktif (açık) bir iş emri veya ekibe bağlı aktif personel bulunuyorsa fiziksel olarak silinemez.
+- **Pasif Etme (`is_active = false`):** Ekip pasife alınabilir. Pasife alındığında bu ekibe yeni iş emri havale edilemez (routing yapılamaz). Ekibe bağlı açık işler, müdür veya admin tarafından manuel olarak başka bir ekibe yeniden yönlendirilmeli (re-dispatch), ekipteki personeller ise geçici olarak "Boşta/Unassigned" havuzuna çekilmelidir.
+
+**Personel Silme ve Pasif Etme Kuralları:**
+- **Silme:** Veritabanındaki ilişkisel bütünlüğü ve geçmiş iş emirlerindeki log kayıtlarını korumak amacıyla personel hesapları fiziksel olarak silinemez.
+- **Pasif Etme (`is_active = false`):** Personel hesabı pasife alınabilir. Pasife alındığı anda `ROLE_CHANGE_CLEANUP` sistemi devreye girer: üzerindeki `in_progress` ve `assigned_to_worker` durumundaki tüm işler otomatik olarak `assigned_to_team` durumuna çekilir (yani şefin **atanmamış havuzuna** düşer — belirli bir şefe değil). Şefe anlık bildirim gönderilir. `pending_chief_approval` durumundaki işler ise bu devirden muaftır; atanan personel alanı pasifleşmiş olarak işaretlenir ve şefin onay kuyruğunda kalmaya devam eder. İşlem denetim loguna `ROLE_CHANGE_CLEANUP` olarak kaydedilir.
+
+
+#### 2.5.4 Kategori ve SLA Yönetimi
+
+**URL:** `/admin/categories`  
+**Erişim:** `muni_admin`
+
+**İki Sekme**
+- **Global Kategoriler:** Sadece görüntülenebilir; düzenlenemez veya silinemez; SLA süresi belediyeye özel ayarlanabilir
+- **Belediye Kategorileri:** Ekleme / düzenleme / silme (aktif iş emri yoksa)
+
+**Kategori Formu**
+
+| Alan | Tür | Kural |
+| :--- | :--- | :--- |
+| Kategori Adı | Metin | Zorunlu, max 100 karakter |
+| Üst Kategori | Dropdown | Opsiyonel (alt kategori için) |
+| Varsayılan Müdürlük | Dropdown | Zorunlu |
+| SLA Süresi | Sayı + Birim (saat / iş günü) | Zorunlu (Öncelik `Acil` veya `Kriz` ise bu süreler mesai saatlerinden bağımsız olarak 7/24 kesintisiz sayılır) |
+| Fotoğraf Zorunlu mu? | Radio | Zorunlu / Opsiyonel / Yok |
+| Public haritada görünür mü? | Toggle | Zorunlu (Varsayılan: Aktif) |
+| Risk Skoru | Sayı 1–10 | Opsiyonel; öncelik hesaplamasında kullanılır |
+| Durum | Toggle | Aktif / Pasif |
+
+#### 2.5.5 Akıllı Yönlendirme Kuralları
+
+**URL:** `/admin/routing-rules`  
+**Erişim:** `muni_admin`
+
+- Kategori başına bir satır tablo görünümü
+- Her satırda: Kategori adı · Birincil Müdürlük (dropdown) · İkincil Bildirim Müdürlükleri (çoklu checkbox)
+- Değişiklik kaydedildiğinde denetim loguna yazılır
+- Toplu güncelleme: CSV yükleme ile (kategori kodu + müdürlük kodu eşleşmesi)
+
+#### 2.5.6 Periyodik İş Takvimi
+
+**URL:** `/admin/schedule`  
+**Erişim:** `muni_admin` (tüm müdürlüklerin şablonlarını görebilir ve düzenleyebilir), `muni_department_manager` (yalnızca **kendi müdürlüğüne** ait şablonları görüntüleyebilir, oluşturabilir ve düzenleyebilir; diğer müdürlüklerin şablonlarını göremez)
+
+**Görünümler**
+- Liste görünümü (varsayılan): tüm şablonlar tablo olarak
+- Takvim görünümü: aylık/haftalık takvimde planlanan iş emirleri
+
+**Şablon Formu**
+
+| Alan | Tür | Kural |
+| :--- | :--- | :--- |
+| Şablon Adı | Metin | Zorunlu, max 150 karakter |
+| Açıklama | Textarea | Opsiyonel, max 1000 karakter |
+| Kategori | Dropdown | Zorunlu |
+| Sorumlu Müdürlük | Dropdown | Zorunlu |
+| **Öncelik** | Radio | Zorunlu; Normal (varsayılan) / Yüksek / Acil / Kriz. **Not:** `Acil` veya `Kriz` seçilirse SLA sayacı 7/24 kesintisiz çalıştırılır. |
+| Varsayılan Ekip / Şef | Dropdown | Opsiyonel; atanmazsa müdürlük havuzuna düşer |
+| Tekrar Sıklığı | Radio | Günlük / Haftalık / Aylık / Özel (cron ifadesi) |
+| Günlük ise saat | Saat seçici | Zorunlu (günlük tekrarda) |
+| Haftalık ise günler | Çoklu checkbox | Zorunlu (haftalık tekrarda) |
+| Aylık ise gün | Sayı 1–28 | Zorunlu (aylık tekrarda) |
+| Başlangıç Tarihi | Tarih | Zorunlu |
+| Bitiş Tarihi | Tarih | Opsiyonel; boşsa süresiz |
+| Durum | Toggle | Aktif / Pasif |
+
+- **Çakışma Kuralı (Concurrency Rule):** Aynı şablondan üretilmiş ve henüz kapatılmamış (`resolved`/`rejected` olmayan) aktif bir iş emri varsa, sistem yeni bir iş emri üretmez (Skip/Atla) ve bu durumu uyarı loglarına yazar.
+
+**Şablon Silme ve Durum Yönetimi:**
+- **Silme:** Periyodik iş şablonları fiziksel olarak silinemez.
+- **Durum:** Yalnızca [Pasif] konuma getirilebilir (`is_active = false`). Pasif yapılan şablonların gelecekteki cron tetiklemeleri durdurulur; geçmişte bu şablondan üretilmiş olan iş emirlerinin geçmişi ve bütünlüğü korunur.
+
+#### 2.5.7 Entegrasyon Yönetimi
+
+**URL:** `/admin/integrations`  
+**Erişim:** `muni_admin`
+
+**Liste**
+- Entegrasyon kaynakları: kaynak adı, hedef müdürlük, durum, son başarılı istek, son hata
+
+**Yeni Entegrasyon Formu**
+
+| Alan | Tür | Kural |
+| :--- | :--- | :--- |
+| Kaynak Adı | Metin | Zorunlu, max 100 karakter |
+| Hedef Müdürlük | Dropdown | Zorunlu |
+| Entegrasyon Türü | Radio | `generic_webhook` (Standart Webhook) / `custom_iot_sensor` (Özel Donanım/Sensör Entegrasyonu) |
+| Alan Eşleştirme (Mapping) | JSON / GUI Mapper | Entegrasyon Türü `custom_iot_sensor` ise zorunlu. Cihaz kimliği, doluluk oranı, arıza durumu ve koordinat alanlarının gelen JSON gövdesindeki karşılıklarını belirler (Örn: `fill_level_percentage` = `telemetry.level`) |
+| Özel Parser Betiği (Sandbox JS) | Kod Editörü (JS) | Opsiyonel. Gelişmiş veri dönüştürme ve kalibre etme işlemleri için JavaScript kodu girişi (Örn: `function parse(payload) { return { fill_level_percentage: payload.raw_val / 10 }; }`) |
+| **Halka Açık Görünürlük Varsayılanı (`default_public`)** | **Checkbox (Toggle)** | **Zorunlu.** Bu entegrasyondan tetiklenen iş emirlerinin varsayılan olarak public haritada görünüp görünmeyeceğini belirler. Aktif ise yeni iş emirleri `is_public_visible = true` ile oluşturulur; pasif ise `false` ile oluşturulur ve moderatör onayı olmadan gösterilemez. Varsayılan: **Pasif (gizli).** |
+| API Anahtarı | Otomatik oluşturulur | Kopyalama butonu; yeniden oluşturma (mevcut anahtarı geçersiz kılar) |
+| Açıklama | Textarea | Opsiyonel |
+| Durum | Toggle | Aktif / Pasif |
+
+**IoT Cihaz Envanteri ve İzleme Sekmesi**
+*   **Envanter Listesi:** Eşleştirilmiş aktif IoT cihazlarının listesi: Cihaz Kimliği (`device_id`), Cihaz Türü (Çöp/Geri Dönüşüm), Atık Tipi (Plastik/Kağıt vb.), Doluluk Oranı (%72 vb. - ilerleme çubuğu ile), Batarya Seviyesi (%90), Sağlık Durumu (Aktif/Arızalı/Bakımda), Son Telemetri Sinyali Zamanı.
+*   **Harita Görünümü (Leaflet):** Envanterdeki tüm cihazların harita üzerinde pinler şeklinde gösterilmesi. Pin renkleri doluluk seviyesine göre dinamik olarak renklenir:
+    *   **Yeşil (Forest Green):** Doluluk < %50
+    *   **Sarı (Lime/Orange):** %50 ≤ Doluluk < %85
+    *   **Kırmızı (Danger Red):** Doluluk ≥ %85 (İş emri oluşturulmuş) VEYA Durum = Arızalı
+*   **İşlemler:** Cihaz detayını görüntüleme, geçmiş telemetri log grafiklerini inceleme, cihazı manuel "Bakım" moduna alma (SLA/İş Emri tetiklemelerini geçici olarak durdurur).
+*   **Sensör Spam Koruması ve Otomatik Bakım Modu (Cool-Down):** `resolved` durumuna getirilen bir iş emrinin ardından 1 saat içinde aynı sensörden tekrar doluluk sinyali gelirse, sistem otomatik olarak sensörü "Şüpheli / Bakım Gerekli (suspicious)" moduna alır, yeni iş emri tetiklemez ve admin paneline arıza kontrol uyarısı düşer.
+
+**Hata Logları Sekmesi**
+- Hatalı webhook isteklerinin ve parser çökmelerinin listesi: tarih, entegrasyon kaynağı, hata türü (400 Bad Request, 422 Parser Error vb.), hata detayı/log çıktısı, istek gövdesi (ilk 500 karakter), yeniden deneme butonu.
+
+**Entegrasyon Kaynağı Silme ve Pasif Etme:**
+- **Silme:** Entegrasyon kaynakları veritabanında denetim bütünlüğü için silinemez.
+- **Pasif Etme (`is_active = false`):** Sadece pasif konuma getirilebilir. Pasif yapıldığında bu entegrasyona bağlı olan IoT cihazlarından gelen telemetri verileri sistem tarafından reddedilir. Geçmiş entegrasyon logları saklanmaya devam eder.
+
+**IoT Cihaz Silme ve Düzenleme:**
+- **Silme:** Sensör fiziksel olarak kaldırıldığında cihaz envanterden silinemez, durum parametresi **"Arşivlendi (archived)"** olarak güncellenir. Bu durumda cihaza ait veri alımı kalıcı olarak durdurulur ama geçmiş veri bütünlüğü korunur.
+- **Düzenleme:** Cihaz bilgileri (cihaz türü, atık tipi, lokasyon notu) IoT Cihaz Envanteri listesinde [Düzenle] butonu ile güncellenebilir.
+
+#### 2.5.8 Duyuru Yönetimi
+
+**URL:** `/admin/announcements`  
+**Erişim:** `muni_admin`
+
+**Liste + Oluşturma / Düzenleme Formu**
+
+| Alan | Tür | Kural |
+| :--- | :--- | :--- |
+| Başlık | Metin | Zorunlu, max 150 karakter |
+| İçerik | Zengin metin editörü | Zorunlu, max 5000 karakter |
+| Tür | Radio | Bilgi / Uyarı / Acil |
+| Etkilenen İlçe/Mahalleler | Çoklu dropdown | Zorunlu; "Tüm Belediye" seçeneği de var |
+| Yayın Tarihi | Tarih-saat | Zorunlu; ileriye tarihleme desteklenir |
+| Bitiş Tarihi | Tarih-saat | Opsiyonel; girildiyse vatandaş arayüzünden otomatik kaldırılır |
+
+**Duyuru Silme ve Yayından Kaldırma:**
+- **Silme:** Duyurular listedeki [Sil] butonu ile fiziksel olarak silinebilir. Silindiğinde vatandaş arayüzünden ve mobil bildirimlerden anında kaldırılır.
+- **Yayından Kaldırma:** Bitiş tarihi beklenmeden duyuruyu anlık olarak yayından kaldırmak için [Yayından Kaldır] butonu mevcuttur. Bu buton duyurunun durumunu `draft` veya `archived` olarak günceller ve vatandaş ekranlarından gizler.
+
+#### 2.5.9 Fikir Moderasyonu
+
+**URL:** `/admin/ideas`  
+**Erişim:** `muni_admin`
+
+**Filtreler:** Durum (Beklemede / Onaylandı / Reddedildi) · Tarih
+
+**İşlemler**
+- [Onayla]: Fikir vatandaş arayüzünde yayımlanır
+- [Reddet]: Gerekçe alanı (max 500 karakter) zorunlu; vatandaşa bildirim gönderilmez
+- [Resmi Yanıt Ekle]: Metin alanı (max 1000 karakter); vatandaş arayüzünde fikrin altında yayımlanır
+
+**Fikir Silme ve Düzenleme Kuralları:**
+- **Silme / Yayından Kaldırma:** Onaylanmış veya reddedilmiş bir fikir, vatandaşların oyları ve veri bütünlüğü için fiziksel olarak silinemez. Ancak, sonradan uygunsuz içerik tespit edilirse [Geri Çek / Gizle] butonu ile vatandaş panelinden tamamen gizlenebilir (`status = 'hidden'`).
+- **Resmi Yanıt Düzenleme:** Fikre eklenen "Resmi Yanıt" istenildiği zaman [Yanıtı Düzenle] butonu ile güncellenebilir veya [Yanıtı Sil] ile tamamen kaldırılabilir.
+
+#### 2.5.10 Analitik ve Raporlama
+
+**URL:** `/admin/analytics`  
+**Erişim:** `muni_admin`, `muni_department_manager` (yalnızca kendi müdürlüğü), `muni_team_chief` (yalnızca kendi ekibi)
+
+**Sekmeler**
+
+| Sekme | İçerik |
+| :--- | :--- |
+| **Özet** | Bekleyen / Devam / Çözülen sayıları; müdürlük dağılımı; kaynak tipi dağılımı |
+| **Isı Haritası** | **Bölgesel Yoğunluk Analizi:** Belediye sınırları içerisinde mahalle ve sokak bazlı sorun kümelerini gösteren ısı haritası. Kategori ve tarih filtresine göre dinamik güncellenir. Halka açık görünürlük durumuna göre filtreleme (`is_public_visible = true|false`) ve katman yönetimi mevcuttur. |
+| **Performans** | Ortalama çözüm süresi (trend grafiği); müdürlük ve ekip bazında tamamlanan iş; en sık kategoriler |
+| **SLA Raporu** | Süresinde kapatılan vs. aşılan iş oranı; müdürlük bazında SLA uyum yüzdesi |
+| **Vatandaş Memnuniyeti** | Yıldız ortalaması (tüm zaman / aylık); yeniden açılma oranı; kategori bazında memnuniyet |
+| **Destek Analitiği** | Vatandaş katılımı ve "+1 Beni de Etkiliyor" desteği metrikleri: En Çok Desteklenen Raporlar listesi, mahalle bazlı destek yoğunluk dağılımı, zaman serisi bazında destek sayısı trend grafiği. |
+| **Personel Performansı** | Ekip/personel bazında tamamlanan iş sayısı ve ortalama süre |
+| **Özel Raporlar (Custom)** | **Dinamik Özel Rapor Oluşturucu (Custom Report Builder):** Drag-and-drop arayüzü ile belediye yöneticilerinin kendi özel rapor şablonlarını oluşturduğu alan. Boyutlar (kategori, mahalle, personel, müdürlük, öncelik, kronik durumu) ile metrikler (iş sayısı, SLA uyum %, ortalama çözüm süresi, memnuniyet puanı, re-open %) serbestçe eşleştirilip filtrelenebilir. |
+
+**Ortak Kontroller (tüm sekmeler için)**
+- Tarih aralığı seçici: Son 7 Gün / Son 30 Gün / Son 3 Ay / Özel
+- Müdürlük filtresi (yalnızca muni_admin için)
+- Dışa Aktar butonu: PDF veya Excel (XLSX)
+
+**Dinamik Özel Rapor Oluşturucu ve Zamanlayıcı Yapısı:**
+1. **Şablon Tasarımı (Builder):** `muni_admin` seçtiği metrikleri (örn. *Fen İşleri Ortalama Çözüm Süresi*), boyutları (örn. *Mahalle Bazlı*) sürükleyip bırakarak pivot veya tablo görünümü oluşturur.
+2. **Performans İzleme (Read Replica):** Raporlama sorguları veritabanı performansını düşürmemek için doğrudan canlı DB yerine read-replica sunucusu üzerinden izole olarak çalıştırılır.
+3. **Otomatik Zamanlayıcı (Report Scheduler):** Oluşturulan özel şablonlar periyodik gönderime bağlanabilir. Admin panelinden haftalık (örn. Her Pazartesi 09:00) veya aylık (örn. Ayın 1'i) periyotlar seçilerek tanımlanan e-posta adreslerine rapor otomatik olarak şık stilize edilmiş PDF veya ham veri içeren XLSX formatında gönderilir.
+
+#### 2.5.11 Denetim Logları
+
+**URL:** `/admin/audit-logs`  
+**Erişim:** `muni_admin`
+
+**Liste Sütunları**
+- Tarih-Saat · Kullanıcı · Rol · Olay Tipi · Etkilenen Kayıt (iş emri no / kullanıcı adı vb.) · IP Adresi · Aksiyonlar
+
+**Filtreler**
+
+| Filtre | Seçenekler |
+| :--- | :--- |
+| Olay Tipi | REPORT_REDISPATCHED, STATUS_CHANGED, USER_CREATED, KVKK_DELETE, KVKK_ANONYMIZE_STARTED, GDPR_AUDIT_LOG_MASKED, INTEGRATION_ERROR, MANAGER_FORCE_APPROVE, FORCE_RESOLVE, MANUAL_APPROVAL, ROLE_CHANGE_CLEANUP, DISPUTE_RESOLVED, PUBLIC_VISIBILITY_CHANGED, SUPPORT_VOTE_ADDED, SUPPORT_VOTE_REMOVED vb. (dropdown, çoklu seçim) |
+| Kullanıcı | Metin araması |
+| Tarih Aralığı | Özel aralık |
+| Vatandaş | `citizen_id` UUID bazlı arama (KVKK denetim sorgusu) |
+
+**Görsel Denetim Logu Vizörü (Visual JSONB Diff Viewer):**
+Her denetim log satırının sonunda bulunan **"İncele"** butonuna basıldığında ekranın sağ tarafından HSL Adaçayı/Orman Yeşili temalı şık bir drawer (modal yan panel) açılır:
+1. **Üst Bilgi Kartı:** İşlemi yapan personelin adı-soyadı, e-postası, rolü, işlemin gerçekleştiği IP adresi ve cihaz bilgileri (User-Agent) listelenir.
+2. **JSONB Diff Görünümü:** Veritabanındaki `payload_old` ve `payload_new` JSON verileri karşılaştırılarak side-by-side (yan yana) veya line-by-line (satır satır) karşılaştırmalı görünümde yansıtılır:
+   - **Eklenen Veriler / Yeni Değerler:** Arka planı hafif HSL yeşili (`#e6f4ea`) ve yeşil metin rengi ile vurgulanır.
+   - **Silinen Veriler / Eski Değerler:** Arka planı hafif HSL kırmızı/pembe (`#fce8e6`) ve kırmızı metin rengi ile vurgulanır.
+   - Değişmeyen satırlar arka plan rengi olmadan düz listelenir.
+3. **Veri Sayfalama (Offset-based Pagination):** Tarihsel audit sorgularının performansı için listelemede `page` ve `limit = 25` parametreleri içeren offset bazlı sayfalama zorunludur.
+
+- Loglar kesinlikle silinemez, değiştirilemez ve dışarıdan manipüle edilemez; yalnızca okunabilir (Read-Only).
+- Dışa Aktar: CSV formatında dışa aktarma düğmesi mevcuttur.
+
+
+#### 2.5.12 KVKK Yönetimi
+
+**URL:** `/admin/gdpr`  
+**Erişim:** `muni_admin`
+
+**gdpr_requests Tablo Yapısı:**
+- `id UUID PRIMARY KEY`
+- `citizen_id UUID (ref: citizen.id)`
+- `status TEXT (pending | processing | completed) DEFAULT 'pending'`
+- `requested_at TIMESTAMPTZ`
+- `processed_at TIMESTAMPTZ NULL`
+- `anonymized_at TIMESTAMPTZ NULL`
+- `admin_notes TEXT NULL`
+
+- Vatandaş silme taleplerinin listesi: `gdpr_requests` tablosu üzerinden; talep tarihi, durum (Beklemede / İşlemde / Tamamlandı), `anonymized_at` zaman damgası.
+- **[Talebi İşle] akışı:**
+  1. E-posta veya telefon ile kullanıcı aranarak eşleştirme doğrulanır.
+  2. `muni_admin` onayladığında: `citizen` tablosu kişisel alan maskelenir, `work_orders` anonimleştirilir, `support_votes` silinir, IP adresleri `0.0.0.0` yapılır. İşlem denetim loguna `KVKK_DELETE` olarak kaydedilir.
+  3. **Asenkron Denetim Logu Maskeleme (KVKK Zorunluluğu):** Ana anonimleştirme tamamlandıktan sonra sistem otomatik olarak arka plan job'u başlatır. Bu job `audit_logs` tablosundaki `old_value` ve `new_value` alanlarında silinen vatandaşa ait geçmiş kayıtları regex ile tarar; telefon, T.C. kimlik numarası, e-posta ve ad-soyad verilerini `[KİŞİSEL VERİ SİLİNDİ]` ile maskeler. Job tamamlandığında `gdpr_requests.status = 'completed'` ve `anonymized_at` zaman damgası yazılır; denetim loguna `GDPR_AUDIT_LOG_MASKED` olayı eklenir.
+- Tamamlanan talepler silinmez; arşiv olarak tutulur (`gdpr_requests` tablosu silinemez).
+
+
+#### 2.5.13 Belediye Ayarları
+
+**URL:** `/admin/settings`  
+**Erişim:** `muni_admin`
+
+| Alan | Tür | Kural |
+| :--- | :--- | :--- |
+| Belediye Adı | Metin | Zorunlu |
+| Logo | Dosya yükleme | PNG/SVG, max 2 MB |
+| İletişim E-postası | E-posta | Zorunlu |
+| İletişim Telefonu | Telefon | Opsiyonel |
+| Coğrafi Sınırlar (GeoJSON) | Dosya yükleme veya metin alanı | PostGIS uyumlu GeoJSON; haritada önizleme gösterilir. **Failsafe:** Alan daralması tespiti ve uyarısı mevcuttur. |
+| Zaman Dilimi | Dropdown | Varsayılan: Europe/Istanbul |
+| Varsayılan Dil | Dropdown | Şu an yalnızca Türkçe |
+
+**Geofencing Ayarları**
+- [Geofencing Aktif/Pasif] Toggle (Acil durumlarda sistem genelinde sınırlamayı kaldırmak için)
+- **50m Geofence İstisna Tanımlama:** Bazı iş kategorileri için 50 metrelik mesafe kuralı yetersiz kalabilir (geniş alanlı park bakım, altyapı çalışmaları gibi). `muni_admin`, kategori veya müdürlük bazında "Geofence Mesafesi" değerini 50m–500m arasında özelleştirebilir. Her istisna düzenleyebilir ve kaldırılabilir; değişiklikler denetim loguna kaydedilir.
+
+**Public Harita Ayarları**
+- **Public Harita Genel Toggle:** Halka açık sorun haritasının aktif veya pasif yapılmasını sağlar. Pasif yapıldığında ana sayfa (`/`) graceful fallback mesajı gösterir.
+- **Varsayılan Görünürlük Politikası:** Yeni gelen raporların varsayılan görünürlük durumu (`Otomatik Görünür` - moderation sonrası doğrudan gösterim / `Moderatör Onaylı` - moderatörün açık onayını gerektiren gösterim).
+- **Çözülen Raporların Kalma Süresi:** Çözülmüş statüsündeki raporların public haritada ne kadar süre daha gösterilmeye devam edeceğini belirler (30 gün / 90 gün / 6 ay / 1 yıl).
+- **Koordinat Fuzzing Miktarı (Yarıçapı):** Güvenlik ve gizlilik sebebiyle public haritada pinlerin konumlarının ne kadar kaydırılacağını (fuzzing) belirler (25m / 50m / 100m).
+- **Fotoğrafların Public Gösterilmesi Varsayılanı:** Halka açık haritada rapor fotoğraflarının varsayılan olarak gösterilip gösterilmeyeceğini belirler (Açık / Kapalı).
+- **Varsayılan Kaynak Görünürlük Politikaları:** Kaynak tiplerine göre (`citizen_report`, `manual_internal`, `scheduled`, `integration` - IoT) varsayılan görünürlük ayarlarının özelleştirilmesi.
+
+> **Kısıtlama:** Bu Public Web Yol Haritası **sadece Merkez Panel (Central Admin)** üzerinden yönetilebilir. Belediye paneli (muni_admin dahil) bu içeriğe erişemez ve değiştiremez. Belediye sadece kendi belediyesine özel Public Harita ayarlarını yönetebilir.
+
+**Statik Nokta (Geri Dönüşüm / Afet) Yönetimi**
+- `/admin/settings/static-points` sayfası üzerinden:
+- **Geri Dönüşüm Noktaları:** Ekle / Düzenle / Sil (Tür, Adres, Konum, Detay)
+- **Afet Toplanma Alanları:** Ekle / Düzenle / Sil (Kapasite, Adres, Konum)
+- **Toplu Veri:** GeoJSON veya CSV formatında toplu nokta yükleme ve harita üzerinde önizleme.
+
+#### 2.5.14 Kriz Masası Canlı Haritası
+
+**URL:** `/admin/crisis-map`  
+**Erişim:** `muni_admin` (Afet Modu aktifken görünür)  
+**Amaç:** Afet anında gelen panik sinyallerini gerçek zamanlı izlemek ve koordine etmek.
+
+**Sayfa İçeriği**
+- **Tam Ekran Harita:** Gelen panik sinyalleri (GPS) ısı haritası veya kümelenmiş (clustered) pinler olarak gösterilir.
+- **Sinyal Detayı:** Pin üzerine tıklandığında konum, saat ve vatandaş takip kodu gösterilir.
+- **Toplu İşlem Paneli (Bulk Actions):** 
+  - Seçili alanı kare içine alarak tüm sinyalleri seçme.
+  - "Müdahale Edildi / Güvende" olarak toplu kapatma.
+- **Statik Katmanlar:** Toplanma alanları, hastaneler ve kapalı yollar harita üzerinde katman olarak açılıp kapatılabilir.
+
+#### 2.5.15 Anlaşmazlık Çözüm (Ping-Pong) Kuyruğu
+
+**URL:** `/admin/disputes`  
+**Erişim:** `muni_admin`  
+**Amaç:** Müdür/admin tarafından 3. re-dispatch gerçekleştiğinde (re-dispatch sayacı `> 2`) sistem tarafından admin'e eskalasyon yapılan iş emirlerini incelemek ve son kararı vermek.
+
+**Liste Sütunları**
+- İş Emri No · Başlık · Müdürlükler Arası Geçiş Sayısı · Son Reddeden Müdürlük · Tarih
+- Satır tıklanınca iş emri detayına gider. Admin bu sayfada doğrudan herhangi bir müdürlüğe **"Kesin Atama"** yapabilir.
+
+**Kesin Atama Davranışı:**
+- Kesin atama yapıldığında iş emrine `is_force_assigned = true` flag'i yazılır.
+- Bu flag aktifken hedef müdürlük ve müdürler `re-dispatch` yapamaz; iş API katmanında kilitlidir.
+- Yalnızca `muni_admin` tekrar müdahale edebilir (flag'i kaldırabilir veya yeniden kesin atama yapabilir).
+- Re-dispatch sayacı sıfırlanır; iş sıfır sayaçla yeni müdürlüğe düşer.
+- Her kesin atama işlemi denetim loguna `DISPUTE_RESOLVED` olarak kaydedilir.
+
+
+---
+
+### 2.6 Profil ve Güvenlik Ayarları (Tüm Belediye Personeli)
+
+**URL:** `/profile/security`  
+**Erişim:** Tüm Belediye Rolleri  
+**Amaç:** Kullanıcının kendi bilgilerini ve 2FA ayarlarını yönetmesi.
+
+**Bölümler**
+- **Hesap Bilgileri:** Ad, Soyad, E-posta, Profil Fotoğrafı.
+- **Şifre Güncelleme:** Mevcut şifre ve yeni şifre alanları.
+- **İki Faktörlü Doğrulama (2FA):** 
+  - Durum (Aktif / Pasif) toggle.
+  - Aktifleştirildiğinde: QR kod gösterimi (Authenticator App uyumlu) + Yedek kodlar listesi.
+- **Oturum Yönetimi:** Mevcut aktif oturumların listesi ve "Tüm Cihazlardan Çıkış" butonu.
+
+---
+
+### 2.7 Birleşik Mobil Uygulama (Unified Mobile App) — Rol Tabanlı Mobil Deneyim ve Aksiyonlar
+
+KENTİM Mobil Uygulaması (React Native + Expo), normal vatandaşların yanı sıra belediye içindeki tüm operasyonel rollerin (**Saha Personeli, Ekip Şefi ve Departman Müdürü**) hareket halindeyken (on-the-go) görev takibi yapabilmesi, push bildirimleri alabilmesi ve iş atayıp onaylayabilmesi için **Dinamik Rol Tabanlı UI Geçişi** ile tasarlanmıştır.
+
+#### 2.7.1 Mobil Vatandaş Görünümü
+*   **Arayüz:** Web public arayüzündeki tüm harita, 3 adımlı rapor modalı, takip drawer'ı, oylama, duyurular, geri dönüşüm ve acil/panik afet katmanları mobil ekranına duyarlı (responsive) olarak sunulur.
+
+#### 2.7.2 Mobil Belediye Görünümü (Rol Tabanlı Ekranlar)
+
+Kullanıcı kurumsal hesabı ile giriş yaptığında, JWT token içindeki yetki rolüne göre mobil kabuk (shell UI) otomatik olarak şu ekranlara dönüşür:
+
+##### A. Saha Personeli Görünümü (`muni_worker`)
+*   *Mobil Görev Havuzu:* Kendisine atanan işlerin öncelik ve yakınlık mesafesine göre listelenmesi.
+*   *Görev Detay ve Tamamlama:* Navigasyon başlatma, dahili not ekleme, 50m geofence GPS kilidi, EXIF doğrulamalı kamera vizörü ile fotoğraf çekip işi tamamlayarak şef onayına gönderme.
+*   *Çevrimdışı Mod:* SQLite/MMKV yerel veri önbelleği ve internet bağlantısı sağlandığında otomatik sync kuyruğu.
+*   *Vardiya Kapatma (Handover):* Vardiya kapatıldığında `in_progress` işleri otomatik olarak şef havuzuna devretme.
+
+##### B. Ekip Şefi Görünümü (`muni_team_chief`) — Mobil Planlama ve Fotoğraf Onay
+*   **Mobil Görev Dağıtım Ekranı:** 
+    *   Müdürlükten ekibe sevk edilmiş atanmamış (`assigned_to_team`) işlerin listesi.
+    *   İş emri kartının altındaki [Personele Ata] butonu tıklanarak kendi ekibindeki aktif personellerin listelendiği dropdown açılır; onaylandıktan sonra durum `assigned_to_worker` olur ve ilgili personele push bildirimi gider.
+*   **Mobil Fotoğraf ve Kanıt Denetimi:**
+    *   Personelin tamamlayıp `pending_chief_approval` durumuna getirdiği işler şefin mobil ekranına anlık push bildirimiyle düşer.
+    *   Şef fotoğrafları ve üzerindeki EXIF GPS/saat damgalarını mobil ekranında inceleyerek doğrudan **[Fotoğrafı Onayla (resolved)]** veya **[Fotoğrafı Reddet (in_progress - gerekçe zorunlu)]** aksiyonu alır.
+*   **Mobil Kalite Kontrol (QA):**
+    *   Vatandaşın düşük puan verdiği işler şefe push bildirimiyle iletilir. Şef mobil detay ekranından **[Çözümü Kesinleştir]** veya **[Yetersiz - İşe Döndür]** kararlarını anında verir.
+
+##### C. Departman Müdürü Görünümü (`muni_department_manager`) — Mobil Yönetim ve Eskalasyon
+*   **Mobil Müdür Havuzu:**
+    *   Müdürlüğün atanmamış havuzunda (`dispatched_to_department`) bekleyen veya müdürlük altındaki tüm aktif iş emirlerinin listelenmesi.
+*   **Mobil Üzerinden İş Atama (Bypass Yetkisi):**
+    *   Müdür, mobil detay sayfasından **[Şefe Ata]** dropdown'unu kullanarak işi uygun şefin havuzuna yönlendirir.
+    *   Dilerse şeflik kademesini atlayarak **[Personele Doğrudan Ata (Bypass)]** dropdown'u ile işi doğrudan saha personeline atayabilir. Bu durumda onay yetkisi müdüre geçer.
+*   **Eskalasyon ve Acil Aksiyon Butonları (Müdür Kontrolleri):**
+    *   Müdürün telefonuna şu durumlarda **Kritik Eylem Push Bildirimleri** gönderilir:
+        1. **SLA Kritik / SLA Aşıldı:** İş emrinin SLA süresi dolduğunda veya %80 sınıra ulaştığında.
+        2. **Ret Devre Kesici (Circuit Breaker):** Bir iş üst üste 3 kez fotoğraf reddi alıp `pending_manager_review` durumuna düştüğünde.
+        3. **Re-dispatch Anlaşmazlığı:** İş emri ping-pong korumasına girmeden önce müdüre sevk uyarısı geldiğinde.
+    *   Müdür bildirim üzerine tıkladığında mobil uygulama doğrudan o iş emrinin detay sayfasını açar ve müdüre şu **Hızlı Karar Butonlarını** sunar:
+        *   **[Zorla Çözüldü Yap] (`force_resolve`):** Şef veya personel kanıtlarını bypass ederek işi doğrudan kapatır.
+        *   **[Personel Değiştir] (`reassign_worker`):** Ret sayacını sıfırlayarak işi yeni personeline sevk eder.
+        *   **[İşi İptal Et] (`reject`):** Gerekçeli olarak iş emrini sonlandırır.
+        *   **[Manuel Onayla] (`manual_approval`):** Mevcut yetersiz kanıtları kabul ederek onaylar.
+        *   **[Müdürlük Sevk] (`re-dispatch`):** İşin kendi müdürlüğüne ait olmadığı gerekçesiyle mobil ekranından gerekçe girerek işi tekrar moderatör kuyruğuna iade eder.
+
+#### 2.7.3 İnteraktif Mobil Push Bildirim Matrisi (Actionable Push Notifications)
+Mobil uygulama üzerinden gönderilen bildirimler yalnızca bilgilendirici değil, **tıklanabilir ve hızlı aksiyon alınabilir** (actionable) yapıdadır:
+
+| Alıcı Rol | Tetikleyici Olay | Push Bildirim İçeriği | Tıklama Sonrası Mobil Aksiyon / Ekran |
+| :--- | :--- | :--- | :--- |
+| **Saha Personeli** | Yeni İş Atandı | "Size yeni bir saha görevi atandı. Detayları görmek için tıklayın." | Doğrudan görev detay sayfasını açar; `[İşi Üstlen (in_progress)]` butonu odaklanır. |
+| **Ekip Şefi** | İş Onay Bekliyor | "Personel [Ad] görevi tamamladı. Fotoğraflı kanıtları onaylamak için tıklayın." | Şefin fotoğraf denetim vizörünü açar; `[Onayla]` ve `[Reddet]` hızlı butonları belirir. |
+| **Departman Müdürü** | Devre Kesici (3x Ret) | "ACİL: [No] nolu iş üst üste 3 kez reddedildi. İncelemek için tıklayın." | `pending_manager_review` ekranını açar; `[Force Resolve]` / `[Reassign]` aksiyon paneli aktifleşir. |
+| **Departman Müdürü** | SLA Aşıldı | "UYARI: [No] nolu iş emrinin SLA süresi aşıldı! Müdahale etmek için tıklayın." | İş emrinin zaman çizelgesini ve atanan ekibi açar; müdüre `[Reassign]` veya `[Force Approve]` yetkisi sunar. |
+
+**Sonuç:** KENTİM Mobil Uygulaması, saha personelinden departman müdürüne kadar tüm rolleri birbirine anlık etkileşimli push bildirimleri ve aksiyon butonlarıyla bağlayan, tam kapsamlı bir mobil iş yönetim merkezidir.
+
+---
+
+## BÖLÜM 3: Central Panel — `central.kentim.com.tr`
+
+### 3.0 Kimlik Doğrulama
+
+**URL:** `/login`
+
+```
+E-posta + şifre girişi
+  → Başarılı: Role göre yönlendirme
+    - central_admin      → /dashboard
+    - central_moderator  → /dashboard
+  → Başarısız: 5 denemede 15 dakika kilidi
+```
+
+İsteğe bağlı 2FA (TOTP): `muni_admin` ve `central_admin` rolleri için etkinleştirilebilir (`/profile/security` sayfasından).
+
+---
+
+### 3.1 Central Dashboard
+
+**URL:** `/dashboard`  
+**Erişim:** `central_admin`, `central_moderator`  
+**Amaç:** Tüm belediyelerin anlık özetini izlemek.
+
+**Widget'lar**
+
+- Aktif Belediye Sayısı / Toplam Lisans
+- Toplam Aktif İş Emri (tüm belediyeler)
+- Bu Ay Çözülen İş Emirleri
+- SLA Aşım Oranı (belediye ortalaması)
+- **Belediye Durumu Tablosu:** Her belediye için ad · Aktif İş · Heartbeat Durumu (yeşil/sarı/kırmızı) · Son Veri Alım Zamanı · Abonelik Bitiş Tarihi
+- **Uyarılar Bölümü:** Heartbeat kesintileri, SLA aşımları, abonelik bitiş yaklaşanlar (30 gün içinde)
+
+> `central_moderator` için: Dashboard, Sistem Sağlığı (`/system-health`), Global Raporlar (`/reports`) ve Denetim Logları (salt-okunur, sadece kendi yaptığı işlemler) erişimine sahiptir. Belediye yönetimi, Afet Modu tetikleme, Kullanıcı yönetimi ve Global Kategori düzenleme yetkisi **yoktur**. Bireysel iş emri, vatandaş verisi veya koordinat detayına erişemez.
+
+---
+
+### 3.2 Belediye Yönetimi
+
+**URL:** `/municipalities`  
+**Erişim:** `central_admin`  
+**Amaç:** Belediye ekleme, durum güncelleme ve abonelik yönetimi.
+
+**Liste Sütunları**
+- Belediye Adı · İl · Durum (Aktif / Pasif / Süresi Dolmuş) · Abonelik Bitiş · Heartbeat Durumu · Kayıt Tarihi
+- Arama: belediye adı ile
+
+**Yeni Belediye Ekleme & Dinamik Lokasyon Bağlama**
+
+Belediye ekleme formu, Türkiye'nin coğrafi sözlük hiyerarşisiyle tam entegre çalışır. Lokasyon dropdown alanları şu kurallarla dinamik olarak beslenir:
+1. **İl Dropdown (Dinamik Binding):** Form açıldığı anda, frontend arka planda `GET /v1/central/locations/hierarchy` endpoint'ini çağırır. Dönen JSON listesindeki `type = 'province'` olan tüm illeri (toplam 81 il) alfabetik olarak "İl" dropdown'una doldurur.
+2. **İlçe Dropdown (Bağımlı Tetikleyici):** Kullanıcı "İl" dropdown'undan bir şehir (örn: *İstanbul*, `id: "a2e564ad-43ab-41c1-90a1-24c568ad9cf1"`) seçtiği anda, "İlçe" dropdown'u aktifleşir ve sistem asenkron olarak `GET /v1/central/locations/hierarchy?parent_id=a2e564ad-43ab-41c1-90a1-24c568ad9cf1` isteğini fırlatır. Dönen sonuçtaki ilgili ilçeler (örn: *Kadıköy*, *Beşiktaş*) "İlçe" dropdown'una dinamik olarak bind edilir.
+3. Bu sayede, database seed (`turkey_locations_seed.sql`) verisiyle %100 uyumlu, tutarlı ve eksiksiz bir il/ilçe seçimi sağlanır.
+
+| Alan | Tür | Kural / Dinamik Veri Kaynağı |
+| :--- | :--- | :--- |
+| Belediye Adı | Metin | Zorunlu, benzersiz |
+| İl | Dropdown | Zorunlu (Central API Province listesinden beslenir) |
+| İlçe | Dropdown | Opsiyonel (Seçili İl'e bağlı District listesinden beslenir) |
+| Yetkili Kişi Adı | Metin | Zorunlu |
+| Yetkili E-posta | E-posta | Zorunlu; bu adrese `muni_admin` davet maili gönderilir |
+| Abonelik Başlangıç Tarihi | Tarih | Zorunlu |
+| Abonelik Bitiş Tarihi | Tarih | Zorunlu |
+
+
+Kayıt sonrası:
+1. Standart müdürlük şablonu otomatik oluşturulur (Fen İşleri, Temizlik İşleri, Park Bahçeler, Su Kanal, Zabıta)
+2. `muni_admin` kullanıcısı için davet maili gönderilir
+3. Belediyeye özgü API anahtarı oluşturulur
+
+**Belediye Silme Politikası:**
+- **Silme:** Belediyeler hiçbir koşulda veritabanından fiziksel olarak silinemez (yasal/tarihsel veri bütünlüğü ve denetim loglarının korunması sebebiyle).
+- **Pasif Etme (`status = 'passive'`):** Sadece [Pasif] toggle ile devre dışı bırakılabilirler. Pasife alındığında belediye sistemine tüm erişim durdurulur (7 günlük "salt-tamamlama" grace period sonunda).
+
+#### 3.2.1 Belediye Detay
+
+**URL:** `/municipalities/:id`  
+**Erişim:** `central_admin`
+
+**Sekmeler**
+
+| Sekme | İçerik |
+| :--- | :--- |
+| **Genel Bilgiler** | Düzenleme formu; Aktif/Pasif toggle |
+| **Abonelik** | Bitiş tarihi, yenileme geçmişi; [Tarihi Güncelle] butonu |
+| **İstatistikler** | Belediyeden gelen anonimleştirilmiş özet veriler (son 30 günlük trend) |
+| **Heartbeat** | Son 24 saatteki heartbeat kayıtları; kesinti anları kırmızı ile işaretli |
+| **API Anahtarları** | Mevcut anahtar (maskelenmiş); [Yenile] butonu (mevcut anahtarı geçersiz kılar; onay modal'ı gerektirir) |
+| **Denetim Logu** | Bu belediyeyle ilgili central düzeydeki işlem kayıtları |
+
+---
+
+### 3.3 Global Kategori Yönetimi
+
+**URL:** `/categories`  
+**Erişim:** `central_admin`
+
+**Liste**
+- Tüm global kategoriler: ad, risk skoru, varsayılan müdürlük türü, oluşturulma tarihi
+- Global kategoriler silinemez; yalnızca düzenlenebilir ve Aktif/Pasif yapılabilir
+- `central_moderator` bu sayfayı görebilir ama düzenleyemez
+
+**Kategori Formu**
+
+| Alan | Tür | Kural |
+| :--- | :--- | :--- |
+| Kategori Adı | Metin | Zorunlu, benzersiz, max 100 karakter |
+| Açıklama | Textarea | Opsiyonel, max 500 karakter |
+| Risk Skoru | Sayı 1–10 | Zorunlu |
+| Public Haritada Görünür mü? | Toggle | Aktif/Pasif (Kategori bazlı yasaklama seçeneği. Pasif yapıldığında kategori-level deny olarak işaretlenir ve bu kategoriye ait hiçbir iş emri belediyeden bağımsız olarak public haritada gösterilemez) |
+| Durum | Toggle | Aktif / Pasif |
+
+---
+
+### 3.4 Lokasyon Hiyerarşisi Yönetimi
+
+**URL:** `/locations`  
+**Erişim:** `central_admin`
+
+**Hiyerarşik Ağaç:** Bölge → Şehir → İlçe → Mahalle → Sokak
+
+**İşlemler**
+- Tekil kayıt ekleme / düzenleme / silme (alt kaydı olanlar silinemez)
+- Toplu içe aktarım: CSV yükleme; sütun formatı: `bolge, sehir, ilce, mahalle, sokak`; hatalı satırlar ayrı bir özet raporda listelenir
+- Dışa aktarım: Tüm hiyerarşiyi CSV olarak indir
+
+---
+
+### 3.5 Sistem Sağlığı İzleme
+
+**URL:** `/system-health`  
+**Erişim:** `central_admin`, `central_moderator`  
+**Not:** central_moderator sadece izleyebilir; heartbeat testi tetikleme veya alarm kapatma yapamaz.
+
+**Sayfa İçeriği & Düzen**
+
+1. **Merkezi SaaS Altyapı Sağlığı (Monitör Kartları):**
+   - **Central DB:** Durum (UP/DOWN) · Latency (ms) · Aktif Bağlantı Sayısı
+   - **Kuyruklar:** Durum (Sağlıklı) · PostgreSQL Panik Sinyali Kuyruk Derinliği (bekleyen işler)
+   - **Gateway API Sunucusu:** CPU Kullanımı (%) · Bellek Kullanımı (MB)
+
+2. **Dağıtık Belediye Backend Sunucu Sağlığı (Polling & Heartbeat Grid):**
+   - **Grid Kolonları:** Belediye Adı · Backend URL · Durum (`UP` / `DEGRADED` / `DOWN`) · Latency (ms) · DB Bağlantısı · pg_listener_active · Disk Doluluk Oranı (%) · Son Heartbeat Zamanı · Aksiyonlar (Heartbeat Testi Tetikle)
+   - **Görsel Kodlama:** 
+     - **Yeşil (UP):** Sunucu `/ready` polling testini başarıyla geçmiş, DB/pg_listener_active aktif, latency < 150ms.
+     - **Sarı (DEGRADED):** Polling testi başarılı fakat son 3 dakikada heartbeat gecikmiş VEYA DB/pg_listener_active servislerinden biri ulaşılamaz VEYA disk doluluk > %85 VEYA latency > 500ms.
+     - **Kırmızı (DOWN):** Polling testine 5 saniye boyunca yanıt yok VEYA son 3 dakikadır heartbeat kesik.
+   - **Heartbeat & Latency Geçmişi:** Satıra tıklandığında son 24 saatlik `/ready` ping gecikme ve ulaşılamazlık (Uptime) grafiklerini gösteren modal yan panel açılır.
+   - **Kritik Sunucu Uyarı Paneli:** Son 24 saatte "DOWN" durumuna düşen belediye sunucularını kesinti süreleriyle birlikte listeler.
+
+
+---
+
+### 3.6 Global Raporlar
+
+**URL:** `/reports`  
+**Erişim:** `central_admin`, `central_moderator`  
+**Not:** central_moderator sadece görüntüleyebilir ve dışa aktarabilir. Karşılaştırma raporlarında belediye bazlı filtre kullanabilir ancak hiçbir zaman bireysel iş emri veya vatandaş verisine inemez.
+
+**Sekmeler**
+
+| Sekme | İçerik |
+| :--- | :--- |
+| **Genel İstatistikler** | Tüm belediyelerden toplanan anonimleştirilmiş toplu veriler: kategori bazında iş emri dağılımı, bölgesel SLA uyum oranları, aylık trend grafiği |
+| **Bölgesel Sorun Haritası** | Türkiye haritası üzerinde il bazında iş emri yoğunluğu (ısı haritası) |
+| **Belediye Karşılaştırma** | SLA uyumu, ortalama çözüm süresi, vatandaş memnuniyeti gibi anonimleştirilmiş karşılaştırma tablosu |
+
+**Tarih Aralığı Seçici:** Son 30 Gün / Son 3 Ay / Son Yıl / Özel  
+**Dışa Aktar:** CSV veya JSON
+
+---
+
+### 3.7 Afet Modu
+
+**URL:** `/disaster-mode`  
+**Erişim:** Yalnızca `central_admin`
+
+**Sayfa Durumları**
+
+**A — Pasif Durum:**
+- Mevcut mod: "Normal"
+- [Afet Modunu Etkinleştir] butonu (kırmızı)
+
+**B — Etkinleştirme Akışı:**
+```
+[central_admin] → "Afet Modunu Etkinleştir" butonuna tıklar
+    ↓
+[Etkilenen Belediyeler Seçimi]
+  Tüm Belediyeler / Belirli İller / Belirli Belediyeler (çoklu seçim)
+    ↓
+[Açıklama Alanı] — max 500 karakter (zorunlu)
+    ↓
+[Onay Modal'ı]
+  "Bu işlem seçili belediyelerde vatandaş arayüzünde
+   Acil / Panik butonunu öne çıkaracaktır. Onaylıyor musunuz?"
+  Onay için admin şifre tekrar girişi istenir
+    ↓
+[Sistem] → Seçili belediyelere sinyal gönderilir
+           Vatandaş arayüzünde panik butonu öne çıkar
+           İşlem denetim loguna kaydedilir
+```
+
+**C — Aktif Durum:**
+- Etkin mod başlangıç zamanı ve açıklama gösterilir
+- Etkilenen belediyeler listesi
+- [Afet Modunu Sonlandır] butonu → onay modal'ı (şifre tekrar)
+
+---
+
+### 3.8 Kullanıcı ve Yetki Yönetimi
+
+**URL:** `/users`  
+**Erişim:** `central_admin`
+
+**Liste**
+- Central panel kullanıcıları: ad, e-posta, rol, durum, son giriş tarihi
+
+**Kullanıcı Oluşturma / Düzenleme**
+
+| Alan | Tür | Kural |
+| :--- | :--- | :--- |
+| Ad Soyad | Metin | Zorunlu |
+| E-posta | E-posta | Zorunlu, benzersiz |
+| Rol | Radio | central_admin / central_moderator |
+| Durum | Toggle | Aktif / Pasif |
+
+Oluşturmada davet maili gönderilir; kullanıcı ilk girişte şifre oluşturur.
+
+**Central Kullanıcı Silme Politikası:**
+- **Silme:** Central panel kullanıcıları (admin/moderatör) veritabanındaki denetim loglarının (audit log) geçmiş izlenebilirliği açısından fiziksel olarak silinemez.
+- **Pasif Etme (`status = 'passive'`):** Sadece durum toggle'ı kullanılarak pasif konuma getirilebilirler. Pasif yapılan kullanıcıların panele tüm erişimi anında kesilir.
+
+---
+
+### 3.9 Central Denetim Logları
+
+**URL:** `/audit-logs`  
+**Erişim:** `central_admin`
+
+**Açıklama:**
+Merkezi SaaS seviyesindeki sistem yöneticilerinin gerçekleştirdiği tüm global eylemlerin (`central_audit_logs` tablosu) izlendiği ekrandır.
+- Belediye ekleme, lisans askıya alma/grace period güncellemeleri, afet modu tetiklemeleri gibi tüm kritik eylemlerin listelenmesi.
+- **Visual JSONB Diff Viewer Panel Entegrasyonu:** Tıpkı belediye panelinde olduğu gibi, central log vizöründe de her satır için original ve new durumları (JSONB payload'ları) karşılaştırarak yeşil/kırmızı renk kodlarıyla diff olarak sunan yan panel mevcuttur. Örneğin bir belediyenin lisans tarihi uzatıldığında `payload_old.license_expires_at` ile `payload_new.license_expires_at` arasındaki fark görselleştirilerek sunulur.
+- Filtreler: Olay Tipi (Dropdown, çoklu) · Central Kullanıcı · Etkilenen Belediye · Tarih Aralığı
+- Sayfalama: Hızlı tarihsel tarama için offset bazlı pagination (`limit = 25`).
+- Silinemez, düzenlenemez; salt-okunurdur (Read-Only).
+- Dışa Aktar: CSV formatında dışa aktarma seçeneği mevcuttur.
+
+
+---
+
+### 3.10 Yönetici Sunum Raporları (Executive Presentation-Ready Reports)
+
+**URL:** `/admin/executive-reports`  
+**Erişim:** `central_admin`, `central_moderator`  
+**Amaç:** Merkez SaaS düzeyinde, tüm belediyelerin karşılaştırmalı performans, hacim ve vatandaş memnuniyet verilerini içeren sunuma hazır (Executive Presentation-Ready) şık grafiksel PDF ve Excel (XLSX) raporlarını oluşturmak ve dışa aktarmak.
+
+**Temel Özellikler:**
+- **Karşılaştırmalı Belediye Analizi (Benchmark):** Tüm aktif belediyelerin SLA uyum oranları, ortalama çözüm süreleri ve vatandaş memnuniyeti yıldız ortalamalarının yan yana karşılaştırıldığı dinamik pivot tabloları ve bar grafikleri.
+- **Global SLA Trendleri ve Isı Dağılımı:** Hangi kategorilerde (Fen İşleri, Zabıta, vb.) ülke genelinde SLA aşım eğilimi olduğunu gösteren trend çizgileri.
+- **SaaS Gelir ve Lisanslama Projeksiyonu:** Bütçe sunumları için lisans bitimine kalan süre, belediye büyüme oranları ve gelir özetleri.
+- **Vatandaş Katılımı & Memnuniyet Analitiği:** "+1 Beni de Etkiliyor" desteği ve vatandaş puanlamalarının karşılaştırmalı analizi.
+- **Sunum Dışa Aktarım Katmanı:** Tek tıkla meclis veya yönetim kurullarına sunulmaya uygun, modern kurumsal renk paletleriyle stilize edilmiş, KENTİM logolu, sayfa numaralı ve grafik nesneleri gömülü **Vektörel PDF Raporu** ve detaylı **Pivot Excel Tablosu** üretimi.
+- **Tenant Güvenlik İzolasyonu:** Raporlama motoru çalışırken ham işlemlere ve kişisel verilere (`citizen` tabloları, `work_orders` detayları) kesinlikle erişilmez. Her tenant'ın kendi izole şemasından periyodik asenkron ETL scheduler ile toplanan ve central analytical DB'ye yazılan **anonim agrege veriler** kullanılır. Cross-tenant leak riski tamamen sıfırlanmıştır.
+
+---
+
+### 3.11 Public Web Yol Haritası Yönetimi (Geliştirme Rehberi Seviyesi)
+
+**URL:** `/public-web-roadmap`  
+**Erişim:** Yalnızca `central_admin` (2FA önerilir)  
+**Amaç:** Vatandaş arayüzünde gösterilecek "Sistem Yol Haritası" içeriğini (MVP ve V1) merkezi, kontrollü ve denetlenebilir şekilde yönetmek.
+
+#### 1. Acceptance Criteria (Kabul Kriterleri)
+
+**AC-1: İçerik Düzenleme**
+- Central Admin, MVP ve V1 yol haritası içeriklerini ayrı sekmelerde düzenleyebilmelidir.
+- Her sürüm için Başlık, Alt Başlık, Markdown İçerik, Yayın Tarihi ve Aktif/Pasif durumu değiştirilebilir olmalıdır.
+- Değişiklikler anında sağ taraftaki Live Preview panelinde yansıtılmalıdır.
+
+**AC-2: Yayın Kontrolü**
+- Central Admin, bir sürümü (MVP veya V1) aktif/pasif yapabilmelidir.
+- Pasif yapılan sürüm vatandaş arayüzünde görünmemelidir.
+- En az bir sürüm aktif olmalıdır (sistem bunu zorunlu kılmalıdır).
+
+**AC-3: Önizleme**
+- Central Admin, değişiklikleri yayınlamadan önce tek kullanımlık önizleme linki üretebilmelidir.
+- Önizleme linki 24 saat geçerli olmalı ve sadece o adminin tarayıcısından erişilebilir olmalıdır.
+
+**AC-4: Denetim**
+- Tüm değişiklikler (içerik güncelleme, aktif/pasif değiştirme) `central_audit_logs` tablosuna yazılmalıdır (kim, ne zaman, ne değişti).
+
+#### 2. Business Rules (İş Kuralları)
+
+- Sadece `central_admin` rolü bu ekrana erişebilir ve değişiklik yapabilir.
+- `central_moderator` sadece görüntüleyebilir (salt-okunur).
+- Belediye paneli (hiçbir rol) bu içeriğe erişemez veya değiştiremez.
+- İçerik `central_static_contents` tablosunda şu key’lerle saklanır:
+  - `public_web_roadmap_mvp`
+  - `public_web_roadmap_v1`
+- Bir sürüm aktif hale getirildiğinde, diğer sürümün aktiflik durumu otomatik olarak değişmez (bağımsızdır).
+- Markdown içerik 20.000 karakteri geçemez.
+
+#### 3. Edge Cases & Error Handling
+
+| Senaryo | Sistem Davranışı | Kullanıcıya Gösterilen Mesaj |
+|---------|------------------|------------------------------|
+| Her iki sürüm de pasif bırakılmaya çalışılıyor | İşlem reddedilir | "En az bir sürüm aktif olmalıdır." |
+| 20.000 karakterden uzun içerik kaydediliyor | Kaydet butonu pasif veya hata | "İçerik 20.000 karakteri geçemez." |
+| Aynı anda iki admin aynı sürümü düzenliyor | İyimser kilitleme devreye girer | "Bu içerik başka bir kullanıcı tarafından güncellendi. Sayfayı yenileyin." |
+| Önizleme linki süresi doldu | Link 404 döner | "Önizleme linkinin süresi dolmuş." |
+
+#### 4. Validation Rules
+
+- Başlık: Min 5 - Max 120 karakter
+- Alt Başlık: Max 200 karakter
+- İçerik: Min 50 karakter (boş bırakılamaz)
+- Yayın Tarihi: Opsiyonel, girilirse geçmiş tarih olamaz
+
+#### 5. Non-Functional Requirements
+
+- Değişiklik sonrası Live Preview < 300ms içinde güncellenmelidir.
+- Kaydet işlemi < 2 saniye içinde tamamlanmalıdır.
+- Önizleme linki üretimi < 1 saniye sürmelidir.
+- İçerik Markdown render edilirken XSS koruması (sanitization) zorunludur.
+
+#### 6. Audit & Logging
+
+Her kaydetme işleminde şu bilgiler `central_audit_logs` tablosuna yazılır:
+- `central_user_id`
+- `event_type`: `PUBLIC_WEB_ROADMAP_UPDATED` veya `PUBLIC_WEB_ROADMAP_TOGGLED`
+- `payload_old` / `payload_new` (tam içerik snapshot)
+- `ip_address`, `user_agent`
+
+#### 7. Teknik Uygulama Notları
+
+- Mevcut `central_static_contents` tablosu kullanılacaktır.
+- Key’ler: `public_web_roadmap_mvp` ve `public_web_roadmap_v1`
+- Migration: Sadece INSERT ile yeni satırlar eklenir (schema değişikliği gerekmez).
+- Frontend: Live Preview için Markdown → HTML dönüşümü client-side yapılabilir (güvenlik için backend sanitization da zorunludur).
+
+---
+
+### 3.11 Statik İçerik Yönetimi
+
+**URL:** `/central/static-contents`  
+**Erişim:** `central_admin`  
+**Amaç:** Vatandaş arayüzünde gösterilen "Hakkımızda", "KVKK Metni", "Gizlilik Politikası" gibi statik sayfaların içeriklerini merkezi olarak düzenlemek.
+
+**Sayfa Yapısı**
+- Sol panelde yönetilebilir içeriklerin listesi (`about`, `faq`, `privacy`, `kvkk`, `terms`, `contact`).
+- Seçilen içeriğe tıklandığında sağ tarafta düzenleme formu açılır.
+
+**Düzenleme Formu**
+
+| Alan | Tür | Kural |
+| :--- | :--- | :--- |
+| Başlık (`title`) | Metin | Zorunlu, max 200 karakter. Tarayıcı sekmesinde ve sayfa başlığında kullanılır. |
+| İçerik (`content`) | Markdown / Zengin Metin Editörü | Zorunlu. İçeriğin gövdesini oluşturur. |
+
+- **[Kaydet]** butonu tıklandığında `PUT /v1/central/static-contents/:key` endpoint'i çağrılır.
+- Değişiklikler anında `GET /v1/public/static-contents/:key` endpoint'ine yansır.
+
+---
+
+## Özet: Sayfa ve İşlem Envanteri (MVP - Map-First + Modal Model)
+
+### Vatandaş Web
+Ana deneyim tek sayfada (`/`) toplanmıştır. Halka açık harita ana sayfadır. Tüm diğer vatandaş akışları **modal / slide-over drawer** olarak açılır.
+
+| # | Tür | Açıklama |
+| :--- | :--- | :--- |
+| 1 | Ana Sayfa | `/` — Tam public harita (serbest pan/zoom + dinamik yükleme) + floating aksiyonlar |
+| 2 | Rapor Oluşturma | Home haritası üzerinden açılan **modal** (3 adımlı) |
+| 3 | Rapor Takip | Home üzerinden açılan **modal** (takip kodu + sonuç drawer) |
+| 4 | Duyurular | Home üzerinden açılan **modal** (liste + detay) |
+| 5 | Fikir Önerileri | Home üzerinden açılan **modal** (liste, detay, oluşturma, oy) |
+| 6 | Geri Dönüşüm Haritası | Ana harita üzerine katman veya **modal** |
+| 7 | Dashboard | Giriş yapmış kullanıcı için **modal** (raporlarım, desteklerim, tercih) |
+| 8 | Profil & Ayarlar | **Modal** (bilgi güncelleme, şifre, hesap silme) |
+| 9 | Auth Akışları | Giriş, kayıt, OTP, şifre sıfırlama (modal veya sayfa) |
+| 10 | Panik / Acil | Home üzerinden her zaman erişilebilir **modal** |
+
+**Not:** Ayrı `/map`, `/report/new`, `/announcements`, `/ideas`, `/dashboard` gibi tam sayfalar kaldırılmıştır.
+
+### Belediye Paneli — **30** Sayfa / Görünüm
+| # | URL | Rol |
+| :--- | :--- | :--- |
+| 1 | `/login` | Tüm roller |
+| 2 | `/moderator/queue` | Moderatör, Admin |
+| 3 | `/moderator/reports/:id` | Moderatör, Admin |
+| 4 | `/moderator/work-orders/new` | Moderatör, Admin |
+| 5 | `/manager/work-orders` | Müdür, Admin |
+| 6 | `/manager/work-orders/:id` | Müdür, Admin |
+| 7 | `/manager/work-orders/new` | Müdür, Admin |
+| 8 | `/chief/work-orders` | Şef |
+| 9 | `/chief/work-orders/:id` | Şef |
+| 10 | `/chief/work-orders/new` | Şef |
+| 11 | `/chief/daily-plan` | Şef |
+| 12 | `/chief/team-stats` | Şef |
+| 13 | `/worker/tasks` | Personel |
+| 14 | `/worker/tasks/:id` | Personel |
+| 15 | `/admin/dashboard` | Admin |
+| 16 | `/admin/departments` | Admin |
+| 17 | `/admin/teams` | Admin |
+| 18 | `/admin/categories` | Admin |
+| 19 | `/admin/routing-rules` | Admin |
+| 20 | `/admin/schedule` | Admin, Müdür |
+| 21 | `/admin/integrations` | Admin |
+| 22 | `/admin/announcements` | Admin |
+| 23 | `/admin/ideas` | Admin |
+| 24 | `/admin/analytics` | Admin, Müdür, Şef |
+| 25 | `/admin/audit-logs` | Admin |
+| 26 | `/admin/gdpr` | Admin |
+| 27 | `/admin/settings` | Admin |
+| 28 | `/admin/crisis-map` | Admin |
+| 29 | `/admin/disputes` | Admin |
+| 30 | `/profile/security` | Tüm Roller |
+
+### Central Panel — 11 Sayfa
+| # | URL | Rol |
+| :--- | :--- | :--- |
+| 1 | `/login` | Tüm central roller |
+| 2 | `/dashboard` | Admin, Moderatör |
+| 3 | `/municipalities` + `/:id` | Admin |
+| 4 | `/categories` | Admin, Moderatör (salt-okunur) |
+| 5 | `/locations` | Admin |
+| 6 | `/system-health` | Admin, Moderatör |
+| 7 | `/reports` | Admin, Moderatör |
+| 8 | `/disaster-mode` | Admin |
+| 9 | `/users` | Admin |
+| 10 | `/audit-logs` | Admin |
+| 11 | `/central/static-contents` | Admin |
+
+---
+
+## EK - Public Harita ve Modal Deneyimi (MVP)
+
+### Ana Sayfa (`/`) — Public Harita (Map-First)
+- **URL:** `/` (tek ana deneyim)
+- **Erişim:** Herkese açık (anonim okuma). +1 desteği için JWT zorunlu.
+- **Bileşenler:** Tam ekran / baskın Leaflet haritası + floating aksiyon butonları. Tüm vatandaş akışları (rapor, takip, duyuru, fikir vb.) harita üzerinde **modal / drawer** olarak açılır.
+- **Davranış:** Vatandaş harita üzerinde tamamen serbestçe gezinebilir. BBOX + zoom seviyesine göre dinamik veri yüklenir.
+
+### Admin Dashboard Widget'ları (Belediye Paneli)
+- **Public Map Sağlık Kartı:** Toplam public görünür iş/adet, son 24 saat destek oyları, cache hit/miss oranı.
+- **En Çok Destek Alan 10 İş:** Sol panelde listelenir.
+- **Moderasyon Bekleyen Public Özet**
+
+### Analytics ve Destek Metrikleri
+- `support_votes` zaman serisi
+- Modal açılış metrikleri (hangi modal ne kadar kullanılıyor)
+- Destek → Çözüm korelasyonu
+
+### Denetim Olayları
+- `PUBLIC_VISIBILITY_CHANGED`, `SUPPORT_VOTE_ADDED/REMOVED` (aynı)
+
+### Public Harita Pasif Fallback
+- Belediye public haritayı kapatmışsa, ana sayfa (`/`) üzerinde graceful mesaj gösterilir. "Rapor oluşturmak için harita üzerinden 'Yeni Rapor' butonunu kullanın."
+
+### Hesap Silme Uyarısı (MVP)
+- Hesap silme modalında +1 destek oyları ve `support_count` güncellemesi hakkında açık uyarı.
+
+## BÖLÜM 4: Sistem Performansı ve Servis Kalitesi (QoS)
+
+Sistemin operasyonel hızı ve kullanıcı deneyimi için aşağıdaki teknik hedefler (KPI) belirlenmiştir:
+
+| Metrik | Hedef Değer | Açıklama |
+| :--- | :--- | :--- |
+| **API Yanıt Süresi** | < 200ms (P95) | Liste ve detay sayfaları için sunucu yanıt hızı. |
+| **Görsel Yükleme** | < 2s | 5MB fotoğrafın optimize edilip CDN'e basılma süresi. |
+| **Harita Render** | < 1s | 100+ pin içeren haritanın etkileşime hazır olma süresi. |
+| **Eşzamanlı Kullanıcı** | 10.000+ | Belediye başına beklenen anlık aktif vatandaş trafiği. |
+| **Sistem uptime** | %99.9 | Yıllık kesintisiz çalışma oranı. |
+
+---
+
+## BÖLÜM 5: Çok Belediyeli Bağımsız IoT ve Donanım Entegrasyon API Standartları
+
+KENTİM platformu, her belediyenin kendi yerel donanımlarını (farklı marka/model akıllı çöp sensörleri, akıllı geri dönüşüm kutuları vb.) sisteme esnek ve izole şekilde entegre edebilmesi için **Self-Service Payload Mapping** mimarisine sahiptir. 
+
+### Ortak Telemetri API Uç Noktası (Telemetry API Endpoint)
+
+*   **Metot:** `POST`
+*   **Adres:** `https://api.kentim.com.tr/v1/integrations/iot/telemetry`
+*   **Headers:**
+    ```http
+    Authorization: Bearer <API_KEY>
+    x-idempotency-key: <UUIDv4>
+    Content-Type: application/json
+    ```
+
+> [!NOTE]
+> Gelen istekte bulunan `Authorization` başlığındaki `API_KEY` bilgisi, Central SaaS Gateway tarafından çözülerek ilgili belediyenin `tenant_id` değeri ile eşleştirilir. Bu sayede tüm veriler RLS katmanında tamamen izole edilir.
+
+---
+
+### Dinamik Alan Eşleştirme (Payload Mapping & Parser)
+
+Her belediye, kendi panelindeki `/admin/integrations` sekmesinden gelen cihaz verilerini KENTİM standart formatına dönüştürecek kuralları tanımlar.
+
+#### Örnek A: Basit Alan Eşleştirme (GUI Mapping)
+Belediyenin kullandığı sensör doluluk oranını `"status.capacity"` olarak, cihaz seri numarasını da `"uuid"` olarak yolluyorsa, admin panelden yapılan eşleştirme şöyledir:
+*   `device_id` ➔ `uuid`
+*   `fill_level_percentage` ➔ `status.capacity * 100`
+
+#### Örnek B: Gelişmiş JavaScript Sandbox Parser (Custom Script Parser)
+Eğer cihaz verisi ham voltaj, mesafe veya karmaşık formatlar içeriyorsa, belediye admini sisteme güvenli JavaScript parser kodu girer. Sunucu tarafında bu betik V8 sandbox içinde izole olarak çalıştırılır:
+
+```javascript
+/**
+ * Ham IoT telemetri verisini standart KENTİM formatına dönüştürür.
+ * @param {Object} rawPayload - Cihazdan gelen ham JSON verisi
+ * @returns {Object} Standart KENTİM IoT şeması
+ */
+function parse(rawPayload) {
+    // Örnek: Cihaz çöp kutusunun üst kapağı ile atık arasındaki mesafeyi mm olarak yolluyor (toplam yükseklik 1200mm)
+    const maxDistance = 1200; // mm
+    const currentDistance = rawPayload.sensor_reading.distance_mm;
+    
+    // Doluluk yüzdesini hesaplama
+    let fillRatio = ((maxDistance - currentDistance) / maxDistance) * 100;
+    fillRatio = Math.max(0, Math.min(100, Math.round(fillRatio))); // 0-100 arasına sınırla
+
+    return {
+        device_id: rawPayload.device_metadata.serial_no,
+        device_type: "smart_waste_bin",
+        waste_type: rawPayload.device_metadata.waste_category === "PET" ? "plastic" : "general_waste",
+        fill_level_percentage: fillRatio,
+        battery_level_percentage: Math.round((rawPayload.sensor_reading.battery_mv - 2000) / 12), // mV'tan yüzdeye çevirme
+        status: rawPayload.sensor_reading.distance_mm < 50 ? "faulty" : "active", // Tıkanma durumu
+        coordinates: {
+            latitude: rawPayload.gps.lat,
+            longitude: rawPayload.gps.lng
+        }
+    };
+}
+```
+
+---
+
+### Standart KENTİM IoT Veri Şeması (Target Internal Schema)
+Dinamik dönüştürücüden çıktıktan sonra veritabanına ve iş emri durum makinesine gönderilen standardize edilmiş nihai JSON şeması:
+
+```json
+{
+  "device_id": "9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d",
+  "device_type": "smart_waste_bin",
+  "waste_type": "plastic",
+  "tenant_id": "muni_a",
+  "fill_level_percentage": 89,
+  "battery_level_percentage": 94,
+  "status": "active",
+  "coordinates": {
+    "latitude": 41.0082,
+    "longitude": 28.9784
+  },
+  "timestamp": "2026-05-20T18:48:00Z"
+}
+```
+
+---
+
+### HTTP Durum Kodları ve Hata Yönetimi
+
+| Hata / Yanıt | HTTP Kodu | Açıklama |
+| :--- | :--- | :--- |
+| **Success (Yeni İş Emri)** | `201 Created` | Doluluk eşiği (%85) aşıldı veya arıza tespit edildi; otomatik olarak **Temizlik İşleri** veya **Sıfır Atık** müdürlüğüne `dispatched_to_department` durumunda yeni iş emri oluşturuldu. |
+| **Success (Aksiyon Yok)** | `200 OK` | Telemetri verisi başarıyla kaydedildi. Eşik aşılmadığı için yeni iş emri oluşturulmadı VEYA o cihaz için zaten açık, kapatılmamış aktif bir iş emri mevcut (Mükerrerlik koruması devrede). |
+| **Bad Request (Sınır Dışı)** | `400 Bad Request` | Gönderilen koordinatlar belediyenin PostGIS sınır poligonu (`boundaries`) dışında kaldı. İstek `integration_logs` tablosuna `FAILED` olarak kaydedilir. |
+| **Unauthorized** | `401 Unauthorized` | API anahtarı geçersiz veya iptal edilmiş. |
+| **Forbidden (Askı Modu)** | `403 Forbidden` | Belediye aboneliği pasife alınmış ve 7 günlük "salt-tamamlama" (grace period) süresi de dolmuş. Telemetri verisi kabul edilmez. |
+| **Parser Error** | `422 Unprocessable Entity` | Belediyenin tanımladığı Custom Parser Script hata verdi veya JSON alan eşleştirmeleri gelen gövdeyle uyuşmadı. |
+
+---
+
+*MVP Sürümü — KENTİM Sayfa Yapısı ve İşlemler Belgesi*  
+*Birlikte okunacak belge: proje.md*
+
+---
+
+## Arayüz Standartları, Mobil Jestleri, WCAG Erişilebilirlik ve Analitik Şemaları (Eksikler Giderildi)
+
+Bu bölüm, KENTİM vatandaş ve belediye paneli arayüzlerinin mobil cihazlarda, erişilebilirlik standartlarında ve analitik izleme katmanında sorunsuz çalışması için uyulması zorunlu olan kesin kuralları tanımlar:
+
+### 1. Mobil Jest ve Çekmece (Drawer / Bottom Sheet) Çakışma Yönetimi
+
+Mobil tarayıcılarda ve webviews üzerinde tam ekran harita ile bottom sheet çekmecesinin hareket çakışmalarını sıfıra indirmek için şu kurallar zorunludur:
+- **Harita Etkileşim Kilidi (Map Interaction Lock):**
+  - İstemcide drawer'ın sürüklenmeye başlandığı an (`touchstart` / `mousedown`) harita nesnesinin (Leaflet/Mapbox) `dragging.disable()`, `touchZoom.disable()` ve `doubleClickZoom.disable()` metotları tetiklenerek harita tamamen pasifleştirilir.
+  - Sürükleme bittiğinde (`touchend` / `mouseup`) harita etkileşimleri yeniden aktifleşir.
+- **Snap-Points Sınırları ve Davranışları:**
+  - **Aşama 1 (Yükseklik %10 - Collapsed):** Yalnızca başlık, takip kodu ve durum rozeti görünür. Haritada serbest gezinti yapılabilir.
+  - **Aşama 2 (Yükseklik %50 - Preview):** Rapor açıklaması, kategori ve en fazla 2 fotoğraf önizlemesi yüklenir. Bottom sheet'e odaklanıldığında haritadaki ilgili pin otomatik olarak ekranın üst %25'lik kısmına kaydırılarak (offset) görünür tutulur.
+  - **Aşama 3 (Yükseklik %95 - Expanded):** Tüm zaman çizelgesi, geri bildirim formları ve yorumlar yüklenir. Arka plan tamamen donuklaşır (dim backdrop) ve harita tıklamaları bloke edilir.
+- **Dikey Kaydırma Yakalama (Scroll Capture Pipeline):**
+  - Çekmece `%95` yüksekliğe ulaşana kadar CSS `touch-action: pan-y` kısıtlamasıyla çekmecenin kendi iç kaydırması kilitli kalır, her dikey hareket çekmeceyi büyütmeye yönlendirilir.
+  - Çekmece en tepeye ulaştığında (`translateY` sıfıra eşitlendiğinde), çekmece gövdesinin iç kaydırması (`overflow-y: scroll`) aktifleşir.
+
+### 2. WCAG AA/AAA Erişilebilirlik ve Odak Yönetimi (Focus Trap)
+
+KENTİM platformunun engelli vatandaşlar ve ekran okuyucu kullanan bireyler için uyumlu olması yasal bir zorunluluktur (WCAG 2.1 standardı):
+- **Focus Trap (Odak Kilidi) Algoritması:**
+  - Herhangi bir modal veya drawer açıldığında, odak (`focus`) modal içindeki ilk etkileşimli elemana (örn. kapatma butonu veya ilk input) taşınır.
+  - Kullanıcı `Tab` tuşuna bastığında, odak modal içindeki elemanlar arasında döner. Eğer odaktaki eleman modalın son elemanıysa ve kullanıcı tekrar `Tab` yaparsa, odak modalın başına döner (`Shift + Tab` için tersi geçerlidir).
+- **Klavye Navigasyonu:**
+  - `Esc` tuşuna basıldığında aktif modal/drawer anında kapanır, URL query param'ı (`/` haline) temizlenir ve odak modalı tetikleyen butona geri döner.
+  - Harita üzerindeki pinler `tabindex="0"` özniteliğine sahiptir. Kullanıcı haritada klavyeyle gezinirken ok tuşlarıyla pinleri seçebilir ve `Enter` ile modal detay penceresini açabilir.
+- **WAI-ARIA Yapısı:**
+  - Tüm modal pencereleri `role="dialog"` ve `aria-modal="true"` özniteliklerini içermelidir.
+  - Kapatma butonlarında `aria-label="Kapat"` etiketi bulunmalıdır.
+  - Harita pinleri ekran okuyucular tarafından okunurken `"Pin [Takip Kodu], Kategori: [Kategori Name], Durum: [Durum Name]"` şeklinde seslendirilir.
+
+### 3. Analitik (Analytics) Standart Event Şeması
+
+KENTİM vatandaş web uygulamasındaki tüm modal açılışları ve kullanıcı etkileşimleri, tarayıcı history'sini kirletmeden aşağıdaki standartlaştırılmış veri şemasıyla ölçümleme sunucusuna push edilir:
+
+#### A. Modal Açılış Event'i (`modal_open`)
+```json
+{
+  "event": "modal_open",
+  "timestamp": "2026-05-26T20:15:00Z",
+  "payload": {
+    "modal_type": "report-new | track | announcement | idea | profile | about | faq | privacy | kvkk",
+    "tracking_code": "KENT-34-ABC12345", // yalnızca track ise, aksi halde null
+    "source": "header_button | map_pin_click | footer_link | direct_link"
+  }
+}
+```
+
+#### B. Rapor Başarı Gönderim Event'i (`report_submit_success`)
+```json
+{
+  "event": "report_submit_success",
+  "timestamp": "2026-05-26T20:15:00Z",
+  "payload": {
+    "category_id": "uuid",
+    "is_anonymous": true,
+    "has_photo": true,
+    "geofence_distance_m": 12.4
+  }
+}
+```
+
+#### C. Fikir Oy Verme Event'i (`idea_vote_submitted`)
+```json
+{
+  "event": "idea_vote_submitted",
+  "timestamp": "2026-05-26T20:15:00Z",
+  "payload": {
+    "idea_id": "uuid",
+    "direction": 1 // 1: +1 desteği, -1: olumsuz destek
+  }
+}
+```
+
+#### Ek Event'ler
+- `duplicate_check_triggered`: Harita üzerinde konum seçildiğinde mükerrer kontrol tetiklendiğinde
+- `qa_loop_triggered`: Vatandaş 1-2 yıldız verdiğinde QA kuyruğuna düşme olayı tetiklendiğinde
+
+**Sonuç:** Bu sayfa yapısı, operasyonel işlemler ve görsel standartlar KENTİM platformunun tüm bileşenlerinde tam performansla çalışmaktadır. Bilinen hiçbir eksiklik bulunmamaktadır.