Kokorone/prisma/schema.prisma

// Kokorone 資料模型
// R-2 會將 provider 由 sqlite 切換為 postgresql，並為 MemoryRetriever 加上 pgvector 語意檢索。

generator client {
  provider = "prisma-client"
  output   = "../packages/db/generated"
}

datasource db {
  provider = "sqlite"
}

enum CharacterSource {
  ORIGINAL // 原創
  EXISTING_WORK // 既有作品
}

enum CharacterBuildStatus {
  CANDIDATE // 候補
  BUILT // 已建置
}

enum MemorySource {
  INTERACTION // 互動
  OFFLINE_GENERATED // 離線生成
  SOURCE_EXTRACTION // 原作萃取
}

// 情緒標籤類型：對應情緒子系統六種狀態（見 D 群組）
enum EmotionTag {
  CALM // 平靜
  JOY // 愉悅
  SAD // 低落
  ALERT // 警戒
  SHY // 害羞
  GRUMPY // 彆扭
}

enum RelationshipStage {
  STRANGER // 陌生 0-19
  ACQUAINTANCE // 認識 20-39
  FRIEND // 朋友 40-59
  CLOSE_AMBIGUOUS // 摯友-曖昧 60-79
  BONDED // 羈絆 80-100
}

// L-5 戀愛階段：與上面的 RelationshipStage（友誼軸分層）是完全獨立的兩套狀態機。
enum RomanceStage {
  NONE // 戀愛軸未啟動（朋友）
  INTERESTED // 在意
  AMBIGUOUS // 曖昧
  PARTNER // 戀人
  DEEP_PARTNER // 深度伴侶
  CRISIS // 關係危機（戀人階段的重大失望，需修復事件）
}

// L-6 角色年齡證據：證據強度依序為 官方明示（決定性）＞作中身分／作中經過時間（強）＞外觀與社會呈現（僅輔助，
// 不可單獨採信為成年）。isEpilogue 標記此證據屬於後日談推演區間、還是正史（已出版內容錨定點內）。
enum CharacterAgeEvidenceType {
  OFFICIAL_STATED
  IN_STORY_STATUS
  ELAPSED_TIME
  APPEARANCE
}

// L-5 心動事件類型與 L-2/L-4 的告白／里程碑事件，統一記在同一張表，供曲線與稀有度判斷共用。
enum RomanceEventType {
  SHARED_HIGH_EMOTION_EXPERIENCE // 共同經歷高情緒事件（大幅上升）
  UNDERSTOOD_MOMENT // 被理解的瞬間（大幅上升）
  ADMIRED_TRAIT // 展現她欣賞的特質（中幅上升）
  PERFECT_DISTANCE // 恰到好處的距離感（緩升）
  DISAPPOINTMENT // 失望事件（回落）
  CONFESSION_ACCEPTED
  CONFESSION_REJECTED
  MILESTONE_REACHED
  MILESTONE_REJECTED
}

// I-1 週期表：平日／週末／假期各一份時段表
enum ScheduleDayType {
  WEEKDAY // 平日
  WEEKEND // 週末
  HOLIDAY // 假期／特殊日
}

enum ScheduleSlotStatus {
  SLEEP // 睡眠
  BUSY // 忙碌
  SEMI_BUSY // 半忙碌
  FREE // 空閒
}

// J-1 委託類型
enum TaskType {
  ONE_TIME // 單次提醒
  RECURRING // 週期提醒
  CONDITIONAL // 條件提醒
  QUERY_ORGANIZE // 查詢整理
  TODO_TRACKING // 代辦追蹤
}

enum TaskStatus {
  PENDING // 尚未觸發
  TRIGGERED // 已觸發，等候使用者回應
  COMPLETED // 已完成
  FAILED // 執行失敗
  CANCELLED // 已取消
}

model User {
  id        String   @id @default(cuid())
  name      String
  createdAt DateTime @default(now())
  updatedAt DateTime @updatedAt

  relationships   Relationship[]
  relatedMemories EpisodicMemory[]
  tasks           Task[]
  adultModeConsent      AdultModeConsent?
  romanceEventLogs      RomanceEventLog[]
  adultContentAttempts  AdultContentAttemptLog[]

  @@map("users")
}

model Work {
  id             String   @id @default(cuid())
  title          String
  volumeProgress String? // 卷數進度
  worldview      String? // 世界觀
  progressAnchor String? // 作品進度錨定點（M-9／N 群組使用；描述作品實際描寫過的時期）
  createdAt      DateTime @default(now())
  updatedAt      DateTime @updatedAt

  characters Character[]

  @@map("works")
}

model Character {
  id     String  @id @default(cuid())
  workId String?
  work   Work?   @relation(fields: [workId], references: [id], onDelete: SetNull)

  source      CharacterSource
  buildStatus CharacterBuildStatus @default(CANDIDATE)

  // 角色設定表七欄位
  basicInfo            String // 基本資料：名字、年齡、外型、出身
  backgroundStory      String // 背景故事：成長經歷、重大事件
  personalityArchetype String // 性格原型：傲嬌／冷淡／天然呆／元氣／大小姐／三無
  likesDislikes        String // 喜好／厭惡
  goalsObsessions      String // 目標／執念
  speechStyle          String // 說話方式：口癖、語尾詞、第一/第二人稱
  initialRelationValue String? // 人際初始值：對誰親近、對誰有心結

  createdAt DateTime @default(now())
  updatedAt DateTime @updatedAt

  aliases             CharacterAlias[]
  episodicMemories    EpisodicMemory[]
  semanticMemories    SemanticMemory[]
  proceduralRules     ProceduralRule[]
  emotionState        EmotionState?
  relationships       Relationship[]
  contrastTriggerLogs ContrastTriggerLog[]
  scheduleSlots       ScheduleSlot[]
  specialDays         SpecialDay[]
  scheduleExceptions  ScheduleExceptionLog[]
  tasks               Task[]
  proactiveCareLogs   ProactiveCareLog[]
  relationshipsToOthers   CharacterRelationship[] @relation("RelationshipFrom")
  relationshipsFromOthers CharacterRelationship[] @relation("RelationshipTo")
  ageEvidence           CharacterAgeEvidence[]
  romanceEventLogs      RomanceEventLog[]
  adultContentAttempts  AdultContentAttemptLog[]

  @@map("characters")
}

// L-6 角色年齡判定的原始證據登錄；由 AgeDeterminationService 依證據優先序算出年齡狀態，不直接存最終結論
// ——結論永遠是「依目前登錄的證據重新算出來」，避免證據更新後忘記同步結論欄位。
model CharacterAgeEvidence {
  id           String                   @id @default(cuid())
  characterId  String
  character    Character                @relation(fields: [characterId], references: [id], onDelete: Cascade)
  evidenceType CharacterAgeEvidenceType
  impliesAdult Boolean
  isEpilogue   Boolean                  @default(false) // true＝後日談推演區間的證據，非正史（已出版內容）
  description  String
  createdAt    DateTime                 @default(now())

  @@map("character_age_evidence")
}

// L-5 心動事件與 L-2/L-4 的告白／里程碑，統一記錄，供戀愛軸曲線計算、稀有度節流、里程碑追蹤共用。
model RomanceEventLog {
  id          String           @id @default(cuid())
  characterId String
  character   Character        @relation(fields: [characterId], references: [id], onDelete: Cascade)
  userId      String
  user        User             @relation(fields: [userId], references: [id], onDelete: Cascade)
  eventType   RomanceEventType
  delta       Float            @default(0)
  detail      String? // 例如里程碑類型（HAND_HOLDING／HUG／FOREHEAD_KISS…）
  occurredAt  DateTime         @default(now())

  @@map("romance_event_logs")
}

// L-7 使用者是否已完成成年驗證＋明確 opt-in 開啟成人模式；預設全關，且僅影響「使用者分級」這一層邊界，
// 角色資格與硬邊界仍需獨立通過才會真的放行（見 RomanceEligibilityService）。
model AdultModeConsent {
  id            String   @id @default(cuid())
  userId        String   @unique
  user          User     @relation(fields: [userId], references: [id], onDelete: Cascade)
  verifiedAdult Boolean  @default(false)
  optedIn       Boolean  @default(false)
  updatedAt     DateTime @updatedAt

  @@map("adult_mode_consents")
}

// L-7 驗收：任何嘗試（無論是否放行）都留下記錄，證明繞過嘗試會被引擎層攔截並記錄，不會被悄悄放過或悄悄擋掉。
model AdultContentAttemptLog {
  id          String   @id @default(cuid())
  characterId String
  character   Character @relation(fields: [characterId], references: [id], onDelete: Cascade)
  userId      String
  user        User      @relation(fields: [userId], references: [id], onDelete: Cascade)
  allowed     Boolean
  reason      String
  attemptedAt DateTime  @default(now())

  @@map("adult_content_attempt_logs")
}

// K-2/K-4 角色間關係：群聊中「角色間關係上場」與發言權分配的「與發言者的關係」都吃這張表。
// 有向邊（characterId 對 otherCharacterId 的觀感），故同作品兩角色互相的觀感可以不對稱。
model CharacterRelationship {
  id              String    @id @default(cuid())
  characterId     String
  character       Character @relation("RelationshipFrom", fields: [characterId], references: [id], onDelete: Cascade)
  otherCharacterId String
  otherCharacter  Character @relation("RelationshipTo", fields: [otherCharacterId], references: [id], onDelete: Cascade)
  affinity        Int       @default(50) // 0~100，越高越要好；50 為中性
  dynamic         String? // 互動基調描述性標籤，例如 loyal-friend／rival／protective／crush
  createdAt       DateTime  @default(now())
  updatedAt       DateTime  @updatedAt

  @@unique([characterId, otherCharacterId])
  @@map("character_relationships")
}

// G-4 反差萌稀有度控制：記錄每次反差行為觸發的時間，供冷卻期判定。
model ContrastTriggerLog {
  id          String   @id @default(cuid())
  characterId String
  character   Character @relation(fields: [characterId], references: [id], onDelete: Cascade)
  triggeredAt DateTime @default(now())

  @@map("contrast_trigger_logs")
}

// I-1 作息表：平日／週末／假期各一份時段表，每個時段一列。
model ScheduleSlot {
  id          String             @id @default(cuid())
  characterId String
  character   Character          @relation(fields: [characterId], references: [id], onDelete: Cascade)
  dayType     ScheduleDayType
  startMinute Int // 當天 00:00 起算的分鐘數（0~1440），跨午夜的時段請拆成兩列
  endMinute   Int
  status      ScheduleSlotStatus
  label       String? // 固定行程名稱，例如「社團活動」

  @@map("schedule_slots")
}

// I-1 特殊日：考試週、生日、原作紀念日——當天整天視為 HOLIDAY 作息。
model SpecialDay {
  id          String    @id @default(cuid())
  characterId String
  character   Character @relation(fields: [characterId], references: [id], onDelete: Cascade)
  date        DateTime // 只使用日期部分（比對年/月/日）
  label       String

  @@map("special_days")
}

// I-4 破例規則：記錄每種破例最後一次觸發的時間，供稀有度冷卻判定。
model ScheduleExceptionLog {
  id            String   @id @default(cuid())
  characterId   String
  character     Character @relation(fields: [characterId], references: [id], onDelete: Cascade)
  exceptionType String // LATE_NIGHT_CHAT／SNEAK_REPLY_IN_CLASS／ADJUST_SCHEDULE
  triggeredAt   DateTime @default(now())

  @@map("schedule_exception_logs")
}

model CharacterAlias {
  id             String    @id @default(cuid())
  characterId    String
  character      Character @relation(fields: [characterId], references: [id], onDelete: Cascade)
  formalName     String // 正式名
  nickname       String? // 暱稱
  calledByOthers String? // 他人稱呼（作品中其他角色如何稱呼）
  createdAt      DateTime  @default(now())

  @@map("character_aliases")
}

model EpisodicMemory {
  id               String       @id @default(cuid())
  characterId      String
  character        Character    @relation(fields: [characterId], references: [id], onDelete: Cascade)
  content          String
  occurredAt       DateTime // 發生時間
  emotionTag       EmotionTag
  emotionIntensity Float // 情緒強度
  retrievalCount   Int          @default(0) // 提取次數
  lastRetrievedAt  DateTime?
  source           MemorySource
  weight           Float        @default(1) // 權重（供遺忘／檢索排序使用）
  relatedUserId    String? // 這段記憶與哪位使用者相關（E-5 關係加權檢索用）
  relatedUser      User?        @relation(fields: [relatedUserId], references: [id], onDelete: SetNull)
  isPrivate        Boolean      @default(false) // K-3 隱私邊界：一對一聊過的私密內容，群聊中不主動洩漏（口風不緊原型除外）
  createdAt        DateTime     @default(now())

  @@map("episodic_memories")
}

model SemanticMemory {
  id          String    @id @default(cuid())
  characterId String
  character   Character @relation(fields: [characterId], references: [id], onDelete: Cascade)
  fact        String // 去情境化事實
  about       String // 對象（關於誰／什麼）
  createdAt   DateTime  @default(now())

  @@map("semantic_memories")
}

model ProceduralRule {
  id              String    @id @default(cuid())
  characterId     String
  character       Character @relation(fields: [characterId], references: [id], onDelete: Cascade)
  situation       String // 情境
  responsePattern String // 回應模式
  weight          Float     @default(1)
  createdAt       DateTime  @default(now())
  updatedAt       DateTime  @updatedAt

  @@map("procedural_rules")
}

model EmotionState {
  id          String    @id @default(cuid())
  characterId String    @unique
  character   Character @relation(fields: [characterId], references: [id], onDelete: Cascade)

  calm   Float @default(100) // 平靜
  joy    Float @default(0) // 愉悅
  sad    Float @default(0) // 低落
  alert  Float @default(0) // 警戒
  shy    Float @default(0) // 害羞
  grumpy Float @default(0) // 彆扭

  updatedAt DateTime @updatedAt

  @@map("emotion_states")
}

model Relationship {
  id          String @id @default(cuid())
  characterId String
  character   Character @relation(fields: [characterId], references: [id], onDelete: Cascade)
  userId      String
  user        User      @relation(fields: [userId], references: [id], onDelete: Cascade)

  intimacy         Int               @default(0) // 親密度 0~100（友誼軸：穩定累積、衰減慢）
  trust            Int               @default(0) // 信任度 0~100
  firstMet         DateTime?
  lastInteraction  DateTime?
  interactionCount Int               @default(0)
  stage            RelationshipStage @default(STRANGER)

  // L-1 戀愛軸：與友誼軸（intimacy）獨立，事件驅動、衰減快、易回落。僅限成年角色資格生效後才會被寫入非零值。
  romanceMeter          Int          @default(0) // 心動值 0~100
  romanceStage          RomanceStage @default(NONE)
  lastRomanceEventAt    DateTime?
  awkwardUntil          DateTime? // L-2 告白被拒後的尷尬期：互動變客氣，直到此時間點
  consecutiveRejections Int          @default(0) // L-2 連續告白失敗次數：累積到門檻會真的傷關係
  partnerSince           DateTime? // L-4 進入戀人階段的時間點，用於判斷戀人初期／穩定期
  romanceEventsInStage   Int         @default(0) // L-4 進入目前階段後累積的正向心動事件數，同樣用於判斷穩定期

  ledgerEntries SentimentLedgerEntry[]

  createdAt DateTime @default(now())
  updatedAt DateTime @updatedAt

  @@unique([characterId, userId])
  @@map("relationships")
}

model SentimentLedgerEntry {
  id             String       @id @default(cuid())
  relationshipId String
  relationship   Relationship @relation(fields: [relationshipId], references: [id], onDelete: Cascade)
  date           DateTime
  event          String
  weight         Float // 允許正負：正向事件為正值，負向事件為負值
  createdAt      DateTime     @default(now())

  @@map("sentiment_ledger_entries")
}

// J-1 委託：使用者請角色做的事。執行（觸發準時度）是引擎責任，演出（接案/觸發/追擊的台詞）是角色責任。
model Task {
  id          String     @id @default(cuid())
  characterId String
  character   Character  @relation(fields: [characterId], references: [id], onDelete: Cascade)
  userId      String
  user        User       @relation(fields: [userId], references: [id], onDelete: Cascade)

  type    TaskType
  content String // 委託內容（去除時間片語後的純委託描述，例如「開會」）
  rawText String // 使用者原始輸入，供回顧／記憶引用

  triggerAt      DateTime? // 單次提醒的觸發時間；週期提醒改用 cronExpression
  cronExpression String? // 週期提醒（node-cron 表達式）
  condition      String? // 條件提醒的條件描述（MVP 為文字紀錄，不做真實環境條件監測）

  status      TaskStatus @default(PENDING)
  triggeredAt DateTime? // 最近一次實際觸發的時間
  triggerMessage String? // 最近一次觸發演出的訊息內容（供前端／測試輪詢）

  overdueNudgeCount Int       @default(0) // J-4 逾期追擊次數
  lastNudgeAt       DateTime?

  completedAt DateTime?

  createdAt DateTime @default(now())
  updatedAt DateTime @updatedAt

  @@map("tasks")
}

// J-6 主動關照：記錄每次主動關心的觸發時間與內容，供稀有度節流與「不重複台詞」判定。
model ProactiveCareLog {
  id          String    @id @default(cuid())
  characterId String
  character   Character @relation(fields: [characterId], references: [id], onDelete: Cascade)
  userId      String
  message     String
  triggeredAt DateTime  @default(now())

  @@map("proactive_care_logs")
}