-- 开放平台 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;