VCST-4328: Update to .NET10

Directory.Build.props

@@ -2,7 +2,7 @@
 <Project>
   <!-- These properties will be shared for all projects -->
   <PropertyGroup>
-    <VersionPrefix>3.809.0</VersionPrefix>
+    <VersionPrefix>3.1000.0</VersionPrefix>
     <VersionSuffix>
     </VersionSuffix>
     <VersionSuffix Condition=" '$(VersionSuffix)' != '' AND '$(BuildNumber)' != '' ">$(VersionSuffix)-$(BuildNumber)</VersionSuffix>

README.md

@@ -1,19 +1,126 @@
-# Virto Commerce Export Module
+# Generic Export Module
 
 [![CI status](https://github.com/VirtoCommerce/vc-module-export/workflows/Module%20CI/badge.svg?branch=dev)](https://github.com/VirtoCommerce/vc-module-export/actions?query=workflow%3A"Module+CI") [![Quality gate](https://sonarcloud.io/api/project_badges/measure?project=VirtoCommerce_vc-module-export&metric=alert_status&branch=dev)](https://sonarcloud.io/dashboard?id=VirtoCommerce_vc-module-export) [![Reliability rating](https://sonarcloud.io/api/project_badges/measure?project=VirtoCommerce_vc-module-export&metric=reliability_rating&branch=dev)](https://sonarcloud.io/dashboard?id=VirtoCommerce_vc-module-export) [![Security rating](https://sonarcloud.io/api/project_badges/measure?project=VirtoCommerce_vc-module-export&metric=security_rating&branch=dev)](https://sonarcloud.io/dashboard?id=VirtoCommerce_vc-module-export) [![Sqale rating](https://sonarcloud.io/api/project_badges/measure?project=VirtoCommerce_vc-module-export&metric=sqale_rating&branch=dev)](https://sonarcloud.io/dashboard?id=VirtoCommerce_vc-module-export)
 
-The Virto Commerce Export module provides the ability to export data from Catalog and Pricing modules. Before starting the export, the user can first filter the data by object type and properties, select the export provider using the advanced filter.
+## Overview
 
-## Key features
+The Generic Export module provides a pluggable, provider-based export infrastructure for the Virto Commerce platform. It allows any module to register its domain entities as exportable types and then export them to different file formats (JSON, CSV) via a unified REST API. Export operations run as Hangfire background jobs with real-time progress reporting through push notifications, and the resulting files are persisted to the platform's blob storage for subsequent download.
 
-* Role-based functionality- only users with an Export reader role has access to generic export function
-* Possibility to apply an advanced filter before starting the export
-* Data can be exported in JSON and CSV format
+## Key Features
+
+* **Pluggable export type registry** — Other modules register their exportable entity types at startup; the export module discovers and exposes them through a single API.
+* **Multiple export providers** — Ships with JSON (hierarchical) and CSV (tabular) providers out of the box; additional providers can be added via DI.
+* **Background job execution** — Export tasks are queued as Hangfire background jobs, keeping API responses non-blocking and supporting cancellation.
+* **Real-time progress notifications** — Push notifications report export progress (processed/total counts, errors, completion) to the calling client.
+* **Property-level filtering** — Callers can select which properties to include in the export, and the module strips excluded properties before writing.
+* **Tabular conversion** — Entities that implement `ITabularConvertible` can be flattened for CSV export while retaining their full hierarchy for JSON export.
+* **Paged data retrieval** — A generic `ExportPagedDataSource` base class handles pagination, so consuming modules only need to implement the data-fetch logic.
+* **Fluent type registration** — `ExportedTypeDefinitionBuilder` and its extension methods provide a fluent API for registering export types with metadata, data sources, and groups.
+* **Configurable file naming** — Export file names are generated from a configurable template with timestamp formatting.
+* **OR-based authorization** — The `AuthorizeAny` attribute allows endpoints to accept any one of several permissions (e.g., platform export OR module download).
+
+## Configuration
+
+### Application Settings
+
+| Setting | Type | Default | Description |
+|---------|------|---------|-------------|
+| `Export.FileNameTemplate` | ShortText | `export_{0:yyyyMMddHHmmss}` | Template for generated export file names. `{0}` is replaced with the UTC timestamp. |
+
+### Permissions
+
+| Permission | Description |
+|------------|-------------|
+| `export:access` | Grants access to list export types, preview data, start export tasks, and cancel running exports. |
+| `export:download` | Grants access to download exported files (also accepted: `platform:export`). |
+
+## Architecture
+
+```
+┌───────────────────────────────────────────────────────────┐
+│                        Web Layer                          │
+│  ExportController · ExportJob · Module                    │
+│  (VirtoCommerce.ExportModule.Web)                         │
+├──────────────┬────────────────────────┬───────────────────┤
+│  CSV Provider│      Data Layer        │   JSON Provider   │
+│  CsvExport-  │  DataExporter          │   JsonExport-     │
+│  Provider    │  KnownExportTypes-     │   Provider        │
+│  Metadata-   │    Service             │   ObjectDiscrim-  │
+│  FilteredMap │  ExportProviderFactory │   inatorJson-     │
+│              │  ExportPagedDataSource │   Converter       │
+│  (CsvProvider│  ExportFileStorage     │                   │
+│   project)   │  ExportedTypeDefini-   │  (JsonProvider    │
+│              │    tionBuilder         │   project)        │
+│              │  (VirtoCommerce.       │                   │
+│              │   ExportModule.Data)   │                   │
+├──────────────┴────────────────────────┴───────────────────┤
+│                       Core Layer                          │
+│  Domain Models · Service Interfaces · Settings            │
+│  Permissions · ExportDataQuery · IExportProvider           │
+│  (VirtoCommerce.ExportModule.Core)                        │
+└───────────────────────────────────────────────────────────┘
+```
+
+> **Note:** This module has no database layer — it is a pure infrastructure/framework module. Data is sourced from other modules that register their paged data sources.
+
+### Key Flow
+
+1. During startup, consuming modules register their exportable types via `IKnownExportTypesRegistrar.RegisterType()`, supplying an `ExportedTypeDefinition` with metadata and a paged data source factory.
+2. A client retrieves available export types by calling `GET /api/export/knowntypes`.
+3. The client optionally previews data via `POST /api/export/data` with an `ExportDataRequest`.
+4. The client starts an export by calling `POST /api/export/run` with the export type name, data query, and chosen provider name.
+5. The controller creates an `ExportPushNotification` and enqueues a Hangfire background job (`ExportJob`).
+6. `ExportJob` uses `IExportProviderFactory` to create the requested provider (JSON or CSV) and opens a write stream via `IExportFileStorage`.
+7. `DataExporter` resolves the `ExportedTypeDefinition`, creates the `IPagedDataSource`, and iterates through pages of data.
+8. For each record, properties are filtered to the requested subset, tabular conversion is applied if needed, and the record is written via the `IExportProvider`.
+9. Progress callbacks update the push notification in real time (processed count, errors, description).
+10. On completion, the download URL (`/api/export/download/{fileName}`) is set on the notification.
+11. The client downloads the file via `GET /api/export/download/{fileName}`, which streams it from blob storage.
+
+## Components
+
+### Projects
+
+| Project | Layer | Purpose |
+|---------|-------|---------|
+| VirtoCommerce.ExportModule.Core | Core | Domain models, service interfaces, permissions, settings, and constants |
+| VirtoCommerce.ExportModule.Data | Data | Service implementations, paged data source base class, security utilities, and extension methods |
+| VirtoCommerce.ExportModule.CsvProvider | Provider | CSV export provider using CsvHelper with metadata-driven column mapping |
+| VirtoCommerce.ExportModule.JsonProvider | Provider | JSON export provider using Newtonsoft.Json with type discriminator support |
+| VirtoCommerce.ExportModule.Web | Web | REST API controller, Hangfire background job, and module DI registration |
+| VirtoCommerce.ExportModule.Tests | Tests | Unit tests |
+
+### Key Services
+
+| Service | Interface | Responsibility |
+|---------|-----------|----------------|
+| `DataExporter` | `IDataExporter` | Orchestrates the full export pipeline: resolves the data source, iterates pages, filters properties, and writes records via the provider |
+| `KnownExportTypesService` | `IKnownExportTypesRegistrar`, `IKnownExportTypesResolver` | Thread-safe registry of exportable type definitions; allows registration and lookup by type name |
+| `ExportProviderFactory` | `IExportProviderFactory` | Selects and instantiates the appropriate `IExportProvider` based on the provider name in the request |
+| `ExportFileStorage` | `IExportFileStorage` | Generates export file names from the configured template and reads/writes files via the platform blob storage provider |
+| `ExportPagedDataSource<TDataQuery, TSearchCriteria>` | `IPagedDataSource` | Abstract base class for paginated data retrieval; consuming modules subclass it to supply their own fetch logic |
+| `ExportedTypeDefinitionBuilder` | — | Fluent builder for constructing `ExportedTypeDefinition` instances with metadata, data sources, and groups |
+| `CsvExportProvider` | `IExportProvider` | Writes exportable entities as CSV rows using CsvHelper; requires tabular (flat) data |
+| `JsonExportProvider` | `IExportProvider` | Writes exportable entities as a JSON array with type discriminators; supports hierarchical data |
+| `ExportJob` | — | Hangfire background job that wires together the provider, file storage, and data exporter with progress reporting |
+
+### REST API
+
+Base route: `api/export`
+
+| Method | Endpoint | Description |
+|--------|----------|-------------|
+| GET | `/api/export/knowntypes` | Returns all registered exportable type definitions |
+| GET | `/api/export/providers` | Returns all available export providers |
+| POST | `/api/export/data` | Fetches a page of exportable entities for preview based on the data request |
+| POST | `/api/export/run` | Starts an export background job and returns a push notification with the job ID |
+| POST | `/api/export/task/cancel` | Cancels a running export job by its Hangfire job ID |
+| GET | `/api/export/download/{fileName}` | Downloads a previously exported file by file name |
 
 ## Documentation
 
 * [Generic Export module user documentation](https://docs.virtocommerce.org/platform/user-guide/generic-export/overview/)
-* [REST API](https://virtostart-demo-admin.govirto.com/docs/index.html?urls.primaryName=VirtoCommerce.Export)
+* [REST API Reference](https://virtostart-demo-admin.govirto.com/docs/index.html?urls.primaryName=VirtoCommerce.Export)
 * [View on GitHub](https://github.com/VirtoCommerce/vc-module-export)
 
 ## References
@@ -22,13 +129,12 @@ The Virto Commerce Export module provides the ability to export data from Catalo
 * [Installation](https://docs.virtocommerce.org/platform/user-guide/modules-installation/)
 * [Home](https://virtocommerce.com)
 * [Community](https://www.virtocommerce.org)
-* [Download latest release](https://github.com/VirtoCommerce/vc-module-export/releases/latest)
+* [Download Latest Release](https://github.com/VirtoCommerce/vc-module-export/releases/latest)
 
-# License
-Copyright (c) Virto Solutions LTD. All rights reserved.
+## License
 
-Licensed under the Virto Commerce Open Software License (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at
+Copyright (c) Virto Solutions LTD. All rights reserved.
 
-http://virtocommerce.com/opensourcelicense
+Licensed under the Virto Commerce Open Software License (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at <https://virtocommerce.com/opensourcelicense>.
 
 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.

src/VirtoCommerce.ExportModule.Core/VirtoCommerce.ExportModule.Core.csproj

@@ -1,6 +1,6 @@
 <Project Sdk="Microsoft.NET.Sdk">
   <PropertyGroup>
-    <TargetFramework>net8.0</TargetFramework>
+    <TargetFramework>net10.0</TargetFramework>
     <GenerateDocumentationFile>true</GenerateDocumentationFile>
     <IsPackable>True</IsPackable>
     <noWarn>1591</noWarn>
@@ -13,7 +13,7 @@
     <NoWarn>1701;1702;1705;1591</NoWarn>
   </PropertyGroup>
   <ItemGroup>
-    <PackageReference Include="Microsoft.SourceLink.GitHub" Version="8.0.0" PrivateAssets="All" />
-    <PackageReference Include="VirtoCommerce.Platform.Core" Version="3.917.0" />
+
+    <PackageReference Include="VirtoCommerce.Platform.Core" Version="3.1002.0" />
   </ItemGroup>
 </Project>

src/VirtoCommerce.ExportModule.CsvProvider/VirtoCommerce.ExportModule.CsvProvider.csproj

@@ -1,6 +1,6 @@
 <Project Sdk="Microsoft.NET.Sdk">
   <PropertyGroup>
-    <TargetFramework>net8.0</TargetFramework>
+    <TargetFramework>net10.0</TargetFramework>
     <GenerateDocumentationFile>true</GenerateDocumentationFile>
     <IsPackable>True</IsPackable>
     <noWarn>1591</noWarn>
@@ -10,10 +10,10 @@
     <SymbolPackageFormat>snupkg</SymbolPackageFormat>
   </PropertyGroup>
   <ItemGroup>
-    <PackageReference Include="CsvHelper" Version="33.0.1" />
+    <PackageReference Include="CsvHelper" Version="33.1.0" />
   </ItemGroup>
   <ItemGroup>
-    <PackageReference Include="Microsoft.SourceLink.GitHub" Version="8.0.0" PrivateAssets="All" />
+
     <ProjectReference Include="..\VirtoCommerce.ExportModule.Core\VirtoCommerce.ExportModule.Core.csproj" />
     <ProjectReference Include="..\VirtoCommerce.ExportModule.Data\VirtoCommerce.ExportModule.Data.csproj" />
   </ItemGroup>

src/VirtoCommerce.ExportModule.Data/VirtoCommerce.ExportModule.Data.csproj

@@ -1,6 +1,6 @@
 <Project Sdk="Microsoft.NET.Sdk.Web">
   <PropertyGroup>
-    <TargetFramework>net8.0</TargetFramework>
+    <TargetFramework>net10.0</TargetFramework>
     <GenerateDocumentationFile>true</GenerateDocumentationFile>
     <IsPackable>True</IsPackable>
     <OutputType>Library</OutputType>
@@ -14,8 +14,8 @@
     <NoWarn>1701;1702;1705;1591</NoWarn>
   </PropertyGroup>
   <ItemGroup>
-    <PackageReference Include="Microsoft.SourceLink.GitHub" Version="8.0.0" PrivateAssets="All" />
-    <PackageReference Include="VirtoCommerce.AssetsModule.Core" Version="3.814.0" />
+
+    <PackageReference Include="VirtoCommerce.AssetsModule.Core" Version="3.1000.0" />
     <ProjectReference Include="..\VirtoCommerce.ExportModule.Core\VirtoCommerce.ExportModule.Core.csproj" />
   </ItemGroup>
 </Project>

src/VirtoCommerce.ExportModule.JsonProvider/VirtoCommerce.ExportModule.JsonProvider.csproj

@@ -1,6 +1,6 @@
 <Project Sdk="Microsoft.NET.Sdk">
   <PropertyGroup>
-    <TargetFramework>net8.0</TargetFramework>
+    <TargetFramework>net10.0</TargetFramework>
     <GenerateDocumentationFile>true</GenerateDocumentationFile>
     <IsPackable>True</IsPackable>
     <noWarn>1591</noWarn>
@@ -10,7 +10,7 @@
     <SymbolPackageFormat>snupkg</SymbolPackageFormat>
   </PropertyGroup>
   <ItemGroup>
-    <PackageReference Include="Microsoft.SourceLink.GitHub" Version="8.0.0" PrivateAssets="All" />
+
     <ProjectReference Include="..\VirtoCommerce.ExportModule.Core\VirtoCommerce.ExportModule.Core.csproj" />
   </ItemGroup>
 </Project>

src/VirtoCommerce.ExportModule.Web/VirtoCommerce.ExportModule.Web.csproj

@@ -1,6 +1,6 @@
 <Project Sdk="Microsoft.NET.Sdk.Web">
   <PropertyGroup>
-    <TargetFramework>net8.0</TargetFramework>
+    <TargetFramework>net10.0</TargetFramework>
     <GenerateDocumentationFile>true</GenerateDocumentationFile>
     <IsPackable>False</IsPackable>
     <OutputType>Library</OutputType>
@@ -21,9 +21,9 @@
     <None Remove="node_modules\**" />
   </ItemGroup>
   <ItemGroup>
-    <PackageReference Include="FluentValidation" Version="11.11.0" />
-    <PackageReference Include="Microsoft.AspNetCore.Mvc.NewtonsoftJson" Version="[8.0.11,9)" />
-    <PackageReference Include="VirtoCommerce.Platform.Hangfire" Version="3.917.0" />
+    <PackageReference Include="FluentValidation" Version="12.1.1" />
+    <PackageReference Include="Microsoft.AspNetCore.Mvc.NewtonsoftJson" Version="10.0.1" />
+    <PackageReference Include="VirtoCommerce.Platform.Hangfire" Version="3.1002.0" />
   </ItemGroup>
   <ItemGroup>
     <ProjectReference Include="..\VirtoCommerce.ExportModule.Core\VirtoCommerce.ExportModule.Core.csproj" />

src/VirtoCommerce.ExportModule.Web/module.manifest

@@ -1,12 +1,12 @@
 <?xml version="1.0" encoding="utf-8"?>
 <module xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
   <id>VirtoCommerce.Export</id>
-  <version>3.809.0</version>
+  <version>3.1000.0</version>
   <version-tag />
 
-  <platformVersion>3.917.0</platformVersion>
+  <platformVersion>3.1002.0</platformVersion>
   <dependencies>
-    <dependency id="VirtoCommerce.Assets" version="3.814.0" />
+    <dependency id="VirtoCommerce.Assets" version="3.1000.0" />
   </dependencies>
 
   <title>Generic Export</title>
@@ -20,7 +20,7 @@
   <projectUrl>https://github.com/VirtoCommerce/vc-module-export</projectUrl>
   <iconUrl>Modules/$(VirtoCommerce.Export)/Content/logo.png</iconUrl>
   <requireLicenseAcceptance>false</requireLicenseAcceptance>
-  <copyright>Copyright © 2011-2025 Virto Commerce. All rights reserved</copyright>
+  <copyright>Copyright © 2011-2026 Virto Commerce. All rights reserved</copyright>
   <tags>export</tags>
   <assemblyFile>VirtoCommerce.ExportModule.Web.dll</assemblyFile>
   <moduleType>VirtoCommerce.ExportModule.Web.Module, VirtoCommerce.ExportModule.Web</moduleType>