Ghid pentru utilizatori — Platforma de vot

Acest document explică, pas cu pas, ce poți face în aplicație ca utilizator obișnuit (nu administrator): pagini, butoane, ce vezi pe ecran și cum funcționează votul.

---

1. Ce este platforma

Platforma permite:

• Voturi normale (puncte de vot): întrebări cu Pentru / Împotrivă / Abținere, cu rezultate agregate vizibile (câte voturi pe fiecare opțiune).
• Voturi anonime (ascunse): votul tău nu este legat public de persoana ta; rezultatele sunt afișate fără să se știe cine cum a votat.
• Rezultate live, statistici și arhivă pentru sesiunile de vot trecute.

Conturile administrator au meniuri și drepturi suplimentare; acest ghid le ignoră (vezi Ghid administrator).

---

2. Cum îți faci cont și intri în platformă

2.1. Cerere de înregistrare (request.php sau formularul public de pe site)

1. Completezi formularul cu datele cerute (de regulă legate de identitatea ta în organizație, ex. ID ONCR, email).
2. La trimitere, se creează o cerere în sistem. Vei primi (dacă e configurat) un email cu un link de înregistrare care conține o cheie unică (register.php?key=...).

Ce vezi: mesaje de succes sau eroare (ex. date lipsă, email deja folosit).

2.2. Finalizarea contului (register.php)

1. Deschizi linkul din email (sau îl copiezi în browser). Linkul trebuie să conțină parametrul key=... valid.
2. Alegi nume de utilizator și parolă (de obicei confirmi parola de două ori).
3. Completezi prenume și nume dacă formularul le cere.

Butoane / acțiuni:

• Trimiterea formularului creează utilizatorul în baza de date.
• Contul poate fi creat ca inactiv până când un administrator îl activează — în acest caz nu te poți autentifica până atunci.

Erori frecvente:

• „Username deja existent” — alege alt nume de utilizator.
• „Parolele nu sunt aceleași” — rescrie parola identic în ambele câmpuri.
• „Linkul nu corespunde…” — link expirat sau deja folosit; cere un link nou de la administrator.

2.3. Autentificare (login.php → login_process.php)

1. Introduci nume de utilizator și parolă.
2. Apeși butonul de conectare.

După login:

• Dacă ești admin, ești redirecționat spre panoul de administrare.
• Dacă ești utilizator obișnuit, mergi la pagina Acasă (welcome.php).

Dacă contul este inactiv: vei vedea un mesaj că trebuie activat de un administrator.

2.4. Am uitat parola (password_reset_request.php)

1. Introduci adresa de email asociată contului.
2. Dacă emailul există, primești un mesaj cu un link temporar pentru resetare (reset_password_confirm.php?token=...).
3. Deschizi linkul și setezi o parolă nouă.

Important: linkul are durată limitată (ex. 24 ore). Dacă expiră, repetă cererea.

2.5. Deconectare (logout.php)

Din meniu: Deconectare — sesiunea se închide; trebuie să te autentifici din nou pentru acces.

---

3. Meniul din antet (toți utilizatorii autentificați)

După autentificare, în partea de sus apare bara de navigare (logo + titlu Platforma de Vot).

Pe telefon sau ecran îngust, meniul se ascunde în iconița „hamburger” (trei linii). Apeși pe ea pentru a deschide lista completă (poate fi derulabilă dacă sunt multe opțiuni).

Dacă nu ești autentificat: poți vedea în meniu Autentificare și uneori Rezultate Live (în funcție de configurarea paginii).

---

4. Pagina Acasă (welcome.php)

4.1. Ce afișează sus

• Titlu: Platforma de Vot.
• Sesiune: dacă există o sesiune de vot activă, vezi un badge verde cu numele sesiunii. Dacă nu există, vezi un mesaj că nu e sesiune activă și un link spre Arhivă.

4.2. Secțiunea „Puncte de Vot Active” (voturi normale)

Fiecare card (punct de vot) conține:

• Titlul și descrierea întrebării.
• Statistici: Total voturi, Pentru, Împotrivă, Abțineri (numere actualizate).
• Dacă nu ai votat încă: trei butoane:
• Pentru (verde)
• Împotrivă (roșu)
• Abținere (galben)
• Dacă ai votat deja: un badge care arată cum ai votat (ex. „Votul tău: Pentru”).

Butoanele de vot trimit votul prin aplicație (fără reîncărcare completă a paginii, unde e implementat AJAX). După vot, butoanele dispar și apare badge-ul.

Actualizare automată: la câteva secunde, lista se poate actualiza de la server: apar puncte noi, se actualizează numerele, dispar puncte închise.

Jos la card: data creării punctului.

4.3. Secțiunea „Voturi anonime”

• Explică că participarea e confidențială și că nu se afișează cum ai votat.
• Pentru fiecare vot anonim activ (la care ai dreptul):
• Titlu, tip (Da/Nu sau Candidați), descriere opțională.
• Dacă nu ai votat și poți participa: buton Deschide votul → hidden_vote.php?id=....
• Dacă ai votat: mesaj de tip „Ai participat (vot anonim)” (fără a dezvălui opțiunea).
• Dacă nu poți participa (ex. restricții de rol): mesaj corespunzător.

Lista se poate actualiza automat la fel ca voturile normale.

---

5. Pagina Vot anonim (hidden_vote.php)

Se deschide din Acasă sau din meniul Voturi Anonime.

5.1. Conținut general

• Titlu și descriere ale votului.
• Poate exista imagine asociată.
• Secțiune Participare: text de tip „X din Y utilizatori eligibili au votat” și o bară de progres (fără a dezvălui cine a votat).

5.2. Tip „Da / Nu”

• Dacă votul e deschis și poți vota: formular cu opțiuni Da și Nu (și trimitere).
• După vot: mesaj de succes; se afișează rezultate agregate (ex. procente/totaluri), nu cine cum a votat.

5.3. Tip „Candidați”

• Lista de candidați (nume, eventual imagine).
• Alegi un candidat și trimiți votul.
• Rezultatele arată distribuția pe candidați (tot agregat, anonim).

5.4. Dacă nu poți vota

• Mesaje explicative (vot închis, deja votat, fără drepturi etc.).

---

6. Rezultate live (live_results.php)

6.1. Scop

Vizualizare centralizată a activității: voturi normale în sesiunea curentă, voturi anonime (unde e permis), indicatori rapizi.

6.2. Elemente uzuale

• Buton de tip „Cine a votat / cine nu” pentru voturile normale — deschide un panou (modal) unde poți alege un punct de vot și vezi:
• cine a votat (nume afișate conform politicii platformei),
• cine nu a votat încă, în rândul utilizatorilor eligibili (în mod tipic membri activi, fără administratori în lista de eligibili).
• Voturile anonime: nu există listă „cine a votat” — doar totaluri / participare estimată.
• Carduri cu puncte active: titlu, distribuție Da/Nu/Abținere sau, pentru candidați, rezultate pe candidat.
• Actualizare: pagina se poate reîmprospăta automat (JSON) ca să vezi date proaspete.

---

7. Statistici (statistics.php)

• Grafice și cifre despre voturi, sesiune, tendințe (ex. ultimele zile).
• Conținutul depinde de implementarea curentă (Chart.js etc.), dar ideea este rezumat vizual al activității, filtrat pe sesiunea de vot activă (sau regulile echivalente din cod).

---

8. Arhivă (archive.php și archive_session.php)

8.1. archive.php

• Lista sesiunilor de vot (active trecute, arhivate).
• Poți deschide o sesiune pentru a vedea ce s-a votat în acea perioadă (puncte normale și, unde e cazul, voturi anonime rezumate).

8.2. archive_session.php

• Detaliu pentru o sesiune selectată: puncte de vot, descrieri, rezultate istorice.

---

9. Eligibilitate la vot (pe scurt)

• La voturile normale și la participare afișată public, „eligibili” sunt de obicei utilizatorii activi cu rol de membru/utilizator, nu administratorii (conform setărilor actuale ale platformei).
• Administratorii pot totuși avea alte drepturi în sistem; detaliile exacte sunt în ghidul de administrare.

---

10. Probleme frecvente (utilizatori)

---

11. Fișiere utile (referință tehnică scurtă)