Bordro Modülü

Çift görünümün “ne yapar” tarafı. “Nasıl yapılır” için → modul-bordro-islemler.md. Bordro parametreleri/ayarları (vergi/SGK/teşvik) → modul-ayarlar-bordro.md. Dil: TR. Kanıt: Ekrandaki etiket/buton — kod adı yok.

---

1. Bordro modülü neyi yapar?

Bir dönem (ay) için tüm çalışanların maaşını hesaplar, onay sürecinden geçirir ve çıktıları (pusula, banka EFT, muhasebe fişi, SGK/MUHSGK) üretir. Akış: hesapla → çarşafı incele → onay zinciri → öde → çıktılar.

Kim kullanır: HR (bordrocu) / Owner. Çalışanlar yalnız kendi pusulalarını görür (self-servis).

Nerede: Sol menü → Bordro & Finans → Bordro (Bordro Yönetimi). Alt sayfalar: İşlemler (çarşaf), Onay Akışı, Raporlar, Simülasyon, Ayarlar, Kişi detayı.

---

2. Bordro durum makinesi (5 aşama)

Her bordro kaydı şu durumlardan sırayla geçer (renkli rozet):

Durum (ekrandaki ad)	Anlamı
Taslak	Hesaplandı, henüz onaya gönderilmedi
Onay Bekliyor	Onay zincirinde bekliyor
Onaylandı	Onaylandı, işlenmeye hazır
İşlendi	Ödeme için işlendi
Ödendi	Ödeme tamamlandı
İptal	Reddedildi (gerekçeli) → düzeltme bekler

Geri alınabilirlik: Onaylı/İşlenmiş bordrolar Taslağa Geri Al ile geri çekilebilir (ama onay süreci sıfırlanır). Ödendi genelde tek yönlüdür.

---

3. Bordro Yönetimi (çarşaf)

Nerede: Bordro → Bordro Yönetimi.

• Dönem seçici (yıl/ay) + ileri/geri.
• Bordro Hesapla butonu → seçili dönem için tüm çalışanların taslak bordrosunu üretir.
• Çarşaf tablosu: Çalışan · Brüt · Kesinti · Net · Durum.
• Özet kartları: Toplam Çalışan · Brüt Toplam · Net Toplam · İşveren Maliyeti.
• Durum dağılımı + Kesinti dağılımı (SGK / Gelir Vergisi / Damga / Diğer) kartları.
• Toplu durum butonları: Onaya Gönder · Onayla · İşle · Ödendi İşaretle. Tehlikeli: Taslakları Sil · Taslağa Geri Al (onay ister).

---

4. Onay Akışı

Nerede: Bordro → Onay Akışı.

Bekleyen/onaylanan/iptal sekmeleri; tekil (Onayla/Reddet/İşle/Ödendi İşaretle) ve toplu (Toplu Onayla/Reddet) aksiyonlar. Reddetmede gerekçe zorunlu.

⚠️ Yeniden hesaplama uyarısı: Bir bordro, puantaj/maaş/ücretsiz izin değişikliği nedeniyle güncel değilse satırda “Yeniden hesaplama gerekli” rozeti çıkar. Onaya ilerletirken sistem uyarır; “Yine de ilerlet” seçilirse eski (yanlış olabilecek) tutarlarla devam edilir. Önce yeniden hesaplamak önerilir.

---

5. Kişi bazlı bordro detayı

Nerede: Çarşafta bir çalışana tıkla → Bordro Detayı (veya Bordro → kişi).

[QA-SS bekliyor: kişi bordro detayı — rekor demo tenant'ında bordro verisi yok; bordrolu bir tenant lokal olunca çekilecek]

Üstte özet: Brüt · Kesintiler · Net · İşveren Maliyeti (her birinin altında bileşim açıklaması). Kısmi ayda SGK Prim Günü ve Bordro Günü gösterilir. Sekmeler:

• Kazançlar: brüt maaş + ek ödemeler (harcırah vergi-muaf/tabi dahil), vergiye/SGK’ya tabi etiketleri.
• Kesintiler: Yasal (SGK İşçi, İşsizlik, Gelir Vergisi + asgari ücret istisnası + engellilik, Damga, BES) + Diğer (kredi/avans).
• Özet: brütten nete ödeme akışı + İşveren Maliyeti (SGK işveren + işsizlik − SGK İşveren Teşviki (5510/81-ı)); varsa Ar-Ge (5746) Teşviki kartı.
• Geçmiş: son 12 ay bordro kaydı.

Üstte Yazdır / PDF İndir (pusula).

---

6. Çıktılar & Raporlar

Nerede: Bordro → Raporlar.

Dönem seçip indirilebilen çıktılar: Aylık Bordro Özeti · Departman Analizi · Vergi Beyannamesi · SGK Bildirge · Banka EFT Dosyası · Toplu Bordro Fişi (PDF). Görünüm sekmeleri: Özet · Departmanlar · Vergi & SGK · Trendler.

Not: MUHSGK her SGK işyeri için ayrı üretilir (işyeri-bazlı). Raporlar ekranında henüz işyeri seçici yoktur (API-seviyesi yetenek; çoklu-işyeri ihtiyaç olunca seçici eklenir).

---

7. Simülasyon & Self-servis

• Maaş Simülasyonu (Bordro → Simülasyon): bir brüt tutar girip net/işveren maliyetini önceden görürsünüz (zam/işe alım planı). Simülasyon işyeri/sektör bağlamı taşımaz; teşvik varsayılan (%2) ile hesaplanır.
• Ücret Pusulalarım (çalışan self-servis, /payroll): çalışan kendi dönem pusulalarını (brüt/kesinti/net) görür ve PDF İndir ile alır.

---

8. Önemli davranışlar (sık karışan / kurumsal hafıza)

• Kümülatif gelir vergisi yalnız onaylanmış aylardan hesaplanır → önceki ayları onaylamadan ilerlerseniz kümülatif matrah eksik kalır (uyarı çıkar).
• Net iki anlamda: “ele geçen” (BES dahil) vs anlaşılan net (BES öncesi) — detayda ikisi de açıklanır.
• Net→Brüt (net anlaşmalı): net anlaşılan çalışanda brüt otomatik yükseltilir (gross-up); “brüt neden yüksek?” normaldir.
• Teşvik sektöre bağlı: İmalat işyeri %5, Diğer %2 (modul-ayarlar-bordro.md).
• Yeniden hesaplama gerekli rozetini görünce önce recalc et, sonra onayla.

---

9. İlgili kılavuzlar

• Nasıl yapılır (dönem bordrosu, onay, çıktılar): modul-bordro-islemler.md
• Bordro parametreleri (vergi/SGK/teşvik/BES): modul-ayarlar-bordro.md

---

QA — SS notu

Harness: scripts/scenarios/bordro-screenshots.spec.mjs → screenshots/bordro/. Rol: HR/Owner (rekor demo tenant), salt-okuma (hesaplama/onay tetiklemez). Çekilen (4 yapı SS, içerik-assert): yonetim (çarşaf) · onay · raporlar · simülasyon. rekor demo’da bordro verisi yok → kartlar/tablo boş-durum gösterir (yine de kontrolleri/5-durum yapısını belgeler). Bekleyen: kişi-bordro-detayı + self-servis pusula SS — bordro verisi olan bir tenant lokalde olunca çekilecek.