rar-autopass/docs/ghid-utilizator.md

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.

---

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.

---

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.