Files
streamline/drizzle/0042_openplatform_webhooks.sql
T
2026-11-16 17:26:44 -08:00

48 lines
2.5 KiB
SQL

-- 开放平台 v1 的状态推送订阅(见 control-server/src/openplatform_webhooks.ts)。
--
-- 和管理台那份全局 webhookUrls(settings KV,推全部单子、只发一次)是两套东西:
-- 那份留给存量接收端原样用;这里是给接入方的标准方案 —— 订阅挂在一把 API Key
-- 下,只推这把 Key 建的任务(tasks.created_via_key_id),每条带 HMAC 签名,失败
-- 按退避重试。Key 本身仍在 settings KV 里,这里的 key_id 指向它的稳定 id。
--
-- 投递单独一张表而不是发完即弃:重试、「最近投递」自查、以及「同一事件对同一
-- 订阅只投一次」的去重(唯一索引)都要落地的状态。纯新增,不需要回填。
CREATE TABLE IF NOT EXISTS "openplatform_webhooks" (
"id" text PRIMARY KEY,
"key_id" text NOT NULL,
"url" text NOT NULL,
-- 只推这些状态(JSON 数组存 TEXT);NULL = 全部状态。
"events" text,
-- 签名密钥明文。HMAC 需要服务端持有原文,所以不能像 API Key 那样只存哈希;
-- 只在创建时返回一次,列表接口永不返回。
"secret" text NOT NULL,
"created_at" bigint NOT NULL,
-- 非空 = 已停用(接入方 / 管理员手动停用,或连续投递失败被自动停用)。
"disabled_at" bigint,
"disabled_reason" text,
"consecutive_failures" bigint NOT NULL DEFAULT 0,
"last_success_at" bigint,
"last_failure_at" bigint
);
CREATE INDEX IF NOT EXISTS "openplatform_webhooks_key" ON "openplatform_webhooks" ("key_id");
CREATE TABLE IF NOT EXISTS "openplatform_webhook_deliveries" (
"id" text PRIMARY KEY,
"webhook_id" text NOT NULL,
-- 与 task_transitions.id 同一个值(kind:targetId:toStatus:ts),接收端据此去重。
"event_id" text NOT NULL,
-- 入队那一刻冻结的请求体;签名在每次发送时按当时的时间戳重算。
"payload" text NOT NULL,
-- pending | succeeded | failed(重试用尽)| cancelled(订阅停用 / Key 吊销)
"state" text NOT NULL,
"attempts" bigint NOT NULL DEFAULT 0,
"next_attempt_at" bigint,
"last_status" bigint,
"last_error" text,
"created_at" bigint NOT NULL,
"updated_at" bigint NOT NULL
);
CREATE UNIQUE INDEX IF NOT EXISTS "openplatform_webhook_deliveries_event" ON "openplatform_webhook_deliveries" ("webhook_id", "event_id");
CREATE INDEX IF NOT EXISTS "openplatform_webhook_deliveries_due" ON "openplatform_webhook_deliveries" ("state", "next_attempt_at");
CREATE INDEX IF NOT EXISTS "openplatform_webhook_deliveries_recent" ON "openplatform_webhook_deliveries" ("webhook_id", "created_at");