КОДЕКС РО-БОТ QODEX
Главная

Документация

Документация программного обеспечения «Кодекс Ро-бот»

На этой странице размещена документация, содержащая описание функциональных характеристик программного обеспечения «Кодекс Ро-бот» и информацию, необходимую для установки и эксплуатации программного обеспечения. Правообладатель – ООО «Кодекс технологии» (ОГРН 1200200055791, ИНН 0278962265).

Документы

Функциональные характеристики Назначение, состав и функциональные возможности программного обеспечения. Скачать PDF
Инструкция по установке Модель поставки, требования к рабочему месту, порядок подключения, установка модуля сбора данных. Скачать PDF
Руководство пользователя Порядок эксплуатации: вход, разделы системы, сверка, обработка расхождений, выгрузка результатов. Скачать PDF
Описание жизненного цикла Процессы поддержания жизненного цикла ПО, устранение неисправностей, совершенствование, персонал. Скачать PDF

Раздел 1

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

«Кодекс Ро-бот» – программная платформа для сбора, дедупликации и сверки данных о жилом фонде из государственной информационной системы жилищно-коммунального хозяйства (ГИС ЖКХ) с расчётной (биллинговой) системой организации. Система выявляет расхождения в числе проживающих, помогает оператору обработать их через личный кабинет и формирует отчётность.

Назначение – выявление ранее не учтённых плательщиков и повышение полноты начислений за коммунальные услуги. Область применения: региональные операторы по обращению с ТКО, ресурсоснабжающие и управляющие организации, расчётно-кассовые центры.

Состав программного обеспечения

КомпонентНазначение
Серверная частьХранение и обработка данных, выполнение сверки, программный интерфейс (API). Развёрнута на инфраструктуре правообладателя на территории Российской Федерации.
Личный кабинет оператораВеб-приложение для работы пользователей: настройка территории, просмотр данных, обработка расхождений, отчётность.
Модуль сбора данных (агент)Программа, устанавливаемая на рабочее место сотрудника организации. Выполняет выгрузку сведений из ГИС ЖКХ под учётной записью сотрудника организации. Управление агентами ведётся из личного кабинета.

Личный кабинет оператора

  • Регистрация организации по ИНН с подтверждением адреса электронной почты.
  • Разграничение доступа по ролям: администратор и сотрудник.
  • Настройка территории обслуживания и тарифа, используемого при расчёте показателей.

Сбор и хранение данных

  • Сбор сведений о домах, помещениях и числе проживающих по выбранной территории из ГИС ЖКХ.
  • Дедупликация и хранение реестра объектов жилищного фонда.
  • Просмотр данных по территории в виде иерархии: регион, населённый пункт, улица, дом, помещения.
  • Управление модулями сбора данных: статус, создание, получение установщика, команды.

Сверка с расчётной системой

  • Автоматическое сопоставление числа проживающих по данным ГИС ЖКХ и расчётной системы.
  • Выявление расхождений по лицевым счетам с расчётом разницы.
  • Ведение списков расхождений «К обработке» и «Обработанные».
  • Контроль актуальности: более свежие сведения расчётной системы не перезаписываются устаревшими.

Обработка расхождений

  • Внесение изменений в биллинг по решению оператора.
  • Отклонение расхождения с указанием причины из справочника.
  • Массовая обработка выбранных позиций и отмена ранее принятых решений.

Отчётность и аналитика

  • Ключевые показатели: объём проверенных объектов, выявленные расхождения, оценка потенциала доначислений.
  • Динамика за период, разбивка по причинам отклонения, охват по территориям.
  • Выгрузка результатов сверки файлом в формате электронной таблицы.

Информационная безопасность

  • Учётные записи сотрудников для работы с государственными системами остаются у организации.
  • Персональные данные за пределы контура обработки не передаются.
  • Серверная инфраструктура размещена на территории Российской Федерации.
  • По запросу заключается соглашение о неразглашении (NDA); техническое описание для служб ИБ и ИТ направляется комплектом с NDA.

Раздел 2

Информация, необходимая для установки программного обеспечения

Модель поставки

«Кодекс Ро-бот» предоставляется как интернет-сервис (SaaS). Установка серверной части на оборудование пользователя не требуется: работа ведётся через веб-браузер, серверная часть развёрнута на инфраструктуре правообладателя на территории Российской Федерации. Для выгрузки сведений из ГИС ЖКХ по решению организации на рабочее место сотрудника устанавливается модуль сбора данных (агент).

Требования к рабочему месту пользователя

  • Персональный компьютер с доступом в сеть Интернет.
  • Веб-браузер актуальной версии: Яндекс Браузер, Google Chrome, Mozilla Firefox или совместимый.
  • Разрешение экрана от 1280 × 720.
  • Дополнительное программное обеспечение для работы в личном кабинете не требуется.

Порядок подключения организации

  1. Направить заявку через форму на сайте или по адресу info@qodex.tech.
  2. Подписать соглашение о неразглашении (NDA). Проект соглашения направляется в день обращения.
  3. Зарегистрировать организацию в личном кабинете: указать ИНН и подтвердить адрес электронной почты.
  4. Дождаться подтверждения регистрации организации правообладателем.
  5. Пригласить сотрудников и назначить им роли: администратор или сотрудник.
  6. Указать территорию обслуживания и тариф в разделе «Настройки».

Установка модуля сбора данных (агента)

Требования к рабочему месту: ОС Microsoft Windows 10 или 11 (64-разрядная), оперативная память от 8 ГБ, свободное место на диске от 10 ГБ, канал доступа в Интернет от 10 Мбит/с.

  1. Войти в личный кабинет под учётной записью администратора организации.
  2. Открыть раздел «Настройки» → «Агенты» и создать агента.
  3. Скачать установщик агента на рабочее место сотрудника.
  4. Запустить установщик и следовать указаниям мастера установки.
  5. После установки запустить агент: статус отобразится в разделе «Агенты» личного кабинета.

Удаление агента выполняется штатными средствами операционной системы. Учётные записи для работы с государственными системами остаются у организации и правообладателю не передаются.

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

Приводятся справочно: серверная часть разворачивается и обслуживается правообладателем.

КомпонентТребование
Операционная системаLinux. Подтверждена работоспособность на российских операционных системах Astra Linux и РЕД ОС
Среда выполненияPython 3.11 и выше
СУБДPostgreSQL 14 и выше
Веб-серверnginx с поддержкой TLS

Обновление

Обновления серверной части и личного кабинета устанавливаются централизованно, действий пользователя не требуется. При выпуске новой версии модуля сбора данных обновлённый установщик доступен в личном кабинете. По вопросам подключения: info@qodex.tech, +7 937 500 06 65.

Раздел 3

Информация, необходимая для эксплуатации программного обеспечения

Начало работы

Открыть адрес сервиса в браузере, ввести логин и пароль учётной записи и нажать «Вход в систему». После авторизации открывается личный кабинет оператора. Навигация по разделам – в меню слева.

Разделы системы

РазделПорядок работы
Отчёты и аналитикаСводные показатели по территории: объём проверенных объектов, выявленные расхождения, оценка потенциальных доначислений по тарифу из настроек, динамика за период, разбивка по причинам отклонения и охват по территориям.
ГИС ЖКХПросмотр данных по территории в виде иерархии: субъект, населённый пункт, улица, дом. В карточке дома отображаются число помещений и проживающих, идентификатор дома и дата последней выгрузки. Доступны выгрузка сведений, сверка с биллингом и экспорт результата в файл электронной таблицы. По каждому помещению выводятся число проживающих по данным ГИС ЖКХ и биллинга, разница между ними и даты обновления сведений.
Рабочее местоОсновной раздел работы с выявленными расхождениями. Оператор принимает решение по каждой позиции: обновить запись в биллинге или отклонить с указанием причины из справочника. Если источник данных биллинга ещё не подключён, раздел предлагает подключить его загрузкой файла или по API.
НастройкиПараметры рабочего пространства и управление организацией: территория работы, тариф, справочник причин отклонения, источник данных биллинга, агенты, организации, баланс и счета, смена пароля.

Подключение источника данных биллинга

  • Загрузка файлом. Скачать шаблон электронной таблицы, заполнить его выгрузкой из своей учётной системы и загрузить. Система проверяет файл и показывает ошибки.
  • Подключение по API. Учётная система обменивается данными автоматически: передаёт лицевые счета и получает решения операторов. Токен и инструкция выдаются правообладателем.

Типовой сценарий работы

  1. Указать территорию обслуживания и тариф в разделе «Настройки».
  2. Подключить источник данных биллинга: файлом или по API.
  3. В разделе «ГИС ЖКХ» выполнить выгрузку сведений по территории.
  4. Запустить сверку с биллингом: система сформирует список расхождений по лицевым счетам.
  5. Обработать расхождения в «Рабочем месте»: обновить запись в биллинге или отклонить с указанием причины. Доступны массовая обработка и отмена решений.
  6. Проконтролировать показатели в разделе «Отчёты и аналитика» и выгрузить результат файлом электронной таблицы.

Завершение работы и поддержка

Выход выполняется командой выхода из системы в интерфейсе личного кабинета; отдельных действий по остановке сервиса не требуется. Обращения в техническую поддержку принимаются по адресу info@qodex.tech и по телефону +7 937 500 06 65 в рабочие дни с 9:00 до 18:00 (UTC+5). Техническая поддержка, устранение неисправностей и развитие продукта осуществляются правообладателем.