[DT-3108] Add PUT endpoint to Update FileStorageObject category

[kevinmarete]

Addresses

https://broadworkbench.atlassian.net/browse/DT-3108

Summary

Adds a new endpoint to update the FileCategory of an existing FileStorageObject (PUT /api/{entity}/{entityId}/document/{id}) without requiring file re-upload. The change ensures that only the category is mutable while preserving file content and storage references.

Implements validation for valid and entity-appropriate categories, enforces entity ownership and access control, and prevents updates to soft-deleted or mismatched records. Adds DAO support for updating category metadata (updateUserId, updateDate) and includes Swagger documentation and unit tests for resource and DAO behavior.

---

Have you read CONTRIBUTING.md lately? If not, do that first.

• Label PR with a Jira ticket number and include a link to the ticket
• Label PR with a security risk modifier [no, low, medium, high]
• PR describes scope of changes
• Get a minimum of one thumbs worth of review, preferably two if enough team members are available
• Get PO sign-off for all non-trivial UI or workflow changes
• Verify all tests go green
• Test this change deployed correctly and works on dev environment after deployment

[sonarqubecloud]

Quality Gate passed

Issues
0 New issues
0 Accepted issues

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

See analysis details on SonarQube Cloud

[kevinmarete]

To be implemented in this PR: #2867