Zaman takibi¶

Zaman takibi, çalışanların çalışma sürelerini bir zaman damgası saatiyle kaydetmelerini sağlar — doğrudan kasada, ek bir yazılıma gerek kalmadan. Çalışma süreleri, molalar ve fazla mesai otomatik olarak hesaplanır ve bordro muhasebesi için Excel dosyası olarak dışa aktarılabilir.

İşlev özeti¶

İşlev	Açıklama
Zaman damgası saati	Geliş, Mola, Mola bitişi, Gidiş — doğrudan POS içinde
Canlı genel bakış	Şu anda hangi çalışanlar giriş yapmış durumda?
Zaman raporları	Her çalışan için ayrı ayrı veya toplu genel bakış
Excel dışa aktarımı	Bordro muhasebesi için 2 sayfalı çalışma kitabı
Sonradan düzenleme	Yönetici zaman damgalarını düzeltebilir, ekleyebilir, silebilir
Otomatik yenileme	Durum güncellemesi her 30 saniyede bir

⏱️ Zaman damgası (POS)¶

Zaman damgası sayfasını açma¶

Kasada: Menü → Zaman takibi

Zaman damgası sayfası geçerli durumu ve dört eylem düğmesini gösterir:

POS — Zaman takibi zaman damgası

┌──────────────────────────────────────┐
│                                      │
│    Maria Schmidt                     │
│    ● Eingestempelt seit 08:00        │
│                                      │
│    Arbeitszeit heute: 4 Std. 30 Min. │
│    Pause heute:       0 Std. 45 Min. │
│                                      │
│    ┌──────────┐  ┌──────────┐       │
│    │ Kommen   │  │  Pause   │       │
│    │  (grün)  │  │ (orange) │       │
│    └──────────┘  └──────────┘       │
│    ┌──────────┐  ┌──────────┐       │
│    │ Zurück   │  │  Gehen   │       │
│    │  (blau)  │  │  (rot)   │       │
│    └──────────┘  └──────────┘       │
│                                      │
└──────────────────────────────────────┘

Zaman damgası eylemleri¶

Düğme	Renk	Açıklama	Kullanılabilir koşul
Geliş	Yeşil	İşe başlama — vardiya başlar	Giriş yapılmamış
Mola	Turuncu	Molaya başla	Giriş yapılmış, molada değil
Geri	Mavi	Molayı bitir, çalışmaya devam et	Molada
Gidiş	Kırmızı	İş bitişi — vardiyayı bitir	Giriş yapılmış, molada değil

Durum makinesi¶

Zaman takibi bir durum makinesi olarak çalışır — yalnızca geçerli geçişlere izin verilir:

                    ┌──────────┐
         ┌─────────│  Kommen  │─────────┐
         │         └──────────┘         │
         ▼                              ▼
  ┌──────────┐                   ┌──────────┐
  │  Pause   │◄─────────────────│  Zurück  │
  └──────────┘                   └──────────┘
         │                              │
         ▼                              ▼
  ┌──────────┐                   ┌──────────┐
  │  Zurück  │                   │  Gehen   │
  └──────────┘                   └──────────┘

Geçersiz eylemler otomatik olarak engellenir. Örnek: Çalışan molada iken „Gidiş" mümkün değildir — önce „Geri", sonra „Gidiş" tuşuna basın.

Geçerli durum	İzin verilen eylemler	İzin verilmeyen
Giriş yapılmamış	Geliş	Mola, Geri, Gidiş
Giriş yapılmış	Mola, Gidiş	Geliş, Geri
Molada	Geri	Geliş, Mola, Gidiş
Moladan sonra (geri)	Mola, Gidiş	Geliş, Geri

Tipik bir iş gününün akışı¶

08:00  → [Kommen]       Arbeit beginnt
         ● Status: Eingestempelt (grün)

12:00  → [Pause]        Mittagspause
         ● Status: In Pause (orange)

12:45  → [Zurück]       Weiter arbeiten
         ● Status: Eingestempelt (grün)

15:30  → [Pause]        Kurze Kaffeepause
         ● Status: In Pause (orange)

15:45  → [Zurück]       Weiter arbeiten
         ● Status: Eingestempelt (grün)

17:00  → [Gehen]        Feierabend
         ● Status: Nicht eingestempelt

Ergebnis:
  Arbeitszeit: 8 Std. 0 Min. (abzgl. 1 Std. Pause)
  Pausenzeit:  1 Std. 0 Min. (45 + 15 Min.)

Bir günde birden fazla mola¶

Çalışanlar istedikleri kadar mola verebilir — her mola ayrı ayrı kaydedilir:

Saat	Eylem	Çalışma süresi	Mola süresi
08:00	Geliş	0:00	0:00
10:00	Mola	2:00	0:00
10:15	Geri	2:00	0:15
12:00	Mola	3:45	0:15
12:45	Geri	3:45	1:00
17:00	Gidiş	8:00	1:00

Canlı genel bakış (Yönetici)¶

Şu anda kim çalışıyor?¶

Yönetici → Zaman takibi → „Canlı" sekmesi

Canlı görünüm hangi çalışanların giriş yaptığını gerçek zamanlı gösterir:

Durum	Ad	Geliş	Çalışma süresi	Mola
● Çalışıyor	Maria Schmidt	08:00	4:30	0:45
● Mola	Thomas Weber	09:00	2:45	—
● Çalışıyor	Lisa Müller	07:30	5:00	0:30

Durum göstergesi:

Sembol	Renk	Anlamı
●	Yeşil	Şu anda çalışıyor
●	Turuncu	Molada
—	Gri	Giriş yapılmamış

Görünüm her 30 saniyede bir otomatik olarak güncellenir. „Canlı" rozetindeki yanıp sönen bir animasyon, gerçek zamanlı güncellemeyi gösterir.

📊 Zaman raporları (Yönetici)¶

Yönetici → Zaman takibi → „Ayrı" veya „Toplam" sekmesi

Yönetici — Ayrı ve Toplam görünümlü zaman raporu

Ayrı rapor (Ayrıntı)¶

Bir veya tüm çalışanların günlük çalışma sürelerini gösterir:

Filtre: - Başlangıç / Bitiş: Zaman aralığı seçin - Çalışan: Tek çalışan veya „Tümü"

Ad	Tarih	Geliş	Gidiş	Mola (Dk)	Çalışma süresi (Dk)
Maria Schmidt	01.03.2026	08:00	17:00	45	495
Maria Schmidt	02.03.2026	09:00	14:00	0	300
Maria Schmidt	03.03.2026	08:00	18:00	45	555

Plan vs. Gerçekleşen

Ek olarak Vardiya planı modülü de etkinse, burada vardiya planındaki hedef vardiya süresiyle birlikte „Planlanan" sütunu görünür — doğrudan zaman damgası ile kaydedilen gerçekleşen sürelerin yanında.

Toplam rapor (Özet)¶

Çalışan başına aylık/dönemsel toplamları gösterir:

Çalışan	Çalışma saatleri	Mola saatleri	İş günleri
Maria Schmidt	168,50	16,50	22
Thomas Weber	152,00	15,00	20
Lisa Müller	135,75	13,50	18

Excel dışa aktarımı¶

Ayrıntılı bir tablo için „Excel dışa aktarımı" üzerine tıklayın:

Sayfa 1: „Genel Bakış"

Ad	Çalışma saatleri	Mola saatleri	İş günleri
Maria Schmidt	168,50	16,50	22
Thomas Weber	152,00	15,00	20

Sayfa 2: „Ayrıntılar"

Ad	Tarih	Başlangıç	Bitiş	Mola (Dk)	Çalışma süresi (Dk)
Maria Schmidt	01.03.2026	08:00	17:00	45	495
Maria Schmidt	02.03.2026	09:00	14:00	0	300

Excel formatı (XLSX) doğrudan yaygın bordro muhasebesi yazılımlarına aktarılabilir.

🔧 Zaman damgası saatlerini düzeltme¶

Bir çalışan zaman damgası basmayı unuttuysa veya yanlış bir saat kaydedildiyse:

Zaman damgasını düzenleme¶

Yönetici → Zaman takibi
Çalışanı ve ayı seçin
İlgili zaman damgası kaydına tıklayın
Saati, Türü veya Notu uyarlayın
Kaydedin — çalışma süresi otomatik olarak yeniden hesaplanır

Zaman damgası ekleme¶

Bir çalışan zaman damgası basmayı unuttuysa:

Yönetici bölümünde eksik zaman damgası kaydını manuel olarak ekleyin
Türü seçin (Geliş, Mola, Geri, Gidiş)
Saati girin
Kaydedin

Zaman damgasını silme¶

Bir zaman damgası kaydı hatalıysa:

Zaman damgası kaydını seçin
„Sil" üzerine tıklayın
Onaylayın — çalışma süresi otomatik olarak yeniden hesaplanır

Tüm düzeltmeler kayıt altına alınır — izlenebilirlik için.

🧮 Çalışma süresinin hesaplanması¶

DiKAS çalışma süresini aşağıdaki algoritmaya göre otomatik olarak hesaplar:

Temel kural¶

Arbeitszeit = (Gehen - Kommen) - Summe aller Pausen

İki molalı örnek¶

Kommen:     08:00
Pause 1:    10:00 - 10:15 (15 Min.)
Pause 2:    12:00 - 12:45 (45 Min.)
Gehen:      17:00

Bruttozeit: 17:00 - 08:00 = 9 Std. 0 Min.
Pausen:     15 + 45 = 60 Min.
Arbeitszeit: 9:00 - 1:00 = 8 Std. 0 Min.

Özel durumlar¶

Durum	Davranış
Gece yarısını aşan vardiya	örn. 22:00 ile 06:00 arası = 8 saat (doğru hesaplanır)
Mola bitirilmemiş	Açık mola sayılmaz (yalnızca „Geri" sonrası)
Gidiş yok	Çalışma süresi „Geliş"ten itibaren gerçek zamanlı hesaplanır
Günde birden fazla vardiya	Her vardiya (Geliş→Gidiş) ayrı ayrı sayılır ve toplanır
Yalnızca Geliş, Gidiş yok	Çalışma süresi devam eder (canlı göstergede görünür)

Aylık özet¶

Ayın sonunda günlük değerler toplanır:

März 2026 — Maria Schmidt:
  22 Arbeitstage
  168 Std. 30 Min. Arbeitszeit
   16 Std. 30 Min. Pausenzeit
    7 Std. 39 Min. Durchschnitt/Tag

Uygulama örnekleri¶

Vardiyalı çalışan restoran¶

Durum: Erken ve geç vardiyalı restoran, 8 çalışan.

Erken vardiya (Maria):

06:30  Kommen
10:30  Pause (Frühstück)
10:45  Zurück
14:30  Gehen
→ 7 Std. 45 Min. (15 Min. Pause)

Geç vardiya (Thomas):

14:00  Kommen
18:00  Pause
18:30  Zurück
22:30  Gehen
→ 8 Std. 0 Min. (30 Min. Pause)

Ay sonu: Yönetici → Zaman takibi → Excel dışa aktarımı → bordro bürosuna gönder.

Gece vardiyalı disko¶

Durum: Kulüp, çalışanlar gece yarısını aşarak çalışıyor.

20:00  Kommen
00:30  Pause
01:00  Zurück
04:00  Gehen
→ 7 Std. 30 Min. (30 Min. Pause)

DiKAS gece yarısını aşan vardiyaları doğru hesaplar — zaman damgaları saate göre sıralanır.

Kısa vardiyalı yardımcı¶

Durum: Öğrenci yardımcı, cumartesi günü 3 saat.

11:00  Kommen
14:00  Gehen
→ 3 Std. 0 Min. (keine Pause)

Çıkış damgası unutulması¶

Durum: Lisa çıkış damgası basmayı unutmuş.

Ertesi gün yönetici canlı görünümde görür: Lisa dünden beri 08:00'den itibaren „giriş yapmış" durumda
Yönetici → Zaman takibi → Lisa → Zaman damgası ekle:
Tür: Gidiş
Saat: 17:00 (tahmini iş bitişi)
Çalışma süresi geriye dönük olarak doğru hesaplanır

Teknik ayrıntılar¶

Veri yapısı¶

Her çalışan ve ay için bir TimeSheet belgesi mevcuttur (örn. ts_usr_001_202603):

Alan	Açıklama
UserId	Çalışan kimliği
Year / Month	Yıl ve ay
Stamps	Tüm zaman damgası kayıtlarının listesi
TotalWorkMinutes	Toplam çalışma süresi (ay)
TotalBreakMinutes	Toplam mola süresi (ay)
LastStampType	Son zaman damgası türü (durum göstergesi için)

Her zaman damgası kaydı şunları içerir:

Alan	Açıklama
Zaman noktası	Tarih ve saat (UTC)
Tür	0=Geliş, 1=Mola, 2=Geri, 3=Gidiş
Not	İsteğe bağlı yorum

API uç noktaları¶

Yöntem	Endpoint	Açıklama
POST	`/api/v1/time-tracking/stamp`	Zaman damgası basma
GET	`/api/v1/time-tracking/status/{userId}`	Durum sorgulama
GET	`/api/v1/time-tracking/active-workers`	Aktif çalışanlar
GET	`/api/v1/time-tracking/sheets/{userId}/{year}/{month}`	Aylık veriler
GET	`/api/v1/time-tracking/report`	Zaman raporu
GET	`/api/v1/time-tracking/report/excel`	Excel dışa aktarımı
PUT	`/api/v1/time-tracking/sheets/{id}/stamps/{index}`	Zaman damgasını düzenleme
DELETE	`/api/v1/time-tracking/sheets/{id}/stamps/{index}`	Zaman damgasını silme

Yapılandırma¶

Zaman takibi Yönetici → Ayarlar → İşletme altında etkinleştirilir.

Ayar	Açıklama
Zaman takibini etkinleştir	Modülü aç/kapat

Etkinleştirme sonrası POS menüsünde ve yönetici bölümünde „Zaman takibi" menü öğesi görünür.

Sık sorulan sorular¶

Bir çalışan aynı gün birden fazla vardiya çalışabilir mi? Evet. Her Geliş→Gidiş dizisi ayrı bir vardiya olarak sayılır ve çalışma süreleri toplanır.

Vardiya sırasında elektrik kesintisi olursa ne olur? Son zaman damgası korunur. Çalışan yeniden başlatma sonrası çıkış damgası basabilir veya yönetici kaydı sonradan düzeltebilir.

Çalışanlar kendi sürelerini görüntüleyebilir mi? Zaman damgası sayfası, giriş yapmış çalışana o günkü çalışma süresini ve geçerli durumunu gösterir. Ayrıntılı raporlar yalnızca yönetici bölümünde mevcuttur.

Zaman takibi Android tablette (MAUI uygulaması) de mevcut mu? Evet. Zaman damgası sayfası Android uygulamasında aynı şekilde çalışır — çevrimdışı modda da.

Sonraki adım¶

→ Muhasebe — DATEV, faturalar, ihtar yönetimi