Fix descriptions, add module ID to OpenAPI

[asvishnyakov]

Description

• Fixes API descriptions on platforms with case-sensitive file systems (Linux)
• Properly implements descriptions on tags (tags on operations are strings, i.e. description was omitted from API spec generation)
• Adds x-virtocommerce-module-id extension to operations and tags

P.S. Please test changes in swagger UI in Safari

swagger.json:

{
  "paths": [
    ...
    {
      "delete": {
        "tags": [
          "Catalog"
        ],
        "summary": "Deletes catalog by id",
        "description": "Deletes catalog by id",
        "operationId": "CatalogModuleCatalogs_DeleteCatalog",
        "parameters": [
        ],
        "responses": {
          ...
        },
        "security": [
          ...
        ],
        "x-virtocommerce-module-id": "VirtoCommerce.Catalog"
      },
    }
    ...
  ],
  "tags": [
    ...
    {
      "name": "Catalog",
      "description": "Easily manage your products, categories, variations, and properties",
      "x-virtocommerce-module-id": "VirtoCommerce.Catalog"
    }
    ...
  ]
}

UI:

These changes make OpenAPI json more AI-friendly (and to be honest - human-friendly too :)

References

QA-test:

Jira-link:

Artifact URL:

Image tag:
ghcr.io/VirtoCommerce/platform:3.914.0-pr-2944-453c-api-descriptions-453c6b35

[vc-ci]

Review task created: https://virtocommerce.atlassian.net/browse/VCST-4080

[vc-ci]

Test Suite: Test Suites/Modules/module_Assets
Tests: 13
Failures: 0
Errors: 0
Time: 7.328
Timestamp: 09-10-2025T04:47:50

[vc-ci]

Test Suite: Test Suites/Modules/module_Assets
Tests: 13
Failures: 0
Errors: 0
Time: 7.154
Timestamp: 09-10-2025T04:58:13

[vc-ci]

Test Suite: Test Suites/Modules/module_Assets
Tests: 13
Failures: 0
Errors: 0
Time: 7.581
Timestamp: 09-10-2025T22:21:23

[vc-ci]

Test Suite: Test Suites/Modules/module_Assets
Tests: 13
Failures: 0
Errors: 0
Time: 7.608
Timestamp: 09-10-2025T22:31:05

[vc-ci]

Test Suite: Test Suites/Modules/module_Assets
Tests: 13
Failures: 0
Errors: 0
Time: 8.639
Timestamp: 13-10-2025T10:19:52

[sonarqubecloud]

Quality Gate passed

Issues
0 New issues
0 Accepted issues

Measures
0 Security Hotspots
0.0% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarQube Cloud

[vc-ci]

Test Suite: Test Suites/Modules/module_Assets
Tests: 13
Failures: 0
Errors: 0
Time: 7.539
Timestamp: 30-10-2025T10:29:10