admin
92a03aeafd
页面 / 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（文件内留有警示）。
94 lines
4.0 KiB
SQL
94 lines
4.0 KiB
SQL
-- cdrop MVP schema (PROJECT_BRIEF.md §4)
|
||
-- 以 IF NOT EXISTS 形式由 internal/db/bootstrap.go 启动期单事务执行。
|
||
|
||
CREATE TABLE IF NOT EXISTS devices (
|
||
user_id TEXT NOT NULL,
|
||
name TEXT NOT NULL,
|
||
type TEXT NOT NULL,
|
||
last_seen INTEGER NOT NULL,
|
||
PRIMARY KEY (user_id, name)
|
||
);
|
||
|
||
CREATE TABLE IF NOT EXISTS shortcut_tokens (
|
||
jti TEXT PRIMARY KEY,
|
||
user_id TEXT NOT NULL,
|
||
label TEXT NOT NULL,
|
||
scopes TEXT NOT NULL,
|
||
created_at INTEGER NOT NULL,
|
||
expires_at INTEGER NOT NULL,
|
||
last_used_at INTEGER,
|
||
revoked INTEGER NOT NULL DEFAULT 0
|
||
);
|
||
|
||
CREATE TABLE IF NOT EXISTS transfer_sessions (
|
||
id TEXT PRIMARY KEY,
|
||
user_id TEXT NOT NULL,
|
||
sender_name TEXT NOT NULL,
|
||
receiver_name TEXT NOT NULL,
|
||
state TEXT NOT NULL,
|
||
mode TEXT,
|
||
file_name TEXT NOT NULL,
|
||
file_size INTEGER NOT NULL,
|
||
file_sha256 TEXT,
|
||
bytes_transferred INTEGER NOT NULL DEFAULT 0,
|
||
created_at INTEGER NOT NULL,
|
||
finished_at INTEGER,
|
||
fail_reason TEXT
|
||
);
|
||
|
||
CREATE TABLE IF NOT EXISTS clipboard_state (
|
||
user_id TEXT PRIMARY KEY,
|
||
content_type TEXT NOT NULL,
|
||
content TEXT,
|
||
source_device TEXT,
|
||
updated_at INTEGER NOT NULL,
|
||
-- version 是每用户严格单调递增的版本号（每次写 +1），变更探测 / ETag 用；
|
||
-- updated_at 仍是墙钟（TTL / 展示）。既有库由 bootstrap 的幂等 ALTER 补列。
|
||
version INTEGER NOT NULL DEFAULT 0,
|
||
-- origin_ts 是内容在源设备被复制的时刻（ms）。冲突收敛按它做 LWW——写入仅在
|
||
-- origin_ts 严格大于现存时被接受，故延迟/乱序到达的旧复制不会盖掉新的。
|
||
origin_ts INTEGER NOT NULL DEFAULT 0
|
||
);
|
||
|
||
-- web_sessions：浏览器端「免重登」。cookie 里只放不透明随机串，本表 id 存其
|
||
-- SHA-256，故 DB 单独泄露也换不出可用 cookie；refresh_token 以 AES-256-GCM 落盘
|
||
-- （密钥在容器环境、不在库内）。仅浏览器使用——桌面端 refresh_token 由 Go keyring
|
||
-- 持有、走自有 loopback flow，绝不入此表。device_name 随会话存，使 PWA 存储被清后
|
||
-- 开机仍能恢复本机设备名。
|
||
CREATE TABLE IF NOT EXISTS web_sessions (
|
||
id TEXT PRIMARY KEY,
|
||
user_id TEXT NOT NULL,
|
||
refresh_token TEXT NOT NULL,
|
||
device_name TEXT NOT NULL DEFAULT '',
|
||
user_agent TEXT NOT NULL DEFAULT '',
|
||
created_at INTEGER NOT NULL,
|
||
last_used_at INTEGER NOT NULL,
|
||
expires_at INTEGER NOT NULL
|
||
);
|
||
|
||
CREATE INDEX IF NOT EXISTS idx_web_sessions_expires ON web_sessions (expires_at);
|
||
|
||
-- push_subscriptions：浏览器 / PWA 的 Web Push 订阅端点。当某设备「页面已关闭」
|
||
-- （无活的 SSE 连接）时，服务端按此表向其推送系统通知；页面开着时事件仍走 SSE，
|
||
-- 前端自弹 toast，不触发 push。id 是 SHA-256(endpoint) 的 hex，使同一浏览器重复
|
||
-- 订阅幂等覆盖（endpoint 唯一标识一条推送通道）。p256dh/auth 是 RFC 8291 消息加密
|
||
-- 用的客户端公钥与鉴权密钥（base64url）。按 (user_id, device_name) 定位收件设备，
|
||
-- 与 hub.SendTo 用 device_name 作 deviceID 一致。桌面端不入此表——它走本地原生通知。
|
||
CREATE TABLE IF NOT EXISTS push_subscriptions (
|
||
id TEXT PRIMARY KEY,
|
||
user_id TEXT NOT NULL,
|
||
device_name TEXT NOT NULL,
|
||
endpoint TEXT NOT NULL,
|
||
p256dh TEXT NOT NULL,
|
||
auth TEXT NOT NULL,
|
||
user_agent TEXT NOT NULL DEFAULT '',
|
||
-- locale 随订阅存：推送文案在服务端渲染（SW 只负责展示收到的 title/body），
|
||
-- 故须知道该设备的界面语言；用户切换语言时前端重新订阅会幂等刷新此列。
|
||
locale TEXT NOT NULL DEFAULT 'zh-CN',
|
||
created_at INTEGER NOT NULL,
|
||
last_used_at INTEGER NOT NULL
|
||
);
|
||
|
||
CREATE INDEX IF NOT EXISTS idx_push_subscriptions_user_device
|
||
ON push_subscriptions (user_id, device_name);
|