mirror of https://github.com/NickoScope/nickol-knx-mcp.git synced 2026-09-30 03:41:58 +02:00

Files

T

Nikolay MiroshnichenkoandClaude Opus 4.8 2d0a63c548 docs: add spec-PDF→KNX case study (EN+RU, anonymised)

A 96% structural match of an auto-designed GA structure vs a professional
reference, from a 42-page spec alone — 662 GA, 0 validation errors, HA package.
No client data/files; reference used only as an anonymous benchmark.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

2026-06-30 23:27:32 +02:00

4.5 KiB

Raw Blame History

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

🌍 English version: 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 ошибок).

4.5 KiB Raw Blame History