# Кейс — из PDF-ТЗ в выверенную KNX-структуру на 662 GA, за минуты

> 🌍 **English version:** [case-study.md](case-study.md)

## Вопрос
Насколько далеко можно **из одного ТЗ** получить готовую, корректную по стандарту KNX-структуру
групповых адресов — и насколько близко к работе профессионала?

## Вход
Реальный жилой проект — **14 помещений (~155 м²)**, на оборудовании Zennio: коммутируемый и
диммируемый свет, электрический тёплый пол, вентиляция с рекуперацией, моторизованные шторы,
учёт воды / электро / тепла, протечки и пожарная безопасность — описан **только в 42-страничном
ТЗ (PDF)**. Ни группадресов, ни DPT, ни нейминга в ТЗ нет: там оборудование и функции, не KNX-структура.

## Конвейер
```
PDF-ТЗ
   │  AI-ассистент, опираясь на стандарт KNX Association + мировую практику,
   ▼  ПРОЕКТИРУЕТ полную структуру групповых адресов
GA-структура (таксономия · нейминг · DPT · пары команда/статус · сцены · резервы)
   │  nickol-knx-mcp ВАЛИДИРУЕТ её и ГЕНЕРИРУЕТ выходные файлы
   ▼
пакет Home Assistant  +  ETS-импортируемый XML групповых адресов
```

## Выход
- **662 групповых адреса** в **10 функциональных доменах**, как `ga-export/01` XML, готовый для ETS
  *Import Group Addresses* → размещение устройств → экспорт `.knxproj`.
- Получено за **минуты**.

## Сверка — с профессиональной эталонной реализацией того же объекта
| Метрика | Результат |
|---|---|
| Структурное совпадение | **96 %** (662 против 687 GA) |
| Таксономия доменов | **10 из 10 совпали** |
| Имена адресов | **118 дословных**, 68 % с близким аналогом |
| DPT-дисциплина | точные под-типы у всех; DPT 5.001 ≈ 1 : 1 |
| Валидация (nickol-knx-mcp) | **0 ошибок**; шум (резервы/логика) распознан автоматически |
| Home Assistant | **9 климат-зон · 11 штор · 12 диммеров** + датчики, собраны сразу |

## Что это показывает
Стандартизованный и трудоёмкий **«скелет»** KNX-проекта — то, что определяется стандартом и
оборудованием — проектируется автоматически до **почти профессионального уровня за минуты против
дней** ручной работы с группадресами. Это освобождает время инженера для по-настоящему творческой
части — проектной логики, которая остаётся его ремеслом (оставшиеся проценты — ровно эти одноразовые
логические функции).

## Честные оговорки
- **Никакие клиентские данные и файлы проектов не публикуются.** Эталонная реализация используется
  только как анонимный ориентир; в кейсе — параметры и проценты совпадения, ничего идентифицирующего.
- **Проектирование** выполняет AI-ассистент, заземлённый на знания KNX (стандарт KNX Association +
  мировая практика). **Роль nickol-knx-mcp** — валидация только на чтение и экспорт в Home Assistant /
  ETS; к живой шине он не подключается.
- Цифры — со структуры, которая реально прошла проверки инструмента (0 ошибок).