← Ana Sayfa

Kullanıcı · Kılavuzu

Demo CRM — uygulamanın ne işe yaradığı, nasıl başlatıldığı ve müşteri / görev / sayaç ekranlarının adım adım kullanımı.

Belge
KULLANICI KILAVUZU v1.2
Tarih
06.10.2026
Çalışan sürüm
cfceea7 (prod)
Durum
7. müşteri belgesi · statik HTML

01Amaç

Uygulama ne işe yarar?

Demo CRM, tek kullanıcıya ve yerel ortama hitap eden, tek sayfalık ve tamamen Türkçe bir müşteri takip uygulamasıdır. Müşterilerinizi bir adres defteri gibi tutar; her müşteriye görevler (ör. “Teklifi ilet”, “Arayıp teyit et”) atarsınız ve her görevin bir vadesi olur. Uygulama, vadesi geçmiş görevleri sizin yerinize işaretler.

Her şey tek bir çalışma sayfasında toplanmıştır: üstte sayaç bandı, solda müşteri listesi, sağda müşteri paneli ve görev paneli. Sekme değiştirmeye gerek yoktur; listeler arasında geçiş yaparak çalışırsınız.

Müşteri defteri

Adres defteri: arama, firma filtresi, ekleme, düzenleme, silme ve not.

Görev takibi

Müşteriye bağlı görevler: başlık, vade, durum ve gecikme işareti.

Sayaçlar

Toplam müşteri, gecikmiş görev ve bu ay eklenen müşteri — gözünüzün önünde.

Kim için?

Uygulama tek kullanıcı içindir; aynı anda birden fazla kişi çalıştırmak için tasarlanmamıştır. Kendi bilgisayarınızda (yerel) çalışır; internet bağlantısı ve dış servis gerektirmez (dış font/CDN kullanılmaz).

Kurulum ve teknik ayrıntılar için Kurulum belgesi, gereksinimler ve veri modeli için Gereksinim belgesi bakınız. Bu kılavuz yalnızca günlük kullanıma odaklıdır.

02Başlangıç

Uygulamayı açma

Uygulama servis betiğiyle başlatılır ve tarayıcıda açılır. Kurulum, betikler ve ortam ayrıntıları Kurulum belgesinde anlatılır; burada yalnızca ilk açılışı gösteriyoruz.

  1. Servisi başlatın: scripts/start.sh — uygulama dinlemeye başlar.
  2. Tarayıcıda açın: adres çubuğuna http://localhost:8021 yazın (prod ortamda atanan port bu olabilir; port Kurulum belgesinde sabittir).
  3. Sayfa yüklenince: üstte sayaç bandı, solda müşteri listesi, sağda boş çalışma paneli görünür. Veri yoksa listeler “Kayıt yok” yazar — hata değildir.

İlk bakışta sayfa düzeni

Üst şeritUygulama adı + ortam etiketi
Sayaç bandı3 kart: Toplam müşteri · Gecikmiş görev · Bu ay eklenen müşteri
Sol sütunMüşteri listesi (adres defteri): arama, firma filtresi, “Yeni müşteri”
Sağ sütunMüşteri paneli (profil + form) ve Görevler paneli

Bir müşteri seçtiğinizde sağ panel ve görev listesi otomatik olarak o müşteriye odaklanır; tüm işlemler bu odak üzerinden yapılır.

İlk 5 dakikada

  1. İlk müşteriyi ekleyin: solda Yeni müşteri → İsim (zorunlu) + dilediğinizce Firma / Telefon / E-posta → Kaydet.
  2. Müşteriye bir görev açın: o müşteriyi listeden seçin → sağda Görevler panelinde Yeni görev → Başlık + Vade → Kaydet.
  3. Sayaçları izleyin: üstteki sayaç bandı her işlemden sonra kendiliğinden güncellenir.
Not: İlk açılışta veritabanı boş olabilir; uygulama boş durumları “Kayıt yok” ile gösterir. İlk kaydınızı eklediğiniz anda sayaçlar ve listeler canlanır.

03Sayaçlar

Sayaç bandı

Sayfanın en üstündeki üç kart, portföyünüzün kısa bir özetini verir. Değerler her ekleme, düzenleme veya silme işleminden sonra otomatik yenilenir.

Toplam müşteri

Defterdeki tüm müşteri kayıtlarının sayısı.

Gecikmiş görev

Durumu “Açık” olan ve vadesi geçmiş görevlerin sayısı.

Bu ay eklenen müşteri

İçinde bulunulan ayda eklenen yeni müşteri sayısı.

“Gecikmiş” ne demektir?

ŞartAçıklama
Durum = AçıkGörevin durumu hâlâ “Açık” olmalı; “Tamamlandı” olanlar sayılmaz.
Vade < bugünVade tarihi bugünden önce olmalı. Bugün vadesi gelen açık görev gecikmiş sayılmaz.

Bu kural görev ekranındaki Gecikmiş rozetinde ve müşteri listesindeki kırmızı nokta işaretinde aynı şekilde uygulanır.

04Müşteri Ekranı

Liste (adres defteri)

Sol sütundaki Müşteriler paneli tüm kayıtları listeler. Üstündeki araçlarla daraltabilirsiniz.

AraçNeyi yapar
Arama kutusuİsim, firma, telefon veya e-posta içinde arama yapar (yazarken canlı filtreler).
Firma filtresiListeyi tek bir firmayla sınırlar; varsayılanı “Tümü”.
Yeni müşteriSağdaki müşteri formunu boş bir kayıt için açar.

Her satır müşterinin adını ve alt satırda Firma · Telefon bilgisini gösterir. Satırda adın yanında kırmızı nokta varsa o müşteriye ait gecikmiş bir açık görev vardır.

Müşteri ekleme

  1. Yeni müşteri butonuna tıklayın (sol üstte).
  2. İsim alanını doldurun (zorunlu).
  3. Firma, Telefon ve E-posta alanlarını dilediğinizce doldurun.
  4. Kaydet’e basın. Kayıt listeye eklenir ve sayaçlar güncellenir.
Zorunlu alan: Yalnızca İsim zorunludur. Diğer alanlar boş bırakılabilir.

Müşteri seçme ve düzenleme

Listeden bir müşteriyi seçtiğinizde sağdaki panel o müşteriye dolar: üstte profil (ad, firma, telefon, e-posta, not), altta doldurulmuş bir düzenleme formu görünür. Form başlığı “Müşteri — <isim>” olur ve buton Güncelle olarak değiştirilir.

  1. Listeden bir müşteri seçin.
  2. Sağdaki formda değiştirmek istediğiniz alanları güncelleyin.
  3. Güncelle ile kaydedin ya da İptal ile yeni müşteri formuna dönün.
  4. Sil, müşteriyi (onay penceresiyle) kalıcı siler; bağlı görevleri de silinir.
Silme geri alınamaz: Onay penceresinde “… müşterisi ve bağlı görevleri kalıcı olarak silinecek. Emin misiniz?” yazısı görünür.

Müşteri notu (Not popup’ı)

Seçili müşterinin profiline bir not eklemek için Not butonunu kullanın. Not, pencerenin (popup) içinde düzenlenir.

  1. Seçili müşteride Not butonuna tıklayın; başlığı “Not” olan pencere açılır.
  2. Not içeriği alanına metin yazın (ör. görüşme özeti, karar, sonraki adım).
  3. Kaydet ile notu kaydedin; Vazgeç ile pencereyi kapatın.

Not alanı isteğe bağlıdır ve en fazla 2000 karakter kabul eder; yazdıkça sağ altta “X / 2000” sayacı görünür. Kaydedilen not, profilin “Not” satırında listelenir. Pencereyi ayrıca Esc tuşu veya pencerenin dışına tıklayarak da kapatabilirsiniz.

05Görev Ekranı

Görev listesi ve filtreler

Sağ alttaki Görevler paneli görevleri listeler. Üstündeki iki araçla daraltılır.

AraçNeyi yapar
Müşteri filtresiGörevleri tek bir müşteriyle sınırlar; varsayılanı “Tümü”.
Yalnız gecikmişSadece gecikmiş (Açık + vadesi geçmiş) görevleri gösterir.

Soldan bir müşteri seçtiğinizde görev listesi otomatik olarak o müşteriye odaklanır ve panel başlığı “Görevler — <müşteri adı>” olur. Filtreyi “Tümü”ye alarak tüm müşteri görevlerini görebilirsiniz.

Görev satırı ne gösterir?

Her görev satırında:

BaşlıkGörevin adı (örn. “Teklifi ilet”)
Durum rozetiAçık veya Tamamlandı
Gecikme rozetiGecikmiş — yalnızca gecikmişse görünür
Alt bilgiMüşteri adı · vade (gg.aa.yyyy)
İşlem butonlarıDüzenle (kalem) · Sil (çöp kutusu)

Görev ekleme

  1. Görevleri eklemek istediğiniz müşteriyi listeden seçin (veya “Tümü”deyken formda müşteri seçin).
  2. Yeni görev formunda Müşteri (zorunlu), Başlık (zorunlu) ve Vade (zorunlu) alanlarını doldurun.
  3. Durum varsayılan olarak Açık gelir; dileriniz Tamamlandı yapabilirsiniz.
  4. Kaydet ile görevi ekleyin.
Zorunlu alanlar: Görev için Müşteri, Başlık ve Vade zorunludur. Müşteri seçilmeden kaydederseniz “Görev için geçerli bir müşteri seçin.” mesajı görünür.

Görev düzenleme ve silme

  1. Görev satırındaki kalem (Düzenle) simgesine tıklayın; form “Görev düzenle” başlığına ve Güncelle butonuna döner.
  2. Alanları değiştirdikten sonra Güncelle ile kaydedin; İptal ile yeni görev formuna dönün.
  3. çöp kutusu (Sil) simgesi görevi onay penceresiyle kalıcı siler.

Gecikme kuralı

Üründe geçerli kural: Bir görev Durum = Açık ve vadesi bugünden önce ise Gecikmiş kabul edilir. Bugün vadesi olan açık görev gecikmiş değildir. Görevi “Tamamlandı” yaptığınızda gecikme rozeti kalkar.

Vadeler ekranda gg.aa.yyyy biçiminde gösterilir (ör. 04.10.2026). Vade günü yerel saat üzerinden değerlendirilir.

06Sık Sorulan Sorular

Bir müşteri sildiğimde ne olur?

Müşteri Sil ile onaylandığında kalıcı olarak silinir ve ona bağlı tüm görevler de birlikte silinir. Onay penceresinde bu durum açıkça yazılıdır; silme işlemi geri alınamaz.

Not alanı zorunlu mu?

Hayır, müşteri notu isteğe bağlıdır. En fazla 2000 karakter yazabilirsiniz; boş bırakabilirsiniz. Notu düzenlemek için Not butonunu kullanın.

Gecikme rozeti neden bazı günlerde kalkıp bazılarında çıkıyor?

Çünkü gecikme her gün vadeye göre yeniden hesaplanır. Bir görev vadesi geçtiği gün “Gecikmiş” olur; “Tamamlandı” yaptığınızda veya vadesi gelecek bir tarihe çektiğinizde rozet kalkar. Bugün vadesi olan açık görev henüz gecikmiş sayılmaz.

Hata bandı çıkarsa ne yapmalıyım?

İşlem sırasında bir sorun olursa sayfanın üstünde turuncu bir hata bandı görünür ve sorunu kısa bir dille anlatır (ör. “Görev için geçerli bir müşteri seçin.”). Hata, yapılan kayıtların silindiği anlamına gelmez; işleminizi yeniden deneyebilirsiniz.

İnternet bağlantısı gerekir mi?

Hayır. Uygulama kendi bilgisayarınızda çalışır ve dış font/CDN kullanmaz; bağlantı yokken de arayüz aynı şekilde görünür. Veriler yerel bir veritabanında tutulur.

Bir müşteriye hızlıca takip görevi nasıl eklerim?

Listeden müşteriyi seçin; sağdaki Görevler paneli o müşteriye odaklanır. Yeni görev formunda müşteri otomatik o kişi olur; yalnızca Başlık ve Vade girip Kaydet edin.

07Sürüm Notları

Yayınlanan sürümler

Aşağıdaki tabloda yalnızca gerçek yayın kayıtları (git etiketleri) listelenir; uydurma bir sürüm numarası verilmez.

SürümSHATarihİçerik
v1.0.0 6f10004 30.09.2026 İlk kararlı prod teslimi: görev tablosunda vade gg.aa.yyyy gösterimi ve Türkçe karakterli bildirim dili; ortam kilit (lease) ve graceful-shutdown / hata testleri.
v1.1.0 c958364 02.10.2026 Arayüz yeniden tasarımı (UI v2): yerel Fira yazı tipi yığını, mavi vurgu paleti ve duyarlı yerleşim (telefon / tablet / masaüstü); tasarım sistemi (MASTER.md) üretime alındı.
v1.2.0 1a6cc84 04.10.2026 Müşteri ve görev arayüzünün yeni tasarıma uyumu ve not penceresi: müşteri notu artık bir pencerede düzenlenir.
Geliştirme cfceea7 06.10.2026 Görevler panelinde yeni görev kayıt ve düzenleme penceresi. Yeni kayıtta müşteri alanı, panelde seçili müşteri filtresiyle dolu açılır; filtre boşsa (Tümü) alan boş kalır. Üretim ortamında çalışmaktadır. Henüz etiketli bir yayın değildir, bu nedenle ayrı bir sürüm numarası verilmedi. Ürünün adı Demo CRM oldu.
Sürüm kaynağı: Tablo SCOPE.md — “Yayınlanan Sürümler” tablosu ve git etiketleriyle birebir tutarlıdır. cfceea7 etiketsiz bir geliştirme sürümü olduğu için numara değil, “geliştirme sürümü” olarak notlanır; 06.10.2026 itibarıyla üretim ortamında çalışmaktadır.

Kullanıcı için ne değişti?

v1.1.0Arayüz yeniden çizildi: yazı tipi, renkler ve yerleşim; davranış aynı kaldı
cfceea7Yeni görev penceresi: müşteri alanı, seçili müşteri filtresiyle hazır gelir; ürünün adı Demo CRM oldu
v1.2.0Görev ve müşteri alanları yeni tasarıma uyumlu; müşteri notu artık pencerede düzenlenir
v1.0.0Vade gösterimi gg.aa.yyyy; bildirim dili Türkçe karakter

Yeni sürümler eklendikçe bu tablo güncellenir.