feat: add push notifications

[aarushtools]

Proposed changes

• add the ability to send push notifications via webpush
• tests for notifications and pages to view notification logs and send a custom one
• adds user push notification preferences and implements sending push notifications on announcements, absences, glance, etc. (eighth waitlist push notification option is implemented in the preferences model but unused)

Brief description of rationale

Many of Ion's current notification features rely on sending emails but people check push notifications more often. This makes the PWA experience more intuitive especially on mobile

Notes

• In production, the VAPID keys (generated via create_vapid_keys.py) should be generated once and never changed, otherwise all push subscriptions will be invalidated and users will have to manually subscribe to push notifications again

Video of it working on windows

Video of it working on iOS

[alanzhu0]

This is great!!! Are you all done or still working on stuff?
One useful notification option to add is when your bus arrives you get sent a notif, and also maybe some text description of where it's parked (e.g. "in front of the curb," "right front row", "left back row"). Maybe those notifs have to be delayed so they aren't sent until the end of the day (4 pm most days, but dynamically calculated for early release). And also maybe a notif that sends at 4 pm "your bus isn't here yet" if it hasn't arrived.

great work!!

[aarushtools]

Everything is done, I'll try adding that feature 👍

[aarushtools]

I added it, here's what it looks like:

and the bus spot id -> string translations:

[coveralls]

coverage: 79.119% (-0.2%) from 79.361%
when pulling 9ca0850 on aarushtools:webpush
into e5e51f2 on tjcsl:dev.

[alanzhu0]

• On mobile, on preferences the subscribe page looks too transparent, can you decrease the opacity there?
• It doesn't work on Edge, right? I can subscribe now actually, but I don't get notified. If that's right, please include a note to the user about that, and also a decent number of people use Edge so getting support for it would be good.
• There's a notification sound on mobile - can you turn off the sound? I don't think people will like that.
• Can you make Django admin interfaces for the webpush-related models?
• Does the bus notification only check at 4 pm right now? Can you do something where if the bus hasn't arrived at 4 pm, send the bus delayed notification you're already doing, then when the bus does arrive send another notification saying so?

[aarushtools]

@alanzhu0 everythings done 👍

[aarushtools]

Idk why it's failing I ran build_docs like 20 times

[aarushtools]

to test:

• APP: Announcements
  • announcement posted sends a push notification when notify option is enabled
    • test if content is truncated when its too long
• APP: Bus
  • push notification sent at dismissal time indicating where your bus is
    • works with different day end times
    • test all possible bus location messages
  • push notification sent at dismissal time indicating if your bus is delayed or not
    • works with different day end times
  • push notification sent when delayed bus arrives
    • works with different day end times
  • push notification sent to users with bus mentioned in bus announcement
    • test different counties
• APP: Eighth
  • push notification sent to student when an activity they signed up for is cancelled
  • push notification sent to student when they get an absence
    • cron
    • admin command
  • push reminder notification to sign up 40 mins prior to blocks locking.
    • works with different signup lock times
  • test glance notification
    • works with multiple blocks (2+)
• APP: Polls
  • test notification sent when a poll is created (and the notify option is selected)
• APP: Notifications
  • test post notification
    • content is truncated?
    • works on individual user(s)
    • works on group(s)
    • works on everyone
  • test notification logs
  • test rescheduling of notifications
• Other:
  • Docker:
    • test vapid keys generated on containers creation
  • JS:
    • test silent notifications option, per device
    • test with different browsers to see if it can detect supported/unsupported accurately
      • ios 16.4+ (safari)
      • chrome
      • opera
      • macos 16+ (safari)
      • firefox
      • edge (confirm that it says the browser is unsupported)