Files
goSportpunktetafel/AGENTS.md
T
hermes bd05edfb9c M7: Frontend - HTML/JS/CSS mit dunklem Design, Vollbild, WebSocket-Updates, embed.FS-Integration
- Frontend: index.html, style.css, app.js
  - Dunkles Kontrast-Design mit Team-Farben (Rot/Grün)
  - Vollbild-Toggle, Responsive Design
  - Echtzeit-Updates über WebSocket + Polling-Fallback
  - Tastatur-Shortcuts (R/G für Punkte, N für nächste Runde)
  - Rundenverlauf mit Farbcodierung

- Go-Integration:
  - frontend.go: embed.FS für statische Dateien
  - websocket.go: WebSocket-Handler (/ws) für State-Broadcast
  - httpapi.go: broadcastState() nach jeder Mutation, /ws-Route
  - main.go: api.SetupFrontend() für Frontend-Einbettung
  - Frontend unter '/' verfügbar, API unter '/api/'

- Tests: 17 End-to-End-Tests bestanden
  - Alle HTTP-Endpunkte funktionsfähig
  - Frontend-Assets korrekt eingebettet
  - Persistenz (state.json) funktioniert
2026-07-14 16:32:21 +02:00

3.6 KiB
Raw Permalink 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 (dunkles Design, Vollbild, 2 Teams)
  • Plausibilitäts- und Funktionstest bestanden (17 Tests)
  • In Go-Binary integriert (embed.FS)
  • Unter / verfügbar
  • End-to-End-Test: Backend + Frontend gemeinsam
  • WebSocket-Endpoint /ws für Echtzeit-Updates
  • Persistenz-Datei: state.json

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, WebSocket, eingebettetes Frontend
├── systemd/        – Systemd-Service-Datei
├── docs/           – Dokumentation
└── scripts/        – Hilfs-Scripts

Wichtige Dateien

Datei Beschreibung
internal/httpapi/frontend.go Eingebettetes Frontend (embed.FS)
internal/httpapi/static/ Frontend-Dateien (index.html, style.css, app.js)
internal/httpapi/websocket.go WebSocket-Handler für Echtzeit-Updates
data/state.json Persistenz-Datei (JSON)

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 16:30 CET Aktueller Meilenstein: M7 abgeschlossen ✅ Nächster Schritt: Frontend-Design verfeinern (Vollbild-UX, Animationen, responsive)