@d3iu/tiktok-quiz 2.1.4 → 2.1.6

package/README.md

@@ -1,4 +1,4 @@
-# TikTok Unified · 2.1.4
+# TikTok Unified · 2.1.6
 
 **Autor: D3iu · [deiu@resita.eu](mailto:deiu@resita.eu)** · Licență AGPL-3.0.
 
@@ -6,7 +6,9 @@ Quiz TikTok LIVE pentru mai mulți creatori, overlay vertical, transmisie RTMP/R
 
 ## Instalare rapidă
 
-Necesită Linux amd64, Node.js 24+, Docker Engine local și Compose 2.30+.
+**Pe Synology instalezi din Container Manager, fără terminal:** [descarcă arhiva pregătită](https://cdn.jsdelivr.net/npm/@d3iu/tiktok-quiz@2.1.6/synology.zip) și urmează secțiunea „Synology NAS fără SSH” de mai jos.
+
+Pentru instalarea prin terminal pe Linux: amd64, Node.js 24+, Docker Engine local și Compose 2.30+.
 
 ```sh
 npm install -g @d3iu/tiktok-quiz
@@ -22,13 +24,90 @@ Asistentul întreabă portul (**8077** implicit), contul inițial, adresa public
 - [Procesul de publicare a versiunilor](https://github.com/d3iu/tiktok-unified/blob/main/docs/RELEASE.md)
 - [Modificări](https://github.com/d3iu/tiktok-unified/blob/main/CHANGELOG.md)
 
-## Portainer și Synology
+## Synology NAS fără SSH — instalare simplă
+
+Compatibilitate vizată: **DS1825+**, DSM **7.4.1-90080 Update 1**, Container Manager, procesor Intel/AMD x86-64. Nu ai nevoie de SSH, Node.js, npm sau cont GitHub pe NAS.
+
+**[Descarcă pachetul Synology](https://cdn.jsdelivr.net/npm/@d3iu/tiktok-quiz@2.1.6/synology.zip)** · [descărcare alternativă](https://unpkg.com/@d3iu/tiktok-quiz@2.1.6/synology.zip)
+
+1. Descarcă ZIP-ul pe calculator și extrage-l. Păstrează fișierele din arhivă împreună.
+2. Deschide **`configure.html`** în browserul calculatorului. Completează emailul administratorului, parola și portul (implicit **8077**), apoi apasă **Descarcă compose.yaml**. Configuratorul funcționează local, fără să trimită datele pe internet.
+3. Înlocuiește fișierul `compose.yaml` din folderul extras cu cel generat. Dacă browserul l-a redenumit `compose (1).yaml`, redenumește-l în `compose.yaml`.
+4. În DSM → **File Station**, creează `/volume1/docker/tiktok-unified` și încarcă în el **`compose.yaml` și `seccomp.json`**. Nu este nevoie să încarci configuratorul HTML pe NAS.
+5. În **Container Manager → Project → Create**, alege numele `tiktok-unified`, folderul de mai sus și fișierul Compose existent (sau încarcă același fișier dacă interfața cere Upload). Confirmă crearea și pornirea proiectului.
+6. Deschide **`http://IP-NAS:8077`**, folosind portul ales, și autentifică-te cu datele introduse.
+
+Gata: Container Manager descarcă imaginea publică și pornește aplicația. Datele sunt păstrate într-un volum Docker dedicat proiectului. **Nu modifica numele proiectului și nu șterge volumul la actualizare.** Parola există în fișierul Compose generat; păstrează-l privat.
+
+Alternativ, poți completa direct `ADMIN_EMAIL` și `ADMIN_PASSWORD` în secțiunea `environment:` a fișierului Compose din editorul Container Manager, fără configurator. Pentru o instalare existentă, păstrează configurația și volumul actual; nu crea un proiect nou peste datele ei. Pe Synology, actualizează imaginea din Container Manager, cu aplicația oprită și datele salvate. Nu este necesar agentul npm.
+
+Arhiva include profilul seccomp necesar browserului. Nu activează modul privilegiat și nu dezactivează sandbox-ul. Configurația este verificată în Docker Linux; funcționarea și performanța pe un NAS fizic depind de kernelul DSM și resursele disponibile.
+
+## Environment: variabile și configurare
+
+`environment:` reprezintă variabilele primite de container. Un fișier `.env` este doar una dintre metodele de furnizare a valorilor; **nu este obligatoriu în Portainer sau Synology**.
+
+### Variabilele aplicației
+
+| Variabilă | Exemplu / implicit | Ce configurează |
+| --- | --- | --- |
+| `ADMIN_EMAIL` | `admin@exemplu.ro` | Email obligatoriu pentru crearea primului administrator |
+| `ADMIN_PASSWORD` | alegi o parolă de minimum 12 caractere | Obligatorie la prima pornire; nu folosi o parolă din exemple |
+| `PUBLIC_URL` | gol sau `https://quiz.exemplu.ro` | Originea publică inițială, fără cale; ulterior setarea salvată din panou are prioritate |
+| `COOKIE_SECURE` | `false` | `true` numai când accesezi panoul prin HTTPS configurat în proxy |
+| `EULER_API_KEY` | gol | Cheie opțională, dacă serviciul de conectare TikTok o cere |
+| `MAX_ACTIVE_BROADCASTS` | `1` pe NAS / `2` la instalarea npm | Limita inițială a sesiunilor media simultane; se poate gestiona ulterior din admin |
+| `YOUTUBE_LOGIN_IDLE_SECONDS` | `180` | Expirarea ferestrei de conectare YouTube, în secunde |
+| `PORT` | `3000` | Portul **intern** al aplicației; păstrează valoarea |
+| `DB_PATH` | `/app/data/quiz.sqlite` | Baza de date din volumul persistent; păstrează valoarea |
+| `DEPLOYMENT_MODE` | `synology` / `portainer` | Indică managerul care se ocupă de actualizare; template-ul îl setează automat |
+
+### Parametrii Docker/Compose
+
+Aceste opțiuni configurează containerul și **nu se aplică dacă le adaugi doar în Environment-ul containerului**:
 
-Poți configura aplicația direct prin Environment în manager, fără npm sau un `.env` obligatoriu. Sunt disponibile template-uri și arhive dedicate pentru Linux x86-64: [instrucțiuni Portainer/Synology](https://github.com/d3iu/tiktok-unified/blob/main/docs/MANAGERS.md).
+| Parametru | Implicit | Unde se aplică |
+| --- | --- | --- |
+| `HOST_PORT` | `8077` | Port pe gazdă în installer/stack Portainer; pe Synology, prima valoare din `ports: "8077:3000"` |
+| `BIND_ADDRESS` | `0.0.0.0` | Adresa de ascultare pe gazdă; `127.0.0.1` permite numai acces local |
+| `APP_VERSION` | versiunea template-ului | Tag-ul imaginii în stack-ul Portainer; pe Synology editezi `image:` |
+| `SHM_SIZE` | `1gb` | Câmpul Compose `shm_size`, folosit de browsere |
+| `MEMORY_LIMIT` | `3g` | Câmpul Compose `mem_limit` |
+| `CPU_LIMIT` | `4.0` în installer | Câmpul `cpus` din instalarea npm; template-urile NAS nu impun o limită CPU implicită |
+| `PIDS_LIMIT` | `1024` | Numărul maxim de procese |
+
+### Cum setezi valorile
+
+**Prin instalatorul npm:** rulează `tiktok-quiz install` și răspunde la întrebări. Pentru schimbări ulterioare:
+
+```sh
+tiktok-quiz configure --dir /cale/catre/instalare
+```
+
+Installerul generează `.env` și `.runtime.env` cu permisiuni private. Dacă editezi manual `.env`, rulează apoi `tiktok-quiz start --dir /cale/catre/instalare` pentru sincronizare și aplicare. Oprește întâi activitățile LIVE. Nu distribui aceste fișiere.
+
+**Prin Portainer:** la **Stacks → Add stack → Environment variables**, adaugă perechi nume/valoare sau folosește **Load variables from .env file**. Template-ul Portainer referă explicit aceste variabile. La actualizarea valorilor, actualizează/recreează stack-ul păstrând volumul. Tokenul pentru accesul la repository-ul GitHub privat se introduce în configurarea Git a Portainer, nu în Environment-ul aplicației.
+
+**Prin Synology:** folosește configuratorul local de mai sus sau editează **Project → YAML Configurations → `environment:`**. În crearea unui container individual, variabilele sunt în **Advanced settings → Environment**; pentru joc și broadcast complet recomandăm **Project**, deoarece păstrează și profilul seccomp, memoria partajată și volumul.
+
+Exemplu de editare directă în YAML:
+
+```yaml
+environment:
+  ADMIN_EMAIL: "admin@exemplu.ro"
+  ADMIN_PASSWORD: "" # completează cu parola proprie, minimum 12 caractere
+  PUBLIC_URL: ""
+  COOKIE_SECURE: "false"
+  MAX_ACTIVE_BROADCASTS: "1"
+```
+
+În câmpurile Environment ale interfețelor introduci valoarea **fără ghilimele suplimentare**. În YAML citează șirurile; un dolar literal se scrie `$$` pentru a evita interpretarea Compose. Configuratorul Synology face automat această conversie. Emailul/parola bootstrap sunt folosite numai la crearea administratorului inițial: schimbarea lor în Environment **nu resetează conturile existente**. Parolele existente se schimbă din aplicație.
 
 ## Actualizare
 
-Din contul de administrator: **Actualizare → Actualizează aplicația**. Sau:
+**Instalări Synology/Portainer:** actualizează imaginea din managerul respectiv, păstrând volumul și configurația.
+
+**Instalări făcute prin npm:** din contul de administrator: **Actualizare → Actualizează aplicația**. Sau:
 
 ```sh
 tiktok-quiz update --dir "$HOME/tiktok-unified"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@d3iu/tiktok-quiz",
-  "version": "2.1.4",
+  "version": "2.1.6",
   "description": "Instalare și administrare TikTok Unified prin Docker",
   "type": "module",
   "bin": {
@@ -17,7 +17,9 @@
     "templates/",
     "README.md",
     "LICENSE",
-    "configure.mjs"
+    "configure.mjs",
+    "synology.zip",
+    "portainer.zip"
   ],
   "scripts": {
     "test": "node --test test/*.test.mjs"
@@ -36,9 +38,9 @@
   },
   "tiktokUnified": {
     "schema": 1,
-    "version": "2.1.4",
-    "image": "ghcr.io/d3iu/tiktok-unified:2.1.4",
-    "updaterImage": "ghcr.io/d3iu/tiktok-unified-updater:2.1.4",
-    "notes": "# Modificări\n\n## 2.1.4\n\n- Resolve public installation and updates through npm with private GitHub source\n\n## 2.1.3\n\n- Document authenticated access to private deployment repository\n\n## 2.1.2\n\n- Add environment-based Portainer and Synology DS1825+ deployments\n\n## 2.1.1\n\n- Publish a new stable release automatically after each verified main change\n\n## 2.1.0\n\n- Instalare interactivă prin `@d3iu/tiktok-quiz`, cu port, cont inițial și limite Docker configurabile.\n- Administrare prin terminal: configurare, pornire, oprire, stare, loguri, backup și actualizare.\n- Meniu Actualizare pentru administrator, bazat pe GitHub Releases și imagini GHCR.\n- Backup complet și revenire automată după o actualizare eșuată; blocare în timpul activităților LIVE.\n- Repository public nou și distribuție fără datele private ale instalării autorului.\n- Include funcțiile Quiz, broadcast RTMP/RTMPS, muzică, conturi separate și animații la 30 FPS din versiunea unificată 2.0.0.\n"
+    "version": "2.1.6",
+    "image": "ghcr.io/d3iu/tiktok-unified:2.1.6",
+    "updaterImage": "ghcr.io/d3iu/tiktok-unified-updater:2.1.6",
+    "notes": "# Modificări\n\n## 2.1.6\n\n- Add public offline Synology installer and complete Environment documentation\n\n## 2.1.5\n\n- Document active trusted publishing for the public npm package\n\n## 2.1.4\n\n- Resolve public installation and updates through npm with private GitHub source\n\n## 2.1.3\n\n- Document authenticated access to private deployment repository\n\n## 2.1.2\n\n- Add environment-based Portainer and Synology DS1825+ deployments\n\n## 2.1.1\n\n- Publish a new stable release automatically after each verified main change\n\n## 2.1.0\n\n- Instalare interactivă prin `@d3iu/tiktok-quiz`, cu port, cont inițial și limite Docker configurabile.\n- Administrare prin terminal: configurare, pornire, oprire, stare, loguri, backup și actualizare.\n- Meniu Actualizare pentru administrator, bazat pe GitHub Releases și imagini GHCR.\n- Backup complet și revenire automată după o actualizare eșuată; blocare în timpul activităților LIVE.\n- Repository public nou și distribuție fără datele private ale instalării autorului.\n- Include funcțiile Quiz, broadcast RTMP/RTMPS, muzică, conturi separate și animații la 30 FPS din versiunea unificată 2.0.0.\n"
   }
 }