Wizard «Куди я вступлю?»

Метадані

Поле	Значення
Статус	🚧 в розробці — гілка `vladbandurin/chances-wizard` локальна, на GitHub не запушена (`gh api .../branches/vladbandurin/chances-wizard` → 404)
Поверхні	web (плановано); споріднений bot-флоу `/start chances_…` уже в проді
Доступність	`TODO:` (за стратегією монетизації — depth-gating пріоритет-оптимізатора за тарифом; на гілці не верифіковано)
Власник	`TODO:`
Останнє підтвердження	2026-06-14 · гілка:`vladbandurin/chances-wizard` (404 на GitHub) + `gh api` (немає remote-гілки/PR) + curl (`/uk/chances`, `/uk/admission-chances` → fallback-сторінка, не wizard)

Призначення

Майстер «Куди я вступлю?»: за конкурсним балом абітурієнта підбирає реальні оффери ЗВО/спеціальностей, де він проходить (порівняння бала з прохідними балами минулого року), і ранжує їх як пріоритет-оптимізатор «куди вступлю». Розвиток воронки калькулятора конкурсного бала: від «який у мене бал» → до «куди саме з цим балом вступати».

User flow

Точка входу: https://abitly.org/TODO: — публічний роут wizard’а на гілці не підтверджено (/uk/chances, /uk/admission-chances на проді віддають загальну fallback-сторінку, не майстер).

TODO: кроки майстра — недоступні без коду гілки (бал на вході / вибір спеціальностей / ранжований список офферів із розривом балів).

Споріднений сценарій уже працює в боті — веб-калькулятор віддає deep-link, бот будує список «куди вступиш»: див. /start chances_… — шанси на вступ. Контракт payload — chances_<specialityId>_<score×100> (бал у 0..200, ремап спец-id на 2025). Веб-wizard, ймовірно, споживає той самий backend-рейл, але це TODO: до появи коду.

Дані та API

Джерело	Ендпоінт / entity	Призначення
api-v2	`GET /offers/chances` (мок + integration-тест у `main`; `admissionChancesResponse`)	список офферів за балом із прохідними балами-2025 і `delta`/`probability`
api-v2	`GET /offers/admission-chances` (param `concursScore`)	той самий тізер «шанси на вступ», що живить калькулятор
api-v2	`src/api/admission/` (`AdmissionCalculator`, `AdmissionScoreStrategy`, NMT-стратегії)	розрахунок/порівняння конкурсного бала на бекенді

Backend-рейл існує в main; конкретні запити wizard’а з фронтенду — TODO: (код на незапушеній гілці).

Зв’язки з іншими фічами

Калькулятор конкурсного бала — батьківська воронка; wizard продовжує її від «мій бал» до «куди вступлю». Калькулятор уже віддає deep-link chances_… і тізер топ-офферів.
«Мій бал» — кабінетний бал по обраних спеціальностях; джерело вхідного бала для майстра.
Deep-links до Telegram-бота — контракт chances_<specialityId>_<score×100> (owner — бот), яким веб передає бал у бот-аналог цього сценарію.

Код

Репо	Шлях	Примітка
`abitly-frontend-v2`	`TODO:` (гілка `vladbandurin/chances-wizard` не на GitHub — 404)	сторінка / компоненти wizard’а недоступні
`abitly-frontend-v2`	`src/api/offers/__mocks__/chances.mock.ts`, `__tests__/integration/api/offers-chances.test.ts`	у `main`: мок + тест клієнта `/offers/chances` (споживач рейлу)
`abitly-api-v2`	`src/api/offers/offers.controller.ts`, `src/responses/offers/admissionChancesResponse.ts`, `src/api/admission/**`	бекенд-рейл шансів (у `main`)

Обмеження та блокери

Гілка локальна, не запушена — код wizard’а недоступний для верифікації; всі деталі UI/роутів — TODO:.
409-caveat для live-тесту: за пам’яттю проєкту локальний прогін майстра впирається в конфлікт (409) — повноцінний live-тест неможливий без запушеної гілки/прод-середовища.
Бекенд-рейл (/offers/chances, прохідні бали-2025) у main присутній, але як feature wizard у проді не видно (/uk/chances → fallback-сторінка).
TODO: депт-гейтинг за тарифом (Free/Pro/Max) — задекларовано у стратегії монетизації, у коді гілки не звірено.

Історія змін

Дата	Подія	Джерело
2026-06-14	створено картку 🚧; зафіксовано, що гілка `vladbandurin/chances-wizard` локальна й не на GitHub (404), деталі — `TODO:`	`gh api` (404) + curl + пам’ять проєкту