ModernERP EAM / Рабочая инструкция

Резервное копирование и восстановление EAM

Сохраните базу и настройки, проверьте checksum и восстановление только в новую пустую PostgreSQL-БД.

Редакция от 21 ноября 2026 года. Действия и ограничения сверены с исходниками EAM; установленная версия и права могут отличаться.

Перед началом

Кому нужен доступ

Администратор с правами pg_dump, создания отдельной restore-БД и чтения защищённой конфигурации. Обычному пользователю EAM не нужен доступ к архивам и секретам.

Что подготовить

Клиенты PostgreSQL 19, shell, sha256sum или shasum, каталог копий с ограниченным доступом и свободное место. Пароли лучше получать из защищённого .pgpass, не из аргументов команды.

1. Согласуйте состав копии

Зафиксируйте версию приложения и миграций. Копия БД включает оборудование, ремонтную историю, аудит и inbox/outbox; APP_SECRET, connector credentials и серверная конфигурация хранятся отдельно. Определите, какие задания нужно остановить.

Проверьте результат: Есть согласованный комплект, а не один SQL-файл без настроек подключения и версии кода.

2. Явно выберите исходную БД

Передайте PGHOST, PGPORT, PGUSER и PGDATABASE именно для EAM. Не полагайтесь на случайные defaults пользователя shell. Проверьте имя и сервер до запуска backup.

Проверьте результат: Копируется нужная EAM-БД, не ERP, APS или локальная тестовая база.

3. Создайте архив и checksum

Запустите sh ops/backup.sh с новым путём. Скрипт проверяет PostgreSQL 19, создаёт custom-format dump без owner/ACL и файл .sha256; существующий архив не перезаписывается.

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

4. Подготовьте новую пустую цель

Для проверки создайте отдельную БД. PGDATABASE и EAM_RESTORE_CONFIRM должны явно совпадать с её именем. Restore отказывается очищать уже непустую базу. Рабочие обмены восстановленного стенда не включайте.

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

5. Проверьте восстановление

Запустите sh ops/restore.sh с архивом и checksum рядом. Скрипт сверяет checksum и пустоту цели, затем выполняет pg_restore с остановкой при ошибке. Подготовьте владельца/права целевой БД отдельно: owner/ACL в dump не переносятся.

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

6. Проведите прикладную проверку

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

Проверьте результат: Стенд не создал повторных бизнес-событий в реальном APS. Результат восстановления и ответственный за cutover зафиксированы.

Ограничения и ошибки

Checksum обнаруживает порчу, но не заменяет доверенный канал хранения. Restore не обещает транзакционную очистку после любого сбоя: неудачный результат проверяйте в новой цели, а не запускайте повтор поверх неполной базы. Нет автоматического отката схемы через down.

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

Примеры и команды

Копия выбранной EAM-БД

Учебные имена и путь. Каталог должен существовать и быть защищён; пароль берётся из настроенного .pgpass. Архив сохраняет реальные данные выбранной базы.

PGHOST=127.0.0.1 PGPORT=5432 PGUSER=eam PGDATABASE=eam \
  sh ops/backup.sh /secure-backups/eam-2026-11-21.dump

Восстановление в отдельную пустую БД

База eam_restore_check должна быть заранее создана и пуста. Не подставляйте рабочую базу. Не включайте production-коннекторы восстановленного стенда.

PGHOST=127.0.0.1 PGPORT=5432 PGUSER=eam PGDATABASE=eam_restore_check \
  EAM_RESTORE_CONFIRM=eam_restore_check \
  sh ops/restore.sh /secure-backups/eam-2026-11-21.dump