ПРОГРАММА “icomrepgen”

HTTP-сервер для обработки входящих запросов к автоматизированной системе

Описание функциональных характеристик программного обеспечения

Программа icomrepgen представляет собой консольное приложение, функционирующее как HTTP-сервер для обработки входящих запросов к автоматизированной системе. Программа реализует HTTP-API для взаимодействия с системой: она выполняет запросы к базе данных PostgreSQL (используемой IoT-платформой) и возвращает результаты в виде файлов отчетов или структурированных данных в формате JSON.

Цели и область применения ПО:

Программа предназначена для развертывания на серверах с российскими операционными системами (Astra Linux, РЕД ОС, Альт и др.) и обеспечивает интеграцию между пользовательскими запросами и существующей инфраструктурой IoT платформы. Область применения — автоматизация формирования отчетов и предоставление аналитических данных в автоматизированной системе.

Ключевые функции ПО icomrepgen:

Формирование отчетов по запросам: Обработка HTTP-запросов вида /api/reports/objects и генерация отчетов по объектам учета за указанный временной период с использованием параметров:
- NREPORT — номер отчета;
- GRP — группа объектов;
- date1, date2 — временной период.
В зависимости от типа запроса возвращается либо файл отчета в формате XLS (для отчетов №1, 3, 4, 5), либо ZIP-архив, содержащий XML-файлы (для отчета 80020) за каждый день заданного периода.
Предоставление расчетных данных по ценовым категориям (КЦК): Обработка запросов вида /api/kck/objects на получение массива расчетов по 4-м ценовым категориям для указанных:
- year — год;
- month — месяц;
- region — регион (например, «Самарская область»);
- gp — гарантирующий поставщик.
Данные возвращаются в формате JSON.
Предоставление справочной информации: Обработка запросов и выдача структурированной справочной информации в формате JSON, включая:
- список регионов РФ (endpoint: /api/kck/regions);
- список гарантирующих поставщиков для указанного региона (endpoint: /api/kck/gps?region=<регион>);
- список НЭСК для указанного региона (endpoint: /api/kck/ns?region=<регион>)
Взаимодействие с базой данных: Программа выполняет роль серверного приложения, которое подключается к существующей базе данных PostgreSQL, используемой IoT-платформой. Она выполняет SQL-запросы к БД для получения необходимых данных, их последующей обработки и форматирования в соответствии с поступившим запросом.
Конфигурирование параметров подключения: Возможность настройки программы через конфигурационный файл icomrepgen.ini, в котором указываются:
- параметры подключения к серверу БД (хост, порт, название базы данных, пользователь, пароль);
- порт для приема входящих HTTP-запросов.

Функции, доступные без подключения к другим компонентам ПАК:

Примечание: Для своей работы программа icomrepgen требует подключения к базе данных, но в рамках своего функционала она предоставляет следующие возможности:

Генерация файлов отчетов: Формирование и выгрузка файлов отчетов в форматах XLS и ZIP (с XML-файлами) на основе данных, хранящихся в БД.
Выдача данных в формате JSON: Предоставление структурированных данных (расчеты по КЦК, справочники) в машиночитаемом формате JSON для дальнейшего использования внешними информационными системами или интерфейсами.
Обработка HTTP-запросов в режиме 24/7: Выступая в роли самостоятельного консольного HTTP-сервера, программа непрерывно принимает, обрабатывает запросы и формирует ответы, не требуя наличия веб-интерфейса или графической оболочки.
Работа в различных ОС: Обеспечение стабильной работы на различных Linux-дистрибутивах, включая российские операционные системы.

Условия распространения

Программное обеспечение «icomrepgen» распространяется только в составе автоматических систем производства компании «Айсибиком». Для определения стоимости систем нужно послать запрос по адресу электронной почты sales@aistiot24.ru