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