Files
buryan-infra/ops/work/ARCHITECTURE.md

3.8 KiB

Архитектура комбайна: сервисы

Дата: 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 отдельной вкладкой