Пример микросервисов для входа в систему и управления задачами

Ключевые особенности • Как использовать • Благодарности • Лицензия

Ключевые особенности

• Аутентификация пользователей
  • Регистрация пользователя, обновление JWT-токена
  • Возможность добавлять пользователей с ролями ADMIN, USER, GUEST
• Менеджер задач
  • Можно создавать задачи, управлять их статусом, назначать исполнителя
• Менеджер пользователей
  • Простые операции CRUD

Требования

• Java 21 или выше
• Maven 3.6+

Как использовать

Чтобы клонировать и запустить это приложение, вам нужно установить Git, Docker, Docker Compose на вашем компьютере. Также у вас должна быть пара SSH ключей для клонирования по SSH(рекомендуется), следуйте инструкции SSH

Выполните следующие шаги в командной строке:

# Клонируйте этот репозиторий
$ git clone [email protected]:KiselevAlecksey/task-management-system.git

# Перейдите в каталог репозитория
$ cd task-management-system

# Запустите Docker Compose для сборки и запуска приложений
$ docker-compose up --build

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

1. Убедитесь, что вы находитесь в корневом каталоге вашего проекта, где находится файл docker-compose.yml.

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

docker ps

2. Убедитесь, что все контейнеры запущены и работают. Вы должны увидеть следующие контейнеры:

• tms-auth-container
• task-manager-server
• postgres-tms
• postgres-auth

Проверка здоровья сервисов:

3. Вы можете убедиться, что сервисы работают правильно, перейдя по следующим адресам в вашем веб-браузере:

• Для auth-server: http://localhost:9090/actuator/health
• Для task-manager-server: http://localhost:8080/actuator/health

4. Остановка контейнеров:

Чтобы остановить и удалить контейнеры, выполните:

docker-compose down

Добавление данных

После успешного запуска сервисов вы можете использовать Postman для выполнения запросов к API.

• После запуска контейнеров вы можете подключиться к базам данных для добавления данных. Используйте любой инструмент для работы с PostgreSQL, например, pgAdmin или командную строку.

• Пароли указаны в docker-compose.yml.

• Swagger UI доступен по ссылкам http://localhost:8080/swagger-ui/index.html#/ и http://localhost:9090/swagger-ui/index.html#/

• Также можно использовать Swagger.io для просмотра json пакете postman

Примечание

Если у вас возникли проблемы с запуском контейнеров, проверьте логи с помощью команды:

docker-compose logs

Это поможет вам диагностировать проблемы и найти их решения.

Благодарности

Это программное обеспечение использует следующие открытые пакеты:

• Spring Boot 3 JWT Security

Лицензия

MIT

GitHub @KiselevAlecksey  ·  Telegram @Kiselev_Alecksey