# Архитектура комбайна: сервисы Дата: 06.11.2026. Переход от одного файла к сервисам. ## Сервисы (все запущены, systemd) | Сервис | Порт | За что отвечает | |---|---|---| | **combine-catalog** | 8101 | устройства, порты, комплектация, функции, матрица, полнота данных | | **combine-engine** | 8102 | совместимость, группы, ёмкость VCH/PoE, **подсчёт портов**, **кабельный журнал**, BOM | | **combine-project** | 8103 | сохранение, список, **версии** (история до 10), удаление | | **combine-draw** | 8104 | **SVG-схема соединений**, кабельный журнал | | **combine-docs** | 8105 | документы по устройству (даташиты из зеркала Nextcloud) | Общий код: `combine_core.py` — доменная логика (совместимость, порты, ёмкость, кабели). База: `svc_base.py` — HTTP + JSON + CORS + роутинг. ## Ключевые новые возможности ### 1. Подсчёт портов (`/ports`) Возвращает: какие порты хоста заняты, какие свободны, что не удалось подключить. ``` /ports?host=meetingbara50&item=UVC86&item=CTP25 → free_in: [VCH, USB-C, LAN], free_out: [HDMI, USB, 3.5mm] ``` ### 2. Кабельный журнал (`/cables`) Что с чем соединяется и каким разъёмом, с пометкой «в комплекте». ``` USB → UVC86 USB в комплекте USB → CTP25 USB USB → WPP30 USB-C в комплекте ``` ### 3. Схема соединений (`/diagram`) SVG с портами хоста слева/справа, устройствами и связями по типу разъёма. ### 4. Версии проектов (`/save`) При каждом сохранении — запись в историю (последние 10 версий). ### 5. Документы (`/docs?device=UVC86`) Индекс PDF из зеркала Nextcloud, поиск по модели, тип документа. ## Приоритет портов Порты подбираются по роли устройства: | Роль | Приоритет | |---|---| | дисплей | HDMI → DP → USB-C | | камера | USB → USB-C → LAN → HDMI | | аудио | VCH → USB → USB-C | | панель | USB → LAN | ## Проверено фактами ``` combine-catalog active /hosts 200 · /matrix 200 combine-engine active /cables 4 кабеля, 0 нерешённых combine-draw active /diagram SVG 2.9 КБ combine-project active /list 200 combine-docs active /docs 200 ``` ## Известные дефекты 1. **MeetingDisplay получает USB вместо HDMI** — у устройства есть извлечённые порты, которые перекрывают правило роли. Требует выверки портов. 2. UI пока работает на старом `app.py` (порт 8095). Перенос на сервисы — следующий шаг. 3. Ёмкость цепочек VCH не считается по-настоящему: нужны порты in/out у аксессуаров и ёмкость цепи (данные добываются LLM). ## Что дальше 1. Перевести интерфейс на сервисы (сейчас дублирование логики) 2. Экспорт: BOM в XLSX, схема в PNG/SVG 3. Чек-лист полноты проекта 4. Автозаполнение состава 5. Кабельный журнал — в UI отдельной вкладкой