Ignis App

Мобильное приложение для управления умными лампами WiZ через self-hosted сервер Ignis Core.

Возможности

• Мульти-дом -- поддержка нескольких серверов Ignis (квартира, дача, друзья). Каждый дом -- отдельный сервер со своим URL и API-ключом.
• Группы ламп -- создание, удаление, управление. При создании группы можно выбрать нужные лампы из списка обнаруженных устройств, пересканировать сеть.
• Управление освещением:
  • Включение/выключение
  • Яркость 10--100% с шагом 10%
  • Цветовая температура 2700--6500K с шагом 100K
  • RGB-цвет через HSV-пикер
  • Сцены (загружаются с сервера)
  • Таймер "включить на 4 часа"
• Расписания -- одноразовые таймеры и cron-задачи с выбором дней недели. Просмотр и отмена активных задач.
• API-ключи -- просмотр, создание, отзыв и повторная активация гостевых ключей для администраторов.
• Статистика и лог событий -- просмотр сводки по группам и последних событий сервера.
• Геофенс -- опциональное автовыключение света при уходе от дома.

Стек

• Flutter 3.x / Dart
• Riverpod -- управление состоянием
• Dio -- HTTP-клиент
• SharedPreferences -- локальное хранение несекретных настроек
• Flutter Secure Storage -- безопасное хранение API-ключей
• Geolocator -- геолокация
• Workmanager -- периодические фоновые задачи
• Flutter Local Notifications -- локальные уведомления

Структура проекта

lib/
├── app/
│   └── app_bootstrap.dart       -- bootstrap приложения и стартовые состояния
├── main.dart                    -- точка входа, тема, роутер
├── models/
│   └── home_config.dart         -- несекретная модель "дома" (сервер)
├── services/
│   ├── api_client.dart          -- обёртка Dio для Ignis API
│   ├── credentials_storage.dart -- безопасное хранение API-ключей
│   ├── geofence_worker.dart     -- фоновая проверка геофенса
│   └── settings_service.dart    -- хранение домов и миграция ключей
├── providers/
│   └── providers.dart           -- Riverpod-провайдеры
├── screens/
│   ├── api_keys_screen.dart     -- управление API-ключами
│   ├── event_log_screen.dart    -- лог событий
│   ├── homes_screen.dart        -- список домов
│   ├── home_edit_screen.dart    -- добавление/редактирование дома
│   ├── remote_screen.dart       -- пульт управления группами
│   ├── group_edit_screen.dart   -- создание группы
│   ├── schedules_screen.dart    -- расписания
│   └── stats_screen.dart        -- статистика
└── widgets/
    ├── group_card.dart          -- карточка группы с управлением
    └── color_picker.dart        -- HSV-пикер цвета

Сборка

# Зависимости
flutter pub get

# Debug-запуск
flutter run

# Release APK
flutter build apk --release

APK: build/app/outputs/flutter-apk/app-release.apk

Сейчас release APK подписывается debug-ключом из Flutter-шаблона. Для личной установки на телефон этого достаточно, для настоящего релиза подпись нужно заменить.

Проверки

flutter analyze
flutter test

Текущий baseline зелёный: анализатор без issues, тесты проходят. Перед установкой на телефон дополнительно проверялась сборка:

flutter build apk --debug
flutter build apk --release

Настройка

При первом запуске приложение попросит добавить "дом" -- указать адрес сервера Ignis и API-ключ. После этого откроется пульт управления группами.

Для добавления второго дома: кнопка "домик" в левом верхнем углу пульта -> экран домов -> кнопка "+".

API-ключи хранятся отдельно от конфигурации домов в flutter_secure_storage. Старые ключи, сохранённые прежними версиями приложения в SharedPreferences, автоматически мигрируются при запуске.

API

Приложение работает с Ignis Core API -- self-hosted бэкенд на FastAPI для управления лампами WiZ по локальной сети. Используемые эндпоинты:

Метод	Путь	Назначение
GET	/devices	Список ламп
GET	/devices/groups	Список групп
GET	/devices/scenes	Доступные сцены
POST	/devices/groups	Создать группу
DELETE	/devices/groups/{id}	Удалить группу
POST	/devices/rescan	Пересканировать сеть
POST	/control/group/{id}	Управление группой
GET	/control/group/{id}/status	Статус группы
POST	/schedules/once	Одноразовый таймер
POST	/schedules/cron	Cron-расписание
GET	/schedules/tasks	Список задач
DELETE	/schedules/{job_id}	Отменить задачу
GET	/auth/me	Информация о текущем ключе
GET	/api-keys	Список гостевых ключей
POST	/api-keys	Создать гостевой ключ
POST	/api-keys/revoke	Отозвать ключ
POST	/api-keys/activate	Активировать ключ
GET	/stats/summary	Сводная статистика
GET	/stats/log	Лог событий

Авторизация: заголовок X-API-Key.

Текущие ограничения

• Целевая платформа сейчас Android.
• Release APK пока подписывается debug-ключом из Flutter-шаблона.
• Архитектура всё ещё содержит крупный providers.dart и много сырых Map<String, dynamic>.
• Обработка ошибок стала лучше на bootstrap/polling, но ещё не унифицирована по всем экранам.

Лицензия

Частный проект.