Сайт за визуално сравнение на училищата в България по резултати от Национално външно оценяване (НВО) и Държавни зрелостни изпити (ДЗИ).

https://ivandavidov.github.io/nvo

• Графики за сравнение — интерактивни диаграми по БЕЛ и МАТ (или втора матура / среден резултат от останалите матури) за всяко училище
• Класации — подреждане на училищата по среден успех за последните 3 години, с информация за брой явили се ученици
• Класации по градове и години — отделни страници за всеки град и всяка година
• Балове по паралелки след 7 клас — минимален и максимален бал по паралелки за София
• Топ училища — топ 3, 5 или 10 държавни/частни училища за всеки град
• Страница за всяко училище — профил по код с резултати по всички класове, рангове (национален, в града, медиана) и графики
• Търсене на училище — поле на главните страници, което води директно към профила на училището
• CSV експорт — изтегляне на данните за отделен град или за всички градове
• PDF отчети — генериране на PDF справки за отделно училище или за цяла класация
• Тъмна/светла тема — избор на визуален стил с автоматично запомняне
• Вграждане (embed) — графиките могат да се вграждат в други сайтове чрез iframe (документация)
• Обобщена статистика — преглед на общите тенденции по класове и години
• Мини игри — колекция от 36 игри с поддръжка за клавиатура и тъч устройства
• JSON API — статичен API с данни за училища, градове и класации (документация)
• Kaggle dataset — CSV данни и анализ notebook (Kaggle)

Основните данни са от портала за отворени данни data.egov.bg. Страниците за балове след 7 клас използват XLSX файлове от РУО; в момента публикуваните данни са за София и се съхраняват в data/ruo-sofia/.

• Frontend — статичен HTML/CSS/JS, хостван на GitHub Pages
• Графики — Highcharts (лицензиран)
• PDF генериране — jsPDF + AutoTable
• Обработка на данни — Java 21 инструмент (Maven), който нормализира CSV/XLSX файлове и генерира JS данни + JSON API
• XLSX обработка — Apache POI
• CSS — собствен стил върху normalize.css

python3 -m http.server 8090 -d docs

Отворете http://localhost:8090/ в браузъра.

Изисква Java 21+.

./all.sh

Това компилира Java инструмента, нормализира CSV/XLSX файловете и регенерира всички данни за сайта и API-то. Включва и генерирането на страниците за балове след 7 клас, както и обновяване на sitemap.xml.

docs/                  GitHub Pages root (статичният сайт)
  4/, 7/, 10/, 12/     страници по класове (+ embed.html, класации по градове и години)
  school/              генерирани профилни страници за всяко училище (по код)
  7/balove/            страници за минимални и максимални балове по паралелки след 7 клас
  stats/               обобщена статистика
  games/               36 мини игри
  api/v1/              статичен JSON API
  embed/               документация за вграждане
  js/                  логика, конфигурация и генерирани данни
  css/                 стилове
data/
  mon/                 сурови CSV файлове от data.egov.bg
  ruo-sofia/           XLSX файлове за баловете след 7 клас в София
  normalized/          нормализирани CSV файлове (генерирани)
java/                  Maven проект за обработка на данните
kaggle/                Kaggle dataset (CSV експорт, notebook, cover image)

За пълна техническа документация виж AGENTS.md.

MIT