79 lines
3.8 KiB
Markdown
79 lines
3.8 KiB
Markdown
# Архитектура комбайна: сервисы
|
|
|
|
Дата: 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 отдельной вкладкой
|