Career Quest
Веб-платформа развития сотрудников с кабинетами по ролям: сотрудник видит цель, навыки и объяснимые следующие шаги, HR видит дефициты компетенций и…
О проекте
Команда: Anyqta AI
Кейс HackAlem.ai: Менеджмент — Halyk Bank · кейс 1
Стадия: Рабочий MVP
Задача кейса: «Career Quest»: AI-навигатор, связывающий навыки сотрудника с шагами развития
Суть
Веб-платформа развития сотрудников с кабинетами по ролям: сотрудник видит цель, навыки и объяснимые следующие шаги, HR видит дефициты компетенций и загружает проверочные профили жюри.
Как устроено
Python-бэкенд с SQL-миграциями импортирует 200 профилей, 40 мероприятий и 2743 записи истории, считает карьерную траекторию и рекомендации по проверяемым правилам (требования следующего грейда, критические навыки, история участия). Есть запись на активность, завершение в демо с пересчётом, сброс демо и HR-аналитика с импортом JSON/CSV без частичной записи при ошибке. Если задать LLM_API_URL, LLM_API_KEY и LLM_MODEL, OpenAI-совместимая модель выбирает среди событий, уже проверенных сервером. Запуск через Docker Compose, демо-аккаунты по ролям.
Ключевые решения
- rule-based recommendations
- LLM selection among server-verified events
- role-based auth
- batch import validation
Особенности
Запуск для жюри одной командой docker compose с healthcheck и готовыми демо-аккаунтами по грейдам; импорт пакета атомарный, ошибка не меняет данные. Судя по первому коммиту, команда сначала начала кейс по ветровой генерации, а потом перешла на Career Quest.
Стек
Python · SQL migrations · Docker Compose · Makefile · vanilla JS/HTML/CSS
Модели
OpenAI-compatible LLM (configurable)
Проект создан за 5 часов на финале хакатона HackAlem.ai (23 сентября 2026, Астана). Код — BAITC-Hacks/hack-d4bf9ae8-anyqta-ai.
README
README.mdCareer Quest
Career Quest — веб-платформа развития сотрудников для кейса Halyk Bank на HackAlem AI. Сотрудник видит карьерную цель, актуальные навыки и объяснимые следующие шаги. HR получает агрегированный срез дефицитов компетенций и может загрузить проверочные профили жюри.
Быстрый запуск для жюри
Нужен Docker Desktop или Docker Engine с Docker Compose. В комплект уже входит
синтетический стартовый набор: никаких путей к Downloads, Python, Node.js или
PostgreSQL на компьютере жюри не требуется.
docker compose up --build -d
Откройте http://127.0.0.1:8000. Первый запуск собирает образ, применяет миграции, импортирует 200 профилей, 40 мероприятий и 2 743 записи истории, затем создаёт демо-аккаунты. Готовность проверить командой:
docker compose ps
У сервиса career-quest должен быть статус healthy. Если порт 8000 занят,
создайте .env из .env.example, измените CAREER_QUEST_PORT и откройте
соответствующий порт.
| Логин | Пароль | Роль и сценарий |
|---|---|---|
[email скрыт] | DemoEmployee2026! | Junior: путь к Middle |
[email скрыт] | DemoEmployee2026! | Middle: критический разрыв и история участия |
[email скрыт] | DemoEmployee2026! | Senior: путь к Lead |
[email скрыт] | DemoEmployee2026! | Lead: межролевую цель |
[email protected] | DemoHR2026! | HR: компетенции, сигналы поддержки и импорт |
Сценарий проверки
- Войдите как
[email скрыт]и откройте объяснение следующего шага: система использует требования Senior, критические навыки и историю участия. - Войдите как
[email скрыт], начнитеSystem Design Fundamentals, затем нажмите «Завершить в демо». Покрытие требований и рекомендации пересчитаются, повторное завершение не добавит навык второй раз. Кнопка «Сбросить демо» вернёт только этого сотрудника к исходному состоянию. - Войдите как HR, примените фильтр, откройте сотрудника и загрузите
employees.jsonвместе сactivity_history.csvв исходной схеме. Ошибка в пакете не изменит данные; успешный профиль сразу доступен в обзоре.
В демо-режиме рекомендации работают без внешнего ключа по проверяемым правилам;
интерфейс это обозначает. Чтобы подключить OpenAI-совместимую модель, скопируйте
.env.example в .env и задайте одновременно LLM_API_URL, LLM_API_KEY и
LLM_MODEL. Модель выбирает только уже проверенные сервером события; она не
может обойти права, prerequisites или изменить уровни навыков.
Управление и диагностика
docker compose logs --tail=100 career-quest
docker compose down
make demo-reset
make acceptance
docker compose down сохраняет локальный прогресс в Docker volume. make demo-reset потребует ввести reset-demo, удалит только volume этого демо,
включая импортированные профили и прогресс, и поднимет чистое исходное состояние.
Подробности команд разработки находятся в backend/README.md. Полный план и принятые решения — в analysis.md. Полный чек-лист финальной приёмки — в docs/acceptance.md.
Авторы коммитов
История коммитов
- 2026-09-23 17:51Merge pull request #3 from BAITC-Hacks/feature/addmdIzabek
- 2026-09-23 17:50add agents.mdIzabek Zinekenov
- 2026-09-23 17:46Merge pull request #2 from BAITC-Hacks/feature/v2abeka14
- 2026-09-23 17:42finished profile and history experienceabeka14
- 2026-09-23 17:38update and use aiIzabek Zinekenov
- 2026-09-23 17:10fix the jury-profile ai pathabeka14
- 2026-09-23 17:00docs: add Career Quest agent guidance skillIzabek Zinekenov
- 2026-09-23 16:57docs: document AI recommendation modeIzabek Zinekenov
Все коммиты (21)
- 2026-09-23 16:52chore: ignore local environment configurationIzabek Zinekenov
- 2026-09-23 16:45feat: add employee demo reset and activity modalIzabek Zinekenov
- 2026-09-23 15:51test: add demo acceptance checklistIzabek Zinekenov
- 2026-09-23 15:49chore: add reproducible Docker demo startupIzabek Zinekenov
- 2026-09-23 15:45feat: add HR analytics and profile importIzabek Zinekenov
- 2026-09-23 15:38feat: add activity enrollment and demo completionIzabek Zinekenov
- 2026-09-23 15:31feat: add employee web cabinetIzabek Zinekenov
- 2026-09-23 15:25feat: add roles authentication and demo accountsIzabek Zinekenov
- 2026-09-23 15:22feat: add explainable development recommendationsIzabek Zinekenov
- 2026-09-23 15:16feat: calculate employee career trajectoriesIzabek Zinekenov
- 2026-09-23 15:13feat: add validated Career Quest data importerIzabek Zinekenov
- 2026-09-23 15:04docs: replace analysis with Career Quest implementation and demo planIzabek Zinekenov
- 2026-09-23 14:38docs: add wind power forecasting analysis and demo planIzabek Zinekenov
Структура репозитория (49 файлов)
.dockerignore .env.example AGENTS.md Dockerfile Makefile README.md analysis.md backend/README.md backend/app/__init__.py backend/app/activities.py backend/app/auth.py backend/app/bootstrap.py backend/app/career.py backend/app/db.py backend/app/demo_seed.py backend/app/hr.py backend/app/importer.py backend/app/profiles.py backend/app/recommendations.py backend/app/static/app.js backend/app/static/index.html backend/app/static/styles.css backend/app/web.py backend/migrations/001_initial.sql backend/migrations/002_users.sql backend/migrations/003_activity_enrollments.sql backend/migrations/004_app_activity_records.sql backend/tests/test_activities.py backend/tests/test_auth.py backend/tests/test_bootstrap.py backend/tests/test_career.py backend/tests/test_hr.py backend/tests/test_hr_analytics.py backend/tests/test_importer.py backend/tests/test_profiles.py backend/tests/test_recommendations.py backend/tests/test_web.py compose.yml data/career_quest_dataset/README.kz.md data/career_quest_dataset/README.md data/career_quest_dataset/README.ru.md data/career_quest_dataset/activity_history.csv data/career_quest_dataset/employees.json data/career_quest_dataset/events.json data/career_quest_dataset/skills.json docs/acceptance.md scripts/acceptance.py scripts/demo-reset.sh scripts/start.sh
Обсуждение 0 комментариев
Войдите, чтобы комментироватьПока нет комментариев — будьте первым.