Tisa.BpmCore 2026.1.9.310

Tisa.BpmCore

Описание

Tisa.BpmCore - это библиотека для работы с платформой BPMSoft, предоставляющая базовые абстракции и реализации для взаимодействия с BPM-системой. Проект является частью экосистемы ТИСА и предназначен для упрощения разработки бизнес-приложений, работающих с BPMSoft.

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

• Поддержка .NET 8.0, .NET 9.0 и .NET 10.0
• Интеграция с платформой BPMSoft
• REST API для взаимодействия с BPMSoft
• JSON сериализация/десериализация
• Асинхронное программирование

Структура проекта

Tisa.BpmCore/
├── Abstractions/    # Абстракции и интерфейсы
├── Clients/         # Клиенты для работы с BPMSoft
├── Data/            # Модели данных
├── Exceptions/      # Кастомные исключения
├── Extensions/      # Методы расширения
├── Infrastructure/  # Инфраструктурные компоненты
├── Requests/        # Модели запросов
├── Responses/       # Модели ответов
└── Resources/       # Ресурсы проекта

Установка

NuGet Package Manager

Install-Package Tisa.BpmCore

.NET CLI

dotnet add package Tisa.BpmCore

Начало работы

Базовая конфигурация

public void ConfigureServices(IServiceCollection services, IConfiguration configuration)
{
    // Вариант 1: из секции конфигурации "BpmCore"
    services.AddBpmCore(configuration);

    // Вариант 2: ручная настройка
    services.AddBpmCore(options =>
    {
        options.BaseUrl = "https://your-bpmsoft-instance.com";
        options.User = "admin";
        options.Password = "password";
        options.Timeout = TimeSpan.FromSeconds(30);
    });
}

Использование клиента

public class YourService
{
    private readonly IBpmClient _bpmClient;

    public YourService(IBpmClient bpmClient)
    {
        _bpmClient = bpmClient;
    }

    public async Task<string> GetDataAsync(string method, CancellationToken ct)
    {
        return await _bpmClient.GetAsync(method, null, ct);
    }
}

Работа с процессами и данными

• Запуск процессов, получение информации о процессах, управление состоянием
• Сериализация/десериализация JSON, валидация данных
• Кастомные исключения, логирование, повторные попытки при сбоях (Polly)

Разработка

Требования

• .NET 8.0 SDK или выше (поддержка net8.0 / net9.0 / net10.0)
• Visual Studio 2022 или VS Code
• Доступ к BPMSoft платформе

Сборка проекта

dotnet build

Тестирование

dotnet test

Публикация пакета

dotnet pack -c Release
dotnet nuget push bin/Release/*.nupkg -s https://api.nuget.org/v3/index.json

Конвенции разработки

Кодирование

• Использование UTF-8 кодировки
• Соблюдение правил именования .NET
• Комментарии на русском языке
• XML-документация для публичных API

Структура кода

• Разделение на слои (Abstractions, Implementation)
• Использование паттернов проектирования
• Асинхронное программирование
• Обработка исключений

Тестирование

• Unit-тесты для всех компонентов
• Интеграционные тесты для клиентов
• Использование Moq для тестирования

Безопасность

Основные принципы

• Безопасное хранение учетных данных
• Валидация входных данных
• Защита от инъекций
• Использование HTTPS

Рекомендации

• Регулярное обновление зависимостей
• Мониторинг уязвимостей
• Аудит безопасности кода

Хранение секретов в Production

• Используйте User Secrets для локальной разработки
• В production используйте Azure Key Vault, HashiCorp Vault или переменные окружения
• Никогда не храните пароли и строки подключения в файлах, попадающих в систему контроля версий
• Путь к конфигурации BPMSoft можно задать через переменную окружения BPMSOFT_CONFIG_PATH

Производительность

Оптимизация

• Асинхронные операции
• Кэширование где необходимо
• Эффективное использование ресурсов
• Оптимизация сетевых запросов

Мониторинг

• Логирование критических операций
• Метрики производительности
• Профилирование при необходимости

Поддержка и развитие

Процесс разработки

1. Создание feature branch
2. Написание тестов
3. Реализация функционала
4. Code review
5. Слияние в main

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

• Поддержка актуальности README
• Обновление XML-документации
• Ведение changelog

Поддержка

• Issue tracking
• Pull request review
• Версионирование и релизы

Лицензия

MIT License

Контакты

• Email: support@tisa.ru
• Website: https://tisa.ru