refactor: bump all management API endpoints to v3

[paullatzelsperger]

What this PR changes/adds

This PR bumps the latest version of all Management API endpoints to /v3, and it deprecates the old endpoints/controllers. It also adds unique operationId entries to avoid clashes.

each API version (interface + controller) is in its own Java package, with common base classes wherever feasible, to avoid duplicated code as much as possible.

Why it does that

one consistent management API version.

Further notes

• there are no functional changes, only moving around files
• some APIs are bumped from /v1 to /v3 without a /v2 in between, which not ideal, but its not avoidable
• there potentially may be an option to do this more elegantly with path multiplexing with an interceptor ([Spike] Management API: investigate path multiplexing mechanisms #4183, Management API: implement path multiplexing #4184), but that would come in a subsequent PR
• some API operations already had operationIds set - those were changed to reflect the API versions, which is a BREAKING CHANGE

Linked Issue(s)

Closes #4208

Please be sure to take a look at the contributing guidelines and our etiquette for pull requests.

[codecov-commenter]

Codecov Report

Attention: Patch coverage is 85.29412% with 20 lines in your changes are missing coverage. Please review.

Project coverage is 75.32%. Comparing base (7f20ba5) to head (4977a3f).
Report is 273 commits behind head on main.

Files	Patch %	Lines
...ement/transferprocess/v2/TransferProcessApiV2.java	0.00%	5 Missing ⚠️
...lplane/api/management/catalog/v2/CatalogApiV2.java	0.00%	4 Missing ⚠️
...ntractnegotiation/v2/ContractNegotiationApiV2.java	0.00%	3 Missing ⚠️
...contractdefinition/v2/ContractDefinitionApiV2.java	0.00%	2 Missing ⚠️
...pi/management/policy/v2/PolicyDefinitionApiV2.java	0.00%	2 Missing ⚠️
...nnector/api/management/secret/v1/SecretsApiV1.java	0.00%	2 Missing ⚠️
...src/main/java/org/eclipse/edc/api/ApiWarnings.java	0.00%	1 Missing ⚠️
...trolplane/api/management/edr/v1/EdrCacheApiV1.java	0.00%	1 Missing ⚠️

❗ Your organization needs to install the Codecov GitHub app to enable full functionality.

Additional details and impacted files

@@            Coverage Diff             @@
##             main    #4211      +/-   ##
==========================================
+ Coverage   71.74%   75.32%   +3.58%     
==========================================
  Files         919     1039     +120     
  Lines       18457    20668    +2211     
  Branches     1037     1151     +114     
==========================================
+ Hits        13242    15569    +2327     
+ Misses       4756     4587     -169     
- Partials      459      512      +53     

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.