Puantaj & Devam Modülü

Çift görünümün “ne yapar” tarafı. “Nasıl yapılır” için → modul-puantaj-islemler.md. Ayarlar (tolerans, otomatik çıkış, fazla mesai) → modul-ayarlar-puantaj-devam.md. Dil: TR. Kanıt: Ekrandaki etiket/buton — kod adı yok.

---

1. Puantaj modülü neyi yapar?

Çalışanların giriş-çıkış (yoklama) kayıtlarını tutar, geç/erken/fazla-mesai sapmalarını işaretler ve ayı aylık puantaj özetine dönüştürür. Bu özet, SGK prim günü ve bordro için temeldir. Akış: giriş-çıkış → günlük kayıt + sapma → aylık özet → puantajı kapat (SGK) → bordro.

Kim kullanır: Çalışan (kendi giriş-çıkışı), HR (yönetim + kapatma), Yönetici (timesheet onayı).

Nerede: Sol menü → İK Yönetimi → Puantaj Yönetimi (+ çalışan için Devam / giriş-çıkış).

---

2. Çalışan: giriş-çıkış (self-servis)

[QA-SS bekliyor: çalışan giriş-çıkış ekranı — kendi worker kaydı + yoklama verisi olan kullanıcıyla çekilecek]

Çalışan büyük saat ekranından Giriş yap / Çıkış yap yapar. Sistem konum (GPS) algılar (ayara göre zorunlu olabilir), isteğe bağlı not eklenir. Altta Puantaj Kayıtları tablosu (Tarih, Giriş, Çıkış, Normal Saat, Fazla Mesai, Toplam Saat, Durum) ve Düzeltme Talep Et butonu bulunur. Tablo/Takvim görünümü seçilebilir.

Durum rozetleri: Mevcut · Devamsız · Geç · İzinli · Tatil · Uzaktan.

---

3. HR: Puantaj Yönetimi (günlük kayıtlar)

Nerede: Puantaj Yönetimi.

Günlük devam kayıtları: Planlanan Vardiya vs gerçek Giriş/Çıkış, Normal/Fazla Mesai/Toplam saat, Sapma (Geç X dk / Erken Çıkış / ✓). Özet kartları: Bugün Mevcut · Geç Gelenler · Toplam Fazla Mesai · Ort. Çalışma Saati. İsim/durum filtresi.

---

4. Aylık Puantaj Özeti (SGK için kapatma)

Nerede: Puantaj Yönetimi → Aylık Puantaj Özeti.

Dönem (yıl/ay/şirket/departman) seçilir; tablo her çalışan için ay toplamlarını gösterir:

Sütun	Anlamı
Sicil No / Ad Soyad / Departman	Çalışan (kısmi ayda “Kıst” rozeti)
SGK Gün	SGK prim günü (kritik — bordro/SGK için)
Çalışma	Fiilen çalışılan gün
Devamsız	Devamsızlık (kırmızı)
Ücretli / Ücretsiz	İzin günleri
Mesai	Fazla mesai saati
Geç	Geç gelme sayısı
Detay	Günlük puantaj takvimi (gün-gün durum)

Durum: Taslak → Kapatıldı → Kilitli. İşlemler:

• Puantaj Onayla → ayı kapatır: tüm ayın verisinden snapshot oluşturur, kilitler, bordro/SGK için kullanıma hazırlar. (Onay: “Bordro hesaplamalarında bu veriler kullanılacaktır.”)
• Kilidi Aç (yalnız Owner) → Taslak’a döndürür ama ilgili bordro verileri geçersiz işaretlenir.
• Dışa Aktar → CSV (puantaj_YYYY_MM.csv).

Puantaja Dahil: Bir çalışan “Puantaja Dahil” değilse (çalışan kaydındaki anahtar) bu özette görünmez ve SGK gününe girmez (modul-ozluk.md).

---

5. Düzeltme & Mazeret (corrections)

Nerede: Puantaj → Düzeltmeler.

Çalışanın giriş-çıkış düzeltme talepleri burada HR tarafından incelenir: orijinal vs düzeltilmiş giriş/çıkış görünür. Onayla (yorum opsiyonel) / Reddet (red nedeni zorunlu).

---

6. Zaman Çizelgesi (timesheet) onayı

Nerede: Zaman Çizelgesi Yönetimi (timesheets).

İki aşamalı onay: Yönetici İncelemesi → İK Onayı → Tamamlandı. Sekmeler (Yönetici Bekliyor / İK Bekliyor / Tümü), tekil + toplu onay/ret (red nedeni zorunlu), onay izleri (kim, ne zaman).

---

7. Önemli davranışlar (sık karışan)

• Puantajı kapatmak (Onayla) geri dönüşü zordur: Kilidi Aç bordroyu geçersiz kılar. Kapatmadan önce düzeltmeleri bitirin.
• SGK Gün ayın en kritik çıktısıdır — kısmi ay, izin, devamsızlık bunu etkiler.
• Tolerans ayarları (geç/erken/mesai) sapma etiketini belirler (modul-ayarlar-puantaj-devam.md).
• Otomatik çıkış: çıkış unutulursa ayardaki saatte kapanır.

---

8. İlgili kılavuzlar

• Nasıl yapılır: modul-puantaj-islemler.md
• Ayarlar: modul-ayarlar-puantaj-devam.md · Vardiya: modul-vardiya.md

---

QA — SS notu

Harness: scripts/scenarios/puantaj-vardiya-screenshots.spec.mjs → screenshots/puantaj/. Rol: HR/Owner (rekor demo tenant), salt-okuma (giriş-çıkış/kapatma tetiklemez). Veri yoksa boş-durum yapıyı belgeler.