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
120 lines
3.6 KiB
Markdown
120 lines
3.6 KiB
Markdown
# 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)
|