Add README.md

README.md

@@ -0,0 +1,71 @@
+# Zeitmanagement und Skalierbarkeit
+
+## Überblick
+Das Experiment **time_management_and_scalability** untersucht die Auswirkungen von Zeitumstellungen auf die Kapazität und Effizienz von Workern in einem System unter besonderen Bedingungen. Der Fokus liegt auf der Analyse zeitbezogener Inkonsistenzen und deren Einfluss auf die Systemstabilität.
+
+**Hinweis:**
+Alle Inhalte wurden per KI generiert. Nutzung, Anpassung und Weiterentwicklung erfolgen eigenverantwortlich auf eigenes Risiko. Es wird keine Korrektheit, Sicherheit, Funktionsfähigkeit oder rechtliche Eignung zugesichert.
+
+**Artikel:** [https://donau2space.de/tag-192-sommerzeit-sprung-run-35-wann-ist-ein-worker-mehr-nur-noch-teurer-nicht-mehr-besser/](https://donau2space.de/tag-192-sommerzeit-sprung-run-35-wann-ist-ein-worker-mehr-nur-noch-teurer-nicht-mehr-besser/)  
+**Git Repository:** [https://git.donau2space.de/Mika/time_management_and_scalability](https://git.donau2space.de/Mika/time_management_and_scalability)
+
+## Inhalt des Repositories
+
+### Artefakte
+
+**artifact_1**  
+- **Art:** python_script  
+- **Zielplattform:** linux-userspace  
+- **Sprache:** Python  
+- **Zweck:** Skript zur Protokollierung und Analyse von Zeitstempeln, einschließlich epochaler und monotoner Zeitangaben.  
+- **API-Funktionen:**  
+  - `log_timestamps(epoch_ms, monotonic_ns, tz_offset_minutes, run_id, step_id)` – Erfasst und speichert Zeitstempel in einem strukturierten Log.  
+- **Datentypen:**  
+  - `LogEntry` (JSON) – enthält epoch_ms, monotonic_ns, tz_offset_minutes, run_id, step_id.
+
+**artifact_2**  
+- **Art:** python_script  
+- **Zielplattform:** linux-userspace  
+- **Sprache:** Python  
+- **Zweck:** Konsistenztest-Skript zur Überprüfung der Protokolldaten auf zeitliche Kohärenz.  
+- **API-Funktionen:**  
+  - `check_timestamp_consistency(log_entries)` – Prüft, ob die aufgezeichneten Zeitstempel logisch konsistent sind.  
+- **Datentypen:**  
+  - `LogEntries` (JSON) – Sammlung von LogEntry-Datensätzen.
+
+**artifact_3**  
+- **Art:** doc_only  
+- **Zielplattform:** mixed  
+- **Sprache:** Markdown  
+- **Zweck:** Dokumentation über die Auswirkungen von Zeitumstellungen auf die Performance verschiedener Worker-Setups.
+
+## Installation & Nutzung
+
+Voraussetzung: Python ≥ 3.8 unter Linux.
+
+1. Repository klonen:
+   - `git clone https://git.donau2space.de/Mika/time_management_and_scalability`
+2. In das Verzeichnis wechseln:
+   - `cd time_management_and_scalability`
+3. benötigte Python-Pakete installieren (falls vorhanden).
+4. Skripte ausführbar machen:
+   - `chmod +x *.py`
+5. Nutzung:
+   - Zeitstempel-Logging starten: `python log_timestamps_script.py`
+   - Konsistenzprüfung durchführen: `python check_consistency_script.py`
+
+## Typische Use-Cases
+- Untersuchung von Problemen durch Zeitumstellungen (Sommer-/Winterzeit).  
+- Validierung von Zeiterfassungsmechanismen in skalierenden Systemen.  
+- Benchmarking von Worker-Kapazität unter Zeitsynchronisationsbedingungen.
+
+## Struktur & Erweiterbarkeit
+- Erweiterbar durch zusätzliche Analyse-Skripte oder Logging-Ausgabemodule.  
+- Anpassbare Datenstrukturen (JSON-basiert).  
+- Kompatibel mit bestehenden Zeit- und Monitoring-Systemen.  
+- Dokumentation kann um neue Testszenarien ergänzt werden.
+
+## Lizenz
+Dieses Projekt steht unter der **MIT-Lizenz**.
+
+**Hinweis:** Die Inhalte wurden von einer KI erstellt. Nutzung auf eigene Gefahr.