Expose station entrances in GraphQL API

[cedarbaum]

Summary

This change exposes GTFS station entrances via the GraphQL API. It provides a new top-level entrances query which returns all station entrances as well as a new entrances subquery of the stations query which returns all entrances associated with a station.

Top-level query

entrances() {
  gtfsId
  lat
  lon
  name
  vehicleMode
  locationType
}

stations subquery

stations {
  gtfsId
  lat
  lon
  name
  stops {
    ...
  }
  entrances {
    gtfsId
    lat
    lon
    name
    vehicleMode
    locationType
  }
}

Issue

This is a proposed change as part of issue #6081. Further discussion of the implementation and API are still pending as part of this issue, but this PR hopefully will provide additional context. It is possible this PR will evolve significantly with this issue - if it makes more sense to make it a draft, I can do so.

Unit tests

• Unit tests were added for associating Entrance objects with their parent station
• GraphQL integration tests were added for the new queries.

Documentation

• Documentation for new GraphQL queries has been added.

[codecov]

Codecov Report

Attention: Patch coverage is 66.95652% with 38 lines in your changes missing coverage. Please review.

Project coverage is 69.81%. Comparing base (b108104) to head (a829afb).

Files with missing lines	Patch %	Lines
...entripplanner/apis/gtfs/datafetchers/StopImpl.java	45.90%	32 Missing and 1 partial ⚠️
...ntripplanner/apis/gtfs/generated/GraphQLTypes.java	54.54%	4 Missing and 1 partial ⚠️

Additional details and impacted files

@@              Coverage Diff              @@
##             dev-2.x    #6082      +/-   ##
=============================================
+ Coverage      69.78%   69.81%   +0.02%     
- Complexity     17357    17400      +43     
=============================================
  Files           1962     1962              
  Lines          74357    74450      +93     
  Branches        7623     7629       +6     
=============================================
+ Hits           51893    51978      +85     
- Misses         19820    19823       +3     
- Partials        2644     2649       +5     

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

[leonardehrenfried]

We need to harmonise our approaches as #6076 does something similar.

[optionsome]

@HenrikSundell will do implement a entrance type to the graphql schema in a different pr soon-ish, and you can then use that type for the entrances in this pr instead of using the stop type.

[cedarbaum]

Thanks for the update @optionsome! Are we all aligned on returning both OSM and GTFS provided entrances in a common type? If so, it sounds like the remaining work on this PR will be to integrate with the OSM entrance data.

@HenrikSundell please let me know if there is anything I can do to help or if you want to chat about synchronizing our changes.

[optionsome]

Are we all aligned on returning both OSM and GTFS provided entrances in a common type? If so, it sounds like the remaining work on this PR will be to integrate with the OSM entrance data.

Yes you are correct, we will use same type for both.