[katerina20]

Part of updating the SDK to the current Crowdin API docs. This PR covers the Reports API.

Fixes

• Report archive URLs:
  • downloadReportArchive built reports/archives{archiveId}/… with the slash missing, so it always failed.
  • listReportArchives used a trailing slash (reports/archives/).
  • The test mocks had copied the wrong URLs; they now use the documented ones.
• Group report requests:
  • GroupQaCheckIssuesGenerateReportRequest, GroupTaskUsageGenerateReportRequest and GroupTranslationActivityGenerateReportRequest extended the project request base. They could not be passed to generateGroupReport or generateOrganizationReport.
  • Matching schemas now live in GenerateGroupReportRequest, and the old classes are deprecated.
  • Group task usage taskType is now sent as the documented typeTasks.
• Javadoc:
  • deleteReportSettingsTemplate and checkReportArchiveExportStatus now link the right operations.
  • The project settings-template methods link Crowdin only, because Enterprise has no such route.

New report types

• Project reports:
  • TimeSpentGenerateReportRequest (time-spent).
  • TaskUsageGenerateReportRequest (task-usage, Enterprise), with workload, created-vs-resolved, performance, time and cost variants.
• Group/organization reports, new schemas in GenerateGroupReportRequest:
  • source content updates
  • time spent
  • pre-translate accuracy (general and by task)
  • translator accuracy
  • saving activity
  • translation costs by task
  • QA check issues
  • translation activity
  • task usage

New fields

• Existing project report schemas:
  • matchScoreCategories, skipArchiving.
  • The file/directory/branch/label filters, taskIds, userIds.
  • useCategoryBasedProofreadRates, useTmEditDistance.
  • Saving activity mode.
• Settings templates (project, user, organization):
  • baseRates, netRateSchemes, calculateInternalMatches, includePreTranslatedStrings, useCategoryBasedProofreadRates, useTmEditDistance.
  • Hourly rates.
• Enums: Unit.HOURS, Currency.DDK/PLN, GroupingParameter.PROJECT.
• Archives:
  • ReportArchive.status/progress.
  • New overload listReportArchives(userId, ListReportArchivesParams) with scopeType, scopeId, userId, taskId, name, dateFrom, dateTo.

Deprecated (still working)

• postEditingCategories: use matchScoreCategories.
• taskId in the costs by-task schemas: use taskIds.
• excludeApprovalsForEditedTranslations and preTranslatedStringsCategorizationAdjustment: deprecated in the API.
• GroupTopMembersSchema.groupBy: not part of the API.
• ReportSettingsTemplate.Config.regularRates, RegularRate and Mode: use baseRates/netRateSchemes.

Backward compatibility

• Signatures: no public method, field or class was removed, renamed or retyped.
• Behaviour corrections:
  • The archive URLs above.
  • GroupTaskUsageGenerateReportRequest.Schema.setTaskType(x) now sends "typeTasks" instead of "taskType".
• New enum constants: exhaustive switch statements over Unit, Currency and GroupingParameter will see new values.

Open questions for review

Both questions were resolved after merge in #425:

1. MatchType: Match now keeps the raw matchType string (matchTypeValue), so any documented range (100-82, 100-74, …) is sent and read without loss. The enum accessors are unchanged.
2. Deprecated fields: the deprecated fields introduced here (postEditingCategories in the new group accuracy schemas; excludeApprovalsForEditedTranslations/preTranslatedStringsCategorizationAdjustment in the group costs by-task schema and ReportSettingsTemplate.Config) were removed. They were never part of a release.

Testing

• ./gradlew build: 661 tests, 0 failures, on both JDK 17 and JDK 8.
• ./gradlew javadoc on JDK 8: no errors.
• New mock tests and fixtures cover:
  • every new project and group report type;
  • the corrected archive URLs and the archive list overload (Crowdin and Enterprise paths);
  • hourly and post-editing settings templates;
  • the typeTasks request JSON;
  • the new ReportArchive fields.

🤖 Generated with Claude Code