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

Установка и обновление EAM без Docker

Разверните нативный release, настройте окружение, фоновые задания и проверку работоспособности без смешения с базами ERP и APS.

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

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

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

Администратор сервера и приложения. Пользователь PHP должен читать конфигурацию и писать в var; операции с БД выполняются отдельной учётной записью с согласованными правами.

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

Проверенный release-архив и доверенную контрольную сумму, отдельную PostgreSQL-БД, HTTPS и резервную копию перед обновлением. Проверенный runtime поставки — PHP 8.6 и PostgreSQL 19; Composer допускает PHP >=8.4, но это не равнозначно проверке всех версий.

1. Проверьте пакет и зависимости

Получите архив из доверенного канала, проверьте SHA-256 и manifest. Release содержит production vendor, миграции и ops-скрипты; Composer на целевом сервере не обязателен. Нужные расширения и версии проверяет preflight.

Проверьте результат: Архив целостен, выбран нужный релиз; checksum из того же недоверенного источника не принят за доказательство подлинности.

2. Подготовьте отдельный release-каталог

Распакуйте приложение от отдельного пользователя. Web root должен указывать только на public/. Сохраните сессии и locks в защищённом shared-каталоге, а кеш каждого релиза оставляйте отдельным. Не переносите чужой prod cache.

Проверьте результат: Файлы .env.local и корень проекта не доступны через HTTP. У пользователя приложения есть права на необходимые runtime-каталоги.

3. Настройте production-окружение

По ops/env.production.example задайте APP_ENV=prod, APP_DEBUG=0, случайный APP_SECRET не короче 32 символов и отдельный DATABASE_URL. Пароли URL-encode. До настройки интеграций оставьте EAM_PRO_TOKENS и EAM_APS_CREDENTIALS пустыми JSON-объектами.

Проверьте результат: Выбрана именно БД EAM, не Pro и не APS. Секреты переданы отдельно от архива и не попали в Git.

4. Выполните явную установку

Остановите задания на время обновления и выполните sh ops/install.sh из каталога распакованного приложения от его пользователя. Скрипт проверяет пакет и окружение до миграций, применяет их и проверяет состояние схемы и production-кеш.

Проверьте результат: Миграции up-to-date, preflight и финальная проверка завершились успешно. Ошибка не скрыта принудительным продолжением скрипта.

5. Создайте администратора и расписание

Создайте пользователя командой app:eam:user с паролем из окружения. Настройте уведомления, delivery APS при подключении и генерацию ППР по ops/crontab.example. Генератор использует scoped actor; проверьте доступ к площадкам.

Проверьте результат: Первый вход работает; jobs используют правильный PHP, каталог и окружение. Не создан второй tenant вместо выдачи доступа существующему.

6. Проверьте сайт и обновление

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

Проверьте результат: Health не выдаёт tenant/connector-секретов. Возврат старого кода после миграции не считается гарантированным откатом: восстановление БД проверено отдельно.

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

Docker не требуется. Нельзя использовать demo-команду в production: она допускается только в dev/test с явным подтверждением. PHP built-in server из примеров разработки не является рекомендуемой production-конфигурацией. Прикладные базы не обновляются автоматически из документации.

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

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

Проверка и установка релиза

Первые команды проверяют подготовку; install применяет реальные миграции. Запускайте только из нужного release-каталога с его production-настройками и готовой копией данных.

php bin/console app:eam:release:verify --no-interaction
php bin/console app:eam:release:check --before-migrations --no-interaction
sh ops/install.sh

Первый администратор нового контура

Только при первой установке. Пароль вводится без отображения и передаётся через окружение; для существующего контура используйте --tenant вместо --new-tenant. Новый пароль должен содержать минимум 12 символов. Не запускайте этот пример с shell trace.

read -rs EAM_USER_PASSWORD
export EAM_USER_PASSWORD
php bin/console app:eam:user --email=admin@example.test \
  --new-tenant="Предприятие" --roles=admin
unset EAM_USER_PASSWORD