Piton Studios
Piton Studios
[36]

Ödeme Takip Botu

2025
[ VİDEO · PROJE ]
Müşteri
Piton Studios
Yıl
2025
Kapsam
Automation, backend, Telegram integration
Rol
Development
§ Proje Detayı

Ödeme Takip Botu — Vade tarihi yaklaşınca Telegram'dan otomatik hatırlatan ödeme takip uygulaması.

Şirket ödemelerini (kredi kartı/taksitli, çek, elden ve diğer) takip eden; vade tarihi yaklaşınca Telegram üzerinden otomatik hatırlatma gönderen bir web uygulaması geliştirdik. Node.js, Express ve SQLite üzerine kurulu hafif ama güvenilir bir altyapı kullandık.

Taksitli ödemelerde otomatik vade üretimi, geciken ve önümüzdeki 7 gün için özet panel, ödenmiş kayıtlar için finansal bütünlük koruması gibi özelliklerle iş süreçlerini otomatikleştirmenin somut bir örneğini ortaya koyduk.

Node.jsTelegram BotAutomationFintech

Problem

Şirket, kredi kartı taksiti, çek, elden ödeme ve diğer ödeme türlerini elle takip ediyordu; vade tarihleri unutulduğunda gecikme riski doğuyordu, ödemeler farklı kişilerde farklı defter/tablo düzeninde tutuluyordu. İhtiyaç, tek bir sunucuda çalışabilecek, ayrı bir sunucu ekibi ya da karmaşık altyapı gerektirmeyen; buna karşılık vade takibini otomatikleştirip ilgilileri zamanında uyaracak hafif ama güvenilir bir sistemdi. Ayrıca ödenmiş kayıtların düzenleme sırasında yanlışlıkla bozulmaması ve dönem sonu raporlarının Türkçe karakterlerle sorunsuz şekilde dışa aktarılabilmesi gerekiyordu.

Çözüm

Node.js, Express ve EJS ile sunucu tarafında render edilen, better-sqlite3 üzerinde tek dosyalı bir SQLite veritabanı kullanan bir web uygulaması geliştirdik. Taksitli ödemelerde ilk vade tarihinden itibaren ay bazlı taksit planı otomatik hesaplanıyor (ay sonu taşmaları dahil); tutarlar kuruş farkı kalmayacak şekilde son taksitte dengeleniyor. node-cron ile her gün 09:00'da vade kontrolü, 08:00'de günlük özet ve Pazartesi 08:15'te haftalık plan mesajı Telegram Bot API üzerinden gönderiliyor; aynı vade için aynı hatırlatmanın tekrar gitmemesi bir bildirim log tablosuyla garanti ediliyor. Kimlik doğrulama bcrypt ile parola hash'leyip dosya tabanlı oturum deposunda (session-file-store) tutuluyor, böylece sunucu yeniden başlasa da oturumlar korunuyor. Ödemeler sayfasında filtrelerle uyumlu, UTF-8 BOM'lu noktalı virgülle ayrılmış CSV dışa aktarım var. Arayüz Tailwind CSS ile derlenip CDN bağımlılığı olmadan sunuluyor.

Öne çıkan teknik kararlar

  • Taksit planı otomasyonu: ilk vade tarihinden başlayarak ay bazlı taksitler otomatik üretiliyor, ay sonu taşmaları düzeltiliyor ve kuruş farkı son taksitte dengeleniyor.
  • Telegram Bot API üzerinden üç ayrı otomasyon: tekil vade hatırlatma (gün öncesi ayarlanabilir), günlük özet (08:00) ve haftalık plan (Pazartesi 08:15) — node-cron ile zamanlanıyor.
  • Bildirim log tablosu (installment_id + window_days üzerinde tekillik kısıtı) aynı hatırlatmanın birden fazla gönderilmesini engelliyor.
  • Ödeme düzenlenirken, kaydın ödenmiş taksidi varsa vade planı yeniden oluşturulmuyor — ödeme geçmişi korunuyor.
  • UTF-8 BOM'lu, noktalı virgülle ayrılmış CSV dışa aktarım, filtrelerle uyumlu ve Türkçe karakterleri doğrudan Excel'de gösteriyor.

Kullanılan teknolojiler

Node.jsExpressEJSbetter-sqlite3node-cronTelegram Bot APITailwind CSSbcrypt

Sonuç

Şirket artık tüm ödeme türlerini tek panelden takip edebiliyor ve vade tarihlerini elle hatırlamak zorunda kalmıyor; Telegram üzerinden gelen otomatik hatırlatmalar ve günlük/haftalık özetlerle gecikme riski azaldı. Ödenmiş kayıtlar düzenleme sırasında korunduğu için finansal geçmiş güvenilir kalıyor, dönem sonu raporlama filtrelerle uyumlu CSV dışa aktarımla hızlanıyor ve oturumlar sunucu yeniden başlasa da kesintiye uğramıyor.

İlgili çözümler