Triple A Solutions — Career Quest

Рабочая папка для HackAlem AI, 23 сентября 2026, Астана. Добавлен черновой интерактивный прототип Career Quest на датасете организаторов. Это макет для знакомства с продуктом: AI, импорт дополнительных профилей и авторизация пока не реализованы.

Открыть прототип Career Quest

Из корня репозитория, Python 3.10+:

python3 scripts/prepare-demo-data.py --source /path/to/career_quest_dataset
python3 scripts/preview.py

Откройте http://127.0.0.1:4173. Зависимости устанавливать не нужно. В репозитории уже есть подготовленный синтетический снимок данных для запуска. Команда подготовки нужна, только если организаторы выдадут обновлённый набор. Подробнее: описание прототипа.

Начать работу

git clone https://github.com/mxwqs/hackalem-ai.git
cd hackalem-ai

Если .env.local ещё нет, скопируйте .env.example в .env.local и заполните нужные ключи локально. Не перезаписывайте существующий файл. Для проверки каркаса нужен Python 3.10+:

python3 scripts/check_repo.py

На подготовленном Mac локальные Node.js и GitHub CLI доступны через:

source scripts/use-hackalem-tools.zsh

Каталог .tools/ не входит в Git. На других компьютерах используйте свои установленные инструменты. Прототип использует HTML/CSS/JavaScript без сборки. Стек полного решения пока не зафиксирован.

Структура

Путь	Назначение
src/prototype/	Интерактивный макет Career Quest
tests/	Проверки ключевого сценария
data/examples/	Безопасные демонстрационные данные
docs/hackalem-analysis.md	Проверенные сведения о мероприятии и стратегия
docs/brief.md	Задание, критерии, пользователь и границы MVP
docs/plan.md	Этапы работы после получения задания
docs/decisions.md	Команда и технические решения
docs/progress.md	Фактический прогресс и использование Codex
docs/demo.md	Сценарий показа и комплект сдачи
docs/research.md	Как применять UnfairGaps после выбора темы

Совместная работа

Сначала заполните docs/brief.md, затем распределите задачи в docs/plan.md. Делайте небольшие коммиты с законченным изменением. Для задач используйте ветки codex/<task> или согласованный командой префикс. Перед коммитом выполните проверку и просмотрите git diff / git diff --cached. Не добавляйте ключи, приватные данные и локальные инструменты. Локальная копия unfairgaps-os/ исключена из Git.

После подготовки коммита отправка текущей ветки:

git push -u origin HEAD

Готовность MVP

• Один пользователь проходит основной сценарий от входных данных до полезного результата.
• Для результата есть проверка качества и сравнение с исходным способом решения.
• Реальные вызовы AI и демонстрационные заглушки явно различимы.
• Проект воспроизводимо запускается по README; демо проверено с чистого старта.
• Комплект сдачи соответствует полученному регламенту.