Ghid de utilizare

Urmează pașii de mai jos pentru a obține și a valida arhiva cu orare.

Fluxul de lucru

Pregătește fișierul Excel

Fișierul trebuie să fie în format .xlsx.
Prima linie de date (header-ul) trebuie să fie pe linia 2 a tabelului.
Coloanele obligatorii: Subject, Sala, Start Date, End Date, Start Time, End Time, Frecventa.
Coloana Description trebuie să conțină adresa de email a cadrului didactic.

Formatul datelor: Datele pot fi în formatele 10/01/2025 sau 2025-10-01. Orele pot fi scrise ca 08:00 sau 8:00 AM.

Încarcă și validează fișierul

Accesează pagina Upload din meniul principal de navigare.
Apasă butonul Alege Fișier (.xlsx) și selectează fișierul pregătit anterior.
Apasă butonul Previzualizează evenimentele.
Sistemul va prelua datele tale, le va valida și va afișa eventualele erori sau avertismente găsite.

Notă: În cazul erorilor, corectează datele în Excel și reîncarcă fișierul. Avertismentele pot fi ignorate ori rezolvate, la alegerea ta.

Verifică rezultatele

După validarea cu succes, vei fi redirecționat către pagina de previzualizare a datelor.
Verifică statisticile generale și modul în care evenimentele au fost distribuite pe săli.
Fă click pe cardurile reprezentând sălile pentru a vedea detaliat orarul fiecărei săli.
Dacă totul arată corespunzător, ești gata să mergi la pasul de descărcare.

Descarcă arhiva finală

Apasă butonul Generează arhiva prezent pe pagina de previzualizare.
Se va descărca automat în calculatorul tău un fișier numit orar_sali.zip, care stochează:
- Un fișier CSV separat pentru fiecare sală procesată (ex: UVT_002.csv).
- Un fișier LOG_Procesare.csv cuprinzând istoricul și statisticile rulării.

Încarcă în Google Calendar

Accesează secțiunea Google Calendar din meniul principal și autentifică-te cu contul instituțional @e-uvt.ro.
Încarcă direct arhiva generată (orar_sali.zip) sau fișiere CSV individuale. Sistemul va extrage automat CSV-urile pe fiecare sală, excluzând fișierul de log (LOG_Procesare.csv), și va propune maparea pe calendare.
Folosește picker-ul integrat cu funcție de căutare pentru a asocia fiecare fișier CSV cu calendarul Google corespunzător.
Apasă Încarcă în Google Calendar. Progresul este transmis în timp real pe ecran (evenimente adăugate, total, eventuale erori).
Buton de Anulare: Dacă observi că ai asociat un calendar greșit sau dorești să oprești procesul, apasă oricând pe Anulează. Upload-ul este stopat instant pe server, iar evenimentele neprocesate nu vor fi adăugate.

Modulul UNO flip (Inversare și Anulare Orare)

Ce este UNO flip: Instrumentul creat pentru a anula sau retrage dintr-un clic un orar încărcat anterior, folosind aceleași fișiere CSV ca referință.
Simulare Dry-Run sigură: Apasă pe Previzualizează UNO flip pentru a analiza fără riscuri starea evenimentelor. Sistemul afișează 4 carduri sintetice (Total CSV, Găsite în Calendar, Lipsă din Calendar, Calendare implicate).
Vizualizare pe Tab-uri și Filtrare Live: Rezultatele sunt grupate în tab-uri dedicate (Evenimente găsite, Negăsite, Sumar calendare) cu căutare instantă în timp real după materie, sală sau cadru didactic.
Ștergere efectivă cu Anulare: La rularea ștergerii (Rulează UNO flip), ai la dispoziție butonul roșu Anulează ștergerea. La apăsare, ștergerea este oprită imediat atât în browser, cât și pe server, protejând evenimentele rămase.

Siguranță garantată: UNO flip șterge doar evenimentele care coincid exact (titlu, dată, ore început/sfârșit) cu cele specificate în CSV. Nicio altă activitate din calendar nu este afectată.

Audit & Curățare Calendar

Apasă pe butonul Audit Calendar din antetul paginii Google Calendar pentru a deschide fereastra de interogare.
Alege calendarul dorit, intervalul de date (ex. semestrul curent) și opțional un cuvânt cheie pentru filtrare.
Poți selecta individual evenimentele folosind căsuțele de bifare sau poți selecta tot lotul.
Apasă Șterge selectate sau Șterge toate pentru curățare rapidă, având de asemenea posibilitatea de a anula ștergerea în curs.

Împărțire săli (Machetă gata multiplicată)

Când se folosește: Dacă primești un orar complet unde datele fiecărei activități sunt deja multiplicate (adică există deja data exactă de început și sfârșit pentru fiecare eveniment în parte, fără a necesita expandare săptămânală pe semestru).
Acces rapid: Accesează pagina Împărțire săli din meniul principal de navigare.
Încărcare flexibilă: Trage fișierul (.xlsx sau .csv) în zona de încărcare. Sistemul detectează automat rândul de antet (chiar dacă fișierul are titluri pe primul rând) și asociază coloanele relevante.
Opțiuni inteligente: Poți alege dacă vrei prefixarea numelui fișierului cu denumirea clădirii (ex: UVT_002.csv), eliminarea duplicatelor identice și ignorarea rândurilor fără sală alocată.
Rezultate & Export: Vezi instant tabelul cu sălile identificate, previzualizezi activitățile fiecărei săli printr-un modal detaliat, poți descărca fișiere CSV individuale sau arhiva completă orar_sali.zip gata de încărcat în Google Calendar.

Întrebări frecvente

Ce fac dacă am o machetă deja multiplicată pe date exacte?

Folosește modulul dedicat Împărțire săli din bara de sus. Încarcă fișierul complet (Excel sau CSV), iar aplicația îl va împărți instant pe săli și clădiri, generând arhiva orar_sali.zip fără a multiplica din nou săptămânile.

Ce se întâmplă dacă anulez un upload sau o ștergere UNO flip?

Operațiunea este întreruptă imediat pe server prin deconectarea stream-ului. Evenimentele care nu au fost încă procesate rămân neatinse în Google Calendar. Pe ecran este afișat un card rezumat cu numărul exact de evenimente procesate până la momentul opririi.

Cum funcționează identificarea în UNO flip?

Sistemul compară cheia logică a evenimentului din CSV (Titlu curs/laborator, Data, Ora de început, Ora de sfârșit și Calendar ID) cu evenimentele deja existente în Google Calendar. Doar potrivirile 1:1 sunt marcate pentru ștergere.

De ce un eveniment apare ca „Negăsit în calendar”?

Acest lucru indică faptul că evenimentul din CSV nu se mai află în Google Calendar (de exemplu, a fost șters manual, mutat la altă oră sau nu a fost încărcat anterior). Nu este o eroare critică, iar sistemul îl ignoră la ștergere.

Cum scap de mesajul „Google nu a verificat aplicația”?

Fiind o aplicație internă universitară dedicată domeniului @e-uvt.ro, administratorul Google Workspace poate marca ID-ul clientului OAuth drept „De încredere” (Trusted) în Consola Admin (admin.google.com → Securitate → Control acces la API → Control acces la aplicații), fără a necesita verificare publică Google.

Fișierul nu se încarcă?

Verifică dacă fișierul este salvat din Excel direct sub formatul .xlsx și asigură-te că antetul (header-ul) cu denumirile fiecărei coloane se află fix pe linia 2 a documentului.

Apare eroare de dată sau oră?

Datele trebuie să fie în format standard (10/01/2025 sau 2025-10-01), iar orele în format 24h sau 12h (08:00 sau 08:00 AM). Formatele neconforme vor fi semnalate cu avertisment sau eroare.

Există conflicte între evenimente?

Platforma semnalează automat dacă mai multe activități se suprapun ca oră și sală. Cel mai sigur mod de a le remedia este din mediul sursă (Excel) și să repeți încărcarea.

Formate acceptate

Tip de dată	Formate permise	Exemple valide
Dată	MM/DD/YYYY M/D/YYYY YYYY-MM-DD	`10/01/2025` `1/5/2025` `2025-10-01`
Oră	HH:MM H:MM HH:MM AM/PM	`08:00` `8:00 AM` `02:30 PM`

Atenție la spațiile suplimentare sau la caracterele ascunse din căsuțele din Excel. Ele pot genera erori la validare!