# Регламент сопровождения

Программное обеспечение «Универсальная платформа-конструктор сбора, обработки и согласования данных»

Редакция документа: 1.1. Дата: 21.09.2026.

## 1. Общие положения

Регламент определяет предлагаемый порядок приема обращений, анализа ошибок, восстановления работоспособности, обновления и консультирования по «Универсальная платформа-конструктор сбора, обработки и согласования данных». Объекты сопровождения: серверное приложение, пользовательский интерфейс, локальная библиотека компонентов, конфигурация форм, БД и параметры развертывания в согласованной зоне ответственности.

Документ является проектом регламента. Исполнитель, режим обслуживания, сроки реакции, сроки восстановления и состав услуг утверждаются для конкретного внедрения. Реквизиты и условия из документа другого проекта к платформе не применяются автоматически.

## 2. Участники и ответственность

Заказчик назначает ответственных пользователей и администратора, предоставляет описание проблемы и согласует работы, влияющие на доступность или данные. Эксплуатационная команда обеспечивает доступ к инфраструктуре, резервные копии и сохранность конфигурации в пределах своей ответственности.

Служба сопровождения регистрирует обращения, определяет приоритет, анализирует причины, сообщает ход работы, подготавливает исправления и результаты проверки. Разработчики подключаются, когда необходимо изменение программы, схемы БД или сборки.

## 3. Виды работ и уровни сопровождения

| Уровень | Состав работ | Типовой исполнитель |
| --- | --- | --- |
| I. Консультационный | Вход, навигация, ввод, настройка полей, объяснение поведения | Поддержка / администратор приложения |
| II. Прикладной и инфраструктурный | Анализ конфигурации, прав, журналов, БД и процесса установки | Администратор и специалист приложения |
| III. Разработка | Исправление кода, миграций, сборки, изменение функциональности | Разработчик с проверкой результата |

Уровень описывает требуемую компетенцию, а не срочность. Приоритет назначается по влиянию проблемы на пользователей и данные.

## 4. Подача и регистрация обращений

### 4.1. Каналы связи

Используется утвержденный канал регистрации заявок.

| Сведения | Значение |
| --- | --- |
| Организация сопровождения | Общество с ограниченной ответственностью «И8У8» |
| Электронная почта | 18U8_studio@mail.ru |
| Телефон | +7 (989) 116-19-77 |
| Рабочие часы и часовой пояс | Ежедневно с 9:00 до 22:00 по московскому времени (MSK, UTC+3) |

### 4.2. Содержание обращения

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

Прикладываются текст ошибки, обезличенный снимок экрана и относящийся к ситуации фрагмент журнала. Пароли, cookie, ключи и полные env-файлы в заявку не включаются. Для маршрута по возможности сообщается идентификатор процесса, если он известен администратору.

### 4.3. Регистрация

Обращению присваиваются номер, время регистрации, категория, приоритет и ответственный. Заявителю сообщаются номер и следующий шаг. Если сведений недостаточно, запрашиваются недостающие данные; причина ожидания фиксируется в карточке.

## 5. Приоритеты и сроки

| Приоритет | Признаки | Порядок обработки с момента получения обращения |
| --- | --- | --- |
| Критический | Массовая недоступность, признаки потери или повреждения данных | Немедленная эскалация в согласованные часы; сохранение диагностических данных. Не более 1 часа. |
| Высокий | Основной сценарий заблокирован у группы пользователей, обхода нет | Приоритетный анализ и план восстановления. Не более 24 часов. |
| Обычный | Локальная ошибка или доступен обходной путь | Работа в согласованной очереди. Не более 48 часов. |
| Консультация / развитие | Вопрос эксплуатации, пожелание, новый сценарий | Разъяснение или отдельная оценка задачи. Не более 72 часов. |

Время реакции — срок до принятия обращения и первого содержательного ответа. Время восстановления — срок до возврата согласованной работоспособности, возможно с временным обходным решением. Срок окончательного исправления может отличаться.

## 6. Выполнение и закрытие заявки

1. Проверить полноту сведений и воспроизводимость.
2. Определить затронутый компонент и влияние на данные.
3. Зафиксировать причину либо рабочую гипотезу и следующий диагностический шаг.
4. При необходимости предложить временный порядок работы.
5. Проверить исправление на стенде и согласовать окно внедрения.
6. Выполнить работы с предусмотренной резервной копией.
7. Повторить исходный сценарий и связанные проверки.
8. Передать заявителю результат, версию изменения и оставшиеся ограничения.

Заявка закрывается после подтверждения результата по принятому сторонами порядку. В карточке остаются причина, действия, время восстановления и сведения о выпуске. Если проблема повторилась, обращение возобновляется либо создается связанная заявка.

## 7. Плановое обслуживание

Периодичность утверждает эксплуатирующая организация. Для начала эксплуатации предлагается ежедневно контролировать доступность, свободное место, ошибки и результат резервного копирования; еженедельно проверять повторяющиеся ошибки и успешность заданий; перед каждым выпуском проверять миграции и восстановление на стенде. Это предлагаемый график, а не реализованный в приложении планировщик.

Состояние сервисов проверяется через docker compose ps, консольные журналы — через docker compose logs. Файловые журналы backend находятся в каталоге LOG_DIR внутри контейнера, по умолчанию /app/logs/app.log. При текущем монтировании ./backend:/app они доступны на хосте в backend/logs. По умолчанию LOG_RETENTION_DAYS равен 30. Проверьте права записи и фактическое удаление старых файлов. Ротация журналов не заменяет мониторинг и резервное копирование БД.

## 8. Резервное копирование и восстановление

### 8.1. Состав копии

Сохраняются БД PostgreSQL, идентификатор версии приложения, конфигурация развертывания и необходимые секреты в защищенном хранилище. Срок хранения, число копий, допустимая потеря данных и время восстановления утверждаются отдельно.

Пример логической копии БД промышленной контейнерной установки. Для среды разработки замените docker-compose-prod.yml на docker-compose-dev.yml. Команды выполняются из корня проекта; каталог backups должен быть исключен из Git и ограничен по доступу:

```sh
mkdir -p backups
chmod 700 backups
docker compose -f docker-compose-prod.yml exec -T docomo-postgres pg_dump -U admin -d docomo_db -Fc > backups/docomo.dump
```

Имя docomo.dump приведено для одной контрольной копии. При регулярном копировании используйте уникальные имена, контроль успешного завершения и отдельное хранилище; не перезаписывайте единственную рабочую копию. Копирование каталога работающей БД обычными файловыми средствами не рассматривается как проверенная резервная копия.

### 8.2. Проверка восстановления

Восстанавливайте контрольную копию в новую пустую БД, не в рабочую. Пример для отдельной БД docomo_restore_check в контейнере PostgreSQL (имя БД отличается от рабочей):

```sh
docker compose -f docker-compose-prod.yml exec -T docomo-postgres createdb -U admin docomo_restore_check
docker compose -f docker-compose-prod.yml exec -T docomo-postgres pg_restore -U admin -d docomo_restore_check --no-owner --exit-on-error < backups/docomo.dump
```

Если имя контрольной БД уже занято, выберите новое. Проверку приложения выполните в отдельной Docker-среде: перенесите копию в ее БД и запустите контейнеры совместимой версии с отдельным окружением и DATABASE_URL контрольной БД. Не меняйте DATABASE_URL рабочего backend. Для одновременного размещения стенда на том же хосте потребуются отдельные имена контейнеров, порты и каталоги данных, поскольку исходные Compose-файлы используют одинаковые container_name и db/pgdata. Проверьте формы, учетные записи и записи. Зафиксируйте результат и длительность восстановления. Наличие файла дампа без такой проверки не подтверждает возможность восстановления.

## 9. Обновления и аварийные работы

Перед обновлением фиксируются версия, изменения, резервная копия и план возврата. Прикладные контейнеры останавливаются до замены исходников, смонтированных в /app. Затем пересобираются Docker-образы; docomo-ui и frontend собираются внутри образа в этом порядке. Миграции backend выполняются отдельной командой docker compose run --rm --no-deps docomo-backend uv run aerich upgrade с выбранным Compose-файлом, после чего контейнеры пересоздаются. Подробные команды приведены в инструкции по установке. Локальный frontend используется только при разработке. Изменения env-файлов вводятся через пересоздание контейнера, а не простой restart; смена NEXT_PUBLIC_BACKEND требует пересборки frontend. После запуска проверяются вход, открытие формы, сохранение записи и применимые права.

При аварии сначала определяется состояние БД и исключаются действия, способные усугубить потерю данных. Решение о восстановлении копии согласуется с ответственным заказчика с учетом даты копии и возможной потери более поздних изменений. Обратная миграция не выполняется вслепую.

## 10. Известные особенности, учитываемые поддержкой

Настройка CORS и cookie влияет на вход; API-документация отключена вне development. Bootstrap-пароль при сохранении в окружении может применяться повторно при старте. Права на родительский элемент не наследуются дочерними элементами автоматически.

Отправка записи и маршрут независимы. После обновления страницы панель не восстанавливает ранее запущенный процесс, а подпись хранится как текст. Флаги Excel не подтверждают готовый обмен файлами. Эти ситуации сверяются с описанием функциональных характеристик прежде, чем классифицировать их как новый отказ.

## 11. Утверждение

Окончательно положения Регламента определяют представитель заказчика и представитель исполнителя при заключении договора лицензирования. Регламент вступает в силу с момента подписания договора лицензирования.
