Шестнадцать систем, собранных под одну работу

Архитектура

• Панель — одна веб-компонента для Home Assistant, а не форк интерфейса: ставится как карточка и не мешает штатному Lovelace.
• Загрузка двухступенчатая: лёгкий загрузчик сразу показывает заставку и подтягивает основной файл — Lovelace не успевает показать «ошибку конфигурации».
• Мобильный слой — последний в каскаде стилей и намеренно перекрывает десктопный; разметка телефона ветвится по медиазапросу, а не по ширине окна на лету.

Решения, которые дались опытом

• Фоновые перерисовки на телефоне троттлятся: каждая пересборка DOM переносила видеоплеер и он мигал. Действия пользователя рисуются мгновенно, фон — раз в несколько секунд.
• Кэш файла панели с почасовым ключом: раньше телефон качал мегабайты при каждом открытии.
• Панель заперта во вьюпорт, скроллится только рабочая область — иначе iOS оставлял «зависший» скролл документа.

Архитектура

• Все конфигурации разделов — не константы в коде, а документ дома, который материализуется при загрузке. Встроенные значения — только дефолты «родного» дома.
• Привязки описаны ролями: новое устройство получает роль, а не строчку в коде панели.
• Настройки владельца синхронизируются между устройствами через профиль пользователя Home Assistant.

Честность важнее магии

• Слабо распознанное помечается «средней» уверенностью и подписью «проверьте» — панель не делает вид, что уверена.
• Обучение на исправлениях включается только там, где классификатор слаб: иначе одна случайная правка ломала бы уверенные связи.
• Регрессия проверяется на нескольких синтетических домах разной архитектуры — от квартиры до дома с композитными воротами.

Каскад

• Сначала бесплатные интенты — простые команды выполняются локально и не стоят ничего. К модели уходит только то, что действительно требует рассуждения.
• Факты считает дом и панель, модель их только объясняет — ответ не может «придумать» показания счётчика.
• Все AI-кнопки панели ходят в один движок объяснений с разными видами запроса, а не в десяток разных промптов.

Граф дома

• Между устройствами и ассистентом появился слой связей: комнаты, климатические зоны, контуры, источники тепла, счётчики, проёмы — и рёбра между ними («греет», «содержит», «управляет»). Список устройств отвечает на «что есть», граф — на «как соединено», и без второго вопрос «почему» неразрешим.
• Граф собирается из уже описанной конфигурации дома, без единого нового идентификатора сущности, и переживает переименования так же, как связи панели.
• Разбор идёт вторым ходом: модель просит факты по узлу — панель считает их локально по истории дома и присылает готовыми. Числа не выдумываются по построению.
• Поверх фактов работают правила, а не модель: они дают вывод и обязаны уметь сказать «не хватает данных» вместо ближайшей подходящей причины.
• Контур наблюдается каскадом «сервопривод → реле → термостат зоны»: отдельной сущности привода в доме может не быть, но команду контуру подаёт сам термостат — значит слепых зон нет.

Экономика и надёжность

• Детерминированный кэш ответов: одинаковые по смыслу факты (с квантованием чисел) переиспользуют готовый текст, подставляя изменившиеся значения. Это не нейросеть — и в этом смысл: результат воспроизводим и бесплатен.
• Поверх тарифных лимитов стоит общий предохранитель на дом — защита от разорительного цикла.
• Провайдер модели переключаемый; контракт ответа для панели при этом не меняется.
• Контекст диалога держится стабильным идентификатором разговора: без этого голосовой агент терял нить на каждой фразе.

Архитектура

• Это интеграция, а не набор скриптов: обновление и бэкап оформлены сервисами, старые скрипты остались запасным путём для старых панелей.
• Регистрация ресурса идёт через хранилище интерфейса с защитой от дублей — повторная установка не плодит записи.
• Существующий паспорт дома никогда не перезаписывается: переустановка не рвёт связь с подпиской и историей.

Безопасность

• Секретов внутри нет; токен агента лежит в закрытом хранилище, а не в веб-каталоге — иначе он утёк бы в браузер.
• Резервные копии шифруются на стороне дома паролем владельца: сервер их прочитать не может.

Механика

• Версия берётся из самого файла панели — рассинхронизировать «версию в списке» и «версию в коде» невозможно.
• Установщик пишет этапы (скачивание → проверка → установка) в статус-файл, панель читает его раз в секунду и двигает прогресс-бар.
• Раздача файла привязана к подписке, но со «страховкой»: сбой чтения подписки не блокирует обновление, а старые пути оставлены открытыми, пока не обновятся все дома.

Правило эксплуатации

• Обратная совместимость проверяется перед каждой выкладкой: панель обновляется у людей, которые не звали инженера.

Три места и одно направление

• Агент живёт внутри интеграции, а не отдельным демоном: меньше движущихся частей в чужом доме.
• Телеметрия пишется в отдельную базу — это самый пишущий поток, ему нечего делать рядом с боевыми данными.
• Рабочее место держит кэш: недоступное облако даёт баннер, а не пустой экран.

Сознательные ограничения

• Канала команд домам нет вообще. Мониторинг не должен уметь ничего выключать — иначе компрометация облака становится компрометацией домов.
• Дочерние проблемы подавляются: одна поломка даёт один инцидент, а не двадцать.
• В историю пишутся счётчики, а не списки устройств — иначе парк домов за год съел бы десятки гигабайт.

Стыковка платежа с домом

• Платёжная страница не принимает собственных параметров, поэтому дом и тариф записываются в журнал намерений до ухода в кассу, а списание стыкуется по плательщику.
• Продление идемпотентно по номеру платежа: повторное уведомление не добавляет лишний месяц.

Найденная и закрытая дыра

• Тариф определяет сумма платежа, а не поле в запросе. Журнал намерений открыт всем — иначе можно было заплатить за младший тариф и заявить старший. Из намерения берётся только дом.
• Уведомления без проверяемой подписи ничего не активируют — только логируются.

Решения

• Туннель поднимает сам дом и держит автоматически; цель жёстко ограничена одним локальным адресом — туннель не превращается в проход в сеть заказчика.
• Сертификат на локальный адрес выпускается проверкой владения доменом через DNS: наружу ничего публиковать не нужно.
• Продление автоматическое и выполняется в доме — истёкший сертификат не превращается в выезд.

Ключевое ограничение

• Второй панели не существует и заводить её нельзя. Демо отличается только источником данных: подменяется интерфейс связи с домом, всё остальное — продакшн-код. Иначе витрина через месяц начала бы врать.
• Роль автоматики играет отдельный движок сценариев виртуального дома — он и создаёт «жизнь» на экране.
• Состояния устройств генерируются из самой панели, а не пишутся руками: обновилась панель — пересобралась демонстрация.

Мелочи, которые решают

• Кадры фасада дома пережаты с сотен мегабайт до десятка, а виртуальное солнце ходит только по тем фазам, для которых кадры собраны.
• Мастер первого запуска в демо не показывается — гость попадает сразу в готовый дом.

Данные

• Автосинхронизация «смета → каталог»: ручная позиция с ценой попадает в каталог и дальше следует за правками строки. Каталог наполняется работой, а не отдельным вечером ввода данных.
• Полсотни исторических смет разобраны и загружены — система подсказывает, что обычно бывает в таком проекте и чего в смете не хватает.
• Закупки создаются идемпотентно: повторное согласование не удваивает заказ.

AI в рабочем месте

• Модель правит тексты КП и возвращает только изменённые поля; применяются исключительно текстовые поля снимка — цены и состав она трогать не может физически.
• Есть режим «сообщение клиенту»: тот же смысл, но языком мессенджера.

Главный принцип

• Никакого «магического автопроекта». Расчётный ток не равен проектному номиналу: расчёт возвращает формулу, входные данные и единицы, а при нехватке данных честно говорит «недостаточно данных» — и ничего не меняет сам.
• Авторазмещение, подбор корпуса и перенумерация работают только через предпросмотр и подтверждение. Закреплённые аппараты и резервные блоки не двигаются.

Инженерия

• Автосохранение с оптимистичной блокировкой: две открытые вкладки не затирают друг друга молча, конфликт виден.
• Рендерер схемы общий для экрана и печати — распечатка не может отличаться от того, что видно.
• Деньги в спецификации справочные; настоящие появляются только после переноса в смету.
• Тестовые щиты от простого до трёхфазного на 45+ линий — для проверки интерфейса на реальном масштабе.

Ограничения, заданные до начала работы

• Себестоимость запроса нулевая: никаких платных сервисов распознавания. Компьютерное зрение написано под задачу и работает в браузере клиента.
• Сценарий «плохое фото» обязан честно давать слабый результат и ручной режим, а не рисовать выдуманные стены.
• Во фронтенде нет ни одной цены: элемент ссылается на ключ, ключ — на позицию каталога. Ненастроенный ключ показывается как «не настроено», а не как выдуманное число.

Где проходит граница ответственности

• Номиналы защиты, сечения, УЗО и распределение по фазам не назначаются автоматически — это работа щита и живого инженера.
• Условные обозначения описаны один раз примитивами и проигрываются тремя разными рендерерами — на экране, в векторе и в картинке они совпадают.

Почему это не отдельная система

• Калькулятор — «шаг 0» того же проекта: он синтезирует модель по нормативам и передаёт её в общий расчётный движок. Иначе появились бы второй прайсинг, вторая база заявок и вторая смета, которые разъедутся.
• Двойного учёта «электрика + умный дом» нет по построению: умная точка заменяет тип точки, а не добавляет вторую линию.

Две неочевидные детали расчёта

• Кабель считается нормативом «метров на точку», а не по геометрии: у калькулятора нет плана, а схематичная раскладка давала три километра кабеля и больше половины стоимости проекта.
• Неопределённости складываются в квадратуре, а не перемножением: перемножение считало один риск дважды и раздувало вилку почти вдвое.

Полевые реалии

• Связь на объекте пропадает, поэтому правки складываются в очередь на устройстве и уходят, когда сеть вернётся. Обрыв связи не роняет работу.
• Быстрый ввод и размещённые на плане точки не складываются: в расчёт идёт максимум, а разница показана как «осталось разместить» — иначе замер удваивал бы объём.
• Завершение замера делает снимок цен; пересчёт по новому прайсу — только через предпросмотр и подтверждение.

Без дублей

• Подробный режим использует тот же конструктор плана — второго редактора геометрии в системе нет.
• Цены берутся из общей с конструктором таблицы привязок: прайс один на всю платформу.

Принципы

• Юридический текст живёт только в шаблонах и не переписывается моделью — требование владельца, и оно правильное: договор не место для творчества.
• Предпросмотр, печать и файл рендерятся из одного источника — «на экране одно, в файле другое» невозможно.
• Подписанное хранится снимком вместе с готовым файлом: через год видно ровно то, что подписывали.
• Суммы считает расчётный слой сметы с каскадом скидок — строки не суммируются в обход.

Разделение прав

• Рабочее место читает облако только на чтение и через фасад — прямого доступа к боевым базам у него нет. Компрометация рабочего места не даёт админку облака, а падение облака не ломает работу: остаются кэш и честный баннер.

Документация как часть работы

• Источник истины — файлы документации, база данных только производная и её можно удалить без потерь.
• Статья помнит отпечаток кода на момент последней проверки: разошлось — статья помечается как требующая проверки. Документация не может тихо устареть.
• Списки маршрутов и таблиц собираются из реального кода, а не поддерживаются руками.