Skip to content
View onerkoray's full-sized avatar
🎯
Focusing
🎯
Focusing

Block or report onerkoray

Block user

Prevent this user from interacting with your repositories and sending you notifications. Learn more about blocking users.

You must be logged in to block users.

Content in all repositories owned by your account will be closed.
Maximum 250 characters. Please don’t include any personal information such as legal names or email addresses. This note will only be visible to you.
Report abuse

Contact GitHub support about this user’s behavior. Learn more about reporting abuse.

Report abuse
onerkoray/README.md

Koray Öner

Türkiye'de maaş, vergi, SGK ve emeklilik hesaplarını yapan ücretsiz araçlar yazıyorum. Araçlar ve onları anlatan yazılar korayoner.dev üzerinde; hesap motoru ayrı bir paket olarak açık kaynak.

korayoner.dev · Hakkımda · In English · Yayınlar (DOI) · ORCID 0009-0005-8730-3577

Neden her rakamın bir testi var

Bir hesaplama aracındaki hata ses çıkarmaz. SGK tavanını ya da bir vergi dilimini yanlış girerseniz sayfa yine açılır, tablo yine düzgün görünür; yalnızca sonuç yanlıştır ve bunu kimse fark etmez.

Bu yüzden sitede her yasal parametrenin tek bir kaynağı var. Araçlardaki ve yazılardaki rakamlar o kaynaktan, motor üzerinden yeniden hesaplanıp testle sabitleniyor. Kanun değişip parametre güncellendiğinde eski rakamı taşıyan test kırılıyor, sayfa sessizce eskimiyor.

Bunu öğrenmenin bedeli de oldu: Eylül 2026'da testi olmayan 17 yazıya test yazdım, beşinde toplam altı yanlış ya da tutarsız rakam çıktı. O günden beri testi olmayan yazı yayına girmiyor.

Bir örnek: maaş neden Temmuz'da artıyor?

Brüt 60.000 TL, 2026, hiç zam yok. Net her ay aynı olmaz:

const Bordro = require("hesap-cekirdegi/bordro/motor.js");

Bordro.hesaplaYil(60000, 2026).aylar.map((a) => Math.round(a.net));
// [47357, 47357, 47357, 46657, 44807, 44807, 45133, 45650, 42640, 42640, 42640, 42640]
Ay Ne oluyor Net
Ocak – Mart Birikmiş matrah %15 diliminde 47.357 TL
Nisan Matrah 190.000 TL'yi geçiyor, ayın bir kısmı %20'den 46.657 TL
Mayıs – Haziran Tamamı %20 diliminde 44.807 TL
Temmuz Asgari ücret istisnası büyüyor (4.211 → 4.538 TL) 45.133 TL
Ağustos Matrah 400.000 TL'yi geçip %27'ye giriyor, ama istisna 5.615 TL'ye çıktığı için net yine artıyor 45.650 TL
Eylül – Aralık Tamamı %27 diliminde 42.640 TL

Yıllık toplam net 539.685 TL. Bordrosunda Eylül'de 3.000 TL düşüş gören biri için cevap bu tabloda; Maaşım neden düştü? yazısı aynı hesabı daha uzun anlatıyor.

Nasıl kurulu

  • Tek kaynak. Asgari ücret, SGK taban ve tavanı, vergi dilimleri, istisnalar: hepsi tek bir parametre dosyasında, resmî kaynağıyla. Aynı değerin ikinci bir kopyası CI'da kırmızı.
  • Motor ve test. Bordro, kıdem, emeklilik, rapor parası, kira geliri ve kredi hesapları bağımlılıksız JavaScript; aynı kod tarayıcıda ve Node.js'te çalışıyor.
  • Her değişiklikte iki yüzü aşkın kontrol. Mülga maddeye atıf, süresi geçmiş tarihli iddia, birbirine fazla benzeyen sayfa, bozuk yapısal veri: hepsi yayından önce yakalanıyor.
  • Statik site. Çatı (framework) yok, derleme adımı yok. Python ve Node üreteçleri sayfaları içerik manifestinden yazıyor.
  • Veri cihazdan çıkmıyor. Hesaplar tarayıcıda yapılıyor. Paylaşılabilir hesap bağlantısı girdiyi adresin # kısmında tutuyor; o kısım sunucuya da ölçüme de gitmiyor.
  • Düzeltmeler açık. Bulunan hatalar tarihiyle yayın ilkeleri sayfasındaki düzeltme günlüğüne yazılıyor.

Depolar

Depo Ne
hesap-cekirdegi Sitedeki araçların altında çalışan hesap motoru. npm'de, MIT lisanslı.
onerkoray.github.io korayoner.dev'in kaynağı: sayfalar, üreteçler, testler ve CI.
npm install hesap-cekirdegi
npm test --prefix node_modules/hesap-cekirdegi

Araçlardan birkaçı

Araç Sorduğu soru
Brüt Net Maaş 12 ayın neti, dilim geçişleri ve istisnayla
Bordro Denetimi Bordromdaki rakamlar doğru mu?
Ne Zaman Emekli Olurum? EYT, 1999–2008 ve 2008 sonrası; borçlanmanın etkisi
Kıdem ve İhbar Tazminatı Tavan ve damga vergisiyle
Rapor Parası Hastalık, iş kazası ve doğum raporunda SGK ödeneği
Dilim Kayması Vergi dilimleri enflasyonun gerisinde kalınca ne kadar fazla vergi ödüyorum?
Kira Geliri Vergisi İstisna, beyan sınırı, götürü ve gerçek gider
Engelli Araç ÖTV İstisnası Uygunluk, fiyat sınırı, yerli katkı, on yıl kuralı

Hepsi: korayoner.dev/araclar (60'tan fazla).

Son yazılar

Hepsi: korayoner.dev/makaleler

Yayımlanmış çalışmalar

Zenodo'da, açık erişimli, DOI'li:

Şu sıralar (Ekim 2026)

  • TÜİK enflasyonu açıkladığı saatte emekli ve memur zammı araçlarını kendiliğinden güncelleyen bir hat. Bugün araçlar açıklamadan birkaç saat sonra güncelleniyor; hedef yarım saat.
  • 2027'ye geçiş: asgari ücret ve vergi tarifesi açıklandığı gün bütün araçların aynı saatte 2027'ye geçmesi için prova.

In English

I build free calculators for Turkish payroll, income tax, social security and pensions, and write the articles that explain the rules behind them. The site is in Turkish; there is a short English overview.

Every legal parameter lives in a single source file, and every number in the tools and articles is recomputed by the engine and pinned by a test, so a rate that changes in law breaks a test instead of silently going stale. The engine is published as hesap-cekirdegi: dependency-free, no build step, MIT.

İletişim

Hata bildirimi, öneri ya da iş birliği için: iletisim@korayoner.dev

LinkedIn · X · YouTube · Substack · Medium · ORCID

Popular repositories Loading

  1. onerkoray.github.io onerkoray.github.io Public

    korayoner.dev'in kaynağı: Türkiye bordro, vergi, SGK ve emeklilik hesaplama araçları, yazılar, üreteçler ve testler.

    HTML

  2. onerkoray onerkoray Public

    GitHub profil README’si. Projeler ve araçlar: korayoner.dev

  3. hesap-cekirdegi hesap-cekirdegi Public

    Türkiye mevzuatına göre bordro, tazminat, emeklilik, kira geliri ve kredi hesap çekirdeği. Bağımlılıksız, testli, MIT. npm: hesap-cekirdegi

    JavaScript

  4. veri-korayoner veri-korayoner Public

    veri.korayoner.dev — uluslararası kurumların Türkiye verileri, kaynağıyla ve lisans kapısıyla

    Astro