Проєкт має дві частини з одним джерелом даних:
Питання й малюнки взяті з офіційної бази ГСЦ МВС (наказ № 225 від 29.10.2025, розділи 1–39 і 44–47). Кожна відповідь категорії B перевірена трьома незалежними способами.
Зміст
Можливості сайту
Навчання
- Інтервальні повторення FSRS-6 — той самий алгоритм і стандартні параметри, що в Anki (ts-fsrs). Під кнопками «Важко / Добре / Легко» видно наступний інтервал.
- Питання йдуть від найімовірніших у білеті до рідкісних (порядок карток).
- Темп під дату іспиту: пресети «Місяць / 2 тижні / 1 тиждень» або «Під дату», який перераховується щодня.
- Після помилки — розбір «Чому так»: головна думка, чому неправильний саме ваш варіант, а під «Детальніше» — хід міркувань, інші варіанти, пастка й пункти ПДР з посиланнями.
- «Не сплутайте»: схожі питання з іншою відповіддю поруч із помилкою.
- Автопереход: після 20 ручних оцінок алгоритм пропонує сам оцінювати правильні відповіді за часом, історією питання й схожими питаннями (
web/grade.js).
- Підходи по 15 хвилин із перервою, скасування останньої відповіді, керування з клавіатури (1–9, Enter).
Як на іспиті
- Пробний іспит, як у сервісному центрі: 20 питань (10 ПДР, 4 — безпечне водіння, 4 — категорія B, 2 — домедична допомога), 20 хвилин, не більше 2 помилок. Можна пропускати питання й повертатися за номером.
- Спроба переживає перезавантаження сторінки. Після третьої помилки застосунок одразу пропонує завершити й розібрати помилки.
- Варіанти відповідей щоразу в новому порядку, як у ГСЦ, крім питань на кшталт «Відповіді 1 і 2».
- Історія спроб на графіку й «Шанс скласти іспит зараз», порахований з пам'яті FSRS по кожному питанню.
Вибірково
- Теми — 45 тем у групах («Дорожні знаки», «Перехрестя», «Домедична допомога»…) з прогресом по кожній.
- Пошук без інтернету, з виправленням помилок і російськими словами («обгон» знайде «обгін»).
- Робота над помилками з лічильником «виправлено X з N».
Зручність
- PWA: працює офлайн (малюнки ~30 МБ зберігаються одним натисканням), встановлюється на головний екран, ярлики «Вчити / Іспит / Помилки» на значку, лічильник повторень на значку.
- Системна кнопка «Назад» працює всередині застосунку.
- Світла, темна або системна тема.
- Мотивація: серія днів, активність за тиждень, ціль на сьогодні, відлік до іспиту, нагадування в календар (.ics).
Прогрес
- Зберігається в браузері; вхід через Google синхронізує його між пристроями.
- Без акаунта: перенесення за QR-кодом або посиланням (шифрується в браузері, ключ лише в посиланні) і експорт/імпорт файлом.
Як це влаштовано
flowchart LR
subgraph src["Офіційні джерела"]
Q["questions.pdf<br>питання + малюнки"]
A["answers.pdf<br>скан таблиці відповідей"]
end
Q --> P["parse_official.py"]
A --> O["ocr_answers.py<br>tesseract + власний класифікатор"]
P --> D["build_dataset.py"]
O --> D
B["Brut322/pdr-test<br>незалежна звірка"] --> F["finalize_dataset.py"]
D --> F
F --> J[("data/questions.json")]
J --> DK["build_deck.py"] --> APKG["PDR_UA_category_B.apkg"]
J --> W["build_web.py + build_seo.py"] --> SITE["_site/ → GitHub Pages<br>zdaipdr.com.ua"]
AI["explain.py · similar.py · topics.py<br>(OpenAI, один раз локально)"] --> X[("explanations · similar<br>topics · keywords")]
X --> W
- Збірка даних — Python-скрипти, один раз на редакцію бази. Відповіді звіряються трьома способами, розбіжності зупиняють збірку.
- Сайт — статичний: ванільний JavaScript (ES-модулі), без фреймворків і без кроку збірки JS.
build_web.py копіює web/, додає questions.json, малюнки й SEO-сторінки. Збірка потребує лише стандартної бібліотеки Python, тому CI запускає її як є.
- Деплой —
.github/workflows/pages.yml на кожен push у main. Після деплою indexnow.py повідомляє пошуковики про змінені сторінки.
- Бекенд — лише Supabase: анонімна статистика (функція
ingest(), тільки додає рядки), акаунти Google для синхронізації й тимчасові зашифровані пакети для перенесення прогресу (supabase/schema.sql).
Модулі застосунку:
| Файл | Що робить |
|---|
web/app.js | екрани, черга FSRS, іспит, пошук, теми, налаштування, синхронізація |
web/ui.js | спільні елементи: шапка, нижня панель, діалоги, тости, перегляд малюнка з зумом |
web/grade.js | автооцінка правильної відповіді для автопереходу |
web/sync.js | вхід через Google і синхронізація (Supabase Auth + REST), вантажиться на вимогу |
web/transfer.js | перенесення прогресу за QR/посиланням з шифруванням AES-GCM |
web/telemetry.js | черга анонімної статистики, працює й офлайн |
web/sw.js | service worker: офлайн-режим і кеш малюнків |
web/vendor/ | ts-fsrs, MiniSearch, qrcode-generator |
Швидкий старт для розробника
Сайт:
python build_web.py data _site # лише стандартна бібліотека Python 3.11+
python -m http.server -d _site 8000 # http://localhost:8000
Пояснення «Чому так» потрапляють у застосунок лише зі змінною PDR_APP_EXPLAIN=1 (у CI вона ввімкнена):
PDR_APP_EXPLAIN=1 python build_web.py data _site
Колода Anki:
python -m venv .venv && . .venv/bin/activate
pip install -r requirements.txt
python build_deck.py data PDR_UA_category_B.apkg
Адреса сайту для канонічних посилань і sitemap — змінна SITE_URL у pages.yml. Ключі Supabase й Google (публічні) — у web/config.js; порожній SUPABASE_URL вимикає статистику й синхронізацію.
Структура репозиторію
web/ веб-застосунок (вихідні файли сайту)
build_web.py збирає сайт у _site/
build_seo.py статичні сторінки для пошуковиків
build_deck.py збирає колоду Anki
deck_order.py яруси й порядок карток — спільні для колоди й сайту
parse_official.py PDF питань → JSON + малюнки
ocr_answers.py OCR скану таблиці відповідей
build_dataset.py об'єднує питання й відповіді
finalize_dataset.py звірка з Brut322/pdr-test, статус перевірки
explain.py пояснення через OpenAI Batch API
similar.py схожі питання («не сплутайте»)
topics.py теми й ключові слова для пошуку
indexnow.py повідомлення пошуковикам після деплою
data/questions.json усі 2332 питання (усі категорії) зі статусом перевірки
data/images/ малюнки до питань
data/*.json пояснення, теми, ключові слова, схожі питання, текст ПДР
answer_overrides.json відповіді, звірені вручну зі сканом
supabase/ схема бази й запити для аналізу статистики
brand/ логотип і генератор усіх його варіантів
docs/screenshots/ скриншоти для цього README
Колода Anki
Колода є на AnkiWeb: https://ankiweb.net/shared/info/1194338664 — у Anki
Огляд колод → Отримати спільні або відкрийте посилання й натисніть Download.
- Скачайте колоду з AnkiWeb або готовий
PDR_UA_category_B.apkg
з Releases (або зберіть самі: python build_deck.py)
і імпортуйте в Anki: Файл → Імпорт.
- У налаштуваннях колоди: Порядок нових карток → Порядок збирання: «Колода»,
інакше Anki перемішає пріоритети.
- Темп: за 2 тижні — ~175 нових карток на день (2–2,5 год), за 1 тиждень —
~350 на день протягом 5 днів і 2 дні повторення (4–5 год). Для тижневого режиму:
максимальний інтервал 3 дні, кроки навчання
10m 1h, бажана утримуваність FSRS 0.92.
- Готовність до іспиту: 5 пробних білетів поспіль з ≤1 помилкою.
Повторний імпорт оновленої колоди зберігає прогрес: GUID нотаток стабільні.
Сайт чи Anki? Сайт не потребує встановлення, має пробний іспит, розбір помилок, теми й пошук. Anki вміє персонально оптимізувати параметри FSRS за історією відповідей (після ~1000 повторень; для 1–2 тижнів підготовки це майже нічого не змінює).
Порядок карток
Білет складається з 10 питань ПДР, 4 — основ безпечного водіння, 4 — додаткових
питань категорії та 2 — домедичної допомоги (hsc.gov.ua, 16.09.2025). Чим менший
пул і більше місць у білеті, тим вища ймовірність, що конкретне питання трапиться,
тому колода й сайт ідуть від найвигіднішого ярусу:
| # | Ярус | Карток | Ймовірність питання в білеті |
|---|
| 1 | Додаткові питання кат. B (розд. 44–47) | 65 | ~6 % |
| 2 | Домедична допомога (розд. 37) | 60 | ~3,3 % |
| 3 | Основи безпечного водіння (розд. 35) | 171 | ~2,3 % |
| 4 | Топ помилок ГСЦ: регулювальник, нерегульовані перехрестя, круговий рух, розмітка | 302 | ~0,7 % |
| 5 | Решта ПДР — ситуації з малюнком | 684 | ~0,7 % |
| 6 | Решта ПДР — текстові питання | 480 | ~0,7 % |
Ярус 4 — теми з п'ятірки найчастіших помилок за даними ГСЦ (18.12.2025). Усередині
ярусу першими йдуть складніші питання: більше варіантів, є малюнок, довший текст
(публічної статистики помилок по окремих питаннях немає). Припущення: блок
«4 питання за категорією» — це розділи 44–47. Логіка — у deck_order.py.
Дані й перевірка відповідей
Поле verified у data/questions.json:
| значення | що означає | кат. B |
|---|
ocr+template+brut | tesseract, власний класифікатор цифр і незалежний датасет Brut322/pdr-test збігаються | 1646 |
template+brut | tesseract не впевнений, класифікатор і Brut322 збігаються | 111 |
manual | розбіжність, звірено очима зі сканом | 5 |
brut-only / brut-unconfirmed | відповідь лише з Brut322 (бляклий 11-й аркуш скану, розділи 53–63) | 0 (поза кат. B: 125) |
Відповіді поза категорією B (brut-only, brut-unconfirmed) вручну не перевірялися.
Перезбірка, коли ГСЦ оновить базу
Потрібні Python 3.11+ і tesseract
(brew install tesseract), а також залежності з requirements.txt.
Офіційні PDF у репозиторій не входять. Їх треба скачати зі сторінки ГСЦ
«Питання та іспит з ПДР»
і покласти в data/official_pdf/ як questions.pdf (питання) та answers.pdf
(таблиця відповідей).
hsc.gov.ua стоїть за Akamai: з неукраїнського IP — «Access Denied», а з українського
звичайний curl отримує 403. Качати через curl_cffi:
from curl_cffi import requests
s = requests.Session(impersonate="chrome")
open("questions.pdf", "wb").write(s.get(URL).content)
Далі:
mkdir -p work/ans
python parse_official.py data/official_pdf/questions.pdf work/ # питання + малюнки
python -c "import pymupdf,sys; [p.get_pixmap(dpi=300).save(f'work/ans/a{i+1:02d}.png') for i,p in enumerate(pymupdf.open(sys.argv[1]))]" data/official_pdf/answers.pdf
python ocr_answers.py work/ans work/ans_ocr.json # OCR таблиці відповідей
python build_dataset.py work/questions_official.json work/ans_ocr.json work/glyphs work/dataset.json answer_overrides.json
git clone https://github.com/Brut322/pdr-test work/pdr-test # незалежна звірка
python finalize_dataset.py work/dataset.json work/pdr-test/data/questions.json answer_overrides.json data/questions.json
rm -rf data/images && cp -r work/images data/images
python build_deck.py data PDR_UA_category_B.apkg
build_dataset.py друкує розбіжності OCR і аномалії таблиці; finalize_dataset.py
завершується з помилкою, якщо хоч одна відповідь категорії B розходиться з Brut322 і
не звірена вручну. Такі питання звірте зі сканом і внесіть у answer_overrides.json
({"<розділ>-<номер>": відповідь}). Якщо в новій редакції зміниться нумерація,
Brut322 теж має бути оновлений, інакше звірка не зійдеться.
SEO-сторінки й пояснення
Застосунок малює все через JavaScript, тому для пошуковиків build_seo.py додає статичні сторінки без JS:
q/<id>/ — кожне питання: малюнок, варіанти, відповідь після вибору, пояснення, пункти ПДР, шанс потрапити в білет;r/<розділ>/ — розділи іспиту; pdr/<розділ>/ — текст ПДР з питаннями до кожного пункту;tema/<тема>/ — теми з data/topics.json; ispyt/ — пробний іспит; pro/ — про проєкт і перевірку відповідей;404.html, sitemap.xml з lastmod, robots.txt, CNAME.
Сторінка питання індексується лише тоді, коли в data/explanations.json для нього є перевірене
пояснення ("status": "ok"); кількість живих сторінок обмежує SEO_MAX_EXPLAINED у pages.yml.
Пояснення генерує explain.py через OpenAI Batch API (вдвічі дешевше): одна модель
відповідає на питання наосліп, інша пише пояснення до офіційної відповіді; публікуються лише ті,
де обидві збігаються з таблицею ГСЦ. У запит іде не весь розділ ПДР, а 8 найближчих фрагментів
(ембединги з тим самим кешем, що й у similar.py). Усі 1762 питання коштують близько $10–15.
python explain.py submit --limit 30 # пілот: перші 30 питань у порядку колоди
python explain.py status
python explain.py collect # після завершення батчу (до 24 год)
python explain.py review # розбіжності, які треба перевірити вручну
similar.py і topics.py запускаються один раз локально (ключ OpenAI запитується прихованим вводом і не зберігається); результати комітяться, тому збірці сайту OpenAI не потрібен.
Конфіденційність і статистика
Застосунок безкоштовний і без реклами; натомість він збирає анонімну статистику
навчання для відкритого дослідження про підготовку до іспиту. Збір увімкнено за
замовчуванням; вимкнути можна на сторінці
«Конфіденційність».
- Збирається: випадковий ідентифікатор браузера, номер питання, обрана відповідь і чи
правильна, час на відповідь, оцінка FSRS і стан картки, день підготовки, година доби,
налаштування темпу, тип пристрою, результати пробних іспитів (і на якому питанні з них
вийшли), сесії (скільки хвилин застосунок відкритий, скільки відповідей, екран і питання,
на якому закрили), мітка посилання й домен, з якого перейшли, відповідь про справжній іспит, серія днів,
оцінка шансу скласти і днів до іспиту (без самої дати), натискання «Поділитися» / «Встановити» /
«Нагадування в календар» / «Ще 20 нових».
- Не збирається: ім'я, email, IP-адреса, місцезнаходження, браузер, модель пристрою.
Анонімний ідентифікатор статистики ніколи не пов'язується з акаунтом синхронізації.
- Дані йдуть у Supabase через одну функцію
ingest(), яка лише додає рядки: публічний
ключ не може нічого прочитати, змінити чи видалити (supabase/schema.sql).
Готові запити для аналізу — supabase/analysis.sql.
- Синхронізація (за бажанням): після входу через Google зберігаються лише email і прогрес;
акаунт і дані в хмарі видаляються з налаштувань.
Мітки посилань
Щоб бачити, звідки приходять люди, додавайте до посилання свою мітку ?src=:
https://zdaipdr.com.ua/?src=reddit_ukraina
https://zdaipdr.com.ua/?src=tg_avtoshkola_kyiv
- мітка — латиниця, цифри,
_ - ., до 40 символів (інше замінюється на _, великі літери стають малими);
utm_source / utm_campaign теж працюють: ?utm_source=reddit&utm_campaign=ukraina → reddit-ukraina;- після відкриття мітка зникає з адресного рядка, щоб її не розносили далі;
- зберігається мітка першого візиту (
first_src) і кожного наступного (src), а також
домен, з якого перейшли (ref, напр. t.me), — без повної адреси сторінки.
Результати по мітках — запит 16 у supabase/analysis.sql.
Помилки й пропозиції
Знайшли неправильну відповідь чи помилку на сайті — відкрийте issue
з номером питання (видно над текстом питання, напр. «Розділ 33 · №115»). Виправлення відповідей
вносяться в answer_overrides.json і проходять ту саму звірку.
Ліцензія та джерела
Код, зібраний і перевірений датасет та колода — CC BY-NC-SA 4.0:
- BY — вказуйте авторство: «PDRAnkiDeck by punjet» і посилання на репозиторій;
- NC — без комерційного використання: не в платних застосунках, курсах, продуктах
з рекламою тощо без письмового дозволу автора;
- SA — похідні роботи поширюються лише під цією ж ліцензією.
Тексти питань, відповіді й малюнки належать ГСЦ МВС України (hsc.gov.ua); автор
на них прав не заявляє — ліцензія стосується цієї збірки й власного внеску (код,
перевірка відповідей, структура ярусів). Деталі — у NOTICE, юридичний текст — у LICENSE.
Незалежна звірка — Brut322/pdr-test (MIT).
Бібліотеки в web/vendor/ — під власними ліцензіями (файли *-LICENSE.txt поруч).
