Sber Teambuilding

О проекте

Какую проблему решаем

Sber Teambuilding — это платформа для организации и управления корпоративными мероприятиями и командообразующими активностями. Решает следующие проблемы:

• Сложности в организации групповых мероприятий
• Трудности с координацией участников
• Отсутствие централизованного управления задачами и расходами
• Неэффективная коммуникация между участниками мероприятий

Функциональность

• Управление мероприятиями:

  • Создание мероприятий
  • Приглашение участников
  • Поиск по мероприятиям
  • Шаблоны для быстрого создания типовых мероприятий
  • AI-ассистент для помощи в создании мероприятий

• Управление задачами:

  • Создание задач в рамках мероприятия
  • Назначение ответственных
  • Отслеживание прогресса выполнения

• Коммуникация:

  • Встроенный чат для каждого мероприятия
  • Уведомления о важных событиях

• Управление расходами:

  • Учет затрат на мероприятие
  • Отслеживание бюджета

• Локации:

  • Привязка мероприятий к местам проведения
  • Интеграция с картами

Технологический стек

Frontend:

• Основа: React 19, TypeScript
• Маршрутизация: TanStack Router с файловой маршрутизацией
• Управление состоянием и запросами: TanStack Query (React Query)
• UI компоненты: Shadcn/UI, Radix UI
• Стилизация: TailwindCSS
• Формы: React Hook Form с валидацией Zod
• Сборка: Vite

Backend:

• Java, Spring Boot
• Liquibase, Postgres
• Интеграция с API через сгенерированные из Swagger типизированные методы
• Axios для HTTP-запросов
• WebSocket для реактивной связи

Тестирование:

• Testcontainer для тестирования backend

Развертывание:

• Docker для контейнеризации
• Nginx для раздачи статики
• Traefik как reverse proxy

Интеграции

Telegram:

• Возможность получать уведомления о событиях и задачах
• Интеграция с системой аутентификации через Telegram

Email:

• Отправка приглашений участникам мероприятий
• Уведомления о новых задачах и изменениях в мероприятиях
• Системные оповещения

Запуск проекта

Разработка

2. Создайте файл .env на основе примера:

   cp .env.example .env

3. Запустите проект в режиме разработки с помощью Makefile:

   make dev-up

   Эта команда запустит все необходимые сервисы через Docker Compose:

   • Frontend (доступен на http://localhost:80)
   • Backend (доступен на http://localhost:8080)
   • PostgreSQL (доступен на localhost:5432)

4. Для остановки сервисов используйте:

   make dev-down

5. Для запуска только определенных компонентов доступны команды:

   make dev-up-postgres  # только база данных
   make dev-up-backend   # база данных + бэкенд