feat(db): 0004 媒体域——assets/usages 双唯一

media_assets 双唯一 UNIQUE(site_id, source_url) / UNIQUE(site_id, public_path) + status 四值 enum + source_id 可空；media_usages 复合主键 (media_asset_id, content_revision_id, field_path)，无独立 id/时间戳（spec §5.5）。 vitest fileParallelism: false——不可变表清场 DISABLE/ENABLE TRIGGER 是库级 DDL，与并行文件的不可变断言竞态（实测 media 清场窗口内 content 断言偶发放行）；串行执行消除竞态，套件仅数秒。 Co-Authored-By: Claude Code <noreply@anthropic.com>
2026-10-20 20:02:57 +08:00
parent cb959c905d
commit 1cc0dcc57f
6 changed files with 1955 additions and 1 deletions
@@ -0,0 +1,37 @@
+CREATE TYPE "public"."media_asset_status" AS ENUM('ready', 'missing', 'quarantined', 'unsupported');--> statement-breakpoint
+CREATE TABLE "media_assets" (
+	"id" uuid PRIMARY KEY DEFAULT gen_random_uuid() NOT NULL,
+	"site_id" uuid NOT NULL,
+	"source_connection_id" uuid NOT NULL,
+	"source_id" text,
+	"source_url" text NOT NULL,
+	"source_path" text NOT NULL,
+	"storage_path" text NOT NULL,
+	"public_path" text NOT NULL,
+	"sha256" text NOT NULL,
+	"detected_mime" text NOT NULL,
+	"declared_mime" text,
+	"byte_size" bigint NOT NULL,
+	"width" integer,
+	"height" integer,
+	"alt_text" text,
+	"status" "media_asset_status" NOT NULL,
+	"created_at" timestamp with time zone DEFAULT now() NOT NULL
+);
+--> statement-breakpoint
+CREATE TABLE "media_usages" (
+	"site_id" uuid NOT NULL,
+	"media_asset_id" uuid NOT NULL,
+	"content_revision_id" uuid NOT NULL,
+	"field_path" text NOT NULL,
+	"source_url" text NOT NULL,
+	CONSTRAINT "media_usages_media_asset_id_content_revision_id_field_path_pk" PRIMARY KEY("media_asset_id","content_revision_id","field_path")
+);
+--> statement-breakpoint
+ALTER TABLE "media_assets" ADD CONSTRAINT "media_assets_site_id_sites_id_fk" FOREIGN KEY ("site_id") REFERENCES "public"."sites"("id") ON DELETE no action ON UPDATE no action;--> statement-breakpoint
+ALTER TABLE "media_assets" ADD CONSTRAINT "media_assets_source_connection_id_source_connections_id_fk" FOREIGN KEY ("source_connection_id") REFERENCES "public"."source_connections"("id") ON DELETE no action ON UPDATE no action;--> statement-breakpoint
+ALTER TABLE "media_usages" ADD CONSTRAINT "media_usages_site_id_sites_id_fk" FOREIGN KEY ("site_id") REFERENCES "public"."sites"("id") ON DELETE no action ON UPDATE no action;--> statement-breakpoint
+ALTER TABLE "media_usages" ADD CONSTRAINT "media_usages_media_asset_id_media_assets_id_fk" FOREIGN KEY ("media_asset_id") REFERENCES "public"."media_assets"("id") ON DELETE no action ON UPDATE no action;--> statement-breakpoint
+ALTER TABLE "media_usages" ADD CONSTRAINT "media_usages_content_revision_id_content_revisions_id_fk" FOREIGN KEY ("content_revision_id") REFERENCES "public"."content_revisions"("id") ON DELETE no action ON UPDATE no action;--> statement-breakpoint
+CREATE UNIQUE INDEX "media_assets_source_url_uq" ON "media_assets" USING btree ("site_id","source_url");--> statement-breakpoint
+CREATE UNIQUE INDEX "media_assets_public_path_uq" ON "media_assets" USING btree ("site_id","public_path");
@@ -29,6 +29,13 @@
      "when": 1792496827818,
      "tag": "0003_groovy_phil_sheldon",
      "breakpoints": true
+    },
+    {
+      "idx": 4,
+      "version": "7",
+      "when": 1792497336007,
+      "tag": "0004_last_victor_mancha",
+      "breakpoints": true
    }
  ]
 }
@@ -1,4 +1,4 @@
-// 聚合导出：Task 6 起按域追加 pgTable 定义（站点域 = 迁移文件 0000_pale_sumo；来源域 = 0001_*；内容域 = 0002_*；分类域 = 0003_*）
+// 聚合导出：Task 6 起按域追加 pgTable 定义（站点域 = 迁移文件 0000_pale_sumo；来源域 = 0001_*；内容域 = 0002_*；分类域 = 0003_*；媒体域 = 0004_*）
 import { pgTable, pgEnum, uuid, text, integer, bigint, jsonb, timestamp, uniqueIndex, index, boolean, primaryKey, type AnyPgColumn } from 'drizzle-orm/pg-core'

 export const sites = pgTable('sites', {
@@ -172,3 +172,44 @@ export const contentTerms = pgTable('content_terms', {
  termId: uuid('term_id').notNull().references(() => terms.id),
  isPrimary: boolean('is_primary').notNull(),
 }, (t) => [primaryKey({ columns: [t.siteId, t.contentEntryId, t.termId] })])
+
+// ---- 媒体域（spec §5.5；迁移文件 0004_*，无手写 SQL）----
+// 媒体资产与使用关系：匹配按 source_url 找（spec 匹配顺序 1-3），发布按 public_path 寻址，
+// 故库层打双唯一——同站同一来源 URL 只入一次库，同站公开路径不冲突（换路径放行 = 新资产）。
+
+export const mediaAssetStatus = pgEnum('media_asset_status', ['ready', 'missing', 'quarantined', 'unsupported'])
+
+export const mediaAssets = pgTable('media_assets', {
+  id: uuid('id').primaryKey().defaultRandom(),
+  siteId: uuid('site_id').notNull().references(() => sites.id),
+  sourceConnectionId: uuid('source_connection_id').notNull().references(() => sourceConnections.id),
+  // WP 站外媒体（热链/外部图床）在来源系统内没有附件 ID，source_id 必须可空
+  sourceId: text('source_id'),
+  sourceUrl: text('source_url').notNull(),
+  sourcePath: text('source_path').notNull(),
+  storagePath: text('storage_path').notNull(),
+  publicPath: text('public_path').notNull(),
+  sha256: text('sha256').notNull(),
+  detectedMimeType: text('detected_mime').notNull(),
+  declaredMimeType: text('declared_mime'),
+  byteSize: bigint('byte_size', { mode: 'number' }).notNull(),
+  width: integer('width'),
+  height: integer('height'),
+  altText: text('alt_text'),
+  status: mediaAssetStatus('status').notNull(),
+  createdAt: timestamp('created_at', { withTimezone: true }).notNull().defaultNow(),
+}, (t) => [
+  uniqueIndex('media_assets_source_url_uq').on(t.siteId, t.sourceUrl),
+  uniqueIndex('media_assets_public_path_uq').on(t.siteId, t.publicPath),
+])
+
+// 使用关系：一资产在一修订的一字段位被引用一次。复合主键 (media_asset_id, content_revision_id,
+// field_path) 天然防重；无独立 id/时间戳（照 spec §5.5——usage 是修订不可变快照的一部分，
+// 修订不可变则 usage 无需自身生命周期）。content_revision_id 指向不可变的 content_revisions。
+export const mediaUsages = pgTable('media_usages', {
+  siteId: uuid('site_id').notNull().references(() => sites.id),
+  mediaAssetId: uuid('media_asset_id').notNull().references(() => mediaAssets.id),
+  contentRevisionId: uuid('content_revision_id').notNull().references(() => contentRevisions.id),
+  fieldPath: text('field_path').notNull(),
+  sourceUrl: text('source_url').notNull(),
+}, (t) => [primaryKey({ columns: [t.mediaAssetId, t.contentRevisionId, t.fieldPath] })])