Перейти к содержимому

Как установить программу на ПК

ИНСТРУКЦИЯ ПО УСТАНОВКЕ ПРОГРАММЫ (простыми словами)

1. Какой архив выбрать? (x64 или x32)

Программа ONDStat доступна в двух версиях:

  • ONDStat x64 — для компьютеров с 64-битной Windows
  • ONDStat x32 — для компьютеров с 32-битной Windows

Если вы не знаете, какая у вас система — выполните простые шаги ниже.

  1. Нажмите ПускПанель управления (или Параметры).
  2. Откройте Система или Система и безопасностьСистема.
  3. Найдите строку Тип системы:
    • Если написано 64-разрядная операционная система — выбирайте ONDStat x64.
    • Если написано 32-разрядная операционная система — выбирайте ONDStat x32.

Совет: вы можете попробовать обе версии — если выбрана неподходящая, программа просто не запустится. Это безопасно.

2. Распаковка архива

а) Откройте скачанный архив (например,ONDStat x64.rar или ONDStat x32.rar).

б) Извлеките (скопируйте) папку с программой (например, ONDStat x64) в удобное место (например, на диск D:).

в) После распаковки архива вы должны увидеть следующие файлы и каталоги программы:

Файлы:

  • main.py, ONDStat.exe
  • gui.py, data_processing.py, report_generation.py, utils.py
  • requirements.txt, ONDStat.spec, style.qss, help.html

Папки:

  • input_files — для загрузки Excel-файлов
  • reports — сюда сохраняются сгенерированные отчёты
  • img — изображения и логотип
  • tests, build, dist, __pycache__, .pytest_cache — служебные папки
⚠️ Важно: не удаляйте и не перемещайте файлы и папки внутри — это приведёт к ошибкам при запуске программы.

3. Запуск программы

а) Откройте папку с программой.

б) Дважды кликните по файлу ONDStat (.exe).

в) При необходимости можно создать ярлык на рабочем столе — кликните правой кнопкой по ONDStat (.exe)→ ОтправитьРабочий стол (создать ярлык).

г) Если появится предупреждение Windows SmartScreen — нажмите "Подробнее" → "Выполнить в любом случае".

д) Дождитесь открытия окна программы.

4. Загрузка файлов для анализа

а) В открывшемся окне программы вы увидите два поля для загрузки файлов:

  • Выгрузка из МУПа с более новыми данными — сюда загружается файл с актуальными (новыми) данными.
  • Выгрузка из МУПа с более старыми данными — сюда загружается файл для сравнения (обычно прошлый год или период).

б) Нажмите кнопку Обзор рядом с каждым полем и выберите нужный файл Excel на вашем компьютере.

в) Программа сама скопирует выбранные файлы в нужную папку и переименует их как надо — вручную ничего копировать и переименовывать не нужно!

г) После выбора обоих файлов кнопка Запустить станет активной. Нажмите её для начала анализа.

5. Получение результата

а) Дождитесь завершения анализа (может занять несколько секунд или минуту).

б) После завершения появится сообщение о готовности и кнопка Открыть папку с анализом.

в) Нажмите эту кнопку — откроется папка reports, где будет готовый файл с анализом (Excel).

Возможные проблемы и решения

  • Нет Visual C++ Redistributable
    Симптом: программа не запускается, появляется ошибка о DLL (MSVCR100.dll, MSVCP140.dll).
    Решение: скачайте и установите Visual C++ Redistributable для x64 или Visual C++ Redistributable для x32 (x86) для вашей системы (x64 или x32(x86)).
  • Антивирус блокирует запуск
    Симптом: программа не запускается или удаляется антивирусом.
    Решение: добавьте папку с программой в исключения антивируса.
  • Нет прав администратора
    Симптом: программа не запускается, появляется ошибка доступа.
    Решение: запустите программу от имени администратора (ПКМ → "Запуск от имени администратора").
  • Нет .NET Framework 4.5+
    Симптом: ошибка при запуске PyQt5-приложения.
    Решение: установите .NET Framework 4.5 или выше.
  • Старый Excel
    Симптом: файл отчёта не открывается.
    Решение: используйте Excel 2010 или новее, либо бесплатные аналоги (LibreOffice, OnlyOffice).
  • Проблемы с кириллицей в путях
    Симптом: программа не видит файлы, если путь содержит русские буквы.
    Решение: используйте папки с латинскими буквами в пути к программе и файлам.

Советы для неопытных пользователей

  • Устанавливать Python и библиотеки на целевом ПК не требуется — программа работает автономно.
  • Для запуска достаточно распаковать папку с программой и дважды кликнуть по ONDStat.exe.
  • Если программа не запускается — проверьте наличие Visual C++ Redistributable и попробуйте запустить от имени администратора.
  • Если антивирус ругается — добавьте папку программы в исключения.
  • Не запускайте программу из архива — сначала распакуйте её в отдельную папку.

Полезные советы:

  • Не меняйте структуру внутри папки (не удаляйте, не переименовывайте и не перемещайте файлы и папки).
  • Не запускайте программу из архива — сначала распакуйте её в отдельную папку!
  • Для работы программы не требуется установка Python или других дополнительных программ — всё уже включено.
  • Если программа долго не отвечает — дождитесь завершения анализа, не закрывайте окно.
  • Для анализа всегда используйте свежие выгрузки из МУПа.
  • Если что-то не работает — проверьте наличие файлов выгрузок.

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

Минимальные требования к системе

💻 Операционная система

  • Windows 7 и выше (32-bit или 64-bit)
  • Windows 10 - рекомендуется! (11 - официально не тестировалась, но известных проблем не выявлено)
  • Требуется .NET Framework 4.5 или выше (обычно уже установлен)
  • Сетевые требования: не требуется интернет-подключение»

💾 Память и место на диске

  • RAM: минимум 2 ГБ, рекомендуется 4 ГБ+
  • Свободное место: минимум 250 МБ

📄 Требования к файлам выгрузки

  • Размер файла: до 50 МБ (рекомендуется)
  • Количество строк: рекомендуется до 20 000
  • Формат: стандартная выгрузка из МУПа в формате .xlsx

Примечание по производительности:

Время обработки зависит от объема данных: файлы до 10 МБ обрабатываются за 10-30 секунд, файлы 20-50 МБ могут потребовать около минуты (могут потребовать до 1 минуты в зависимости от мощности ПК). При работе с большими файлами рекомендуется закрыть другие программы для ускорения процесса.

Безопасность и работа с антивирусом

Защита данных

✅ Локальная обработка

Все данные обрабатываются исключительно на вашем компьютере. Программа не подключается к интернету и не передает никакую информацию на внешние серверы.

✅ Отсутствие облачного хранения

Ваши данные о пожарах остаются конфиденциальными. Программа не сохраняет, не копирует и не передает информацию третьим лицам.

✅ Временное хранение

Данные используются только во время создания анализа. После завершения работы файлы никак не используются, остается только готовый отчет.

Работа с антивирусными программами

Возможные проблемы от антивируса:

  • Блокировка запуска - антивирус может посчитать программу подозрительной
  • Удаление файлов - некоторые антивирусы удаляют .exe файлы
  • Ложные срабатывания - предупреждения о "вредоносном ПО"

Как решить проблемы:

1️⃣ Добавить в исключения

Добавьте папку с программой ONDStat в список исключений вашего антивируса. Это предотвратит блокировку и ускорит работу.

Примеры для популярных антивирусов:
  • Windows Defender: Настройки → Безопасность Windows → Защита от вирусов → Исключения
  • Kaspersky: Настройки → Дополнительно → Угрозы и исключения → Исключения
  • Avast: Настройки → Компоненты → Экран файловой системы → Исключения
2️⃣ Временное отключение

Если добавление в исключения не помогло, временно отключите антивирус на время установки и первого запуска программы.

Внимание: Не забудьте включить антивирус обратно после установки!
3️⃣ Разрешение от администратора

При первом запуске может потребоваться разрешение администратора. Нажмите "Да" или "Разрешить" в окне User Account Control (UAC).

4️⃣ Проверка карантина

Если программа внезапно перестала работать, проверьте карантин антивируса - возможно, файлы были помещены туда и их нужно восстановить.

Гарантия безопасности

Программа ONDStat создана для упрощения анализа статистики пожаров и не содержит вредоносного кода. Все ложные срабатывания антивирусов связаны с тем, что программа не имеет цифрового сертификата от крупной IT-компании.