推送通知：Web Push（网页 / PWA）+ 桌面原生通知

页面 / PWA 关闭、或桌面窗口非前台时，收到文件、消息、传输完成 / 失败以系统通知提醒。判定统一为「页面打开走应用内提示，否则系统通知」，三端各自落地；网页端的判定直接复用 Hub.SendTo 的投递结果，零额外状态。 - Web Push（VAPID，账号无关）：服务端 internal/push.Sender 在事件未经 SSE 投递到目标设备时（即该设备页面已关）发推送，文案按订阅 locale 在服务端渲染（中简 / 中繁 / 英）、 404 / 410 自动清理死订阅；新增 push_subscriptions 表（含 locale，主键为 endpoint 的 SHA-256 以幂等 upsert）+ /api/push/{vapid-key, subscribe POST/DELETE} 端点 - 事件挂接：transfer:incoming / message（离线返 202，文本随推送送达）/ transfer:state DONE|FAILED，均未投递才推 - 配置 CDROP_VAPID_PUBLIC_KEY / CDROP_VAPID_PRIVATE_KEY（半对即拒启动，都空则推送惰性关闭）+ just vapid-keygen 生成工具（cmd/vapidgen） - 前端：service worker 加 push / notificationclick（仍不拦截 /api 与导航）；net/push.ts 订阅管理 + push store slice + 设置页「推送通知」面板（仅浏览器 / PWA）；登录后 resyncPush 把既有订阅重新登记到当前用户，换用户 / endpoint 轮换 / 切换语言皆自愈 - 桌面原生通知：platform/notify_{darwin,windows,other}.go + notify_darwin.m，仅窗口非前台时弹原生通知（macOS UNUserNotificationCenter，未签名时安全空操作、待签名后显示； Windows go-toast 即用）；app.go ShowNotification 绑定，前端 notifyNativeIfBackground 复用 hub 事件分发 + 客户端本地化 - 文档：README / .env.example / compose 模板补 CDROP_VAPID_* 配置注：sqlc v1.31.1 对 query 文件里的多字节字符会错位偏移、生成损坏 SQL，故 query 注释保持纯 ASCII（文件内留有警示）。
2026-06-18 16:56:47 +08:00
parent e903b03afe
commit 92a03aeafd
40 changed files with 1579 additions and 13 deletions
@@ -0,0 +1,146 @@
+// Code generated by sqlc. DO NOT EDIT.
+// versions:
+//   sqlc v1.31.1
+// source: push_subscriptions.sql
+
+package db
+
+import (
+	"context"
+)
+
+const deletePushSubscription = `-- name: DeletePushSubscription :exec
+DELETE FROM push_subscriptions
+WHERE id = ?
+`
+
+func (q *Queries) DeletePushSubscription(ctx context.Context, id string) error {
+	_, err := q.db.ExecContext(ctx, deletePushSubscription, id)
+	return err
+}
+
+const deletePushSubscriptionsByUserDevice = `-- name: DeletePushSubscriptionsByUserDevice :exec
+DELETE FROM push_subscriptions
+WHERE user_id = ? AND device_name = ?
+`
+
+type DeletePushSubscriptionsByUserDeviceParams struct {
+	UserID     string `json:"user_id"`
+	DeviceName string `json:"device_name"`
+}
+
+func (q *Queries) DeletePushSubscriptionsByUserDevice(ctx context.Context, arg DeletePushSubscriptionsByUserDeviceParams) error {
+	_, err := q.db.ExecContext(ctx, deletePushSubscriptionsByUserDevice, arg.UserID, arg.DeviceName)
+	return err
+}
+
+const listPushSubscriptionsByUserDevice = `-- name: ListPushSubscriptionsByUserDevice :many
+SELECT id, user_id, device_name, endpoint, p256dh, auth, user_agent, locale, created_at, last_used_at
+FROM push_subscriptions
+WHERE user_id = ? AND device_name = ?
+`
+
+type ListPushSubscriptionsByUserDeviceParams struct {
+	UserID     string `json:"user_id"`
+	DeviceName string `json:"device_name"`
+}
+
+func (q *Queries) ListPushSubscriptionsByUserDevice(ctx context.Context, arg ListPushSubscriptionsByUserDeviceParams) ([]PushSubscription, error) {
+	rows, err := q.db.QueryContext(ctx, listPushSubscriptionsByUserDevice, arg.UserID, arg.DeviceName)
+	if err != nil {
+		return nil, err
+	}
+	defer rows.Close()
+	var items []PushSubscription
+	for rows.Next() {
+		var i PushSubscription
+		if err := rows.Scan(
+			&i.ID,
+			&i.UserID,
+			&i.DeviceName,
+			&i.Endpoint,
+			&i.P256dh,
+			&i.Auth,
+			&i.UserAgent,
+			&i.Locale,
+			&i.CreatedAt,
+			&i.LastUsedAt,
+		); err != nil {
+			return nil, err
+		}
+		items = append(items, i)
+	}
+	if err := rows.Close(); err != nil {
+		return nil, err
+	}
+	if err := rows.Err(); err != nil {
+		return nil, err
+	}
+	return items, nil
+}
+
+const touchPushSubscription = `-- name: TouchPushSubscription :exec
+UPDATE push_subscriptions
+SET last_used_at = ?
+WHERE id = ?
+`
+
+type TouchPushSubscriptionParams struct {
+	LastUsedAt int64  `json:"last_used_at"`
+	ID         string `json:"id"`
+}
+
+func (q *Queries) TouchPushSubscription(ctx context.Context, arg TouchPushSubscriptionParams) error {
+	_, err := q.db.ExecContext(ctx, touchPushSubscription, arg.LastUsedAt, arg.ID)
+	return err
+}
+
+const upsertPushSubscription = `-- name: UpsertPushSubscription :exec
+
+INSERT INTO push_subscriptions (id, user_id, device_name, endpoint, p256dh, auth, user_agent, locale, created_at, last_used_at)
+VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+ON CONFLICT(id) DO UPDATE SET
+    user_id      = excluded.user_id,
+    device_name  = excluded.device_name,
+    p256dh       = excluded.p256dh,
+    auth         = excluded.auth,
+    user_agent   = excluded.user_agent,
+    locale       = excluded.locale,
+    last_used_at = excluded.last_used_at
+`
+
+type UpsertPushSubscriptionParams struct {
+	ID         string `json:"id"`
+	UserID     string `json:"user_id"`
+	DeviceName string `json:"device_name"`
+	Endpoint   string `json:"endpoint"`
+	P256dh     string `json:"p256dh"`
+	Auth       string `json:"auth"`
+	UserAgent  string `json:"user_agent"`
+	Locale     string `json:"locale"`
+	CreatedAt  int64  `json:"created_at"`
+	LastUsedAt int64  `json:"last_used_at"`
+}
+
+// push_subscriptions: Web Push endpoints for browsers / PWAs. id is the hex
+// SHA-256 of the endpoint, so a re-subscribe from the same browser upserts in
+// place rather than piling up duplicate rows. Lookups are by (user_id,
+// device_name): the receiving device of a notify-worthy event. Dead endpoints
+// (push service returns 404/410) are pruned by DeletePushSubscription.
+// NOTE: keep this file pure ASCII; sqlc v1.31.1 drifts byte offsets on
+// multibyte runes in query files, corrupting the generated SQL.
+func (q *Queries) UpsertPushSubscription(ctx context.Context, arg UpsertPushSubscriptionParams) error {
+	_, err := q.db.ExecContext(ctx, upsertPushSubscription,
+		arg.ID,
+		arg.UserID,
+		arg.DeviceName,
+		arg.Endpoint,
+		arg.P256dh,
+		arg.Auth,
+		arg.UserAgent,
+		arg.Locale,
+		arg.CreatedAt,
+		arg.LastUsedAt,
+	)
+	return err
+}