Установка КАСКАД 360

1. Системные требования

Минимальные требования

Компонент	Требование
ОС	Linux x86_64 (Ubuntu 20.04+, CentOS 8+, и др.), Windows 10+, macOS 12+
ОЗУ	от 512 МБ (рекомендуется 2 ГБ)
Диск	от 500 МБ свободного места
СУБД	MySQL 8.0+ или PostgreSQL 14+

2. Установка из архива (Linux x86_64)

Рекомендуемый способ для Linux — скачать готовый дистрибутив и распаковать его на сервере.

2.1. Скачивание архива

# Скачать архив (wget)
wget https://cascad360.ru/downloads/cascad360-1.0.0-linux-x86_64.tar.gz

# или через curl
curl -LO https://cascad360.ru/downloads/cascad360-1.0.0-linux-x86_64.tar.gz

2.2. Распаковка и установка

# Распаковать архив
tar -xzf cascad360-1.0.0-linux-x86_64.tar.gz

# Перейти в каталог
cd cascad360-1.0.0-linux-x86_64

# (Опционально) Установить в /opt для всех пользователей
# sudo mv cascad360-1.0.0-linux-x86_64 /opt/cascad360
# cd /opt/cascad360

2.3. Запуск

# Запуск шлюза (из каталога распакованного архива)
./cascad360 start

# или, если исполняемый файл в подкаталоге bin:
# ./bin/cascad360 start

Прямая ссылка на скачивание: cascad360-1.0.0-linux-x86_64.tar.gz

3. Конфигурация

Основной файл конфигурации — config.yml в корне проекта.

# config.yml — пример минимальной конфигурации

server:
  host: "0.0.0.0"
  port: 5000
  debug: false

database:
  type: "mysql"          # mysql или postgresql
  host: "localhost"
  port: 3306             # 3306 для MySQL, 5432 для PostgreSQL
  name: "cascad360"
  user: "root"
  password: "your_password"

security:
  secret_key: "your-secret-key-change-me"
  jwt_expiration: 3600   # 1 час

logging:
  level: "INFO"
  format: "json"

4. Первый запуск

При первом запуске система автоматически:

1. Создаёт таблицы в БД (если не применены миграции)
2. Создаёт администратора по умолчанию: admin / admin
3. Загружает обязательные плагины: auth, security, validation
4. Применяет конфигурацию маршрутизации

5. Настройка базы данных

Одна база данных

По умолчанию используется одно подключение, указанное в config.yml. Этого достаточно для большинства сценариев.

Несколько баз данных

Для работы с несколькими БД добавьте секцию database.connections:

database:
  connections:
    - id: "main"
      type: "mysql"
      host: "localhost"
      port: 3306
      name: "cascad360"
      user: "root"
      password: "password1"

    - id: "analytics"
      type: "postgresql"
      host: "localhost"
      port: 5432
      name: "analytics_db"
      user: "postgres"
      password: "password2"

В API-запросах указывайте datasource_id для выбора подключения.

6. Регистрация сервисов

Сервисы регистрируются в config.yml в секции routing.static_services:

routing:
  static_services:
    # Локальный бэкенд
    - name: "backend-api"
      host: "localhost"
      port: 8080
      routes:
        - path: "/api/v1/users/*"
        - path: "/api/v1/orders/*"

    # Внешний сервис
    - name: "payment-service"
      host: "192.168.1.50"
      port: 3000
      routes:
        - path: "/api/v1/payments/*"

    # Docker-контейнер
    - name: "notification-service"
      host: "notification-container"
      port: 8080
      routes:
        - path: "/api/v1/notifications/*"

Поддерживаются три типа сервисов:

• Локальные — localhost / 127.0.0.1 + порт
• Внешние — IP-адрес или домен + порт
• Контейнеры — имя контейнера в Docker-сети + порт

7. Проверка работоспособности

# Проверка здоровья шлюза
curl http://localhost:5000/health

# Ожидаемый ответ:
# {"status": "ok", "version": "1.0.0-beta"}

# Проверка авторизации (получить токен)
curl -X POST http://localhost:5000/api/v1/auth/login \
  -H "Content-Type: application/json" \
  -d '{"username": "admin", "password": "admin"}'

# Проверка API к БД
curl http://localhost:5000/api/v1/db/query \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "entity": "users",
    "fields": ["id", "username", "email"],
    "filters": {},
    "limit": 10
  }'