API для управления устройствами печати

Данный проект предоставляет API для управления сеансами печати, устройствами печати, филиалами, сотрудниками и инсталляциями.

Основные возможности

• Получение сотрудников, филиалов и устройств печати
• Создание, получение и удаление инсталляций устройств печати для сотрудников в филиалах.
• Создание и обработка сеансов печати, включая возможность загрузки сеансов через CSV-файл.
• Фильтрация инсталляций по филиалам.

Схема базы данных

На схеме ниже представлена структура базы данных, которая используется в данном проекте:

Требования

• Установленная .NET SDK версии 8.0 или выше.
• Подключение к базе данных (SQL Server).

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

1. Склонируйте репозиторий на локальную машину:

   git clone https://github.com/GeorgeD615/PrintingSystemAPI.git

2. Создайте базу данных с помощью скрипта Create Database в папке SQL Scripts.
3. При необходимости настройте строку подключения к базе данных в файле appsettings.json.
4. Запустите приложение

Swagger документация

После запуска проекта, документация API будет доступна по адресу:

http://localhost:23456

Описание методов API

В проекте реализованы следующие контроллеры:

• EmployeesController – Управление сотрудниками (получение списка сотрудников).
• InstallationsController – Управление инсталляциями устройств печати (создание, получение, удаление инсталляций).
• OfficesController – Управление филиалами (получение списка филиалов).
• PrintingDevicesController – Управление устройствами печати (получение устройств по типу подключения).
• SessionsController – Управление сеансами печати (создание сенсов, загрузка через CSV, получение результата печати).

Пример POST-запроса для создания сеанса печати

POST /api/sessions
Content-Type: application/json
{
"TaskName": "Печать документа",
"EmployeeId": "A0BFADA5-CA3D-4481-87E3-3B89FA2004B0",
"DeviceOrderNumber": 1,
"NumberOfPages": 10
}