О проекте
Команда: Qanat
Кейс HackAlem.ai: Спецтрек — Astana Innovations
Стадия: Рабочий MVP
Задача кейса: «Аким на 5 часов»: городской симулятор, распределяющий бюджет по 5 направлениям и 5 районам
Суть
Браузерная игра-симулятор: игрок в роли акима распределяет бюджет, выбирает ровно 5 решений по районам Астаны и смотрит изменение Astana Quality of Life Score. После этого AI-помощник на OpenAI разбирает стратегию.
Как устроено
Фронтенд на vanilla JS (data.js, validator.js, simulator.js) проверяет выбор, считает симуляцию, показатели районов, потраченный бюджет и критические показатели. Есть уровни и неожиданные городские события. Node.js-сервер (server/server.js) по /api/analyze передаёт сценарий в OpenAI и возвращает сильные стороны, риски и рекомендации.
Ключевые решения
- валидация сценария
- симуляция показателей районов
- случайные городские события
- AI-анализ сценария
Особенности
В базовую механику добавлены игровые элементы: уровни и неожиданные городские события.
Стек
JavaScript · HTML/CSS · Node.js
Модели
OpenAI
Проект создан за 5 часов на финале хакатона HackAlem.ai (23 сентября 2026, Астана). Код — BAITC-Hacks/hack-060b71bf-qanat.
README
README.md🚀 Запуск проекта
- Клонировать репозиторий git clone <URL_ВАШЕГО_РЕПОЗИТОРИЯ> cd hack-060b71bf-qanat
- Установить зависимости
Для работы backend необходим установленный Node.js.
npm install 3. Настроить OpenAI API
В корне проекта создать файл:
.env
Добавить:
OPENAI_API_KEY=ваш_openai_api_key PORT=3000
⚠️ .env содержит секретный API-ключ и не должен загружаться в GitHub.
В .gitignore должно быть:
node_modules/ .env 4. Запустить AI-сервер
Из корневой папки проекта:
node server/server.js
После успешного запуска в терминале должно появиться примерно:
QANAT AI SERVER
Server: http://localhost:3000 AI: http://localhost:3000/api/analyze
Для проверки backend можно открыть в браузере:
Сервер должен вернуть:
{ "success": true, "message": "QANAT AI Server работает" } 5. Запустить интерфейс игры
В VS Code рекомендуется установить расширение Live Server.
Открыть:
index.html
и выбрать:
Open with Live Server
После этого игра откроется примерно по адресу:
http://127.0.0.1:5500/index.html 6. Начать игру
Нажать:
НАЧАТЬ ИГРУ
Игрок распределяет бюджет, выбирает ровно 5 управленческих решений и запускает симуляцию. После расчёта отображаются изменение Astana Quality of Life Score, показатели районов, потраченный бюджет и критические показатели. Затем можно нажать «Получить AI-анализ» — AI объяснит сильные стороны, риски и возможные улучшения выбранного сценария. О проекте
«Аким на 5 часов» — интерактивный веб-симулятор управления Астаной. Пользователь выступает в роли акима, развивает районы города, распределяет ограниченный бюджет и принимает решения по пяти направлениям.
В игре реализованы система уровней, контроль бюджета, неожиданные городские события, визуализация изменений районов и расчёт Astana Quality of Life Score.
После завершения сценария AI-помощник анализирует решения игрока, показывает сильные стороны и риски стратегии и предлагает рекомендации по улучшению.
Проект помогает в игровой форме понять, как связаны городская проблема → решение → бюджет → последствия → результат.
Авторы коммитов
История коммитов
- 2026-09-23 17:59Update README.mdgulkhan754
- 2026-09-23 17:56Update README.mdgulkhan754
- 2026-09-23 17:45Обновить README.md с описанием проекта и механикамиgulkhan754
- 2026-09-23 17:21Add AI analysis and game improvementsAyala Temirgali
- 2026-09-23 16:05Add OpenAI city advisorAyala Temirgali
- 2026-09-23 15:19Add interactive Astana city simulator UIAyala Temirgali
Структура репозитория (13 файлов)
.gitignore README.md assets/icons assets/image css/style.css index.html js/app.js js/data.js js/simulator.js js/validator.js package-lock.json package.json server/server.js
Обсуждение 0 комментариев
Войдите, чтобы комментироватьПока нет комментариев — будьте первым.