Add laser_tracking_cli_tool/README.md

laser_tracking_cli_tool/README.md

@@ -0,0 +1,126 @@
+# laser_tracking_cli_tool
+
+**WICHTIGER HINWEIS – ALLE INHALTE SIND EXPERIMENTELL UND KI-GENERIERT**
+
+## Warnung
+
+Dieses Kommandozeilenprogramm wurde vollständig von einer KI generiert.
+Es ist rein experimentell und wurde in **KEINER** Weise auf Sicherheit,
+Korrektheit oder Robustheit geprüft.
+
+- **KEIN PRODUKTIVEINSATZ!**
+- **KEINE GARANTIE FÜR FUNKTIONALITÄT ODER SICHERHEIT!**
+- Kann Abstürze, Speicherfehler, undefiniertes Verhalten oder
+  Sicherheitslücken verursachen
+- Nur für Lern-, Demonstrations- und Forschungszwecke gedacht
+
+## Beschreibung
+
+`laser_tracking` ist ein kleines, simuliertes CLI-Tool in C, das ein
+Laser-Tracking-System für Satelliten nachbildet. Es steuert **keine**
+reale Hardware, sondern erzeugt lediglich plausible Statuswerte.
+
+Es orientiert sich lose an einem Experiment zur Messung von
+Laserreflexionen von Satelliten und kann genutzt werden, um typische
+CLI-Abläufe (Starten eines Trackings, Statusabfragen) zu demonstrieren.
+
+## Sicherheit
+
+Dieses Programm simuliert nur ein Tracking-System, trotzdem gilt:
+
+- Führen Sie reale Laserexperimente nur mit geeigneter Schutzbrille und
+  ausschließlich mit Geräten im zulässigen Leistungsbereich (z. B.
+  < 5 mW) durch.
+- Achten Sie bei eigenen Experimenten darauf, dass weder Personen noch
+  Fahrzeuge in einen eventuellen Strahlbereich geraten.
+- Beachten Sie gesetzliche Vorgaben und holen Sie ggf. erforderliche
+  Genehmigungen ein.
+
+## Build
+
+Voraussetzungen:
+
+- Linux-Umgebung
+- GCC oder kompatibler C-Compiler
+- Make
+
+Build-Schritte:
+
+```bash
+make
+```
+
+Dadurch entsteht das Binary:
+
+- `./laser_tracking`
+
+Aufräumen:
+
+```bash
+make clean
+# oder vollständig:
+make distclean
+```
+
+## Nutzung
+
+Allgemeine Hilfe:
+
+```bash
+./laser_tracking --help
+```
+
+### Globale Optionen
+
+- `-h`, `--help`   – Hilfe anzeigen
+- `-v`, `--version` – Version ausgeben
+- `-q`, `--quiet`  – weniger Ausgaben
+- `--debug`        – Debug-Ausgaben aktivieren
+- `--seed N`       – Zufalls-Seed setzen (z. B. für reproduzierbare Simulationen)
+
+### Kommandos
+
+#### `start`
+
+Startet ein simuliertes Tracking für einen Satelliten.
+
+```bash
+./laser_tracking start --sat COMM-SAT-RX --elev 67
+```
+
+Optionen:
+
+- `--sat NAME`  – Name/ID des Ziel-Satelliten
+- `--elev WINKEL` – Elevationswinkel in Grad (0.0–90.0)
+
+Beispielausgabe:
+
+```text
+tracking – target=COMM-SAT-RX, elev=67.00deg
+Tracking simuliert gestartet. Status:
+  active      : yes
+  last_update : 2026-01-01 23:45:11 CET
+  deviation   : 0.0300 deg
+```
+
+#### `status`
+
+Gibt einen aktuellen, simulierten Tracking-Status aus.
+
+```bash
+./laser_tracking status
+```
+
+Beispielausgabe:
+
+```text
+Tracking-Status:
+  active      : yes
+  last_update : 2026-01-01 23:59:59 CET
+  deviation   : 0.0500 deg
+```
+
+## Lizenz
+
+Dieses Projekt ist experimentell. Verwenden Sie den Code ausschließlich
+auf eigene Verantwortung für Lern- und Demonstrationszwecke.