Системные требования и программный стек «Rowux»
Документ описывает требования к среде функционирования, программный стек и состав сервисов ПО «Rowux».
#1. Требования к среде функционирования
#1.1. Общесистемное программное обеспечение
- Операционная система семейства Linux (промышленная эксплуатация); для целей разработки поддерживается также macOS.
- Docker Engine и Docker Compose версии 2 — среда контейнеризации и оркестрации, обязательное требование.
#1.2. Аппаратные ресурсы
ПО представляет собой многосервисный комплекс. Рекомендуемая минимальная конфигурация сервера для промышленной эксплуатации:
| Ресурс | Рекомендуемый минимум |
|---|---|
| Процессор | 8 логических ядер |
| Оперативная память | 16 ГБ (32 ГБ при активной аналитике/индексации) |
| Дисковое пространство | 50 ГБ и более (зависит от объёма баз знаний и артефактов) |
| Сеть | доступ к поставщикам языковых моделей (при использовании внешних) |
Изолированное исполнение кода аналитического агента может выноситься на отдельную виртуальную машину с усиленной изоляцией среды исполнения — в этом случае требуется дополнительный вычислительный узел.
Языковые модели по умолчанию используются через внешний шлюз (в том числе российские поставщики); при размещении моделей локально требования к ресурсам (в первую очередь к видеопамяти) определяются выбранной моделью.
#2. Программный стек
#2.1. Языки и технологии собственных компонентов
- Python (FastAPI) — серверные сервисы: сервер-обвязка, сервис потоковой доставки, аналитический агент, сервис защиты данных.
- JavaScript / TypeScript (React, Vite) — портал и веб-интерфейсы.
- Docker / Docker Compose — контейнеризация и оркестрация.
#2.2. Хранение данных
- Реляционная СУБД PostgreSQL — данные подсистем (отдельные экземпляры для разных подсистем).
- Объектное S3-совместимое хранилище (SeaweedFS) — файлы, артефакты, базы знаний.
- Векторное хранилище (Qdrant) — индексы для поиска по знаниям (RAG).
#2.3. Платформенные и инфраструктурные компоненты
| Подсистема | Компонент | Версия |
|---|---|---|
| Чат-интерфейс и работа со знаниями | Open WebUI (доработан) | 0.5.4 |
| Конструктор сценариев и агентов | Langflow (доработан) | 1.8.0 |
| Единый вход (SSO) | Keycloak | 26.0.0 |
| Реляционная СУБД | PostgreSQL | 15 |
| Объектное хранилище | SeaweedFS | — |
| Векторное хранилище | Qdrant | 1.17 |
| Шлюз доступа к языковым моделям | Bifrost | — |
| Сбор метрик | Prometheus | 3.10.0 |
| Информационные панели мониторинга | Perses | 0.53.1 |
| Пограничный маршрутизатор трафика | Traefik | 3.6.2 |
Версии приведены по состоянию на дату подготовки документа; актуальные значения фиксируются в
docker-compose.yml. Все перечисленные компоненты распространяются на условиях разрешительных (permissive) лицензий, допускающих модификацию и коммерческое использование; копилефт-лицензии (GPL/LGPL/AGPL) в составе продукта отсутствуют.
#3. Состав сервисов и сетевые порты
Комплекс включает следующие сервисы (порты приведены для конфигурации локального запуска; в промышленной среде доступ публикуется через пограничный маршрутизатор с TLS):
| Сервис | Роль | Порт (локально) |
|---|---|---|
| landing | Публичная информационная страница | через маршрутизатор |
| ui | Портал платформы | 3000 |
| backend | Сервер-обвязка (аутентификация, синхронизация сессий) | 8092 |
| ghost-writer-ui | Интерфейс потоковой доставки | 8011 |
| ghost-writer-backend | Сервис потоковой доставки | 8012 |
| open-webui | Чат-интерфейс и работа со знаниями | 8091 |
| langflow | Конструктор сценариев и агентов | 7860 |
| analytics-agent | Аналитический агент | 9097 (proxy) |
| pii-guard | Сервис защиты данных | 9097 |
| bifrost | Шлюз доступа к языковым моделям | 8023 |
| keycloak | Единый вход (SSO) | 8484 |
| postgres / postgres-owui / postgres-lf | Реляционные СУБД подсистем | внутренние |
| seaweedfs | Объектное хранилище | внутренний |
| docstorage (Qdrant) | Векторное хранилище | внутренний |
| prometheus | Сбор метрик | 9090 |
| perses | Информационные панели мониторинга | 3001 |
| pushgateway / open-webui-exporter | Экспорт метрик | 9091 / 8093 |
| traefik | Пограничный маршрутизатор трафика | 80 / 443 |
Дополнительно при первом запуске отрабатывают сервисы инициализации (создание учётных записей хранилища, загрузка стартовых сценариев и моделей, инициализация подсистемы мониторинга).
#4. Внешние интеграции (опционально)
- Поставщики языковых моделей — через шлюз доступа к моделям (в том числе российские: aitunnel.ru, routerai.ru, а также OpenAI-совместимые провайдеры).
- Корпоративные хранилища данных — подключение к базам данных заказчика ролью только на чтение (для аналитического агента).
- BI-системы заказчика (Apache Superset / Metabase) — для публикации дашбордов.
- Мессенджеры — публикация сценариев в виде чат-ботов.
Все внешние интеграции опциональны; ядро платформы работоспособно в полностью закрытом контуре.