Adds a /help page served from the dashboard navigation, containing the full
Romanian user manual for operators: dashboard, playlist management, adding
media, removing files from playlists, player management, and the advanced
edited-media view.
Implementation notes
- Manual is pre-rendered to HTML with pandoc and shipped as a static asset
(app/static/help/_manual_body.html) rather than parsed at runtime. This
keeps the container free of a Markdown dependency and makes the page render
identically regardless of what is installed.
- /help is login-protected; the sidebar table of contents is derived from the
level-2 headings at request time.
- Screenshots are served from app/static/help/screenshots/ (32 images).
- Regenerate after editing the manual:
documentatie/convert_help_page.sh
docker compose up -d --build
Also adds
- backup_players_playlists.sh / restore_database.sh for DB backup and restore.
- .gitignore rules so local database backups (real production data), generated
.docx files and duplicate screenshot copies are never committed.
24 KiB
Manual de Utilizare – DigiServer v2
Versiune document: 1.0 Data: Septembrie 2026 Aplicație: DigiServer v2 – Sistem de management al conținutului pentru ecrane digitale (Digital Signage)
Cuprins
- Introducere
- Autentificare în aplicație
- Dashboard (Panoul principal)
- Biblioteca de Media
- Adăugarea de Media în sistem
- Managementul Playlist-urilor
- Adăugarea de conținut într-un Playlist
- Ștergerea unui fișier din Playlist
- Reordonarea conținutului în Playlist
- Managementul Playerelelor
- Vizualizarea fișierelor editate pe Player (funcție avansată)
- Administrare
- Întrebări frecvente și depanare
1. Introducere
DigiServer v2 este o aplicație web folosită pentru a gestiona conținutul afișat pe ecranele digitale (playere). Cu ajutorul ei puteți:
- Încărca fișiere media (imagini, videoclipuri, documente PDF, prezentări PowerPoint)
- Crea playlist-uri – liste ordonate de conținut care se afișează pe ecrane
- Atribui playlist-uri către playere specifice
- Urmări automatizarea și starea playerelor
- Vizualiza și gestiona versiunile editate ale fișierelor de pe playere
Structura generală a aplicației
┌─────────────────────────────────────────────────────────┐
│ UTILIZATOR (browser) │
│ │ │
│ ▼ │
│ DigiServer (interfață web) │
│ │ │
│ ├──► Biblioteca de Media (fișiere) │
│ ├──► Playlist-uri (liste de redare) │
│ └──► Playere (ecrane fizice) │
└─────────────────────────────────────────────────────────┘
Roluri de utilizator
| Rol | Drepturi |
|---|---|
| Admin | Acces complet: utilizatori, setări sistem, HTTPS, playere, conținut |
| Editor | Poate încărca conținut, crea playlist-uri și edita playere |
| Utilizator | Poate vizualiza conținut și playlists |
2. Autentificare în aplicație
2.1. Deschiderea aplicației
Deschideți un browser (Chrome, Firefox sau Edge) și accesați una dintre adresele:
- Prin adresă IP:
https://10.76.152.164 - Prin nume gazdă:
https://digiserver - Prin domeniu:
https://digiserver.sibiusb.harting.intra
Notă: Dacă browserul afișează un avertisment de certificat („Conexiunea nu este privată"), acest lucru este normal pentru rețeaua internă. Apăsați „Avansat" → „Continuă către...". Administratorul de rețea poate instala certificatul intern pentru a elimina acest avertisment.
2.2. Ecranul de autentificare
Figura 1 – Ecranul de login
Introduceți:
- Nume utilizator (username)
- Parolă
- Apăsați butonul „Autentificare" / „Login"
Important: Dacă ați uitat parola, contactați administratorul sistemului. Parola poate fi schimbată ulterior din meniul de cont.
2.3. Schimbarea parolei
După prima autentificare, se recomandă schimbarea parolei:
- Accesați meniul de utilizator (colț dreapta-sus)
- Selectați „Schimbă parola" / „Change Password"
- Introduceți parola veche, apoi parola nouă (de două ori)
- Confirmați
Figura 2 – Schimbarea parolei
3. Dashboard (Panoul principal)
După autentificare, sunteți redirecționat către Dashboard – pagina principală a aplicației.
Figura 3 – Dashboard-ul principal
3.1. Elementele Dashboard-ului
Dashboard-ul oferă o imagine de ansamblu asupra sistemului:
| Element | Descriere |
|---|---|
| Statistici | Număr de playere, playlist-uri, fișiere media |
| Stare playere | Care playere sunt online / offline |
| Acțiuni rapide | Butoane pentru adăugare rapidă de conținut |
| Meniu de navigare | Acces către toate secțiunile aplicației |
3.2. Meniul principal de navigare
Meniul din partea stângă (sau de sus) conține:
| Secțiune | Funcție |
|---|---|
| Dashboard | Pagina principală cu statistici |
| Media Library (Biblioteca de Media) | Toate fișierele încărcate |
| Playlists | Gestionarea listelor de redare |
| Players (Playere) | Gestionarea ecranelor |
| Admin | Setări de sistem (doar pentru administratori) |
3.3. Cum citiți statisticile
- Playere (Players): Numărul total de ecrane configurate
- Playlist-uri: Numărul de liste de redare existente
- Media: Numărul total de fișiere încărcate
Apăsați pe orice statistică pentru a accesa secțiunea corespunzătoare.
4. Biblioteca de Media
Biblioteca de Media conține toate fișierele încărcate în sistem: imagini, videoclipuri, documente PDF și prezentări.
Figura 4 – Bibliotecac de Media
4.1. Accesarea bibliotecii
Din meniul principal, selectați „Media Library" sau accesați direct /media-library.
4.2. Informații afișate pentru fiecare fișier
| Coloană / Element | Semnificație |
|---|---|
| Nume fișier | Numele original al fișierului încărcat |
| Tip | Imagine / Video / PDF / Prezentare |
| Dimensiune | Mărimea fișierului |
| Data încărcării | Când a fost adăugat în sistem |
| Previzualizare | Miniatură pentru imagini și videoclipuri |
4.3. Filtrarea și căutarea
- Folosiți bara de căutare pentru a găsi un fișier după nume
- Folosiți filtrele pentru a afișa doar un anumit tip (imagini, videoclipuri etc.)
4.4. Ștergerea unui fișier din bibliotecă
Atenție: Ștergerea din bibliotecă este permanentă. Dacă fișierul este folosit într-un playlist, acesta va apărea ca lipsă.
- Găsiți fișierul în listă
- Apăsați butonul Ștergere (iconiță coș de gunoi / X)
- Confirmați ștergerea
Figura 5 – Accesarea butonului de ștergere
Figura 6 – Confirmarea ștergerii
5. Adăugarea de Media în sistem
5.1. Deschiderea formularului de încărcare
Din meniul principal selectați „Upload Media" sau accesați pagina de încărcare.
Figura 7 – Pagina de încărcare media
5.2. Tipuri de fișiere acceptate
| Categorie | Formate acceptate |
|---|---|
| Imagini | PNG, JPG, JPEG, GIF, BMP |
| Video | MP4, AVI, MKV, MOV, WEBM |
| Documente | |
| Prezentări | PPT, PPTX |
5.3. Pașii pentru încărcare
- Apăsați zona de selecție sau butonul „Alege fișier"
- Selectați fișierul (sau mai multe fișiere) din calculator
- Așteptați finalizarea încărcării
- Veți primi confirmarea că fișierul a fost adăugat
Figura 8 – Selectarea fișierului
5.4. Confirmarea încărcării
După finalizarea încărcării, aplicația afișează un banner verde de confirmare cu mesajul „Successfully uploaded", care indică playlist-ul în care a fost adăugat fișierul.
Figura 9 – Bannerul „Successfully uploaded"
5.5. Adăugarea unui link web (Web Link)
Pe lângă fișiere, puteți adăuga și adrese web care să fie afișate pe ecrane.
- Selectați opțiunea „Add Web Link" / „Adaugă link web"
- Introduceți URL-ul complet (ex:
https://www.exemplu.ro) - Dați un titlu pentru link
- Salvați
Figura 10 – Adăugarea unui link web
Sfat: Limita maximă pentru un fișier este de 2 GB. Pentru fișiere foarte mari, împărțiți-le sau contactați administratorul.
6. Managementul Playlist-urilor
Un playlist este o listă ordonată de conținut care se redă pe un player. Puteți avea mai multe playlist-uri pentru diferite ecrane sau situații.
6.1. Vizualizarea playlist-urilor
Din meniul principal selectați „Playlists".
Figura 9 – Lista playlist-urilor
Aici vedeți toate playlist-urile existente, cu:
| Element | Descriere |
|---|---|
| Nume | Denumirea playlist-ului |
| Nr. elemente | Câte fișiere conține |
| Player atribuit | Pe ce ecran se redă |
| Acțiuni | Editare, gestionare conținut, ștergere |
6.2. Crearea unui playlist nou
- Apăsați butonul „Creează Playlist" / „Create Playlist"
- Introduceți numele playlist-ului (ex: „Ecran Recepție")
- Opțional: adăugați o descriere
- Apăsați „Salvează"
Figura 10 – Crearea unui playlist
6.3. Gestionarea conținutului unui playlist
Pentru a vedea și edita conținutul unui playlist:
- Găsiți playlist-ul în listă
- Apăsați butonul „Gestionare" / „Manage" (sau numele playlist-ului)
- Se deschide pagina de management a conținutului
Figura 12 – Accesarea managementului
Figura 13 – Conținutul playlist-ului
6.4. Ștergerea unui playlist
- Găsiți playlist-ul în listă
- Apăsați butonul Ștergere
- Confirmați
Atenție: Ștergerea unui playlist nu șterge fișierele media. Doar lista de redare este eliminată.
7. Adăugarea de conținut într-un Playlist
7.1. Pași pentru adăugare
- Deschideți playlist-ul (secțiunea Management)
- Apăsați „Adaugă conținut" / „Add Content"
- Se afișează lista cu toate fișierele disponibile
- Bifați fișierele dorite (puteți selecta mai multe)
- Apăsați „Adaugă"
Figura 12 – Adăugarea conținutului
7.2. Opțiuni per element
După adăugare, pentru fiecare element puteți configura:
| Opțiune | Descriere |
|---|---|
| Durată afișare | Cât timp se afișează elementul (secunde) |
| Fără sunet (Muted) | Dezactivează sunetul pentru acel element |
| Editare permisă | Permite player-ului să editeze fișierul local |
Figura 13 – Opțiunile elementelor
7.3. Adăugarea unui link web direct în playlist
- În pagina de management a playlist-ului, apăsați „Adaugă link web"
- Introduceți URL-ul și titlul
- Salvați – link-ul apare în listă ca orice alt element
8. Ștergerea unui fișier din Playlist
8.1. Ștergerea unui singur element
- Deschideți playlist-ul în modul Management
- Găsiți elementul dorit în listă
- Apăsați iconița Ștergere (X / coș de gunoi) de pe rândul respectiv
- Confirmați dacă vi se cere
Figura 14 – Ștergerea unui element
Important: Ștergerea din playlist nu șterge fișierul din Biblioteca de Media. Fișierul rămâne disponibil pentru alte playlist-uri.
8.2. Ștergerea mai multor elemente simultan (Bulk Remove)
Pentru a șterge mai multe fișiere dintr-un playlist:
- În pagina de management, bifați elementele dorite
- Apăsați butonul „Șterge selectate" / „Bulk Remove"
- Confirmați operațiunea
Figura 15 – Ștergerea în masă
8.3. Diferența: ștergere playlist vs. ștergere fișier
| Acțiune | Efect |
|---|---|
| Ștergere element din playlist | Elementul dispare din listă; fișierul rămâne în bibliotecă |
| Ștergere fișier din bibliotecă | Fișierul dispare complet; apare ca lipsă în toate playlist-urile |
| Ștergere playlist | Lista dispare; toate fișierele rămân în bibliotecă |
9. Reordonarea conținutului în Playlist
Ordinea elementelor determină ordinea de afișare pe ecran.
9.1. Reordonare prin tragere (drag & drop)
- Deschideți playlist-ul în modul Management
- Apăsați și țineți apăsat pe iconița de mâner (⋮⋮) din dreptul unui element
- Trageți elementul în poziția dorită
- Ordinea se salvează automat
Figura 16 – Reordonarea elementelor
9.2. Verificarea ordinii
După reordonare, verificați că numerele de ordine (1, 2, 3...) corespund intenției dvs.
10. Managementul Playerelelor
Playerele sunt ecranele fizice care afișează conținutul.
10.1. Lista playerelor
Din meniul principal selectați „Players".
Figura 17 – Lista playerelor
| Coloană | Semnificație |
|---|---|
| Nume | Denumirea player-ului |
| Locație | Unde este amplasat ecranul |
| Adresă IP | Adresa de rețea a player-ului |
| Playlist atribuit | Ce conținut redă |
| Stare | Online / Offline / Stare deploy |
10.2. Adăugarea unui player nou
- Apăsați „Adaugă Player" / „Add Player"
- Completați:
- Nume (ex: „Ecran Hol Principal")
- Adresă IP
- Locație (opțional)
- Salvați
Figura 20 – Formularul de adăugare player
Figura 21 – Formularul completat
10.3. Editarea unui player
- Apăsați „Editare" / „Edit" pe rândul player-ului
- Modificați câmpurile dorite
- Salvați
10.4. Atribuirea unui playlist unui player
- În lista de playere, găsiți player-ul dorit
- Apăsați „Atribuie Playlist" / „Assign Playlist"
- Selectați playlist-ul din listă
- Confirmați
Figura 22 – Selectarea playlist-ului
Figura 23 – Confirmarea atribuirii
Notă: După atribuire, player-ul va prelua noul conținut la următoarea sincronizare.
10.5. Starea de deployment
Fiecare player are o stare de deployment care arată dacă conținutul a fost trimis cu succes:
| Stare | Semnificație |
|---|---|
| ✓ Succes | Conținutul a fost trimis cu succes |
| ⏳ În așteptare | Se așteaptă sincronizarea |
| ✗ Eroare | Trimiterea a eșuat – verificați mesajul |
10.6. Regenerarea cheii de autentificare
Dacă un player nu se mai poate conecta:
- Găsiți player-ul în listă
- Apăsați „Regenerează autentificare" / „Regenerate Auth"
- Confirmați – se va genera o cheie nouă
Atenție: Va trebui să actualizați cheia și pe player-ul fizic.
11. Vizualizarea fișierelor editate pe Player (funcție avansată)
Această funcție vă permite să vedeți ce versiuni editate ale fișierelor există pe fiecare player. Este utilă când un player modifică local fișierele (de exemplu, suprapune informații, ajustează rezoluția etc.).
11.1. Accesarea raportului de fișiere editate
- Accesați secțiunea Players
- Găsiți player-ul dorit
- Apăsați „Fișiere editate" / „Edited Media"
Figura 20 – Fișierele editate
11.2. Ce afișează această pagină
| Element | Descriere |
|---|---|
| Fișier original | Fișierul din biblioteca centrală |
| Versiune editată | Fișierul modificat pe player |
| Data editării | Când a fost modificat |
| Status | Sincronizat / Diferit / Lipsă |
11.3. Raportul detaliat
Pentru o vedere completă:
- Apăsați „Raport fișiere editate" / „Edited Media Report"
- Se generează un raport cu toate diferențele
Figura 26 – Raportul fișierelor editate
Figura 27 – Detaliu din raport
11.4. Interpretarea statusurilor
| Status | Ce înseamnă | Ce faceți |
|---|---|---|
| Sincronizat | Fișierul de pe player corespunde cu cel central | Nimic – este în regulă |
| Diferit | Fișierul a fost editat pe player | Decideți dacă păstrați sau resincronizați |
| Lipsă | Fișierul lipsește de pe player | Resincronizați player-ul |
11.5. Vizualizare în mod ecran complet (Fullscreen)
Pentru a vedea cum arată conținutul pe player:
- În lista de playere, apăsați „Ecran complet" / „Fullscreen"
- Se deschide o previzualizare la scară
Figura 22 – Previzualizarea fullscreen
12. Administrare
Această secțiune este disponibilă doar pentru administratori.
12.1. Managementul utilizatorilor
Admin → Users
- Creați utilizatori noi
- Modificați roluri (Admin / Editor / Utilizator)
- Resetați parole
- Ștergeți utilizatori
Figura 28 – Lista utilizatorilor
Figura 29 – Editarea unui utilizator
12.2. Setări HTTPS
Admin → HTTPS Configuration
Aici configurați certificatul SSL/TLS pentru acces securizat:
- Hostname – numele serverului
- Adresă IP – IP-ul serverului
- Domeniu – domeniul (lăsați gol pentru rețea internă)
- Email – pentru notificări certificat
Figura 24 – Configurarea HTTPS
Important: Când mutați serverul în rețeaua de producție, setați IP-ul corect (
10.76.152.164).
12.3. Personalizare logo
Admin → Customize Logos
- Încărcați logo pentru antet (header)
- Încărcați logo pentru ecranul de login
12.4. Dependențe și unelte
Admin → Dependencies
Permite instalarea de unelte opționale:
| Unealtă | Rol |
|---|---|
| LibreOffice | Conversie automată PPT/PPTX în imagini |
| Emoji Fonts | Afișarea corectă a emoji-urilor |
Figura 25 – Instalarea dependențelor
12.5. Media rămasă fără utilizare
Admin → Leftover Media
Afișează fișierele care nu mai sunt folosite în niciun playlist. Le puteți șterge pentru a elibera spațiu.
12.6. Jurnale de sistem (Logs)
Admin → System Info / Logs
Vedeți activitatea sistemului și eventualele erori.
13. Întrebări frecvente și depanare
13.1. Nu mă pot autentifica
Simptom: Parola este respinsă. Soluție:
- Verificați că scrieți corect numele de utilizator și parola (atenție la majuscule)
- Dacă ați uitat parola, contactați administratorul
- Verificați că accesați adresa corectă (cu
https://)
13.2. Browserul afișează avertisment de certificat
Simptom: „Conexiunea nu este privată" / „Nu este sigur". Soluție: Acest lucru este normal pentru rețeaua internă. Apăsați „Avansat" → „Continuă către...". Administratorul de rețea poate furniza un certificat intern pentru a elimina avertismentul.
13.3. Fișierul nu se încarcă
Simptom: Încărcarea eșuează sau se blochează. Soluție:
- Verificați că fișierul este sub limita de 2 GB
- Verificați că formatul este acceptat (PNG, JPG, MP4, PDF, PPT etc.)
- Verificați conexiunea la rețea
- Încercați din nou; dacă persistă, contactați administratorul
13.4. Player-ul nu afișează conținutul nou
Simptom: Ați schimbat playlist-ul, dar ecranul afișează vechiul conținut. Soluție:
- Verificați că playlist-ul este atribuit player-ului
- Verificați starea de deployment a player-ului
- Așteptați următoarea sincronizare (poate dura câteva minute)
- Dacă persistă, verificați că player-ul este online și accesibil în rețea
13.5. Am șters un fișier din bibliotecă din greșeală
Simptom: Fișierul apare ca „lipsă" în playlist-uri. Soluție: Reîncărcați fișierul în bibliotecă și adăugați-l din nou în playlist. Dacă aveți un backup, contactați administratorul.
13.6. Playlist-ul se redă în ordine greșită
Simptom: Elementele apar în altă ordine decât ați stabilit. Soluție: Verificați ordinea în pagina de Management a playlist-ului și reordonați folosind drag & drop. Confirmați că ordinea s-a salvat.
13.7. Fișierele editate nu corespund
Simptom: Raportul de fișiere editate arată diferențe neașteptate. Soluție: Consultați secțiunea 11.4 pentru interpretarea statusurilor. Decideți dacă resincronizați player-ul.
Anexă A – Glosar de termeni
| Termen | Explicație |
|---|---|
| Media | Fișier (imagine, video, document) încărcat în sistem |
| Playlist | Listă ordonată de conținut care se redă pe un ecran |
| Player | Dispozitivul/ecranul fizic care afișează conținutul |
| Deployment | Procesul de trimitere a conținutului către player |
| Dashboard | Pagina principală cu statistici |
| Bibliotecă de Media | Colecția tuturor fișierelor încărcate |
| Bulk Remove | Ștergerea mai multor elemente simultan |
| Edited Media | Versiunile modificate local ale fișierelor, de pe player |
| Web Link | Adresă web afișată ca element în playlist |
Anexă B – Lista capturilor de ecran necesare
Salvați capturile în folderul documentatie/screenshots/ cu numele exacte de mai jos:
| Nr. | Nume fișier | Secțiune | Ce trebuie să conțină |
|---|---|---|---|
| 1 | 01-login.png |
2.2 | Ecranul de autentificare |
| 2 | 02-change-password.png |
2.3 | Formularul de schimbare parolă |
| 3 | 03-dashboard.png |
3 | Dashboard-ul complet |
| 4 | 04-media-library.png |
4 | Lista fișierelor media |
| 5 | 05-delete-file.png |
4.4 | Confirmarea ștergerii |
| 6 | 06-upload-media.png |
5.1 | Formularul de încărcare |
| 7 | 07-upload-progress.png |
5.3 | Progresul încărcării |
| 8 | 08-add-weblink.png |
5.4 | Formularul de link web |
| 9 | 09-playlists-list.png |
6.1 | Lista playlist-urilor |
| 10 | 10-create-playlist.png |
6.2 | Crearea unui playlist |
| 11 | 11-manage-playlist.png |
6.3 | Managementul conținutului |
| 12 | 12-add-content-to-playlist.png |
7.1 | Selectarea conținutului |
| 13 | 13-content-options.png |
7.2 | Opțiunile unui element |
| 14 | 14-remove-from-playlist.png |
8.1 | Ștergerea unui element |
| 15 | 15-bulk-remove.png |
8.2 | Ștergerea în masă |
| 16 | 16-reorder-playlist.png |
9.1 | Reordonarea elementelor |
| 17 | 17-players-list.png |
10.1 | Lista playerelor |
| 18 | 18-add-player.png |
10.2 | Adăugarea unui player |
| 19 | 19-assign-playlist.png |
10.4 | Atribuirea unui playlist |
| 20 | 20-edited-media.png |
11.1 | Fișierele editate |
| 21 | 21-edited-media-report.png |
11.3 | Raportul detaliat |
| 22 | 22-player-fullscreen.png |
11.5 | Previzualizarea fullscreen |
| 23 | 23-user-management.png |
12.1 | Managementul utilizatorilor |
| 24 | 24-https-config.png |
12.2 | Configurarea HTTPS |
| 25 | 25-dependencies.png |
12.4 | Instalarea dependențelor |
Sfârșitul documentului































