Первоначальный запуск программного комплекса осуществляется после завершения процедуры установки. Для активации программы необходимо выполнить двойной щелчок левой кнопкой мыши по файлу «Oculus.exe», расположенному в каталоге установки. В качестве альтернативного метода запуска может использоваться ярлык на рабочем столе, созданный в процессе инсталляции. При первом запуске операционная система может запросить подтверждение разрешения на выполнение программы, если она получена из ненадежного источника или не имеет цифровой подписи. В таком случае требуется нажать кнопку «Разрешить» или «Выполнить в любом случае» для продолжения процесса запуска.
После запуска программного модуля на экране появляется главное окно приложения с логотипом программы и информацией о версии. В момент запуска происходит автоматическая проверка системных требований, включая наличие необходимых библиотек, доступ к файловой системе и сетевые настройки. Длительность процесса инициализации зависит от производительности оборудования и обычно составляет от 3 до 30 секунд. В случае обнаружения критических проблем, препятствующих нормальной работе, программа выводит соответствующее сообщение об ошибке с рекомендациями по ее устранению. Первичная конфигурация параметров программы осуществляется через диалоговое окно «Настройки VK API». Для доступа к настройкам необходимо в главном окне программы перейти в меню «Файл», расположенное в верхней части интерфейса. В раскрывающемся списке меню следует выбрать пункт «Настройки». После выбора указанного пункта меню на экране появляется модальное диалоговое окно с элементами управления для конфигурации (рисунок 1)
Окно настроек имеет фиксированные размеры и не поддерживает изменение геометрии, что обеспечивает стабильность расположения элементов управления. Окно блокирует взаимодействие с основным интерфейсом программы до своего закрытия, предотвращая случайное изменение других параметров во время настройки. В правом верхнем углу окна находятся стандартные элементы управления окнами операционной системы: кнопка свертывания и кнопка закрытия. Нажатие кнопки закрытия без сохранения изменений эквивалентно нажатию кнопки «Отмена» в нижней части окна.
Основным полем для настройки в окне конфигурации является поле «Токен VK API». Данное поле расположено в верхней части окна под соответствующей текстовой меткой. Поле представляет собой однострочный текстовый редактор с поддержкой стандартных операций ввода и редактирования. Для ввода токена необходимо установить текстовый курсор в поле, нажав левую кнопку мыши в области поля, или перейти к нему с помощью клавиши Tab. Далее требуется ввести ранее полученный токен доступа, используя метод вставки из буфера обмена (комбинация клавиш Ctrl+V) или ручной ввод.
Помимо токена доступа, в окне настроек присутствуют дополнительные параметры конфигурации. Поле «Версия VK API» определяет версию API, используемую при формировании запросов к социальной сети. По умолчанию установлено значение «5.199», которое является стабильной и рекомендованной версией на момент разработки программы. Изменение данного значения допускается только при наличии специальных требований или в случае устаревания используемой версии. Ввод нечисловых значений или версий, не поддерживаемых программой, блокируется системой валидации.
Поле «Путь к базе данных» определяет расположение файла базы данных SQLite, в котором хранится собранная информация. По умолчанию используется путь «vk_data.db» в каталоге программы. При необходимости может быть указан абсолютный или относительный путь к любому расположению в файловой системе, к которому есть права на запись. Рекомендуется использовать пути без пробелов и кириллических символов для предотвращения потенциальных проблем совместимости.
Поле «Папка для экспорта» задает каталог, в который будут сохраняться результаты экспорта данных в формате *.csv. По умолчанию используется значение «export» в каталоге программы. При указании несуществующего каталога программа автоматически создаст его при первом выполнении операции экспорта. Как и в случае с путем к базе данных, рекомендуется избегать специальных символов и длинных путей.
После заполнения всех необходимых полей конфигурации требуется сохранить настройки. Для этого необходимо нажать кнопку «Сохранить», расположенную в нижней части окна настроек. При нажатии кнопки «Сохранить» программа выполняет проверку корректности введенных данных. Проверяется наличие значения в поле токена (оно не должно быть пустым), корректность формата версии API (должна быть числом с точкой), допустимость указанных путей (не содержат запрещенных символов). В случае обнаружения ошибок валидации программа выводит сообщение с описанием проблемы и выделяет проблемное поле красной рамкой или другим визуальным индикатором. Пользователь должен исправить ошибку и повторить попытку сохранения.
При успешном сохранении программа записывает конфигурационные данные в файл «vk_config.json», расположенный в каталоге программы. Файл сохраняется в формате JSON с человекочитаемой структурой. Содержимое файла включает все настройки, включая токен доступа в открытом виде, поэтому необходимо обеспечить ограничение доступа к данному файлу средствами операционной системы. После сохранения настроек окно автоматически закрывается, и программа возвращается в главное окно.
После сохранения настроек рекомендуется проверить корректность конфигурации, выполнив тестовый запрос к API социальной сети. Для этого необходимо перейти во вкладку «Парсинг постов и комментариев VK» и ввести в поле «Домен группы» известный публичный идентификатор сообщества, например, «club1» (официальная группа API ВКонтакте). В полях количества постов и комментариев установить минимальные значения (например, 1 и 0 соответственно). Далее нажать кнопку «Начать парсинг».
Программа выполнит попытку установления соединения с серверами VK API и запроса информации об указанном сообществе. В случае успешной аутентификации с использованием предоставленного токена в области статистики появится информация о группе. Также будет выполнена загрузка указанного количества постов. Если токен некорректен, просрочен или не имеет необходимых разрешений, программа выведет сообщение об ошибке с указанием кода и описания проблемы, полученного от API.
Токен доступа к VK API является конфиденциальной информацией, компрометация которой может привести к несанкционированному доступу к данным социальной сети от имени приложения. Для защиты токена рекомендуется:
- Хранить файл «vk_config.json» в зашифрованном разделе диска или с использованием шифрования на уровне файловой системы.
- Ограничить права доступа к файлу конфигурации только для учетной записи, используемой для работы с программой.
- Регулярно обновлять токен, даже если срок его действия еще не истек.
- Не использовать один и тот же токен на нескольких рабочих станциях одновременно.
- Вести журнал выдачи и отзыва токенов для обеспечения подотчетности.
База данных программы и экспортированные файлы могут содержать информацию, требующую защиты. Рекомендуется:
- Хранить базу данных в каталоге с ограниченным доступом, недоступном для неавторизованных пользователей.
- Использовать шифрование тома для раздела диска, содержащего рабочие данные программы.
- Регулярно выполнять резервное копирование базы данных с сохранением копий в защищенном месте.
- Осуществлять безопасное удаление данных по истечении установленных сроков хранения.
После успешного завершения первоначальной настройки программный комплекс «Oculus» готов к выполнению своих основных функций: созданию словарей, парсингу данных из социальной сети и сравнительному анализу текстов. Рекомендуется перед началом активного использования провести тестовый прогон всех функциональных модулей для подтверждения корректности работы в конкретной операционной среде.