// 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") }