mayatnikovandClaude Opus 5
8f67f4aa4d
Сервер: пакет push на webpush-go (третья и последняя прямая зависимость),
подписка устройства, правило ADR-023 «пуш только молчащему устройству и только
один» через атомарный захват push_pending, удаление подписки на 404 и 410,
TTL сутки, urgency normal. В нагрузке только {title, body, chat} — тело
собирается из константы, плейнтекст туда не попадает даже по ошибке.
Клиент: service worker с версионированным кэшем оболочки и никогда — /api/*,
push и notificationclick, подписка на VAPID-ключ сервера, запрос разрешения
после первого отправленного сообщения, разделы настроек «уведомления»
и «установить приложение», баннер установки на iOS.
ADR-045: пуш адресован получателю — по букве ADR-023 он уходил бы и молчащему
устройству отправителя с бессмысленным заголовком из собственного ника.
ADR-047: сервер ходит на endpoint подписки, который выбирает браузер. Проверка
«только https» обходилась редиректом, а имя могло смотреть внутрь сети — теперь
запрет редиректов и проверка разрешённого адреса на уровне сокета.
ADR-048: пределы отправки — недоступный push-сервис одного аккаунта больше
не съедает пуши всего сервера.
ADR-049: явно выключенные уведомления сами не включаются обратно.
Попутно: webpush-go дописывает набивку в переданный срез, а одна нагрузка
уходила всем устройствам сообщения — гонка, пойманная go test -race.
Теперь у каждого задания своя копия.
Приёмка на боевом: подписки, hasPush, чужое устройство, Origin, оболочка
из девяти файлов, Service-Worker-Allowed. Отдельно шесть непубличных адресов
и endpoint на 3 КиБ — все отбиты.
Чеклист ручной проверки на iPhone и Android — в docs/plan.md.
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_015DbCjVfTFq4ZFG8juD45YJ
3.1 KiB
3.1 KiB
ADR-023: Правила пушей и service worker
Кому уходит пуш и тексты уведомления — ADR-045. Адрес перехода, состояния настроек и жизнь подписки на клиенте — ADR-046.
Контекст
ADR-011 задаёт принцип «пуш — сигнал». Не определено, когда именно слать пуш, как он привязан к устройству и что кэширует service worker.
Решение
- Push-подписка принадлежит устройству (
devices.push_subscription). СтавитсяPUT /api/devices/{id}/push, снимаетсяDELETE. - Пуш отправляется при постановке сообщения в очередь устройства, если выполняются оба условия: устройство не подключено по SSE и у устройства не висит неотработанный пуш (
push_pending = 0). После отправкиpush_pending = 1; сбрасывается при подключении SSE. Одно молчащее устройство получает один пуш, не ленту. - Полезная нагрузка:
{title, body: "новое сообщение", chat}—titleэто@nickили#имя комнаты,chat— идентификатор для перехода.TTL24 часа, urgencynormal. Ответы 404/410 от push-сервиса удаляют подписку. - Service worker:
push→showNotificationсtag = chat(новое уведомление заменяет старое в том же чате);notificationclick→ фокус открытого окна или открытие/#/<chat>. - Кэш: stale-while-revalidate для оболочки (
/,/app.css,/manifest.json,/js/*,/icons/*), никогда — для/api/*. Имя кэша содержит версию, версия задаётся константой вsw.jsи меняется при релизе. Сервер отдаёт статику сETagиCache-Control: no-cache. - Разрешение на уведомления запрашивается после первого отправленного сообщения (ADR-011). На iOS вне установленного PWA вместо запроса показывается баннер установки.
Следствия
- Сервер знает только, что у устройства есть что забрать; содержимое в пуше не появляется.
- Пользователь с пятью непрочитанными чатами получает один пуш про первый. Остальное — при открытии. Осознанно.
- Релиз без смены версии в
sw.jsобновит статику только по ETag при следующем revalidate, не мгновенно.