Location Hierarchy endpoint lineage ids enhancement and refactor ✨

[ndegwamartin]

IMPORTANT: Where possible all PRs must be linked to a Github issue

Resolves #112
Resolves #113

Engineer Checklist

• I have written Unit tests for any new feature(s) and edge cases for
  bug fixes
• I have added documentation for any new feature(s) and configuration
  option(s) on the README.md
• I have run mvn spotless:check to check my code follows the project's
  style guide
• I have run mvn clean test jacoco:report to confirm the coverage report
  was generated at plugins/target/site/jacoco/index.html
• I ran mvn clean package right before creating this pull request.

[codecov]

Codecov Report

Attention: Patch coverage is 52.71318% with 61 lines in your changes missing coverage. Please review.

Project coverage is 63.52%. Comparing base (5eac4bd) to head (28c1b36).
Report is 9 commits behind head on main.

Files with missing lines	Patch %	Lines
.../fhir/gateway/plugins/PermissionAccessChecker.java	0.00%	32 Missing ⚠️
...teway/plugins/LocationHierarchyEndpointHelper.java	69.47%	19 Missing and 10 partials ⚠️

Additional details and impacted files

@@             Coverage Diff              @@
##               main     #118      +/-   ##
============================================
+ Coverage     63.13%   63.52%   +0.38%     
- Complexity      224      235      +11     
============================================
  Files            16       16              
  Lines          1492     1601     +109     
  Branches        173      199      +26     
============================================
+ Hits            942     1017      +75     
- Misses          461      483      +22     
- Partials         89      101      +12     

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