Appearance
Mode object
Объект режимов хранит переключаемый список состояний States с индексами; Value — индекс активного состояния (-1 — без состояния, 0 — последнее). ValueAfterReboot — производное от Value для бэкенда: UNDEFINED (Value=-1), LAST_VALUE (Value=0) или VALUE_FROM_LIST (Value=state.index).
Настройки
ts
export const ModeObjectSettingsSchema = z.object({
settings: z.object({
/** Индекс активного состояния (index из States). -1 — без состояния, 0 — последнее. */
Value: z.number(),
/** Список состояний режима (сортируется по index при нормализации в конструкторе). */
States: z.array(ZodModeObjectState),
/** Действие после перезагрузки */
ActionAfterReboot: z.nativeEnum(EActionAfterReboot),
/** Состояние после перезагрузки */
ValueAfterReboot: z.nativeEnum(EValueAfterReboot),
}),
});После перезапуска
Словарь значений, семантика и связка с действием — на странице «После перезапуска». Этот тип использует подмножество (★ — значение по умолчанию для новых объектов):
| Значение (в БД) | Лейбл редактора |
|---|---|
ValueFromList | Значение из списка |
LastValue | Последнее значение |
Undefined | Без состояния ★ |
Логика и команды
Команда «установить значение» (CMD_CHANGE_VALUE): значение — reference на состояние mode-object; опции — проекция состояний цели, удаление состояния удаляет ссылающиеся действия (deleteStateReferences). Реализация ILinkAdapter: createEditorState — дропдаун состояний цели (дефолт — активное); editorStateToStoredDB — стабильный stateId; toRuntimePayload — индекс состояния в AddData-форме прошивки.
createEditorState() // поле stateId, дефолт — «День»
editorStateToStoredDB(editorState) // => { stateId: "3f9c…" } — в БД
toRuntimePayload({ stateId: "3f9c…" }) // AddData value = 1 (Ночь — индекс 1)★ — значение по умолчанию (чем предзаполнена форма / что выбрано при создании).
События — когда объект владелец реакции
- изменение (
MSG_STATUS_CHANGED) ★
Действия — когда объект выбран целью действия
установить значение (CMD_CHANGE_VALUE) ★
- изменить состояние на (
stateId) — список:- «Состояние 1» ★
- «Состояние 2»
увеличить значение (CMD_INC_VALUE)
- увеличить на значение (
value) — число; ★ 1; минимум 1, максимум 2
уменьшить значение (CMD_DEC_VALUE)
- уменьшить на значение (
value) — число; ★ 1; минимум 1, максимум 2
переключить (CMD_SWITCH)
- полей нет: команда без параметров
обновить (CMD_UPDATE)
- полей нет: команда без параметров
Условия — когда объект связан в кейсе реакции
- значение (
Value) ★- операторы:
- «равно» (
eq) ★ - «не равно» (
neq) - «больше» (
more) - «меньше» (
less)
- «равно» (
- значение — число: ★ 0
- операторы:
- состояние (
State)- операторы:
- «находится в состоянии» (
eq) ★ - «не находится в состоянии» (
neq)
- «находится в состоянии» (
- значение — список:
- «Состояние 1» ★
- «Состояние 2»
- операторы:
- uiState (
uiState)- операторы:
- «равно» (
eq) ★
- «равно» (
- значение — число: ★ 6
- операторы:
Ссылочная модель состояний
Ссылочная модель состояний: id — стабильный идентификатор (существующая строка или новый uuid), index — целочисленный, 1-based и уникальный: кандидат нормализуется как max(1, trunc), коллизии сдвигаются вверх. Конструктор (getSettings) прогоняет States через нормализацию и сортирует по index; Value, не попадающий ни в один index, сбрасывается.
Как адаптер переводит stateId в runtime-формат индекса — см. специализированные адаптеры.
Драйвер-линки
★ — поле по умолчанию в новой связи.
Поля объекта для связи с драйвером
| Поле | Чт. | Зап. |
|---|---|---|
| значение ★ | ✓ | ✓ |
| обновить (служебный канал) | ✓ | — |
| авария (служебный канал) | ✓ | — |
Связи только на чтение у драйверов: SNMP, PING.
Хранение
Сохраняется в таблице project_objects через RepositoryObject (Dexie).