Spoleto.Marking.TsPiot 1.0.13

Spoleto.Marking.TsPiot

.NET 8 клиент для интеграции с Драйвером ТС ПИоТ (ЕСМ) через gRPC / REST.

📌 Описание

Пакет предназначен для интеграции программного обеспечения рабочего места кассира (ПМСР) с Драйвером ТС ПИоТ в рамках требований системы маркировки «Честный ЗНАК».

ТС ПИоТ выступает как единая точка входа для проверки кодов маркировки и берет на себя взаимодействие с ГИС МТ.

🎯 Назначение

• Проверка кодов маркировки
• Получение статуса товара
• Поддержка онлайн и офлайн режимов (ЛМ ЧЗ)
• Обработка ошибок и блокировка некорректных операций

🏗 Архитектура взаимодействия

Общий сценарий

1. Пользователь сканирует код маркировки
2. Код передаётся в ТС ПИоТ
3. ТС ПИоТ возвращает результат:
   • ✅ разрешить продажу
   • ❌ запретить продажу

🔌 Протокол взаимодействия

ТС ПИоТ предоставляет локальный API:

• gRPC
• REST

🚀 Установка

dotnet add package Spoleto.Marking.TsPiot

⚙️ Конфигурация

Пример appsettings.json:

{
  "TsPiotClientOptions": {
    "ServiceUrl": "https://esm-emu.ao-esp.ru/",
    "RetryOptions": {
      "AttemptTimeoutSeconds": 30,
      "TotalTimeoutSeconds": 180,
      "BaseDelayMs": 500,
      "RetryCount": 3
    },
    "AppOptions": {
      "Name": "MyApp",
      "Version": "1.0",
      "Id": "my-app-id",
      "Token": "token"
    }
  }
}

⚙️ Инициализация

var options = configuration
    .GetSection("TsPiotClientOptions")
    .Get<TsPiotClientOptions>();

🔄 Создание клиента

REST

ITsPiotClient client = new TsPiotRestClient(options);

gRPC

ITsPiotClient client = new TsPiotGrpcClient(options);

✅ Примеры использования

Проверка кодов

var codes = new[]
{
    "код1",
    "код2"
};

var result = await client.CheckCodesAsync(codes);

if (result != null)
{
    Console.WriteLine("Проверка выполнена");
}

Проверка аварийного режима

var result = await client.CheckCodesAsync(codes);

if (result.IsEmergencyMode)
{
    Console.WriteLine("Аварийный режим (код ответа 203)");
}

Обработка ошибок

try
{
    var result = await client.CheckCodesAsync(codes);
}
catch (TsPiotException ex)
{
    Console.WriteLine($"Ошибка проверки: {ex.Message}");
}

🧪 Примеры (как в тестах)

Успешный сценарий

var settings = ConfigurationHelper.GetOptions();
var client = new TsPiotRestClient(settings);

var codes = ConfigurationHelper.GetSuccessfulCodes();

var res = await client.CheckCodesAsync(codes);

Assert.That(res, Is.Not.Null);

Аварийный режим (203)

var settings = ConfigurationHelper.GetOptions();
var client = new TsPiotGrpcClient(settings);

var codes = ConfigurationHelper.GetSuccessfulCodes203();

var res = await client.CheckCodesAsync(codes);

Assert.That(res.IsEmergencyMode, Is.True);

Ошибка проверки

var settings = ConfigurationHelper.GetOptions();
var client = new TsPiotRestClient(settings);

var codes = ConfigurationHelper.GetUnsuccessfulCodes();

Assert.ThrowsAsync<TsPiotException>(async () =>
{
    await client.CheckCodesAsync(codes);
});

⚠️ Важно

• ТС ПИоТ должен быть доступен по ServiceUrl
• Клиент не взаимодействует напрямую с ГИС МТ
• Все проверки проходят через ТС ПИоТ
• Retry/Timeout настраиваются через RetryOptions

📄 Лицензия

MIT