bd05edfb9c
- 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
3.6 KiB
3.6 KiB
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
- 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.modinitialisiert
✅ 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
/wsfü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)