Сервис для информирования о состоянии склада, наличии снаряжения и т.д. Для использования требуется подключение к Google-таблице склада.
- .NET 7
- Swagger UI
- REST API
- PostgreSQL
- Google Apps Script
Prefix: host/api/v1/
| Method | Route | Request | Response | Notes |
|---|---|---|---|---|
| GET | equipment/central | skip - сколько записей пропустить, take - сколько записей взять | {items: EquipmentItemAvailability[] , totalCount: Integer} |
Возвращает массив объектов-снаряжения для центрального склада |
Сущность нужна для отображения пользователю количество инвентаря на складе, с указанием какой конкретно объект и примерное количество.
class EquipmentItemAvailability {
equipmentItemId: number, // Идентификатор вида снаряжения
equipmentItemTitle: string, // Название, например: верёвка 30м
storageId: number, // Идентификатор склада
storageTitle: string, // Название склада, например: центральный склад
availability: AvailabilityLevel, // Наличие на складе, например: AvailabilityLevel.Enough (достаточно)
resupplyDate: Date | null // Дата пополнения запасов, если известно когда кто-то собирается вернуть эту вещь на склад
}Сущность описывает элемент снаряжения, например веревку, карабин, каску.
class EquipmentItem {
Id: number // Идентификатор в БД
title: string // Отображаемое название, например: Карабин стальной
synonyms: string[] // Синонимы, нужны для парсинга из таблиц и для поиска, например: [Кс, сталь]
}Перечисление нужно для описания количества снаряжения на складе без указания точного количества.
enum AvailabilityLevel {
Unknown = 0, // Неизветно
Enough = 1, // Достаточно
Medium = 2, // Средне
Few = 3, // Мало
OutOfStock = 4 // Отсутствует
}