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.
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.
| 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 |
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.
| Product |
|---|
| vsoko-api — 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 Vue 3 · TypeScript · Vite · Vue Router · Reka UI |
| Documentation |
| specs — roles, feedback periods, Excel import/export, architecture, API integration and operations Markdown · Mermaid · Source links |
| Platform |
| vsoko-infra — PostgreSQL, Redis and secrets in the shared k3s cluster; deploy it first k3s · GitLab Agent · External Secrets · cluster Traefik / TLS |
| I want to… | Go to |
|---|---|
| try the running app | vsoko.tech — student feedback and administrator workspace |
| understand the product | roles and feedback → periods and Excel import |
| understand the system | service map → data model → flows |
| run locally or deploy | run and deploy → infra setup and Variables |
| use the API | HTTP and authentication — routes, sessions, envelopes, sorting and source contracts |
| diagnose a failure | troubleshooting — permissions, imports, AI and configuration |
| 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 |

