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.
- Servisi başlatın:
scripts/start.sh— uygulama dinlemeye başlar. - Tarayıcıda açın: adres çubuğuna
http://localhost:8021yazın (prod ortamda atanan port bu olabilir; port Kurulum belgesinde sabittir). - 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
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
- İlk müşteriyi ekleyin: solda Yeni müşteri → İsim (zorunlu) + dilediğinizce Firma / Telefon / E-posta → Kaydet.
- 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.
- Sayaçları izleyin: üstteki sayaç bandı her işlemden sonra kendiliğinden güncellenir.
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?
| Şart | Açıklama |
|---|---|
| Durum = Açık | Görevin durumu hâlâ “Açık” olmalı; “Tamamlandı” olanlar sayılmaz. |
| Vade < bugün | Vade 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 filtresi | Listeyi tek bir firmayla sınırlar; varsayılanı “Tümü”. |
| Yeni müşteri | Sağ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
- Yeni müşteri butonuna tıklayın (sol üstte).
- İsim alanını doldurun (zorunlu).
- Firma, Telefon ve E-posta alanlarını dilediğinizce doldurun.
- Kaydet’e basın. Kayıt listeye eklenir ve sayaçlar güncellenir.
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.
- Listeden bir müşteri seçin.
- Sağdaki formda değiştirmek istediğiniz alanları güncelleyin.
- Güncelle ile kaydedin ya da İptal ile yeni müşteri formuna dönün.
- Sil, müşteriyi (onay penceresiyle) kalıcı siler; bağlı görevleri de silinir.
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.
- Seçili müşteride Not butonuna tıklayın; başlığı “Not” olan pencere açılır.
- Not içeriği alanına metin yazın (ör. görüşme özeti, karar, sonraki adım).
- 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 filtresi | Gö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:
Görev ekleme
- Görevleri eklemek istediğiniz müşteriyi listeden seçin (veya “Tümü”deyken formda müşteri seçin).
- Yeni görev formunda Müşteri (zorunlu), Başlık (zorunlu) ve Vade (zorunlu) alanlarını doldurun.
- Durum varsayılan olarak Açık gelir; dileriniz Tamamlandı yapabilirsiniz.
- Kaydet ile görevi ekleyin.
Görev düzenleme ve silme
- 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.
- Alanları değiştirdikten sonra Güncelle ile kaydedin; İptal ile yeni görev formuna dönün.
- çöp kutusu (Sil) simgesi görevi onay penceresiyle kalıcı siler.
Gecikme kuralı
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üm | SHA | Tarih | İç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. |
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?
Yeni sürümler eklendikçe bu tablo güncellenir.