group code popup

docs/Gruppenbearbeitung.md

@@ -1,15 +1,16 @@
 # Gemeinsam bearbeiten
 
-In „Strecken bearbeiten“ trägt jede Strecke eine Schaltfläche mit zwei Wichteln:
-links der Vogel, rechts der Stein. „Gemeinsam bearbeiten“ legt einen gemeinsamen
+In „Strecken bearbeiten“ öffnet der kleine Gruppenbutton zwischen Stift und
+Löschen einen Dialog. Dort sind die beiden Wichtel groß zu sehen: links der Vogel,
+rechts der Stein. Erst „Gemeinsamen Entwurf öffnen“ legt einen gemeinsamen
 Entwurf auf der Website an. Das Original bleibt unverändert. Bei lokalen Entwürfen
 fragt die App vorher, ob Weg, Stationen, Bilder und Ton übertragen werden dürfen.
 Ein bereits eingesandter eigener Entwurf wird dabei zuerst aktualisiert.
 
-Danach zeigt die App acht Wichtel als Gruppencode. Andere öffnen in der
-Streckenverwaltung „Gruppencode eingeben“ und schieben die Bilder in den acht
+Danach zeigt die App fünf Wichtel als Gruppencode. Andere öffnen in der
+Streckenverwaltung „Gruppencode eingeben“ und schieben die Bilder in den fünf
 Drehrädern nach oben oder unten. Es zählen die Wichtel in der Mitte, von links
-nach rechts, zuerst in der oberen Reihe. Pfeiltasten und die Pfeilschaltflächen
+nach rechts. Wiederholungen sind erlaubt. Pfeiltasten und die Pfeilschaltflächen
 funktionieren ebenfalls. „Mitmachen“ öffnet den gemeinsamen Entwurf.
 
 ## Arbeiten und Einladungen
@@ -22,8 +23,12 @@ funktionieren ebenfalls. „Mitmachen“ öffnet den gemeinsamen Entwurf.
 - Wenn jemand zwischenzeitlich gespeichert hat, weist die App den veralteten
   Speicherversuch zurück. Die Eingaben bleiben stehen und können vor dem Laden
   des neuen Stands gesichert werden. Es gibt noch keine automatische Zusammenführung.
-- Der Einladungscode gilt eine Stunde. „Neuen Code anzeigen“ ersetzt ihn; bereits
-  beigetretene Personen behalten ihren Zugang. Nur die eröffnende Person kann das.
+- Der Einladungscode gilt 30 Minuten. Anschließend erzeugt die Website automatisch
+  einen neuen Code, sobald keine Station mehr gesperrt ist. Ein abgelaufener Code
+  erlaubt auch während einer Bearbeitung keinen neuen Beitritt. Bereits beigetretene
+  Personen behalten ihren Zugang. Das geöffnete Codefenster prüft alle 30 Sekunden
+  auf einen neuen Code. Die eröffnende Person kann mit „Neuen Code anzeigen“ auch
+  früher wechseln; während einer Stationsbearbeitung wartet auch dieser Wechsel.
 - „Gruppe schließen“ entfernt den Zugang der anderen Personen und den Code.
   Die eröffnende Person behält ihren Entwurf und kann wieder einen Code erzeugen.
 - Es sind höchstens 50 Zugänge je Gruppe und zwölf gleichzeitig offene Gruppen
@@ -88,7 +93,10 @@ Ist sie bereits geöffnet, fragt die App, ob die Bearbeitung übernommen werden
 soll. Erst die Bestätigung ersetzt die bisherige Sperre. Das andere Gerät darf
 danach nicht mehr speichern. Zwei Fenster desselben Geräts benötigen ebenfalls
 eine bestätigte Übernahme, damit sie einander nicht unbemerkt überschreiben.
-Beim Verlassen der Station wird ihre eigene Sperre entfernt. Bleibt nach einem
+Beim Verlassen der Station wird ihre eigene Sperre entfernt. Eingaben sowie
+Bedienaktionen in der Station melden bei bestehender Verbindung spätestens alle
+30 Sekunden Aktivität. Das bloße Offenlassen des Fensters oder Abfragen des
+Sperrstatus verlängert die Sperre nicht. Bleibt nach einem
 Abbruch oder ohne Verbindung eine Sperre zurück, kann sie bestätigt übernommen
 werden. Während eine Speicherung läuft, ist keine Übernahme möglich.
 
@@ -128,7 +136,9 @@ angegebenen Anfragefeld. Dateien werden atomar ersetzt und mit Modus 0600
 angelegt. Dieser Ordner darf nicht unmittelbar durch Nginx ausgeliefert werden.
 Schließen der Gruppe entfernt ihre Sperren; laufende Schreibanfragen müssen
 zunächst fertig werden. Erfolgreiches Entfernen einer Station entfernt auch
-ihre Sperrdatei. Zurückgebliebene Sperren werden nicht zeitgesteuert gelöscht.
+ihre Sperrdatei. Sperren ohne gemeldete Aktivität werden nach 60 Minuten entfernt. Die Wartung
+läuft beim App-Start und anschließend jede Minute; API-Zugriffe prüfen die Frist
+zusätzlich unmittelbar.
 
 Stationsänderungen prüfen zusätzlich einen SHA-256-Abdruck aus Stationsangaben
 und den tatsächlichen Bild-/Tondateien. Andere Stationen können deshalb unabhängig
@@ -141,3 +151,9 @@ Die Sicherungen liegen in IndexedDB (`wegwichtel.group-point-drafts.v1`) und zä
 zur vorhandenen Anzeige des belegten Gerätespeichers. Browserdaten-Löschung kann
 sie entfernen. Sie enthalten nur die betroffene Station und neu ausgewählte
 Dateien; vorhandene Aufnahmen werden hierfür nicht gesammelt heruntergeladen.
+
+Einladungen werden dauerhaft weiterhin nur als Hash gespeichert. Den neu erzeugten
+Klartext hält der App-Prozess im Arbeitsspeicher für die berechtigte Anzeige vor.
+Nach einem App-Neustart bleibt der zuletzt gültige Code weiterhin bis zu seinem
+Ablauf verwendbar. Falls er auf dem Gerät nicht mehr angezeigt wird, kann die
+eröffnende Person bei freien Stationen einen neuen Code anfordern.