Rebuild the arrival notifications/reminder feature using the Obaco backend

[aaronbrethorst]

The iOS app has its own custom arrival notification/reminder feature that was built using a backend service hosted at onebusaway.co (source code can be found here: https://github.com/onebusaway/onebusaway-deep-links). These systems are pretty straightforward in their design and implementation:

1. In the iOS app, the user requests an alert when their bus is X minutes away
2. If the user has not previously granted push notification permission, they are prompted to do so, and their push notification credentials are established with OneSignal, the service we use for push notifications
3. The iOS app makes a POST to https://onebusaway.co/api/v1/regions/:region_id/alarms (Obaco) with some POST body params representing the alarm
4. The Obaco server adds the new alarm to a database table of alarms, which it polls the relevant server for details about once per minute
5. If an alarm's conditions are met (i.e. it's time to fire the alarm), the Obaco server makes an API call to OneSignal, which in turn sends a push notification to the iOS app.
6. Tapping on the push notification displays the relevant stop information

We'll essentially replicate this setup on Android.

Screenshots and videos

Creating the alarm

Part.1.MP4

receiving the alarm

Other screenshots

Relevant iOS source code

• API Service: https://github.com/OneBusAway/onebusaway-ios/blob/main/OBAKitCore/Network/ObacoAPIService.swift#L109
• model code: https://github.com/OneBusAway/onebusaway-ios/blob/main/OBAKitCore/Models/Obaco/Alarm.swift
• push body model code: https://github.com/OneBusAway/onebusaway-ios/blob/main/OBAKit/PushNotifications/AlarmPushBody.swift

Related issues

Fixing this would render the following issues moot: (i.e. they could be closed)

• Improve reminder notification implementation #493
• Ghost notification "Updating reminders" #977
• Arrival notification stalls after about 25 minutes #1040
• User reported bug: "Updating your reminders" notification pops up from time to time #1183
• ForegroundServiceStartNotAllowedException on boot on some Android 12 devices #1090
• Reminders don't trigger/update unless app is opened #558

Tasks

• Update BUILD.md to include the configuration steps for the OneSignal SDK.