Genel bakış

StaffTracker, sahadaki ve şubedeki personelin mesaisini uçtan uca yöneten bir sistem. Personel mobil uygulamadan QR ile giriş-çıkış yapar, konumu geofence sınırlarıyla kontrol edilir, yöneticiler canlı haritada kimin nerede olduğunu SignalR ile anlık görür.

Admin panelinde vardiya planları, izinler ve tatiller, aylık puantaj, denetim kayıtları, şube cirosu ve satış analizi, hızlı sipariş onayı, Migros satış aktarımı ve üretim modülleri yönetiliyor.

Öne çıkanlar

QR ile giriş-çıkış ve çalışma oturumları
Konum ve geofence sınır takibi, SignalR ile canlı varlık haritası
Vardiya ve vardiya planları, izin bakiyeleri, resmî tatiller
Aylık puantaj; Excel (ClosedXML) ve PDF (QuestPDF) çıktıları
HMAC imzalı özel bearer token, rol ve izin anahtarlarıyla yetkilendirme
Hızlı sipariş ve sipariş onayı, şube cirosu ve satış analizi
iOS'ta arka plan konum takibi ve çevrimdışı konum kuyruğu; Android'de açılışta yeniden başlayan ön plan konum servisi

Mimari

Mobil API ve MVC admin paneli aynı Core ve Infrastructure katmanlarını paylaşıyor. API sözleşmesi veya hata kodu değiştiğinde iOS ve Android güncellemeleri aynı iş paketinde yapılıyor; istemciler sabit hata kodlarına dayanıyor.

ClientsiOS · SwiftUIAndroid · ComposeAdmin panel · MVC
APIREST + SwaggerStaffPresenceHub (SignalR)Rate-limited auth
ApplicationMediatR handlersStable error codesPermission keys
PersistenceEF Core · SQL Server3 DbContextsDocker Compose

Mühendislik notları

Apple'ın Unlisted App Distribution yöntemiyle App Store'da yayınlandı; müşteri şirketlere kontrollü dağıtılıyor.
Mimari testler, izin attribute'u eksik bir admin endpoint'i olduğunda build'i kırıyor.
CI her push'ta derleyip testleri çalıştırıyor; üretim yığını Docker Compose ile AWS EC2 üzerinde çalışıyor.
iOS uygulaması mobil davranışın referansı; Android aynı ekran setini aynı sözleşmeyle izliyor.

Ekranlar

Ekran görüntüleri eklenecek