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
/appim 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/songswieder ö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
/songsstehen 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/sessioneine kurzlebige Sitzung ihres eigenen Lab-Kontos, lädt den Ton hoch, schreibt den Eintragat.tessera.buzzr.answerin 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.