#+title: hutch-notify

* what
backend for push notifications in hutch.

* does
- register apns device tokens
- store notification subscriptions
- poll sr.ht for changes
- send pushes via apns

* stack
python (fastapi), sqlite, apns (http/2, token auth).

* status
early development. current scope: device registration and a test
push endpoint. planned: build, ticket, and inbox notifications.

* run
#+begin_src sh
python3.12 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
uvicorn app.main:app --reload
#+end_src

* env
create .env:

#+begin_src conf
API_KEY=change-me
DATABASE_URL=sqlite+aiosqlite:///./hutch_notify.db
APNS_KEY_ID=
APNS_TEAM_ID=
APNS_BUNDLE_ID=
APNS_PRIVATE_KEY_PATH=
SRHT_TOKEN=
#+end_src

* notes
- the ios app registers with apns and sends its token here.
- keep the apns .p8 key secure.
- event-driven eventually; the first version polls.