mse-2025-rocket1

Установка и запуск

Здесь описывается процесс установки и запуска релизной версии. Для запуска версии в разработке перейдите к следующему разделу

Зависимости

Для функционирования программного продукта необходимо наличие на машине установленного ПО Docker актуальной версии

Процесс запуска

Для установки и запуска необходимо:

1. Проверить наличие зависимостей из соответствующего раздела
2. Склонировать ветку main репозитория (так как ветка reports содержит в себе видеозаписи созвонов, полный репозиторий весит много)

git clone https://github.com/moevm/mse1h2025-rocket1 -b main --single-branch 

3. Перейти в директорию deployment/prod

cd mse1h2025-rocket1/deployment/prod

4. Настроить порты на которых будут работать фронтенд и бэкенд, изменив переменные среды, указанные в файле .env
5. Запустить docker-compose релизной версии

docker compose up -d

Примечание

При изменении переменных среды обязательно необходимо пересобрать докер-контейнеры

docker compose build --no-cache

Остановка

Для прекращения работы программного продукта требуется

1. Перейти в директорию deployment/prod

cd mse1h2025-rocket1/deployment/prod

2. Отдать docker-compose команду об остановке

docker compose down

Установка и запуск версии "в разработке"

Здесь описывается процесс установки и запуска версии "В разработке". Для запуска релизной версииперейдите к предыдущему разделу

Зависимости версии "в разработке"

Для функционирования программного продукта необходимо наличие на машине установленного ПО Docker актуальной версии, а также следующих программ:

python >= 3.13
uv
bun

Процесс запуска

Для установки и запуска необходимо:

1. Проверить наличие зависимостей из соответствующего раздела
2. Склонировать репозиторий

git clone https://github.com/moevm/mse1h2025-rocket1

3. Перейти на ветку development

git checkout development

4. Перейти в директорию deployment

cd mse1h2025-rocket1/deployment/dev

5. Запустить docker-compose версии в разработке

docker compose up -d

6. Перейти в директорию backend

cd ../../backend

7. Запустить бэкенд-сервер

uv run fastapi dev

8. Перейти в директорию frontend

cd ../frontend

9. Установить зависимости фронтенд-сервера

bun install

10. Запустить фронтенд-сервер

bun run dev

Послеустановочные операции

Где взять токен и userId для входа?

1. Войти в RocketChat с аккаунта администратора (или другого аккаунта от имени которого будет производиться использование RocketManager)
2. Перейти в раздел "Учётная запись" -> "Профиль"
3. Выбрать раздел "Токены для личного доступа" (альтернативно 2 и 3 разделу - перейти по адресу <URL пространства>/account/tokens)
4. В поле с placeholder'ом "Добавить токен личного доступа" ввести название токена (можно оставить пустым), в выпадающем меню выбрать "Игнорировать двухфакторную авторизацию", нажать "добавить"
5. В открывшемся окне появятся токен и Id пользователя.

Настройка пространства для работы с RocketManager (ВАЖНО)

I. Включение бесконечной пагинации

1. Войти в RocketChat с аккаунта администратора
2. Перейти в стандартную админ-панель RocketChat
3. Открыть раздел "Настройки"
4. Открыть подраздел "Общие настройки"
5. В пункте REST API включить настройку "Разрешить получить всё"

II. Выдать роли администратора все права:

1. Войти в RocketChat с аккаунта администратора
2. Перейти в стандартную админ-панель Rocketchat
3. Перейти в раздел "Права доступа" (альтернативно 2 и 3 разделу - перейти по адресу <URL пространства>/admin/permissions)
4. Выдать роли Admin (или, при наличии, специально выделенной для аккаунта котрый будет использоваться с RocketManager) все права