Files
UHD_Media_Tool/packages/db/migrations/0020_metadata_fields.ts
T
rootandClaude Opus 5.5 a24bda952b feat(server): W2-B sources, identity resolution, metadata and site workbench
- Sites / accounts / feeds: registry view (/site-definitions), site CRUD with
  enable/disable (history stays queryable, marked site_disabled), accounts and
  feed URLs stored as secrets (only secret_ref / redacted urlDisplay exposed),
  feed enable/disable/reset/fetch; one shared rate limiter + adapter per site.
- Tasks: ingestFeed (FeedFetchState/FeedCursor on feed_source, observation
  feed+guid upsert with digest-change updates, source_release site+id
  aggregation across feeds, auth failure -> account invalid + decision, no
  retry, gap -> feed.gap_suspected -> budgeted backfill snapshot),
  resolveObservation (parseRelease -> local recall via title_alias pg_trgm +
  accepted identities -> TMDB -> resolveIdentity; auto binds entity /
  provisional units / identities / aliases, otherwise identity_candidate pool
  with evidence version and bounded review backoff; manual lock respected),
  refreshMetadata (metadata_field + field_override, user locks win, paths
  untouched), snapshotSite (site_snapshot coverage records).
- Events: feed.due, feed.gap_suspected, release.observed (self-consumed),
  release.resolved, decision.created/updated; scheduler in worker start().
- Identity API: entity detail with redirects, manual mapping correction with
  identity_revision, merge with identity_redirect, pool list/assign/dismiss/
  retry, content unit numbering lock, aliases, external identities.
- Decisions: list/summary (by entity and kind)/detail/resolve; identity
  options executed directly.
- Workbench: /sites/{id}/releases (snapshot first, coalesced live search with
  backoff, origin + freshness) and /sites/{id}/releases/{rid} (volatile field
  recheck times, refresh keeps data on failure).
- Capabilities: catalog.lookup, release.search, release.inspect,
  identity.resolve.
- Migrations 0018-0020: site.adapter api, source_release.resolution_locked,
  site_snapshot, identity_candidate, resolution_attempt, identity_redirect,
  metadata_field, field_override.

Co-Authored-By: Claude Opus 5.5 <[email protected]>
2026-09-27 20:12:01 +08:00

55 lines
2.2 KiB
TypeScript

import type { Kysely } from "kysely";
import { dropTables, entityTable, execDdl, oneOf } from "../src/migration-helpers.ts";
// W2-B 字段级元数据协调(REQ §7.3):
// - metadata_field:各来源的候选字段值(来源/语言/时间/来源修订),刷新只写这里;
// - field_override:用户(或 Agent 生成并确认)的字段覆盖与锁定,优先于任何自动来源;
// 最终展示值投影到 media_entity.metadata / content_unit.metadata。路径绑定不受元数据刷新影响。
const SOURCE = ["tmdb", "user", "agent", "nfo", "site", "import"] as const;
const target = "constraint {t}_target_check check (num_nonnulls(media_entity_id, content_unit_id) = 1)";
// biome-ignore lint/suspicious/noExplicitAny: 迁移不依赖应用表类型
export async function up(db: Kysely<any>): Promise<void> {
await execDdl(
db,
`
${entityTable(
"metadata_field",
`
media_entity_id uuid references media_entity (id) on delete cascade,
content_unit_id uuid references content_unit (id) on delete cascade,
field text not null,
value jsonb,
language text,
source text not null ${oneOf("source", SOURCE)},
source_revision text,
fetched_at timestamptz not null default now(),
${target.replace("{t}", "metadata_field")}`,
)}
create unique index metadata_field_key on metadata_field (media_entity_id, content_unit_id, field, source, language) nulls not distinct;
${entityTable(
"field_override",
`
media_entity_id uuid references media_entity (id) on delete cascade,
content_unit_id uuid references content_unit (id) on delete cascade,
field text not null,
value jsonb,
locked boolean not null default true,
source text not null default 'user' ${oneOf("source", SOURCE)},
reason text,
actor_type text not null ${oneOf("actor_type", ["user", "agent", "system", "api_key"])},
actor_id text,
${target.replace("{t}", "field_override")}`,
)}
create unique index field_override_key on field_override (media_entity_id, content_unit_id, field) nulls not distinct;
`,
);
}
// biome-ignore lint/suspicious/noExplicitAny: 同上
export async function down(db: Kysely<any>): Promise<void> {
await execDdl(db, dropTables(["field_override", "metadata_field"]));
}