QALA — «5 сағатқа әкім» / «Аким на 5 часов»

Astana City AI Governance & Quality of Life Simulator
Көп агентті жасанды интеллект жүйесіне (Multi-Agent System) негізделген қала дамуын басқару симуляторы.

---

🇰🇿

Жоба туралы

«QALA — 5 сағатқа әкім» — қала басқарушысына шектеулі бюджет жағдайында Астана қаласының 5 шартты ауданы бойынша негізгі 5 бағытты тиімді басқаруға мүмкіндік беретін интерактивті AI-симулятор. Жүйе қабылданған шешімдердің қала өміріне тигізетін әсерін детерминирленген математикалық модель арқылы есептеп, AI-агенттер арқылы жан-жақты сараптама жасайды.

Негізгі 5 бағыт

1. Көлік (Транспорт): Жол жүктемесін реттеу, қоғамдық көлік инфрақұрылымы.
2. Көгалдандыру (Озеленение): Саябақтар, жасыл белдеу және экологиялық аймақтар.
3. Әлеуметтік инфрақұрылым (Социальная инфраструктура): Мектептер, емханалар мен мәдени нысандар.
4. Қауіпсіздік (Безопасность): Қалалық бейнебақылау, жарықтандыру, қауіпсіз орта.
5. Қалалық сервистер (Городской сервис): Коммуналдық қызметтер, цифрландыру және тазалық.

Басты функционал және шешілетін мәселелер

• Шектеулі виртуалды бюджет (100 млн ₸): Барлық қатысушыларға бірдей ресурстар беріледі.
• Бюджетті автоматты бақылау: Лимиттен асу қаупін болдырмайтын қатаң валидация (validator.py).
• Astana Quality of Life Score: Әрбір ауданның бастапқы деректері мен таңдалған шаралар негізінде есептелетін бірыңғай өмір сүру сапасының индексі.
• Мультиагентті AI аудиті: Тәуекелдерді, артықшылықтарды, компромисстерді және стратегиялық кеңестерді нақты түсіндіреді.

---

🇷🇺

О проекте

«QALA — Аким на 5 часов» — интерактивный симулятор для городского управленца или аналитика, позволяющий оценить влияние управленческих решений на качество городской среды Астаны в условиях жестко ограниченного бюджета.

5 ключевых направлений развития

1. Транспорт: Снижение нагрузки на дороги, оптимизация маршрутов.
2. Озеленение: Парковые зоны, зеленый пояс и эко-баланс.
3. Социальная инфраструктура: Доступность школ, больниц и общественных центров.
4. Безопасность: Городское освещение, системы наблюдения и безопасность районов.
5. Городской сервис: Эффективность ЖКХ, чистота улиц и цифровые услуги.

Ключевой функционал

• Единый виртуальный бюджет (100 млн ₸): Фиксированный стартовый баланс для справедливой оценки.
• Автоматический контроль перерасхода: Строгая валидация входящих параметров, предотвращающая дефицит.
• Расчет Astana Quality of Life Score: Детерминированная математическая модель изменения метрик по районам.
• Мультиагентный AI-анализ: Комплексный аудит сценария с аргументацией рисков, плюсов и компромиссов.

---

🏗 АРХИТЕКТУРА ЖӘНЕ ҚҰРЫЛЫМЫ / АРХИТЕКТУРА И СТРУКТУРА

hack-c1d95a16-office/
├── agents/             # Мультиагентная AI-система
│   ├── executive_agent.py   # Сводный отчет для руководства
│   ├── policy_agent.py      # Анализ соответствия городским политикам
│   ├── risk_agent.py        # Выявление узких мест и рисков по районам
│   └── optimizer_agent.py   # Рекомендации по оптимизации распределения
├── backend/            # FastAPI REST API бэкенд
│   ├── main.py              # Точка входа приложения
│   ├── routes.py            # Маршруты API
│   ├── schemas.py           # Pydantic v2 схемы валидации
│   └── API_CONTRACT.md      # Документированный контракт взаимодействия
├── simulation/         # Движок симуляции городской среды
│   ├── engine.py            # Расчет метрик и Astana Quality of Life Score
│   ├── validator.py         # Контроль бюджета и валидности мер
│   └── optimizer.py         # Алгоритм подбора оптимального сценария
└── frontend/           # Пользовательский интерфейс (React + Vite + TS)
    ├── src/                 # Компоненты, карта, графики и дашборд
    └── package.json         # Зависимости интерфейса