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

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