Делаба - Веб-приложение для планирования задач по учёбе

Суть проекта

Приложение решает задачу сбора и отслеживания учебных заданий академических групп из разных источников в едином месте.

Администраторы могут управлять набором академических групп (учебных каналов), а также назначать новых модераторов (старост).

Учебные каналы представляют собой отдельные информационные пространства, куда модераторы могут загружать задания по учёбe. Кроме того, они могут приглашать новых пользователей в назначенный им администратором канал.

Загруженные задания при этом группируются по предметам (разделам).

Кроме этого, старосты могут публиковать новости в назначенный им канал в текстовом формате.

Возможности

• Загружайте задания в виде списка пунктов или документов (.pdf);
• Отслеживайте доступные задания и сроки их выполнения
• Поддержка прав доступа - все данные разделены по виртуальным каналам.

Как запустить?

Для удобства конфигурации проект предлагает отдельный python-файл настройки окружения delaba-helper (не требует внешних зависимостей).

Для работы приложения требуются технологии Docker и Docker Compose. Предварительно убедитесь в том, что они поддерживаются и установлены на вашей системе.

1. Откройте конфигуратор окружения через delaba-helper

./delaba-helper build-dotenv

Заполните все требуемые поля для генерации .env проекта (используйте Enter для применения значений по умолчанию)

2. Выберите режим работы

Запустите delaba-helper с одним из следующих параметров:

• dev (окружение с автоперезагрузкой при изменении локального исходного кода и debug-серверами)
• prod (окружение с развёрткой статического веб-сервера и меньшей диагностической нагрузкой)
• test (окружение для проверки работоспособности локального исходного кода)

Программа вернёт указания по запуску проекта в выбранном режиме.

Для работы в режиме разработки рекомендуется установить зависимости проекта локально через uv (./backend/) и bun (./frontend/) для корректной работы средств проверки кода.

3. Завершите создание первого аккаунта администратора

3.1. Откройте веб-интерфейс

После запуска приложения интерфейс пользователя станет доступен по адресу:

• <ALLOWED_HOSTNAME> (prod)
• 127.0.0.1 (dev)

В режиме разработки доступны привязки отдельных сервисов приложения к локальным портам. Ознакомиться с ними можно в файле docker-compose.override.yml.

3.2. Введите данные инициализации

Система при первом запуске автоматически выводит в консоль контейнера backend первоначальный логин и пароль для создания аккаунта администратора:

Root login --> <...>
Root password --> <...>

Введите эти данные в соответствующие поля веб-интерфейса и задайте новый логин и пароль администратора.

Готово!