Bakım & Arıza Kullanım Kılavuzu
Amaç ve Kimler Kullanır
Bakım & Arıza modülü; şirkete ait makine/ekipmanların kart bilgilerinin tutulmasını, bu ekipmanlar için periyodik bakım planlarının tanımlanmasını ve arızaların hem iç kullanıcılar hem de sahadaki personel/misafirler tarafından (QR kod veya link ile, giriş yapmadan) bildirilip takip edilmesini sağlar. Ayrıca gece çalışan bir otomatik hatırlatma/eskalasyon sistemi vardır.
Kullanıcılar:
- Bakım/teknik sorumlular — makine kartı açar, bakım planı tanımlar, bakım işlemlerini yürütür.
- Saha personeli / operatörler — arıza bildirir (iç ekrandan veya QR ile), arızayı takip eder.
- Yöneticiler — haftalık özet raporlarını e-posta ile alır, eskalasyon uyarılarını takip eder.
Bu modül şirkette ArizaBakim modülü aktifse görünür.
Ana Ekranlar

- Makine Formu / Listesi / Detayı — ekipman kartı, QR etiketi.
- Bakım Planı Formu / Listesi / Detayı / Takvimi — periyodik bakım planları, bakım işlem akışı, bakım belgesi (iş emri) PDF çıktısı.
- Arıza Formu / Listesi / Detayı — arıza bildirimi, durum/atama takibi, kapatma.
- Genel QR Sayfası (herkese açık) — QR etiketi okutulduğunda açılan, giriş gerektirmeyen makine bilgi + arıza bildirim sayfası.
- Genel "Hızlı Bildir" Formu (herkese açık) — bağımsız bir public arıza bildirim formu.
Adım Adım Kullanım
1. Makine/ekipman kartı açma ve QR etiketi basma

- BAKIM & ARIZA > Makine & Ekipman > Yeni Makine menüsüne gidin.
- Makine No alanını boş bırakırsanız sistem otomatik olarak
MKN-00001biçiminde sıra numarası üretir. Ad alanı zorunludur. - Diğer alanları doldurun: Marka, Model, Seri No, Kategori (dropdown; "+ Yeni Kategori" ile anında eklenebilir), Şube (Lokasyon), Satın Alım Tarihi, Garanti Başlangıç/Bitiş, Alış Fiyatı ve Döviz, Açıklama, Aktif/Pasif durumu.
- Kaydet ile makine kartı oluşturulur.
- Makine Detay sayfasında son 5 arıza, son 5 bakım kaydı ve toplam arıza maliyeti görülür. Açık (kapanmamış) arızası olan bir makine silinemez.
- Toplu makine tanımı için Excel'e Aktar / Örnek Excel İndir / Excel'den Aktar seçenekleri kullanılabilir (sütun eşleştirme başlık adına göre otomatik yapılır; Makine No eşleşirse mevcut kayıt güncellenir).
QR etiketi üretme ve basma:
- Makine Detay sayfasından QR Kod ekranına gidin.
- Makinenin daha önce bir QR kodu yoksa sistem otomatik olarak benzersiz bir kod üretip makineye kaydeder.
- Sayfada makine bilgileri (No, Ad, Marka/Model, Kategori, Lokasyon) ile birlikte bir QR görseli gösterilir.
- "Yazdır / PDF" butonuna basarak etiketi yazdırın ve makinenin üzerine/yanına yapıştırın.
QR okutulunca ne olur: Etikette kodlanmış bağlantı, giriş yapmadan erişilebilen genel bir sayfayı açar. Bu sayfada:
- Makinenin özet bilgi kartı (ad, no, durum, marka/model, seri no, lokasyon, kategori, garanti durumu) gösterilir.
- "Arıza Bildir" başlıklı kısa bir form vardır: Başlık (zorunlu), Açıklama, Bildiren Kişi (isteğe bağlı) alanlarıyla, giriş yapmadan doğrudan o makine için arıza kaydı açılabilir. Bu şekilde açılan arızalar "QR ile oluşturuldu" olarak işaretlenir, öncelik "Normal" ve durum "Bekliyor" olarak başlar.
- Sayfanın altında o makineye ait son 10 arıza ve son 5 bakım kaydı salt görüntüleme olarak listelenir.
Önemli: Makine QR etiketindeki bağlantı ile aşağıda anlatılan "Hızlı Bildir" public formu birbirinden farklı iki ayrı mekanizmadır — biri doğrudan makineye bağlı QR koduyla, diğeri şirket/makine seçimi gerektiren genel bir bağlantıyla çalışır.
2. Periyodik bakım planı tanımlama

- BAKIM & ARIZA > Bakım Planlaması > Yeni Plan menüsüne gidin.
- Makine (zorunlu) ve Plan Adı (zorunlu, örn. "3 Aylık Genel Bakım") girin.
- Periyot olarak Günlük / Haftalık / Aylık / Yıllık / Saatlik seçin ve "Her Kaçta Bir" (periyot değeri) sayısını girin.
- İlk / Sonraki Bakım Tarihini belirleyin.
- Sorumlu olarak bir teknisyen (iç kullanıcı) veya dış firma seçin.
- Gerekirse bir kontrol listesi oluşturun: her madde için açıklama girip, zorunlu olup olmadığını işaretleyin (zorunlu maddeler işaretlenmeden bakım tamamlanamaz).
- Plan Aktif anahtarını açık bırakın ve Kaydet.
- Var olan bir planı hızlıca çoğaltmak için Detay sayfasındaki "Kopyala" butonunu kullanabilirsiniz (kontrol listesiyle birlikte "(Kopya)" adıyla yeni bir plan oluşturur).
Not: Saatlik periyot seçeneği formda mevcuttur, ancak "sonraki bakım tarihi" otomatik hesaplamasında özel olarak ele alınmaz; günlük periyotla aynı mantıkla (gün ekleyerek) hesaplanır — saatlik periyotlu planlar için tarihi kontrol etmeniz önerilir.
Bakım işlemini başlatma ve tamamlama:
- Plan Detay sayfasında "İşlemi Başlat" butonuna basın; bu, plandaki tüm kontrol maddeleriyle birlikte yeni bir "Devam Ediyor" durumunda bakım işlemi açar.
- İşlem Detay sayfasında kontrol listesi maddelerini teker teker işaretleyin.
- Gerekirse maliyet kalemleri ekleyin; müşteriye fatura edilecekse ilgili cariyi işleme atayın.
- Tüm zorunlu kontrol maddeleri işaretlendikten sonra "Tamamla" butonuna basın — zorunlu bir madde eksikse sistem uyarı verip tamamlamayı engeller.
- İşlem tamamlandığında planın "Sonraki Bakım Tarihi" otomatik olarak periyoda göre yeniden hesaplanır.
- Yapılamayacak bir bakım işlemi için "Atla" seçeneği kullanılabilir (bir neden girilerek).
- Bakım Takvimi ekranında tüm planlanan/tamamlanan bakım işlemleri takvim görünümünde izlenebilir.
Bakım belgesi (İş Emri) PDF çıktısı:
- Plan Detay sayfasından "İş Emri" butonuyla bir PDF indirilir.
- Bu belge, saha ekibinin elle doldurması için hazırlanmış boş bir şablondur: makine bilgileri, plan bilgileri, kontrol listesi (her madde için elle işaretlenecek boş Sonuç sütunu), notlar için boş alan, son 5 bakım geçmişi tablosu ve altta "Bakımı Yapan / Kontrol Eden / Onaylayan" için üç imza kutusu içerir.
3. Arıza bildirimi (iç kullanıcı)

- BAKIM & ARIZA > Arıza Yönetimi > Yeni Arıza menüsüne gidin.
- Makine, Kategori, Öncelik (Düşük/Normal/Yüksek/Kritik), Başlık (zorunlu), Açıklama, Arıza Tarihi girin; isteğe bağlı olarak sorumlu Teknisyen veya dış Servis Firması atayabilir, fotoğraf/dosya ekleyebilirsiniz.
- Kaydettiğinizde sistem otomatik
ARZ-XXXXXnumarası üretir; arıza başlangıç durumu her zaman **"Bekliyor"**dur. - Bir teknisyen atadıysanız ona otomatik e-posta gönderilir; ayrıca şirket geneline "🔧 Yeni Arıza Kaydı" push bildirimi düşer.
Arıza takibi:
- Arıza Listesi ekranı varsayılan olarak sadece açık arızaları ("Devam Ediyor" ve "Bekliyor") gösterir; "Tümü" seçeneğiyle kapatılmış arızalar da görülebilir.
- Detay sayfasında "Devam Ediyor" veya "Bekliyor" durum butonlarıyla durum güncellenir; her değişiklik zaman çizelgesine (log) kaydedilir. Liste ekranından birden çok arızanın durumu toplu olarak da değiştirilebilir.
- Yedek parça kullanıldıysa Detay sayfasından stok hareketi eklenebilir (otomatik stok düşümü/iadesi ile).
- Parça sistemde yoksa "Yedek Parça Talep" ile satınalma yetkili kullanıcılara otomatik e-posta gönderilebilir.
- Arıza çözüldüğünde "Arızayı Kapat" ile yapılan işlem, kök neden ve kapanma tarihi (boş bırakılırsa o an) girilir; sistem açılış-kapanış arasındaki süreyi (dakika) otomatik hesaplayıp kaydeder ve "✅ Arıza Kapatıldı" push bildirimi gönderir.
- Her arıza için, tanımlıysa öncelik bazlı bir hedef çözüm süresi (SLA) gösterilir.
Teknisyen servis formu ve müşteri onay linki (dinamik form + imza):
Arıza Detay sayfasında, tanımlı bir dinamik form şablonu varsa teknisyenin dolduracağı bir "Servis" formu açılabilir (bölüm/alan yapısı esnek bir şablondan gelir — metin, uzun metin, sayı, tarih, evet/hayır, tekli/çoklu seçim, 1-5 puanlama gibi alan tipleri desteklenir). Bu form imza alanı da içerebilir.
Ayrıca Detay sayfasından "Müşteri Onay Linki Oluştur" ile 14 gün geçerli, tek kullanımlık bir bağlantı üretilebilir:
- Detay sayfasında onay linkini oluşturun; sistem bunu doğrudan bir WhatsApp mesaj linki olarak veya düz bir bağlantı olarak sunar, hangi kanaldan paylaşıldığı kayıt altına alınır.
- Bu bağlantıyı müşteriye/ilgili kişiye iletin (WhatsApp, SMS, e-posta vb. — link paylaşımı sistem dışında yapılır).
- Müşteri, giriş yapmadan bağlantıya tıklayarak genel bir onay formu sayfasını açar; burada şirketin tanımladığı dinamik form şablonu (varsa) doldurulur ve altta bir imza alanına (canvas) parmak/kalem ile imza atılır.
- Form gönderildiğinde bağlantı tek kullanımlık olarak kilitlenir (aynı link ikinci kez kullanılamaz) ve sonuçlar arızaya kaydedilir; ilgili şirkete "📝 Müşteri Formu Tamamlandı" push bildirimi gönderilir.
- Linkin süresi (14 gün) dolmuşsa veya daha önce kullanılmışsa, müşteri sayfayı açtığında "geçersiz/kullanılmış link" mesajı görür.
Bu, projedeki uzaktan (self-servis) müşteri onayı + imza akışının tek örneğidir; Oto Servis (araç) modülünde buna karşılık gelen bir uzaktan onay linki yoktur (bkz. 07-OtoServis.md).
4. Public "Hızlı Bildir" ile arıza bildirimi (giriş yapmadan)

"Hızlı Bildir" sayfası, makinenin QR etiketinden bağımsız, ayrı bir genel bağlantıdır:
- Bağlantı belirli bir şirkete (zorunlu) ve isteğe bağlı olarak belirli bir makineye özel olarak paylaşılır. Bu bağlantının nereden/nasıl dağıtıldığı (örn. panoya asılan ayrı bir kod, saha talimatı vb.) kurum içi bir tercihtir; sistemde otomatik üretilip gösterildiği bir ekran yoktur.
- Sayfa açıldığında o şirkete ait aktif makineler bir dropdown listesinde görünür; bağlantıda belirli bir makine belirtilmişse ilgili makine otomatik seçili gelir.
- Form alanları: Makine (zorunlu, dropdown), Başlık (zorunlu), Öncelik (varsayılan Normal), Açıklama (isteğe bağlı), fotoğraf ekleme (mobil cihazlarda doğrudan kamerayı açacak şekilde ayarlanmıştır).
- Gönderildiğinde
ARZ-XXXXXnumaralı bir arıza kaydı "Bekliyor" durumunda açılır, zaman çizelgesine "Mobil Bildirim" kullanıcısıyla log düşülür ve şirkete "📣 Sahadan Arıza Bildirimi" push bildirimi gönderilir. - Başarılı gönderim sonrası kullanıcıya bir takip numarası gösterilen bir onay sayfası açılır.
Alan Açıklamaları
| Alan | Ekran | Açıklama |
|---|---|---|
| Makine No | Makine Formu | Boş bırakılırsa MKN-00001 biçiminde otomatik üretilir |
| QR Kod | Makine QR Kod ekranı | Makineye özel, ilk açılışta otomatik üretilen benzersiz kod; genel erişime açılır |
| Periyot / Her Kaçta Bir | Bakım Planı Formu | Bakımın tekrar sıklığı (Günlük/Haftalık/Aylık/Yıllık/Saatlik + katsayı) |
| Sonraki Bakım Tarihi | Bakım Planı | Bir sonraki bakımın planlandığı tarih; işlem tamamlanınca periyoda göre otomatik yenilenir |
| Kontrol Listesi / Zorunlu | Bakım Planı | Bakım işleminde işaretlenmesi gereken maddeler; zorunlu olanlar tamamlanmadan işlem kapatılamaz |
| Öncelik | Arıza Formu | Düşük / Normal / Yüksek / Kritik — SLA hedef süresini ve raporlardaki önceliği etkiler |
| Durum | Arıza | Bekliyor (başlangıç) / Devam Ediyor / Kapalı (varsayılan/tanımsız durum "Açık" olarak gösterilir) |
| Duruş Süresi (dk) | Arıza Kapatma | Arıza açılışı ile kapanışı arasındaki süre, kapatma anında otomatik hesaplanır |
| sirketId / makineId | HizliBildir bağlantısı | Public formun hangi şirket/makineyi göstereceğini belirleyen sorgu parametreleri |
Sık Karşılaşılan Durumlar / İpuçları / Uyarılar
- Açık arızası olan makine silinemiyor: Önce ilgili arızaların kapatılması gerekir.
- Bakım işlemi "Tamamla" ile kapanmıyor: Kontrol listesindeki zorunlu maddelerden işaretlenmemiş olanlar var demektir; tüm zorunlu maddeleri işaretleyin.
- Saatlik periyotlu bakım planının tarihi beklediğim gibi ilerlemiyor: Sistem saatlik periyodu ayrıca hesaplamaz, günlük periyotla aynı mantığı kullanır; bu tür planlarda sonraki tarihi elle kontrol etmeniz önerilir.
- QR kod ile HizliBildir linkini karıştırmayın: QR etiketi doğrudan makineye bağlı özel bir koddur; HizliBildir ise
sirketId/makineIdparametreli, ayrıca paylaşılması gereken genel bir bağlantıdır. İkisi de giriş gerektirmez ama farklı adreslerdir. - Müşteri onay linkinin süresi doldu / zaten kullanılmış diyor: Link 14 gün geçerli ve tek kullanımlıktır; yeni bir link üretmeniz gerekir.
- Arıza modülünde uzaktan müşteri onayı var ama Oto Servis'te yok: Bu kasıtlıdır — bkz.
07-OtoServis.md, orada imza sadece ofis içinde (aynı cihazda) alınır.
Otomatik hatırlatma ve eskalasyon e-postaları (arka plan servisi)
Sistemde her gece saat 02:00'de otomatik çalışan bir arka plan görevi (uygulama ilk açıldığında ayrıca 2 dakika içinde bir kez daha çalışır) dört ayrı kontrolü sırayla yapar. Bu işlem tamamen otomatiktir, kullanıcı müdahalesi gerektirmez:
- Bakım Hatırlatması: Sonraki bakım tarihi tam olarak bugünden 3 gün sonrasına denk gelen aktif bakım planları için, planın sorumlu (iç) kullanıcısına — e-posta adresi tanımlıysa — "⏰ Bakım Hatırlatması: {Plan Adı}" konulu bir e-posta gönderilir. (Sorumlu bir dış firma ise bu e-posta gönderilmez, sadece iç kullanıcı sorumlulara gider.)
- Gecikmiş Bakım Uyarısı: Sonraki bakım tarihi geçmiş olan aktif planlar için sorumlu kullanıcıya "Gecikmiş Bakım Uyarısı: {Plan Adı}" konulu, kaç gün gecikildiğini belirten bir e-posta gönderilir. Aynı plan için günde en fazla bir kez gönderilir (tekrar mail bombardımanı olmaz).
- Arıza Eskalasyonu: Kapatılmamış ve açılışından itibaren 24 saati geçmiş arızalar için, şirketteki tüm aktif ve e-posta adresi tanımlı kullanıcılara "🚨 {X} saattir çözülemeyen arıza: {Arıza No}" konulu bir uyarı e-postası gönderilir. Bu da aynı arıza için 24 saatte bir kez tekrarlanır (spam önlenir).
- Haftalık Özet Raporu: Yalnızca Pazartesi günleri çalışır; son 7 günün arıza (toplam/kapanan/açık kalan/kritik) ve bakım (toplam işlem/tamamlanan/atlanan/geciken plan) özetini, şirketin süper admin yetkili ve e-posta adresi tanımlı kullanıcılarına "📊 Haftalık Arıza & Bakım Özeti" konulu bir e-posta ile gönderir.
Bu e-postaları almak için ilgili kullanıcı kaydının aktif olması ve geçerli bir e-posta adresi tanımlı olması gerekir; sorumlu/yetkili tanımlı değilse veya e-posta boşsa o kullanıcıya bildirim gitmez.