Filter routes and patterns by service date in GTFS GraphQL API

[leonardehrenfried]

Summary

TriMet has requested to be able to filter routes and their patterns based on the service dates that the operate on to only display those from the current week. The request is fleshed out in more details in #4879.

This makes the Date scalar implementation from the Transmodel API into a general one used by both APIs. Since the GTFS API also accepts dates in other places in yyyyMMdd format this would also become possible in the Transmodel API. Is this a problem?

Issue

#4879

Unit tests

Lots added.

Documentation

Javadoc and GraphQL docs.

cc @miles-grant-ibigroup @fpurcell

[codecov]

Codecov Report

Attention: Patch coverage is 78.94737% with 16 lines in your changes missing coverage. Please review.

Project coverage is 69.65%. Comparing base (2a5c8be) to head (3cf6130).
Report is 196 commits behind head on dev-2.x.

Files	Patch %	Lines
...ntripplanner/apis/gtfs/generated/GraphQLTypes.java	54.54%	9 Missing and 1 partial ⚠️
...pplanner/apis/gtfs/datafetchers/QueryTypeImpl.java	0.00%	1 Missing and 1 partial ⚠️
...ntripplanner/apis/gtfs/datafetchers/RouteImpl.java	75.00%	1 Missing and 1 partial ⚠️
...ner/apis/gtfs/support/time/LocalDateRangeUtil.java	66.66%	1 Missing ⚠️
...er/framework/graphql/scalar/DateScalarFactory.java	85.71%	1 Missing ⚠️

Additional details and impacted files

@@              Coverage Diff              @@
##             dev-2.x    #5869      +/-   ##
=============================================
+ Coverage      69.45%   69.65%   +0.20%     
- Complexity     17070    17195     +125     
=============================================
  Files           1937     1946       +9     
  Lines          73692    73866     +174     
  Branches        7540     7562      +22     
=============================================
+ Hits           51184    51453     +269     
+ Misses         19880    19782      -98     
- Partials        2628     2631       +3     

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

[t2gran]

See my comments in #4879

[leonardehrenfried]

Note to self: clarify docs on service date.

[fpurcell]

BTW @leonardehrenfried and @miles-grant-ibigroup ... so looking forward to this fix, as the OTP-RR and Calltaker apps are really broken (and will continue to be until October) in terms of future versions of routes and stops showing up: https://rtp.trimet.org/rtp/#/route.

TriMet has a lot of changes coming in the September service change (https://trimet.org/betterbus/servicechanges-fy25proposed.htm#proposedchanges). That data is now in TriMet's gtfs.zip. Without a date filter, all of this junk is showing up and making for a confusing experience when viewing routes and stops that are not currently active.

[leonardehrenfried]

@fpurcell Since many developers from Europe are on holiday these days it will be a little longer until we will have finished the review. If you are keen to have it beforehand (and @miles-grant-ibigroup has capacity) we can supply you with a preview version of it.

[fpurcell]

Thanks Leonard ... no rush on my end, especially since the new call taker app is not yet in the hands of end-users. Just pointing out that these fixes will eliminate a lot of confusion in today's system.