Установка и настройка¶
Это руководство описывает установку Turbo EA с помощью Docker, настройку окружения, загрузку демонстрационных данных и запуск дополнительных сервисов, таких как ИИ и сервер MCP.
Предварительные требования¶
- Docker (v20.10+)
- Docker Compose (v2.0+)
Шаг 1: Клонирование и настройка¶
git clone https://github.com/vincentmakes/turbo-ea.git
cd turbo-ea
cp .env.example .env
Откройте .env в текстовом редакторе и установите необходимые значения:
# Учётные данные PostgreSQL (используются встроенным контейнером базы данных)
POSTGRES_PASSWORD=выберите-надёжный-пароль
# Ключ подписи JWT — сгенерируйте с помощью:
# python3 -c "import secrets; print(secrets.token_urlsafe(64))"
SECRET_KEY=ваш-сгенерированный-ключ
# Порт, на котором будет доступно приложение
HOST_PORT=8920
Шаг 2: Выбор варианта базы данных¶
Вариант А: Встроенная база данных (рекомендуется для начала)¶
Файл docker-compose.db.yml запускает контейнер PostgreSQL вместе с бэкендом и фронтендом. Внешняя база данных не нужна — данные сохраняются в томе Docker.
docker compose -f docker-compose.db.yml up --build -d
Вариант Б: Внешний PostgreSQL¶
Если у вас уже есть сервер PostgreSQL (управляемая база данных, отдельный контейнер или локальная установка), используйте базовый файл docker-compose.yml, который запускает только бэкенд и фронтенд.
Сначала создайте базу данных и пользователя:
CREATE USER turboea WITH PASSWORD 'ваш-пароль';
CREATE DATABASE turboea OWNER turboea;
Затем настройте .env:
POSTGRES_HOST=ваш-хост-postgresql
POSTGRES_PORT=5432
POSTGRES_DB=turboea
POSTGRES_USER=turboea
POSTGRES_PASSWORD=ваш-пароль
Запустите приложение:
docker compose up --build -d
Note
Базовый файл docker-compose.yml ожидает сеть Docker с именем guac-net. Создайте её командой docker network create guac-net, если она не существует.
Шаг 3: Загрузка демонстрационных данных (необязательно)¶
Turbo EA может запускаться с пустой метамоделью (только 14 встроенных типов карточек и типов связей) или с полным набором демонстрационных данных. Демонстрационные данные идеально подходят для оценки платформы, проведения обучения или изучения функциональности.
Параметры загрузки¶
Добавьте эти переменные в .env перед первым запуском:
| Переменная | По умолчанию | Описание |
|---|---|---|
SEED_DEMO |
false |
Загружает полный набор данных NexaTech Industries, включая BPM и PPM |
SEED_BPM |
false |
Загружает только демонстрационные процессы BPM (требует наличия базовых данных) |
SEED_PPM |
false |
Загружает только данные проектов PPM (требует наличия базовых данных) |
RESET_DB |
false |
Удаляет все таблицы и пересоздаёт их при запуске |
Полная демонстрация (рекомендуется для оценки)¶
SEED_DEMO=true
Это загружает весь набор данных NexaTech Industries одной настройкой. Вам не нужно устанавливать SEED_BPM или SEED_PPM отдельно — они включены автоматически.
Демонстрационная учётная запись администратора¶
При загрузке демонстрационных данных автоматически создаётся учётная запись администратора:
| Поле | Значение |
|---|---|
admin@turboea.demo |
|
| Пароль | TurboEA!2025 |
| Роль | Администратор |
Warning
Демонстрационная учётная запись администратора использует известные учётные данные. Измените пароль или создайте собственную учётную запись администратора для любой среды за пределами локальной оценки.
Что включают демонстрационные данные¶
Набор данных NexaTech Industries содержит около 150 карточек на всех уровнях архитектуры:
Основные данные EA (всегда включены при SEED_DEMO=true):
- Организации — Корпоративная иерархия: NexaTech Industries с бизнес-подразделениями (Инженерия, Производство, Продажи и Маркетинг), регионами, командами и клиентами
- Бизнес-возможности — Более 20 возможностей в многоуровневой иерархии
- Бизнес-контексты — Процессы, потоки создания ценности, клиентские пути, бизнес-продукты
- Приложения — Более 15 приложений (NexaCore ERP, IoT-платформа, Salesforce CRM и др.) с полными данными о жизненном цикле и затратах
- ИТ-компоненты — Более 20 элементов инфраструктуры (базы данных, серверы, промежуточное ПО, SaaS, модели ИИ)
- Интерфейсы и объекты данных — Определения API и потоки данных между системами
- Платформы — Облачные и IoT-платформы с подтипами
- Цели и инициативы — 6 стратегических инициатив с различными статусами согласования
- Теги — 5 групп: Бизнес-ценность, Технологический стек, Статус жизненного цикла, Уровень риска, Регуляторная область
- Связи — Более 60 связей, объединяющих карточки на всех уровнях
- Поставка EA — Записи архитектурных решений и документы архитектурных работ
Данные BPM (включены при SEED_DEMO=true или SEED_BPM=true):
- ~30 бизнес-процессов в 4-уровневой иерархии (категории, группы, процессы, варианты)
- Диаграммы BPMN 2.0 с извлечёнными элементами процесса (задачи, события, шлюзы, дорожки)
- Связи элементов с карточками, соединяющие задачи BPMN с приложениями, ИТ-компонентами и объектами данных
- Оценки процессов с показателями зрелости, эффективности и соответствия
Данные PPM (включены при SEED_DEMO=true или SEED_PPM=true):
- Отчёты о статусе для 6 инициатив, отображающие состояние проекта во времени
- Иерархические структуры разбиения работ (WBS) с декомпозицией и вехами
- ~60 задач между инициативами со статусами, приоритетами, исполнителями и тегами
- Бюджетные строки (капитальные/операционные расходы по финансовым годам) и строки затрат (фактические расходы)
- Реестр рисков с оценками вероятности/воздействия и планами смягчения
Сброс базы данных¶
Чтобы удалить всё и начать заново:
RESET_DB=true
SEED_DEMO=true
Перезапустите контейнеры, затем удалите RESET_DB из .env, чтобы избежать сброса при каждом перезапуске:
docker compose -f docker-compose.db.yml up --build -d
# После подтверждения работоспособности удалите RESET_DB=true из .env
Шаг 4: Дополнительные сервисы¶
Предложения описаний с помощью ИИ¶
Turbo EA может генерировать описания карточек с помощью локальной LLM (Ollama) или коммерческих провайдеров. Встроенный контейнер Ollama — самый простой способ начать.
Добавьте в .env:
AI_PROVIDER_URL=http://ollama:11434
AI_MODEL=gemma3:4b
AI_AUTO_CONFIGURE=true
Запустите с профилем ai:
docker compose -f docker-compose.db.yml --profile ai up --build -d
Модель автоматически загружается при первом запуске (это может занять несколько минут в зависимости от соединения). Подробности настройки см. в разделе Возможности ИИ.
Сервер MCP (интеграция инструментов ИИ)¶
Сервер MCP позволяет инструментам ИИ, таким как Claude Desktop, Cursor и GitHub Copilot, запрашивать ваши данные EA.
docker compose -f docker-compose.db.yml --profile mcp up --build -d
Подробности настройки и аутентификации см. в разделе Интеграция MCP.
Комбинирование профилей¶
Вы можете включить несколько профилей одновременно:
docker compose -f docker-compose.db.yml --profile ai --profile mcp up --build -d
Краткая справка: Частые команды запуска¶
| Сценарий | Команда |
|---|---|
| Минимальный запуск (встроенная БД, пустая) | docker compose -f docker-compose.db.yml up --build -d |
| Полная демо (встроенная БД, все данные) | Установите SEED_DEMO=true в .env, затем docker compose -f docker-compose.db.yml up --build -d |
| Полная демо + ИИ | Установите SEED_DEMO=true + переменные ИИ в .env, затем docker compose -f docker-compose.db.yml --profile ai up --build -d |
| Внешняя БД | Настройте переменные БД в .env, затем docker compose up --build -d |
| Сброс и повторная загрузка | Установите RESET_DB=true + SEED_DEMO=true в .env, перезапустите, затем удалите RESET_DB |
Следующие шаги¶
- Откройте http://localhost:8920 (или ваш настроенный
HOST_PORT) в браузере - Если загрузили демонстрационные данные, войдите с
admin@turboea.demo/TurboEA!2025 - В противном случае зарегистрируйте новую учётную запись — первый пользователь автоматически получает роль Администратора
- Изучите Панель управления для обзора вашего ландшафта EA
- Настройте Метамодель для адаптации типов карточек и полей