Import der Arbeitszeiten

import { Tabs, TabItem } from ‘@astrojs/starlight/components’;

Dieser Import ermöglicht das Einspielen von Arbeitszeit-Einträgen sowie die optionale Erstellung von Produktivitätsdaten.

Daten für den Arbeitszeit-Import

Feld	Datentyp	Nicht NULL	Bemerkung
wkt_external_id	VARCHAR(32)		Externe ID: Eindeutiger Schlüssel für den Zeiteintrag
usr_external_id	VARCHAR(32)	✓	Externe ID des Benutzers
tcl_external_id	VARCHAR(32)	✓	Externe ID der Zeitklasse (z.B. ‘auto’)
ord_external_id	VARCHAR(32)		Externe ID des Auftrags (für Produktivität)
worktime_date	DATE	✓	Datum der Arbeitszeit
worktime_start	INTEGER	✓	Startzeit (Minuten seit Mitternacht)
worktime_pause	INTEGER		Pause in Minuten
worktime_end	INTEGER		Endzeit (Minuten seit Mitternacht)
worktime_duration	INTEGER		Dauer in Minuten
worktime_text	VARCHAR(255)		Text für den Arbeitszeit-Eintrag
productivity_text	VARCHAR(255)		Text für den Produktivitäts-Eintrag
storno	BOOLEAN	✓	Wenn `true`, wird dieser Eintrag als Storno behandelt

Arbeitszeit-Import: Sätze werden in die Tabelle t_worktime importiert, sofern:
- storno auf false steht.
- Die wkt_external_id noch nicht im System vorhanden ist (keine Updates möglich).
- Der Zeitraum für den Benutzer noch nicht final verbucht/abgerechnet ist.
Produktivität: Wenn eine ord_external_id geliefert wird, wird zusätzlich ein Eintrag in t_productivity erzeugt.
Fehlerprotokollierung: Sätze, die nicht importiert werden konnten (z.B. wegen Storno, fehlender ID oder bereits erfolgter Verbuchung), werden in der Tabelle i_worktime_not_imported zur Analyse gespeichert.

Inkrementeller Import (Delta): Bestehende Einträge mit der gleichen wkt_external_id werden nicht überschrieben. Änderungen müssen im Quellsystem vorgenommen werden oder durch Stornierung und Neuanlage erfolgen.
Storno-Logik: Sätze mit storno = true werden vom eigentlichen Import ausgeschlossen und nur protokolliert.
Dauer vs. Start/Ende: Das System nutzt vorrangig die gelieferte worktime_duration.