Entwurf · Issue 20184fd

Antworten kommen im eigenen Space an

Entwurf zu Issue 20184fd, zu docs/plans/20184fd-answers-reach-the-space.md. Teil des Vorhabens effort/answers (Karte 4356857).

Wer Ja gesagt hat, hat einen Space, und der bleibt leer: Die App kann keine Antwort übergeben, und keine Seite zeigt, was aufbewahrt ist. Dieser Entwurf baut den Weg von der App bis in den Space der Spielerin und die Seite „Meine Songs“. Dazu zeigt die Adresse eines Raums jemandem ohne Konto, wie man hineinkommt.

01Was man sieht

  • Wer das Spiel leitet. Die App öffnet /app im Browser. Dort meldet man sich an und öffnet einen Raum. Auf dessen Seite tritt man selbst bei, mit derselben Frage wie alle anderen, und tippt dann „In buzzr öffnen“. Die App zeigt danach den QR-Code des Raums. Weil das Handy während des Spiels die App zeigt, landen die eigenen Antworten erst im Space, wenn man die Seite des Raums oder /songs wieder öffnet, innerhalb von 24 Stunden.
  • Wer den QR-Code scannt, ohne angemeldet zu sein. Eine Seite mit drei Wegen: mit dem Passkey anmelden, ein neues Konto anlegen, oder ohne Konto am Tisch als Gast mitspielen. Nach dem Anmelden ist man wieder im Raum.
  • Wer Ja gesagt hat. Solange die Seite des Raums offen ist, landen die eigenen richtigen Antworten im Space; eine Zeile sagt, wie viele. Unter /songs stehen sie mit Song, Zeit und dem verstandenen Text, lassen sich anhören und einzeln löschen.
  • Gäste und wer nur als Name mitspielt. Von ihnen nimmt das Backend nichts an.

02Der Weg einer Antwort

  • Die App schickt eine richtige Antwort mit dem Token des Raums an POST /api/rooms/<code>/answers: Song, was richtig war, die beiden Zeiten, den verstandenen Text und den Ton als WAV (höchstens 512 KB).
  • Das Backend behält sie im Speicher, am Eintrag des Mitglieds, und nur bei einem Ja mit fertigem Space. Sie verschwindet mit dem Raum nach 24 Stunden, mit einem zurückgenommenen Ja, oder sobald sie abgeholt ist. In einen Space schreibt das Backend nie.
  • Der Browser der Spielerin holt, was für sie wartet, bekommt über POST /api/space/session eine kurzlebige Sitzung ihres eigenen Lab-Kontos, lädt den Ton hoch, schreibt den Eintrag at.tessera.buzzr.answer in ihren Space und meldet dem Backend, dass es seine Kopie verwerfen kann. Wie der Eintrag aussieht, steht als Lexikon in tessera-sdk; was es nicht gibt (kein Ton, keine Sprechzeit), fehlt im Eintrag.

03Was die App weiß

Die App meldet sich nicht selbst an. Sie bekommt über den Link buzzr://room?code=…&token=…&origin=… den Code und ein Token, das nur diesen Raum öffnet und mit ihm endet. Damit liest sie, wer beigetreten ist, und zwar als zufällige Kennung je Raum, Name und ob ein Ja mit Space vorliegt. Eine DID oder ein Handle erfährt sie nicht.

04Grenzen

  • Höchstens 30 wartende Antworten je Mitglied und 48 MB Ton je Raum; der Ton muss ein WAV sein.
  • Die Sitzung des Lab-Kontos ist ein Zugang. Sie wird nie protokolliert, nie zwischengespeichert und liegt im Browser nur im Arbeitsspeicher der Seite.
  • Schlägt ein Schritt im Browser fehl, bleibt die Antwort im Backend liegen und die nächste Runde versucht es erneut. Der Schlüssel des Eintrags entsteht aus Song und Zeitpunkt, eine Wiederholung überschreibt also und verdoppelt nichts.
  • Wer die Seite des Raums schließt, bevor alles abgelegt ist, findet den Rest innerhalb von 24 Stunden unter /songs. Danach ist er weg.
  • Ein Neustart des Dienstes leert Räume und Wartendes. Falsche Antworten, Statistik und ein Spielprotokoll sind nicht Teil dieser Karte.