ha-warm-family-panel/README.md

# 🏡 Тёплый дом — панель Home Assistant для большой семьи

Готовый набор для Home Assistant, который превращает умный дом в **тёплое,
спокойное и понятное всем место**: маме, папе и детям. Кремовые тона, дерево и
терракота, крупные кнопки, мягкий вечерний свет и сценарии, которые сами
заботятся о доме — утром будят по-доброму, вечером греют, ночью тихо
подсвечивают дорожку ребёнку до туалета.

Всё на **стандартном Home Assistant** — без HACS и сторонних модулей. Ставится
за вечер, дальше только подставляете свои устройства.

---

## Что внутри

- 🎨 **Тёплая тема** `warm_home` — кремовый фон, тёплое дерево/терракота, мягкий
  янтарь для «включено», приглушённый зелёный для «эко». Крупные скруглённые
  карточки, мягкие тени, читаемый шрифт. Есть светлый (день) и уютный тёмный
  (вечер) режимы — переключаются сами.
- 📊 **Дашборд «Тёплый дом»** — вкладки:
  - **Дом** — крупные кнопки-сцены, погода, «кто дома», режимы;
  - **Комнаты** — гостиная, кухня, детские, спальня, ванная (тёплый пол),
    прихожая: свет, климат, шторы;
  - **Дети** — ночники, «тихий час», «спать», климат детских;
  - **Безопасность** — охрана, двери/окна, дым/CO/протечка, камеры;
  - **Энергия** — потребление, эко-режим, ночной тариф.
- 🤖 **Сценарии** (scripts + automations) для семейного дома — по времени суток и
  по ситуациям (список ниже).
- 🎚️ **Помощники-режимы** — флажки `family_mode`, `guests`, `movie`, `night`,
  `eco`, `quiet_hours` и расписание подъёма/отбоя.

---

## Как выглядит

> Тёплая палитра «домашнего очага»:

| Роль | Цвет |
|---|---|
| Фон (кремовый) | `#f6efe6` |
| Карточки (тёплый белый) | `#fffaf3` |
| Главный акцент (дерево/терракота) | `#c9743a` |
| Второй акцент (мягкий янтарь, «включено») | `#e0a458` |
| «Эко» (приглушённый зелёный) | `#7d9464` |
| Текст (тёплый тёмно-коричневый) | `#3a332c` |

Карточки скруглены (радиус 18px), тени мягкие и тёплые, кнопки-сцены — крупные,
чтобы попадал и ребёнок, и бабушка. Вечером тема сама уходит в тёплый тёмный
режим, чтобы не бить по глазам.

---

## Сценарии

**По времени суток:**

- ☀️ **Утро · будни** — плавный подъём: детские мягко разгораются по расписанию
  школы, приоткрываются шторы, греется тёплый пол в ванной, приходит погода на
  сегодня, включается кофе.
- 🌤️ **Утро · выходные** — позже и тише, без будильников, детей не трогаем.
- 🏃 **День · никого нет** — эко-режим: климат в экономию, свет гаснет,
  напоминание проветрить.
- 🌆 **Вечер** — тёплый свет 2700K, сцена ужина на кухне, подсветка за ТВ.
- 🌙 **Ночь · отбой** — всё приглушаем, детские ночники, охрана периметра,
  мягкая проверка «всё выключено?».

**Ситуации:**

- 🚪 **Уход из дома** (все ушли, по presence) — свет off, климат эко, охрана,
  проверка открытых окон/дверей, запуск роботов-пылесосов.
- 🏡 **Возвращение домой** — свет по времени суток, климат в комфорт, тёплое
  приветствие.
- 👋 **Гости** — приветливый ровный свет, музыка, комфортный климат.
- 🎬 **Кино** — затемнить гостиную, подсветка ТВ, «не беспокоить».
- 😴 **Укладывание детей** — ночники warm dim, колыбельная/белый шум, дом
  притихает, тихий режим уведомлений.
- 🌛 **Ребёнок проснулся ночью** — по движению в детской/коридоре мягкая
  подсветка пути в туалет на 10–15%, без яркого света, и сама гаснет.
- 🚨 **Тревога** (дым/протечка/CO/взлом) — свет ярко везде, голосовое оповещение,
  уведомление всем взрослым, перекрытие воды при протечке.
- 💡 **Экономия · ночной тариф** — тяжёлые нагрузки (бойлер, стиралка,
  посудомойка) на дешёвое время, климат-эко ночью.
- 🤒 **Болеет ребёнок** — климат и увлажнитель в его комнате, мягкий свет, тихий
  режим уведомлений.
- 🎉 **Праздник · День рождения** — праздничная цветная сцена и музыка.

Каждый сценарий обильно прокомментирован и **не привязан к реальным
устройствам** — везде понятные плейсхолдеры (`light.gostinaya`,
`climate.detskaya_1`, `binary_sensor.protechka_vannaya` …), которые вы меняете на
свои.

---

## Установка (коротко)

1. Скопировать `themes/`, `packages/`, `lovelace/` в папку конфигурации HA.
2. Включить тему, пакеты и дашборд в `configuration.yaml`:
   ```yaml
   frontend:
     themes: !include_dir_merge_named themes
   homeassistant:
     packages: !include_dir_named packages
   lovelace:
     dashboards:
       warm-home:
         mode: yaml
         title: Тёплый дом
         icon: mdi:home-heart
         show_in_sidebar: true
         filename: lovelace/dashboard.yaml
   ```
3. Перезапустить HA, выбрать тему **warm_home** в профиле.
4. Заменить entity_id-плейсхолдеры на свои (Инструменты разработчика → Состояния).
5. Настроить группу уведомлений `notify.family_adults`, TTS и код охраны.

Подробно, по шагам и со скриншотами настроек — **[docs/SETUP.md](docs/SETUP.md)**.

---

## Структура репозитория

```
ha-warm-family-panel/
├── README.md                       # этот файл
├── helpers.yaml                    # флажки-режимы, расписание, температуры
├── themes/
│   └── warm_home.yaml              # тёплая тема Lovelace
├── lovelace/
│   └── dashboard.yaml              # дашборд «Тёплый дом» (5 вкладок)
├── packages/
│   └── family_scenarios.yaml       # сценарии: scripts + automations
└── docs/
    └── SETUP.md                    # пошаговая установка
```

---

## Заметки

- Ничего никуда не деплоится и не трогает реальные дома — это чистый шаблон.
  Всё живёт только в вашем Home Assistant, когда вы сами его туда положите.
- Конфиги — валидный YAML под структуру Home Assistant (packages / themes /
  lovelace YAML-режим).
- Плейсхолдер-сущности безопасны: несуществующие показываются как «недоступно» и
  не ломают панель. Заменяйте постепенно.

Пусть дом будет тёплым 🤍