# Описание жизненного цикла

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

Описание процессов, обеспечивающих поддержание жизненного цикла.

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

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

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

Техническая часть документа основана на текущем репозитории. Приведенный порядок организации работ является проектом процесса для внедрения. Состав исполнителей, сроки, объем поддержки и порядок предоставления обновлений должны быть закреплены ответственными сторонами, наличие этого документа само по себе не подтверждает действующий договор сопровождения.

## 2. Поддержание жизненного цикла

### 2.1. Формирование требований

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

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

### 2.2. Разработка и управление конфигурацией

Изменения исходного кода фиксируются в Git. Для выпуска сохраняются идентификатор ревизии, состав изменений, версии зависимостей и миграций. Зависимости backend определяются pyproject.toml и uv.lock. Для frontend и docomo-ui — package.json и pnpm-lock.yaml.

При изменении структуры БД подготавливается миграция с помощью Aerich. Миграции, уже примененные в эксплуатации, не подменяются без согласованного плана. Изменение полей схемы оценивается отдельно: изменение имени поля может повлиять на интерпретацию ранее сохраненных JSON-данных без изменения физической структуры таблиц.

### 2.3. Проверка качества

До выпуска проверяются затронутые сервисы, авторизация и права на данные, применение миграций, сборка библиотеки интерфейса и frontend. В репозитории имеются тесты для настроек, сеансов, пользователей, иерархии, записей, ACL, маршрутов и репозиториев. Объем проверки выбирают по характеру изменения.

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

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

### 2.4. Выпуск и внедрение

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

Порядок технических действий: остановка прикладных контейнеров перед заменой смонтированных исходников, обновление исходников, сборка Docker-образов, применение миграций через одноразовый контейнер backend, пересоздание прикладных контейнеров и приемочная проверка. Зависимости устанавливаются внутри образов. Сборка docomo-ui происходит перед frontend в сборочном контейнере. Backend, frontend, PostgreSQL и Redis в эксплуатации работают через Docker Compose. Только frontend при разработке допускает локальную сборку и запуск, при этом backend и БД остаются в Docker. Миграции выполняются явно: приложение не создает таблицы при старте. Параметры окружения и секреты передаются отдельно от общедоступных материалов выпуска.

### 2.5. Эксплуатация

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

Основные данные хранятся в PostgreSQL. Консольные журналы просматриваются через docker compose logs. Файловые журналы backend размещаются по LOG_DIR внутри контейнера; имя и срок хранения определяются LOG_FILE_NAME и LOG_RETENTION_DAYS. При изменении AUTH_SESSION_SECRET необходимо учитывать возможную потерю действительности существующих сеансов.

### 2.6. Исправление ошибок и восстановление

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

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

### 2.7. Развитие

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

Текущие флаги Excel, текстовое поле подписи и частичная модель процессов не следует представлять как уже завершенные интеграции или криптографические функции.

### 2.8. Прекращение использования

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

## 3. Перечень работ сопровождения

- Консультирование по установке, настройке и эксплуатации.
- Помощь в настройке пользователей, ролей, схем, иерархии и маршрутов.
- Анализ ошибок входа, сохранения записей, применения действий и сборки.
- Подготовка исправлений и обновлений с проверкой миграций.
- Содействие восстановлению по согласованным резервным копиям.
- Актуализация эксплуатационной документации.
- Оценка и реализация согласованных доработок.

Фактически включенные услуги, часы обслуживания и порядок предоставления новых версий определяются условиями сопровождения.

## 4. Информация о персонале

| Роль участника | Необходимые знания и ответственность |
| --- | --- |
| Пользователь | Работа в браузере, ввод данных, проверка результата, оформление обращения |
| Администратор приложения | Пользователи и роли, настройка форм, схем, иерархии и маршрутов |
| Системный администратор | Linux, Docker Compose, контейнеризация, файловая система, сеть, HTTPS, хранение секретов, журналирование |
| Администратор БД | PostgreSQL, резервное копирование и восстановление, оценка миграций |
| Разработчик backend | Python, FastAPI, Tortoise ORM, Aerich, прикладные сервисы |
| Разработчик frontend | TypeScript, React, Next.js, сборка @docomo/ui |
| Специалист проверки | Сценарии приемки, проверка разграничения доступа и изменений |

Один сотрудник может совмещать роли при наличии компетенций. Утвержденная численность команды, ее местонахождение и персональные контакты в репозитории не установлены.

## 5. Сведения для утверждения

Окончательный порядок сопровождения жизненного цикла ПО закрепляется в договоре лицензирования. За сопровождение жизненного цикла ПО в соответствии с договором лицензирования отвечает Общество с ограниченной ответственностью «И8У8», ОКПО 84918223; ОГРН 1247700433045; ИНН 9714052120; КПП 771401001, 125424, г. Москва, ш. Волоколамское, д. № 71, корпус 4, помещение 315К.

Со стороны ООО «И8У8» закрепляется технический сотрудник, ответственный за выпуск и внедрение новых версий ПО, а также за эксплуатацию ПО и техническую поддержку. Работы осуществляются по адресу ООО «И8У8»: 125424, г. Москва, ш. Волоколамское, д. № 71, корпус 4, помещение 315К, а также с помощью удаленной настройки.

Для хранения исходного текста и объектного кода программного обеспечения «Универсальная платформа-конструктор сбора, обработки и согласования данных» ООО «И8У8» использует арендуемую у АО «Селектел» (далее — Selectel) инфраструктуру центра обработки данных: облачный сервер, предоставляемый на основании Пользовательского соглашения № 698708 от 02.10.2026. Оборудование размещено в центре обработки данных Selectel по адресу: 123060, г. Москва, ул. Берзарина, д. 36, стр. 3. Доступ к хранилищу предоставляется ограниченному кругу уполномоченных сотрудников ООО «И8У8».

Для связи в процессе сопровождения жизненного цикла ПО используются тел.: +7 (989) 116-19-77, e-mail: 18U8_studio@mail.ru.

Согласованный порядок сопровождения жизненного цикла ПО вступает в силу с даты заключения договора лицензирования.
