Payroll Engine
SQL Server üzerinde çalışan Türkiye özel sektör 4/a bordro hesaplama çekirdeği.
Proje hakkında
Payroll Engine, şirketlerin personel ve ödeme sistemlerinden alınan girdilerle bordro hesabı yapmak için geliştirilen bir veritabanı motorudur. Çalışan bağlamı, çalışma günleri, ödeme kalemleri ve önceki kümülatif değerler üzerinden net ücret, vergi, prim ve işveren maliyeti sonuçlarını üretir. Tek çalışan için veya toplu bordro isteğiyle kullanılabilir.
Motor Microsoft SQL Server (MSSQL) üzerinde T-SQL ile saklı yordamlar ve fonksiyonlarla çalışır. Hesap tarihinde geçerli kural seti, sigorta profili ve parametreler seçilir; eksik veya çelişkili girdiler hatayla reddedilir. Sonuçla birlikte hesap kimliği, uygulanan kurallar ve ara değerler saklanarak hesapların izlenebilmesi sağlanır.
Yapılandırma saklı yordamları (SP), taslak kural seti üzerinde yeni bordro parametreleri ve ödeme tanımları eklemeyi, mevcut kayıtları güncellemeyi ve sigorta primi oranlarını düzenlemeyi sağlar. Değişiklikler geçerlilik tarihleri ve yapılandırma kontrolleriyle doğrulanır; hazırlanan kural seti daha sonra yayımlanır.
Personel yönetimi, puantaj girişi, web arayüzü ve HTTP API bu çekirdeğin kapsamında değildir. Bu sistemlerle bağlantıyı çağıran şirketin adaptörü kurar. Entegrasyon TVP ve saklı yordam çağrılarıyla yapılır; sonuçlar JSON veya sonuç setleriyle alınır.
Şirket adaptörü motorun dışındadır; motor personel veya puantaj sistemi değildir. Brütten nete hesap doğrudan sonuç üretir. Netten brüte çözüm yalnız gerektiğinde aynı hesap çekirdeğini tekrar çağırır.
Uygulama akışı
- Çağıran sistem çalışan ve ödeme bilgilerini hazırlayıp tekil veya toplu hesap giriş noktasına gönderir.
- Motor girdileri doğrular, hesap tarihindeki tekil kural setini seçer ve bordroyu hesaplar. Standart 4/a temel ücret için netten brüte çözüm aynı çekirdeği tekrar kullanır.
- Hesap sonucu ve RunId döndürülür. Girdi / çıktı kayıtları, kural sürümleri ve hata bilgileri audit kayıtlarından izlenebilir; toplu işlemlerde çalışan bazlı sonuçlar alınır.
Özellikler ve teknolojiler
Mevcut özellikler
- Tarih bazlı kural, parametre ve sigorta profili seçimi
- Brütten nete bordro hesabı
- Standart 4/a temel ücret için netten brüte çözüm
- Tekil ve toplu hesap girişleri
- Toplu isteklerde idempotency ve satır bazlı hata sonucu
- Ödeme, kesinti, teşvik ve geçmiş dönem düzeltmeleri
- SP ile parametre ve ödeme tanımı ekleme / güncelleme
- Taslak kural setinde sigorta primi oranlarını düzenleme
- Kural seti yayınlama ve yapılandırma doğrulama
- JSON sonuçları, hesap kimliği ve audit kayıtları
- Hazırlık / capability kontrolleri ve personel maliyet projeksiyonu
Teknolojiler
- Microsoft SQL Server (MSSQL) · T-SQL
- Saklı yordamlar · fonksiyonlar · TVP
- DECIMAL tabanlı hesaplama · JSON çıktı
- SSDT / veritabanı projesi
- PowerShell build ve örnek çalıştırma betikleri
- Golden, integration, audit ve performans testleri