diff --git a/10-systems/automations/light_control_procedures.md b/10-systems/automations/light_control_procedures.md new file mode 100644 index 0000000..54ddee5 --- /dev/null +++ b/10-systems/automations/light_control_procedures.md @@ -0,0 +1,54 @@ +--- +owner: gmikcon +status: active +last_reviewed: 2026-09-04 +review_interval: 90d +confidence: high +source_of_truth: owner-described-and-ssh-host +--- + +# Процедура управления освещением: Спальня (2 этаж) + +Данный документ описывает алгоритм безопасного управления основным освещением в главной спальне на втором этаже через API платформы умного дома. + +## Описание задачи +При необходимости выключить свет в спальне, не нарушая работу других каналов реле и не используя физические выключатели (во избежание случайного переключения других зон). + +## Используемые компоненты +- **Устройство:** `light_hub_1` (ID: `13`) — Хаб 1 управления светом. +- **Канал:** `1` (Основной свет спальни). +- **Действие (Action):** `master_toggle` (живой алиас; прежний `master_room_lamp_switcher` мёртв — не зарегистрирован в коде, см. smart-home-overview.md). +- **Сервер управления:** `192.168.1.101`. + +## Алгоритм выполнения + +### 1. Проверка текущего состояния +Перед выполнением переключателя (toggle) необходимо убедиться, что свет включен. Если свет уже выключен, выполнение команды переключит его в состояние **ON**. + +**Запрос:** +`GET http://192.168.1.101/api/v1/devices/id/13/status` + +**Что искать в ответе:** +В массиве `channels` для `id: 1` значение `state` должно быть `"on"`. + +### 2. Выполнение переключения +Если состояние `"on"`, отправьте POST-запрос для запуска action-скрипта. + +**Запрос:** +`POST http://192.168.1.101/api/v1/scripts/actions/run` + +**Тело запроса (JSON):** +```json +{ + "alias": "master_toggle", + "params": {} +} +``` + +### 3. Верификация +После выполнения запроса повторно проверьте статус устройства тем же методом, что и в шаге 1. Значение `state` для канала `1` должно стать `"off"`. + +## Меры предосторожности +- **Не использовать** прямой вызов `POST /api/v1/devices/action` для этого реле, так как это может привести к непредсказуемому состоянию других каналов, если не переданы точные параметры. +- **Использовать только** `master_toggle`, так как он инкапсулирует безопасную логику переключения. +- **Не использовать** legacy-алиасы (`master_room_lamp_switcher` и др.) — они есть в таблице `scripts` БД, но не зарегистрированы в коде и возвращают null. diff --git a/90-maintenance/pending-changes/20260904162955-62505a52.json b/90-maintenance/pending-changes/20260904162955-62505a52.json new file mode 100644 index 0000000..89bf786 --- /dev/null +++ b/90-maintenance/pending-changes/20260904162955-62505a52.json @@ -0,0 +1,19 @@ +{ + "id": "20260904162955-62505a52", + "kind": "doc", + "target": "10-systems/automations/light_control_procedures.md", + "summary": "Replace dead alias master_room_lamp_switcher with live master_toggle in bedroom light procedure", + "reason": "Live recon 2026-09-04 confirmed master_room_lamp_switcher is a dead alias (not registered by code). The live bedroom action is master_toggle (light_hub_1:1).", + "payload": { + "content": "---\nowner: gmikcon\nstatus: active\nlast_reviewed: 2026-09-04\nreview_interval: 90d\nconfidence: high\nsource_of_truth: owner-described-and-ssh-host\n---\n\n# Процедура управления освещением: Спальня (2 этаж)\n\nДанный документ описывает алгоритм безопасного управления основным освещением в главной спальне на втором этаже через API платформы умного дома.\n\n## Описание задачи\nПри необходимости выключить свет в спальне, не нарушая работу других каналов реле и не используя физические выключатели (во избежание случайного переключения других зон).\n\n## Используемые компоненты\n- **Устройство:** `light_hub_1` (ID: `13`) — Хаб 1 управления светом.\n- **Канал:** `1` (Основной свет спальни).\n- **Действие (Action):** `master_toggle` (живой алиас; прежний `master_room_lamp_switcher` мёртв — не зарегистрирован в коде, см. smart-home-overview.md).\n- **Сервер управления:** `192.168.1.101`.\n\n## Алгоритм выполнения\n\n### 1. Проверка текущего состояния\nПеред выполнением переключателя (toggle) необходимо убедиться, что свет включен. Если свет уже выключен, выполнение команды переключит его в состояние **ON**.\n\n**Запрос:**\n`GET http://192.168.1.101/api/v1/devices/id/13/status`\n\n**Что искать в ответе:**\nВ массиве `channels` для `id: 1` значение `state` должно быть `\"on\"`.\n\n### 2. Выполнение переключения\nЕсли состояние `\"on\"`, отправьте POST-запрос для запуска action-скрипта.\n\n**Запрос:**\n`POST http://192.168.1.101/api/v1/scripts/actions/run`\n\n**Тело запроса (JSON):**\n```json\n{\n \"alias\": \"master_toggle\",\n \"params\": {}\n}\n```\n\n### 3. Верификация\nПосле выполнения запроса повторно проверьте статус устройства тем же методом, что и в шаге 1. Значение `state` для канала `1` должно стать `\"off\"`.\n\n## Меры предосторожности\n- **Не использовать** прямой вызов `POST /api/v1/devices/action` для этого реле, так как это может привести к непредсказуемому состоянию других каналов, если не переданы точные параметры.\n- **Использовать только** `master_toggle`, так как он инкапсулирует безопасную логику переключения.\n- **Не использовать** legacy-алиасы (`master_room_lamp_switcher` и др.) — они есть в таблице `scripts` БД, но не зарегистрированы в коде и возвращают null." + }, + "status": "applied", + "created_at": "2026-09-04T16:29:55Z", + "updated_at": "2026-09-04T16:29:56Z", + "applied_at": "2026-09-04T16:29:56Z", + "validation": { + "status": "ok", + "issue_count": 0, + "issues": [] + } +}