AAYMA
RU
Войти

Career Quest

Веб-платформа развития сотрудников с кабинетами по ролям: сотрудник видит цель, навыки и объяснимые следующие шаги, HR видит дефициты компетенций и…

Рабочий MVP
Команда «Anyqta AI» 8💬 0 комментариевс 23 сентября 2026 г.

О проекте

Команда: 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.md

Career 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: компетенции, сигналы поддержки и импорт

Сценарий проверки

  1. Войдите как [email скрыт] и откройте объяснение следующего шага: система использует требования Senior, критические навыки и историю участия.
  2. Войдите как [email скрыт], начните System Design Fundamentals, затем нажмите «Завершить в демо». Покрытие требований и рекомендации пересчитаются, повторное завершение не добавит навык второй раз. Кнопка «Сбросить демо» вернёт только этого сотрудника к исходному состоянию.
  3. Войдите как 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.

Звёзды
⭐ 0
Форки
0
Язык
Python
Последний push
в прошлом месяце
Коммиты
21
Авторы
4
Файлы
49
Ветки
4

Авторы коммитов

Izabek Zinekenov 17abeka14 2Izabek 1abeka14 1

История коммитов

  • 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
Ветки (4)

Обсуждение 0 комментариев

Войдите, чтобы комментировать

Пока нет комментариев — будьте первым.