> ## Documentation Index
> Fetch the complete documentation index at: https://docs.totemdigital.ro/llms.txt
> Use this file to discover all available pages before exploring further.

# Instalare și configurare

> Instalarea pe cPanel sau XAMPP, setările de e-mail, sarcinile automate, utilizatorii și rolurile, datele personale și backup-ul.

## Instalare

**1. Urcați fișierele**

Pe cPanel, într-un folder de pe domeniu (de exemplu `/digimap/turism/`). Cerințe: PHP 7.4 sau mai nou, cu extensiile PDO MySQL, GD, OpenSSL, mbstring.

**2. Creați baza de date**

În cPanel → MySQL Databases: o bază de date și un utilizator cu toate drepturile pe ea.

**3. Rulați instalarea**

Deschideți `install.php` în browser: datele bazei, numele clientului și contul de administrator. Puteți instala și un obiectiv demonstrativ.

**4. Activați HTTPS**

Camera pentru selfie funcționează doar pe HTTPS (cPanel → SSL/TLS Status → AutoSSL).

## E-mail

Felicitările pleacă de pe adresa din **Setări → E-mail**. Ca să nu ajungă în Spam:

* folosiți o adresă de pe domeniul obiectivului sau al instituției (de exemplu `felicitari@domeniu.ro`);
* completați serverul SMTP al adresei (pe cPanel: `mail.domeniu.ro`, port 465 cu SSL sau 587 cu STARTTLS);
* activați SPF și DKIM (cPanel → Email Deliverability);
* trimiteți un **e-mail de test** după orice schimbare.

## Sarcini automate (cron)

În cPanel → Cron Jobs, la fiecare 5 minute, adăugați comanda afișată în **Setări**. Ea trimite felicitările programate, reîncearcă trimiterile eșuate, șterge pozele vechi, trimite rapoartele lunare și alertele de totem și face backup. Fără cron, sarcinile rulează la vizitele în panou și la cererile totemurilor.

## Alte setări

* **Totemuri**: limbile oferite vizitatorilor, timpul de revenire la început, numărul maxim de destinatari.
* **Clientul**: numele și logo-ul instituției (fiecare obiectiv are logo-ul lui).
* **Manual și credit**: adresa acestui manual (butonul Ajutor deschide capitolul potrivit) și textul de credit din subsol.
* **Aspectul panoului**: culoarea (folosită și în e-mailurile de raport), fontul și unul dintre template-urile panoului.

## Utilizatori

| Rol | Ce poate face |
| - | - |
| Administrator | Tot: obiective, totemuri, utilizatori, setări, backup, licență. |
| Editor | Felicitări, felicitări trimise, carte de oaspeți, rapoarte, abonați, vouchere. |
| Casier | Doar validarea voucherelor. |

Editorii și casierii pot fi legați de un singur obiectiv; atunci văd doar datele lui. Sesiunea rămâne activă 12 ore.

## Date personale

* Trimiterea cere acordul explicit, cu linkul spre politica de confidențialitate (din Setări sau a obiectivului). Fără pagină online, textul se poate afișa direct pe totem.
* Pozele și selfie-urile se șterg automat după perioada din Setări (implicit 180 de zile); pagina destinatarului rămâne, cu imaginea obiectivului. Alegeți o perioadă mai lungă decât valabilitatea voucherului.
* Datele unei felicitări se șterg la cerere din **Felicitări trimise**; un abonat se șterge din **Abonați**.
* Totemul nu păstrează nimic: după trimitere sau după inactivitate șterge tot.

## Backup

Aplicația face automat backup al bazei de date, păstrat în folderul ei de pe server; îl descărcați din pagina **Backup**. Pentru restaurare, fișierul `.sql.gz` se importă din phpMyAdmin (Import). Imaginile din folderul `uploads` se salvează cu backup-ul găzduirii (cPanel → Backup).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.