Teknik Servis Yönetim Scripti Kurulum ve Kullanım Kılavuzu

Bu yazılım nedir?#

Teknik servis ve hizmet firmaları için iş emri, teknisyen, stok, teklif ve cari yönetimi. Müşteri siteden talep açıp takip koduyla durumu izler; siz işi panodan yürütür, kullanılan parçayı stoktan düşer, tutarı cariye işlersiniz.

Sunucu gereksinimleri#

Aşağıdakiler yazılımın çalışması için gereken asgari koşullardır. Neredeyse tüm paylaşımlı hosting paketleri bunları zaten karşılar.

• PHP 8.0 veya üzeri (cPanel → "Select PHP Version" menüsünden seçin)
• MySQL / MariaDB veritabanı
• Şu PHP eklentileri açık olmalı: pdo_mysql, mbstring, openssl, gd, curl
• Apache mod_rewrite (cPanel'de standarttır)
• Kök dizin ve storage/ klasörü için yazma izni
• Geçerli bir missweb.com lisans anahtarı (müşteri panelinizden alınır)

PHP sürümünü cPanel'de “Select PHP Version” menüsünden değiştirebilirsiniz. Eklentilerden biri kapalıysa aynı ekrandan açabilir ya da hosting firmanızdan açmasını isteyebilirsiniz.

Adım adım kurulum#

Kurulum tarayıcıdan çalışan bir sihirbazla yapılır: veritabanı bilgilerini, yönetici hesabınızı ve lisans anahtarınızı girersiniz; şema, örnek içerik ve lisans etkinleştirmesi otomatik tamamlanır.

1. Dosyaları yükleyin. ZIP içindeki dosyaları public_html/ klasörüne çıkarın. Pakette gelen .htaccess gerekli yönlendirmeyi yapar.
   Daha güvenli yöntem: dosyaları public_html dışına yükleyip cPanel → Domains'ten alan adının kök dizinini .../public klasörüne ayarlamak.
2. Veritabanı oluşturun. cPanel → MySQL® Databases: bir veritabanı, bir kullanıcı açın ve kullanıcıyı veritabanına tüm yetkilerle ekleyin. Üç bilgiyi not alın.
3. Sihirbazı çalıştırın. Tarayıcıdan https://alanadınız.com/install.php adresine gidin; veritabanı bilgilerini, yönetici hesabınızı ve lisans anahtarınızı girin. Kurulumu Tamamla deyin.
4. install.php dosyasını silin. Sihirbaz ikinci kez çalışmaz ama dosyayı sunucudan kaldırmak en güvenlisidir. .env dosyasının iznini 600 yapın: içinde veritabanı şifreniz vardır.
5. Panele girin. https://alanadınız.com/admin/login adresinden kurulumda belirlediğiniz hesapla oturum açın.

Sunucuya SSH erişiminiz varsa şema ve örnek içeriği komut satırından da kurabilirsiniz: php bin/console fresh. Sihirbaz bunu zaten yaptığı için normal kurulumda gerekmez.

Lisans ve alan adı#

Lisans anahtarınızı müşteri panelinizden alırsınız. Biçimi SH-XXXX-XXXX-XXXX-XXXX şeklindedir.

• Lisans alan adına bağlanır. Anahtar, ilk kurulumda hangi alan adında çalıştırılırsa o alan adına otomatik bağlanır.
• Alan adı değiştirebilirsiniz. Müşteri panelinizden ya da destek üzerinden alan adı değişikliği yapılabilir.
• Panelden durum görürsünüz. Yönetim → Lisans ekranı lisansın durumunu, bağlı alan adını ve destek bitiş tarihini gösterir; “yenile” ile sunucuya yeniden sorar.
• Süresiz kullanım. Yazılımı kullanma hakkı süresizdir; yıllık yenilenen şey güncelleme ve destek hakkıdır.

İlk yarım saat#

Kurulumdan hemen sonra şu sırayı izlerseniz site yayına hazır hâle gelir. Sıra önemlidir: içerik girmeden önce kimlik ve iletişim bilgilerini tanımlayın.

1. Ayarlar → Firma bilgileri ve iletişim
2. Şubeler ve Teknisyenler
3. Hizmetler
4. Stok & Parçalar (kritik stok eşikleriyle)
5. E-posta Şablonları → talep alındı / durum değişti
6. Örnek (demo) içeriği gözden geçirin: kullanacaklarınızı düzenleyin, gerisini silin.

Yönetim paneli haritası#

Yönetim paneli 4 grupta 32 ekrandan oluşur. Aşağıdaki liste panelin sol menüsünün birebir karşılığıdır: kurulumdan sonra göreceğiniz şey budur.

Menü yetkiye duyarlıdır: bir role kapalı olan ekran o kullanıcının menüsünde hiç görünmez. Yukarıdaki liste tam yetkili yöneticinin gördüğüdür.

Günlük kullanım#

Yazılımın günlük akışı aşağıdaki gibidir. Adımlar sırayla ilerler; ilk kurulumda da bu sırayı izlemek en hızlısıdır.

1. 1
   Kurulumu yapın

   Şubeler, Teknisyenler ve Stok & Parçalar ekranlarını doldurun. Hizmetler ekranı talep formundaki seçenekleri besler.

2. 2
   İşi panodan yürütün

   Servis Panosu iş emirlerini durum sütunlarında gösterir (yeni → randevu → atandı → işlemde → parça bekliyor → test → tamamlandı → teslim). Kart üzerinden durum ilerletilir; söz verilen tarihi geçen işler vurgulanır. Şube ve teknisyene göre süzülür.

3. 3
   Parçayı iş emrine yazın

   İş emri detayından kullanılan parçayı eklersiniz; stok o anda düşer, satırı silerseniz geri eklenir. Stok yetersizse işlem reddedilir. Kritik stoğun altına düşen parçalar liste başında uyarı olarak görünür.

4. 4
   Teklif verin

   Fiyat Teklifleri ekranında kalemleri parça kataloğundan seçerek teklif hazırlarsınız; KDV ve geçerlilik tarihi ile birlikte yazdırılabilir çıktı alınır. Teklif kabul edilince tek tıkla iş emrine dönüşür.

5. 5
   Parayı takip edin

   İş emri tamamlandığında tutar (işçilik + parça) müşterinin carisine borç olarak işlenir; tahsilatı alacak kaydı olarak girersiniz. Cari Hesaplar ekranında bakiye ve hareket dökümü durur.

6. 6
   Garantiyi ve performansı izleyin

   Garanti Takibi ekranı bu ay ve gelecek ay garantisi dolacak işleri listeler; aynı cihaz için garantisi süren bir iş varsa yeni talep açarken uyarı çıkar. Raporlar ekranı teknisyen performansı, en çok kullanılan parçalar, şube kırılımı ve geliri verir.

Ziyaretçinin gördüğü sayfalar#

Ziyaretçinin göreceği sayfalar ve adresleri. Bu adresler sabittir; menüyü değiştirmek adresleri değiştirmez.

Bu sayfaların tamamını canlı demoda gezebilirsiniz; demo, satın aldığınızda kurulacak yazılımın kendisidir.

İçerik ve SEO#

Kurumsal içerik ekranları bütün missweb.com yazılımlarında aynıdır: Sayfalar, Blog, Menüler, SSS, Referanslar, Ekip, Galeri ve Medya.

• Sayfalar: Hakkımızda, politikalar gibi statik içerikler. Her sayfanın kendi başlık/açıklama (SEO) alanı vardır.
• Menüler: üst menünün sırası buradan yönetilir. Yeni bir sayfa eklemek menüyü kendiliğinden değiştirmez; menüye siz eklersiniz.
• Medya: yüklediğiniz tüm görsellerin ortak kütüphanesi; her yükleme alanından buraya erişebilirsiniz.
• Hızlı İndeksleme: yeni ve güncellenen adresleri arama motorlarına IndexNow protokolüyle bildirir. Kurulum sınamasını bir kez çalıştırıp anahtarınızı doğrulayın.
• Site haritası: /sitemap.xml otomatik üretilir; Google Search Console'a bu adresi tanıtın.

E-posta bildirimleri#

Bildirim e-postaları (form bildirimi, durum değişikliği) sunucunun kendi posta işleviyle gönderilir; ayrı bir SMTP ekranı yoktur. Metinleri Yönetim → E-posta Şablonları ekranından düzenlersiniz.

• Gönderen adresi Ayarlar ekranındaki firma e-postasıdır; alan adınıza ait bir adres kullanın (gmail gibi bir adres gönderen olarak kullanılırsa postalar engellenir).
• Alan adınızın SPF kaydı yoksa postalar spam'e düşebilir: hosting firmanızdan kayıtları eklemesini isteyin.
• Kurulumdan sonra bir deneme formu doldurup postanın ulaştığını doğrulayın.

Kullanıcılar ve roller#

Panele birden çok kişi erişecekse her birine kendi hesabını açın; hesap paylaşmayın. Kim ne yaptı sorusunun cevabı buna bağlıdır.

• Kullanıcılar: hesap açma, şifre sıfırlama, hesabı devre dışı bırakma.
• Roller: her rol hangi ekranlara erişeceğini belirler; yetkisi olmayan ekran menüde hiç görünmez.
• Aktivite Kayıtları: hangi kullanıcının neyi ne zaman değiştirdiğini gösterir. Bir kaydın kaybolduğunu düşündüğünüzde ilk bakılacak yer burasıdır.

Görünüm ve özel kod#

Yönetim → Görünüm ekranı Özel CSS, Özel JavaScript ve Head/Footer kodu alanlarını içerir. Etiketleri (<style>, <script>) yazmanıza gerek yoktur; alanlar bunları kendisi ekler.

• Head kodu: Google Analytics, Search Console doğrulaması, piksel kodları.
• Özel CSS: renk, boşluk ve köşe ayarları. Tema dosyasını elle düzenlemeyin; güncellemede değişir ve değişiklikleriniz kaybolur. Özel CSS bir ayardır, güncellemelerden etkilenmez.
• Dikkat: display:none ile bölüm gizlemek içeriği sayfada bırakır (arama motorları ve ekran okuyucular okumaya devam eder). Bir bölümü kapatmak istiyorsanız ilgili ekrandan pasife alın.

Yedekleme#

Yönetim → Yedekleme ekranı veritabanınızın tam bir kopyasını .sql dosyası olarak indirir. Ekran ayrıca tablo ve kayıt sayılarını gösterir.

• İki parça vardır: veritabanı ve public/uploads/ klasörü (görseller). Yalnız veritabanını yedeklemek yetmez.
• Büyük değişiklikten önce yedek alın: toplu silme, içe aktarma ve güncelleme öncesi.
• Yedeği sunucu dışında saklayın. Sunucu kaybedilirse üzerindeki yedek de kaybolur.

Güncelleme#

Yönetim → Güncellemeler ekranı yeni sürüm olup olmadığını lisans sunucusuna sorar. Varsa tek tıkla indirilir, dosyalar değiştirilir ve veritabanı göçleri çalışır.

1. Önce yedek alın. Güncelleme dosyaları değiştirir; geri dönüş yolunuz yedektir.
2. Güncelle deyin. Paket indirilir, sağlaması (SHA-256) doğrulanır, site kısa süre bakıma alınır ve dosyalar değiştirilir.
3. Kontrol edin. Vitrini ve paneli açıp birkaç ekranı gezin.

• Ayarlarınız korunur: özel CSS, e-posta şablonları, içerik ve ayarlar veritabanındadır.
• Dosyada yaptığınız elle değişiklikler kaybolur. Özelleştirmeyi panel alanlarından yapın.
• Güncelleme hakkınızın süresi Lisans ekranında yazar; süre dolduğunda yazılım çalışmaya devam eder, yalnız yeni sürümleri alamazsınız.

Sorun giderme#

Sık sorulan sorular#

Destek#