Рабочий процесс использования KMES

Бизнес-сценарий

Данное руководство демонстрирует установку, развертывание и использование системы EMS в контексте сталелитейного производства.

Предварительные требования

Убедитесь, что на вашей локальной рабочей станции установлено следующее программное обеспечение:

• Docker
• Visual Studio Code (рекомендуется установить расширение Python)
• Node.js (версия 20 или выше)
• Python 3.12.5 (внимание: избегайте использования версий Python 3.12.6 и новее согласно README)
• DBeaver (или аналогичный клиент для работы с базами данных)

Подготовьте окружение, следуя шагам из README.md:

1. Загрузка образов Docker
   Используйте docker-compose или команды docker pull/docker tag для получения образов postgres:16 и redis:latest:

   # Пример (см. точные команды в README.md)
   # docker-compose -f mes-compose.yml -p kmes up -d

2. Копирование шаблона переменных окружения:

   cp .env.template dev.env

   • Вы можете при необходимости изменить любые переменные в файле dev.env.
3. Запуск сервисов (PostgreSQL и Redis):

   docker-compose -f mes-compose.yml -p easy up -d
   # Или следуйте альтернативным способам запуска, описанным в README

   • После запуска убедитесь, что контейнеры работают, и подключитесь к PostgreSQL через DBeaver.

Запуск системных сервисов

1. Установка зависимостей backend:
   • Убедитесь, что pip обновлён до последней версии:

     pip install --upgrade pip

   • Установите зависимости проекта:

     pip install -e .
     # Или для ускорения установки через зеркало Aliyun:
     # pip install -e . -i https://mirrors.aliyun.com/pypi/simple/ --trusted-host mirrors.aliyun.com

2. Инициализация базы данных:
   • В Visual Studio Code выберите интерпретатор Python версии 3.12.5.
   • Откройте вкладку "Отладка" (Debug).
   • Запустите конфигурацию Server Cli - init-test.
3. Запуск backend-сервисов:
   • В режиме отладки (Debug) в Visual Studio Code
   • Запустите конфигурацию Web API Server - 8000. API будет запущен на порту 8000.
4. Установка зависимостей фронтенда:

   npm install
   # или
   # yarn install

5. Запуск фронтенд-сервиса:

   npm run dev

6. Доступ к системе:
   • Откройте браузер и перейдите по адресу http://localhost:8881 (или по вашему настроенному адресу).