Task Management Web Service

Веб-сервис для работы с задачами.

Поднять бд

Чтобы поднять бд используйте Docker Compose:

docker-compose -f docker/docker-compose.yml up -d --build

Файл docker-compose.yml находится в папке docker.

Миграции базы данных

Для добавления миграций в каждом сервисе выполните команду:

dotnet ef migrations add <MigrationName> --project Infrastructure --startup-project <API-Project-Name>

Миграции применяются автоматически при запуске приложения.

ENV

В каждый микросервис в слой апи нужно подгрузить .env В том числе в API GATEWAY

JWT_KEY=AAAAB3NzaC1yc2EAAAABJQAAACEA3N1qw1YmAimBUVDFVgHdDulVCiQuBtCaDYQEf5FGMhM

GATEWAY=https://localhost:7024
AUTH_API=https://localhost:7026
NOTIFICATION_API=https://localhost:7043
TASK_API=https://localhost:7055

Технологии

Работа с базой данных осуществляется через Dapper.
Entity Framework Core используется только для создания миграций.

Документация API

Краткая документация доступна через Swagger UI в каждом сервисе.

Основные API эндпоинты

Задачи

GET /api/tasks

Получить список задач с фильтрами.
Параметры запроса:

• filter — поиск по заголовку задачи (title)
• pageSize — количество задач на странице
• pageNumber — номер страницы

Возвращает задачи, доступные пользователю.

POST /api/tasks

Создать задачу.
Тело запроса (JSON):

{
  "title": "string",
  "description": "string",
  "assignedUserId": 0,
  "status": "Planned",
  "isDeleted": true
}

• status — строка из enum JobStatus:

namespace Domain.Enum;
public enum JobStatus { Planned, Testing, Completed, Failed }

• assignedUserId — ID назначенного пользователя, может быть null.

GET /api/tasks/{id}

Получить задачу по ID, если она доступна пользователю.

PUT /api/tasks/{id}

Обновить задачу по ID.
Тело запроса — те же поля, что и при создании, с изменёнными значениями.

Обновление возможно при наличии прав у пользователя.

DELETE /api/tasks/{id}

Мягкое удаление задачи (помечается как удалённая в БД, поле isDeleted).

DELETE /api/tasks/{id}/hard-delete

Жёсткое удаление — задача полностью удаляется из базы.

PUT /api/tasks/{id}/assign

Назначить исполнителя. Нужно указать ID задачи и ID пользователя.
Исполнитель назначится, если у пользователя есть права и указанный пользователь существует.

GET /api/tasks/get-history-by-job/{jobId}

Получить историю изменений задачи.
Параметры запроса:

• pageSize — количество записей истории на странице
• pageNumber — номер страницы

Возвращает всю историю изменений для задачи с указанным jobId.

Аутентификация и Пользователи

POST /api/auth/register

Регистрация пользователя с проверкой на существующую почту.
Тело запроса (JSON):

{
  "email": "string",
  "password": "string"
}

POST /api/auth/login

Вход (получение JWT токена).
Тело запроса (JSON):

{
  "email": "string",
  "password": "string"
}

GET /api/auth/me

Информация о текущем пользователе.
Пример ответа:

{
  "id": 1,
  "email": "qwerty@gmail.com",
  "hashedPassword": "5jJhkTqDgTDnLZthskGQczxTSrOYRgDexETz2gvPF4f5dGrh6L6bM86wqhF1gzWGfCSVDHNua+im/bgOTlQwGw==",
  "salt": "07cd5f5d-0efa-4ab2-a8b5-3757a810bfe3"
}

POST /auth/api/logout

Выход из аккаунта.

GET /auth/api/get-user-by/{id}

Получение информации о пользователе по ID.

Чтобы стать авторизованным пользователем введите в поле ввода токена Bearer и ваш токен. При переходе в другой микросервис, снова заполните это поле

Уведомления

GET /api/notifications/{userId}

Получить список уведомлений.

POST /api/notifications

Создать уведомление.

PUT /api/notifications/{id}/mark-as-read

Отметить уведомление как прочитанное.

Особенности

• NotificationService и TaskService взаимодействуют с AuthService для валидации логина.
• Все микросервисы разбиты на слои.
• Придерживался чистой архитектуры.
• Все миграции создаются через EF Core, но доступ к базе осуществляется через Dapper.