AIDrom

Платформа для тестирования и интеграции AI моделей через единый интерфейс LLM провайдеров

Frontend performance

Описание проекта

AIDrom — система для работы с AI моделями, обеспечивающая единый интерфейс для различных LLM провайдеров. Функционал системы: создание AI агентов, ведение чатов и мониторинг запросов.

Основные возможности

• Мультипровайдерность: Поддержка Gigachat, DeepSeek и других AI провайдеров
• Управление агентами: Создание и настройка AI агентов с индивидуальными параметрами
• Чат-интерфейс: Веб-интерфейс для общения с агентами в реальном времени
• Мониторинг: Журналирование и анализ запросов к AI сервисам

Документация

• Архитектура системы - Описание архитектуры, компонентов и их взаимодействия
• Бизнес-процессы - Описание бизнес-процессов системы
• API Документация - Полное описание REST API эндпоинтов
• Frontend - Архитектура фронтенда, FSD структура, компоненты
• Развертывание - Инструкции по установке, настройке и развертыванию
• Производительность - Метрики производительности и анализ скорости загрузки

Установка

(DISCLAIMER: иногда не все так просто, как всегда 😅😇)

⚠️ Для подробностей всех этапов установки, обратитесь к "великой книге перемен 易經" (которая, кстати, и не всегда в актуальном состоянии 🙃, но если что, есть морально-техническая поддержка)

# Клонирование репозитория
git clone https://github.com/scott-walker/aidrom.git
cd aidrom

# Генерация SSL сертификатов
sudo apt install libnss3-tools mkcert
mkcert -install
mkcert aidrom.lc api.aidrom.lc
mkdir -p gateway/ssl
mv aidrom.lc+1.pem gateway/ssl/front.cert
mv aidrom.lc+1-key.pem gateway/ssl/front.key

# Настройка DNS
echo "127.0.0.1 aidrom.lc api.aidrom.lc" | sudo tee -a /etc/hosts

# Создание .env файла
cp .env.example .env
# Отредактировать .env под ваши нужды

# Запуск системы
make up

🌐 Доступ к системе

• Frontend: https://aidrom.lc
• API: https://api.aidrom.lc
• Документация API: https://api.aidrom.lc/docs

Архитектура

🌐 Gateway    ⚛️ Frontend    ⚙️ API        🗄️ Database
   (Nginx)  ────  (React)  ──── (Node.js) ──── (PostgreSQL)

Stack

Backend	Frontend	Infrastructure
Node.js 24 (TypeScript) Express.js Drizzle ORM PostgreSQL Winston	React 19 (TypeScript) Vite React Router 7 React Hook Form TanStack Query Zustand	Docker & Docker Compose Nginx как reverse proxy SSL/TLS с mkcert

Управление

Команды Make

make up      # Запуск всех сервисов
make down    # Остановка всех сервисов  
make restart # Перезапуск системы
make log     # Просмотр логов
make build   # Сборка всех образов

Управление базой данных

make db-migrate  # Применение миграций
make db-dump     # Создание резервной копии
make db-reset    # Сброс базы данных

📁 Структура проекта

├── api/          # Backend API сервер
├── front/        # Frontend приложение
├── gateway/      # Nginx reverse proxy
├── db/           # PostgreSQL конфигурация
├── docs/         # Документация
└── docker-compose.yaml

🧑‍🔧 Поддержка

Документация (/docs)

• Архитектура системы - Описание архитектуры, компонентов и их взаимодействия
• Бизнес-процессы - Описание бизнес-процессов системы
• API Документация - Полное описание REST API эндпоинтов
• Frontend - Архитектура фронтенда, FSD структура, компоненты
• Развертывание - Инструкции по установке, настройке и развертыванию
• Производительность - Метрики производительности и анализ скорости загрузки

Лицензия

Проект распространяется под лицензией MIT.