Skip to content
@VSOKO-Project

VSOKO Project

VSOKO

VSOKO

Rating teaching quality at a university

Students rate their teachers and courses. Administrators set the criteria, look at the ratings, export PDF reports, and read AI summaries of the feedback. Built for a university and running in production.

App API

C# ASP.NET Core React TypeScript PostgreSQL Redis Docker Traefik


Why

Universities usually collect feedback on teaching with paper or scattered forms, and then nothing happens with it. VSOKO collects ratings against fixed criteria for every teacher × course × group pair and turns them into rankings, reports, and short summaries the administration can actually use.

How it works

Collect Aggregate Report Summarize
Students rate each of their courses against criteria set by an admin Scores add up to teacher and course ratings; reads are cached An admin exports a PDF report An LLM boils written comments down to a short summary
Architecture
Clean Architecture backend, SPA frontend, and a shared Traefik proxy

A two-level cache (in-memory HybridCache + Redis) cut latency under a 200-user k6 load test from 33 to 13 ms at p95 and from 13 to 5 ms on average.

Repositories

Product
vsoko-backend — REST API: sign-in and roles, feedback, ratings, PDF reports, AI summaries
C# · ASP.NET Core · MediatR · EF Core · PostgreSQL · Redis · QuestPDF · Semantic Kernel
vsoko-frontend — web app: feedback forms for students; criteria, ratings, reports, and summaries for admins
React 19 · TypeScript · Vite · TanStack Query · Zustand · Recharts
Platform
vsoko-infra — reverse proxy with automatic TLS and the shared Docker network; deploy it first
Traefik · Let's Encrypt · Docker Compose

Getting started

I want to… Go to
see it live vsoko.semao0.ru
understand the backend architecture → MediatR pipeline → auth and roles
deploy it myself vsoko-infra → vsoko-api → vsoko-frontend
use the API endpoints

Database schema

ERD
Table What it holds
ApplicationUser User accounts (Identity) for staff and students
Employee / EmployeeRole Staff and their roles
Student / StudentGroup Students and their groups
Teacher · Discipline Teachers and courses
Workload A teacher, course, and group combination
Feedback A student's feedback on one workload
Criteria / CriteriaFeedback Criteria and the score for each one
Refresh JWT refresh tokens

Popular repositories Loading

  1. vsoko-frontend vsoko-frontend Public

    Web UI for VSOKO - student feedback forms and admin dashboards for criteria, ratings, reports and AI summaries. React 19 + TypeScript + Vite.

    TypeScript

  2. vsoko-infra vsoko-infra Public

    Infrastructure for VSOKO - Traefik reverse proxy with automatic TLS, deployed via Docker Compose.

  3. vsoko-backend vsoko-backend Public

    Backend for VSOKO - university education-quality platform in production. One of 3 repos (backend/frontend/infra)

    C#

  4. .github .github Public

    VSOKO - automated education quality assessment platform, built for a university and in production use.

Repositories

Showing 4 of 4 repositories

Top languages

Loading…

Most used topics

Loading…