# Ghid de utilizator — RAR AUTOPASS

Ghid simplu pentru service-uri auto. Explica cum trimiti prezentarile catre RAR AUTOPASS
prin aplicatie, cu accent pe cele doua medii: **Testare** si **Productie**.

Fara termeni tehnici. Daca esti dezvoltator si cauti API/instalare, vezi [README.md](../README.md).

---

## Ce face aplicatia

Legea 142/2023 obliga service-urile auto autorizate sa transmita la RAR, la finalul fiecarei
lucrari, datele obligatorii (VIN, kilometraj etc.). Aplicatia asta face transmiterea in locul tau:
tu incarci lucrarile (dintr-un fisier sau din softul tau), iar aplicatia le declara la RAR si iti
arata ce a mers si ce nu.

---

## Cele doua medii: Testare si Productie

La RAR exista **doua sisteme separate**:

- **Testare** — pentru probe. Ce trimiti aici NU e o declaratie oficiala. Bun ca sa te obisnuiesti,
  fara riscuri.
- **Productie** — **real**. Ce trimiti aici e o declaratie oficiala catre RAR, conform legii.
  **Nu se poate anula sau corecta** dupa ce a fost acceptata.

Fiecare mediu are **propriul lui email si parola** de la RAR. Un set de credentiale merge pe exact
un mediu — cele de test nu functioneaza pe productie si invers.

Un mediu e **disponibil** doar cand e activat SI are credentiale valide. Din asta decurge tot ce
poti face: unde trimiti, daca poti alege, ce vezi pe ecran.

---

## Pasul 1 — Configureaza credentialele RAR

Intra in **Cont → Credentiale RAR**. Vezi doua sectiuni: **Testare** si **Productie**. Pentru
fiecare mediu pe care vrei sa-l folosesti:

1. Bifeaza **Activare**.
2. Scrie **emailul si parola** de la RAR pentru acel mediu.
3. Apasa **Salveaza**. Aplicatia incearca un **login de proba** pe RAR:
   - login reusit → credentialele se salveaza (criptat) si mediul devine disponibil;
   - login esuat → primesti eroare pe acel mediu, iar credentialele NU se salveaza.
4. La **prima activare a mediului Productie** trebuie sa bifezi confirmarea: intelegi ca trimiterile
   pe Productie sunt reale, finale si fara anulare (Legea 142).
5. Jos poti alege **Mediul implicit** — cel pe care se trimite automat. Poti alege doar dintre
   mediile disponibile.

Parola nu se afiseaza niciodata inapoi pe ecran; e stocata criptat.

> Un cont nou vine implicit cu **Productie pornit** si **Testare oprit**. Daca vrei sa exersezi
> intai, activeaza Testare si pune-l ca mediu implicit.

---

## Pasul 2 — Cum stii unde trimiti (ca sa nu confunzi testul cu realul)

Doua indicii sunt mereu la vedere:

- **Bara de sus (statusbar)** arata mediul implicit al contului. Daca ai **ambele** medii
  disponibile, apare si un buton **Comuta** ca sa schimbi rapid unde se trimite.
- **Fiecare trimitere are un badge**: `PRODUCȚIE` (rosu, proeminent = real) sau `Testare` (gri,
  discret). Il vezi in liste, in coada, in detaliul trimiterii si in jurnal.

Regula simpla: **rosu = real**. Daca vezi rosu, mergi cu grija.

---

## Pasul 3 — Trimite prezentarile

### Din fisier (Excel / CSV)

Pe dashboard: **incarca** fisierul → **potriveste coloanele** (aplicatia sugereaza singura si tine
minte formatul pentru data viitoare) → **verifica** randurile → **confirma**. Randurile intra in
coada si se trimit.

- Daca ai **un singur mediu** disponibil, totul merge automat acolo.
- Daca ai **doua**, la incarcare apare un **selector de mediu** — alegi unde vrei sa trimiti fisierul
  respectiv.

### Din softul tau (ROAAUTO / soft propriu)

Softul trimite prin cheia API a contului. Poate preciza mediul (`test`/`prod`); daca nu-l precizeaza,
merge pe mediul implicit al contului. Detalii tehnice in [README.md](../README.md).

---

## Ce inseamna starea unei trimiteri

| Stare | Ce inseamna, pe scurt |
|-------|-----------------------|
| **In asteptare** | E in coada, urmeaza sa fie trimisa. |
| **Se trimite** | Se trimite chiar acum. |
| **Declarata la RAR** | Gata, acceptata (are numar de prezentare). Nu se mai poate modifica. |
| **Lipseste codul** | Operatia nu are cod RAR — alege-l in tab-ul **Mapari** si se deblocheaza singura. |
| **Date incomplete** | RAR a respins randul (lipseste ceva) — corecteaza si reincarca. |
| **Eroare** | Trimiterea a esuat si nu se mai reincearca. Vezi detaliul; daca tine de credentiale, corecteaza-le in Cont. |

---

## Jurnal — ce s-a intamplat

Tab-ul **Jurnal** noteaza actiunile importante, cu ora si cont: activarea/dezactivarea unui mediu,
schimbarea mediului implicit, o trimitere blocata pentru ca mediul cerut nu era disponibil. Util cand
vrei sa intelegi „cine, ce, cand".

---

## Intrebari frecvente

**Am pus credentiale si dau eroare la salvare.** Credentialele sunt pentru mediul gresit (test pe
productie sau invers), sau emailul/parola nu sunt corecte. Un set merge pe exact un mediu.

**Sunt client doar cu productie, nu am cont de test.** Normal. Lasa Testare dezactivat si lucreaza pe
Productie. Nu poti activa Testare fara credentiale de test — nu e o eroare, asa e proiectat.

**Am trimis din greseala pe Productie.** La RAR o prezentare acceptata (`FINALIZATA`) e finala si nu
se poate anula prin aplicatie. De aceea Productie e marcat cu rosu peste tot si cere confirmare la
activare. Foloseste Testare cand exersezi.

**Nu vad butonul de comutare a mediului.** Apare doar cand ai **doua** medii disponibile. Cu unul
singur, se trimite automat acolo si nu ai ce comuta.

**Unde vad ce s-a trimis si unde?** In lista de trimiteri de pe dashboard — fiecare rand are badge-ul
de mediu si starea. Pentru verificare independenta direct la RAR, cere-i administratorului lista de
finalizate.