Files
goSportpunktetafel/AGENTS.md
T

3.3 KiB
Raw Blame History

goSportpunktetafel – Projektstatus

Projekt-Info


Meilensteine

✅ M1: Projektstrukturierung und Planung

  • Projektverzeichnis erstellt
  • Alle notwendigen Verzeichnisse angelegt
  • AGENTS.md erstellt und wird fortlaufend aktualisiert
  • Repository auf git.jlserver.de erstellt und initialer Push durchgeführt
  • go.mod initialisiert

✅ M2: Backend – USB-Tastatur-Handling

  • Tastatureingaben im Hintergrund auslesbar
  • Diagnostik und Log-Ausgabe über stderr
  • Systemd-Service-Beispieldatei
  • Dokumentation

⏳ M3: Backend – Logik

  • Zählerlogik implementiert
  • Zustandsausgabe im Log
  • Dokumentation

⏳ M4: Backend – Persistenz

  • Speicherung des aktuellen Zählerstands in Datei (Flag)
  • Laden des Zustands beim Start (falls vorhanden)
  • Dokumentation

⏳ M5: Backend – mDNS

  • HTTP-API über mDNS im Netzwerk bekannt machen
  • Funktion zur Suche anderer Instanzen im Netzwerk

✅ M6: Backend – HTTP-API-Schnittstelle

  • Flags für Listening-Port und -Adresse (Default: Port 3000, alle IPv6/IPv4)
  • /api/... – alle Steuer- und Statusfunktionen
  • Alle API-Endpunkte vor Commit auf Funktion geprüft (14 Tests)
  • Dokumentation

⏳ M7: Frontend

  • HTML, JS, CSS erstellt
  • Plausibilitäts- und Funktionstest
  • In Go-Binary integriert (embed)
  • Unter / verfügbar
  • End-to-End-Test

Projektstruktur

goSportpunktetafel/
├── AGENTS.md
├── go.mod
├── cmd/
│   └── sportscore/
│       └── main.go
├── internal/
│   ├── config/     – Flag-Parsing, Konfiguration
│   ├── usb/        – USB-Tastatur-Handling
│   ├── logik/      – Zählerlogik (Rot/Grün, Runden)
│   ├── persistenz/ – Datei-basierte Persistenz
│   ├── mdns/       – mDNS-Bekanntmachung & Discovery
│   └── httpapi/    – HTTP-API-Server
├── static/         – Frontend (HTML, JS, CSS)
├── test/           – Testdateien
│   ├── usb/
│   ├── logik/
│   ├── persistenz/
│   ├── httpapi/
│   └── mdns/
├── systemd/        – Systemd-Service-Datei
├── docs/           – Dokumentation
└── scripts/        – Hilfs-Scripts

Domänenlogik

Teams

  • Rot und Grün

Tasten (USB-Tastatur)

Taste Aktion
/ +1 Punkt bei Team Rot
* +1 Punkt bei Team Grün
+ Nächste Runde (0:0)
- Alle Runden löschen, zurück zu Runde 1 (0:0)

Frontend-Anforderungen

  • Dunkles Design
  • Vollbild auf großem Bildschirm
  • Zentral: Score (Rot : Grün)
  • Unten: Highscores der vorherigen Runden (komma-getrennt)
  • Menü oben links: Backend-Auswahl
    • Lokal
    • mDNS-Ergebnisse (aktualisierbar)
    • Manuelle Server-Eingabe
  • Ausgewähltes Backend wird in lokaler Persistenz gespeichert

Aktueller Status

Letztes Update: 2026-07-14 14:25 CET Aktueller Meilenstein: M7 – Frontend Nächster Schritt: Frontend (HTML/JS/CSS) erstellen und in Go-Binary integrieren