feat: REGISTRATION_OU for events and enrollments (DHIS2-21980)

[luciano-fiandesio]

Summary

REGISTRATION_OU becomes a new org-unit dimension and filter on all four
tracker-analytics endpoints (/analytics/events/query, /analytics/events/aggregate,
/analytics/enrollments/query, /analytics/enrollments/aggregate), so clients can select or group by the org unit where the tracked entity was registered.

The implementation resolves request items through the existing ou dimension pipeline
(USER_ORGUNIT*, LEVEL-n, OU_GROUP-uid all work), stores them in dedicated EventQueryParams fields, and produce SQL against a second, independently aliased join of analytics_rs_orgunitstructure (regous, next to ous and enrl). Matching is always at or below, aggregate always return one row per requested org unit.

Files to review

• RegistrationOuSqlFragments.java contains SQL builders: join, uidlevelN predicate, uid/name projections.
• RegistrationOuSqlCoordinator.java orchestrates join/where/select for both analytics types;
• RegistrationOuSqlConstants.java contains alias regous, struct table, DIMENSION_NAME.
• EventQueryParams.java New fields + hasRegistrationOuDimension() ,hasRegistrationOuRestriction(),hasRegistrationOuAggregateColumn().
• DefaultEventDataQueryService.java main logic for resolving the Registration ou resolveRegistrationOu
• ColumnHeader, HeaderHelper, MetadataItemsHandler.java Grid response management

[codecov]

Codecov Report

❌ Patch coverage is 93.89671% with 13 lines in your changes missing coverage. Please review.
✅ Project coverage is 65.19%. Comparing base (4e91191) to head (be339fb).
⚠️ Report is 1 commits behind head on master.

Files with missing lines	Patch %	Lines
...ytics/event/data/DefaultEventDataQueryService.java	80.95%	4 Missing and 4 partials ⚠️
...a/registrationou/RegistrationOuSqlCoordinator.java	93.47%	1 Missing and 2 partials ⚠️
.../org/hisp/dhis/analytics/tracker/HeaderHelper.java	95.45%	1 Missing ⚠️
...p/dhis/analytics/tracker/MetadataItemsHandler.java	94.44%	0 Missing and 1 partial ⚠️

Additional details and impacted files

@@              Coverage Diff              @@
##             master   #24971       +/-   ##
=============================================
+ Coverage     28.05%   65.19%   +37.13%     
- Complexity      149      688      +539     
=============================================
  Files          3742     3744        +2     
  Lines        145824   146027      +203     
  Branches      16979    17001       +22     
=============================================
+ Hits          40917    95196    +54279     
+ Misses       100787    43079    -57708     
- Partials       4120     7752     +3632     

Flag	Coverage Δ
integration	42.19% <24.88%> (?)
integration-h2	28.05% <22.53%> (-0.01%)	⬇️
unit	36.48% <93.42%> (?)

Flags with carried forward coverage won't be shown. Click here to find out more.

Files with missing lines	Coverage Δ
.../hisp/dhis/eventvisualization/SimpleDimension.java	100.00% <100.00%> (+5.12%)	⬆️
...rc/main/java/org/hisp/dhis/feedback/ErrorCode.java	99.29% <100.00%> (+0.18%)	⬆️
...rg/hisp/dhis/analytics/event/EventQueryParams.java	73.67% <100.00%> (+42.06%)	⬆️
.../event/data/AbstractJdbcEventAnalyticsManager.java	69.99% <100.00%> (+60.61%)	⬆️
...his/analytics/event/data/AggregatedRowBuilder.java	82.92% <100.00%> (+82.92%)	⬆️
...alytics/event/data/DefaultEventQueryValidator.java	62.35% <100.00%> (+53.96%)	⬆️
...is/analytics/event/data/EventAggregateService.java	66.40% <100.00%> (+64.81%)	⬆️
...ics/event/data/JdbcEnrollmentAnalyticsManager.java	74.89% <100.00%> (+61.67%)	⬆️
...nalytics/event/data/JdbcEventAnalyticsManager.java	67.82% <100.00%> (+66.20%)	⬆️
...ata/registrationou/RegistrationOuSqlFragments.java	100.00% <100.00%> (ø)
... and 6 more

... and 2119 files with indirect coverage changes

---

Continue to review full report in Codecov by Harness.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update 1582037...be339fb. Read the comment docs.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

[github-actions]

Instance deployed to https://dev.im.dhis2.org/pr-24971

[sonarqubecloud]

Quality Gate passed

Issues
0 New issues
3 Accepted issues

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

See analysis details on SonarQube Cloud