1. Сведения о программном обеспечении
| Параметр | Значение |
|---|---|
| Наименование | «Мультиагентная платформа цифровой координации процессов МАПЦИКП» |
| Краткое наименование | «МАПЦИКП» |
| Версия | 1.0 |
| Класс ПО (заявляемый) | 09.01 «Средства управления бизнес-процессами (BPM)»; дополнительно — 09.11 «Средства управления содержимым (CMS), сайты и портальные решения», 05.10 «Базы знаний» |
| Правообладатель | Индивидуальный предприниматель Евстифеев Михаил Юрьевич, ИНН 526308058995, ОГРНИП 326527500057017 |
| Способ распространения | Размещение в инфраструктуре заказчика (on-premise), по лицензионному договору (публичная оферта) |
| Демонстрационный стенд | тепло.мапцикп.рф |
Назначение: цифровизация клиентских и внутренних процессов организаций (в том числе в сфере ЖКХ и ресурсоснабжения) — приём обращений граждан, их классификация и маршрутизация, подготовка ответов, плановое информирование, ведение справочников, публикация сведений на сайте, формирование документов. Ключевой принцип платформы — «агент готовит — человек авторизует» (Human-in-the-Loop): программные агенты формируют проекты решений, а исполнение значимых действий возможно только после утверждения уполномоченным сотрудником.
2. Функциональные характеристики
| Функция | Описание |
|---|---|
| Ролевой доступ (RBAC) | Восемь ролей и зон интерфейса; матрица «роль → права»; режим fail-closed (любая неоднозначность трактуется как отказ); анти-локаут последнего администратора |
| Приём и обработка обращений | Публичная форма подачи, классификация и маршрутизация Агентом №1, статусная модель (новое → в обработке → закрыто/отклонено), проверка статуса по номеру без раскрытия персональных данных |
| Согласование значимых действий (HITL) | Очередь согласований: агенты не исполняют значимые действия напрямую, а формируют заявку; исполнение — только после утверждения уполномоченным человеком |
| Программные агенты | Агент №1 — обработка обращений (классификация по ключевым словам, маршрутизация, черновик ответа, подбор статьи базы знаний). Агент №2 — плановое информирование и отключения (сбор затронутых потребителей по дереву справочников, уведомление и публичное объявление) |
| Конструктор публичных страниц (CMS) | Блочный редактор страниц сайта с версиями и откатом, жизненный цикл «черновик → согласование → публикация» |
| База знаний | Хранение регламентов и статей с полнотекстовым поиском (SQLite FTS5) и подсветкой; управление доступом по роли |
| Генерация документов | Шаблоны с полями-подстановками, формирование документов и выгрузка в формате .docx |
| Справочники (НСИ) | Дерево объектов и потребителей, операции создания/изменения с контролем целостности (уникальность лицевого счёта) |
| Личный кабинет абонента | Вход по лицевому счёту с одноразовым паролем на e-mail; сведения об объекте обслуживания, активные отключения, история и подача обращений |
| Дашборды и аналитика | Срез показателей по роли; диаграммы формируются на стороне сервера (инлайн-SVG), только по агрегатам, без персональных данных |
| Аудит | Неизменяемый журнал действий в виде цепочки хэшей SHA-256 с функцией проверки целостности |
| Защита персональных данных | Маскирование ПДн в режиме fail-closed (телефон, e-mail, лицевой счёт); проверка статуса обращения без раскрытия данных |
| Аутентификация и безопасность входа | Хэширование паролей scrypt, подписанные сессии, двухфакторная аутентификация (TOTP), принудительная смена пароля |
| Администрирование | Управление пользователями, ролями и правами; включение и отключение модулей с записью в аудит |
3. Системные требования
- Серверная ОС: Linux — целевые операционные системы из реестра российского ПО (Astra Linux, РЕД ОС, ALT Linux), также поддерживаются Debian и Ubuntu.
- Среда исполнения: Python 3.12 (CPython); допустимо 3.11+.
- Ресурсы: минимально 1 vCPU, 512 МБ ОЗУ, ~200 МБ дискового пространства без учёта данных.
- СУБД: встроенная SQLite (в составе стандартной библиотеки CPython) — отдельная серверная СУБД не требуется.
- Клиент: современный веб-браузер; специальное клиентское ПО не требуется.
- Сеть: подключение к внешним ресурсам не требуется — платформа полностью автономна.
4. Установка
Дистрибутив передаётся заказчику по лицензионному договору в виде исходного текста. Порядок развёртывания:
# 1. распаковать дистрибутив cd /opt/mapcikp/mapcikp-box # 2. создать виртуальное окружение и установить зависимости python3 -m venv .venv source .venv/bin/activate pip install -r requirements.txt # 3. запустить платформу uvicorn app.main:app --host 127.0.0.1 --port 8000
База данных создаётся и наполняется начальными данными автоматически при первом запуске;
путь к файлу БД переопределяется переменной окружения MAPCIKP_DB. Для промышленной
эксплуатации рекомендуется запуск под системной службой (systemd) от отдельного непривилегированного
пользователя и публикация через обратный прокси (nginx) с TLS.
requirements.txt дистрибутива.
Полное руководство администратора входит в комплект поставки.5. Эксплуатация
Роли пользователей
Платформа разграничивает доступ по ролям: администратор (управление пользователями и модулями, вход с двухфакторной аутентификацией), менеджер (согласования HITL, проверка целостности журнала), оператор обращений, диспетчер (плановые отключения), редактор (база знаний, документы, черновики страниц), публикатор (публикация страниц и объявлений). Абоненты пользуются личным кабинетом, посетители — публичным порталом без авторизации.
Типовой сценарий работы
- Гражданин подаёт обращение через публичную форму и получает номер для отслеживания.
- Агент №1 классифицирует обращение, определяет категорию и готовит проект ответа с опорой на базу знаний.
- Проект попадает в очередь согласований; уполномоченный сотрудник утверждает его, возвращает на доработку или отклоняет.
- После утверждения ответ исполняется, обращение закрывается; каждый шаг фиксируется в журнале аудита с хэш-цепочкой SHA-256.
Аналогично работает Агент №2: диспетчер выбирает объект НСИ, агент собирает затронутых потребителей, формирует уведомления и публичное объявление — исполнение также происходит только после утверждения.
Ознакомиться с работой платформы можно на демонстрационном стенде тепло.мапцикп.рф — демонстрационные учётные записи указаны на экране входа. Полное руководство пользователя входит в комплект поставки.
6. Обновление и резервное копирование
- Обновления устанавливаются администратором вручную (замена версии дистрибутива); механизмов автоматического обновления из внешних источников нет.
- Резервное копирование сводится к копированию одного файла БД SQLite и каталога загруженных изображений; рекомендуется ежесуточное расписание.
- Совместимость с российскими операционными системами из реестра поддерживается в рамках сопровождения.
7. Техническая поддержка
Гарантийное обслуживание, техническая поддержка и модернизация осуществляются правообладателем на территории Российской Федерации на русском языке. Каналы связи, приоритеты обращений и целевые сроки реагирования — на странице технической поддержки. Гарантийный срок — 12 месяцев с даты передачи ПО.