@allbluecn/database 0.4.5 → 0.4.6

package/schema.prisma

@@ -0,0 +1,2014 @@
+generator client {
+  provider = "prisma-client"
+  output   = "./generated"
+}
+
+datasource db {
+  provider = "postgresql"
+}
+
+// 系统配置表
+model SystemSetting {
+  id        String   @id @default(cuid())
+  key       String   @unique
+  value     String   @db.Text
+  category  String   @default("general") // 配置分类
+  desc      String? // 说明
+  createdAt DateTime @default(now())
+  updatedAt DateTime @updatedAt
+
+  @@index([category])
+  @@map("system_settings")
+}
+
+// 用户表
+model User {
+  id            String     @id @default(cuid())
+  email         String     @unique
+  username      String     @unique
+  password      String
+  emailVerified DateTime?
+  image         String?
+  role          Role       @default(USER)
+  status        UserStatus @default(ACTIVE)
+  createdAt     DateTime   @default(now())
+  updatedAt     DateTime   @updatedAt
+  lastLoginAt   DateTime?
+
+  accounts Account[]
+
+  avatarConfig Json?
+  bgShape      String?
+  bgColor      String?
+
+  aiProvider String? // "openrouter" | "openai"
+  aiApiKey   String? // 用户 AI API Key（TODO: 加密存储）
+  aiModel    String? // 默认 "openai/gpt-4o-mini"
+  locale     String? // 用户语言偏好（zh / en），null 表示未设置
+
+  storyDisplayOptions Json? // Story Display Options 个人偏好（URL 无参数时的默认值，跨设备持久化）
+
+  sketchApiToken String?
+  timezone       String? // 用户全局时区，如 "Asia/Shanghai"。null = 浏览器时区
+
+  /// 用户偏好的计费币种（子项目 3 新增）
+  preferredCurrency String @default("usd")
+
+  /// 用户默认 workspace ID（B3 精确化：多 workspace 用户权益判定确定性）
+  defaultWorkspaceId String?
+
+  invitationUses InvitationUse[]
+  loginLogs                     LoginLog[]
+  passwordResetTokens           PasswordResetToken[]
+  prds                          PRD[]
+  tags                          Tag[]
+  knowledgeBases                KnowledgeBase[]
+  knowledgeDocuments            KnowledgeDocument[]
+  knowledgeShares               KnowledgeShareRecord[]
+  legalRegulations              LegalRegulation[]
+  industryCompliances           IndustryCompliance[]
+  dictionaryTerms               DictionaryTerm[]
+  websiteBookmarks              WebsiteBookmark[]
+  bookmarkCategories            BookmarkCategory[]
+  articleFavorites              ArticleFavorite[]
+  anyhubApps                    AnyHubApp[]
+  anyhubMarketApps              AnyHubMarketApp[]
+  reviewedAnyhubRecommendations AnyHubRecommendation[] @relation("reviewedAnyhubRecommendations")
+  anyhubRecommenders            AnyHubRecommender[]
+  prdVersions                   PRDVersion[]
+  reviewComments                ReviewComment[]
+  comments                      Comment[]
+  commentIgnores                CommentIgnore[]
+  reviews                       Review[]               @relation("reviewer")
+  designProjects                DesignProject[]
+  storiesCreated                Story[]                @relation("storyCreator")
+  storiesAssigned               Story[]                @relation("storyAssignee")
+  storiesEdited                 Story[]                @relation("storyEditor")
+  labelsCreated                 Label[]                @relation("labelCreator")
+  storyActivities               StoryActivity[]        @relation("storyActivityUser")
+  storyComments                 StoryComment[]         @relation("storyCommentUser")
+  storyReactions                StoryReaction[]        @relation("storyReactionUser")
+  commentReactions              CommentReaction[]      @relation("commentReactionUser")
+  storyFilterViews              StoryFilterView[]
+  chatThreads                   ChatThread[]
+  aiProviderConfigs             AiProviderConfig[]
+  agentConversations            AgentConversation[]
+  ownedProjects                 Project[]              @relation("projectOwner")
+  projectMemberships  ProjectMember[]
+  projectActivities   ProjectActivity[]
+  ownedWorkspaces     Workspace[]     @relation("workspaceOwner")
+  workspaceMemberships TeamMembership[]   @relation("teamOwner")
+  teamJoined           TeamMembership?    @relation("teamMember")
+  sentInvitations      TeamInvitation[]   @relation("invitationOwner")
+  aiUsageLogs          AiUsageLog[]
+  agents               UserAgent[]
+  skills               UserSkill[]
+
+  issuedLicenses   LicenseKey[]      @relation("LicenseIssuer")
+  ssoMappings      SsoMapping[]
+  roleAssignments  RoleAssignment[]
+  subscription     Subscription?
+
+  @@map("users")
+}
+
+// OAuth 账号关联
+model Account {
+  id                String  @id @default(cuid())
+  userId            String
+  type              String
+  provider          String
+  providerAccountId String
+  refresh_token     String? @db.Text
+  access_token      String? @db.Text
+  expires_at        Int?
+  token_type        String?
+  scope             String?
+  id_token          String? @db.Text
+  session_state     String?
+
+  user User @relation(fields: [userId], references: [id], onDelete: Cascade)
+
+  @@unique([provider, providerAccountId])
+  @@index([userId])
+  @@map("accounts")
+}
+
+// 项目
+model Project {
+  id          String            @id @default(cuid())
+  displayId   String? // 用户层项目ID，全大写字母数字，1-10位
+  name        String
+  description String?
+  icon        String            @default("folder")
+  timezone    String? // 项目时区，null = 跟随用户全局时区
+  ownerId     String
+  owner       User              @relation("projectOwner", fields: [ownerId], references: [id])
+  workspaceId String?
+  workspace   Workspace?        @relation(fields: [workspaceId], references: [id], onDelete: SetNull)
+  members     ProjectMember[]
+  activities  ProjectActivity[]
+  stories     Story[]
+  createdAt   DateTime          @default(now())
+  updatedAt   DateTime          @updatedAt
+
+  @@unique([ownerId, displayId])
+  @@index([ownerId])
+  @@index([workspaceId])
+  @@map("projects")
+}
+
+// 项目成员
+model ProjectMember {
+  id        String   @id @default(cuid())
+  projectId String
+  project   Project  @relation(fields: [projectId], references: [id], onDelete: Cascade)
+  userId    String
+  user      User     @relation(fields: [userId], references: [id], onDelete: Cascade)
+  role      String   @default("member") // owner | admin | member | viewer
+  status    String   @default("active") // active | invited | suspended
+  joinedAt  DateTime @default(now())
+
+  @@unique([projectId, userId])
+  @@index([projectId])
+  @@map("project_members")
+}
+
+// 工作空间（项目的上一级容器）
+model Workspace {
+  id          String   @id @default(cuid())
+  name        String
+  icon        String   @default("folder")
+  description String?
+  ownerId     String
+  owner       User     @relation("workspaceOwner", fields: [ownerId], references: [id])
+  projects    Project[]
+  usageRecords    UsageRecord[]
+  aiUsageLogs     AiUsageLog[]
+  createdAt   DateTime @default(now())
+  updatedAt   DateTime @updatedAt
+
+  ssoProviders     SsoProvider[]
+  customRoles      CustomRole[]
+  auditLogs        AuditLog[]
+
+  @@index([ownerId])
+  @@map("workspaces")
+}
+
+// 团队隶属关系
+model TeamMembership {
+  id        String   @id @default(cuid())
+  ownerId   String
+  owner     User     @relation("teamOwner", fields: [ownerId], references: [id], onDelete: Cascade)
+  memberId  String
+  member    User     @relation("teamMember", fields: [memberId], references: [id], onDelete: Cascade)
+  seatType  String   @default("member")
+  joinedAt  DateTime @default(now())
+  @@unique([memberId])
+  @@index([ownerId])
+  @@map("team_memberships")
+}
+
+// 团队邀请
+model TeamInvitation {
+  id         String    @id @default(cuid())
+  ownerId    String
+  owner      User      @relation("invitationOwner", fields: [ownerId], references: [id], onDelete: Cascade)
+  email      String
+  seatType   String    @default("member")
+  token      String    @unique
+  channel    String    @default("email")
+  status     String    @default("pending")
+  expiresAt  DateTime
+  createdAt  DateTime  @default(now())
+  acceptedBy String?
+  @@unique([ownerId, email])
+  @@index([ownerId])
+  @@index([email])
+  @@map("team_invitations")
+}
+
+// 项目活动记录
+model ProjectActivity {
+  id         String   @id @default(cuid())
+  projectId  String
+  project    Project  @relation(fields: [projectId], references: [id], onDelete: Cascade)
+  userId     String
+  user       User     @relation(fields: [userId], references: [id], onDelete: Cascade)
+  action     String // created | updated | deleted | member_invited | member_joined | member_removed | role_changed | module_viewed
+  targetType String? // project | member | requirement | prd | design | testcase | bug | acceptance
+  targetId   String?
+  metadata   Json?
+  createdAt  DateTime @default(now())
+
+  @@index([projectId, createdAt])
+  @@map("project_activities")
+}
+
+// 对话线程（作为 TanStack AI persistence threadId）
+model ChatThread {
+  id         String   @id @default(cuid())
+  userId     String
+  title      String?
+  isArchived Boolean  @default(false)
+  createdAt  DateTime @default(now())
+  updatedAt  DateTime @updatedAt
+
+  user       User           @relation(fields: [userId], references: [id], onDelete: Cascade)
+  messages   ChatMessage[]
+  runs       ChatRun[]
+  interrupts ChatInterrupt[]
+  generations GenerationRun[]
+  agentId    String?
+  agent      UserAgent? @relation(fields: [agentId], references: [id])
+
+  @@index([userId, updatedAt])
+  @@map("chat_threads")
+}
+
+// 对话消息（TanStack AI messages store）
+model ChatMessage {
+  id         String   @id @default(cuid())
+  threadId   String
+  role       String // "user" | "assistant" | "tool"
+  content    String  @db.Text
+  parts      Json?
+  thinking   String? @db.Text
+  citations  Json?
+  createdAt  DateTime @default(now())
+
+  thread ChatThread @relation(fields: [threadId], references: [id], onDelete: Cascade)
+
+  @@index([threadId, createdAt])
+  @@map("chat_messages")
+}
+
+// 运行记录（TanStack AI runs store）
+model ChatRun {
+  id            String   @id @default(cuid())
+  threadId      String
+  userId        String
+  status        String // running | completed | failed | aborted | interrupted
+  startedAt     DateTime @default(now())
+  finishedAt    DateTime?
+  detachedSince DateTime?
+  usage         Json?
+  error         String?  @db.Text
+
+  thread     ChatThread      @relation(fields: [threadId], references: [id], onDelete: Cascade)
+  interrupts ChatInterrupt[]
+
+  @@index([threadId, startedAt])
+  @@index([userId, status])
+  @@map("chat_runs")
+}
+
+// 中断记录（TanStack AI interrupts store）
+model ChatInterrupt {
+  id         String   @id @default(cuid())
+  runId      String
+  threadId   String
+  userId     String
+  kind       String // tool-approval | generic
+  toolName   String?
+  state      String // pending | resolved | cancelled
+  payload    Json?
+  resolution Json?
+  createdAt  DateTime @default(now())
+  resolvedAt DateTime?
+
+  run ChatRun @relation(fields: [runId], references: [id], onDelete: Cascade)
+  thread ChatThread @relation(fields: [threadId], references: [id], onDelete: Cascade)
+
+  @@index([runId])
+  @@index([threadId, state])
+  @@map("chat_interrupts")
+}
+
+// 媒体生成记录（占位，本轮建表不接入业务）
+model GenerationRun {
+  id         String   @id @default(cuid())
+  threadId   String
+  userId     String
+  kind       String // image | video | speech | transcription
+  status     String // running | completed | failed | interrupted
+  input      Json?
+  result     Json?
+  artifactId String?
+  error      String?  @db.Text
+  startedAt  DateTime @default(now())
+  finishedAt DateTime?
+
+  thread ChatThread @relation(fields: [threadId], references: [id], onDelete: Cascade)
+
+  @@index([threadId, startedAt])
+  @@index([userId, status])
+  @@map("generation_runs")
+}
+
+// 登录日志
+model LoginLog {
+  id        String   @id @default(cuid())
+  userId    String
+  ip        String?
+  userAgent String?
+  location  String? // 地理位置，如 "北京, 中国"；开发环境为 "本地"
+  success   Boolean  @default(true)
+  message   String? // 失败原因（中文），成功时为 null
+  createdAt DateTime @default(now())
+
+  user User @relation(fields: [userId], references: [id], onDelete: Cascade)
+
+  @@map("login_logs")
+}
+
+// 邀请码
+model InvitationCode {
+  id        String   @id @default(cuid())
+  code      String   @unique
+  maxUses   Int      @default(1)
+  usedCount Int      @default(0)
+  expiresAt DateTime
+  createdAt DateTime @default(now())
+
+  uses InvitationUse[]
+
+  @@map("invitation_codes")
+}
+
+// 邀请码使用记录
+model InvitationUse {
+  id     String   @id @default(cuid())
+  codeId String
+  userId String
+  usedAt DateTime @default(now())
+
+  code InvitationCode @relation(fields: [codeId], references: [id], onDelete: Cascade)
+  user User           @relation(fields: [userId], references: [id], onDelete: Cascade)
+
+  @@map("invitation_uses")
+}
+
+// 密码重置令牌
+model PasswordResetToken {
+  id        String    @id @default(cuid())
+  token     String    @unique
+  userId    String
+  expiresAt DateTime
+  usedAt    DateTime?
+  createdAt DateTime  @default(now())
+
+  user User @relation(fields: [userId], references: [id], onDelete: Cascade)
+
+  @@map("password_reset_tokens")
+}
+
+enum Role {
+  SUPER_ADMIN
+  ADMIN
+  USER
+  GUEST
+}
+
+enum UserStatus {
+  ACTIVE
+  INACTIVE
+  BANNED
+}
+
+enum IconType {
+  IMAGE
+  ICON
+}
+
+enum MarketplaceAppStatus {
+  DRAFT
+  PUBLISHED
+  UNPUBLISHED
+}
+
+enum ReviewStatus {
+  PENDING
+  APPROVED
+  REJECTED
+}
+
+enum ShareStatus {
+  ACTIVE
+  EXPIRED
+  DISABLED
+}
+
+// 知识库
+model KnowledgeBase {
+  id          String   @id @default(cuid())
+  name        String
+  description String?  @db.Text
+  icon        String   @default("notebook")
+  tags        Json     @default("[]")
+  visibility  String   @default("private")
+  userId      String
+  isDeleted   Boolean  @default(false)
+  createdAt   DateTime @default(now())
+  updatedAt   DateTime @updatedAt
+
+  user      User                @relation(fields: [userId], references: [id], onDelete: Cascade)
+  documents KnowledgeDocument[]
+
+  @@index([userId])
+  @@map("knowledge_bases")
+}
+
+model KnowledgeDocument {
+  id         String   @id @default(cuid())
+  kbId       String
+  parentId   String?
+  title      String
+  type       String   @default("doc")
+  content    Json     @default("{}")
+  icon       String?
+  isHomepage Boolean  @default(false)
+  sortOrder  Int      @default(0)
+  isDeleted  Boolean  @default(false)
+  createdBy  String
+  tags       Json     @default("[]")
+  properties Json     @default("{}")
+  createdAt  DateTime @default(now())
+  updatedAt  DateTime @updatedAt
+
+  kb            KnowledgeBase       @relation(fields: [kbId], references: [id], onDelete: Cascade)
+  parent        KnowledgeDocument?  @relation("DocumentTree", fields: [parentId], references: [id], onDelete: SetNull)
+  children      KnowledgeDocument[] @relation("DocumentTree")
+  creator       User                @relation(fields: [createdBy], references: [id], onDelete: Cascade)
+  linkedStories StoryDocLink[]      @relation("DocStoryLinks")
+
+  @@index([kbId])
+  @@index([parentId])
+  @@index([kbId, isHomepage])
+  @@map("knowledge_documents")
+}
+
+// PRD 文档表
+model PRD {
+  id          String    @id @default(cuid())
+  icon        String    @default("file") // 图标名称
+  name        String // PRD 名称
+  description String? // 介绍
+  settings    Json? // 文档设置（布局、主题等）
+  userId      String // 所属用户
+  isDeleted   Boolean   @default(false)
+  deletedAt   DateTime?
+  createdAt   DateTime  @default(now())
+  updatedAt   DateTime  @updatedAt
+
+  user               User                @relation(fields: [userId], references: [id], onDelete: Cascade)
+  pages              PRDPage[]
+  versions           PRDVersion[]
+  reviews            Review[]
+  comments           Comment[]
+  shares             Share[]
+  prdTags            PRDTag[]
+  agentConversations AgentConversation[]
+  linkedStories      StoryPrdLink[]      @relation("PrdStoryLinks")
+
+  @@index([userId])
+  @@map("prds")
+}
+
+// Agent 原型生成会话
+model AgentConversation {
+  id        String   @id @default(cuid())
+  userId    String
+  prdId     String
+  title     String   @default("新会话")
+  createdAt DateTime @default(now())
+  updatedAt DateTime @updatedAt
+
+  user     User           @relation(fields: [userId], references: [id], onDelete: Cascade)
+  prd      PRD            @relation(fields: [prdId], references: [id], onDelete: Cascade)
+  messages AgentMessage[]
+
+  @@index([userId, prdId])
+  @@map("agent_conversations")
+}
+
+// Agent 会话消息
+model AgentMessage {
+  id             String   @id @default(cuid())
+  conversationId String
+  role           String // "user" | "assistant"
+  content        String // 消息文本
+  components     Json? // AI 生成的组件数据（assistant 消息）
+  isError        Boolean  @default(false)
+  createdAt      DateTime @default(now())
+
+  conversation AgentConversation @relation(fields: [conversationId], references: [id], onDelete: Cascade)
+
+  @@index([conversationId])
+  @@map("agent_messages")
+}
+
+// 基础组件表（后台维护）
+model Component {
+  id            String   @id @default(cuid())
+  name          String
+  description   String? // 组件描述
+  type          String // "component" | "block" | "template"
+  category      String? // 分类
+  subCategory   String? // 子分类
+  path          String? // 树形分组路径（如 "基础组件/表单/输入框"）
+  defaultWidth  Int      @default(200)
+  defaultHeight Int      @default(40)
+  prototypeKey  String? // unique key for registry lookup (e.g. "text", "button")
+  config        Json // 属性描述 schema（props定义、slots、events）
+  defaultProps  Json? // 默认属性值
+  defaultStyle  Json? // 默认样式
+  preview       String? // 预览图URL
+  version       Int      @default(1)
+  sortOrder     Int      @default(0) // 排序权重（越大越前）
+  source        String   @default("manual") // "npm" | "file" | "manual"
+  sourceId      String? // npm 包名 / 文件名
+  isHidden      Boolean  @default(false) // 隐藏/显示
+  isDeleted     Boolean  @default(false)
+  createdAt     DateTime @default(now())
+  updatedAt     DateTime @updatedAt
+
+  blockItems    BlockComponent[]    @relation("componentRef")
+  instances     ComponentInstance[] @relation("componentRef")
+  componentTags ComponentTag[]
+  tags          String[]            @default([])
+
+  @@index([type, category])
+  @@index([isDeleted])
+  @@index([isHidden])
+  @@index([sortOrder])
+  @@map("components")
+}
+
+// 区块定义表（后台维护）
+model Block {
+  id          String   @id @default(cuid())
+  name        String
+  description String?
+  category    String?
+  isDeleted   Boolean  @default(false)
+  createdAt   DateTime @default(now())
+  updatedAt   DateTime @updatedAt
+
+  items         BlockComponent[]
+  instances     BlockInstance[]  @relation("blockRef")
+  templateItems TemplateBlock[]  @relation("templateBlockRef")
+
+  @@index([isDeleted])
+  @@map("blocks")
+}
+
+// 区块内组件布局
+model BlockComponent {
+  id            String @id @default(cuid())
+  blockId       String
+  componentId   String
+  x             Float  @default(0)
+  y             Float  @default(0)
+  width         Float  @default(100)
+  height        Float  @default(100)
+  zIndex        Int    @default(0)
+  propsOverride Json? // 局部覆写属性
+  styleOverride Json? // 局部覆写样式
+
+  block     Block     @relation(fields: [blockId], references: [id], onDelete: Cascade)
+  component Component @relation("componentRef", fields: [componentId], references: [id])
+
+  @@map("block_components")
+}
+
+// 模板定义表（后台维护）
+model Template {
+  id          String   @id @default(cuid())
+  name        String
+  description String?
+  category    String?
+  isDeleted   Boolean  @default(false)
+  createdAt   DateTime @default(now())
+  updatedAt   DateTime @updatedAt
+
+  items TemplateBlock[]
+
+  @@index([isDeleted])
+  @@map("templates")
+}
+
+// 模板内区块排布
+model TemplateBlock {
+  id         String @id @default(cuid())
+  templateId String
+  blockId    String
+  order      Int    @default(0) // 排布顺序
+  x          Float? @default(0)
+  y          Float? @default(0)
+  width      Float?
+  height     Float?
+
+  template Template @relation(fields: [templateId], references: [id], onDelete: Cascade)
+  block    Block    @relation("templateBlockRef", fields: [blockId], references: [id])
+
+  @@map("template_blocks")
+}
+
+// PRD 页面/目录树节点
+model PRDPage {
+  id        String   @id @default(cuid())
+  prdId     String
+  parentId  String? // 父节点，构建树形结构（null = 根级）
+  name      String
+  order     Int      @default(0) // 排序
+  type      String   @default("page") // "page" | "folder"
+  canvas    Json? // 原型画板数据
+  content   Json? // PRD 文档内容
+  version   Int      @default(1) // 页面版本号
+  createdAt DateTime @default(now())
+  updatedAt DateTime @updatedAt
+
+  prd                PRD                 @relation(fields: [prdId], references: [id], onDelete: Cascade)
+  parent             PRDPage?            @relation("PageHierarchy", fields: [parentId], references: [id], onDelete: Cascade)
+  children           PRDPage[]           @relation("PageHierarchy")
+  componentInstances ComponentInstance[]
+  blockInstances     BlockInstance[]
+  pageVersions       PageVersion[]
+
+  @@index([prdId, order])
+  @@map("prd_pages")
+}
+
+// 组件实例（画布上）
+model ComponentInstance {
+  id              String   @id @default(cuid())
+  pageId          String
+  componentId     String? // null = 已解绑的游离副本
+  blockInstanceId String? // 所属区块实例
+  name            String? // 实例别名
+  x               Float    @default(0)
+  y               Float    @default(0)
+  width           Float    @default(100)
+  height          Float    @default(100)
+  zIndex          Int      @default(0)
+  props           Json? // 局部覆写属性
+  style           Json? // 局部覆写样式
+  createdAt       DateTime @default(now())
+  updatedAt       DateTime @updatedAt
+
+  page          PRDPage        @relation(fields: [pageId], references: [id], onDelete: Cascade)
+  component     Component?     @relation("componentRef", fields: [componentId], references: [id])
+  blockInstance BlockInstance? @relation(fields: [blockInstanceId], references: [id])
+
+  @@index([pageId])
+  @@map("component_instances")
+}
+
+// 区块实例（画布上）
+model BlockInstance {
+  id        String   @id @default(cuid())
+  pageId    String
+  blockId   String? // null = 已解绑的游离副本
+  name      String? // 实例别名
+  x         Float    @default(0)
+  y         Float    @default(0)
+  width     Float    @default(400)
+  height    Float    @default(300)
+  zIndex    Int      @default(0)
+  props     Json? // 局部覆写属性
+  style     Json? // 局部覆写样式
+  createdAt DateTime @default(now())
+  updatedAt DateTime @updatedAt
+
+  page      PRDPage             @relation(fields: [pageId], references: [id], onDelete: Cascade)
+  block     Block?              @relation("blockRef", fields: [blockId], references: [id])
+  instances ComponentInstance[]
+
+  @@index([pageId])
+  @@map("block_instances")
+}
+
+// PRD 版本（手动发布创建）
+model PRDVersion {
+  id            String    @id @default(cuid())
+  prdId         String
+  major         Int       @default(1)
+  minor         Int       @default(0)
+  patch         Int       @default(0)
+  versionLabel  String // 如 "v1", "v1.1", "v1.1.1"
+  parentVersion String? // 上一版本ID（版本链）
+  pageVersions  Json // [{ pageId, pageName, version, canvas, content }]
+  notes         String? // 发版说明
+  userId        String
+  createdAt     DateTime  @default(now())
+  updatedAt     DateTime?
+
+  prd           PRD            @relation(fields: [prdId], references: [id], onDelete: Cascade)
+  user          User           @relation(fields: [userId], references: [id])
+  reviews       Review[]
+  shareVersions ShareVersion[]
+
+  @@index([prdId, createdAt])
+  @@index([userId])
+  @@map("prd_versions")
+}
+
+// 页面版本（独立的页面级别版本历史）
+model PageVersion {
+  id                  String   @id @default(cuid())
+  pageId              String
+  version             Int // 整数版本号，自增
+  notes               String? // 版本说明（用户可编辑）
+  canvas              Json? // 原型快照
+  content             Json? // 文档快照
+  restoredFromVersion Int? // 从哪个版本号还原而来（null 表示非还原版本）
+  fromPRDVersionId    String? // 来源：从哪个 PRD 版本创建（可选标记）
+  createdAt           DateTime @default(now())
+
+  page PRDPage @relation(fields: [pageId], references: [id], onDelete: Cascade)
+
+  @@index([pageId, createdAt])
+  @@index([pageId, version])
+  @@map("page_versions")
+}
+
+// 评审工作流
+model Review {
+  id          String       @id @default(cuid())
+  prdId       String
+  versionId   String
+  status      ReviewStatus @default(PENDING)
+  reviewerId  String?
+  notes       String?
+  createdAt   DateTime     @default(now())
+  completedAt DateTime?
+
+  prd      PRD             @relation(fields: [prdId], references: [id], onDelete: Cascade)
+  version  PRDVersion      @relation(fields: [versionId], references: [id])
+  reviewer User?           @relation("reviewer", fields: [reviewerId], references: [id])
+  comments ReviewComment[]
+
+  @@unique([prdId, versionId])
+  @@index([prdId])
+  @@index([versionId])
+  @@index([reviewerId])
+  @@map("reviews")
+}
+
+// 评审留言
+model ReviewComment {
+  id        String   @id @default(cuid())
+  reviewId  String
+  userId    String
+  content   String   @db.Text
+  pageId    String? // 关联页面
+  elementId String? // 关联具体元素
+  parentId  String? // 回复上级留言
+  createdAt DateTime @default(now())
+
+  review  Review          @relation(fields: [reviewId], references: [id], onDelete: Cascade)
+  user    User            @relation(fields: [userId], references: [id])
+  parent  ReviewComment?  @relation("ReviewCommentReplies", fields: [parentId], references: [id])
+  replies ReviewComment[] @relation("ReviewCommentReplies")
+
+  @@index([reviewId])
+  @@index([userId])
+  @@index([parentId])
+  @@map("review_comments")
+}
+
+// 评论（PRD 级别 / 页面级别 / 元素级别）
+model Comment {
+  id        String   @id @default(cuid())
+  prdId     String
+  pageId    String? // 可选：针对某页面
+  elementId String? // 可选：针对某元素（组件/区块实例ID）
+  userId    String
+  content   String   @db.Text
+  parentId  String? // 回复上级评论
+  position  Json? // 文本选区位置 { from: number, to: number }
+  resolved  Boolean  @default(false)
+  createdAt DateTime @default(now())
+  updatedAt DateTime @updatedAt
+
+  prd     PRD             @relation(fields: [prdId], references: [id], onDelete: Cascade)
+  user    User            @relation(fields: [userId], references: [id])
+  parent  Comment?        @relation("CommentReplies", fields: [parentId], references: [id])
+  replies Comment[]       @relation("CommentReplies")
+  ignores CommentIgnore[]
+
+  @@index([prdId])
+  @@index([userId])
+  @@index([parentId])
+  @@index([pageId])
+  @@map("comments")
+}
+
+model CommentIgnore {
+  id        String   @id @default(cuid())
+  userId    String
+  commentId String
+  createdAt DateTime @default(now())
+
+  user    User    @relation(fields: [userId], references: [id])
+  comment Comment @relation(fields: [commentId], references: [id])
+
+  @@unique([userId, commentId])
+  @@index([userId])
+  @@index([commentId])
+  @@map("comment_ignores")
+}
+
+// 分享链接
+model Share {
+  id          String      @id @default(cuid())
+  prdId       String
+  token       String      @unique
+  type        String      @default("prd") // "prd" | 预留扩展
+  status      ShareStatus @default(ACTIVE)
+  password    String? // 加密分享密码（4位，数字+大写+小写字母）
+  hasPassword Boolean     @default(false)
+  expiresAt   DateTime?
+  createdAt   DateTime    @default(now())
+  updatedAt   DateTime    @updatedAt
+
+  prd           PRD            @relation(fields: [prdId], references: [id], onDelete: Cascade)
+  shareVersions ShareVersion[]
+
+  @@index([token])
+  @@index([prdId, type, status])
+  @@index([status])
+  @@index([expiresAt])
+  @@map("shares")
+}
+
+// 标签表
+model Tag {
+  id        String   @id @default(cuid())
+  name      String
+  color     Int      @default(0)
+  sortOrder Int      @default(0)
+  isHidden  Boolean  @default(false)
+  userId    String
+  createdAt DateTime @default(now())
+  updatedAt DateTime @updatedAt
+
+  user    User     @relation(fields: [userId], references: [id], onDelete: Cascade)
+  prdTags PRDTag[]
+
+  @@unique([name, userId])
+  @@index([sortOrder])
+  @@index([userId])
+  @@map("tags")
+}
+
+// PRD-标签多对多
+model PRDTag {
+  id        String   @id @default(cuid())
+  prdId     String
+  tagId     String
+  createdAt DateTime @default(now())
+
+  prd PRD @relation(fields: [prdId], references: [id], onDelete: Cascade)
+  tag Tag @relation(fields: [tagId], references: [id], onDelete: Cascade)
+
+  @@unique([prdId, tagId])
+  @@index([prdId])
+  @@index([tagId])
+  @@map("prd_tags")
+}
+
+// 组件-标签多对多
+// TODO(ComponentTag 重新调整): Tag 已加 userId，ComponentTag 业务待后续调整。
+// DB 端 FK 已 drop（迁移同步）；component_tags 表保留，tagId 列 + 唯一约束 (componentId, tagId) 保留；
+// 移除 Prisma 关系以避免与新 Tag 语义冲突。
+model ComponentTag {
+  id          String @id @default(cuid())
+  componentId String
+  tagId       String
+
+  component Component @relation(fields: [componentId], references: [id], onDelete: Cascade)
+
+  @@unique([componentId, tagId])
+  @@map("component_tags")
+}
+
+model Reference {
+  id             String   @id @default(uuid())
+  sourceModule   String
+  sourceEntityId String
+  targetModule   String
+  targetEntityId String
+  createdAt      DateTime @default(now())
+
+  @@index([sourceModule, sourceEntityId])
+  @@index([targetModule, targetEntityId])
+  @@map("references")
+}
+
+model ShareVersion {
+  id        String @id @default(cuid())
+  shareId   String
+  versionId String
+
+  share   Share      @relation(fields: [shareId], references: [id], onDelete: Cascade)
+  version PRDVersion @relation(fields: [versionId], references: [id], onDelete: Cascade)
+
+  @@unique([shareId, versionId])
+  @@index([shareId])
+  @@index([versionId])
+  @@map("share_versions")
+}
+
+// ========== AnyHub 模型 ==========
+
+model AnyHubApp {
+  id            String   @id @default(cuid())
+  name          String   @unique
+  displayName   String
+  description   String?  @db.Text
+  version       String   @default("0.1.0")
+  source        String
+  url           String?
+  localPath     String?
+  proxyBasePath String?
+  iconUrl       String?
+  pinned        Boolean  @default(false)
+  status        String   @default("installing")
+  userId        String
+  githubUrl     String?
+  createdAt     DateTime @default(now())
+  updatedAt     DateTime @updatedAt
+
+  user        User               @relation(fields: [userId], references: [id], onDelete: Cascade)
+  permissions AnyHubPermission[]
+
+  @@index([userId])
+  @@index([pinned])
+}
+
+model AnyHubPermission {
+  id         String   @id @default(cuid())
+  appId      String
+  capability String
+  granted    Boolean  @default(false)
+  userId     String
+  createdAt  DateTime @default(now())
+  updatedAt  DateTime @updatedAt
+
+  app AnyHubApp @relation(fields: [appId], references: [id], onDelete: Cascade)
+
+  @@unique([appId, capability, userId])
+  @@index([appId])
+}
+
+model AnyHubMarketApp {
+  id               String               @id @default(cuid())
+  name             String
+  displayName      String
+  description      String?              @db.Text
+  entryUrl         String
+  icon             String?
+  iconType         IconType             @default(ICON)
+  logo             String?
+  category         String?
+  tags             String?              @db.Text
+  downloads        Int                  @default(0)
+  capabilities     Json
+  status           MarketplaceAppStatus @default(DRAFT)
+  publishedAt      DateTime?
+  userId           String
+  recommendationId String?              @unique
+  createdAt        DateTime             @default(now())
+  updatedAt        DateTime             @updatedAt
+
+  user           User                  @relation(fields: [userId], references: [id])
+  recommendation AnyHubRecommendation? @relation("anyhubRecommendation", fields: [recommendationId], references: [id])
+
+  @@index([status])
+  @@index([category])
+}
+
+model AnyHubRecommendation {
+  id               String    @id @default(cuid())
+  githubUrl        String    @unique
+  name             String?
+  displayName      String?
+  description      String?   @db.Text
+  status           String    @default("pending")
+  reviewedBy       String?
+  reviewedAt       DateTime?
+  marketplaceAppId String?
+  createdAt        DateTime  @default(now())
+  updatedAt        DateTime  @updatedAt
+
+  marketplaceApp AnyHubMarketApp?    @relation("anyhubRecommendation")
+  reviewer       User?               @relation("reviewedAnyhubRecommendations", fields: [reviewedBy], references: [id])
+  recommenders   AnyHubRecommender[]
+
+  @@index([status])
+}
+
+model AnyHubRecommender {
+  id               String   @id @default(cuid())
+  recommendationId String
+  userId           String
+  reason           String?
+  createdAt        DateTime @default(now())
+
+  recommendation AnyHubRecommendation @relation(fields: [recommendationId], references: [id], onDelete: Cascade)
+  user           User                 @relation(fields: [userId], references: [id], onDelete: Cascade)
+
+  @@unique([recommendationId, userId])
+}
+
+// 设计稿
+model DesignProject {
+  id         String     @id @default(cuid())
+  name       String
+  documentId String?
+  sketchName String?
+  version    Int        @default(1)
+  userId     String
+  user       User       @relation(fields: [userId], references: [id])
+  artboards  Artboard[]
+  createdAt  DateTime   @default(now())
+  updatedAt  DateTime   @updatedAt
+
+  @@index([userId])
+  @@map("design_projects")
+}
+
+model Artboard {
+  id             String           @id @default(cuid())
+  projectId      String
+  project        DesignProject    @relation(fields: [projectId], references: [id], onDelete: Cascade)
+  name           String
+  pageName       String?
+  width          Int
+  height         Int
+  pngPath        String
+  svgPath        String?
+  annotationJson Json?
+  layerCount     Int?
+  sortOrder      Int              @default(0)
+  createdAt      DateTime         @default(now())
+  exports        ArtboardExport[]
+
+  @@index([projectId])
+  @@map("design_artboards")
+}
+
+model ArtboardExport {
+  id         String   @id @default(cuid())
+  artboardId String
+  artboard   Artboard @relation(fields: [artboardId], references: [id], onDelete: Cascade)
+  layerName  String
+  layerId    String
+  scale      Int
+  format     String   @default("png")
+  filePath   String
+  width      Int
+  height     Int
+
+  @@unique([artboardId, layerId, scale])
+  @@map("design_artboard_exports")
+}
+
+// AI 服务商元数据（admin 维护）
+model AiProvider {
+  id             String   @id @default(cuid())
+  providerId     String   @unique // 业务标识 "openai" "anthropic"，用于 adapter 路由与 AiProviderConfig 软关联
+  displayName    String
+  brandName      String
+  description    String   @db.Text
+  category       String   @default("popular") // recommended|popular|local
+  adapterKind    String // openai|anthropic|gemini|groq|grok|openrouter|ollama|openai-compatible
+  defaultBaseUrl String?
+  keyUrl         String?
+  docsUrl        String?
+  keyPlaceholder String?
+  iconSlug       String?
+  brandColor     String   @default("#6467F2")
+  badge          String? // 卡片角标文案（如「推荐」「热门」「NEW」），admin 可配
+  isLocal        Boolean  @default(false)
+  enabled        Boolean  @default(true) // 平台级开关：停用后未配置用户看不到，已配置用户继续可用
+  models         Json // AiModelMeta[]（admin 可编辑）
+  sortOrder      Int      @default(0)
+  createdAt      DateTime @default(now())
+  updatedAt      DateTime @updatedAt
+
+  @@map("ai_providers")
+}
+
+// 用户级 AI 服务商配置
+model AiProviderConfig {
+  id           String   @id @default(cuid())
+  userId       String
+  providerId   String // 业务 providerId，软关联 AiProvider.providerId（不设外键 cascade，避免 admin 删除丢失用户配置）
+  apiKey       String?  @db.Text // 加密存储 TODO
+  baseUrl      String?
+  enabled      Boolean  @default(false) // 用户级开关：是否在对话模型选择器中暴露
+  models       Json? // string[] 用户启用的模型 ID（有序，顺序 = 模型选择器展示顺序）
+  customModels Json? // AiModelMeta[] 用户私有的自定义/刷新获取的模型元数据，与 AiProvider.models 取并集按 id 去重
+  createdAt    DateTime @default(now())
+  updatedAt    DateTime @updatedAt
+
+  user User @relation(fields: [userId], references: [id], onDelete: Cascade)
+
+  @@unique([userId, providerId])
+  @@index([userId])
+  @@index([providerId])
+  @@map("ai_provider_configs")
+}
+
+// 第三方依赖版本管理（admin 决策是否升级）
+// currentVersion 实时读 monorepo 各 package.json，不存 DB；latestVersion 缓存自 npm registry
+model ThirdPartyDependency {
+  id              String    @id @default(cuid())
+  name            String    @unique // npm 包名，如 "@tiptap/core" / "mind-elixir"
+  displayName     String? // 展示名（默认取 name）
+  description     String?   @db.Text // 依赖用途说明（admin 可编辑）
+  homepage        String? // 官网 / 仓库
+  category        String    @default("other") // framework|ui|editor|ai|state|tool|other
+  isWatched       Boolean   @default(true) // 是否置顶「关注列表」
+  priority        String    @default("normal") // high|normal|low
+  latestVersion   String? // 缓存的 npm registry latest 版本
+  latestChangelog String?   @db.Text // 最新版本的更新日志（来自 GitHub Releases，markdown）
+  lastSyncAt      DateTime? // 最后一次成功同步 npm registry 的时间
+  notes           String?   @db.Text // 备注（升级注意事项等）
+  sortOrder       Int       @default(0)
+  createdAt       DateTime  @default(now())
+  updatedAt       DateTime  @updatedAt
+
+  @@index([category])
+  @@index([isWatched])
+  @@map("third_party_dependencies")
+}
+
+// ============ 公共知识库:法律法规 ============
+model LegalRegulation {
+  id               String    @id @default(cuid())
+  canonicalId      String
+  title            String
+  jurisdiction     String
+  region           String?
+  country          String?
+  category         String
+  issuingAuthority String?
+  effectiveDate    DateTime?
+  summary          String?   @db.Text
+  content          String?   @db.Text
+  sourceUrl        String?
+  likeCount        Int       @default(0)
+  tags             Json      @default("[]")
+  visibility       String    @default("private")
+  userId           String
+  isDeleted        Boolean   @default(false)
+  createdAt        DateTime  @default(now())
+  updatedAt        DateTime  @updatedAt
+
+  user User @relation(fields: [userId], references: [id], onDelete: Cascade)
+
+  @@index([canonicalId, visibility])
+  @@index([userId, visibility])
+  @@index([jurisdiction, category])
+  @@map("legal_regulations")
+}
+
+model IndustryCompliance {
+  id             String   @id @default(cuid())
+  canonicalId    String
+  title          String
+  industry       String
+  regulatoryBody String?
+  region         String?
+  summary        String?  @db.Text
+  content        String?  @db.Text
+  requirements   Json     @default("[]")
+  sourceUrl      String?
+  likeCount      Int      @default(0)
+  tags           Json     @default("[]")
+  visibility     String   @default("private")
+  userId         String
+  isDeleted      Boolean  @default(false)
+  createdAt      DateTime @default(now())
+  updatedAt      DateTime @updatedAt
+
+  user User @relation(fields: [userId], references: [id], onDelete: Cascade)
+
+  @@index([canonicalId, visibility])
+  @@index([userId, visibility])
+  @@index([industry])
+  @@map("industry_compliances")
+}
+
+model DictionaryTerm {
+  id           String   @id @default(cuid())
+  canonicalId  String
+  title        String
+  industry     String
+  definition   String?  @db.Text
+  aliases      Json     @default("[]")
+  examples     Json     @default("[]")
+  referenceUrl String?
+  tags         Json     @default("[]")
+  visibility   String   @default("private")
+  userId       String
+  isDeleted    Boolean  @default(false)
+  createdAt    DateTime @default(now())
+  updatedAt    DateTime @updatedAt
+
+  user User @relation(fields: [userId], references: [id], onDelete: Cascade)
+
+  @@index([canonicalId, visibility])
+  @@index([userId, visibility])
+  @@index([title])
+  @@map("dictionary_terms")
+}
+
+model WebsiteBookmark {
+  id                  String    @id @default(cuid())
+  canonicalId         String
+  title               String
+  url                 String
+  categoryId          String?
+  summary             String?   @db.Text
+  faviconUrl          String?
+  faviconSyncedAt     DateTime?
+  isGithub            Boolean   @default(false)
+  githubOwner         String?
+  githubRepo          String?
+  githubStars         Int?
+  githubLatestVersion String?
+  githubVersionDate   DateTime?
+  githubRepoUpdatedAt DateTime?
+  githubSyncedAt      DateTime?
+  tags                Json      @default("[]")
+  visibility          String    @default("private")
+  userId              String
+  isDeleted           Boolean   @default(false)
+  createdAt           DateTime  @default(now())
+  updatedAt           DateTime  @updatedAt
+
+  user     User              @relation(fields: [userId], references: [id], onDelete: Cascade)
+  category BookmarkCategory? @relation(fields: [categoryId], references: [id], onDelete: SetNull)
+
+  @@index([canonicalId, visibility])
+  @@index([userId, visibility])
+  @@index([categoryId])
+  @@index([isGithub])
+  @@map("website_bookmarks")
+}
+
+model BookmarkCategory {
+  id        String   @id @default(cuid())
+  name      String
+  icon      String   @default("Globe")
+  sortOrder Int      @default(0)
+  isDefault Boolean  @default(false)
+  userId    String?
+  createdAt DateTime @default(now())
+  updatedAt DateTime @updatedAt
+
+  user      User?             @relation(fields: [userId], references: [id], onDelete: Cascade)
+  bookmarks WebsiteBookmark[]
+
+  @@unique([userId, name])
+  @@index([userId])
+  @@map("bookmark_categories")
+}
+
+model KnowledgeShareRecord {
+  id          String   @id @default(cuid())
+  entityType  String
+  canonicalId String
+  userId      String
+  sharedAt    DateTime @default(now())
+
+  user User @relation(fields: [userId], references: [id], onDelete: Cascade)
+
+  @@unique([entityType, canonicalId, userId])
+  @@index([entityType, canonicalId])
+  @@map("knowledge_share_records")
+}
+
+model ArticleFavorite {
+  id         String   @id @default(cuid())
+  entityType String
+  entityId   String
+  userId     String
+  createdAt  DateTime @default(now())
+
+  user User @relation(fields: [userId], references: [id], onDelete: Cascade)
+
+  @@unique([entityType, entityId, userId])
+  @@index([userId, entityType])
+  @@map("article_favorites")
+}
+
+// 需求
+model Story {
+  id          String          @id @default(cuid())
+  sequenceId  Int
+  boardOrder  Int         @default(0)
+  identifier  String
+  projectId   String
+  project     Project        @relation(fields: [projectId], references: [id], onDelete: Restrict)
+  name        String
+  description String?         @db.Text
+  state       String          @default("backlog")
+  priority    String          @default("none")
+  archived    Boolean         @default(false)
+  archivedAt  DateTime?
+  assigneeId  String?
+  assignee    User?           @relation("storyAssignee", fields: [assigneeId], references: [id], onDelete: SetNull)
+  startDate   DateTime?
+  targetDate  DateTime?
+  createdById String
+  createdBy   User            @relation("storyCreator", fields: [createdById], references: [id])
+  updatedById String?
+  updatedBy   User?           @relation("storyEditor", fields: [updatedById], references: [id], onDelete: SetNull)
+  labels      StoryLabel[]
+  activities  StoryActivity[]
+  comments    StoryComment[]
+  reactions   StoryReaction[]
+  createdAt   DateTime        @default(now())
+  updatedAt   DateTime        @updatedAt
+
+  parentId             String?
+  parent               Story?            @relation("StoryHierarchy", fields: [parentId], references: [id], onDelete: SetNull)
+  children             Story[]           @relation("StoryHierarchy")
+  dependenciesAsSource StoryDependency[] @relation("DependencySource")
+  dependenciesAsTarget StoryDependency[] @relation("DependencyTarget")
+  links                StoryLink[]
+  attachments          StoryAttachment[]
+  linkedPrds           StoryPrdLink[]    @relation("StoryPrdLinks")
+  linkedDocs           StoryDocLink[]    @relation("StoryDocLinks")
+
+  @@unique([identifier])
+  @@index([projectId, sequenceId])
+  @@index([state])
+  @@index([archived])
+  @@index([archived, state, createdAt])
+  @@index([assigneeId])
+  @@index([createdById])
+  @@map("stories")
+}
+
+// 全局标签
+model Label {
+  id          String       @id @default(cuid())
+  name        String       @unique
+  color       String       @default("#6b7280")
+  createdById String
+  createdBy   User         @relation("labelCreator", fields: [createdById], references: [id])
+  stories     StoryLabel[]
+  createdAt   DateTime     @default(now())
+
+  @@map("labels")
+}
+
+model StoryLabel {
+  storyId String
+  labelId String
+  story   Story  @relation(fields: [storyId], references: [id], onDelete: Cascade)
+  label   Label  @relation(fields: [labelId], references: [id], onDelete: Cascade)
+
+  @@id([storyId, labelId])
+  @@index([labelId])
+  @@map("story_labels")
+}
+
+model StoryActivity {
+  id        String   @id @default(cuid())
+  storyId   String
+  story     Story    @relation(fields: [storyId], references: [id], onDelete: Cascade)
+  userId    String
+  user      User     @relation("storyActivityUser", fields: [userId], references: [id])
+  action    String
+  field     String?
+  oldValue  String?  @db.Text
+  newValue  String?  @db.Text
+  isAI      Boolean  @default(false)
+  metadata  Json?
+  createdAt DateTime @default(now())
+
+  @@index([storyId, createdAt])
+  @@map("story_activities")
+}
+
+model SequenceCounter {
+  id    String @id @default(cuid())
+  scope String @unique
+  seq   Int    @default(0)
+
+  @@map("sequence_counters")
+}
+
+model StoryComment {
+  id        String            @id @default(cuid())
+  storyId   String
+  story     Story             @relation(fields: [storyId], references: [id], onDelete: Cascade)
+  userId    String
+  user      User              @relation("storyCommentUser", fields: [userId], references: [id])
+  parentId  String?
+  parent    StoryComment?     @relation("CommentReply", fields: [parentId], references: [id], onDelete: Cascade)
+  replies   StoryComment[]    @relation("CommentReply")
+  content   String            @db.Text
+  reactions CommentReaction[]
+  createdAt DateTime          @default(now())
+  updatedAt DateTime          @updatedAt
+
+  @@index([storyId, createdAt])
+  @@index([parentId])
+  @@map("story_comments")
+}
+
+model StoryReaction {
+  id        String   @id @default(cuid())
+  storyId   String
+  story     Story    @relation(fields: [storyId], references: [id], onDelete: Cascade)
+  userId    String
+  user      User     @relation("storyReactionUser", fields: [userId], references: [id])
+  emoji     String
+  createdAt DateTime @default(now())
+
+  @@unique([storyId, userId, emoji])
+  @@index([storyId])
+  @@map("story_reactions")
+}
+
+model CommentReaction {
+  id        String       @id @default(cuid())
+  commentId String
+  comment   StoryComment @relation(fields: [commentId], references: [id], onDelete: Cascade)
+  userId    String
+  user      User         @relation("commentReactionUser", fields: [userId], references: [id])
+  emoji     String
+  createdAt DateTime     @default(now())
+
+  @@unique([commentId, userId, emoji])
+  @@index([commentId])
+  @@map("comment_reactions")
+}
+
+model StoryDependency {
+  id        String         @id @default(cuid())
+  sourceId  String
+  targetId  String
+  type      DependencyType
+  createdAt DateTime       @default(now())
+  updatedAt DateTime       @updatedAt
+
+  source Story @relation("DependencySource", fields: [sourceId], references: [id], onDelete: Cascade)
+  target Story @relation("DependencyTarget", fields: [targetId], references: [id], onDelete: Cascade)
+
+  @@unique([sourceId, targetId, type])
+  @@index([sourceId])
+  @@index([targetId])
+  @@map("story_dependencies")
+}
+
+model StoryLink {
+  id          String   @id @default(cuid())
+  storyId     String
+  url         String
+  title       String?
+  description String?
+  createdAt   DateTime @default(now())
+  updatedAt   DateTime @updatedAt
+
+  story Story @relation(fields: [storyId], references: [id], onDelete: Cascade)
+
+  @@index([storyId])
+  @@map("story_links")
+}
+
+model StoryAttachment {
+  id         String   @id @default(cuid())
+  storyId    String
+  fileName   String
+  fileSize   BigInt
+  mimeType   String
+  storageUrl String
+  createdAt  DateTime @default(now())
+
+  story Story @relation(fields: [storyId], references: [id], onDelete: Cascade)
+
+  @@index([storyId])
+  @@map("story_attachments")
+}
+
+model StoryPrdLink {
+  id        String   @id @default(cuid())
+  storyId   String
+  prdId     String
+  createdAt DateTime @default(now())
+
+  story Story @relation("StoryPrdLinks", fields: [storyId], references: [id], onDelete: Cascade)
+  prd   PRD   @relation("PrdStoryLinks", fields: [prdId], references: [id], onDelete: Cascade)
+
+  @@unique([storyId, prdId])
+  @@index([storyId])
+  @@index([prdId])
+  @@map("story_prd_links")
+}
+
+model StoryDocLink {
+  id        String   @id @default(cuid())
+  storyId   String
+  docId     String
+  createdAt DateTime @default(now())
+
+  story Story             @relation("StoryDocLinks", fields: [storyId], references: [id], onDelete: Cascade)
+  doc   KnowledgeDocument @relation("DocStoryLinks", fields: [docId], references: [id], onDelete: Cascade)
+
+  @@unique([storyId, docId])
+  @@index([storyId])
+  @@index([docId])
+  @@map("story_doc_links")
+}
+
+enum DependencyType {
+  BLOCKS
+  BLOCKED_BY
+  RELATES_TO
+}
+
+// 需求模块保存视图（per-user 私有）
+model StoryFilterView {
+  id             String   @id @default(cuid())
+  userId         String
+  name           String
+  description    String?
+  icon           String   @default("list")
+  projectId      String?
+  filters        Json
+  displayOptions Json
+  sortOrder      Int      @default(0)
+  createdAt      DateTime @default(now())
+  updatedAt      DateTime @updatedAt
+
+  user User @relation(fields: [userId], references: [id], onDelete: Cascade)
+
+  @@index([userId])
+  @@map("story_filter_views")
+}
+
+// ==================== 监控可观测性模块 ====================
+
+model MonitoringRequestLog {
+  id        String   @id @default(cuid())
+  timestamp DateTime @default(now())
+  method    String   @db.VarChar(10)
+  path      String   @db.VarChar(512)
+  status    Int
+  duration  Int
+  ip        String?  @db.VarChar(45)
+  userAgent String?  @db.Text
+
+  @@index([timestamp], map: "idx_request_log_timestamp")
+  @@index([path, timestamp], map: "idx_request_log_path_ts")
+  @@map("monitoring_request_logs")
+}
+
+model MonitoringErrorReport {
+  id           String   @id @default(cuid())
+  timestamp    DateTime @default(now())
+  errorName    String   @db.VarChar(128)
+  errorMessage String   @db.Text
+  stackTrace   String?  @db.Text
+  count        Int      @default(1)
+  firstSeen    DateTime @default(now())
+  lastSeen     DateTime @default(now())
+  context      Json     @default("{}")
+
+  @@index([errorName], map: "idx_error_report_name")
+  @@index([lastSeen], map: "idx_error_report_last_seen")
+  @@map("monitoring_error_reports")
+}
+
+model MonitoringMetricsSnapshot {
+  id          String   @id @default(cuid())
+  recordedAt  DateTime @default(now())
+  metricName  String   @db.VarChar(256)
+  count       Int
+  avg         Float
+  p50         Float
+  p95         Float
+  p99         Float
+  min         Float
+  max         Float
+
+  @@index([metricName, recordedAt], map: "idx_metrics_name_ts")
+  @@map("monitoring_metrics_snapshots")
+}
+
+model MonitoringHealthSnapshot {
+  id            String   @id @default(cuid())
+  timestamp     DateTime @default(now())
+  status        String   @db.VarChar(16)
+  uptimeSeconds Float
+  memoryUsage   Json
+  dbStatus      String   @db.VarChar(16)
+  dbLatencyMs   Int?
+
+  @@index([timestamp], map: "idx_health_snapshot_ts")
+  @@map("monitoring_health_snapshots")
+}
+
+// ── 子项目 2：托管 AI 与 BYOK 统一层 ──
+
+/// 订阅计划定义（seed 数据）
+model Plan {
+  id             String   @id @default(cuid())
+  name           String   @unique
+  displayName    String
+  description    String?
+  priceMonthly   Int      @default(0)
+  priceYearly    Int?
+  currency       String   @default("usd")
+  maxSeats       Int?
+  maxGuestSeats  Int?
+  maxWorkspaces  Int?
+  aiQuotaMonthly Int?
+  features       Json
+  isPublic       Boolean  @default(true)
+  sortOrder      Int      @default(0)
+  createdAt      DateTime @default(now())
+  updatedAt      DateTime @updatedAt
+
+  /// Provider 产品与价格同步（子项目 3 新增）
+  /// ⚠ stripeProductId 已删除：Creem 无独立产品概念，一个价格点 = 一个产品
+  providerPriceIdUsd       String?
+  providerPriceIdCny       String?
+  providerPriceIdUsdYearly String?
+  providerPriceIdCnyYearly String?
+
+  /// 席位加购（P2 新增）：每席位/月单价（分），null = 不可加购
+  seatPriceMonthly Int?
+
+  /// 席位加购 Provider Price（P2 新增，per-seat/monthly interval）
+  providerSeatPriceIdUsd String?
+  providerSeatPriceIdCny String?
+
+  agentQuota Int?
+  skillQuota Int?
+
+  subscriptions Subscription[]
+
+  @@map("plans")
+}
+
+/// 订阅记录（User 级，一人一订阅）
+model Subscription {
+  id          String             @id @default(cuid())
+  userId      String             @unique
+  user        User               @relation(fields: [userId], references: [id])
+  planId      String
+  plan        Plan               @relation(fields: [planId], references: [id])
+  status      SubscriptionStatus @default(ACTIVE)
+
+  /// 席位加购数量（账号级）。实际上限 = plan.maxSeats + addonSeats。
+  addonSeats Int @default(0)
+
+  provider                 String    @default("creem")
+  providerCustomerId       String?
+  providerSubscriptionId   String?   @unique
+  providerPriceId          String?
+  providerSeatSubscriptionId String?
+
+  currentPeriodStart   DateTime?
+  currentPeriodEnd     DateTime?
+  cancelAtPeriodEnd    Boolean            @default(false)
+  canceledAt           DateTime?
+  trialEndsAt          DateTime?
+
+  createdAt   DateTime @default(now())
+  updatedAt   DateTime @updatedAt
+
+  /// 关联发票（子项目 3 新增）
+  invoices Invoice[]
+
+  @@map("subscriptions")
+}
+
+enum SubscriptionStatus {
+  TRIALING
+  ACTIVE
+  PAST_DUE
+  CANCELED
+  EXPIRED
+  UNPAID
+}
+
+/// 用量记录（按月聚合，用于额度判断）
+model UsageRecord {
+  id          String      @id @default(cuid())
+  workspaceId String
+  workspace   Workspace   @relation(fields: [workspaceId], references: [id])
+  metric      UsageMetric
+  period      String
+  count       Int         @default(0)
+  resetAt     DateTime
+
+  createdAt   DateTime    @default(now())
+  updatedAt   DateTime    @updatedAt
+
+  @@unique([workspaceId, metric, period])
+  @@index([workspaceId, metric])
+  @@map("usage_records")
+}
+
+enum UsageMetric {
+  AI_CALL
+  STORAGE_MB
+  SEAT
+}
+
+/// AI 用量明细（按次扣减 + 成本审计）
+model AiUsageLog {
+  id           String   @id @default(cuid())
+  workspaceId  String
+  workspace    Workspace @relation(fields: [workspaceId], references: [id])
+  userId       String
+  user         User     @relation(fields: [userId], references: [id])
+  source       String   @default("byok")
+  provider     String
+  model        String
+  inputTokens  Int      @default(0)
+  outputTokens Int      @default(0)
+  costUsd      Decimal? @db.Decimal(10, 6)
+  success      Boolean  @default(true)
+  errorMessage String?
+  durationMs   Int?
+
+  createdAt    DateTime @default(now())
+
+  @@index([workspaceId, createdAt])
+  @@index([userId, createdAt])
+  @@index([workspaceId, source, createdAt])
+  @@index([workspaceId, success, createdAt])
+  @@map("ai_usage_logs")
+}
+
+// ── 子项目 3：计费与订阅系统 ──
+
+/// 账单记录（Webhook 同步）
+model Invoice {
+  id               String       @id @default(cuid())
+  subscriptionId   String
+  subscription     Subscription @relation(fields: [subscriptionId], references: [id])
+  providerInvoiceId  String      @unique
+  providerEventId    String?
+  amountDue        Int
+  amountPaid       Int
+  currency         String       @default("usd")
+  status           String
+  pdfUrl           String?
+  hostedInvoiceUrl String?
+  periodStart      DateTime
+  periodEnd        DateTime
+  paidAt           DateTime?
+
+  createdAt        DateTime     @default(now())
+
+  @@index([subscriptionId, createdAt])
+  @@map("invoices")
+}
+
+/// Provider Webhook 事件幂等记录
+model ProviderEvent {
+  id              String   @id @default(cuid())
+  providerEventId String   @unique
+  type            String
+  status          String   @default("processing")
+  payload         Json?
+  errorMessage    String?
+  processedAt     DateTime? @db.Timestamptz
+
+  createdAt       DateTime @default(now()) @db.Timestamptz
+
+  @@index([type, createdAt])
+  @@map("provider_events")
+}
+
+// ==================== 子项目 5：企业治理模型 ====================
+
+// 企业版 License（自部署企业版验证）
+model LicenseKey {
+  id            String              @id @default(cuid())
+  key           String              @unique
+  signature     String
+  payload       Json
+  customerId    String
+  customerName  String
+  customerEmail String
+  plan          String              @default("enterprise")
+  seats         Int
+  features      Json
+  issuedAt      DateTime            @default(now())
+  expiresAt     DateTime?
+  revokedAt     DateTime?
+  issuedById    String?
+  issuedBy      User?               @relation("LicenseIssuer", fields: [issuedById], references: [id])
+  activations   LicenseActivation[]
+
+  @@map("license_keys")
+}
+
+model LicenseActivation {
+  id          String     @id @default(cuid())
+  licenseId   String
+  license     LicenseKey @relation(fields: [licenseId], references: [id])
+  instanceId  String     @unique
+  fingerprint String
+  activatedAt DateTime   @default(now())
+  lastSeenAt  DateTime?
+  revokedAt   DateTime?
+
+  @@map("license_activations")
+}
+
+// 审计日志
+model AuditLog {
+  id           String     @id @default(cuid())
+  workspaceId  String?
+  workspace    Workspace? @relation(fields: [workspaceId], references: [id])
+  userId       String?
+  action       String
+  resourceType String
+  resourceId   String?
+  metadata     Json
+  ip           String?
+  userAgent    String?
+  createdAt    DateTime @default(now())
+
+  @@index([workspaceId, createdAt])
+  @@index([userId, createdAt])
+  @@index([action])
+  @@map("audit_logs")
+}
+
+// SSO Provider 配置
+model SsoProvider {
+  id           String      @id @default(cuid())
+  workspaceId  String
+  workspace    Workspace   @relation(fields: [workspaceId], references: [id])
+  type         String
+  name         String
+  config       Json
+  domain       String?
+  enabled      Boolean     @default(true)
+  createdAt    DateTime    @default(now())
+  updatedAt    DateTime    @updatedAt
+  mappings     SsoMapping[]
+
+  @@unique([workspaceId, type, domain])
+  @@map("sso_providers")
+}
+
+model SsoMapping {
+  id         String      @id @default(cuid())
+  providerId String
+  provider   SsoProvider @relation(fields: [providerId], references: [id])
+  externalId String
+  userId     String
+  user       User        @relation(fields: [userId], references: [id])
+  email      String?
+  createdAt  DateTime    @default(now())
+
+  @@unique([providerId, externalId])
+  @@map("sso_mappings")
+}
+
+// 自定义角色
+model CustomRole {
+  id          String          @id @default(cuid())
+  workspaceId String
+  workspace   Workspace       @relation(fields: [workspaceId], references: [id])
+  name        String
+  permissions Json
+  isSystem    Boolean         @default(false)
+  createdAt   DateTime        @default(now())
+  updatedAt   DateTime        @updatedAt
+  assignments RoleAssignment[]
+
+  @@unique([workspaceId, name])
+  @@map("custom_roles")
+}
+
+model RoleAssignment {
+  id        String    @id @default(cuid())
+  roleId    String
+  role      CustomRole @relation(fields: [roleId], references: [id])
+  userId    String
+  user      User      @relation(fields: [userId], references: [id])
+  createdAt DateTime  @default(now())
+
+  @@unique([roleId, userId])
+  @@map("role_assignments")
+}
+
+// 合规导出任务
+model ComplianceExport {
+  id          String    @id @default(cuid())
+  type        String
+  scope       String
+  targetId    String
+  status      String    @default("pending")
+  downloadUrl String?
+  expiresAt   DateTime?
+  error       String?
+  content     String?
+  requestedBy String?
+  createdAt   DateTime  @default(now())
+  completedAt DateTime?
+
+  @@map("compliance_exports")
+}
+
+// P6 用户自定义 Agent（人设/工具/模型/温度/开场白/建议问题/知识库绑定）
+model UserAgent {
+  id               String   @id @default(cuid())
+  userId           String
+  name             String
+  description      String?
+  avatarEmoji      String?
+  systemPrompt     String   @db.Text
+  allowedTools     Json     @default("[]")
+  model            String?
+  temperature      Float?
+  greeting         String?  @db.Text
+  suggestedPrompts Json?
+  knowledgeBaseIds Json     @default("[]")
+  createdAt        DateTime @default(now())
+  updatedAt        DateTime @updatedAt
+  isDeleted        Boolean  @default(false)
+
+  user    User         @relation(fields: [userId], references: [id], onDelete: Cascade)
+  threads ChatThread[]
+
+  @@index([userId])
+  @@map("user_agents")
+}
+
+// P6 用户自定义 Skill（斜杠指令模板）
+model UserSkill {
+  id        String   @id @default(cuid())
+  userId    String
+  name      String
+  title     String
+  template  String   @db.Text
+  createdAt DateTime @default(now())
+  updatedAt DateTime @updatedAt
+  isDeleted Boolean  @default(false)
+
+  user User @relation(fields: [userId], references: [id], onDelete: Cascade)
+
+  @@unique([userId, name])
+  @@map("user_skills")
+}