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（文件内留有警示）。
41 lines
2.0 KiB
Bash
41 lines
2.0 KiB
Bash
# dev 模式（本机开发，brief 实施原则 5）
|
||
# 二者必须同时设置；后端启动期校验，缺一即 panic
|
||
CDROP_AUTH_MODE=dev
|
||
CDROP_DEV_TOKEN=replace-with-32-byte-random-base64
|
||
|
||
# prod 模式所需（填入你的 OIDC provider，如自建 Casdoor / Keycloak）
|
||
# CDROP_AUTH_MODE=prod
|
||
# CDROP_OIDC_AUTHORIZE_URL=https://your-idp.example/login/oauth/authorize
|
||
# CDROP_OIDC_TOKEN_URL=https://your-idp.example/api/login/oauth/access_token
|
||
# CDROP_OIDC_JWKS_URL=https://your-idp.example/.well-known/jwks
|
||
# CDROP_OIDC_ISSUER=https://your-idp.example/
|
||
# prod 强制非空：填你的 OAuth client_id（多值逗号分隔，web + 桌面端共用时填同一个）
|
||
# CDROP_OIDC_AUDIENCE=your-client-id
|
||
# CDROP_OIDC_CLIENT_ID=your-client-id
|
||
# CDROP_OIDC_REDIRECT_URI=https://your-domain.example/oauth/callback
|
||
# CDROP_OIDC_SCOPES=openid profile email
|
||
# prod 强制非空：浏览器免重登会话的 refresh_token 落盘加密密钥（任意长度高熵串，
|
||
# 内部 SHA-256 派生为 32 字节 AES-256 密钥）。留空则 prod 启动期校验失败、拒启动。
|
||
# CDROP_SESSION_SECRET=
|
||
# CDROP_HS256_SECRET=
|
||
# CDROP_TURN_URL=stun:your-stun.example:3478
|
||
|
||
# 可选：Web Push（VAPID）推送通知。用 `just vapid-keygen` 生成一对密钥；二者须同时
|
||
# 设置（半对即启动期校验失败），都留空则推送惰性关闭、不阻塞启动。生成后固定不变
|
||
# ——更换会使所有既有浏览器订阅失效。
|
||
# CDROP_VAPID_PUBLIC_KEY=
|
||
# CDROP_VAPID_PRIVATE_KEY=
|
||
# CDROP_VAPID_SUBJECT=mailto:you@your-domain.example
|
||
|
||
# 通用
|
||
CDROP_DB_PATH=./cdrop.db
|
||
CDROP_LISTEN=:8080
|
||
# Device row max age (sliding via auth-middleware UPSERT and SSE keepalive).
|
||
# Bound by brief §2 refresh_token sliding window (196h ≈ 8 days). Default 196.
|
||
CDROP_DEVICE_TTL_HOURS=196
|
||
|
||
# Cloudflare Realtime TURN（可选；不配则 /api/calls/credentials 返回 STUN-only fallback）。
|
||
# 申请：dash.cloudflare.com → Realtime → TURN → "Create TURN App"，拿到 Key ID 与 API Token。
|
||
# CDROP_CF_TURN_KEY_ID=
|
||
# CDROP_CF_TURN_API_TOKEN=
|