# Применяемые технологии ## 1. Стек для легаси продуктов ### 1.1 Backend #### Языки и платформы | Технология | Версия | Статус | Обоснование | |------------------|--------|--------|-------------| | C# | - | ✅ Поддерживать | Версия языка определяется используемой версией .NET | | .NET Framework | 4.8 | ✅ Поддерживать | Финальная версия платформы с поддержкой до 2028 года | Обоснование: для легаси продуктов приоритетом является стабильность и минимизация рисков изменений. .NET Framework 4.8 является финальной версией платформы и будет поддерживаться Microsoft до 2028 года. #### Базы данных | Технология | Статус | Обоснование | |----------------|--------|-------------| | MS SQL Server | ⚠️ Мигрировать постепенно | Используется в легаси, при плановом рефакторинге рекомендуется переход на PostgreSQL | | PostgreSQL | ✅ Поддерживать | Универсальная production-ready СУБД с активным развитием и широкой поддержкой | | SQL Compact | ❗ Мигрировать | Устаревшая БД, ограниченная функциональность и сильная зависимость от Windows | | SQLite | ✅ Поддерживать | Легковесная встраиваемая БД для локального хранения данных | Обоснование: PostgreSQL рекомендуется как целевая платформа для новых и модернизируемых компонентов. SQL Compact признана устаревшей и требует поэтапной миграции без полного переписывания системы. #### ORM и работа с БД | Библиотека | Версия | Статус | Обоснование | |------------------|--------|--------|-------------| | Entity Framework | - | ✅ Поддерживать | Используется в проектах на .NET Framework, версия определяется поддерживаемой платформой | | ADO.NET | - | ⚠️ Мигрировать постепенно | Прямая работа с БД в легаси системах без изменения архитектуры | Обоснование: для легаси-систем допускается постепенный отказ от прямого использования ADO.NET в пользу Entity Framework. ADO.NET остается допустимым для сложных SQL-сценариев, bulk-операций и модулей без планового рефакторинга. Полный отказ от ADO.NET не является целью; приоритетом является повышение поддерживаемости кода без увеличения рисков и с сохранением возможности повторного использования наработок при дальнейшей модернизации системы. #### Логирование | Библиотека | Статус | Обоснование | |------------|--------|-------------| | Serilog | ✅ Поддерживать | Современная библиотека, поддерживает структурированные логи, гибкие sinks, интеграцию с облачными и аналитическими системами (ELK, Seq, Splunk) | | NLog | ⚠️ Мигрировать постепенно | Рабочее решение для легаси, поддерживает различные targets, но уступает Serilog по структурированности и интеграции с современными системами | | log4net | ❗ Мигрировать | Устаревшая библиотека, сложно работать с разными типами вывода, не поддерживает современные аналитические стеки (например ELK), рекомендуется мигрировать на Serilog | Обоснование: Для новых модулей и постепенной миграции рекомендуется Serilog — она обеспечивает структурированные логи, гибкие sinks, поддержку облачных и аналитических систем и упрощает централизованное логирование. Это повышает поддерживаемость и интеграцию кода, при этом не требует срочной полной переписки существующего логирования. #### Сериализация | Библиотека | Статус | Обоснование | |------------------|--------|-------------| | Newtonsoft.Json | ✅ Поддерживать | Замена не критична | | Google.Protobuf | ✅ Поддерживать | Эффективная бинарная сериализация | **Обоснование:** Для легаси-систем Newtonsoft.Json остаётся стандартом сериализации. Замена на System.Text.Json не требуется, если нет критичных требований к производительности. #### Протоколы и коммуникации | Библиотека | Статус | Обоснование | |------------|--------|-------------| | M2Mqtt | ⚠️ Рассмотреть обновление | Устаревающая библиотека MQTT, рекомендуется плановая замена на MQTTnet при модернизации системы | | SSH.NET | ✅ Поддерживать | Стабильная библиотека для работы по SSH, безопасно использовать в легаси | | FluentFTP | ✅ Поддерживать | Активно поддерживается, надежная реализация FTP | | EGTS | ✅ Поддерживать | Специфичный протокол для ГЛОНАСС, поддержка критична для существующих модулей | **Обоснование:** M2Mqtt устаревает и имеет ограниченное развитие, поэтому для новых модулей или при рефакторинге рекомендуется использовать MQTTnet. Для существующих легаси систем текущая библиотека работает стабильно, срочной замены не требуется. Остальные протоколы остаются актуальными и безопасными для использования. --- ## 2. Стек для новых продуктов ### 2.1 Backend #### Языки и платформы | Технология | Версия | Обоснование | |---------------|-------------------------------|-------------| | .NET | 10 (LTS) | LTS-версия с долгосрочной поддержкой (до 14.10.2028), оптимальна для новых production-проектов | | C# | Актуальная (в составе .NET 10) | Синхронизирована с платформой, новые конструкции упрощают код | | ASP.NET Core | 10.x | Высокопроизводительный веб-фреймворк, стандарт для backend на .NET | Обоснование: .NET 10 и C# 14 обеспечивают улучшенную производительность, кроссплатформенность, новые языковые конструкции, расширенные стандартные библиотеки и интеграцию с облаком и микросервисами. Долгосрочная поддержка снижает риски техдолга. #### Базы данных | Технология | Обоснование | |------------|-------------| | PostgreSQL | Универсальное решение | | SQLite | Лёгкая встроенная БД для локальных решений | #### ORM и работа с БД | Библиотека | Версия | Обоснование | |----------------------|----------------------------------------|-------------| | Entity Framework Core | Актуальная версия для используемой .NET платформы | Поддерживает последние возможности ORM, высокую производительность и совместимость с актуальными инструментами | #### Логирование | Библиотека | Версия | Обоснование | |------------|--------|-------------| | Serilog | Актуальная версия для .NET 10 | Современное структурированное логирование, лёгкая интеграция с облачными и аналитическими системами (ELK, Seq, Splunk), поддержка централизованного логирования | Обоснование: Serilog — стандарт для новых .NET проектов. Поддерживает структурированные логи, гибкие sinks и интеграцию с системами мониторинга, повышая удобство эксплуатации и поддерживаемость кода. #### Сериализация | Библиотека | Обоснование | |------------------|-------------| | System.Text.Json | Встроенная в .NET, высокая производительность | | MemoryPack | Для высокопроизводительной бинарной сериализации, оптимально при рефакторинге корпоративного протокола RITM | | Google.Protobuf | Эффективная бинарная сериализация, только по согласованию | Обоснование: Для новых проектов рекомендуется использовать System.Text.Json как стандартную библиотеку сериализации: она встроена в .NET, быстрее Newtonsoft.Json, поддерживает современные конструкции Span/Memory и структурированные JSON-схемы. MemoryPack подходит для высокопроизводительных бинарных сценариев, в том числе при переходе с RITM. #### Протоколы и коммуникации | Библиотека | Обоснование | | ---------- | --------------------------------------- | | MQTTnet | Современный MQTT клиент (вместо M2Mqtt) | | SignalR | Real-time коммуникация | | NModbus | Протокол Modbus) | ### Архитектурные паттерны и инструменты #### CQRS / Mediator | Библиотека | Обоснование | |-----------------|-------------| | MediatR | Реализация паттерна Mediator для разделения команд и запросов | | ❓ TODO | Рассмотреть переход в сторону бесплатного и поддерживаемого решения | #### Валидация | Библиотека | Обоснование | | ---------------- | ------------------------------------------------------------------------------------ | | FluentValidation | Fluent API для проверки сложных условий, повышает читаемость и поддерживаемость кода | | ❓ TODO | Рассмотреть библиотеки для реализации Result паттерна | #### Маппинг / DTO | Библиотека | Обоснование | |------------|-------------| | AutoMapper | Автоматический маппинг объектов, уменьшает ручной код при трансформации DTO и моделей | | ❓ Mapster | Быстрая и лёгкая альтернатива AutoMapper с source generators и меньшей конфигурацией | > ❓ TODO: проверить Mapster, подходит ли для проектов, протестировать source generators и сложные сценарии маппинга #### Устойчивость / Политики | Библиотека | Обоснование | |------------|-------------| | Polly | Реализация retry, circuit breaker и других политик устойчивости | #### DI / Инъекция зависимостей | Библиотека | Обоснование | |------------|-------------| | Microsoft.Extensions.DependencyInjection | Стандартный контейнер DI для .NET | | Scrutor | Расширение для автоматической регистрации сервисов по соглашению, удобно для модульных проектов | #### Хостинг и фоновые задачи | Библиотека / Инструмент | Обоснование | |-------------------------------|-------------| | Microsoft.Extensions.Hosting | Управление жизненным циклом приложений, интеграция с DI и background-сервисами | | IHostedService / BackgroundService | Простые фоновые задачи внутри приложения, периодичность через Timer/Task.Delay | | Quartz.Extensions.Hosting | Планировщик с гибким расписанием и поддержкой критичных задач | > Обоснование использования: > - **IHostedService / BackgroundService** — для простых фоновых задач, связанных с приложением. > - **Quartz** — для сложного расписания, устойчивости и управления job-ами. #### Геопространственные данные | Библиотека | Обоснование | |---------------------------|-------------| | GMap.NET.Core | Работа с картами и геоданными | | GeoJSON.Net | Работа с форматом GeoJSON | | DotSpatial.Projections | Работа с пространственными проекциями | | NetTopologySuite | Работа с геометрией и пространственными данными | #### Тестирование | Библиотека | Обоснование | |-------------------|-------------| | xUnit | Фреймворк для unit-тестов | | Moq | Создание моков для зависимостей | | AutoFixture.Xunit | Генерация тестовых данных | | MockQueryable.Moq | Моки для IQueryable | --- ## Заключение - Для **легаси систем** главное — стабильность, постепенная миграция и сохранение существующих наработок. - Для **новых проектов** — использовать современные, поддерживаемые технологии.