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>
This commit is contained in:
浅念
2026-10-20 20:02:57 +08:00
parent cb959c905d
commit 1cc0dcc57f
6 changed files with 1955 additions and 1 deletions
+42 -1
View File
@@ -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] })])