Informatii generale
- Categorie: Web
- Judetul: Suceava
- Surse: GitHub - nmt65/unitracka · GitHub
- Homepage: https://unitrack.sbs
Descriere
UniTrack este o platformă web dedicată procesului de admitere la universități, creată pentru a rezolva problema organizării dosarelor, documentelor și termenelor limită pe mai multe platforme diferite. Elevii pot urmări universitățile la care vor să aplice, pot compara programe, pot vedea ce documente lipsesc, pot trimite aplicații și pot primi notificări despre deadline-uri sau schimbări de status.
Platforma include un sistem de conturi cu roluri diferite pentru student, universitate și administrator. Studentul își gestionează profilul, documentele, aplicațiile și opțiunile de admitere, universitatea primește dosarele candidaților într-un workspace dedicat, iar administratorul controlează catalogul de universități, programele, conturile instituționale și setările platformei. UniTrack include și funcții de verificare asistată de inteligență artificială pentru documente, astfel încât aplicația să poată identifica dacă un fișier încărcat corespunde tipului cerut, precum diplomă BAC, foaie matricolă, CV, certificat lingvistic sau alte documente necesare admiterii.
Scopul proiectului este să ofere un sistem modern, centralizat și ușor de folosit pentru admitere, în care elevii nu mai trebuie să își țină informațiile separat în tabele, notițe sau platforme diferite. Prin dashboard, calendar, notificări, comparații și asistentul pentru dosar, UniTrack ajută candidatul să vadă rapid ce are de făcut și reduce riscul de a rata un document sau un deadline important.
Tehnologii
Frontend (Interfața Utilizatorului)
• React – Biblioteca principală folosită pentru construirea interfeței. Aplicația este organizată pe componente reutilizabile pentru dashboard, profil, documente, universități, comparații, calendar, autentificare și workspace-ul universităților.
• Vite – Tool-ul folosit pentru dezvoltarea și construirea frontend-ului. Oferă pornire rapidă în development, build optimizat pentru producție și o structură modernă pentru aplicații React.
• JavaScript ES Modules – Limbajul principal al aplicației frontend și backend. Proiectul folosește module moderne, separarea logicii pe servicii și componente clare.
• CSS custom / Vanilla CSS – Interfața este stilizată cu CSS propriu, fără framework-uri vizuale grele. Acest lucru permite control complet asupra temei dark/light, layout-ului responsive, cardurilor, panourilor, tabelelor, calendarului și designului adaptat pentru desktop și mobil.
• Lucide React – Bibliotecă modernă de iconițe SVG, folosită pentru meniuri, acțiuni, documente, notificări, profil, calendar, comparații și panouri administrative.
Backend & Managementul Datelor
• Node.js – Mediul de rulare pentru backend-ul aplicației. Serverul gestionează autentificarea, utilizatorii, aplicațiile, documentele, notificările, universitățile și funcțiile AI.
• Express.js – Framework-ul backend folosit pentru API-ul REST. Aplicația are endpoint-uri separate pentru autentificare, profil, universități, documente, aplicații, instituții, admin, AI și notificări.
• Sequelize ORM – Sistemul care face legătura între codul aplicației și baza de date relațională. Permite definirea modelelor pentru utilizatori, universități, aplicații, documente, instituții, notificări și audit log.
• SQLite – Baza de date folosită pentru dezvoltare locală, astfel încât proiectul să poată fi rulat rapid pe orice calculator fără configurare complicată.
• PostgreSQL / Supabase – Baza de date recomandată pentru producție. Este folosită pentru stocarea sigură a datelor și suportă politici Row Level Security pentru limitarea accesului la date în funcție de rol.
Autentificare, Securitate și Date Personale
• JWT în cookie httpOnly – Sesiunile utilizatorilor sunt gestionate prin token-uri salvate în cookie-uri securizate, reducând riscul accesării lor din JavaScript.
• bcrypt – Parolele utilizatorilor sunt hash-uite înainte de salvare, astfel încât parola reală nu este stocată niciodată în baza de date.
• CNP hash-uit cu pepper – Pentru a limita crearea mai multor conturi de către același elev, aplicația verifică unicitatea CNP-ului fără a salva CNP-ul în clar.
• Zod – Bibliotecă folosită pentru validarea strictă a datelor primite de backend, prevenind inputuri invalide sau periculoase.
• Helmet, CORS, CSRF și rate limiting – Măsuri de securitate folosite pentru protecție împotriva atacurilor comune, cererilor abuzive și accesului neautorizat.
• Audit log – Acțiunile importante, precum modificările administrative, verificările documentelor și schimbările de status, sunt înregistrate pentru trasabilitate.
Inteligență Artificială și Automatizare
• Gemini API / OpenAI API – Servicii AI folosite pentru verificarea asistată a documentelor și pentru asistentul de admitere al elevului. Sistemul poate analiza dacă un document încărcat pare să corespundă tipului cerut, precum diplomă BAC, foaie matricolă, CV, certificat lingvistic sau scrisoare de motivație.
• Gemini 3.5 Flash – Modelul configurat implicit pentru verificarea documentelor și generarea recomandărilor pentru elevi.
• Fallback local strict – Dacă nu este configurată o cheie AI, aplicația nu aprobă automat documentele sensibile și folosește reguli locale restrictive sau verificare manuală.
Funcționalități ale Platformei
• Dashboard pentru elevi – Afișează progresul aplicațiilor, documentele lipsă, deadline-urile și statusul dosarelor.
• Workspace pentru universități – Universitățile pot vedea aplicațiile primite, pot analiza documentele candidaților și pot actualiza statusul dosarelor.
• Panou de administrator – Administratorul controlează universitățile, programele, conturile instituționale, catalogul public, utilizatorii și setările platformei.
• Calendar de deadline-uri – Elevii pot vedea termenele limită într-un calendar vizual și pot urmări rapid aplicațiile urgente.
• Comparare universități – Platforma permite compararea mai multor universități după program, taxe, deadline, documente, rating și potrivire.
• Notificări interne – Utilizatorii primesc notificări pentru aplicații noi, schimbări de status și evenimente importante.
Hosting & DevOps
• Git / GitHub – Codul sursă este versionat și publicat pe GitHub, împreună cu documentația și fișierele de configurare.
• Render / Vercel / GitHub Pages – Proiectul este pregătit pentru deploy cloud. Backend-ul poate rula pe Render, iar frontend-ul poate fi publicat prin Vercel sau GitHub Pages în modul static.
• Variabile de mediu .env – Cheile API, datele bazei de date, secretele JWT, setările SMTP și configurațiile de producție sunt gestionate separat prin variabile de mediu, fără a fi publicate în cod.
Cerinte sistem
Pentru utilizatorii obișnuiți, UniTrack funcționează direct în browser și nu necesită instalarea unei aplicații separate.
• Hardware: Orice laptop, PC, tabletă sau telefon modern. Pentru administrare și completarea dosarelor este recomandat un ecran mai mare, dar aplicația este responsive și poate fi folosită și pe mobil.
• Sistem de Operare: Independent de platformă. Aplicația poate fi accesată de pe Windows, macOS, Linux, ChromeOS, Android sau iOS.
• Browser: Google Chrome, Microsoft Edge, Mozilla Firefox, Safari sau Opera, într-o versiune actualizată, cu JavaScript activat.
• Rețea: Conexiune stabilă la internet pentru autentificare, încărcarea documentelor, sincronizarea aplicațiilor și folosirea funcțiilor AI.
Pentru rularea locală ca dezvoltator, sunt necesare:
• Node.js 20 sau mai nou.
• npm pentru instalarea dependențelor și rularea scripturilor proiectului.
• SQLite pentru dezvoltare locală, inclus automat prin dependențele proiectului.
• PostgreSQL sau Supabase pentru o configurație apropiată de producție.
• O cheie Gemini sau OpenAI, opțională, pentru verificarea asistată de AI a documentelor și pentru asistentul de admitere.
• Date SMTP, opționale, pentru resetarea parolei și trimiterea emailurilor.
• Visual Studio Code sau alt editor de cod.
• Minimum 8 GB RAM recomandat pentru rularea simultană a frontend-ului, backend-ului, bazei de date locale și editorului.
Realizatori
Luca-Fabian Neamțu
- Scoala: Colegiul Național ,Ștefan cel Mare”
- Clasa: 10
- Judet: Suceava
- Oras: Suceava
Screenshots
