Skip to content

yassinekolsi/hack4ucar

Repository files navigation

UCAR Platform

UCAR Platform is a decision-support system built for the Présidence UCAR to centralize university data, automate reporting, and help leadership act faster across all establishments.

Introduction

UCAR starts with a presidency-level dashboard that brings the main KPIs into one place: success rate, dropout rate, employability, budget consumption, ESG performance, student volume, international conventions, and energy consumption. Instead of fragmented spreadsheets and disconnected reporting, leadership gets one operational command center.

From there, Universites and Comparaison let UCAR review each establishment individually, then benchmark them side by side across academic, financial, and sustainability indicators. This makes it easier to spot gaps, compare performance, and decide where attention is needed most.

One of the most strategic modules is Publications. The platform connects to Semantic Scholar and can scrape a single professor or run in bulk for a whole establishment. It collects publications, citations, authors, venues, and exportable data so UCAR can prepare yearly research reporting faster, track scientific output continuously, and support its international visibility goals.

UCAR also supports day-to-day operations. Etudiants manages enrollment and academic records. Energie tracks consumption and invoices. Documents handles structured collection sheets and validation workflows across departments and institutions.

OCR Scan reduces manual data entry on both mobile and desktop. Staff can scan documents with confidence scoring and offline support, while the desktop flow supports images and PDFs, extracts structured fields, flags warnings, and maps results directly into KPI sheets.

The platform also includes Reclamations for issue escalation and tracking, Analyse Donnees for deeper inspection of uploaded information, Qualite & Normes for readiness indicators around ISO 21001, ISO 9001, and UI GreenMetric, and Predictions IA for forward-looking KPI trajectories and recommended actions.

For leadership, Vue Directeur works like a director copilot. It helps identify missing submissions, detect anomalies, send reminders, review reclamations, approve or reject sheets, and verify whether publication to UCAR headquarters is actually ready.

Assistant IA gives users an interactive copilot for KPI questions, institution comparisons, voice input, and in-chat visual outputs such as line charts and pie charts. Administration completes the platform with role-based control for users, departments, and system settings.

UCAR Platform is not just a dashboard. It is a full ecosystem for collecting data, validating it, analyzing it, reporting it, and turning it into institutional action.

Core Modules

  • Tableau de Bord: consolidated presidency KPI dashboard
  • Universites and Comparaison: establishment analysis and benchmarking
  • Publications: research scraping and export with Semantic Scholar
  • Etudiants, Energie, Documents: operational data management
  • OCR Scan: document digitization, extraction, and KPI mapping
  • Reclamations and Analyse Donnees: issue tracking and deeper inspection
  • Qualite & Normes and Predictions IA: readiness scoring and foresight
  • Vue Directeur: action-oriented workflow supervision
  • Assistant IA: conversational analytics with chart generation
  • Administration: users, departments, roles, and settings

Stack

  • Frontend: Next.js, React, TypeScript, Tailwind CSS, Recharts
  • Backend: FastAPI, SQLAlchemy, PostgreSQL
  • AI and data: Gemini, Semantic Scholar, Qdrant

Run Locally

  1. Create env files:
Copy-Item .env.example .env
Copy-Item backend/.env.example backend/.env
  1. Start infrastructure:
docker compose up postgres qdrant -d
  1. Install dependencies:
npm install
cd backend
python -m venv .venv
.venv\Scripts\activate
pip install -r requirements.txt
  1. Run the apps:
cd backend
uvicorn app.main:app --reload --port 8000
npm run dev

Or use:

.\start.ps1

API

  • Backend docs: http://localhost:8000/docs

Repo Structure

app/          Next.js app
components/   shared UI and workflow components
lib/          frontend utilities and API client
public/       static assets
backend/      FastAPI app, services, models, tests
docs/         supporting documentation

About

1st place winner at Hack4Ucar: AI-powered university decision-support platform centralizing KPIs, benchmarking, and research analytics across institutions.

Resources

Stars

5 stars

Watchers

0 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors