Цифровой двойник и автоматическое создание агентов¶
5.1. Объект цифрового двойника¶
Объект цифрового двойника описывает физическую или логическую сущность на схеме.
Модель данных: digitalTwin.objects[].
| Поле UI | Обязательность | Тип UI | Модель данных | Комментарий |
|---|---|---|---|---|
| Наименование | Да | text | name |
Для агентных объектов используется также как имя агента по умолчанию |
| Вид объекта | Да | readonly / tool type | objectType |
Из справочника типов объектов ЦД |
| Подтип объекта | Нет | select | objectSubType |
Тип станка, тип склада, тип двери и т.п. |
| Политика агентности | Авто | readonly | objectTypeDefinitions[].agentCreationPolicy |
NEVER, OPTIONAL или REQUIRED |
| Архетип агента | Для агентного объекта | select | agents[].archetypeId |
Только совместимые с objectType архетипы; поле сохраняется у автоматически создаваемого агента |
| Родитель | Да для вложенных | tree selector | parentObjectId |
Площадка, этаж, помещение, зона |
| Этаж / отметка | Нет | floor selector / number | floorElevation |
|
| Геометрия | Да | canvas editor | geometry |
Точка, линия, полигон, прямоугольник |
| Физические атрибуты | Нет | typed attributes | attributes |
Габариты, высота, материал стены, ширина ворот |
| Комментарий | Нет | textarea | attributes.comment |
Объект не хранит capability, производительность, вместимость как расчетную способность, календарь, занятость и очереди.
5.2. Признак агентности объекта¶
Признак агентности не является свободным переключателем. Его режим определяется agentCreationPolicy из справочника типов объектов ЦД: NEVER, OPTIONAL или REQUIRED.
Тип объекта не определяет точный архетип. Для агентного объекта пользователь выбирает архетип из списка, отфильтрованного по agentArchetypes[].compatibleObjectTypes[].
5.3. Системное поведение при создании и удалении объектов¶
Создание объекта¶
- Пользователь создает объект на схеме.
- Система сохраняет
digitalTwin.objects[]. - Система читает
agentCreationPolicyиз справочника типов объектов ЦД. - Для
OPTIONALилиREQUIREDпользователь выбирает совместимый архетип; приREQUIREDбез выбора сохранение запрещено. - Система одной транзакцией создает объект и агента.
- Система создает
agents[].spatialBinding.objectIdсо ссылкой на объект. - Система создает начальные
agentCapabilities[]изagentArchetype.capabilitySpecifications[].
Изменение типа объекта¶
Если пользователь меняет тип объекта:
- если новый тип совместим с текущим архетипом, агент и его настройки сохраняются;
- если текущий архетип несовместим, пользователь должен выбрать новый совместимый архетип, после чего система проверяет перенос capability и профилей;
- если объект стал неагентным, система должна предупредить о потере агентных настроек и после подтверждения удалить или архивировать связанного агента;
- если объект стал агентным, система запрашивает совместимый архетип и создает агента автоматически;
- если у агента уже есть настроенные профили выполнения, система должна проверить их совместимость с новым типом.
Удаление объекта¶
Пользователь удаляет объект, а не агента.
Если у объекта есть агент:
- система показывает предупреждение о связанных настройках агента;
- после подтверждения удаляет или архивирует объект, агента, capability и профили, если они не используются в сохраненных расчетах;
- если используются в расчетах, объект и агент помечаются как недоступные в новой версии проекта, но исторические результаты не ломаются.
Связанные документы: Справочники | Соответствие типов | Агенты | Связка операции с агентом