HyreKit
Ссылки
| Что | Адрес |
|---|
| Прототип | https://hyrekit.ru — стенд в Yandex Cloud; экспресс-тест без регистрации — https://hyrekit.ru/express. Локально прототип поднимается одной командой (Инструкция запуска) |
| Описание API (Swagger) | https://hyrekit.ru/docs, локально — http://localhost:8000/docs |
| Репозиторий | https://github.com/Fighter90/hyrekit_fsp |
| Сопроводительная документация | docs/guide/README.md, одним файлом — docx и pdf |
| Инструкция для жюри | docs/jury.md — стенд, демо-аккаунты, экспресс-тест за 5 минут, что посмотреть работодателем |
| Демо-видео (3 минуты, титры) | HyreKit_demo.mp4: тест, автопроверка, Code Arena, разбор модели, подборка и приглашение |
| Презентация (питч на 10 минут, шаблон ФСП) | pptx и pdf, 23 слайда, заметки докладчика в pptx |
Платформа-агрегатор ИТ-вакансий с верифицированным профилем достижений участника ФСП. Хакатон Федерации спортивного программирования 2026, команда «Команда 1».
Кандидат проходит тест на грейд и получает категорию «направление · грейд», к профилю подтягиваются достижения из реестра ФСП. Работодатель описывает потребность и получает подборку проверенных кандидатов с объяснимым баллом соответствия, смотрит тест под вакансию и приглашает с вилкой зарплаты. Контакты кандидата открываются только после его согласия.
Состояние по main 0.1.0 (10.10.2026) — версия к сдаче.
Работает без ключей и внешних сервисов:
- оба кабинета и лендинг в фирменном стиле ФСП, адаптив от 360 px, анимации с учётом «уменьшить движение»;
- тест на грейд: 10 параметрических заданий из 36 семейств по 14 темам, оценка по модели Раша, категория или предложение пересдать уровнем ниже, пересдача через 90 дней;
- подборка под потребность с разбивкой балла, фильтры, банк кандидатов, тест под вакансию с двумя вариантами равной сложности;
- приглашения, отклики, раскрытие контактов, короткие задания;
- достижения ФСП из эмулятора реестра, рейтинг внутри категории;
- демо-аккаунты и синтетический банк из 120 кандидатов, подтверждение почты через Mailpit.
С ключами LLM (GigaChat, в резерве YandexGPT): разбор PDF/DOCX-резюме, оценка ответов на короткие задания и разбор решений Code Arena моделью; без ключей — правила. Все интеграции — в разделе Интеграции.
Вход и привязка через ФСП ID по OpenID Connect: встроенный тестовый провайдер, Keycloak ФСП подключается переменными FSP_OIDC_*.
Не входит в MVP: реальный реестр ФСП, модерация работодателей, интеграция с ATS — схемы в docs/guide/04-arhitektura.md.
История версий — CHANGELOG.md.
Содержание
Инструкция запуска
Нужно: Docker 24+ с Compose v2 и 2 ГБ свободной памяти. Ключи не нужны.
git clone https://github.com/Fighter90/hyrekit_fsp.git
cd hyrekit_fsp
cp .env.example .env
docker compose up -d --build
Проверка «получилось»: curl -s http://localhost:8000/health отвечает {"status":"healthy",...}, docker compose ps показывает app, db, redis, mailpit и frontend в состоянии healthy или running.
При первом старте API применяет миграции (alembic upgrade head) и создаёт демо-данные. Демо-аккаунты, пароль у всех HyreKit2026:
Экспресс-тест для жюри (пошагово — docs/jury.md). На главной ссылка «Экспресс-тест за 5 минут без регистрации» ведёт на /express: выберите направление и грейд, отметьте согласие и пройдите 5 заданий. Каждый запуск создаёт отдельного гостевого кандидата, поэтому эксперты не мешают друг другу. После теста войдите как [email protected] — гость будет в подборке и банке кандидатов. Выключается переменной GUEST_MODE=false.
Вход через ФСП ID. На странице входа кнопка «Войти через ФСП ID», в настройках кандидата «Привязать через ФСП ID» (OpenID Connect, FSP-20). Пока Keycloak ФСП недоступен, работает встроенный тестовый провайдер: участники FSP-123457 и FSP-123450, пароль fsp2026. Подтверждённый ФСП ID работодатель видит с отметкой «подтверждён ФСП ID».
Запуск без Docker и PostgreSQL (SQLite) — в Быстром старте для разработчика. Демо-сценарий за 5 минут — docs/guide/05-zapusk-i-demo.md.
Команда и трек
| Параметр | Значение |
|---|
| Команда | Команда 1 |
| Трек | «Цифровая платформа-агрегатор ИТ-вакансий с верифицированным профилем достижений участника ФСП» |
| Хакатон | Хакатон Федерации спортивного программирования, 2026 |
Что это за продукт
Аудитория и проблема
Работодатель тратит часы на резюме, где грейд заявлен, но не подтверждён, а сильные олимпиадники и участники соревнований ФСП теряются среди шаблонных откликов. Кандидат не может показать, что его Middle — действительно Middle.
Обратная механика найма
Не кандидат ищет вакансию, а работодатель находит кандидата:
- Кандидат заполняет профиль (или загружает PDF-резюме), проходит опрос и тест на предполагаемый грейд.
- Тест подтверждает категорию «направление · грейд» или предлагает пересдать уровнем ниже. Грейд никогда не понижается тестом.
- ФСП ID подтягивает достижения: соревнование, уровень, место, год, роль. Профильные дисциплины весят вдвое.
- Работодатель описывает потребность — и получает подборку по убыванию соответствия с разбивкой: категория 30 %, стек 30 %, тест 25 %, ФСП и Arena 10 %, свежесть 5 %.
- Приглашение с вилкой зарплаты → кандидат принимает → контакты открываются.
Почему тест нельзя выучить
Задания не хранятся списком: 23 из 36 семейств генерируют условие из случайных данных и вычисляют ответ, поэтому утёкшие ответы к новой попытке почти не подходят. По валидации на синтетических кандидатах Junior со шпаргалкой из 200 чужих попыток сдаёт Middle в 29,7 % случаев против 19,3 % честно — и в 100 % при статичном тесте. Все цифры — docs/validation/results.md, методика — docs/guide/03-metodika-ocenki.md.
Границы MVP
Реестр ФСП эмулируется детерминированно по ФСП ID (ID на 0 — участник без истории); замена на реальный API — одна реализация интерфейса FspProvider. Модель (GigaChat или YandexGPT) не генерирует и не проверяет задания теста: сопоставимость сложности важнее.
Визуальная система
Интерфейс в фирменном стиле ФСП: официальный кириллический логотип федерации в связке с HyreKit, графитовая основа, синий #402FFF и красный #EC1D35, шрифты JetBrains Mono и TDAText. Токены и правила — DESIGN.md.
| Лендинг | Подборка работодателя |
|---|
| |
| Тест на грейд | Тест под вакансию |
| |
| Телефон: кабинет кандидата | Телефон: подборка | Телефон: тестирование |
|---|
| | |
Движение: блоки проявляются по очереди, карточки подсвечиваются за курсором, у главных кнопок бегущая рамка, у заголовка лендинга короткий глитч, таймер теста пульсирует в последнюю минуту. Настройка «уменьшить движение» всё это выключает. Все 18 скриншотов — docs/assets/screens/.
Состояние проекта
Задачи ведутся в Linear, проект «HyreKit — платформа подбора ИТ-специалистов (ФСП)», ключи FSP-N. Что в main:
| Блок | Задачи | Что сделано |
|---|
| Профиль кандидата | FSP-22…FSP-25 | Профиль, разбор PDF/DOCX-резюме, приватность и согласие, PDF-профиль |
| Достижения ФСП | FSP-26 | Эмулятор реестра, балл ФСП, отметка «профильное» |
| ФСП ID | FSP-20 | Вход и привязка через ФСП ID по OpenID Connect, встроенный тестовый провайдер, Keycloak ФСП через FSP_OIDC_* |
| Тестирование | FSP-27…FSP-31 | Опрос, банк семейств, план попытки, оценка θ, решение по грейду, пересдача |
| Экспресс-тест | FSP-32 | Тест за 5 минут без регистрации для жюри, гостевой кандидат |
| Честный порог | FSP-61 | Грейд подтверждается только большинством верных ответов на уровне грейда, одинаково для полного и экспресс-теста |
| Калибровка | FSP-33 | Статус семейств заданий, исключение утёкших, мониторинг дрейфа (scripts/calibrate.py) |
| Подбор | FSP-43…FSP-45 | Подборка с объяснением, фильтры, банк кандидатов, тест под вакансию |
| Найм | FSP-46, FSP-50, FSP-51 | Приглашения, вакансии и отклики, короткие задания |
| Демо-данные | FSP-17 | Демо-аккаунты, 120 синтетических кандидатов |
| Валидация | FSP-54, FSP-55 | scripts/validate.py, отчёт в docs/validation/results.md |
| Браузерный тест | FSP-56 | scripts/e2e.cjs: сквозной сценарий в браузере локально и на hyrekit.ru |
| LLM | FSP-22, FSP-36, FSP-51 | Цепочка GigaChat → YandexGPT → правила, GET /api/v1/llm/status |
| Code Arena | FSP-36…FSP-42 | Задачи по коду в браузере (Python, JavaScript), песочница на Landlock и seccomp, вердикты по тестам, разбор решения моделью (GigaChat, резерв YandexGPT) или правилами, таблица в реальном времени, рейтинг Glicko-2 в подборке, раунды и витрина работодателя |
Спецификации каждого блока — docs/specs/, журнал — docs/progress.md.
Кабинеты
| Кабинет | Экраны |
|---|
| Кандидат | Главная, Профиль, Тестирование, Приглашения, Вакансии, Code Arena, Челленджи, Настройки |
| Работодатель | Главная, Компания, Потребности (подборка и тест под вакансию), Банк кандидатов, Избранное, Приглашения и отклики, Code Arena, Челленджи, Настройки |
Регистрация с выбором роли, подтверждение почты по ссылке. Кабинеты разделены по ролям на уровне API.
Быстрый старт для пользователя
- Открыть приложение и войти как
[email protected] / HyreKit2026.
- «Тестирование» → опрос → 10 заданий с таймером → результат с разбором по темам.
- «Настройки» → согласие на публикацию и ФСП ID, например
FSP-123457.
- В другом окне войти как
[email protected] → «Потребности» → «Python backend-разработчик» → подборка → «Пригласить».
- Кандидатом принять приглашение — у работодателя откроются контакты.
Быстрый старт для разработчика
Нужно: Python 3.11+, Node.js 20+.
python -m venv .venv && source .venv/bin/activate
pip install -r requirements-dev.txt
PATH=$PWD/.venv/bin:$PATH scripts/dev.sh # API на :8000, база — файл .dev.db (SQLite)
cd frontend && npm ci && npm run dev # http://localhost:5173, /api проксируется на :8000
Только PostgreSQL и Redis в Docker, код локально: docker compose -f docker-compose.infra.yml up -d.
Разработка в OpenCode: настройка уже в репозитории (opencode.json, .opencode/) — правила, Linear и GitHub через MCP, агенты @spec и @review, команды /task FSP-N, /check, /docs, /e2e. Подключение — docs/opencode.md.
Переменные окружения
Образец — .env.example.
| Переменная | По умолчанию | Назначение |
|---|
SECRET_KEY | — (обязательна) | Подпись JWT; в production слабый ключ останавливает запуск |
DATABASE_URL | PostgreSQL на localhost | postgresql+asyncpg://… или sqlite+aiosqlite:///… |
REDIS_URL | redis://localhost:6379/0 | Лимиты запросов |
ENVIRONMENT | development | production включает строгие проверки |
CORS_ORIGINS | localhost | Разрешённые адреса фронтенда |
GIGACHAT_CREDENTIALS | пусто | Authorization Key GigaChat (developers.sber.ru); без ключа провайдер пропускается |
GIGACHAT_SCOPE, GIGACHAT_MODEL | GIGACHAT_API_PERS, GigaChat | Параметры GigaChat |
YANDEX_GPT_API_KEY | пусто | API-ключ Yandex AI Studio (сервисный аккаунт с ролью ai.languageModels.user); резервный провайдер |
YANDEX_GPT_FOLDER_ID | пусто | ID каталога Yandex Cloud для YandexGPT |
YANDEX_GPT_MODEL | yandexgpt-lite/latest | Модель YandexGPT |
LLM_PROVIDERS | gigachat,yandexgpt | Порядок опроса провайдеров; если не ответил никто, работают правила |
SEED_DEMO | true | Демо-аккаунты и синтетический банк при старте |
CALIBRATION_INTERVAL_MINUTES | 60 | Как часто пересчитывать статус семейств заданий и исключать утёкшие (FSP-33); 0 — выключено |
GUEST_MODE | true | Экспресс-тест для жюри без регистрации (POST /api/v1/auth/guest) |
FSP_OIDC_ISSUER | пусто | Адрес провайдера ФСП ID (Keycloak realm). Пусто — встроенный тестовый провайдер (FSP-20) |
Команды
ruff check src tests scripts && ruff format --check src tests scripts # линтер и формат
pytest --cov=app # тесты бэкенда с покрытием
PYTHONPATH=src python scripts/validate.py # валидация методики
PYTHONPATH=src python scripts/calibrate.py # статус семейств заданий, исключение утёкших
cd frontend && npm run lint && npm run build && npm test # фронтенд
python scripts/smoke.py # дымовая проверка поднятого стенда
node scripts/e2e.cjs --base http://localhost:5173 # сквозной сценарий в браузере (Playwright)
python scripts/load.py # нагрузка: p50/p95 ключевых операций
docker compose logs -f app # логи API
Архитектура
Монолит FastAPI с модулями по предметным блокам и SPA на React за nginx.
flowchart TB
Browser[Браузер: React SPA] -->|HTTPS| Nginx[nginx: статика + прокси /api]
Nginx --> API[FastAPI]
API --> PG[(PostgreSQL 16)]
API --> Redis[(Redis 7)]
API -->|SMTP| Mail[Почта / Mailpit]
API -->|по ключу| Giga[GigaChat]
API -.->|резерв, по ключу| YGPT[YandexGPT]
API -.->|FspProvider| FSP[Реестр ФСП: эмулятор]
| Слой | Технология |
|---|
| Фронтенд | React 19, TypeScript, Vite 6, vitest |
| API | FastAPI, Pydantic v2, async SQLAlchemy 2, Alembic |
| Данные | PostgreSQL 16 (в разработке SQLite), Redis 7 |
| LLM | GigaChat, резерв YandexGPT, без ключей — правила |
Методика (assessment.bank, assessment.engine, matching.service) — чистые функции без базы: их проверяют и юнит-тесты, и скрипт валидации. Подробно — docs/guide/04-arhitektura.md, модель данных — docs/schema.md, контракт API — docs/spec/api.md.
Интеграции
| Интеграция | Что даёт | Как подключена | Без неё |
|---|
| GigaChat (Сбер) | Разбор резюме, оценка ответов на короткие задания, разбор решений Code Arena | SDK gigachat, src/app/llm/gigachat.py; ключ GIGACHAT_CREDENTIALS | Запрос уходит в YandexGPT |
| YandexGPT (Yandex AI Studio) | Те же функции, резервный провайдер | REST Foundation Models API, src/app/llm/yandexgpt.py; YANDEX_GPT_API_KEY, YANDEX_GPT_FOLDER_ID | Работают правила |
| ФСП ID (OpenID Connect) | Вход и подтверждённая привязка ФСП ID | Authorization Code + PKCE, src/app/fsp/oidc.py; FSP_OIDC_* | Встроенный тестовый провайдер /api/v1/fsp-id |
| Реестр достижений ФСП | Достижения и балл ФСП в профиле и подборке | Интерфейс FspProvider, src/app/fsp/provider.py | Детерминированный эмулятор по ФСП ID |
| Почта (SMTP) | Письмо для подтверждения адреса | src/app/core/mailer.py; SMTP_* | Ссылка подтверждения пишется в лог; локально письма в Mailpit |
| Yandex Cloud | ВМ Compute Cloud, Container Registry, статический IP, снимки диска | deploy/yc/deploy.sh | Локальный запуск через Docker Compose |
| DNS Timeweb и Let's Encrypt | Домен hyrekit.ru и сертификат | deploy/yc/deploy.sh, Caddy | Доступ по IP |
LLM: GigaChat, YandexGPT и правила
Все вызовы модели идут через цепочку src/app/llm/chain.py. Запрос получает первый настроенный провайдер из LLM_PROVIDERS (по умолчанию gigachat,yandexgpt). Если он не ответил, отказал в авторизации или вернул ответ без JSON, запрос повторяется у следующего. Если не ответил никто, результат строят правила. Пользователь всегда получает ответ. У разбора резюме и разбора решения Code Arena подпись в интерфейсе и поле source в API показывают, кто его написал: gigachat, yandexgpt или rules. Оценка коротких заданий возвращает только балл и отзыв, без source.
| Где | Что пишет модель | Что делают правила |
|---|
Разбор резюме (candidates.resume_parser) | ФИО, контакты, стек, роли, стаж, софт-скиллы в JSON, сливается с правилами | Регулярные выражения и словари технологий |
Короткие задания (challenges.service) | Балл по рубрике и отзыв | Эвристика по полноте и ключевым словам |
Разбор решения Code Arena (arena.feedback) | Где и почему упало решение, до пяти замечаний по коду | Шаблоны по вердикту, типичные ошибки задачи, статический разбор кода |
Модель не генерирует и не проверяет задания теста, не влияет на грейд и подборку (ADR 0002).
Как получить ключи:
- GigaChat — проект GigaChat API в личном кабинете developers.sber.ru, Authorization Key в
GIGACHAT_CREDENTIALS, скоуп GIGACHAT_API_PERS для физлиц.
- YandexGPT — сервисный аккаунт с ролью
ai.languageModels.user в каталоге Yandex Cloud, API-ключ в YANDEX_GPT_API_KEY, ID каталога в YANDEX_GPT_FOLDER_ID.
Проверка: GET /api/v1/llm/status под любым входом показывает по каждому провайдеру, задан ли ключ, ответил ли проверочный запрос, ошибку, задержку (кэш 5 минут) и последнюю ошибку в рабочих запросах. Спека — docs/specs/llm-provajdery.md.
Структура репозитория
.
├── src/app/
│ ├── assessment/ # банк семейств, план попытки, оценка θ, тест под вакансию, симуляция
│ ├── matching/ # подборка и балл соответствия
│ ├── candidates/ # профиль, резюме, PDF-профиль, приватность
│ ├── employers/ # компания, вакансии, банк кандидатов
│ ├── hiring/ # приглашения и отклики
│ ├── challenges/ # короткие задания
│ ├── arena/ # Code Arena: песочница, задачи, раунды, рейтинг, разбор решений
│ ├── fsp/ # реестр ФСП (интерфейс и эмулятор), вход через ФСП ID (OIDC) и тестовый провайдер
│ ├── auth/ catalog/ llm/ ml/ core/
│ └── main.py
├── frontend/ # React SPA: лендинг, кабинеты кандидата и работодателя
├── tests/ # pytest: сквозной сценарий, методика, ядро
├── scripts/ # dev.sh, validate.py, calibrate.py, smoke.py, e2e.cjs, load.py, export_openapi.py, build_docs.py, render_diagrams.cjs
├── alembic/ # миграции
├── deploy/yc/ # площадка Yandex Cloud: deploy.sh, cloud-init, compose, Caddy
├── docs/
│ ├── guide/ # сопроводительная документация 1–7
│ ├── specs/ # спецификации задач FSP-N
│ ├── decisions/ # ADR
│ ├── spec/api.md # контракт API
│ ├── validation/ # результаты валидации методики
│ ├── presentation/ # питч pptx и pdf на шаблоне ФСП, демо-видео, скриншоты стенда, скрипты сборки
│ ├── jury.md # инструкция для жюри
│ ├── opencode.md # разработка в OpenCode: подключение, агенты, команды
│ └── assets/ # логотип, скриншоты
├── .opencode/ # агенты и команды OpenCode (opencode.json — в корне)
├── PRODUCT.md CONTEXT.md DESIGN.md AGENTS.md CHANGELOG.md
└── docker-compose.yml
Как ведётся разработка
Источник истины
Задачи — Linear, ключи FSP-N. Спецификация до кода — docs/specs/, контракт API — docs/spec/api.md, решения — docs/decisions/.
Путь одной задачи (Spec-Driven Development)
- Задача в Linear с правилами, числами и ссылками на пункты ТЗ.
- Спецификация по шаблону: сценарии, правила, критерии приёмки в формате EARS, план тестов.
- Контракт API до кода — фронтенд и бэкенд пишутся параллельно.
- Код и тест на каждый критерий приёмки.
- Запись в docs/progress.md.
Подробно — docs/process.md.
Тестирование и качество
| Что | Как |
|---|
| Бэкенд | pytest, 276 тестов, покрытие 83 % при пороге 70 % |
| Сквозной сценарий | tests/test_flow.py: регистрация → опрос → тест → категория → подборка → приглашение → контакты |
| Методика | tests/test_method/: каждое семейство на всех уровнях, монотонность θ, правила грейда, подбор, ФСП |
| Фронтенд | vitest, 43 теста; ESLint; сборка TypeScript |
| Стенд | scripts/smoke.py против поднятого docker compose: 28 шагов от регистрации с письмом до раскрытия контактов, отклика и короткого задания |
| Браузер | scripts/e2e.cjs (Playwright) против SPA локально или на hyrekit.ru: 23 шага — регистрация, опрос и тест в интерфейсе с проверкой согласованности результата, согласие и ФСП ID; потребность, подборка, приглашение демо-кандидата, принятие, контакты; кандидат без ФСП |
| Нагрузка | scripts/load.py: 10 пользователей — p95 до 65 мс, 50 пользователей — 0 ошибок; отчёт в docs/validation/load.md |
| Валидация | scripts/validate.py: равная сложность, утечка, повторяемость, дискриминативность, точность грейда, precision@10 и nDCG@10 против базовых способов |
Ключевые результаты валидации:
| Показатель | Значение |
|---|
| Профилей сложности на грейд | 1 (варианты равной сложности) |
| Junior сдаёт Middle: честно / со шпаргалкой / статичный тест | 19,3 % / 29,7 % / 100 % |
| Грейд по тесту: точно / в пределах шага | 69,5 % / 98,7 % (заявленный — 65,5 %) |
| Повторное прохождение: корреляция θ | 0,83 |
| Precision@10 подборки, backend / devops | 0,93 / 0,96 против 0,80 / 0,80 по заявленному грейду |
CI
GitHub Actions (.github/workflows/ci.yml) на каждый push и PR:
- бэкенд (Python 3.12):
ruff check, ruff format --check, pytest --cov=app с порогом покрытия 70 %, scripts/validate.py, scripts/export_openapi.py --check (сверка docs/openapi.json с кодом);
- фронтенд (Node.js 22):
npm ci, npm run build (проверка типов и сборка), npm test.
ESLint (npm run lint) в CI не входит и запускается локально.
Безопасность
- Пароли — bcrypt; JWT access 30 минут, refresh 30 дней; секрет только из окружения.
- Лимиты (Redis): регистрация 3 в минуту, вход 5 в минуту, экспресс-тест 10 в минуту, начало и завершение входа через ФСП ID по 20 в минуту с адреса; Arena — запуск на примерах 20 и отправка решения 10 в минуту на пользователя.
- Роли проверяются на каждом методе; кандидат видит только своё, работодатель — только свою компанию.
- 152-ФЗ: согласие на публикацию с датой, псевдоним до раскрытия имени, контакты только после принятия приглашения или отклика.
- Код решений Arena исполняется отдельными процессами под Landlock и seccomp: без сети, новых процессов и записи на диск, с лимитами процессора и памяти.
.env в git не попадает, .gitleaks.toml — проверка секретов.
Развёртывание
Площадка работает на https://hyrekit.ru: ВМ Compute Cloud в Yandex Cloud, стек из образов Container Registry по deploy/yc/compose.prod.yaml, Caddy с сертификатом Let's Encrypt. Выкатка одной командой — deploy/yc/deploy.sh (нужны YC_SA_KEY_JSON и TIMEWEB_TOKEN). Пошагово — deploy/yc/README.md и docs/runbook.md.
Документация
| Документ | Что внутри |
|---|
| docs/guide/ | Сопроводительная документация для жюри: продукт, сценарий, методика, архитектура, запуск, технологии, команда |
| HyreKit_Documentation.docx, .pdf | Те же разделы одним файлом, сборка — python scripts/build_docs.py |
| docs/jury.md | Инструкция для жюри: стенд, демо-аккаунты, экспресс-тест, сценарий работодателя |
| docs/presentation/ | Питч на 10 минут и демо-видео: pptx с заметками докладчика и pdf; скриншоты стенда — docs/presentation/assets/, сборка — docs/presentation/source/ |
| docs/openapi.json | Спецификация OpenAPI, выгрузка — PYTHONPATH=src python scripts/export_openapi.py |
| docs/specs/ | Спецификации задач |
| docs/spec/api.md |
Архитектурные решения
| ADR | Решение |
|---|
| 0001 | Стек: FastAPI, PostgreSQL, React |
| 0002 | GigaChat как LLM, YandexGPT в резерве, правила без ключей |
| 0003 | Параметрические задания и модель Раша |
| 0004 | Подбор по объяснимому баллу |
| 0005 | Интерфейс реестра ФСП и эмулятор |
| 0006 | SQLite для разработки |
| 0007 | Фирменный стиль ФСП |
| 0008 | Песочница Code Arena на Landlock и seccomp внутри контейнера приложения |
Известные ограничения
- Реестр ФСП эмулируется: API и формат данных в хакатоне не предоставлены.
- Методика проверена на синтетических кандидатах; мониторинг дрейфа и сдвига трудности по реальным ответам работает (FSP-33); перенос сдвига в уровни семейств — по накоплении ответов.
- Концептуальные задания раскрываются быстрее генеративных, поэтому в попытке их не больше одного.
- Модерации работодателей и интеграции с ATS нет — только концепция.
Частые проблемы
| Симптом | Что сделать |
|---|
| Порт 8000, 3000 или 5432 занят | Остановить локальный сервис или поменять порт в docker-compose.yml |
| Письмо подтверждения не пришло | Открыть Mailpit http://localhost:8025; без Docker ссылка в логе API |
SECRET_KEY не задан | cp .env.example .env и задать значение |
| Подборка пустая | Демо-данные создаются при SEED_DEMO=true; перезапустить API |
О хакатоне
Хакатон Федерации спортивного программирования 2026. Трек — «Цифровая платформа-агрегатор ИТ-вакансий с верифицированным профилем достижений участника ФСП». Команда — «Команда 1». Лицензия — GPL-3.0, сторонние компоненты — THIRD_PARTY_NOTICES.md.
