KayıpQR — Gizlilik Odaklı Akıllı QR Etiket Platformu
Eşyan sana dönsün, numaran sende kalsın. Kişisel telefon numarası veya e-posta paylaşmadan, dinamik QR etiketleri üzerinden üyeliksiz anonim mesajlaşma sağlayan uçtan uca platform.
Proje Genel Bakış
Anahtarlık, çanta, bilgisayar veya evcil hayvan tasması gibi eşyalara telefon numarası yazmanın yarattığı gizlilik riskini ortadan kaldırmak için tasarlandı. Eşya sahibi KayıpQR stüdyosunda kendi QR etiketini tasarlayıp bastırır; eşyayı bulan kişi ise uygulama indirmeden ve üye olmadan QR kodu taratıp doğrudan güvenli web sohbeti başlatır. Harici Redis veya S3 bağımlılığına ihtiyaç duymadan; sıkıştırılmış WebP görsellerini, istek hız sınırlarını ve e-posta gönderim kuyruğunu (SQL Outbox) doğrudan PostgreSQL üzerinde yöneten yalın ve üretime hazır bir mimariye sahiptir.
Mimari & Çalışma Mantığı
Dinamik Etiket & Durum Yönetimi: Eşya sahibi 'Güvende', 'Kayıp' veya 'Teslim Alındı' durumlarını ve etiket görünürlüğünü, basılı QR kodun bağlantısını hiç değiştirmeden panelden anlık günceller.
Üyeliksiz Bulan Kişi Oturumu: QR taratıldığında bulan kişi hesap açmadan fotoğraf, isteğe bağlı konum ve ilk mesajını bırakır; özel oturum bağlantısıyla eşya sahibiyle güvenli sohbet sürdürür.
Görünür Sekme Polling & WebSocket Desteği: Sohbet ekranı açık sekmede akıllı artımlı sorgulama (veya kalıcı sunucuda WebSocket) ile okundu bilgisi ve süresi yenilenen imzalı medya bağlantılarını senkronize eder.
SQL Outbox & Anti-Spam Bildirim Hattı: İlk mesajda Resend üzerinden giden e-posta bildirimleri SQL outbox kuyruğuyla güvenceye alınır; IP/alıcı bazlı oran sınırlama (15 dk'da 1, 24 saatte maks. 10) kötüye kullanımı engeller.
Temel Özellikler
Kullanılan Teknolojiler
Projenin tüm kaynak kodlarını, Docker kurulumunu, sistem mimarisi şemalarını ve API dokümantasyonunu GitHub deposunda inceleyebilirsiniz.
GitHub'da Aç