Документация программного обеспечения «Кодекс Ро-бот»
Функциональные характеристики, установка, эксплуатация
На этой странице размещена документация, содержащая описание функциональных характеристик программного обеспечения «Кодекс Ро-бот» и информацию, необходимую для установки и эксплуатации программного обеспечения. Правообладатель — ООО «Кодекс технологии» (ОГРН 1200200055791, ИНН 0278962265).
Свидетельство о государственной регистрации программы для ЭВМ «Кодекс Ро-бот» № 2026684760 от 17.08.2026.
Документы
Функциональные характеристики
Назначение, состав и функциональные возможности программного обеспечения.
Инструкция по установке
Модель поставки, требования к рабочему месту, порядок подключения, установка модуля сбора данных.
Руководство пользователя
Порядок эксплуатации: вход, разделы системы, сверка, обработка расхождений, выгрузка результатов.
Описание жизненного цикла
Процессы поддержания жизненного цикла ПО, устранение неисправностей, совершенствование, персонал.
Раздел 1 Описание функциональных характеристик программного обеспечения
«Кодекс Ро-бот» — программная платформа для сбора, дедупликации и сверки данных о жилом фонде из государственной информационной системы жилищно-коммунального хозяйства (ГИС ЖКХ) с расчётной (биллинговой) системой организации. Система выявляет расхождения в числе проживающих, помогает оператору обработать их через личный кабинет и формирует отчётность.
Назначение — выявление ранее не учтённых плательщиков и повышение полноты начислений за коммунальные услуги. Область применения: региональные операторы по обращению с ТКО, ресурсоснабжающие и управляющие организации, расчётно-кассовые центры.
Состав программного обеспечения
| Компонент | Назначение |
|---|---|
| Серверная часть | Хранение и обработка данных, выполнение сверки, программный интерфейс (API). Развёрнута на инфраструктуре правообладателя на территории Российской Федерации. |
| Личный кабинет оператора | Веб-приложение для работы пользователей: настройка территории, просмотр данных, обработка расхождений, отчётность. |
| Модуль сбора данных (агент) | Программа, устанавливаемая на рабочее место сотрудника организации. Выполняет выгрузку сведений из ГИС ЖКХ под учётной записью сотрудника организации. Управление агентами ведётся из личного кабинета. |
Личный кабинет оператора
- Регистрация организации по ИНН с подтверждением адреса электронной почты.
- Разграничение доступа по ролям: администратор и сотрудник.
- Настройка территории обслуживания и тарифа, используемого при расчёте показателей.
Сбор и хранение данных
- Сбор сведений о домах, помещениях и числе проживающих по выбранной территории из ГИС ЖКХ.
- Дедупликация и хранение реестра объектов жилищного фонда.
- Просмотр данных по территории в виде иерархии: регион, населённый пункт, улица, дом, помещения.
- Управление модулями сбора данных: статус, создание, получение установщика, команды.
Сверка с расчётной системой
- Автоматическое сопоставление числа проживающих по данным ГИС ЖКХ и расчётной системы.
- Выявление расхождений по лицевым счетам с расчётом разницы.
- Ведение списков расхождений «К обработке» и «Обработанные».
- Контроль актуальности: более свежие сведения расчётной системы не перезаписываются устаревшими.
Обработка расхождений
- Внесение изменений в биллинг по решению оператора.
- Отклонение расхождения с указанием причины из справочника.
- Массовая обработка выбранных позиций и отмена ранее принятых решений.
Отчётность и аналитика
- Ключевые показатели: объём проверенных объектов, выявленные расхождения, оценка потенциала доначислений.
- Динамика за период, разбивка по причинам отклонения, охват по территориям.
- Выгрузка результатов сверки файлом в формате электронной таблицы.
Информационная безопасность
- Учётные записи сотрудников для работы с государственными системами остаются у организации.
- Персональные данные за пределы контура обработки не передаются.
- Серверная инфраструктура размещена на территории Российской Федерации.
- По запросу заключается соглашение о неразглашении (NDA); техническое описание для служб ИБ и ИТ направляется комплектом с NDA.
Раздел 2 Информация, необходимая для установки программного обеспечения
Модель поставки
«Кодекс Ро-бот» предоставляется как интернет-сервис (SaaS). Установка серверной части на оборудование пользователя не требуется: работа ведётся через веб-браузер, серверная часть развёрнута на инфраструктуре правообладателя на территории Российской Федерации. Для выгрузки сведений из ГИС ЖКХ по решению организации на рабочее место сотрудника устанавливается модуль сбора данных (агент).
Требования к рабочему месту пользователя
- Персональный компьютер с доступом в сеть Интернет.
- Веб-браузер актуальной версии: Яндекс Браузер, Google Chrome, Mozilla Firefox или совместимый.
- Разрешение экрана от 1280 × 720.
- Дополнительное программное обеспечение для работы в личном кабинете не требуется.
Порядок подключения организации
- Направить заявку через форму на сайте или по адресу info@qodex.tech.
- Подписать соглашение о неразглашении (NDA). Проект соглашения направляется в день обращения.
- Зарегистрировать организацию в личном кабинете: указать ИНН и подтвердить адрес электронной почты.
- Дождаться подтверждения регистрации организации правообладателем.
- Пригласить сотрудников и назначить им роли: администратор или сотрудник.
- Указать территорию обслуживания и тариф в разделе «Настройки».
Установка модуля сбора данных (агента)
Требования к рабочему месту: ОС Microsoft Windows 10 или 11 (64-разрядная), оперативная память от 8 ГБ, свободное место на диске от 10 ГБ, канал доступа в Интернет от 10 Мбит/с.
- Войти в личный кабинет под учётной записью администратора организации.
- Открыть раздел «Настройки» → «Агенты» и создать агента.
- Скачать установщик агента на рабочее место сотрудника.
- Запустить установщик и следовать указаниям мастера установки.
- После установки запустить агент: статус отобразится в разделе «Агенты» личного кабинета.
Удаление агента выполняется штатными средствами операционной системы. Учётные записи для работы с государственными системами остаются у организации и правообладателю не передаются.
Системные требования серверной части
Приводятся справочно: серверная часть разворачивается и обслуживается правообладателем.
| Компонент | Требование |
|---|---|
| Операционная система | Linux. Подтверждена работоспособность на российских операционных системах Astra Linux и РЕД ОС |
| Среда выполнения | Python 3.11 и выше |
| СУБД | PostgreSQL 14 и выше |
| Веб-сервер | nginx с поддержкой TLS |
Обновление
Обновления серверной части и личного кабинета устанавливаются централизованно, действий пользователя не требуется. При выпуске новой версии модуля сбора данных обновлённый установщик доступен в личном кабинете. По вопросам подключения: info@qodex.tech, +7 937 500 06 65.
Раздел 3 Информация, необходимая для эксплуатации программного обеспечения
Начало работы
Открыть адрес сервиса в браузере, ввести логин и пароль учётной записи и нажать «Вход в систему». После авторизации открывается личный кабинет оператора. Навигация по разделам — в меню слева.
Разделы системы
| Раздел | Порядок работы |
|---|---|
| Отчёты и аналитика | Сводные показатели по территории: объём проверенных объектов, выявленные расхождения, оценка потенциальных доначислений по тарифу из настроек, динамика за период, разбивка по причинам отклонения и охват по территориям. |
| ГИС ЖКХ | Просмотр данных по территории в виде иерархии: субъект, населённый пункт, улица, дом. В карточке дома отображаются число помещений и проживающих, идентификатор дома и дата последней выгрузки. Доступны выгрузка сведений, сверка с биллингом и экспорт результата в файл электронной таблицы. По каждому помещению выводятся число проживающих по данным ГИС ЖКХ и биллинга, разница между ними и даты обновления сведений. |
| Рабочее место | Основной раздел работы с выявленными расхождениями. Оператор принимает решение по каждой позиции: обновить запись в биллинге или отклонить с указанием причины из справочника. Если источник данных биллинга ещё не подключён, раздел предлагает подключить его загрузкой файла или по API. |
| Настройки | Параметры рабочего пространства и управление организацией: территория работы, тариф, справочник причин отклонения, источник данных биллинга, агенты, организации, баланс и счета, смена пароля. |
Подключение источника данных биллинга
- Загрузка файлом. Скачать шаблон электронной таблицы, заполнить его выгрузкой из своей учётной системы и загрузить. Система проверяет файл и показывает ошибки.
- Подключение по API. Учётная система обменивается данными автоматически: передаёт лицевые счета и получает решения операторов. Токен и инструкция выдаются правообладателем.
Типовой сценарий работы
- Указать территорию обслуживания и тариф в разделе «Настройки».
- Подключить источник данных биллинга: файлом или по API.
- В разделе «ГИС ЖКХ» выполнить выгрузку сведений по территории.
- Запустить сверку с биллингом: система сформирует список расхождений по лицевым счетам.
- Обработать расхождения в «Рабочем месте»: обновить запись в биллинге или отклонить с указанием причины. Доступны массовая обработка и отмена решений.
- Проконтролировать показатели в разделе «Отчёты и аналитика» и выгрузить результат файлом электронной таблицы.
Завершение работы и поддержка
Выход выполняется командой выхода из системы в интерфейсе личного кабинета; отдельных действий по остановке сервиса не требуется. Обращения в техническую поддержку принимаются по адресу info@qodex.tech и по телефону +7 937 500 06 65 в рабочие дни с 9:00 до 18:00 (UTC+5). Техническая поддержка, устранение неисправностей и развитие продукта осуществляются правообладателем.