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

120 lines
3.6 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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)