# 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 - [ ] 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