feat: Kür-Hub in der App anbinden
- Hub-Adresse und API-Token in den Sync-Einstellungen verbinden - Verbindungstest über /api/v1/me, Token getrennt unter user://hub.cfg - Datei → Kür-Hub… nur bei geprüfter Verbindung - Alle veröffentlichten Küren durchsuchen, laden, veröffentlichen, verstecken - Kollisionen: nummerierte Kopie mit Musik-Umbenennung oder Überschreiben - HubSettings/HubClient/HubJob mit Worker-Thread und SHA-256-Prüfung - Tests für Einstellungen, Fehler, Menü, Download und Kollisionen
This commit is contained in:
parent
055a2919c3
commit
ab88a84d5d
15 changed files with 1960 additions and 9 deletions
38
docs/hub.md
38
docs/hub.md
|
|
@ -38,7 +38,7 @@ hub/
|
|||
├── app/ # PHP: Bootstrap, DB, Auth, Routinen, Seiten, API
|
||||
├── views/ # Server-gerenderte Templates
|
||||
├── sql/ # schema.sql
|
||||
├── web/ # DocumentRoot: index.php, .htaccess, assets/hub.css
|
||||
├── web/ # DocumentRoot: index.php, .htaccess, assets/ (hub.css, logo.png)
|
||||
├── install.php # Einmal-Installer (löscht sich selbst)
|
||||
└── app/config.example.php
|
||||
tools/deploy_hub.sh
|
||||
|
|
@ -281,11 +281,43 @@ Auf der echten Subdomain durchgespielt:
|
|||
- Admin-Löschung von Nutzer samt Kür; Upload-Dateien wurden entfernt.
|
||||
- Sperren von `app/config.local.php`, `storage/`; Installer nach der
|
||||
Installation nicht mehr erreichbar.
|
||||
- Godot-Client: Verbindungstest, Veröffentlichen per Multipart, Liste,
|
||||
Download mit SHA-256-Prüfung, Verstecken; Hub-Menü erscheint nur mit
|
||||
gültiger Verbindung.
|
||||
- Lokale Kollisionen: nummerierte Kopie mit umgeschriebener Musikreferenz
|
||||
und Überschreiben getestet.
|
||||
|
||||
## App-Anbindung
|
||||
|
||||
Die Desktop-App verbindet den Hub getrennt vom Cloud-Sync:
|
||||
|
||||
1. Im Hub unter **Konto → API-Tokens** ein Token erzeugen (`rhub_…`).
|
||||
2. In Rinkplanner **Datei → Sync-Einstellungen…** öffnen.
|
||||
3. Im Bereich **Kür-Hub (Beta)** Adresse und Token eintragen,
|
||||
**Verbinden & testen** drücken. Die App ruft `GET /api/v1/me` auf und
|
||||
zeigt den Kontonamen an.
|
||||
4. Erst danach erscheint **Datei → Kür-Hub…** im Dateimenü. Beim Trennen
|
||||
oder nach einem abgelaufenen Token verschwindet der Eintrag wieder.
|
||||
|
||||
Der Token liegt getrennt von den Cloud-Zugängen unter `user://hub.cfg`
|
||||
(auf Unix Modus 600) und wird nicht in Kürdateien oder `sync.cfg` geschrieben.
|
||||
|
||||
Im Hub-Dialog:
|
||||
|
||||
- **Alle Küren / Meine Küren** durchsuchen; die Liste enthält alle
|
||||
veröffentlichten Küren aller Beta-Konten.
|
||||
- **Vom Hub laden** lädt JSON und Musik in `user://routines/`. Existiert der
|
||||
Dateiname bereits, bietet die App **Nummerierte Kopie** (beide Dateien
|
||||
bekommen „(Hub 2)“ und die Kür wird auf die neue Musik umgeschrieben) oder
|
||||
**Überschreiben** an. Eine Musikdatei, die noch von einer anderen Kür
|
||||
verwendet wird, wird nie überschrieben.
|
||||
- **Aktuelle Kür veröffentlichen** speichert die geöffnete Kür als JSON und
|
||||
lädt sie zusammen mit ihrer Musik hoch. Die Rechte-Checkbox ist Pflicht.
|
||||
- **Aus Hub nehmen** versteckt eine eigene Kür (Admins dürfen alle
|
||||
verstecken). Andere Beta-Konten sehen sie danach nicht mehr.
|
||||
|
||||
## Offene Punkte
|
||||
|
||||
- Godot-Client an die API anbinden (Token im Client speichern, Upload/Download
|
||||
als Paket).
|
||||
- Optional: E-Mail-Versand für Einladungen und Passwort-Reset.
|
||||
- Optional: Quota pro Nutzer, Aufräumen alter Revisionen, Suche nach
|
||||
Kategorien/Saison.
|
||||
|
|
|
|||
|
|
@ -30,6 +30,30 @@ App über den Button **?** in der Statusleiste erreichbar.
|
|||
Konfliktarchiv verschieben. Echte Sync-Konflikte löst die App automatisch
|
||||
nach dem neuesten Speicherstand auf; die ältere Fassung bleibt im Archiv.
|
||||
|
||||
## Kür-Hub
|
||||
|
||||
Der Kür-Hub ist die gemeinsame Beta-Ablage für Küren und Musik. Er ist kein
|
||||
Cloud-Spiegel und wird getrennt vom Dropbox-/Google-Drive-Sync verbunden:
|
||||
|
||||
1. Im Hub im Browser unter **Konto → API-Tokens** ein Token erzeugen.
|
||||
2. **Datei → Sync-Einstellungen…** öffnen, im Bereich **Kür-Hub (Beta)**
|
||||
Adresse und Token eintragen und **Verbinden & testen** drücken.
|
||||
3. Danach erscheint **Datei → Kür-Hub…**. Ohne erfolgreiche Verbindung wird
|
||||
der Menüpunkt ausgeblendet.
|
||||
|
||||
Im Hub-Dialog siehst du alle veröffentlichten Küren der Beta-Konten. Über
|
||||
**Alle Küren / Meine Küren** und das Suchfeld lässt sich die Liste filtern.
|
||||
**Vom Hub laden** speichert JSON und Musik unter `user://routines/`. Bei
|
||||
gleichen Dateinamen fragt die App nach: **Nummerierte Kopie** legt beide
|
||||
Dateien mit „(Hub 2)“ an und passt die Musikreferenz an; **Überschreiben**
|
||||
ersetzt die vorhandenen Dateien. Musik, die noch eine andere Kür verwendet,
|
||||
wird nie überschrieben.
|
||||
|
||||
**Aktuelle Kür veröffentlichen** lädt die geöffnete, gespeicherte Kür samt
|
||||
Musik in den Hub; die Rechte-Checkbox ist Pflicht. **Aus Hub nehmen**
|
||||
versteckt eine eigene Kür wieder (Admins dürfen alle verstecken). Der Token
|
||||
liegt getrennt von den Cloud-Zugängen in `user://hub.cfg`.
|
||||
|
||||
## Laufwege zeichnen
|
||||
|
||||
- **Linie** und die beiden **Bogen**-Werkzeuge erzeugen eine gerade Strecke
|
||||
|
|
|
|||
10
docs/sync.md
10
docs/sync.md
|
|
@ -2,9 +2,13 @@
|
|||
|
||||
Der Abgleich zwischen Desktop und Tablet läuft **manuell** über den eigenen
|
||||
Cloud-Speicher des Nutzers: Dropbox. Google Drive ist im Code vorbereitet,
|
||||
aber derzeit nicht freigeschaltet. Es gibt kein Konto auf einem
|
||||
Rinkplanner-Server. Jeder Nutzer verbindet sein eigenes Konto; die App
|
||||
speichert nur den Refresh-Token lokal auf dem Gerät.
|
||||
aber derzeit nicht freigeschaltet. Jeder Nutzer verbindet sein eigenes Konto;
|
||||
die App speichert nur den Refresh-Token lokal auf dem Gerät.
|
||||
|
||||
Der **Kür-Hub** ist etwas anderes: eine gemeinsame Beta-Ablage, in der
|
||||
ausgewählte Küren mit anderen Konten getauscht werden. Er ersetzt den
|
||||
Cloud-Sync nicht und wird in den Sync-Einstellungen separat verbunden
|
||||
(siehe [`docs/hub.md`](hub.md)).
|
||||
|
||||
## Einrichten
|
||||
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue