feat(db): 0002 内容域——entry/locale/revision + 修订不可变 + 回填 content_entry FK

Co-Authored-By: Claude Code <noreply@anthropic.com>

apps/api/src/db/schema.ts

@@ -1,5 +1,5 @@
-// 聚合导出：Task 6 起按域追加 pgTable 定义（站点域 = 迁移文件 0000_pale_sumo；来源域 = 0001_*）
-import { pgTable, pgEnum, uuid, text, integer, bigint, jsonb, timestamp, uniqueIndex } from 'drizzle-orm/pg-core'
+// 聚合导出：Task 6 起按域追加 pgTable 定义（站点域 = 迁移文件 0000_pale_sumo；来源域 = 0001_*；内容域 = 0002_*）
+import { pgTable, pgEnum, uuid, text, integer, bigint, jsonb, timestamp, uniqueIndex, index } from 'drizzle-orm/pg-core'
 
 export const sites = pgTable('sites', {
   id: uuid('id').primaryKey().defaultRandom(),
@@ -83,8 +83,57 @@ export const sourceRecords = pgTable('source_records', {
   sourceChecksum: text('source_checksum'),
   normalizedChecksum: text('normalized_checksum'),
   parseStatus: text('parse_status').notNull(),
-  // 暂无 FK：content_entries 于 Task 8（内容域）落地后再补引用
+  // FK 由 0002 迁移手写 SQL 回填（Task 7 预留；schema 层不声明以避免与生成器 diff 漂移）
   contentEntryId: uuid('content_entry_id'),
   createdAt: timestamp('created_at', { withTimezone: true }).notNull().defaultNow(),
   // 跨 Snapshot 稳定映射键 = site_id + source_connection_id + source_type + source_id + locale（snapshot_id 进键以允许跨快照再导入）
 }, (t) => [uniqueIndex('source_records_identity_uq').on(t.siteId, t.sourceConnectionId, t.sourceType, t.sourceId, t.locale, t.sourceSnapshotId)])
+
+// ---- 内容域（spec §5.3；迁移文件 0002_*，末尾手写追加修订不可变触发器 + 回填 source_records.content_entry_id FK）----
+
+export const contentLifecycleStatus = pgEnum('content_lifecycle_status', ['active', 'archived'])
+export const revisionSourceKind = pgEnum('revision_source_kind', ['import', 'manual', 'restore'])
+
+// Entry = 内容聚合根（身份与 locale 无关；不用 Permalink 做身份）
+export const contentEntries = pgTable('content_entries', {
+  id: uuid('id').primaryKey().defaultRandom(),
+  siteId: uuid('site_id').notNull().references(() => sites.id),
+  typeKey: text('type_key').notNull(),
+  lifecycleStatus: contentLifecycleStatus('lifecycle_status').notNull(),
+  createdAt: timestamp('created_at', { withTimezone: true }).notNull().defaultNow(),
+  updatedAt: timestamp('updated_at', { withTimezone: true }).notNull().defaultNow(),
+}, (t) => [index('content_entries_site_type_idx').on(t.siteId, t.typeKey)])
+
+// 双指针：current=最新工作修订，published=公开修订；两者不同即"已发布但有未发布修改"（构建只读 published）。
+// 发布 = 只 UPDATE 本表指针，修订行永不 UPDATE（ADR-010）。
+export const entryLocales = pgTable('entry_locales', {
+  id: uuid('id').primaryKey().defaultRandom(),
+  siteId: uuid('site_id').notNull().references(() => sites.id),
+  contentEntryId: uuid('content_entry_id').notNull().references(() => contentEntries.id),
+  locale: text('locale').notNull(),
+  slug: text('slug').notNull(),
+  // 双指针本任务不设 FK：修订表在同一迁移创建，循环引用让 drizzle 处理麻烦；
+  // 指针目标合法性由应用层 + Task 13 测试保证，或后续迁移补 FK
+  currentRevisionId: uuid('current_revision_id'),
+  publishedRevisionId: uuid('published_revision_id'),
+  createdAt: timestamp('created_at', { withTimezone: true }).notNull().defaultNow(),
+  updatedAt: timestamp('updated_at', { withTimezone: true }).notNull().defaultNow(),
+  // slug 唯一性由 Route Registry 决定，不在此假设共享 slug 空间
+}, (t) => [uniqueIndex('entry_locales_uq').on(t.siteId, t.contentEntryId, t.locale)])
+
+// 修订创建后不可变（库内触发器强制，见 0002 迁移手写 SQL；只 INSERT，无 UPDATE/DELETE 业务接口）
+export const contentRevisions = pgTable('content_revisions', {
+  id: uuid('id').primaryKey().defaultRandom(),
+  siteId: uuid('site_id').notNull().references(() => sites.id),
+  contentEntryId: uuid('content_entry_id').notNull().references(() => contentEntries.id),
+  locale: text('locale').notNull(),
+  schemaVersion: integer('schema_version').notNull(),
+  data: jsonb('data').notNull(),
+  checksum: text('checksum').notNull(),
+  sourceKind: revisionSourceKind('source_kind').notNull(),
+  sourceRecordId: uuid('source_record_id'),
+  importJobId: uuid('import_job_id').references(() => importJobs.id),
+  overriddenFields: jsonb('overridden_fields').notNull().default([]),
+  createdBy: text('created_by').notNull(),
+  createdAt: timestamp('created_at', { withTimezone: true }).notNull().defaultNow(),
+})