95 lines
4.3 KiB
Markdown
95 lines
4.3 KiB
Markdown
# 05 – Tasks & Backlog (Changelog)
|
||
|
||
> Zentrales Log über **abgearbeitete Tasks** (Changelog) und das **offene Backlog**.
|
||
> Jeder abgeschlossene Arbeitsschritt an der Test-Suite wird hier als Eintrag dokumentiert –
|
||
> das beantwortet die Frage: *„Werden Tasks, die abgearbeitet werden, dokumentiert?"* → **Ja, hier.**
|
||
|
||
**Konvention:**
|
||
- Chronologisch, neuestens oben.
|
||
- Format: `### [YYYY-MM-DD] Kurztitel` + Stichpunkte (Geändert / Begründung / Impact).
|
||
- Offene Punkte wandern in §3 (Backlog), abgeschlossene in §2 (Changelog).
|
||
- **Trennung zu `CHANGELOG.md`:** Diese Datei = **Task-Changelog** (was an der Suite abgearbeitet wurde).
|
||
Die **Versions-Historie** des Games + der Suite (z. B. `1.0.2`, Versionssprünge) lebt im Root-`CHANGELOG.md`.
|
||
Große Changes gehören in **beide**.
|
||
|
||
---
|
||
|
||
## 1. Status-Snapshot
|
||
|
||
| Bereich | Status |
|
||
|---|---|
|
||
| Test-Suite (Audit / Self-Play / Perf / Report) | ✅ implementiert & lauffähig |
|
||
| Dokumentation (01–06) | ✅ überarbeitet & konsistent |
|
||
| CI-Definition | 🟡 dokumentiert (Workflow noch zu commiten) |
|
||
| Refactoring der Game-Datei | 🔵 Advisory-Backlog (siehe `06_Refactoring_Game.md`) |
|
||
|
||
---
|
||
|
||
## 2. Changelog (abgearbeitete Tasks)
|
||
|
||
### [2026-08-28] Doku-Nummerierung vereinheitlicht (01–06)
|
||
|
||
- **Geändert:** Drei veraltete Dateien (`01_Refactoring_Performance.md`, `02_Audit_Bericht.md`, `03_Automatisierung_SelfPlay.md`) mit altem „Game"-Framing entfernt.
|
||
- **Neu:** Kohärentes Set `01_Debug_API`, `02_Audits`, `03_Automatisierung_CI`, `04_Resultate_Report`, `05_Tasks_Backlog`, `06_Refactoring_Game`.
|
||
- **Begründung:** Repo ist eine **Test-Suite**, kein Spiel → Doku musste umfokussiert und neu nummeriert werden.
|
||
- **Impact:** Keine Code-Änderung; reine Dokumentation.
|
||
|
||
### [2026-08-28] Schemata gegen echten Code verifiziert
|
||
|
||
- **Geändert:** `selfplay-results.json`, `perf-result.json`, `audit-result.json`-Schemata in `03` und `04` an den tatsächlichen Skript-Output angepasst.
|
||
- **Geändert:** CI-Gate prüft jetzt `summary.fail` statt des nicht existierenden Felds `"failed"`.
|
||
- **Begründung:** Doku-Beispiele kollidierten mit der realen Ausgabe (falsche Feldnamen).
|
||
- **Impact:** CI-Beispiel läuft jetzt konsistent mit `audit-result.json`.
|
||
|
||
### [2026-08-28] README auf Test-Suite-Framing umgestellt
|
||
|
||
- **Geändert:** README beschreibt jetzt das **Test-/Audit-Projekt**, nicht das Spiel.
|
||
- **Neu:** Hinweis, dass `Aegis-Labyrinth.html` **manuell** in die Root gelegt werden muss.
|
||
- **Begründung:** User-Fokus: Suite testet & auditiert die extern eingelegte Game-Datei.
|
||
- **Impact:** Onboarding-Clairity für neue Nutzer.
|
||
|
||
### [2026-08-28] `report.mjs` als Artefakt-Generator dokumentiert
|
||
|
||
- **Geändert:** `04_Resultate_Report.md` mit `report.html`-Aufbau + „no data"-Verhalten.
|
||
- **Impact:** Klare Referenz, was `npm run report` erzeugt.
|
||
|
||
---
|
||
|
||
## 3. Offenes Backlog
|
||
|
||
> Priorität: **P0** = sofort, **P1** = kurzfristig, **P2** = später. Jede erledigte Aufgabe
|
||
> wandert nach oben in §2 (Changelog) mit Datum.
|
||
|
||
### Test-Suite / CI
|
||
|
||
| # | Prio | Task |
|
||
|---|---|---|
|
||
| 1 | P0 | `.github/workflows/ci.yml` aus `03_Automatisierung_CI.md` commiten & aktivieren |
|
||
| 2 | P0 | `Aegis-Labyrinth.html` + Test-Artefakte in `.gitignore` sicherstellen |
|
||
| 3 | P1 | CI-Secret `AEGIS_GAME_BASE64` anlegen (Game-Datei in CI bereitstellen) |
|
||
| 4 | P1 | Lighthouse-Job als eigene CI-Stufe ergänzen (Performance-Score ≥ 80) |
|
||
| 5 | P2 | Trend-Tracking: Lauf-Results als CSV/JSON-Artifact archivieren (Trend-Chart) |
|
||
|
||
### Robustheit der Skripte
|
||
|
||
| # | Prio | Task |
|
||
|---|---|---|
|
||
| 6 | P1 | Self-Play: deterministischer Seed für `Math.random()` (reproduzierbare Episoden) |
|
||
| 7 | P1 | Perf-Test: Heap-Delta (vorher/nachher) statt absoluter Werte → Leak-Heuristik |
|
||
| 8 | P2 | Optionaler Q-Learning-/MCTS-Bot (Outline in alter Doku, ggf. neu aufbauen) |
|
||
|
||
### Dokumentation
|
||
|
||
| # | Prio | Task |
|
||
|---|---|---|
|
||
| 9 | P1 | `01_Debug_API.md` um `effectTuning`/`effectLimits`-Detailfeld ergänzen, wenn es sich ändert |
|
||
| 10 | P2 | `report.html`-Screenshot/Beispiel als Referenz in `04` aufnehmen |
|
||
|
||
---
|
||
|
||
## 4. How-to: Neue Task dokumentieren
|
||
|
||
1. Task erledigen (Code / Doku / CI).
|
||
2. Oben in §2 einen Eintrag anfügen: `### [JJJJ-MM-TT] Titel` + Stichpunkte.
|
||
3. Falls noch offen: als Zeile in §3 eintragen, Priorität setzen.
|
||
4. Bei Abschluss: aus §3 entfernen und in §2 verschieben. |