feat(api): photo, upload, outbox schema

Task 10: photos/photo_variants/upload_sessions/photo_jobs/outbox_events on the CN schema (flat string FKs, no Prisma relations); migration 20260917120827_photo_upload_domain rewritten to utf8mb4_0900_bin per the 固化 collation recipe; reset.ts table order extended; one semantics e2e case for photo_jobs @@unique([photoId, type]) and the upload_sessions A03 idempotency anchor @@unique([userId, clientTaskId]). Co-Authored-By: Claude Code <noreply@anthropic.com>
2026-09-17 20:11:26 +08:00
parent a99b8f200b
commit 59464bd73d
4 changed files with 230 additions and 0 deletions
@@ -126,3 +126,77 @@ model album_assets {

  @@index([albumId, kind])
 }
+
+// —— 照片与上传域 + outbox（Task 10）——
+// 同相册域约定：扁平字符串外键、无 Prisma relation/FK 约束。
+// photos.objectKey 是 originals 正式键（Task 18 上传确认时写入）；
+// upload_sessions.objectKey 是 staging 键；outbox_events 承载领域事件
+// （契约见 packages/contracts），由 worker 轮询投递。
+model photos {
+  id              String    @id @default(cuid())
+  albumId         String    @db.VarChar(64)
+  uploaderId      String    @db.VarChar(64)
+  categoryId      String?   @db.VarChar(64)
+  objectKey       String    @unique @db.VarChar(255) // originals 正式键
+  bytes           Int       @default(0)
+  width           Int?
+  height          Int?
+  shotAt          DateTime? @db.DateTime(6)
+  uploadedAt      DateTime? @db.DateTime(6)
+  publishedAt     DateTime? @db.DateTime(6)
+  processingState String    @default("pending_upload") // pending_upload|uploaded|processing|ready|processing_failed
+  errorCode       String?   @db.VarChar(64)
+  visibility      String    @default("unpublished")    // unpublished|published|hidden|deleted
+  likeCount       Int       @default(0)                // P2 起为统计副本
+  entityVersion   Int       @default(1)
+  @@index([albumId, visibility, publishedAt, id])
+  @@index([albumId, uploaderId, uploadedAt])
+}
+model photo_variants {
+  photoId  String  @db.VarChar(64)
+  variant  String  @db.VarChar(32) // thumb|browse
+  objectKey String @unique @db.VarChar(255)
+  bytes    Int
+  version  Int     @default(1)
+  width    Int?
+  height   Int?
+  @@unique([photoId, variant])
+}
+model upload_sessions {
+  id           String   @id @default(cuid())
+  userId       String   @db.VarChar(64)
+  albumId      String   @db.VarChar(64)
+  clientTaskId String   @db.VarChar(128)
+  photoId      String   @unique @db.VarChar(64)
+  objectKey    String   @unique @db.VarChar(255) // staging 键
+  expectedBytes Int
+  contentType  String   @db.VarChar(128)
+  multipartId  String?  @db.VarChar(255)
+  state        String   @default("pending") // pending|confirmed|cancelled|expired（对齐契约 UploadSessionState；核验失败是请求级错误不改会话态，expired 由 expiresAt 判定或 sweep 置位）
+  expiresAt    DateTime @db.DateTime(6)
+  createdAt    DateTime @default(now()) @db.DateTime(6)
+  @@unique([userId, clientTaskId])   // 幂等锚点（A03）
+}
+model photo_jobs {
+  id          String    @id @default(cuid())
+  photoId     String    @db.VarChar(64)
+  type        String    @default("process") @db.VarChar(32)
+  state       String    @default("pending") // pending|active|done|failed
+  attempt     Int       @default(0)
+  errorCode   String?   @db.VarChar(64)
+  nextRetryAt DateTime? @db.DateTime(6)
+  updatedAt   DateTime  @updatedAt @db.DateTime(6)
+  @@unique([photoId, type])
+  @@index([state, nextRetryAt])
+}
+model outbox_events {
+  id            String    @id @default(cuid())
+  type          String    @db.VarChar(64)
+  albumId       String    @db.VarChar(64)
+  photoId       String?   @db.VarChar(64)
+  entityVersion Int
+  payload       Json
+  occurredAt    DateTime  @default(now()) @db.DateTime(6)
+  deliveredAt   DateTime? @db.DateTime(6)
+  @@index([deliveredAt, occurredAt])
+}