Перейти до вмісту

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

ТермінЗначення
АбітурієнтВступник до ЗВО — основний користувач Abitly.org.
ЗВОЗаклад вищої освіти (університет/коледж).
СпеціальністьОсвітня програма, на яку вступає абітурієнт.
ЄДЕБОЄдина державна електронна база з питань освіти (державний реєстр).
StrapiHeadless CMS, джерело контенту (ЗВО, спеціальності, статті).
Mini AppNext.js-додаток, що запускається з Telegram-бота кнопкою.
ValkeyForm Redis (форк після ліцензійних змін у Redis 7.4).
TypesenseOpen-source search engine, що використовується у Abitly API.
CodeStarSourceConnectionAWS-нативна інтеграція з GitHub через OAuth.
MCPModel Context Protocol — спосіб дати AI-агентам інструменти. Див. реєстр.
RunbookПокроковий плейбук для конкретного інциденту.
SSM-redeployСамописна Lambda, що форсить ECS rolling deploy при зміні SSM-параметра.

Живуть у спільних з 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-eleganceSearXNG + OpenClawОкрема search/scrape інфра, поза скоупом.
Railway Studsearch servicesFrontend (FAILED 2026-04-28) + Backend (latestDeployment null)Prod-Studsearch на AWS — Railway-копія не використовується.
Railway FMFfmf-strapi + fmf-frontend + Strapi PostgresOutsource (вище).
Internal abitly-org репоabitly-content, abitly-design, abitly-universities, abitlyWorkspace’и контент-/дизайн-команди, не сервіси.
РепоОстанній pushЩо було
abitly-tg-bot2025-09v1 бота, замінено на abitly-tg-bot-v2
abitly-frontend2023-10старий фронт, замінено на abitly-frontend-v2, branch development
api2023-09старий API, замінено на abitly-api-v2, branch dev
courses2022-10модуль курсів, prod branch
studsearch-old-backend2024-09старий Studsearch backend (TypeScript), branch frontend
studsearch-db2021-09crawler ЗВО
abitly-product, stud-search-product2025-03порожні meta-репо

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

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

Section titled “Tooling-репо (не картки сервісів, але корисні)”
РепоПризначення
abitly-skillsPython — Claude Code skills для команди
abitly-scrapeпарсер днів відкритих дверей українських ЗВО
abitly-blogmulti-agent AI FAQ generator (UA, з PDF)
strapi-materials-parserPDF uploader → Strapi material entry
nmt-tests-generatorReact+Vite UI для створення NMT-тестів + Strapi

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

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

Section titled “Закриті питання (для журналу)”
  • ✅ Стек кожного prod-сервісу — з package.json.
  • ✅ AWS-сервіси per service — aws describe-* (eu-central-1).
  • ✅ Роль Railway — Telegram bot + Mini App.
  • ✅ Postgres — RDS studsearch-prod / DB abitly_prod_db, схеми abitly (API+bot), 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 (bot.launch() без аргументів). Env BOT_TOKEN. Healthcheck GET /healthcheck. Cron 0 7 * * *.
  • ✅ 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.
  • Owner-и кожного сервісу — усі 9 prod-сервісів: @Vladbandurin. Bus factor 1.
  • Studsearch Telegram bot — де живе репо/runtime (підтверджено: НЕ у studsearch-backend-v2).
  • Abitly bot username@abitlybot.
  • Strapi origin-cert expiry2041-05-24 (15-річний Cloudflare Origin Certificate, випущений 2026-05-28).
  • Алерти Grafana — Slack workspace (target). Канал — TODO: точна назва.
  • DBA-контакт для shared-RDS@Vladbandurin (self).
  • DO Droplet з abitly-monitoringвідмова від DO, міграція на AWS (заплановано). Зараз поки на DO.
  • Архівувати legacy v1 репоне архівувати (залишаємо доступними).
  • Чи документувати tooling-репо у tools/ні, поза скоупом хабу.
  • Studsearch Telegram bot — webhook чи polling, де репо.
  • Mini App f3jfl.ondigitalocean.applegacy (попередній deploy перед Railway), кандидат на cleanup з CORS.
  • DO App Platform sea-lion-app-82n43 + urchin-app-lysihlegacy, прибрати з FRONT_URL SSM.
  • test.studsearch.org — окремий host (не Amplify branch).
  • SMTP-провайдер (значення SMTP_HOST SecureString — треба читати з-під SecureString-роллю обережно).
  • Cloudflare zone-level налаштування + перелік DNS-записів (через CF MCP execute).
  • Чи документувати tooling-репо (abitly-skills/scrape/blog/...) у tools/.
  • Алерти Grafana — куди (Telegram чат TELEGRAM_LOG_CHAT_ID?).
  • DBA-контакт / on-call для shared-RDS ескалації.
  • DO Droplet з abitly-monitoring — IP/доступ.
  • Tutor serviceокремий продукт цієї ж команди, не документується в цьому хабі.
  • Чи archive-нути legacy v1 репо в GitHub.