# Установка и эксплуатация станции КОГЭ

**Продукт:** Станция КОГЭ

**Дата редакции:** 11.10.2026

## Версия и варианты установки

Документ описывает исходники станции 5.3b. Готовый пакет устанавливается по инструкции именно его платформы и версии. Перед установкой сверяют имя пакета, версию и контрольную сумму. Архив с исходниками не является универсальным установщиком для всех ОС.

## Запуск из исходников

Необходимы Python, графический сеанс ОС, PyQt5, PyQtWebEngine, PyYAML и psutil. Совместимость конкретных версий Python и Qt проверяется для целевой платформы. Для Windows 7 применяется отдельный согласованный комплект зависимостей и сборка; установка последних библиотек произвольной версии не гарантирует работу.

Из каталога `station/` выполните:

```sh
python3 -m venv venv
source venv/bin/activate
python -m pip install -r requirements.txt
python main.py
```

В Windows вместо команды активации Linux используется:

```bat
venv\Scriptsctivate
```

Запускайте точку входа `main.py`, а не отдельные файлы `ui/`. `config.yaml`, каталоги модулей и ресурсы должны находиться в составе поставки. Для работы QtWebEngine необходимы его библиотеки и ресурсы; при ошибке запуска передайте журнал техническому специалисту.

## Подготовка данных

Откройте «⚙ Настройки», введите пароль технического специалиста, загрузите комплект КИМ и ключ доступа к материалам. Типовые файлы: `kim_zip.zip`, `pass_YYYYMMDD.key`, `dop*.zip`, `tasks11_12.zip`. Дата ключа должна соответствовать дате проверки. Параметры и перечень заданий задаются поставленным комплектом материалов.

Для учебной проверки применяются только учебные задания и тестовые штрихкоды. Реальные экзаменационные материалы в демонстрацию не включаются.

## Каталог данных станции

- Linux: `~/.KOGEv4a/`;
- macOS: `~/Library/Application Support/KOGEv4a/`;
- Windows: `%APPDATA%/KOGEv4a/`.

Для каждого штрихкода создаётся отдельный каталог ответов. Краткие ответы сохраняются в `short_answers.txt`; файловые ответы размещаются в каталогах соответствующих заданий. Операции участника фиксируются в `action_logs.log`.

## Проверка после установки

Загрузите учебный комплект, начните работу с тестовым штрихкодом, откройте задания, введите краткий ответ, сохраните файловый ответ и выполните экспорт. Проверьте наличие ответов и журнала в выгрузке. Этот порядок проверки не заменяет протокол фактически выполненных испытаний на выбранной ОС.

## Обновление

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