Python-Zeitzonen-Slot-Finder-Skript

#!/usr/bin/env python3 """Finden von Meeting-Zeitfenstern in Zeitzonen (Python 3.9+ Standardbibliothek: zoneinfo). Gegeben Teilnehmer mit IANA-Zeitzonen, Arbeitstagen und -zeiten (plus wie weit jeder bereit ist, vor oder nach der Arbeit zu dehnen), findet Meeting-Zeitfenster über einen Datumsbereich, bewertet sie nach Fairness und kann eine rotierende Serie auswählen, damit nicht immer dieselben Personen den frühen oder späten Anruf übernehmen. Jedes Zeitfenster wird in der lokalen Zeit jedes Teilnehmers an diesem Datum bewertet, sodass Sommerzeitübergänge innerhalb des Bereichs (Europa und die USA wechseln an verschiedenen Wochenenden) automatisch verarbeitet und gemeldet werden. Schmerzpunkte pro Teilnehmer und Meeting: 0 innerhalb der Arbeitszeiten, 2 pro Stunde innerhalb des Dehnungs-("Flex")-Fensters vor oder nach der Arbeit, nicht verfügbar darüber hinaus, an Nicht-Arbeitstagen oder während blockierter Zeit. Das Fehlen eines optionalen Teilnehmers zählt als 3 Schmerzpunkte für sie in der Rotationsbilanz. Verwendung: python3 slot_finder.py --team team.csv --start 2026-10-26 --end 2026-11-06 [--duration 60] [--step 30] [--blocked blocked.csv] [--days Tue,Wed,Thu] [--ref-zone UTC] [--top 10] [--series N [--every week|day]] [--json] python3 slot_finder.py --self-test team.csv Spalten: name, zone, work_start, work_end, days (Mon-Fri oder Sun-Thu oder Mon,Wed,Fri), flex_before, flex_after (Stunden, optional), required (yes/no, optional). work_end früher als work_start bedeutet eine Schicht, die über Mitternacht hinausgeht. blocked.csv Spalten: name, date (lokales Datum des Teilnehmers), start, end (leer = ganzer Tag), reason. Exit-Codes: 0 = Zeitfenster gefunden, 1 = kein Zeitfenster, an dem alle erforderlichen Teilnehmer teilnehmen können, 2 = ungültige Eingabe (unbekannte Zeitzone, ungültige Zeit, fehlende Datei oder Spalte). """ [Vollständiger Python-Quellcode hier wie im Original-Tweet]