Files
streamline/drizzle/0070_openplatform_features.sql
2026-11-16 17:26:44 -08:00

32 lines
2.3 KiB
SQL
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
-- 开放平台 v1:外部系统用 API Key 建「一句话需求」(feature)。
--
-- 和 0020 给 tasks 加的三列同一个道理:只有把「哪把 key 建的、带着调用方什么单号」
-- 记在 features 上,归属闸(一把 Key 只看得到 / 只能执行自己建的需求)、按 Key 查单、
-- 以及面板上「开放平台 · 申请人」的标记才成立。
--
-- created_via_key_id —— 建需求时鉴权命中的 key 的稳定 id(openplatform_keys.ts 里的
-- id,不是数据库外键 —— key 列表活在 settings KV)。
-- created_via_source —— 那把 key 注册时填的来源标签快照,纯展示,key 改名不影响历史。
-- external_id —— 调用方自己的需求/工单 ID;与该 key 组合去重(见下)。
--
-- 去重按 (created_via_key_id, external_id) 这一对而不是 external_id 单列:两个接入方
-- 各自选的 external_id 可能撞号,去重范围锁定在调用的那把 key 上就不会互相踩号。
-- 两者都非空时才生效;非开放平台创建的需求三列全为 NULL,不受影响。
--
-- ⚠️ 部署顺序:**先跑这条迁移,再上新代码**。新代码的每一次 feature 读(项目列表/详情
-- 的列投影都从 getTableColumns 派生)和每一次 feature 写(insertFeature 无条件写这三列)
-- 都会带新列 —— 反过来的话不是「新接口不可用」,而是整个需求看板/详情报 SQL 错。
-- deploy.sh 的 check-migrations 会拦,手工 apply-migration 时别忘了。
ALTER TABLE "features" ADD COLUMN IF NOT EXISTS "created_via_key_id" text;
ALTER TABLE "features" ADD COLUMN IF NOT EXISTS "created_via_source" text;
ALTER TABLE "features" ADD COLUMN IF NOT EXISTS "external_id" text;
CREATE UNIQUE INDEX IF NOT EXISTS features_created_via_key_external_id_uidx
ON "features" ("created_via_key_id", "external_id")
WHERE "created_via_key_id" IS NOT NULL AND "external_id" IS NOT NULL;
-- GET /api/openapi/v1/features 按 Key 列自己建的需求。上面那个唯一索引只覆盖带
-- external_id 的行,没传 external_id 的需求用不上它(同 0052 给 tasks 补的索引)。
CREATE INDEX IF NOT EXISTS features_created_via_key_created
ON "features" ("created_via_key_id", "created_at") WHERE "created_via_key_id" IS NOT NULL;