📘 Akıllı Çamaşırhane

1. Sisteme Genel Bakış

Akıllı Çamaşırhane, yurtlardaki çamaşır ve kurutma makinelerinin 7/24 canlı izlenmesini sağlayan, Firebase tabanlı bir otomasyon platformudur. Öğrenciler boş makine bulabilir, sıraya girebilir ve makine bittiğinde anında bildirim alabilir. Yöneticiler uzaktan müdahale edebilir, enerji tüketimini takip edebilir ve teknik arızaları önceden tespit edebilir. Sistem Frontend 2.73w, Cloud Functions 2.73r (Gen2, Node 22, 59 fonksiyon, FAZ 1+2+3+4 KAPANDI modüler refactor -%35.9) ve FSM v10/gen3.1 ile çalışmaktadır. Sahada 15 makine aktif (M#1-15, M#16 sonra eklenecek; 8+7 split: M#1-8 Çavuş #1, M#9-15 Çavuş #2). Donanım: Hub v56.1 + 2 Çavuş v30.5.1 RELAY-ONLY + 15 İşçi v21.4.

2. İlk Adımlar

1. Siteye giriş yapın. Makine kartları otomatik olarak yüklenecek, yüklenene kadar iskelet (skeleton) kartlar gösterilecektir.
2. Bildirim almak, sıraya girmek veya teslim işlemleri için sağ üstteki Giriş Yap butonundan Google hesabınızla oturum açın.
3. İlk kez giren öğrencilere kısa bir tanıtım turu gösterilir (makine kartları, filtreleme, boş makine bildirimi, sıra kartı). İsterseniz "Atla" diyerek geçebilirsiniz.
4. Giriş yaptıktan sonra sağ üstte Öğrenci modunda olduğunuzdan emin olun. Yönetici iseniz Yönetici butonu ile admin paneline geçebilirsiniz.

3. Öğrenci Kılavuzu

3.1 Makine Durumlarını Anlama

Her makine bir kart ile gösterilir. Kartın sol paneli makine numarasını ve tipini (çamaşır/kurutma) büyük puntolarla gösterir; sağ panel durum bandı, akım değeri, tahmini kalan süre ve ilerleme çubuğunu içerir. Renkler şunları ifade eder:

Çalışan makinelerde ilerleme çubuğu (shimmer efekti ile) ve tahmini kalan süre dinamik olarak güncellenir. Kartın üzerine tıklayarak detaylı modal penceresini açabilirsiniz.

3.2 Yoğunluk Barometresi ve Günün Pulsu

Sayfanın üst kısmındaki barometre, anlık doluluk oranını gösterir: Sakin (yeşil) → Orta (sarı) → Yoğun (turuncu) → Çok Yoğun (kırmızı). İlerleme çubuğunun ucundaki ibre mevcut seviyeyi işaret eder. Altındaki "Günün Pulsu" bölümünde bugünkü toplam döngü sayısı, tüketilen kWh, en yoğun kullanılan makine (lider) ve zirve saat bilgisi yer alır.

3.3 Yoğunluk Tahmini Widget'ı YENİ

Makine kartlarının hemen üstünde 📊 Yoğunluk Tahmini kartı bulunur. Bu kart, şu anki saat ve sonraki 3 saat için çamaşır ve kurutma makinelerinin tahmini yoğunluk durumunu (Sakin / Orta / Yoğun) gösterir. Tahminler, son 14 günün aynı saatlerindeki döngü başlangıç verilerine dayanır. Veri henüz toplanmamışsa kart gizli kalır.

3.4 Filtreleme ve Görünüm

• Durum Filtresi: Tümü, Boş, Çalışıyor, Bitti, Bakım butonlarıyla makineleri filtreleyin. Her butonun yanında o durumdaki makine sayısı gösterilir.
• Tip Filtresi: Tümü, Çamaşır veya Kurutma makinelerini listeleyin.
• Kompakt Görünüm: Filtre çubuğunun sağındaki liste/kart butonuyla kartları küçülterek tek ekranda daha fazla makine görebilirsiniz. Bu modda yalnızca kritik bilgiler (makine numarası, kalan süre, teslim butonu) gösterilir; durum rengi küçük bir nokta ile belirtilir. Alt kısımda renklerin ne anlama geldiğini gösteren bir lejant belirir.

3.5 Kalan Süre Tahmini ve "Uzadı" Uyarısı

Çalışan makineler için kalan süre tahmini; seçilen programa, geçmiş döngü sürelerine ve yurt ortalamasına göre hesaplanır. Eğer makine seçilen program süresini aşarsa kart üzerinde "⚠️ Uzadı" uyarısı belirir. Bu, program seçilmiş makineler için gerçek bir alarmdır; program seçilmemişse tahmin aşımı "+X dk" olarak gösterilir. Kalan süre 10 dakikanın altına düştüğünde yazı kırmızı renkte yanıp sönmeye başlar.

3.6 Sıraya Girme ve Bildirim Alma

1. Çalışan (kırmızı) bir makine kartına tıklayın.
2. Açılan pencerede 🔔 Sıraya Gir butonuna basın. (Eğer o tipte hiç çalışan makine yoksa sistem sizi uyarır, sıraya gerek olmadığını belirtir.)
3. Sıra numaranız ekranın alt kısmındaki "Sıra Kartım" çubuğunda gösterilir. Çubukta sıra numaranız, tahmini bekleme süreniz ve sıradan çıkma butonu bulunur.
4. Makine boşaldığında tarayıcı bildirimi, sesli uyarı (üç notalı melodi) ve sekme başlığı yanıp sönmesi ("🔔 SIRA SENDE") ile bilgilendirilirsiniz.
5. Sıra kartındaki "✕ Kapat" butonu kartı yalnızca o oturum için gizler; sayfayı yenilerseniz veya makine tekrar aktif hale gelirse kart yeniden görünür.

Not: iOS cihazlarda push bildirimleri yalnızca ana ekrana eklenmiş PWA üzerinden çalışır (iOS 16.4+).

3.7 "Yoldayım, Geliyorum" ve Teslim Alma

Makine bittiğinde (sarı kart) detay penceresinden:

• 🚶 Yoldayım, Geliyorum: Makineyi 10 dakika sizin için rezerve eder, ekranda geri sayım başlatır (10:00 → 00:00). Bu süre içinde teslim almanız beklenir. (5 Mayıs güncellemesiyle, bu işlem artık kullanıcı kimliği (uid) ile güvence altına alınmıştır.)
• ✅ Teslim Aldım: Çamaşırınızı aldıktan sonra bu butona basarak makineyi boş duruma getirir ve bir sonraki sıradaki kişiye bildirim gönderir. Buton tıklandığında yeşil bir onay animasyonu gösterilir.

3.8 Program Seçme

Çalışan bir makinenin detay penceresinde, makineyi çalıştıran kişiyseniz ilk 30 dakika içinde bir program seçebilirsiniz. Bu, kalan süre tahmininin daha doğru olmasını sağlar. Seçim yapmak için:

1. Makine detay penceresindeki açılır menüden programı seçin.
2. Açılan onay dialogunda "Onayla" butonuna tıklayın.
3. Program etiketi makine kartında ve modal pencerede gösterilir.

Seçimi kaldırmak için "Bilmiyorum / Seçmek istemiyorum" seçeneğini seçip onaylayabilirsiniz.

3.9 Boş Makine Bildirimi

Sayfanın üst kısmındaki yeşil banner'da 🧺 Çamaşır veya 🌀 Kurutma butonlarına tıklayarak, o tipte herhangi bir makine boşaldığında anında bildirim alabilirsiniz. Bu özellik tüm makineler doluyken sıra beklemek istemeyenler için idealdir. Abone olduğunuzda buton "✅ Bekliyor — iptal" olarak değişir; tekrar tıklayarak abonelikten çıkabilirsiniz.

3.10 "Bitince Bildirim Al" (Takip Etme)

Sahip olduğunuz makine dışında, başka bir makineyi de takip edebilirsiniz. Makine detay penceresindeki 🔔 Bitince Bildirim Al butonu ile o makine bittiğinde size özel bildirim gönderilir. Takibi bırakmak için aynı buton "✓ Bildirim Aktif — Vazgeç" olarak değişir.

3.11 Arıza Bildirme

Bir makinede sorun tespit ederseniz (su almıyor, kapak kırık, anormal ses vb.), detay penceresindeki 🛠 Arıza Bildir butonuna tıklayın. Açılan listeden arıza tipini seçebilir (Kapak/cam kırık, Su almıyor/sızdırıyor, Kapak kilitli kaldı, Elektrik gelmiyor, Anormal ses/titreşim, Kötü koku/kirli, Düğme/panel sorunu, Diğer) veya serbest açıklama yazabilirsiniz. 1 saat içinde 3 farklı kullanıcı aynı makineyi şikayet ederse sistem otomatik olarak makineyi bakıma alır ve yöneticilere WhatsApp bildirimi gönderir.

3.12 Öneri / Geri Bildirim Gönderme YENİ

Sayfanın alt kısmındaki 💡 Öneri / Geri Bildirim bölümünden sistem hakkındaki düşüncelerinizi, hata bildirimlerinizi ve yeni özellik önerilerinizi doğrudan yöneticiye iletebilirsiniz. Konu seçebilir (Genel, Yeni Özellik Önerisi, Sorun/Hata Bildirimi, Diğer) ve 500 karaktere kadar mesaj yazabilirsiniz. Giriş yapmış olmanız zorunludur; spam koruması için 30 dakikada en fazla 3 öneri gönderebilirsiniz.

3.13 HALT Modu Bilgilendirme YENİ

Sistem yönetici tarafından geçici olarak duraklatıldığında, sayfanın üstünde sarı bir bilgi banner'ı görünür: "⏸ Sistem geçici olarak duraklatıldı. Yetkili kontrol ediyor — kısa süre içinde aktif olacak." Bu durumda makine kartları "Bakımda" rozetiyle gösterilir; gerçek durum alt bilgide yazmaya devam eder. Teslim alma ve sıraya girme butonları gizlenir.

3.14 📊 Durumum Modal'ı YENİ

Login yapmış öğrenciler için sağ üstteki kullanıcı menüsünden 📊 Durumum seçeneği açılır. Modal içinde son cycle özetiniz, aktif şikayetiniz varsa durumu, ay içindeki yıkama sayınız ve yurt karşılaştırması (sizin %X — yurt ortalaması %Y) gösterilir. Hızlı bakış için profil sayfasına alternatiftir.

3.15 Profil Sayfası v2 YENİ

Sağ üst menüden "Profilim" ile her zaman erişilebilir. Profil 5 bölümden oluşur:

• Hero kartı: Profil fotoğrafı, isim, rol, kayıt tarihi.
• 4-stat şerit: Bu ay yıkama sayısı, toplam dakika, ortalama süre, en sevdiği makine.
• GitHub-style Heat grid: Son 12 hafta günlük yıkama sıklığı (4 ton renk).
• Timeline: Günlük gruplu cycle + şikayet listesi (CMR/KRT ikonları, status rozetleri).
• Karşılaştırma paneli: Program dağılımı + yurt karşılaştırma + favori makine.

3.16 Şikayetlerim ve Cevap Sistemi YENİ

Profil sayfasında Heat grid ile Timeline arasında "Şikayetlerim" bölümü bulunur. Açık + son 20 çözülmüş şikayet listelenir; admin cevap yazdığında yeşil sol-bordürlü cevap balonu görünür. Şikayet "Çözüldü" işaretlendiğinde sol-bordür yeşile döner. Ayrıca admin tarafında "📦 Arşivle" butonu ile çözülmüş şikayetler operasyon listesinden çıkarılır ama profil sayfasında görünür kalır (kayıt amaçlı).

3.17 Klavye Kısayolları

4. Yönetici Kılavuzu

4.1 Yetki Seviyeleri

Rol	Yetkiler
Memur	Makine boşaltma, bakıma alma, sıra temizleme. Canlı ve Operasyon sekmelerini görüntüleyebilir.
Teknik	Tüm ayarlar (konfigürasyon, eşik override), enerji raporları, kullanıcı yönetimi, hub/cavuş reset, cihaz (ESP32) yönetimi, QR kod, teknik analiz, Telegram bildirim kategori filtresi, program yönetimi, bakım takvimi işaretleme.
Super Admin	Sistem genelinde tam yetki. Yeni yurt ekleme (çoklu yurt desteği), bütçe kill switch yönetimi, Telegram Bot token yönetimi. Super admin e-postaları hardcoded whitelist ile tanımlanır.
Geliştirici	Super Admin + Sistem sekmesi (donanım sürümleri, savunma katmanları, Telegram tanı, Kill Switch), Admin Aksiyonları Audit log, tehlikeli bölge işlemleri. Üretim sisteminde tanı ve derin müdahale için kullanılır.

Yetkili e-posta ile giriş yaptıktan sonra sağ üstte beliren Yönetici butonuna tıklayarak admin paneline geçiş yapabilirsiniz. Mobil cihazlarda alt kısımda gezinme çubuğu otomatik olarak görünür; masaüstünde üstteki sekmeler kullanılır.

4.2 Admin Panel Sekmeleri

• 📋 Canlı: Hızlı müdahale ekranı. Makine kartları (admin kompakt görünümü), "Tüm Bitmişleri Boşalt" butonu, sorunlu makineler filtresi, öncelik motoru (Şimdi Müdahale Et / Yakında Dikkat Et), son olaylar listesi ve Çamaşırhane Sağlık Skoru kartı YENİ (0–100 skor bandı + müdahale gerekenler listesi). Her makine kartında Boşalt/Teslim Al, Bakıma Al, Bakımdan Çıkar butonları bulunur.
• 📊 Operasyon: Üç alt sekme — Özet (KPI'lar: Boş/Çalışıyor/Bitti/Bugün Döngü, makine sağlık özeti, en çok kullanılan makineler, wear leveling önerisi, 7 günlük ısı haritası, haftalık yoğunluk haritası, 24 saatlik olay özeti, Bakım Takvimi YENİ), Enerji (30 günlük tüketim, bugünkü tüketim, makine bazlı maliyet, son 14 gün sparkline grafiği), Teknik (teknik personel için: makine bazlı trace özeti, son döngü metrikleri, olay timeline).
• ⚙️ Kontrol: Sistem ayarları — otomatik boşaltma süresi, elektrik birim fiyatı (TL/kWh, son güncelleme tarihi ile), kopma eşiği, çamaşır/kurutma akım eşikleri, ortalama süreler, Telegram bildirim master toggle ve kategori filtresi YENİ, tatil modu toggle, eşik uyarıları listesi, gece parazit kalibratörü durumu, Tanı Merkezi (Doktor raporları: SIK_KOPTU, UZUN_DUSUK_AKIM, FLAP_ISITICI, SENSOR_YOK, KULLANILMIYOR, SESSIZ_ARIZA, CYCLE_DRIFT, SENSOR_FANTOM, SENSOR_DEAD_ZERO YENİ, SAGLIK_DUSUK YENİ), açık şikayet listesi (Çözüldü butonu ile), ve Program Süreleri Yönetimi.
• 📊 Raporlar: YENİ CSV İndir (tarih aralığı seçimi ile), Teknik Rapor (grafikler ve detaylı analiz), Haftalık Rapor Paylaş (Telegram'a gönder).
• 📥 Öneriler: YENİ Öğrencilerden gelen geri bildirimlerin listesi. Durum değiştirme (Yeni → Okundu → Cevaplandı), e‑posta ile cevaplama ve silme butonları.
• 👥 Yetki: (Teknik ve Super Admin) Yeni memur/teknik personel ekleme, silme. Eklenen kullanıcı giriş yaptığında otomatik olarak ilgili yetkilere sahip olur.
• 📡 Cihazlar: (Teknik ve Super Admin) Çavuş & Hub sağlığı (son ping, bağlı işçi sayısı, ort. veri gecikmesi, en zayıf RSSI, paket kaybı, son reset), işçi sağlık özeti (her makine için FSM state, akım, MAC, RSSI, reset butonu, sağlık halkası skoru YENİ, manuel eşik override), kayıtlı cihaz listesi (MAC doğrulama, çevrimiçi/çevrimdışı, silme), kayıtsız cihaz raporları, son bakım geçmişi, İşçi Reset Geçmişi YENİ, Kayıp Döngü Adayları YENİ, PWA banner tanı aracı, sistem sürümleri ve audit log kartı.
• 🔲 QR: QR poster üretici. Makine listesi oluşturup A4'e 4 poster basabilirsiniz.
• 🔧 Sistem: YENİ Geliştirici Cihaz sürümleri (Hub/Çavuş/İşçi firmware), savunma katmanlarının canlı durumu (Kill Switch, bildirim devre kesici), Telegram bildirim tanı (test butonu + son gönderim tracker), Admin Aksiyonları Audit log (son 15 aksiyon, performer, durum ikonu). Üretim tanısı ve derin müdahale için.

4.3 Sağ Detay Çekmecesi v179

Admin modda herhangi bir makine kartına tıkladığınızda, ekranın sağından bir hızlı müdahale çekmecesi açılır. Bu çekmecede makine detayları (akım, son güncelleme, maks akım, program), hızlı aksiyon butonları (Boşalt, Bakıma Al, Bakımdan Çıkar), detaylı görüntüleme butonu ve son döngüler listesi bulunur. Çekmece dışına tıklayarak veya "✕" butonuyla kapatabilirsiniz.

4.4 Makine Sağlık Özeti v195

Operasyon → Özet sekmesinde, her makine için son 24 saatteki koptu sayısı, hub timeout, otomatik bakım ve öğrenci şikayetleri rozetlerle gösterilir. Rozetler yeşil (temiz), sarı (dikkat) veya kırmızı (kritik) olabilir. Son koptu zamanı da gösterilir.

4.5 Öncelik Motoru

Canlı sekmesindeki öncelik motoru, acil müdahale edilmesi gereken makineleri iki kategoriye ayırır:

• 🚨 Şimdi Müdahale Et: Koptu, 15+ dakikadır teslim bekleyen, bakımda olan makineler. Kritik satırda ünlem işareti titreşir.
• 👀 Yakında Dikkat Et: Yeni bitmiş (15 dakika altı), 90+ dakikadır çalışan makineler.

4.6 Enerji Panosu ve Maliyet Analizi

Operasyon → Enerji sekmesinde son 30 günlük toplam tüketim (kWh ve TL), bugünkü tüketim, toplam döngü sayısı, döngü başına ortalama maliyet ve son 14 günün sparkline grafiği yer alır. Birim elektrik fiyatı Kontrol sekmesinden güncellenebilir; değişiklik anında maliyet hesaplarına yansır ve "Son güncelleme" tarihi Cloud Functions tarafından sunucu saatiyle yazılır.

4.7 Telegram Bildirim Kategori Filtresi YENİ

Kontrol sekmesinde, hangi olay türlerinin Telegram'a gönderileceğini seçebilirsiniz. Telegram Bot API limitsiz/ücretsiz olsa da, admin gereksiz bildirim spam'ini engellemek için varsayılan ayarlar şöyledir:

• Açık: Hub alarmı, Sensör kopuk, Anormal durum (8h timeout), Bütçe alarmı, Yeni cihaz, Bakım uyarısı, Haftalık rapor
• Kapalı: Cycle tamamlandı (sık), Tanı tespiti (sık), Öneri yeni (isteğe bağlı)

Master Telegram toggle kapalıysa tüm kategoriler etkisizdir.

4.8 Hub HALT/RESUME Kontrolü

Cihazlar sekmesinde Hub Durumu kartı bulunur. Hub'ın anlık durumunu (Aktif / Duraklatıldı) gösterir. Duraklat butonu ile Hub'ın Firebase yazımlarını geçici olarak durdurabilirsiniz (bakım/temizlik için). Devam Et ile normal çalışmaya döner. Hub v56.1 (14 May gece sahaya alındı) ile tam uyumlu — komut Hub tarafında 30sn içinde algılanır, LoRa RX devam eder, Firebase yazımı durur.

4.9 Eşik Override YENİ

Cihazlar sekmesinde her makine için manuel eşik akımı girebilirsiniz (0.1 – 5.0 A aralığında). Boş bırakılırsa, her gece 03:30'daki otomatik batch doğru eşiği hesaplar. "✓" butonu ile kaydedilir; onay dialog'u yanlış girişlere karşı koruma sağlar.

4.10 Sistem Sürümleri ve Audit Log YENİ

Cihazlar sekmesinin altında 🏷️ Sistem Sürümleri kartı; frontend, backend (CF), FSM motoru, Hub, Çavuş ve İşçi sürümlerini gösterir. Her sürümün yanında DB'de kayıtlı sürümle eşleşip eşleşmediği (✓ / ⚠) belirtilir. Altında 📋 Audit Log bölümü son 8 sürüm değişimini (tip, sürüm, önceki sürüm, zaman) listeler — "v210'da mıydı v211'de mi?" sorusuna kesin cevap verir.

4.11 Çamaşırhane Sağlık Skoru YENİ

Admin → Canlı sekmesinde Anlık Durum kartının altında yeni bir Çamaşırhane Skoru banner'ı gösterilir. Bu skor, her makine için beş bileşeni ağırlıklı olarak hesaplayıp ortalar:

• Veri Düzeni (%25): Son 30 döngüdeki veri tutarlılığı
• Manuel Müdahale (%20): Doğrudan boşaltma/bakım oranı (düşükse iyi)
• Döngü Güveni (%20): Sahte / kısa döngü oranı
• Drift (%20): Normal süre sapması (yüksek drift = kireçlenme riski)
• Tanı (%15): Aktif kritik tanı sayısı

Sonuç: 71–100 → Sağlıklı (yeşil), 41–70 → Orta (sarı), 0–40 → Kritik (kırmızı). Banner'ın altında "Müdahale Gerekenler" şeridinde en sorunlu 5 makine sıralanır. Skor her gece 03:30'da güncellenir.

Her makine kartının yanında 40px'lik sağlık halkası (dairesel SVG progress) makineye özgü skoru ve etiketini gösterir.

4.12 Bakım Takvimi YENİ

Operasyon → Özet sekmesinde Bakım Takvimi kartı, her makine için üç tür bakım önerisi sunar:

• Filtre Kontrolü: Her 500 döngüde bir tetiklenir.
• Kireç Temizliği: Her 1000 döngüde bir. Döngü süresi belirgin uzamışsa öncelik "yüksek" olarak işaretlenir.
• Genel Kontrol: Son bakımdan itibaren 180 gün geçmişse.

Her öneri satırında makine no, bakım tipi ve "✓ Yapıldı" butonu bulunur (Teknik + Geliştirici görür). Butona tıklandığında onay dialog'u açılır; onaylanınca bakım kaydı oluşturulur, döngü sayacı sıfırlanır ve öneri listeden kalkar. Sonraki tetik, o bakımdan itibaren sayılmaya başlar.

4.13 İşçi Reset Geçmişi ve Kayıp Döngü Adayları YENİ

Cihazlar sekmesinde iki yeni geçmiş kartı bulunur:

• 🔄 İşçi Reset Geçmişi: Son 30 günde uzaktan gönderilen reset komutlarının makine bazlı listesi (tarih, tetikleyen, sebep). Sık resetlerin hangi makinede yoğunlaştığını görmek için kullanılır.
• ⚠️ Kayıp Döngü Adayları: Hub bağlantı kopması veya yeniden başlatma sırasında kaydedilememiş döngü kanıtlarını gösterir. Her makine için son 5 aday listelenir (active sample sayısı, beklenen süre, kopma yönü). Bu veriler ilerleyen sürümde otomatik döngü kurtarma (recovered_end) için kullanılacaktır.

4.15 Şikayet Yönetimi (Cevapla / Çözüldü / Arşivle) YENİ

Operasyon sekmesinde Şikayet Paneli: açık + son 20 çözülmüş şikayet listelenir. Her satırda:

• 💬 Cevapla: Inline textarea ile öğrenciye doğrudan yanıt yazma. Cevap profil sayfasında yeşil bordürlü balon olarak görünür. Her yetkili (memur dahil) cevap yazabilir, audit'lenir.
• ✓ Çözüldü: Şikayeti çözüldü olarak işaretler. Cevap ile çözüldü AYRI butonlardır (OMAR kararı). Çözüldükten sonra şikayet açık listesinden çıkar ama profilde görünür kalır.
• 📦 Arşivle: v2.73s Çözülmüş şikayeti operasyon panelinden tamamen kaldırır (soft delete). Profil sayfasında görünür kalır (öğrenci geçmişi için kayıt amaçlı).

4.16 Sabah Raporu (Kartlı Müdahale + PDF) YENİ

Her gece 07:55'te sabahRaporuOlustur cron çalışır, gün özetini hazırlar. Raporlar sekmesinde:

• 📋 Müdahale gerekenler kartları v2.73s: 10 adede kadar tıklanır makine kartı (admin sağ çekmece direkt açılır). Sağlık skoru <41/100 + tanı sebepleri görünür.
• 📥 PDF İndir: Tam liste + KPI + müdahale önerileri PDF olarak. jsPDF lazy load (200KB tasarruf — ilk açılışta indirilir).
• 📤 Telegram Özet: Sabah 08:00'de Geliştirici Telegram kanalına otomatik kısa özet gönderilir.

4.17 Cihaz "Son Görülen" + Stale Sil YENİ

Cihazlar sekmesinde her cihaz satırında "Son Görülen" sütunu eklendi v2.73s (saatlik Çavuş MAC raporundan). 24 saatten eski cihazlar (sökülmüş/repurpose edilmiş board'lar) için 🗑 Sil butonu görünür — DB'den temizler. Geliştirici-only güvenlik.

4.18 OTA Firmware Güncelleme YENİ

Sistem sekmesinde 🔄 Firmware Güncelleme kartı bulunur (Geliştirici-only). Akış:

1. Firmware binary'sini (.bin) compile et (Arduino IDE'de)
2. Sistem → "Binary Yükle" → Firebase Storage'a upload (otaBinaryYukle callable RTDB registry'ye kayıt)
3. Hedef cihaza fişten 3× hızlı çek-tak (boot counter trigger)
4. Cihaz WiFi STA'ya geçer → Storage'tan signed URL ile binary indirir → flash → restart
5. Fail-safe: WiFi timeout 30sn / httpUpdate fail → 30sn sonra normal mod (sahada donma yok)

Saha kanıtı: 14 May gece OMAR Hub v56.0 → v56.1 + 2 Çavuş v30.5 → v30.5.1 OTA ile başarıyla güncelledi. Sahada söküp flash gerekmez.

4.14 Raporlar (Raporlar Sekmesi) YENİ

• 📊 CSV İndir: Seçtiğiniz tarih aralığındaki döngü verilerini (makine no, tip, başlangıç, bitiş, süre, sınıflandırma, ortalama akım, program) Excel uyumlu CSV olarak dışa aktarır. CSV Injection saldırılarına karşı korumalıdır.
• 🧪 Teknik Rapor: Makine seçimi ve tarih aralığı ile kapsamlı analiz. Döngü süre eğrisi, sınıf dağılımı (pasta grafiği), makine bazlı özet ve detaylı tablo.
• 📅 Haftalık Rapor Paylaş: Son 7 günün döngü, tüketim ve maliyet özetini Telegram'a gönderir.

5. Demo Modu

Sistemi gerçek veri olmadan test etmek için sağ üstteki 🎭 Demo butonuna tıklayın. 8 sanal makine (4 çamaşır, 4 kurutma) ile gerçekçi bir simülasyon başlatılır; akım değerleri 10 saniyede bir dalgalanır, durumlar otomatik güncellenir. Firebase bağlantısı tamamen kesilir, gerçek verilere dokunulmaz. Demo modundayken mor bir banner ve butonun aktif hali gösterilir. Çıkmak için banner'daki "Çıkış" butonunu kullanın.

6. Teknik Altyapı ve Güvenlik

6.1 Performans Modları (Perf Tier)

Sistem, cihazınızın belleğine ve işlemci gücüne göre otomatik olarak düşük (low), orta (mid) veya yüksek (high) performans modunda çalışır. Düşük güçlü cihazlarda (≤2GB RAM) animasyonlar, blur efektleri, gölgeler ve arka plan gradyanları tamamen kapatılır; dokunma geri bildirimi opacity ile sağlanır. Bu ayar data-perf-tier HTML özelliği ile kontrol edilir ve kullanıcı müdahalesi gerektirmez. Ayrıca data-slow-net özelliği ile yavaş bağlantılarda skeleton shimmer ve logo animasyonu kapatılır.

6.2 Bütçe Koruma Katmanları (Kill Switch)

Cloud Functions tarafında 3 katmanlı fatura koruması aktiftir (17 Nisan 2026 ₺13,218 patlaması sonrası kuruldu):

1. maxInstances=20: Her fonksiyon için Cloud Run eşzamanlı instance limiti (fiziksel kapı). 40 makineye geçişte Cloud Run CPU quota artırımı gerekir.
2. killSwitchAktif(): Saatlik instance başına 3000 invocation limiti (12 May v2.72j ile 2000→3000 bump — 17 makine geçişi headroom). Yumuşak uyarı, işlemleri durdurur.
3. budgetKillSwitch: Cloud Billing bütçe alarmı tetiklendiğinde (₺400 eşik) /_kill_switch/active=true yazan pub/sub fonksiyonu. Bu flag'i gören tüm hassas CF'ler kendini durdurur. Manuel sıfırlama gerektirir.

6.3 Veri Tutarlılığı ve Koruma Mekanizmaları

Backend (index.js) ve frontend (script.js) çok sayıda koruma mekanizması içerir:

• shouldWriteCycleRecord: 0 dakikalık veya 1A altı sahte döngü kayıtlarını engeller. Sensör freeze tespiti, program süresi kontrolü ve minimum süre kuralları içerir.
• cycleAlreadyExists: Aynı başlangıç zamanına sahip mükerrer döngü kaydını önler (v183).
• filterUnchanged: Veritabanında gerçek bir değişiklik yoksa yazma işlemini atlar (v163).
• etkiliDurumRaw: Frontend'de Hub ve FSM'den gelen iki farklı zaman damgasının en yenisini kullanarak "Koptu" flash'lamasını engeller.
• Boşaltma Koruma Penceresi: Teslim/boşalt sonrası 3 dakika boyunca FSM çalışmaz; gecikmiş Hub paketlerinin yanlış cycle başlatmasını engeller (v173).
• Flap Dedektörü: 30 dakikada 15+ durum geçişi → otomatik bakım (v157).
• Kuyruk Timeout: 24 saatten eski kuyruk girişleri otomatik temizlenir, kullanıcıya FCM bildirimi gönderilir (v207).
• FSM Zaman Damgası Koruma: Hub paket gecikmesi veya ESP32 NTP gecikmesi durumunda eski paket gelirse nowSn fallback kullanılır; sahte lastActiveTimestampSec / runningStartedAtSec yazımı engellenir (v252).
• KVKK Uyumluluğu: Kuyruk verisinden e‑posta alanı kaldırıldı (v211). Sadece uid, token ve isim saklanır. DB rules'a uid match ve token length validasyonu eklendi (v224).

6.4 Otomatik Tanı Sistemi (doktorKontrol)

Her 30 dakikada bir çalışan doktorKontrol cron fonksiyonu makineleri tarar ve Admin → Kontrol → Tanı Merkezi'ne raporlar yazar. Aktif tanı tipleri:

Tanı	Açıklama	Aksiyon
SIK_KOPTU	24 saatte 5+ bağlantı kopması	RSSI, kablo veya Çavuş kontrolü
SENSOR_FANTOM	24 saatlik pencerede akım değeri anormal dar aralıkta takılı kalmış	Çavuş fişini çekip takın
SENSOR_DEAD_ZERO YENİ	Cihaz heartbeat veriyor, makine RUNNING/FINISHING durumunda, ama akım <0.2A — sensör sıfırda donmuş	Çavuş fişini çekip takın; saha müdahalesi gerekebilir
CYCLE_DRIFT	Son döngü süresi normal medyandan %50+ sapıyor (kireçlenme göstergesi)	Kireç temizliği önerilebilir
KULLANILMIYOR	36+ saat hiç döngü yok (sinyal canlıyken)	Donanım veya yerleşim kontrolü
SAGLIK_DUSUK YENİ	Makine sağlık skoru <41/100 (kritik eşik)	Tanı sebeplerine göre çok katmanlı müdahale
FLAP_ISITICI, SESSIZ_ARIZA, UZUN_DUSUK_AKIM, SENSOR_YOK	Diğer sensör ve elektronik anomaliler	Teknik servis

7. Bildirim Sistemleri

7.1 Cep Push Bildirimleri (PWA / FCM)

Makine bitişi, sıra sırası ve boş makine bildirimleri Firebase Cloud Messaging (FCM) üzerinden tarayıcı push olarak gelir. Bu, yönetici Telegram bildirimlerinden bağımsız bir sistemdir. Ayarlar Admin → Cihazlar sekmesinde "Cep Push Bildirimleri (PWA)" kartından kontrol edilir.

• iOS'ta yalnızca ana ekrana eklenmiş PWA üzerinden çalışır (iOS 16.4+).
• Android Chrome'da arka planda da bildirim alınır.

7.2 Telegram Bildirim Sistemi (Yönetici)

Sistem, kritik olaylar için Telegram Bot API üzerinden yöneticilere bildirim gönderir (15 May 2026 itibarıyla CallMeBot WhatsApp'tan göç edildi — kotalı sessiz queue problemi tamamen kapandı). Bot token ve chat ID Cloud Functions ortam değişkenlerinde (TELEGRAM_BOT_TOKEN, TELEGRAM_CHAT_ID) saklanır.

• Devre Kesici: Art arda 3 hata → 1 saat susturma. Başarılı gönderimde otomatik sıfırlanır.
• Kategori Filtresi: Admin hangi olayların Telegram'a gideceğini seçebilir (bkz. Bölüm 4.7).
• Ücretlendirme: Telegram Bot API limitsiz/ücretsiz. Kategori filtresi spam'i engeller, kota değil.
• Tanı: Admin → Sistem sekmesinde Telegram gönderim test butonu bulunur; son başarılı gönderim tarihi ve devre kesici durumu görüntülenebilir.

8. Sık Sorulan Sorular ve Sorun Giderme

S: Bildirim gelmiyor.
C: Cep push (FCM): Chrome'da adres çubuğundaki kilit simgesi → Bildirimler → İzin ver. iOS'ta ana ekrana eklenmiş PWA üzerinden deneyin (iOS 16.4+). Hakkında modal'ında iOS için özel ipucu gösterilir. — Telegram bildirimleri: Yönetici bildirimleri için geçerlidir. Admin → Sistem sekmesindeki Telegram Tanı kartından son gönderim durumu ve devre kesici kontrolü yapılabilir.

S: Makine "Koptu" yazıyor ama aslında çalışıyor.
C: Hub bağlantısı kesilmiş olabilir. Admin panelinden "Hub Resetle" butonunu kullanın veya yurt teknik sorumlusuna haber verin. Hub yeni reset atmışsa (son 5 dakika) zombi temizleyici geçici olarak devre dışı kalır.

S: Kalan süre tahmini hatalı.
C: Kalan süre; seçilen programa, yurt ortalamasına ve geçmiş döngü sürelerine göre hesaplanır. Yeterli veri olmadığında sapma gösterebilir. Program seçerseniz (ilk 30 dakika içinde) tahmin daha isabetli olur.

S: Makine hiç "Bitti" durumuna geçmiyor, sürekli "Çalışıyor" görünüyor.
C: v200'de devreye alınan FSM v10 bu sorunu NEUTRAL band (2.2–3.0A) ile büyük ölçüde çözdü. Hâlâ oluyorsa sensör takılı kalmış olabilir (SENSOR_FANTOM tanısı). Admin paneli → Cihazlar sekmesinden ilgili makinenin "⚠ SENSOR FANTOM" uyarısına bakın. Çavuş fişini çekip takmak genellikle çözer.

S: "Kayıtsız Cihaz Raporları"nda gerçek makineler görünüyor.
C: Bu liste, MAC adresi /cihazlar tablosunda kayıtlı olmayan ancak Çavuş'tan veri gelen cihazları gösterir. Admin paneli → Cihazlar sekmesinden manuel atama yapabilirsiniz.

S: Sistem yavaş çalışıyor.
C: Eski bir cihaz kullanıyorsanız sistem otomatik olarak düşük performans moduna geçer (animasyonlar kapalı). Tarayıcı önbelleğini temizlemeyi ve sayfayı yenilemeyi deneyin. Hâlâ yavaşsa Kompakt Görünüm'e geçin.

9. İletişim ve Destek

Teknik sorunlar, öneriler veya yeni özellik talepleri için:

• Öneri / Geri Bildirim: Uygulama içi "💡 Öneri / Geri Bildirim" bölümünden doğrudan yöneticiye iletebilirsiniz.
• E‑posta: newworldynd@gmail.com
• Sürüm Numarası: Sayfanın en altında gösterilir (örn. "Akıllı Çamaşırhane · Frontend 2.73w"). Destek taleplerinde bu sürüm numarasını belirtmeniz çözüm sürecini hızlandıracaktır.