ModernERP EAM / Рабочая инструкция
EAM и APS: недоступность, очередь и повторная доставка
Сопоставьте оборудование с ресурсом APS и контролируйте подтверждение, изменение и отмену ограничений.
Редакция от 21 ноября 2026 года. Действия и ограничения сверены с исходниками EAM; установленная версия и права могут отличаться.
Перед началом
Кому нужен доступ
Администраторы EAM и APS настраивают подключение и разрешения. Главный механик/диспетчер подтверждает простои в своём scope; пользователи без прав не меняют mapping и очередь.
Что подготовить
Существующий APS workspace, source ID импортированного снимка, external ID ресурса, tenant и организации. Подтвердите, что остановка выбранного оборудования действительно делает ресурс целиком недоступным.
1. Создайте подключение и отдельные права
В EAM откройте «APS», создайте HTTPS-подключение. На стороне APS настройте отдельную учётную запись ROLE_EAM_CONNECTOR и grants tenant/organization/connection/workspace/source. В EAM задайте EAM_APS_CREDENTIALS по connection UUID.
Проверьте результат: Учётная запись не получила доступ к остальным API APS. Пароли не включены в outbox или исходный код.
2. Сопоставьте именно ресурс планирования
Укажите оборудование, external ID ресурса, workspace и source. Текущий Pro-ресурс часто является участком section:<id>, а не отдельным станком. Для полной блокировки требуется явное подтверждение и основание.
Проверьте результат: Остановка одного станка не заблокирует цех необоснованно. Выбран существующий ресурс нужного импортированного источника.
3. Выберите влияние и подтвердите простой
INFORMATIONAL регистрирует факт без ограничения календаря. RESOURCE_UNAVAILABLE применяет подтверждённую недоступность к сопоставленному ресурсу. Обновление и отмена передают новую версию того же бизнес-объекта.
Проверьте результат: Черновик не попал в жёсткие ограничения. CAPACITY_REDUCTION не используется: частичная потеря мощности в V1 запрещена.
4. Запустите доставку и проверьте подтверждение
Администратор настраивает app:eam:availability:deliver по расписанию. Приёмник подтверждает событие после commit. В интерфейсе следите за pending, попытками и failed; повтор неизменного события не должен создавать новое ограничение.
Проверьте результат: Есть подтверждённая доставка, а фактический APS-календарь отражает окно. Один успешный HTTP-запрос не заменяет проверку нужного ресурса.
5. Устраните ошибку и повторите отправку
При остановке APS события остаются в очереди. Дождитесь штатного backoff; не переписывайте nextAttemptAt вручную. Для failed доступен штатный retry с сохранением eventId/payload, истории и счётчика попыток.
Проверьте результат: После восстановления очередь разгружается. Одинаковый eventId с другим содержимым не отправлен как «повтор»: приёмник отвергает конфликт.
6. Проверьте перенос или снятие окна
Отмена снимает только собственное влияние записи; пересекающиеся ручные и другие EAM-окна остаются. При переносе workspace/source доставляются отмена старому адресату и новое состояние. Сохраните grants старого адресата до ACK отмены.
Проверьте результат: Старое ограничение снято, новое подтверждено. Между workspace нет распределённой транзакции: результат проверен для каждого события.
7. Пересчитайте расписание
Изменение доступности повышает revision и требует нового расчёта APS. Событие EAM не утверждает новый производственный план автоматически. Реимпорт ERP повторно накладывает сохранённые EAM-ограничения.
Проверьте результат: Используется актуальный расчёт, а утверждение выполнено ответственным по принятому процессу.
Ограничения и ошибки
Нет автоматического бесконечного продления открытого ремонта: ожидаемый конец нужно обновлять. Отключение подключения сохраняет pending и историю. При включении проверяйте reconciliation; после его ошибки сверку можно повторить без удаления данных.
Если действие недоступно, проверьте роль, разрешения, принадлежность к участку и статус документа. При ошибке сохраните номер документа, время и текст сообщения; передайте их ответственному, прежде чем повторять изменяющую операцию.
Экраны интерфейса
Иллюстрации показывают отдельные экраны. Доступные действия сверяйте с вашей ролью и установленной версией; скриншоты не подтверждают выполнение всего сценария.

Примеры и команды
Ограниченная порция доставки
Команда отправляет реальные события настроенным получателям. Запускайте в нужной установке с подготовленными credentials; для постоянной работы используйте согласованное расписание от пользователя приложения.
php bin/console app:eam:availability:deliver --limit=100