Глосарій, out-of-scope та відкриті питання

Терміни домену

Термін	Значення
Абітурієнт	Вступник до ЗВО — основний користувач Abitly.org.
ЗВО	Заклад вищої освіти (університет/коледж).
Спеціальність	Освітня програма, на яку вступає абітурієнт.
Оффер	Конкурсна пропозиція: зв’язка ЗВО + спеціальність, на яку подаються заяви (entity `Offer` в api-v2). Основна одиниця моніторингу та інтент-сигналів.
Вступлист	Колекція збережених офферів у кабінеті abitly.org; буває публічна (шериться за URL) або приватна. Див. Фічі.
Симуляція вступу	Платний конструктор пріоритетного вступліста: за балами НМТ і списком КП рахує шанс (КБ vs прохідний), запас і вердикт (куди реально проходиш). Тріада намір/шанс/запас. Стан 1 (статус на даних 2025) — у проді; Стан 2 (вердикт широкого конкурсу на живих даних 2026) — відкладено. Див. simulation.
Мої пріоритети	Безкоштовний док-компаньйон вступліста: постійний бічний сайдбар на всіх публічних сторінках, куди абітурієнт одним кліком кидає вступи з тизера шансів калькулятора, бачить статус «куди проходжу» (евристика на даних 2025) і перетягує порядок. Той самий список, що й «Симуляція вступу» (`simulation_application`), але без пейволу — апселить у платний вердикт. Свідомо ≠ «Вступлисти» (збережені каталоги). 🚧 гілка `vladbandurin/priorities-dock`. Див. priorities.
Інсайдер-відгук	Картка реального студента ЗВО зі Studsearch (фото, опис, соцмережі), яку Abitly показує на сторінці оферу (`GET /students`, до 5 за university/faculty/speciality). Див. uni-page.
Бандл (матеріалів)	Strapi-колекція кількох PDF-матеріалів зі спільною разовою ціною (m2m material↔bundle). Див. materials.
SKU оплати	Три типи покупки через Monobank: разовий Premium (матеріали), AI-tutor tokens (пакети), підписка Free/Pro/Max. Див. checkout.
AI-tutor tokens	Пакети токенів для AI-тьютора НМТ (`/tutor`): small_250/best_1000/power_2000; жива оплата Monobank, баланс у зовнішньому tutor-wallet. Див. plans-billing.
ЄДЕБО	Єдина державна електронна база з питань освіти (державний реєстр).
Strapi	Headless CMS, джерело контенту (ЗВО, спеціальності, статті).
Mini App	Next.js-додаток, що запускається з Telegram-бота кнопкою.
Valkey	Form Redis (форк після ліцензійних змін у Redis 7.4).
Typesense	Open-source search engine, що використовується у Abitly API.
CodeStarSourceConnection	AWS-нативна інтеграція з GitHub через OAuth.
MCP	Model Context Protocol — спосіб дати AI-агентам інструменти. Див. реєстр.
Runbook	Покроковий плейбук для конкретного інциденту.
SSM-redeploy	Самописна Lambda, що форсить ECS rolling deploy при зміні SSM-параметра.
IaC / Terraform	Уся AWS-інфра кодифікована в репо `cloud-infrastructure` — 4 env-стеки, локальний state, власний `decision-log.md`.

Терміни домену — маркетинг {#marketing}

Словник для системи маркетингу (re-engagement + продажі через email/Telegram). Архітектура — services/abitly-marketing + ADR-0001 / 0002 / 0003.

Термін	Значення
Контакт	Маркетингова особа, якій адресуються кампанії (= `BaseUser`). Має ≥1 канальну ідентичність. Це сама особа, а не email-рядок чи `TelegramUser`.
Канальна ідентичність	Конкретний канал досяжності контакта: email-акаунт або `TelegramUser`. 30k email + 5k Telegram — це ідентичності, не обов’язково різні особи.
Campaign (кампанія)	Разова розсилка на сегмент у визначений момент (batch).
Journey / Automation (сценарій)	Послідовність повідомлень, що тригериться подією або станом контакта, а не календарною датою.
Сегмент	Набір контактів, відібраних за правилом (стадія + інтент + поведінка). Цільова аудиторія кампанії/сценарію.
Lifecycle stage (стадія)	Де контакт у вступному циклі — визначає ціль кампанії.
Активний проспект	У поточному вступному циклі, виконує дії. Ціль: продаж (Premium / Subscription / Tokens).
Сплячий проспект	Зареєстрований, ще в поточному циклі, але не конвертувався / неактивний. Ціль: реактивація → продаж.
Зарахований (минулий цикл)	Вступив або вийшов з циклу. Ціль: крос-сейл на Studsearch, не реактивація Abitly.
Інтент-сигнал	Декларована намірена дія контакта: які `Offer` (ЗВО + спеціальність) він моніторить через `OfferApplicant` / `MonitoringOpenDay`. Основне пальне для персоналізації.
Згода (consent)	Правова підстава слати маркетинг конкретному контакту по каналу. Реєстраційна згода ≠ маркетингова. Зберігається з джерелом, часом і скоупом.
Re-permission (переотримання згоди)	Кампанія-перепитування: збирає явну маркетингову згоду + свіжий інтент у контактів, де її ще нема. Перша кампанія Abitly буде саме такою (немає explicit opt-in + холодний домен).
Преференс-центр	Сторінка, де контакт керує згодою, каналами й темами. Кожен лист має на неї посилання + one-click unsubscribe.
Consent ledger	Append-only журнал згоди (`consent_event`) + проєкція (`consent_current`), keyed by `channel_identity_id` — щоб згода/suppression пережили late-link merge. Читається ConsentGuard у send-pipeline. ADR-0007.
Fact-Pack	Незмінний валідований знімок фактів (offers, дедлайни, бали), який AI отримує як structured input; ground truth для валідатора. ADR-0003.
Advice-correctness gate	Перевірка над fact-validator: ловить не вигадані, а неправильно скомбіновані реальні факти (напр. «бал 169 > 168.5 → вступиш») і хард-банить гарантії вступу. ADR-0009.
Fail-closed engagement	Поки prod lake-house не існує, engagement-події викидаються+рахуються, ніколи не пишуться в shared RDS. ADR-0002.
Tone of Voice (ToV)	Канон голосу Abitly для всієї user-facing копії: на «ти», без канцеляриту, словник замін, термінологія. Джерело правди — Brand Book; портативна дистиляція для зовнішніх LLM — ToV Rules. Скіли: `/brand-voice` · `/brand-review` · `/brand-guardian`.

Out-of-scope

Живуть у спільних з Abitly/Studsearch акаунтах, але не належать контекст-хабу.

Контекст	Деталі	Чому виключено
FMF (`fmf-frontend`, `fmf-strapi`)	Сайт ФМФ КПІ	Outsource-замовлення, окремий продукт.
*AWS `yangon-` стек**	4 ECS-сервіси + RDS `dev-yangon-rds` + ElastiCache + Lambda + Terraform + ECR + ALB + bastion + SSM `/yangon/` + S3 `yangon*` + CloudFront `dev-yangon-search`	Окремий продукт, поза скоупом.
Railway `overflowing-elegance`	SearXNG + OpenClaw	Окрема search/scrape інфра, поза скоупом.
Railway `Studsearch` services	Frontend (FAILED 2026-04-28) + Backend (latestDeployment null)	Prod-Studsearch на AWS — Railway-копія не використовується.
Railway `FMF`	fmf-strapi + fmf-frontend + Strapi Postgres	Outsource (вище).
Internal abitly-org репо	`abitly-content`, `abitly-design`, `abitly-universities`, `abitly`	Workspace’и контент-/дизайн-команди, не сервіси.

Legacy (кандидати на archive)

Репо	Останній push	Що було
`abitly-tg-bot`	2025-09	v1 бота, замінено на `abitly-tg-bot-v2`
`abitly-tg-bot-v2`	2026-06	v2 бота (TS · Telegraf · Railway), замінено на `abitly-tg-bot-v3` (Python · aiogram 3 · AWS ECS)
`abitly-frontend`	2023-10	старий фронт, замінено на `abitly-frontend-v2`, branch `development`
`api`	2023-09	старий API, замінено на `abitly-api-v2`, branch `dev`
`courses`	2022-10	модуль курсів, `prod` branch
`studsearch-old-backend`	2024-09	старий Studsearch backend (TypeScript), branch `frontend`
`studsearch-db`	2021-09	crawler ЗВО
`abitly-product`, `stud-search-product`	2025-03	порожні meta-репо

Можна архівувати в GitHub (gh repo archive abitly-org/<repo>) — не блокує доступ до історії.

Історія перейменувань

Сервіс	Еволюція
Telegram bot	`abitly-tg-bot` (v1, 2025-09) → `abitly-tg-bot-v2` (TS · Telegraf · Railway) → `abitly-tg-bot-v3` (Python · aiogram 3 · AWS ECS Fargate, cutover ~2026-06-02). Токен `@abitlybot` переключено на v3; Railway-бот знятий, Mini App лишилась на Railway. Картка → Telegram bot.
Frontend	`abitly-frontend` → `abitly-frontend-v2`.
API	`api` → `abitly-api-v2`.

Tooling-репо (не картки сервісів, але корисні)

Репо	Призначення
`abitly-skills`	Python — Claude Code skills для команди
`abitly-scrape`	парсер днів відкритих дверей українських ЗВО
`abitly-blog`	multi-agent AI FAQ generator (UA, з PDF)
`strapi-materials-parser`	PDF uploader → Strapi `material` entry
`nmt-tests-generator`	React+Vite UI для створення NMT-тестів + Strapi

TODO: створити окремий розділ /tools/ якщо вирішимо документувати.

Закриті питання (для журналу)

✅ Стек кожного prod-сервісу — з package.json.
✅ AWS-сервіси per service — aws describe-* (eu-central-1).
✅ Роль Railway — Telegram Mini App (бот мігровано на AWS ECS Fargate, 2026-06).
✅ Postgres — RDS studsearch-prod / DB abitly_prod_db, схеми abitly (API+bot), telegram (bot logs), public (Strapi), studsearch (Studsearch backend).
✅ Платежі — Monobank (SSM MONOBANK_TOKEN).
✅ Auth — Google OAuth + JWT + Telegram login.
✅ Analytics — власний lake-house + GTM (NEXT_PUBLIC_GOOGLE_TAG_MANAGER у prod frontend).
✅ Sentry — частково: підключений тільки у frontend prod (org abitly, region de.sentry.io). Backend — Telegram-logger.
✅ Frontend logging — triple-channel: Sentry + Telegram (/api/logger) + Loki напряму (lokiLogger).
✅ Telegram bot mode — long polling (aiogram 3, один інстанс — ADR 0001). Env BOT_TOKEN. Healthcheck GET /healthcheck:3000. Cron 0 7 * * * (APScheduler, Europe/Kyiv). Хостинг — AWS ECS Fargate (abitly-prod-tg-bot).
✅ Strapi deploy — GitHub Actions docker buildx --platform linux/arm64 → ECR → CodePipeline → EC2 (з Caddy reverse proxy).
✅ Cloudflare account — Info@abitly.org's Account (id 0f2d9ae8b2976e235eefc16812fb91bb).
✅ Studsearch mysql2 — dead dependency (підтверджено grep’ом).
✅ Studsearch Telegram bot username — @StudSearchBot.
✅ Tutor service — https://tutor-api.abitly.org.