# goSportpunktetafel – Projektstatus ## Projekt-Info - **Name:** goSportpunktetafel - **Backend-Sprache:** Go - **Git-Remote:** https://git.jlserver.de - **Repository-URL:** https://git.jlserver.de/goSportpunktetafel.git (noch zu erstellen) - **Go-Version:** 1.19.8 --- ## Meilensteine ### ✅ M1: Projektstrukturierung und Planung - [x] Projektverzeichnis erstellt - [x] Alle notwendigen Verzeichnisse angelegt - [x] AGENTS.md erstellt und wird fortlaufend aktualisiert - [x] Repository auf git.jlserver.de erstellt und initialer Push durchgeführt - [x] `go.mod` initialisiert ### ✅ M2: Backend – USB-Tastatur-Handling - [x] Tastatureingaben im Hintergrund auslesbar - [x] Diagnostik und Log-Ausgabe über stderr - [x] Systemd-Service-Beispieldatei - [x] 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 - [x] Flags für Listening-Port und -Adresse (Default: Port 3000, alle IPv6/IPv4) - [x] `/api/...` – alle Steuer- und Statusfunktionen - [x] Alle API-Endpunkte vor Commit auf Funktion geprüft (14 Tests) - [x] Dokumentation ### ✅ M7: Frontend - [x] HTML, JS, CSS erstellt (dunkles Design, Vollbild, 2 Teams) - [x] Plausibilitäts- und Funktionstest bestanden (17 Tests) - [x] In Go-Binary integriert (embed.FS) - [x] Unter `/` verfügbar - [x] End-to-End-Test: Backend + Frontend gemeinsam - [x] WebSocket-Endpoint `/ws` für Echtzeit-Updates - [x] 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)