feat(deploy): 一条命令链部署——双单文件 + Caddy + DATABASE_URL 单源

多阶段镜像编出 server/engine 单文件与前端静态；compose 起 pg/server/engine/caddy；
启动时自动迁移；仅用 DATABASE_URL，postgres 建库参数由 entrypoint 拆解。

.env.example

@@ -1,10 +1,15 @@
-# ── new-api-key-usage · 本地环境变量示例 ──────────────────────────
+# ── new-api-key-usage · 环境变量示例 ──────────────────────────
 # 复制为 .env 后填写（.env 已被 .gitignore，勿提交）
+# 开发：任意可用的 PostgreSQL，DATABASE_URL 指向即可
+# 部署：docker compose up -d --build（见 README）
 
-# 本服务端口（避开 3000/3001 等常见占用）
+# 本服务端口（避开 3000/3001 等常见占用；容器内固定 18456 即可）
 PORT=18456
 
-# PostgreSQL 连接串（开发 compose 默认如下）
+# PostgreSQL 连接串——数据库配置的唯一来源
+# 开发：指向你本机/已有的库（主机 127.0.0.1 或 localhost）
+# 部署：同一份即可；compose 会把主机改写为容器服务名 postgres
+# 密码含 @ : / 等字符时请 URL 编码
 DATABASE_URL=postgres://postgres:postgres@127.0.0.1:5432/new_api_key_usage
 
 # 已登记 sk-key 的加密密钥：≥32 字节随机数，base64url。
@@ -24,6 +29,9 @@ COOKIE_SECURE=false
 # 业务日志级别：debug | info | warning | error | fatal（访问日志另由 hono/logger 输出）
 LOG_LEVEL=info
 
+# 同步引擎周期（毫秒，≥1000；默认 300000 = 5 分钟）
+# SYNC_INTERVAL_MS=300000
+
 # 空库双通道：可选。用户名与密码同时存在时，首次 setup-state 静默落库；
 # 只填一个视为未配置。此后改 env 不改密；改密走管理面表单。
 # ADMIN_INIT_USERNAME=