photo-live/packages/db-ov/prisma/schema.prisma

// packages/db-ov/prisma/schema.prisma —— OV（海外观众）侧唯一 schema（P2 Task 2）。
// 约定：与 db-cn 同库级约定——MySQL 8.4、utf8mb4_0900_bin（publicToken/对象键的
// 大小写敏感语义依赖它；Prisma 生成 DDL 固定 unicode_ci，迁移走「--create-only →
// 手工改 COLLATE → apply → information_schema 复核」固化流程）；时间一律
// @db.DateTime(6)；全库扁平字符串外键（albumId/photoId/categoryId 为纯字符串，
// 不建 relation/FK 约束——与 cn 相册域同因：删除/墓碑语义由应用层决策）。
//
// 与 cn schema 的本质差异：本库几乎全是「副本 + 同步账本 + 互动流水」三类表——
//   · 副本表（albums_ov/photos_ov）：以 cn 的 id 为键（albumId/photoId），展示
//     字段反规范化为 JSON（translations/categories 直接落 sync payload 原文），
//     entityVersion 是 cn 侧权威版本（ov 只比较、从不自增）；
//   · 同步账本（sync_inbox/sync_state）：eventId 幂等 + entityVersion 单调应用，
//     水位行与实体行同表（见 sync_state 注释）；
//   · 互动流水（like_batches/visit_sessions/visit_requests/outbox_stat_events）：
//     幂等锚点全部唯一约束承担，窗口清理走 createdAt 索引。
// generator 输出到包内 generated/（不进 git）：与 db-cn 关键差异——pnpm 将两个包
// 的 @prisma/client 提升为同一 store 实例，默认输出 node_modules/.prisma/client
// 会被两份 schema 互相覆盖（Task 2 实测 EPERM/串库），故 ov 客户端独立产出，
// 由 src/index.ts 转出口；消费方只见 @photo/db-ov。
generator client {
  provider = "prisma-client-js"
  output   = "../generated/client"
}

datasource db {
  provider = "mysql"
  url      = env("DATABASE_URL_OV")
}

// —— 副本域：albums_ov（cn albums 的展示投影）——
// emergency_disabled 是唯一 ov 本地可写位（Task 5 紧急停用入口直写），独立于
// 同步版本链：任何后续同步事件不得覆盖/解除它，解除仅经显式 enable 端点。
// startAt/endAt 可空：副本以事件到达为准，不复制 cn 的 NOT NULL 约束。
model albums_ov {
  albumId                 String    @id
  publicToken             String    @unique @db.VarChar(32)
  status                  String    @default("active") // active|offline（cn 副本值）
  publicEnabled           Boolean   @default(true)
  downloadEnabled         Boolean   @default(true)
  originalDownloadEnabled Boolean   @default(false)
  emergencyDisabled       Boolean   @default(false)
  translations            Json // [{locale,title,description,venue,address}]（cn 原文数组）
  categories              Json // [{id,sortOrder,translations:[{locale,name}]}]
  bannerAssetKey          String?   @db.VarChar(255)
  defaultLocale           String    @db.VarChar(16)
  timezone                String    @default("Asia/Shanghai") @db.VarChar(64)
  startAt                 DateTime? @db.DateTime(6)
  endAt                   DateTime? @db.DateTime(6)
  entityVersion           Int // cn 权威版本（应用写入，ov 不自增）
  updatedAt               DateTime  @updatedAt @db.DateTime(6)
}

// —— 副本域：photos_ov（cn photos + photo_variants 的展示投影）——
// 三个 objectKey 直接内联（cn 侧 thumb/browse 在变体表）：ov 只读同 MinIO，
// 无上传/处理域，无需变体表。likeTotal/countVersion 是 ov 权威计数（Task 7
// 点赞事务维护，回传 cn 做副本替换）。
model photos_ov {
  photoId           String    @id
  albumId           String    @db.VarChar(64)
  categoryId        String?   @db.VarChar(64)
  width             Int?
  height            Int?
  originalObjectKey String    @db.VarChar(255)
  thumbObjectKey    String    @db.VarChar(255)
  browseObjectKey   String    @db.VarChar(255)
  likeTotal         Int       @default(0)
  countVersion      Int       @default(0) // 点赞乐观锁/回传版本（Task 7/9）
  visibility        String // published|hidden|deleted|unpublished（cn 副本值）
  entityVersion     Int // cn 权威版本
  publishedAt       DateTime? @db.DateTime(6)
  updatedAt         DateTime  @updatedAt @db.DateTime(6)

  @@index([albumId, visibility, publishedAt])
}

// —— 同步账本：sync_inbox（cn→ov 事件收件箱，Task 4 inbox 模块消费）——
// eventId 即 cn outbox_events.id（幂等锚点）；appliedAt 为空 = 未应用（依赖
// 缺失暂存 / 待补应用 / 待对账），receivedAt 供积压监控与重试排序。
model sync_inbox {
  eventId       String    @id
  entityType    String    @db.VarChar(32) // album|category|photo|asset|slot-state
  entityId      String    @db.VarChar(64)
  albumId       String?   @db.VarChar(64)
  entityVersion Int
  tombstone     Boolean   @default(false)
  priority      String    @default("normal") @db.VarChar(16) // normal|high
  payload       Json
  receivedAt    DateTime  @default(now()) @db.DateTime(6)
  appliedAt     DateTime? @db.DateTime(6)

  @@index([receivedAt])
  @@index([appliedAt])
}

// —— 同步账本：sync_state（实体应用版本 + per source 水位，同表两用）——
// 设计取舍（Task 2 决策）：不另建水位表——watermark=false 为实体行
// （entityType+entityId 唯一 → appliedVersion，Task 4 应用前比较、旧版本忽略）；
// watermark=true 为水位行（entityId 记 source 名如 'cn'，appliedVersion 为该
// source 已确认的事件序水位，对账/断点续传用）。单表少一次 join，语义靠
// 唯一约束与标志位保住，P4a 管理页可直接一表读出延迟/积压。
model sync_state {
  id             String   @id @default(cuid())
  entityType     String   @db.VarChar(32)
  entityId       String   @db.VarChar(64)
  appliedVersion Int
  appliedAt      DateTime @default(now()) @db.DateTime(6)
  watermark      Boolean  @default(false)

  @@unique([entityType, entityId])
}

// —— 互动域：like_batches（Task 7 点赞批次幂等锚点）——
// photoId+sessionId+batchId 唯一：重复 batchId 命中唯一冲突 → 返回已确认结果，
// 不加计。createdAt 索引服务 Task 8 清理调度（LIKE_BATCH_WINDOW 默认 24h；
// 窗口外重放拒绝——累计总数在 photos_ov.likeTotal 长期保留，此表仅幂等账本）。
model like_batches {
  id        String   @id @default(cuid())
  photoId   String   @db.VarChar(64)
  sessionId String   @db.VarChar(64)
  batchId   String   @db.VarChar(64)
  delta     Int
  createdAt DateTime @default(now()) @db.DateTime(6)

  @@unique([photoId, sessionId, batchId])
  @@index([photoId])
  @@index([createdAt])
}

// —— 互动域：album_stats（Task 8 浏览计数权威位，ov 本地权威、回传 cn 副本）——
model album_stats {
  albumId     String   @id @db.VarChar(64)
  viewCount   Int      @default(0)
  statVersion Int      @default(0) // 回传替换版本（仅更高版本替换，绝不相加）
  updatedAt   DateTime @updatedAt @db.DateTime(6)
}

// —— 互动域：visit_sessions（albumId+visitorId 窗口去重锚点，Task 8）——
// lastCountedAt 距今超过 VISIT_WINDOW_MINUTES（D07 默认 30 分钟）才允许再计。
model visit_sessions {
  id            String    @id @default(cuid())
  albumId       String    @db.VarChar(64)
  visitorId     String    @db.VarChar(64)
  lastCountedAt DateTime? @db.DateTime(6)

  @@unique([albumId, visitorId])
}

// —— 互动域：visit_requests（requestId 幂等 + 重试应答，Task 8）——
model visit_requests {
  requestId String   @id @db.VarChar(64)
  albumId   String   @db.VarChar(64)
  visitorId String   @db.VarChar(64)
  counted   Boolean  @default(false)
  createdAt DateTime @default(now()) @db.DateTime(6)

  @@index([createdAt])
}

// —— 统计回传队列：outbox_stat_events（ov→cn，Task 9 消费）——
// 与 cn outbox_events 同构的发送位：sentAt 为空即重发（中断恢复），statVersion
// 让 cn 侧「仅更高版本替换」幂等。total 恒为权威快照值（非增量）。
model outbox_stat_events {
  id          String    @id @default(cuid())
  kind        String    @db.VarChar(16) // likes|views
  albumId     String    @db.VarChar(64)
  photoId     String?   @db.VarChar(64) // kind=likes 时携带
  total       Int
  statVersion Int
  createdAt   DateTime  @default(now()) @db.DateTime(6)
  sentAt      DateTime? @db.DateTime(6)

  @@index([sentAt])
}