node-resource-utils 0.0.0-stage → 1.1.7

package/resources/prisma/schema.prisma

@@ -0,0 +1,336 @@
+// ============================================================================
+// 业务系统数据模型（SQLite / Prisma 7）
+//
+// 约定：
+//   - SQLite 不支持 enum，一律用 String / Int + 注释说明取值
+//   - 主键统一 cuid()
+//   - 业务表带 createdAt / updatedAt
+//   - 逻辑删除用 deletedAt（null = 未删除），便于审计与恢复
+//   - 多对多用显式中间表（RoleMenu / UserRole），便于日后加扩展字段
+// ============================================================================
+
+generator client {
+  provider = "prisma-client-js"
+}
+
+// Prisma 7 起 datasource 里不再允许写 url（写了报 P1012），连接串在 prisma.config.ts
+datasource db {
+  provider = "sqlite"
+}
+
+// ---------------------------------------------------------------- 组织与账号
+
+model Department {
+  id        String       @id @default(cuid())
+  name      String
+  code      String       @unique
+  parentId  String?
+  parent    Department?  @relation("DeptTree", fields: [parentId], references: [id])
+  children  Department[] @relation("DeptTree")
+  sort      Int          @default(0)
+  status    Int          @default(1) // 1 启用 0 停用
+  remark    String?
+  createdAt DateTime     @default(now())
+  updatedAt DateTime     @updatedAt
+
+  users     User[]
+  employees Employee[]
+
+  @@index([parentId])
+}
+
+model User {
+  id        String        @id @default(cuid())
+  username  String        @unique // 用户名
+  password  String // bcrypt 哈希，永远不要存明文
+  name      String        // 姓名
+  email     String?
+  phone     String?
+  avatar    String?
+  deptId    String?
+  dept      Department?   @relation(fields: [deptId], references: [id])
+  status    Int           @default(1) // 1 启用 0 停用
+  isSuper   Int           @default(0) // 1 = 超级管理员，绕过权限校验
+  /// 密保问题（创建账号时设置；忘记密码可凭问题 + 答案自助找回）
+  securityQuestion String?
+  /// 密保答案的 bcrypt 哈希；空 = 未设置密保。
+  /// 列名带 Hash 是刻意的：graph-schema / AI 工具的敏感字段过滤按 /hash/ 匹配，
+  /// 避免图谱详情或 AI 查询把答案哈希带出去。
+  securityAnswerHash String?
+  /// 1 = 密码被管理员重置，下次登录必须先修改密码
+  mustChangePassword Int       @default(0)
+  lastLogin DateTime?
+  remark    String?
+  deletedAt DateTime?
+  createdAt DateTime      @default(now())
+  updatedAt DateTime      @updatedAt
+
+  roles     UserRole[]
+  logs      OperationLog[]
+  favorites UserFavorite[]
+  feedbacks Feedback[]
+  notifications Notification[]
+
+  @@index([deptId])
+  @@index([deletedAt])
+}
+
+/// 用户收藏（书签）：把常用功能固定到侧边栏顶部，一键直达。
+///
+/// 为什么存 path 而不是 menuId：菜单主键是 cuid()，重跑 seed 会重新生成，
+/// 收藏会集体失效；path（如 /system/users）稳定且天然可跳转。
+/// 名称、图标、面包屑一律在渲染时用菜单树反查 —— 于是菜单改名、权限收回、
+/// 功能开关关闭这三种情况都会自动跟随，收藏表里不需要存任何冗余文案。
+model UserFavorite {
+  id        String   @id @default(cuid())
+  userId    String
+  user      User     @relation(fields: [userId], references: [id], onDelete: Cascade)
+  path      String // 收藏的路由，必须来自当前用户可见的菜单树
+  sort      Int      @default(0) // 预留：日后支持拖拽排序
+  createdAt DateTime @default(now())
+
+  @@unique([userId, path]) // 同一个人同一页只能收藏一次
+  @@index([userId])
+}
+
+model Role {
+  id          String   @id @default(cuid())
+  code        String   @unique
+  name        String
+  description String?
+  sort        Int      @default(0)
+  status      Int      @default(1)
+  /// 数据范围（行级可见性）：1 全部 / 2 本部门及下级 / 3 本部门 / 4 仅本人
+  /// 一个用户挂多个角色时取最宽的一档（数值最小者生效）；超级管理员恒为全部。
+  /// 与菜单权限（RoleMenu）正交：菜单决定「能不能进这个页面」，它决定「进去能看见哪些行」。
+  dataScope   Int      @default(2)
+  createdAt   DateTime @default(now())
+  updatedAt   DateTime @updatedAt
+
+  users UserRole[]
+  menus RoleMenu[]
+}
+
+model UserRole {
+  userId String
+  roleId String
+  user   User @relation(fields: [userId], references: [id], onDelete: Cascade)
+  role   Role @relation(fields: [roleId], references: [id], onDelete: Cascade)
+
+  @@id([userId, roleId])
+  @@index([roleId])
+}
+
+// ------------------------------------------------------------------- 菜单权限
+
+model Menu {
+  id        String   @id @default(cuid())
+  parentId  String?
+  parent    Menu?    @relation("MenuTree", fields: [parentId], references: [id])
+  children  Menu[]   @relation("MenuTree")
+  name      String // 显示名
+  path      String? // 路由地址；目录与按钮可为空
+  icon      String? // 图标名
+  keywords  String? // 搜索别名：空格或逗号分隔的口语词，全局搜索用（如「请假 销假」）
+  /// 侧边栏红色数字徽标的计数源（如 feedback:attention）。
+  /// 为空 = 该菜单不显示徽标。取值必须是 src/lib/badges.ts 里 BADGE_SOURCES 的 key，
+  /// 且 badge-count.ts 里有同名计数器 —— npm run check:config 会拦不一致的情况。
+  badgeKey  String?
+  type      String   @default("menu") // dir 目录 | menu 菜单 | button 按钮
+  permCode  String?  @unique // 权限标识，如 system:user:add
+  sort      Int      @default(0)
+  hidden    Int      @default(0) // 1 = 菜单不显示（但路由可达）
+  status    Int      @default(1)
+  createdAt DateTime @default(now())
+  updatedAt DateTime @updatedAt
+
+  roles RoleMenu[]
+
+  @@index([parentId])
+}
+
+model RoleMenu {
+  roleId String
+  menuId String
+  role   Role @relation(fields: [roleId], references: [id], onDelete: Cascade)
+  menu   Menu @relation(fields: [menuId], references: [id], onDelete: Cascade)
+
+  @@id([roleId, menuId])
+  @@index([menuId])
+}
+
+// --------------------------------------------------------------- 操作审计日志
+
+model OperationLog {
+  id         String   @id @default(cuid())
+  userId     String?
+  user       User?    @relation(fields: [userId], references: [id])
+  username   String?
+  module     String // 模块名，如 用户管理
+  action     String // 动作：新增 / 修改 / 删除 / 导出 / 登录
+  method     String?
+  path       String?
+  targetId   String?
+  detail     String? // 变更摘要（JSON 字符串）
+  ip         String?
+  userAgent  String?
+  status     Int      @default(1) // 1 成功 0 失败
+  durationMs Int?
+  createdAt  DateTime @default(now())
+
+  @@index([userId])
+  @@index([createdAt])
+  @@index([module])
+}
+
+// --------------------------------------------------------------- 系统配置
+
+/// 系统配置（键值对表）。
+///
+/// 放的是「运行时才需要、且要能在界面上改」的设置，目前用于注册开关
+/// （key = register.enabled）。为什么不用 features.ts 里的编译期开关：
+/// 那个的语义是「这个模块要不要」，改一次要重新构建；而注册开关是
+/// 超级管理员在用户管理页随手可切的运营开关，必须当场生效、重启后仍保持。
+///
+/// 取值约定：布尔统一存 '1' / '0'，缺行 = 默认值（见 lib/system-config.ts）。
+model SystemConfig {
+  key       String   @id
+  value     String
+  updatedAt DateTime @updatedAt
+}
+
+// ============================================================ 演示业务模型
+// ↓↓↓ 一个完整的业务模块示例（员工管理）。
+//     开发新模块时照这个模式复制：模型 + 路由 + 页面，三段式。
+//     不需要演示数据时删掉这一段即可。
+
+model Employee {
+  id        String      @id @default(cuid())
+  code      String      @unique // 工号
+  name      String      // 姓名
+  idCard    String?     // 身份证号（18 位，含校验位；列表展示时脱敏）
+  gender    String      @default("male") // male | female
+  deptId    String?
+  dept      Department? @relation(fields: [deptId], references: [id])
+  position  String?
+  phone     String?
+  email     String?
+  hireDate  DateTime?
+  salary    Float? // 月薪（SQLite 无 decimal 类型）
+  status    Int         @default(1) // 1 在职 0 离职
+  remark    String?
+  deletedAt DateTime?
+  createdAt DateTime    @default(now())
+  updatedAt DateTime    @updatedAt
+
+  @@index([deptId])
+  @@index([deletedAt])
+}
+
+// ============================================================================
+// 问题反馈（骨架内置，见 src/app/(admin)/feedback）
+// ============================================================================
+model Feedback {
+  id       String @id @default(cuid())
+  // bug=功能异常 / suggest=体验建议 / data=数据问题 / other=其他 / account=账号申诉（忘记密码）
+  type     String @default("bug")
+  title    String
+  detail   String
+  pagePath String?
+  contact  String?
+  /// 证明材料 URL 列表（JSON 字符串：[{ name, url, size }]），仅账号申诉使用
+  attachments String?
+  // pending=待处理 / doing=处理中 / resolved=已解决 / closed=已关闭
+  status   String  @default("pending")
+  reply    String?
+  /// 用户最后一次查看回复的时间。管理员写入新回复时重置为 null = 未读，
+  /// 用户打开反馈页时置为当前时间。侧边栏徽标靠它算「我的反馈有新回复」。
+  readAt   DateTime?
+  userId   String
+  user     User    @relation(fields: [userId], references: [id])
+  username String
+
+  createdAt DateTime  @default(now())
+  updatedAt DateTime  @updatedAt
+  deletedAt DateTime?
+
+  @@index([status])
+  @@index([userId])
+  @@index([createdAt])
+}
+
+// ============================================================================
+// 站内消息（骨架内置，见 src/lib/notifications.ts、顶栏铃铛与 /inbox）
+//
+// 只建一张消息表，**不建待办表**：
+//   待办是从各业务模块实时汇总出来的（src/lib/todos 的注册表），业务处理完就
+//   自动消失；如果落到库里，就得额外维护"什么时候该删这一行"，一旦与真实状态
+//   脱节，用户会看到一堆点进去已经没有的假待办。
+//
+// 一条记录只属于一个用户：
+//   广播消息由 notify() 拆成多条写入，换取最简单的「单用户已读」语义，
+//   不必再维护一张 (messageId, userId) 的已读表。
+// ============================================================================
+model Notification {
+  id        String   @id @default(cuid())
+  userId    String
+  /// 收件人删除账号时消息一起删；消息没有独立保留价值
+  user      User     @relation(fields: [userId], references: [id], onDelete: Cascade)
+  title     String
+  body      String?
+  /// 业务来源（仅用于列表上打标）：system / feedback / approval / business
+  type      String   @default("system")
+  /// 提示级别：info / success / warning / error（SQLite 无 enum，用 String）
+  level     String   @default("info")
+  /// 站内跳转路径，必须以 / 开头；纯通知留空
+  link      String?
+  /// 已读时间；null = 未读，顶栏铃铛按它计数
+  readAt    DateTime?
+  createdAt DateTime @default(now())
+
+  // 铃铛每次都要「我的未读」，列表要「我的最近消息」，两条走不同索引
+  @@index([userId, readAt])
+  @@index([userId, createdAt])
+}
+
+// ============================================================================
+// 访问统计（骨架内置，见 src/lib/visit-stats.ts 与顶栏「在线 / 今日 / 总访问」）
+//
+// 底座而不是"给某个页面加个数字"，所以拆成两张表：
+//   Visitor  一个浏览器一个访客（匿名 id 存 localStorage），心跳只刷新 lastSeenAt
+//   Visit    一次真实页面浏览；心跳不写，避免在线人数把 PV 刷爆
+//
+// 为什么匿名 id 由客户端生成而不是用 IP：
+//   内网 NAT 下几十个人可能共用一个出口 IP，按 IP 算在线人数会永远显示 1；
+//   多标签页共享同一个 localStorage id，同一个人也只算一次。
+// ============================================================================
+model Visitor {
+  id          String   @id @default(cuid())
+  /// 客户端生成的稳定匿名标识（8-64 位字母/数字/下划线/连字符）
+  visitorId   String   @unique
+  /// 已登录时顺带记下用户；未登录为空。留空不建外键，游客不会被用户表约束住
+  userId      String?
+  ip          String?
+  userAgent   String?
+  firstSeenAt DateTime @default(now())
+  lastSeenAt  DateTime @default(now())
+
+  @@index([lastSeenAt])
+  @@index([userId])
+}
+
+model Visit {
+  id        String   @id @default(cuid())
+  /// 对应 Visitor.visitorId；不建外键，统计表不参与业务级联删除
+  visitorId String
+  userId    String?
+  /// 页面路由（不含 query/hash），保留原始 path 便于日后做页面排行
+  path      String
+  ip        String?
+  userAgent String?
+  createdAt DateTime @default(now())
+
+  @@index([createdAt])
+  @@index([visitorId, createdAt])
+  @@index([path])
+}