УниПът — Платформа за Кандидат-Студенти

Безплатна платформа, която помага на български ученици да изчислят приемния си бал, да открият подходяща кариера и да сравнят университети — всичко на едно място.

---

Функционалности

• Калкулатор — изчислява точния приемен бал по официалната формула за всяка специалност, като автоматично избира най-добрата оценка за всеки слот
• Кариерен съветник — RIASEC тест в 3 версии (30 / 60 / 90 въпроса), свързващ личностния профил с подходящи специалности (O*NET база)
• Университети — търсене и филтриране по университет, факултет, специалност и град
• Общежития — карта с общежития, цени и условия
• Любими — запазване и сравнение на специалности
• Моите оценки — управление на оценки за повторно изчисление
• Профил — аватар, RIASEC тип, история

---

Технологии

Компонент	Технология
Frontend	React 19 + Vite 6
Routing	React Router 7 (всички маршрути lazy-loaded)
Styling	Tailwind CSS 4 + DaisyUI (dark / nord теми)
Animations	Framer Motion (motion/react) — LazyMotion + domAnimation
3D	Three.js via @react-three/fiber + @react-three/drei
Icons	Lucide React
Backend	Supabase (PostgreSQL + Auth + Storage)
Tests	Vitest + @testing-library/react

---

Маршрути

Маршрут	Достъп	Описание
/	Публичен	Начална страница
/calculator	Публичен	Калкулатор на приемен бал
/universities	Публичен	Търсачка на специалности
/career-advisor	Публичен	RIASEC тест и резултати
/dormitories	Публичен	Общежития
/my-grades	Публичен	Управление на оценки
/about	Публичен	За проекта
/terms	Публичен	Условия за ползване
/privacy	Публичен	Политика за поверителност
/login / /register	Публичен	Автентикация
/forgot-password / /update-password	Публичен	Смяна на парола
/favorites	Изисква вход	Запазени специалности
/profile	Изисква вход	Потребителски профил
/admin	Изисква админ роля	Управление на данни
/admin/reports	Изисква админ роля	Доклади

---

База данни

Основната таблица е public.universities в Supabase:

Колона	Тип	Описание
id	bigint	Първичен ключ
university_name	text	Пълно официално название
city	text	Град
faculty	text	Факултет / направление
specialty	text	Специалност (с вид обучение)
education_level	text	бакалавър / магистър
formula_description	text	Четима формула (показва се в UI)
coefficients	jsonb	Формула като JSONB масив от слотове
max_ball	numeric	Максимален бал

Формат на coefficients

Масив от слотове — за всяка алтернатива се изчислява grade × coef и се взима максимумът:

[
  {"alternatives": [{"key": "exam_mat", "coef": 3}, {"key": "dzi_mat", "coef": 3}]},
  {"alternatives": [{"key": "mat", "coef": 1}]},
  {"alternatives": [{"key": "diploma", "coef": 1}]}
]

Ключовете са дефинирани в src/lib/coefficients_config.js — exam_* за приемни изпити, dzi_* за ДЗИ, без префикс за оценки от диплома.

---

Инсталация

Изисквания: Node.js 18+

git clone <repo-url>
cd Uni-put
npm install

Създай .env в корена:

VITE_SUPABASE_URL=your_supabase_url
VITE_SUPABASE_ANON_KEY=your_supabase_anon_key

npm run dev        # http://localhost:5173
npm run build      # продукционен build
npx vitest run     # тестове

---

Структура на проекта

src/
├── app/              # App.jsx (рутер), main.jsx
├── components/
│   ├── Auth/         # Login, Register, Profile, ForgotPassword, UpdatePassword
│   ├── Calculator/   # Calculator, GradeInputSection, ReportButton
│   ├── CareerAdvisor/# CareerAdvisor, RIASECResults
│   ├── Dormitories/
│   ├── Favorites/
│   ├── MyGrades/
│   ├── Universities/
│   ├── admin/        # AdminDashboard, AdminReports
│   ├── common/       # Header, Footer, Home, About, NotFound, ...
│   └── landing/      # AnoAI, GlobeScene (3D)
├── hooks/            # AuthContext.jsx, useTheme.js
├── lib/              # supabase.js, coefficients_config.js
├── routes/           # ProtectedRoute.jsx, AdminRoute.jsx
└── services/         # universityService.js

---

Алгоритъм на калкулатора

1. Потребителят избира специалност → зарежда се coefficients JSON от Supabase
2. За всеки слот се вземат всички въведени оценки, съответстващи на алтернативите
3. За всяка алтернатива се изчислява grade × coef (всяка алтернатива носи собствен coef); взима се максимумът
4. Сумата от всички слотове е крайният бал
5. Сравнява се с max_ball / 2 (средният бал) — показва се индикатор "Над/Под средното" с разлика в точки