hack-7c95a80f-paraplan

Хакатонный проект ParaPlan: симулятор «Аким на 5 часов» для оценки сценариев распределения городского бюджета.

Запуск

1. Откройте папку репозитория в Visual Studio Code.
2. В терминале из папки репозитория установите backend-зависимости: py -m pip install -r requirements.txt.
3. Перейдите на папку выше репозитория командой cd .. и запустите API: py -m uvicorn hack-7c95a80f-paraplan.main:app --reload.
4. Оставьте API запущенным. Откройте второй терминал в VS Code и запустите сайт кнопкой Go Live (расширение Live Server).
5. Выберите пять мероприятий. Для районных инициатив укажите район; результат интерфейс получит от API.
6. Нажмите Загрузить пример из кейса, чтобы увидеть готовый сценарий.

Для frontend не нужны npm-пакеты. Чтобы включить необязательный AI-разбор, скопируйте .env.example в .env, добавьте туда свой OPENAI_API_KEY и перезапустите backend. Ключ хранится только в локальном .env, который Git игнорирует; не вставляйте его в код, чат или коммиты. При необходимости задайте OPENAI_MODEL в том же файле. Без ключа все расчёты и обычное объяснение продолжают работать, а AI-запрос отправляется только после нажатия кнопки Получить AI-разбор. Каждый такой запрос использует ваш OpenAI API аккаунт и может тарифицироваться. AI объясняет расчёт, но не меняет его баллы.

Файлы

• index.html — страница симулятора.
• style.css — адаптивное оформление.
• src/data.js — районы, показатели, меры, их стоимость, лаги, эффекты, синергии и несовместимости.
• src/model.js — проверка правил, влияние мер и формула Astana Quality of Life Score.
• src/app.js — интерактивный интерфейс, бюджет, районные карточки и разбор результата.
• main.py, simulation.py, data.py — API и серверный расчёт сценария.
• requirements.txt — Python-зависимости backend, включая OpenAI SDK для AI-разбора.
• .env.example — образец локальных настроек; личный .env не коммитится.

Модель

Все показатели лежат в диапазоне 0–100. Эффекты мер умножаются на долю реализации (8 − лаг) / 8. Городские меры действуют на все районы, районные — на выбранный район. После применения эффектов и синергий показатели ограничиваются шкалой 0–100.

AQOL Score = 0.7 × средний балл районов с учётом населения + 0.3 × балл слабейшего района − число показателей ниже 40.

Сценарий допустим, если выбрано ровно пять разных мер, бюджет не выше 100, на одно направление приходится не больше двух мер, выбраны районы для районных мер, не выбраны районы для городских мер и не нарушены несовместимости. Недопустимый сценарий не получает итоговый балл.

Объяснение результата формируется детерминированно из вычисленных данных: показывает изменения районов, ведущие направления, критические значения, затраты и сработавшие синергии. Модель сама рассчитывает все числа; текст не добавляет вымышленных показателей.