Analytics API: Add support for Option in /analytics [DHIS2-18368]

[d-bernat]

As part of the option set and options feature, we need to change the /analytics API to support the following style of queries related to OptionSet and Option.

The changes are only required for Program Attributes and Program Data Elements, where two new models were created to extend the existing flow and logic.

• Examples of requests enabled with these changes:

http://localhost:8080/dhis/api/analytics?dimension=pe:LAST_10_YEARS&filter=ou:USER_ORGUNIT&dimension=dx:WSGAb5XwJ3Y.QFX1FLWBwtq.l8S7SjnQ58G;WSGAb5XwJ3Y.QFX1FLWBwtq.rexqxNDqUKg;M3xtLkYBlKI.KrCahWFMYYz.dEFhuheLj1A&displayProperty=NAME&includeNumDen=true&skipMeta=false&skipData=false&includeMetadataDetails=true&relativePeriodDate=2025-07-01

http://localhost:8080/dhis/api/analytics?dimension=dx:M3xtLkYBlKI.KrCahWFMYYz.dEFhuheLj1A;M3xtLkYBlKI.KrCahWFMYYz.HrKHCQUSYZh,pe:LAST_10_YEARS&filter=ou:USER_ORGUNIT&displayProperty=NAME&includeNumDen=true&skipMeta=false&skipData=false&relativePeriodDate=2025-07-01

http://localhost:8080/dhis/api/analytics?dimension=pe:LAST_10_YEARS&filter=ou:USER_ORGUNIT&filter=dx:WSGAb5XwJ3Y.QFX1FLWBwtq.l8S7SjnQ58G;WSGAb5XwJ3Y.QFX1FLWBwtq.rexqxNDqUKg&displayProperty=NAME&includeNumDen=true&skipMeta=false&skipData=false&includeMetadataDetails=true&relativePeriodDate=2025-07-01

New analytics end-to-end tests are also included, so we can ensure the new feature is well covered.
The metadata was also modified to accommodate the new dimension.

Finally, very light clean-up and specific refactoring were applied where it made sense, especially to respect our Sonar rules.

[luciano-fiandesio]

Looks good, just left a couple of minor comments.

[luciano-fiandesio]

Does it make sense to add some null checks here (in the constructor), something like:

public ProgramTrackedEntityAttributeOptionDimensionItem(
      Program program, TrackedEntityAttribute attribute, Option option) {
    this.program = Objects.requireNonNull(program, "Program cannot be null");
        this.attribute = Objects.requireNonNull(attribute, "Attribute cannot be null");
        this.option = Objects.requireNonNull(option, "Option cannot be null");
  }

[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