> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stampfactory.eu/llms.txt
> Use this file to discover all available pages before exploring further.

# Pausenberechnung

> So berechnet Stampfactory Pausen -- explizite Pausen, gesetzliche Mindestpausen und individuelle Schwellenwerte

## Übersicht

Stampfactory berechnet Pausen automatisch auf Basis der Stempelungen. Dabei werden drei Werte ermittelt:

| Wert                         | Beschreibung                                                             |
| ---------------------------- | ------------------------------------------------------------------------ |
| **Explizite Pause**          | Tatsächliche Unterbrechungen zwischen Aus- und Einstempelung             |
| **Gesetzliche Mindestpause** | Minimum nach ArbZG oder individueller Konfiguration im Arbeitszeitmodell |
| **Effektive Pause**          | Der höhere der beiden Werte -- wird für die Netto-Berechnung verwendet   |

<Info>
  **Netto-Arbeitszeit** = Brutto-Arbeitszeit - Effektive Pause
</Info>

## Berechnungsformel

```
Effektive Pause = max(Explizite Pause, Gesetzliche Mindestpause)
Netto-Arbeitszeit = Brutto-Arbeitszeit - Effektive Pause
```

## Explizite Pause

Die explizite Pause ergibt sich aus den Lücken zwischen aufeinanderfolgenden Ausstempelungen und Einstempelungen:

<Steps>
  <Step title="Stempelungen sammeln">
    Alle Ein-/Ausstempelungen des Tages werden zu Paaren gebildet (IN -> OUT).
  </Step>

  <Step title="Lücken berechnen">
    Zwischen jedem OUT und dem nächsten IN wird die Zeitdifferenz als Pause gewertet.
  </Step>

  <Step title="Summe bilden">
    Alle Lücken werden aufsummiert.
  </Step>
</Steps>

### Beispiel: Explizite Pause

| Stempelung | Typ         |
| ---------- | ----------- |
| 08:00      | Einstempeln |
| 12:00      | Ausstempeln |
| 12:20      | Einstempeln |
| 16:30      | Ausstempeln |

**Explizite Pause** = 12:20 - 12:00 = **20 Minuten**

## Ruhepausen nach ArbZG

<Note>
  Diese Einstellung finden Sie unter **Einstellungen > Arbeitszeit > Ruhepausen nach Arbeitszeitgesetz (ArbZG) § 4**.
</Note>

Wenn die Einstellung **Ruhepausen nach ArbZG § 4** aktiviert ist, gelten Arbeitsunterbrechungen unter 15 Minuten **nicht** als Pausen. Kurze Unterbrechungen (z.B. Rauchen, Toilette, kurzes Telefonat) werden stattdessen als Arbeitszeit gewertet.

### Beispiel: Mit und ohne ArbZG-Einstellung

Stempelungen eines Tages:

| Zeit  | Typ         | Lücke danach |
| ----- | ----------- | ------------ |
| 08:53 | Einstempeln |              |
| 14:15 | Ausstempeln | 6 Min.       |
| 14:21 | Einstempeln |              |
| 14:23 | Ausstempeln | 10 Min.      |
| 14:33 | Einstempeln |              |
| 16:26 | Ausstempeln | 0 Min.       |
| 16:26 | Einstempeln |              |
| 17:12 | Ausstempeln |              |

**Brutto-Arbeitszeit**: 8 Std. 2 Min.

<Tabs>
  <Tab title="Einstellung AUS">
    Alle Lücken zählen als Pause:

    * 6 Min. + 10 Min. + 0 Min. = **16 Min. explizite Pause**
    * Gesetzliche Mindestpause (>6h): **30 Min.**
    * Effektive Pause: max(16, 30) = **30 Min.**
    * **Netto-Arbeitszeit: 7 Std. 32 Min.**
  </Tab>

  <Tab title="Einstellung AN">
    Nur Lücken >= 15 Min. zählen als Pause:

    * 6 Min. (ignoriert) + 10 Min. (ignoriert) + 0 Min. (ignoriert) = **0 Min. explizite Pause**
    * Gesetzliche Mindestpause (>6h): **30 Min.**
    * Effektive Pause: max(0, 30) = **30 Min.**
    * **Netto-Arbeitszeit: 7 Std. 32 Min.**

    <Info>
      In diesem Beispiel macht die Einstellung keinen Unterschied, weil die gesetzliche Mindestpause ohnehin greift. Der Unterschied zeigt sich bei kürzeren Arbeitstagen -- siehe nächstes Beispiel.
    </Info>
  </Tab>
</Tabs>

### Beispiel: Wann die Einstellung einen Unterschied macht

Mitarbeitende arbeiten 5 Std. 50 Min. mit einer 8-minütigen Unterbrechung:

<Tabs>
  <Tab title="Einstellung AUS">
    * Explizite Pause: **8 Min.** (alle Lücken zählen)
    * Gesetzliche Mindestpause: **0 Min.** (unter 6 Std. netto)
    * Effektive Pause: **8 Min.**
    * **Netto-Arbeitszeit: 5 Std. 42 Min.**
  </Tab>

  <Tab title="Einstellung AN">
    * Explizite Pause: **0 Min.** (8 Min. \< 15 Min., wird ignoriert)
    * Gesetzliche Mindestpause: **0 Min.** (unter 6 Std.)
    * Effektive Pause: **0 Min.**
    * **Netto-Arbeitszeit: 5 Std. 50 Min.** (8 Min. mehr als ohne Einstellung)
  </Tab>
</Tabs>

## Gesetzliche Mindestpause (Standard)

Ohne individuelle Konfiguration im Arbeitszeitmodell gelten die Standardwerte nach deutschem Arbeitszeitgesetz (ArbZG § 4):

| Brutto-Arbeitszeit | Mindestpause |
| ------------------ | ------------ |
| bis 6 Stunden      | keine        |
| über 6 Stunden     | 30 Minuten   |
| über 9 Stunden     | 45 Minuten   |

## Individuelle Pausen-Schwellenwerte im Arbeitszeitmodell

<Info>
  Die Standardwerte (30 Min. ab 6h, 45 Min. ab 9h) können pro Arbeitszeitmodell und Wochentag individuell überschrieben werden.
</Info>

In den **Arbeitszeitmodell-Einstellungen** können pro Wochentag eigene Pausen-Schwellenwerte definiert werden. Diese ersetzen die gesetzlichen Standardwerte.

Jeder Schwellenwert besteht aus:

* **Schwelle**: Ab welcher Brutto-Arbeitszeit die Pause greift
* **Dauer**: Wie lange die Mindestpause sein muss

### Beispiel: Individuelle Schwellenwerte

Ein Arbeitszeitmodell definiert folgende Schwellenwerte für Montag:

| Schwelle    | Mindestpause |
| ----------- | ------------ |
| > 4 Stunden | 15 Minuten   |
| > 6 Stunden | 30 Minuten   |
| > 9 Stunden | 50 Minuten   |

Mitarbeitende mit diesem Arbeitszeitmodell erhalten:

* Bei 4,5 Std. Arbeit: **15 Min.** Mindestpause (statt 0 Min. ohne Konfiguration)
* Bei 7 Std. Arbeit: **30 Min.** Mindestpause (wie Standard)
* Bei 10 Std. Arbeit: **50 Min.** Mindestpause (statt 45 Min. Standard)

<Warning>
  Individuelle Schwellenwerte ersetzen die ArbZG-Standardwerte vollständig. Stellen Sie sicher, dass Ihre Konfiguration mindestens die gesetzlichen Anforderungen erfüllt.
</Warning>

### Wann die Schwellenwerte gelten

Es gilt immer der **höchste** Schwellenwert, der von der Brutto-Arbeitszeit überschritten wird. Die Reihenfolge ist aufsteigend nach Schwelle:

```
Brutto = 7 Std.

Schwellenwerte:
  > 4h -> 15 Min.   (7h > 4h -> trifft zu)
  > 6h -> 30 Min.   (7h > 6h -> trifft zu, überschreibt 15 Min.)
  > 9h -> 50 Min.   (7h < 9h -> trifft nicht zu)

Ergebnis: 30 Min. Mindestpause
```

## Zusammenfassung der Berechnungslogik

```
1. Explizite Pause berechnen:
   - Lücken zwischen OUT -> IN summieren
   - Falls "Ruhepausen nach ArbZG" aktiv: Lücken < 15 Min. ignorieren

2. Gesetzliche Mindestpause bestimmen:
   - Falls Arbeitszeitmodell eigene Schwellenwerte hat: diese verwenden
   - Sonst: ArbZG-Standard (>6h = 30 Min., >9h = 45 Min.)

3. Effektive Pause = max(Explizite Pause, Gesetzliche Mindestpause)

4. Netto-Arbeitszeit = Brutto-Arbeitszeit - Effektive Pause
```