Этап 4: PWA и пуши — service worker, Web Push с VAPID, баннер установки

Сервер: пакет 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

docs/plan.md

@@ -32,6 +32,8 @@ web/
   js/api.js                      fetch-обёртки, SSE, ACK
   js/crypto.js                   всё из crypto.md
   js/db.js                       IndexedDB из storage.md
+  js/sync.js                     устройство, поток событий, приём и отправка
+  js/pwa.js                      service worker, подписка на пуши, установка
   js/ulid.js                     ULID
   js/ui/*.js                     экраны из ui.md
   js/export.js                   .bare
@@ -84,6 +86,30 @@ Go — последняя стабильная версия, маршрутиз
 
 Готово, когда закрытое PWA на iPhone и Android получает пуш и открывается на нужном чате; повторные сообщения до открытия пуш не порождают.
 
+### Чеклист ручной проверки на устройствах
+
+Автоматически проверено всё, что проверяется без настоящих устройств: правило «одно
+молчащее устройство — один пуш», сброс `push_pending` при подключении SSE, удаление
+подписки на 404/410, расшифровка пуша по RFC 8291 в тесте, отсутствие плейнтекста
+в нагрузке, кэш оболочки без `/api/*`, отказ ходить на непубличные адреса. Осталось
+то, что требует рук и телефона:
+
+- [ ] **iPhone, установленное на «Домой» приложение**: пуш приходит при закрытом
+      приложении, нажатие открывает нужный чат.
+- [ ] **Android Chrome, закрытое приложение**: то же самое.
+- [ ] **Клик по системному уведомлению** в обоих случаях: в уже открытое окно
+      (фокус и переход) и при закрытом приложении (`/#/dm/<nick>`, `/#/room/<id>`).
+- [ ] **Повторные сообщения до открытия**: второе и третье пуша не порождают.
+- [ ] **iOS вне PWA**: баннер установки над списком чатов, текст, крестик и то,
+      что он больше не появляется; в настройках «уведомления» — текст про установку
+      вместо кнопки.
+- [ ] **`beforeinstallprompt`** в обычном Chrome: раздел «установить приложение»
+      появляется, после нажатия исчезает целиком.
+- [ ] **Системный запрос разрешения** после первого отправленного сообщения:
+      headless-Chrome отвечает `denied` сам, живой диалог не проверялся.
+- [ ] **Прогон сценариев «готово, когда»** этапов 1–5 в Safari (iOS и десктоп)
+      и Firefox — автоматика гоняла только Chrome.
+
 ## Этап 5 — история
 
 - Экспорт и импорт `.bare` по `crypto.md` и `storage.md`; идемпотентность; «архив создан другим аккаунтом».