-- cdrop MVP schema (PROJECT_BRIEF.md §4) -- 以 IF NOT EXISTS 形式由 internal/db/bootstrap.go 启动期单事务执行。 -- devices:cdrop 托管设备(扫码批准 / 原生配对的设备)。device_id 是 cdrop 生成的 -- 稳定不透明 id,作设备身份与「会话↔设备」的 join key——经 broker mint 时作 meta 传入、 -- 由 broker /verify 回显成 X-Auth-Meta。broker_sid 是 broker 返回的会话 id,私存用于 -- 吊销(删设备)。tier=full/guest(冗余缓存,权威在 broker scope)。name 是人类可读 -- 设备名,可重命名而身份不变(device_id 不变)。 CREATE TABLE IF NOT EXISTS devices ( device_id TEXT PRIMARY KEY, user_id TEXT NOT NULL, name TEXT NOT NULL, type TEXT NOT NULL, tier TEXT NOT NULL DEFAULT 'full', broker_sid TEXT NOT NULL DEFAULT '', created_at INTEGER NOT NULL, last_seen INTEGER NOT NULL ); CREATE INDEX IF NOT EXISTS idx_devices_user ON devices (user_id); 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 ); -- 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); -- login_requests:扫码登录的待批准请求(AUTH.md §2.3、§4)。三方密钥分离—— -- poll_secret 存其 SHA-256(新设备私有、QR 不含、领取会话凭它);approval_code 随 QR -- 给批准方。短 TTL(默认 120s),consumed/expired 后不可复用,由 reaper 清理。 CREATE TABLE IF NOT EXISTS login_requests ( id TEXT PRIMARY KEY, poll_secret TEXT NOT NULL, approval_code TEXT NOT NULL, status TEXT NOT NULL, new_device_name TEXT NOT NULL, new_device_type TEXT NOT NULL, user_agent TEXT NOT NULL DEFAULT '', request_ip TEXT NOT NULL DEFAULT '', approver_user_id TEXT NOT NULL DEFAULT '', grant_scope TEXT NOT NULL DEFAULT '', grant_persist TEXT NOT NULL DEFAULT '', created_at INTEGER NOT NULL, expires_at INTEGER NOT NULL, approved_at INTEGER ); CREATE INDEX IF NOT EXISTS idx_login_requests_expires ON login_requests (expires_at);