fix(gui): Recorder-Zustand nach Neuladen vom Server holen
Die GUI hielt `recording`/`recStart`/`markers` nur im Browser-State und fragte den Server nie danach. Nach jedem F5 stand der Recorder auf 00:00, obwohl parecord weiterlief — und das Kopfband malte den Start- statt des Stop-Knopfes, die laufende Aufnahme war aus der GUI also nicht mehr beendbar. `rehydrateRecording()` liest nach dem ersten render() `GET /api/health` und stellt Laufzeit, Namensmarker und Live-Karte wieder her; Fehler bleiben still. Nebeneffekt: ein zweites Gerät sieht die laufende Aufnahme ebenfalls. Doku: Kapitel 03 neuer Abschnitt + /api/health in der Endpunkt-Tabelle, Changelog-Eintrag 2026-08-10. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
This commit is contained in:
@@ -1652,4 +1652,22 @@ function analysisBadge(st) {
|
||||
return '';
|
||||
}
|
||||
|
||||
// Der Aufnahmezustand lebt im Server (recorder.js `current`), nicht im Browser.
|
||||
// Ohne diesen Abgleich zeigt der Recorder nach jedem Neuladen 00:00, obwohl
|
||||
// parecord weiterläuft — und der Stop-Knopf ist unerreichbar, weil das Kopfband
|
||||
// dann den Start-Knopf malt.
|
||||
async function rehydrateRecording() {
|
||||
try {
|
||||
const h = await api.get('/api/health');
|
||||
if (!h || !h.recording) return;
|
||||
state.recording = true;
|
||||
state.recStart = h.startedAt || Date.now();
|
||||
state.markers = h.markers || [];
|
||||
state.mkDraft = '';
|
||||
render();
|
||||
if (state.tab === 'recordings') { state.lastListSig = null; refreshRecList(); }
|
||||
} catch (err) { /* Server nicht erreichbar: normale Ansicht, kein Toast */ }
|
||||
}
|
||||
|
||||
render();
|
||||
rehydrateRecording();
|
||||
|
||||
@@ -110,10 +110,46 @@ linear — bei konstanter Bitrate exakt.
|
||||
30,3 MB. Der Altbestand wurde einmalig mit `lab/recode-cbr.sh` umgeschrieben (Quelle: die WAV, wo noch
|
||||
vorhanden — sonst die MP3 selbst, dann ohne erneute Filter).
|
||||
|
||||
## Der Aufnahmezustand gehört dem Server (Reload-Sicherheit)
|
||||
|
||||
Wer aufnimmt, weiß nur `recorder.js` — dort hält `current` den laufenden `parecord`-Prozess, den WAV-Pfad,
|
||||
den Startzeitpunkt und die Namensmarker. Die GUI ist reiner Betrachter: sie muss sich diesen Zustand beim
|
||||
Laden **holen**, denn ihr eigener `state.recording` ist nach jedem `F5`, Tab-Wechsel des Browsers oder auf
|
||||
einem zweiten Gerät wieder `false`.
|
||||
|
||||
```mermaid
|
||||
flowchart TB
|
||||
A["Seite lädt: render()"] --> B["rehydrateRecording()<br/>GET /api/health"]
|
||||
B --> C{"recording?"}
|
||||
C -- nein --> D["Recorder zeigt ●, 00:00 — korrekt"]
|
||||
C -- ja --> E["state.recording = true<br/>recStart = startedAt (Server-Epoche)<br/>markers = Server-Marker"]
|
||||
E --> F["render(): ■ Stop, laufende Zeit,<br/>Namensfeld, Marker-Chips, Live-Karte in der Liste"]
|
||||
```
|
||||
|
||||
`GET /api/health` ist die einzige Quelle dafür und liefert genau das Nötige:
|
||||
|
||||
```json
|
||||
{ "ok": true, "recording": true, "startedAt": 1786359542932, "source": "default",
|
||||
"markers": [ { "t_ms": 8401, "name": "Markus Ufer" } ] }
|
||||
```
|
||||
|
||||
- `recStart` kommt als **Server-Epoche**; der Timer rechnet `Date.now() - recStart`. Epoch-Werte sind
|
||||
zeitzonenfrei (Board läuft auf UTC, Browser auf CEST) — nur eine echte Uhrabweichung würde verschieben.
|
||||
- Fehlschlag ist absichtlich still: kein Toast, die GUI startet dann einfach im Normalzustand.
|
||||
- Zweites Gerät bekommt dieselbe laufende Aufnahme angezeigt — der Zustand ist nicht mehr an einen Tab
|
||||
gebunden.
|
||||
|
||||
⚠️ **Warum das mehr als Kosmetik ist:** ohne den Abgleich malt das Kopfband nach dem Neuladen den
|
||||
Start-Knopf (●), der Stop-Knopf ist also unerreichbar, während `parecord` weiterschreibt. Ein Druck auf ●
|
||||
läuft in `recorder.js` gegen `if (current) throw new Error('already recording')` — es gibt keinen
|
||||
Datenverlust, aber auch keinen Weg mehr, die Aufnahme aus der GUI zu beenden. Notausgang ohne GUI bleibt
|
||||
`curl -X POST localhost:3000/api/record/stop` (speichert regulär und startet die Transkription).
|
||||
|
||||
## API-Endpunkte (Auszug)
|
||||
|
||||
| Endpunkt | Zweck |
|
||||
|---|---|
|
||||
| `GET /api/health` | Läuft eine Aufnahme? (`recording`, `startedAt`, `source`, `markers`) — Grundlage der Reload-Wiederherstellung |
|
||||
| `POST /api/recordings/:id/retranscribe` | Hängende/fehlgeschlagene Transkription neu starten |
|
||||
| `POST /api/recordings/:id/reanalyze` `{numSpeakers?}` | Diarization **immer** neu (leer/0 = automatisch, Zahl = Anzahl gepinnt) + LLM neu |
|
||||
| `POST /api/recordings/:id/reanalyze-llm` | Nur LLM neu, Diarization/Wörter bleiben |
|
||||
|
||||
@@ -3,6 +3,39 @@
|
||||
Chronik der Entwicklungsschritte. **Regel: jede zukünftige Änderung bekommt hier einen Eintrag** (Datum,
|
||||
Was, Warum, betroffene Dateien/Backups).
|
||||
|
||||
## 2026-08-10 — Recorder überlebt das Neuladen (GUI holt den Zustand vom Server)
|
||||
|
||||
**Symptom:** während einer laufenden Aufnahme klickte der Nutzer in eine andere Aufnahme; danach stand der
|
||||
Recorder auf `00:00` und zeigte den Start-Knopf — auch nach `F5`. Die Aufnahme schien gestorben.
|
||||
|
||||
**Sie lief die ganze Zeit.** Gemessen am Board: `parecord` PID 236484, Elternprozess = die Node-App, seit
|
||||
10:59:02 UTC; die WAV wuchs um ~32 kB/s (16 kHz mono s16 = korrekt); `GET /api/health` meldete
|
||||
`{"recording":true,"startedAt":1786359542932}` samt allen drei Namensmarkern.
|
||||
|
||||
**Ursache:** `web/src/main.js` hielt `recording`/`recStart`/`markers` ausschließlich im Browser-`state`
|
||||
(Zeile 12, Startwert `false`/`0`) und fragte den Server **nie** danach — `grep -rn "api/health" web/src/`
|
||||
ergab null Treffer. Jedes Neuladen setzte die GUI also auf „keine Aufnahme" zurück, obwohl `recorder.js`
|
||||
weiter aufnahm. Fatal daran ist nicht die falsche Anzeige, sondern dass das Kopfband dann ● statt ■ malt:
|
||||
der Stop-Knopf war unerreichbar. Immerhin ohne Datenrisiko — `recorder.js:270`
|
||||
`if (current) throw new Error('already recording')` verhindert eine zweite Aufnahme über dieselbe WAV.
|
||||
|
||||
**Fix:** neue Funktion `rehydrateRecording()` am Ende von `main.js`, aufgerufen direkt nach dem ersten
|
||||
`render()`. Sie liest `GET /api/health` und stellt `recording`, `recStart` (= `startedAt`, Server-Epoche)
|
||||
und `markers` wieder her, rendert neu und frischt die Aufnahmenliste auf (Live-Karte). Ein Fehler bleibt
|
||||
still (kein Toast), damit ein nicht erreichbarer Server nur die Normalansicht bedeutet. Nebeneffekt: ein
|
||||
zweites Gerät sieht die laufende Aufnahme jetzt ebenfalls.
|
||||
|
||||
**Verifiziert:** `vite build` sauber (`dist/assets/index-B3z3XrMo.js`, `api/health` im Bundle enthalten,
|
||||
`dist/index.html` verweist darauf). **Kein `systemctl restart`** — nur statische Dateien getauscht, die
|
||||
laufende Aufnahme blieb unangetastet (`recording:true` vor und nach dem Build, Marker intakt).
|
||||
|
||||
Dateien: `app/web/src/main.js` (Board-Backups `src/main.js.bak-rehydrate`, `web/dist.bak-rehydrate`),
|
||||
Kapitel 03 (neuer Abschnitt „Der Aufnahmezustand gehört dem Server" + `/api/health` in der Endpunkt-Tabelle).
|
||||
|
||||
⚠️ **Nebenbefund, nicht behoben:** `enroll-from-recording failed: spk beendet` bei #107 und #85 — TitaNet
|
||||
stirbt im ONNX-`Where`-Knoten (`Attempting to broadcast an axis by a dimension other than 1. 12288 by
|
||||
30733`), das Stimmabdruck-Lernen aus langen Aufnahmen fällt also aus. Eigener Punkt.
|
||||
|
||||
## 2026-08-07 (3) — Eine Person darf mehrere Namen haben (und mehrere Stimmproben)
|
||||
|
||||
**Warum:** die Identität war der NAME. Derselbe Mensch, in einer Aufnahme „Sascha" und in der nächsten
|
||||
|
||||
Reference in New Issue
Block a user