fix: 手机端关闭侧边栏后刷新页面的延迟300ms=>350ms，instrumentation.ts好像得写在src内部以适配生产环境，

新增simple_deploy.sh便于部署
feat: 增加DEFAULT_USER_PASSWORD，作为创建用户时的默认密码，添加p-limit库，添加DB_PARALLEL_LIMIT = 32环境变量作为“数据库批次操作默认并发数” 限制只有超级管理员才能创建超级管理员用户删除用户时可以级联删除SelectionLog 添加zustand全局状态管理一对多的院系管理功能，支持增删改查院系管理员信息、用户可以在header中切换管理的院系
2025-11-18 20:32:28 +08:00 · 2025-11-18 20:10:48 +08:00 · 2025-11-16 15:51:15 +08:00
36 changed files with 1734 additions and 108 deletions
--- a/.clineignore
+++ b/.clineignore
@@ -0,0 +1,53 @@
+# 这里的文件会被Cline忽略，一般从 .gitignore 直接复制就行，一些需要保密不便给大模型看的文件也可以写在这
+
+# dependencies
+/node_modules
+/.pnp
+.pnp.*
+.yarn/*
+!.yarn/patches
+!.yarn/plugins
+!.yarn/releases
+!.yarn/versions
+
+# testing
+/coverage
+
+# next.js
+/.next/
+/out/
+
+# production
+/build
+
+# misc
+.DS_Store
+*.pem
+
+# debug
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+.pnpm-debug.log*
+
+# env files (can opt-in for committing if needed)
+.env*
+!.env*.example
+
+# vercel
+.vercel
+
+# typescript
+*.tsbuildinfo
+next-env.d.ts
+
+/postgresql
+tasks.md
+/prisma/zod
+
+# pnpm
+.pnpm-store/
+
+# lock 一般的项目需要用git管理，但这个是模板项目就不管理
+package-lock.json
+pnpm-lock.yaml
--- a/.clinerules/TEMPLATE_README.md
+++ b/.clinerules/TEMPLATE_README.md
@@ -0,0 +1,89 @@
+## 项目说明
+本项目模板（Hair Keeper v1.1.0）是一个高度集成、深度定制、约定优于配置的全栈Web应用模板，旨在保持灵活性的同时提供一套基于成熟架构的开发底座，自带身份认证、权限控制、丰富前端组件、文件上传、后台任务、智能体开发等丰富功能，提供AI开发辅助，免于纠结功能如何实现，可快速上手专注于业务逻辑。
+
+Hair Keeper是个诙谐有趣的名称，和项目内容毫无关系。
+
+开发者直接在本项目模板的基础上进行开发，本项目源代码完全对开发者可见并可以随时修改、扩展功能、增加新的组件和模块，开发者尽量遵从如下文表述的约定和项目文件组织规则。
+
+## 主要依赖库
+- 基础：next + react + trpc + prisma
+- UI基础框架：tailwindcss + radix-ui(基于shadcn/ui库添加组件) + lucide-react + sonner(toast)
+- 图表等高级UI：recharts(图表) + xyflow/react(节点图 dagre自动布局) + embla-carousel-react + dnd-kit/sortable
+- 用户交互增强：motion(动画) + framer-motion(动画) + use-gesture/react(手势)
+- Headless UI：react-hook-form + tanstack/react-table + headless-tree/react
+- 数据和存储：pg(PostgreSQL) + ioredis + minio
+- 后台任务及消息队列：bullmq
+- AI大模型交互: ai + ai-sdk/react + ai-elements(基于shadcn/ui库添加组件)
+- 辅助性库：lodash + zod + date-fns + nanoid + zustand + p-limit
+- 其他：next-auth + bcryptjs + nuqs + superjson(前后端序列化类型安全) + copy-to-clipboard
+
+## 项目约定
+### 前端
+- 可使用`pnpx shadcn@latest add`添加UI控件（会添加到components/ui中）
+- 表单输入组件提供value、onChange和disabled三种属性的支持，可方便的集成到react-hook-form中
+- z-index约定：常规对话框及其遮罩z-50，表单控件的Popover为z-60，全屏预览及遮罩z-70
+- tailwindcss v4支持直接编写如 w-[10px] 这样的任意值，非必要不写style，支持样式类合并`import { cn } from "@/lib/utils"`
+- 用`import { useCallbackRef } from "@/hooks/use-callback-ref"`这个钩子构建引用不变但逻辑总是最新的函数，解决闭包陷阱
+
+### 后端
+- tRPC接口报错时可使用TRPCError，例如throw new TRPCError({ code: 'NOT_FOUND', message: '' })
+- server/trpc.ts中导出了createTRPCRouter（本质是t.router）用来创建路由，预定义了publicProcedure用于创建无权限限制、也不需要登录的api
+- server/trpc.ts中预定义了permissionRequiredProcedure，用来创建限制特定权限访问的api，例如permissionRequiredProcedure(Permissions.USER_MANAGE)；空字符串表示无权限要求，但是需要用户登录；约定用permissionRequiredProcedure('SUPER_ADMIN_ONLY')限制超级管理员才能访问，该权限不在Permissions中定义，只有超级管理员才能绕过授权限制访问所有接口，因此SUPER_ADMIN_ONLY这个字符串只是一个通用的约定。
+- 数据库批次操作时，使用`const dbParallelLimit = pLimit(parseInt(process.env.DB_PARALLEL_LIMIT || '16', 10))`控制最大并发数
+
+### 数据和存储
+- Prisma 生成的客户端输出为默认路径，导入时使用`@prisma/client`，可以从中导入定义的数据表的ts类型，例如`import type { User } from '@prisma/client'`
+- 数据库连接使用 `server/db.ts` 中的全局单例 `db`，不要直接实例化 PrismaClient
+- 时间字段统一使用 `@db.Timestamptz` 类型
+- 前后端参数传递尽量使用扁平结构而非嵌套结构
+- 文件的上传和下载采用“客户端直传”架构（基于MinIO），服务器端只负责授权和生成预签名URL
+
+### 开发模式
+为了方便开发，本项目模板内置了在开发模式下可用的大量页面和功能
+- 仅在开发阶段使用的页面、布局、api等会被NextJS识别并处理的文件，以dev.tsx、dev.ts、dev.jsx、dev.js为后缀，不会被打包到生产环境
+- 仅在开发阶段使用的数据模型以Dev开头，对应的数据表以dev_开头
+
+## 重要目录和文件
+### 前端
+- `components/common/`：进一步封装的高级通用控件，例如下拉菜单、对话框表单、响应式tabs等控件
+- `components/features/`：进一步封装的控件，通常更重或者与业务关联强需要在不同的页面中复用
+- `components/ai-elements/`：ai对话相关的组件
+- `components/data-details/`：专注于数据展示的可复用控件，例如detail-badge-list、detail-copyable、detail-list、detail-timeline等控件
+- `components/data-table/`：专注于数据表格的可复用控件，本项目模板自带了基础的data-table、过滤器、排序、分页、列可见性切换等功能
+- `components/icons/`：项目的自定义图标可以写在这个文件夹
+- `components/layout/`：应用的完整布局框架和导航系统以及可复用的布局容器
+- `components/ui/`：高度可定制可复用的基础UI组件，通常源自第三方库
+- `app/(main)/`：开发者在这里自行实现的所有业务的页面
+- `app/(main)/dev/`：辅助开发的页面，本项目模板在其中实现了许多功能，代码在实现业务时也可以借鉴参考
+- `app/(main)/settings/`：全局设置，由开发者根据业务需求进行补充和实现
+- `app/(main)/users/`：用户管理模块，提供用户CRUD、角色管理、批量授权等完整的用户管理功能的页面和组件实现
+- `hooks/`：可复用React Hooks库，部分复杂的组件也通过hook实现Headless UI逻辑与样式分离，组件中可复用的逻辑都可以放在这
+- `lib/trpc.ts`：创建并导出tRPC React客户端实例，用于前端与后端API通信
+- `lib/stores/`：通过zustand管理的全局的状态
+
+### 后端
+- `server/routers/`：项目trpc api定义文件，开发者主要在这里定义和实现业务的后端API
+- `server/routers/_app.ts`：`appRouter`根路由定义，需要添加子路由时在此处注册
+- `server/routers/common.ts`：定义需要在多个模块中复用的通用业务接口路由
+- `server/routers/jobs.ts`：tRPC任务进度订阅路由
+- `server/routers/selection.ts`：用于记录用户选择的选项或者输入的内容，优化用户的输入体验
+- `server/routers/global.ts`：系统全局和特定业务关联不大的一些api
+- `server/routers/dev/`：开发模式下的辅助功能需要的trpc api
+- `server/queues/`：消息队列和worker，通过其中的index.ts统一导出，任务状态更新采用trpc SSE subscription，接口定义在`server/routers/jobs.ts`中
+- `server/agents`：LLM的对接和使用
+- `server/service/`：服务层模块集合，封装后端业务逻辑和系统服务
+- `server/service/dev/`：开发模式下的辅助功能需要的后台服务
+- `server/utils/`：服务端专用工具函数库，为后端业务逻辑提供基础设施支持
+- `api/dev/`：开发模式下的辅助功能需要的api
+
+### 其他
+- `constants/`：项目全局常量管理
+- `constants/permissions.ts`：权限定义，支持前后端一致的权限控制，支持解析复杂的权限表达式（如"A&B|(C&D)"）
+- `lib/schema/`：集中管理数据验证schema，定义前后端统一的数据结构和验证规则，前端对默认值等其他要求写在表单组件中，后端对默认值等其他要求写在接口文件中，使用z.input而不是z.infer来获取Schema的输入类型
+- `lib/algorithom.ts`：通用计算机算法实现，例如拓扑排序
+- `lib/format.ts`：数据格式化工具函数库
+
+## 非标准命令
+- `pnpm run dev:attach`：这会使用tmux在名为nextdev的session中启动pnpm run dev，便于在开发页面或其他地方与开发服务器交互
+- `pnpm run db:seed`：数据库种子数据，`prisma/init_data/`存放种子初始化数据
+- `pnpm run build:analyze`：打包项目并使用next/bundle-analyzer进行分析
--- a/.env.example
+++ b/.env.example
@@ -40,6 +40,9 @@ MINIO_BUCKET=

 # 应用相关
 SUPER_ADMIN_PASSWORD=
+USER_DEFAULT_PASSWORD=
+## 数据库批次操作默认并发数
+DB_PARALLEL_LIMIT =

 # NextAuth.js Configuration
 NEXTAUTH_SECRET=
--- a/README.md
+++ b/README.md
@@ -1,5 +1,5 @@
 ## 项目说明
-本项目模板（Hair Keeper v1.0.0）是一个高度集成、深度定制、约定优于配置的全栈Web应用模板，旨在保持灵活性的同时提供一套基于成熟架构的开发底座，自带身份认证、权限控制、丰富前端组件、文件上传、后台任务、智能体开发等丰富功能，提供AI开发辅助，免于纠结功能如何实现，可快速上手专注于业务逻辑。
+本项目模板（Hair Keeper v1.1.0）是一个高度集成、深度定制、约定优于配置的全栈Web应用模板，旨在保持灵活性的同时提供一套基于成熟架构的开发底座，自带身份认证、权限控制、丰富前端组件、文件上传、后台任务、智能体开发等丰富功能，提供AI开发辅助，免于纠结功能如何实现，可快速上手专注于业务逻辑。

 Hair Keeper是个诙谐有趣的名称，和项目内容毫无关系。

@@ -14,7 +14,7 @@ Hair Keeper是个诙谐有趣的名称，和项目内容毫无关系。
 - 数据和存储：pg(PostgreSQL) + ioredis + minio
 - 后台任务及消息队列：bullmq
 - AI大模型交互: ai + ai-sdk/react + ai-elements(基于shadcn/ui库添加组件)
- 辅助性库：lodash + zod + date-fns + nanoid
+- 辅助性库：lodash + zod + date-fns + nanoid + zustand + p-limit
 - 其他：next-auth + bcryptjs + nuqs + superjson(前后端序列化类型安全) + copy-to-clipboard

 ## 项目约定
@@ -27,11 +27,12 @@ Hair Keeper是个诙谐有趣的名称，和项目内容毫无关系。

 ### 后端
 - tRPC接口报错时可使用TRPCError，例如throw new TRPCError({ code: 'NOT_FOUND', message: '' })
- server/trpc.ts中预定义了publicProcedure用于创建无权限限制、也不需要登录的api
- server/trpc.ts中预定义了publicProcedurepermissionRequiredProcedure，用来创建限制特定权限访问的路由，例如permissionRequiredProcedure(Permissions.USER_MANAGE)；空字符串表示无权限要求，但是需要用户登录；约定用permissionRequiredProcedure('SUPER_ADMIN_ONLY')限制超级管理员才能访问，该权限不在Permissions中定义，只有超级管理员才能绕过授权限制访问所有接口，因此SUPER_ADMIN_ONLY这个字符串只是一个通用的约定。
+- server/trpc.ts中导出了createTRPCRouter（本质是t.router）用来创建路由，预定义了publicProcedure用于创建无权限限制、也不需要登录的api
+- server/trpc.ts中预定义了permissionRequiredProcedure，用来创建限制特定权限访问的api，例如permissionRequiredProcedure(Permissions.USER_MANAGE)；空字符串表示无权限要求，但是需要用户登录；约定用permissionRequiredProcedure('SUPER_ADMIN_ONLY')限制超级管理员才能访问，该权限不在Permissions中定义，只有超级管理员才能绕过授权限制访问所有接口，因此SUPER_ADMIN_ONLY这个字符串只是一个通用的约定。
+- 数据库批次操作时，使用`const dbParallelLimit = pLimit(parseInt(process.env.DB_PARALLEL_LIMIT || '16', 10))`控制最大并发数

 ### 数据和存储
- Prisma 生成的客户端输出为默认路径，导入时使用`@prisma/client`
+- Prisma 生成的客户端输出为默认路径，导入时使用`@prisma/client`，可以从中导入定义的数据表的ts类型，例如`import type { User } from '@prisma/client'`
 - 数据库连接使用 `server/db.ts` 中的全局单例 `db`，不要直接实例化 PrismaClient
 - 时间字段统一使用 `@db.Timestamptz` 类型
 - 前后端参数传递尽量使用扁平结构而非嵌套结构
@@ -58,6 +59,7 @@ Hair Keeper是个诙谐有趣的名称，和项目内容毫无关系。
 - `app/(main)/users/`：用户管理模块，提供用户CRUD、角色管理、批量授权等完整的用户管理功能的页面和组件实现
 - `hooks/`：可复用React Hooks库，部分复杂的组件也通过hook实现Headless UI逻辑与样式分离，组件中可复用的逻辑都可以放在这
 - `lib/trpc.ts`：创建并导出tRPC React客户端实例，用于前端与后端API通信
+- `lib/stores/`：通过zustand管理的全局的状态

 ### 后端
 - `server/routers/`：项目trpc api定义文件，开发者主要在这里定义和实现业务的后端API
--- a/docker-compose.yml
+++ b/docker-compose.yml
@@ -1,7 +1,8 @@
+name: hair-keeper
+
 services:
  postgresql:
    image: bitnami/postgresql:17  # https://hub.docker.com/r/bitnami/postgresql
-    container_name: hair-keeper-dev-pg
    restart: always
    ports:
      - "${POSTGRESQL_PORT}:5432"
@@ -10,21 +11,19 @@ services:
      POSTGRESQL_PASSWORD: ${POSTGRESQL_PASSWORD}
      POSTGRESQL_INITDB_ARGS: "--encoding=UTF-8 --locale=C"
    volumes:
-      - hair_keeper_postgresql_data:/bitnami/postgresql
+      - postgresql_data:/bitnami/postgresql

  redis:
    image: redis:8-alpine  # https://hub.docker.com/_/redis
-    container_name: hair-keeper-dev-redis
    ports:
      - "${REDIS_PORT}:6379"
    command: redis-server --requirepass ${REDIS_PASSWORD} --appendonly yes
    volumes:
-      - hair_keeper_redis_data:/data
+      - redis_data:/data
    restart: always

  minio:
    image: minio/minio:RELEASE.2025-07-23T15-54-02Z
-    container_name: hair-keeper-dev-minio
    ports:
      - "${MINIO_API_PORT}:9000"      # API端口
      - "${MINIO_CONSOLE_PORT}:9001"      # Console端口
@@ -33,11 +32,11 @@ services:
      MINIO_ROOT_PASSWORD: ${MINIO_ROOT_PASSWORD}
      MINIO_SERVER_URL: ${MINIO_SERVER_URL}
    volumes:
-      - hair_keeper_minio_data:/data
+      - minio_data:/data
    command: server /data --console-address ":9001"
    restart: always

 volumes:
-  hair_keeper_postgresql_data:
-  hair_keeper_redis_data:
-  hair_keeper_minio_data:
+  postgresql_data:
+  redis_data:
+  minio_data:
--- a/package.json
+++ b/package.json
@@ -78,6 +78,7 @@
    "next-auth": "^4.24.11",
    "next-themes": "^0.4.6",
    "nuqs": "^2.6.0",
+    "p-limit": "^7.2.0",
    "pg": "^8.16.3",
    "prism-react-renderer": "^2.4.1",
    "prisma": "^6.15.0",
@@ -95,7 +96,8 @@
    "tailwind-merge": "^3.3.1",
    "use-stick-to-bottom": "^1.1.1",
    "vaul": "^1.1.2",
-    "zod": "^4.1.9"
+    "zod": "^4.1.9",
+    "zustand": "^5.0.8"
  },
  "devDependencies": {
    "@eslint/eslintrc": "^3",
--- a/prisma/migrations/20251118103418_add_cascade_delete_to_selection_log/migration.sql
+++ b/prisma/migrations/20251118103418_add_cascade_delete_to_selection_log/migration.sql
@@ -0,0 +1,5 @@
+-- DropForeignKey
+ALTER TABLE "selection_log" DROP CONSTRAINT "selection_log_userId_fkey";
+
+-- AddForeignKey
+ALTER TABLE "selection_log" ADD CONSTRAINT "selection_log_userId_fkey" FOREIGN KEY ("userId") REFERENCES "user"("id") ON DELETE CASCADE ON UPDATE CASCADE;
--- a/prisma/migrations/20251118105141_add_dept_admin_and_managed_dept_switch/migration.sql
+++ b/prisma/migrations/20251118105141_add_dept_admin_and_managed_dept_switch/migration.sql
@@ -0,0 +1,26 @@
+-- AlterTable
+ALTER TABLE "user" ADD COLUMN     "current_managed_dept" VARCHAR(5);
+
+-- CreateTable
+CREATE TABLE "dept_admin" (
+    "id" SERIAL NOT NULL,
+    "uid" VARCHAR(30) NOT NULL,
+    "dept_code" VARCHAR(5) NOT NULL,
+    "admin_email" VARCHAR(100),
+    "admin_line_phone" VARCHAR(100),
+    "admin_mobile_phone" VARCHAR(100),
+    "note" VARCHAR(1000),
+    "created_at" TIMESTAMPTZ NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updated_at" TIMESTAMPTZ NOT NULL,
+
+    CONSTRAINT "dept_admin_pkey" PRIMARY KEY ("id")
+);
+
+-- CreateIndex
+CREATE UNIQUE INDEX "dept_admin_uid_dept_code_key" ON "dept_admin"("uid", "dept_code");
+
+-- AddForeignKey
+ALTER TABLE "dept_admin" ADD CONSTRAINT "dept_admin_uid_fkey" FOREIGN KEY ("uid") REFERENCES "user"("id") ON DELETE RESTRICT ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "dept_admin" ADD CONSTRAINT "dept_admin_dept_code_fkey" FOREIGN KEY ("dept_code") REFERENCES "dept"("code") ON DELETE RESTRICT ON UPDATE CASCADE;
--- a/prisma/schema.prisma
+++ b/prisma/schema.prisma
@@ -19,6 +19,7 @@ model User {
  name          String?
  status        String?   // 在校/减离/NULL
  deptCode      String?   @map("dept_code")  // 所属院系代码（外键）
+  currentManagedDept  String?   @map("current_managed_dept") @db.VarChar(5) // 当前正在管理的院系代码，用于支持院系管理员类型的角色
  createdAt     DateTime  @default(now()) @map("created_at") @db.Timestamptz
  updatedAt     DateTime  @updatedAt @map("updated_at") @db.Timestamptz
  password      String
@@ -29,6 +30,7 @@ model User {
  dept          Dept?     @relation(fields: [deptCode], references: [code])
  roles         Role[]    // 多对多关联角色
  selectionLogs SelectionLog[] // 选择日志
+  deptAdmins          DeptAdmin[] // 作为院系管理员的信息
  
  @@map("user")
 }
@@ -41,10 +43,31 @@ model Dept {
  
  // 关联
  users     User[]
+  deptAdmins DeptAdmin[] // 院系管理员
  
  @@map("dept")
 }

+// 院系管理员表
+model DeptAdmin {
+  id               Int      @id @default(autoincrement())
+  uid              String   @db.VarChar(30) // 管理员用户ID（外键）
+  deptCode         String   @map("dept_code") @db.VarChar(5) // 院系代码（外键）
+  adminEmail       String?  @map("admin_email") @db.VarChar(100) // 管理员邮箱
+  adminLinePhone   String?  @map("admin_line_phone") @db.VarChar(100) // 管理员座机
+  adminMobilePhone String?  @map("admin_mobile_phone") @db.VarChar(100) // 管理员手机
+  note             String?  @db.VarChar(1000) // 备注
+  createdAt        DateTime @default(now()) @map("created_at") @db.Timestamptz
+  updatedAt        DateTime @updatedAt @map("updated_at") @db.Timestamptz
+
+  // 关联
+  user             User     @relation(fields: [uid], references: [id])
+  dept             Dept     @relation(fields: [deptCode], references: [code])
+
+  @@unique([uid, deptCode], name: "uidx_uid_dept_code")
+  @@map("dept_admin")
+}
+
 // 角色表
 model Role {
  id          Int           @id @default(autoincrement())
@@ -68,7 +91,7 @@ model Permission {
 model SelectionLog {
  id        Int      @id @default(autoincrement())
  userId    String   // 关联到用户
-  user      User     @relation(fields: [userId], references: [id])
+  user      User     @relation(fields: [userId], references: [id], onDelete: Cascade)
  
  // 用于标识是哪个的选项，用.进行分隔，例如"user.filter.dept"
  context   String
--- a/prisma/seed.ts
+++ b/prisma/seed.ts
@@ -3,9 +3,13 @@ import bcrypt from 'bcryptjs'
 import { Permissions, ALL_PERMISSIONS } from '../src/constants/permissions'
 import fs from 'fs'
 import path from 'path'
+import pLimit from 'p-limit'

 const prisma = new PrismaClient()

+// 从环境变量获取并发限制，默认为16
+const dbParallelLimit = pLimit(parseInt(process.env.DB_PARALLEL_LIMIT || '16', 10))
+
 // 解析 JSON 文件并导入院系数据
 async function importDepartments() {
  const jsonPath = path.join(__dirname, 'init_data', '院系.json')
@@ -16,7 +20,7 @@ async function importDepartments() {
  
  await Promise.all(
    departments.map((dept: any) => {
-      return prisma.dept.upsert({
+      return dbParallelLimit(() => prisma.dept.upsert({
        where: { code: dept.id },
        update: {
          name: dept.name,
@@ -27,7 +31,7 @@ async function importDepartments() {
          name: dept.name,
          fullName: dept.full_name,
        },
-      })
+      }))
    })
  )
  console.log('院系数据导入完成')
@@ -37,13 +41,15 @@ async function main() {
  console.log('开始数据库初始化...')

  // 插入权限
-  for (const permName of ALL_PERMISSIONS) {
-    await prisma.permission.upsert({
-      where: { name: permName },
-      update: {},
-      create: { name: permName },
+  await Promise.all(
+    ALL_PERMISSIONS.map((permName) => {
+      return dbParallelLimit(() => prisma.permission.upsert({
+        where: { name: permName },
+        update: {},
+        create: { name: permName },
+      }))
    })
-  }
+  )

  // 角色与权限映射
  const rolePermissionsMap: Record<string, string[]> = {
@@ -51,18 +57,20 @@ async function main() {
  }

  // 插入角色
-  for (const [roleName, perms] of Object.entries(rolePermissionsMap)) {
-    await prisma.role.upsert({
-      where: { name: roleName },
-      update: {},
-      create: {
-        name: roleName,
-        permissions: {
-          connect: perms.map((name) => ({ name })),
+  await Promise.all(
+    Object.entries(rolePermissionsMap).map(([roleName, perms]) => {
+      return dbParallelLimit(() => prisma.role.upsert({
+        where: { name: roleName },
+        update: {},
+        create: {
+          name: roleName,
+          permissions: {
+            connect: perms.map((name) => ({ name })),
+          },
        },
-      },
+      }))
    })
-  }
+  )

  await importDepartments()

@@ -74,33 +82,37 @@ async function main() {
    { id: 'unknown', name: '未知用户', status: '在校', deptCode: '00001', roleNames: [] },
  ]

-  for (const u of usersToCreate) {
-    const password = await bcrypt.hash(u.password ?? '123456', 12)
-    await prisma.user.upsert({
-      where: { id: u.id },
-      update: {
-        name: u.name,
-        status: u.status,
-        deptCode: u.deptCode,
-        password,
-        isSuperAdmin: u.isSuperAdmin ?? false,
-        roles: {
-          set: u.roleNames.map((name) => ({ name })),
-        },
-      },
-      create: {
-        id: u.id,
-        name: u.name,
-        status: u.status,
-        deptCode: u.deptCode,
-        password,
-        isSuperAdmin: u.isSuperAdmin ?? false,
-        roles: {
-          connect: u.roleNames.map((name) => ({ name })),
-        },
-      },
+  await Promise.all(
+    usersToCreate.map((u) => {
+      return dbParallelLimit(async () => {
+        const password = await bcrypt.hash(u.password || process.env.USER_DEFAULT_PASSWORD || 'jeep4ahxahx7ee7U', 12)
+        await prisma.user.upsert({
+          where: { id: u.id },
+          update: {
+            name: u.name,
+            status: u.status,
+            deptCode: u.deptCode,
+            password,
+            isSuperAdmin: u.isSuperAdmin ?? false,
+            roles: {
+              set: u.roleNames.map((name) => ({ name })),
+            },
+          },
+          create: {
+            id: u.id,
+            name: u.name,
+            status: u.status,
+            deptCode: u.deptCode,
+            password,
+            isSuperAdmin: u.isSuperAdmin ?? false,
+            roles: {
+              connect: u.roleNames.map((name) => ({ name })),
+            },
+          },
+        })
+      })
    })
-  }
+  )

  // 插入文件类型（仅开发环境）
  const fileTypes = [
@@ -125,18 +137,19 @@ async function main() {
    { id: 'OTHER', name: '其他', description: '无法归入以上分类的文件' },
  ]

-  for (let index = 0; index < fileTypes.length; index++) {
-    const fileType = fileTypes[index]
-    await prisma.devFileType.upsert({
-      where: { id: fileType.id },
-      update: {
-        name: fileType.name,
-        description: fileType.description,
-        order: (index + 1) * 10,
-      },
-      create: {...fileType, order: (index + 1) * 10},
+  await Promise.all(
+    fileTypes.map((fileType, index) => {
+      return dbParallelLimit(() => prisma.devFileType.upsert({
+        where: { id: fileType.id },
+        update: {
+          name: fileType.name,
+          description: fileType.description,
+          order: (index + 1) * 10,
+        },
+        create: {...fileType, order: (index + 1) * 10},
+      }))
    })
-  }
+  )
  console.log('文件类型数据初始化完成')

  // 插入依赖包类型（仅开发环境）
@@ -152,18 +165,19 @@ async function main() {
    { id: 'NODEJS_CORE', name: 'Node.js核心', description: 'Node.js运行时内置的模块，用于底层操作如文件系统、路径处理等，例如fs、path、child_process、util、module、os、http、crypto、events、stream、process、net、url、assert。' },
  ]

-  for (let index = 0; index < pkgTypes.length; index++) {
-    const pkgType = pkgTypes[index]
-    await prisma.devPkgType.upsert({
-      where: { id: pkgType.id },
-      update: {
-        name: pkgType.name,
-        description: pkgType.description,
-        order: (index + 1) * 10,
-      },
-      create: {...pkgType, order: (index + 1) * 10},
+  await Promise.all(
+    pkgTypes.map((pkgType, index) => {
+      return dbParallelLimit(() => prisma.devPkgType.upsert({
+        where: { id: pkgType.id },
+        update: {
+          name: pkgType.name,
+          description: pkgType.description,
+          order: (index + 1) * 10,
+        },
+        create: {...pkgType, order: (index + 1) * 10},
+      }))
    })
-  }
+  )
  console.log('依赖包类型数据初始化完成')

  console.log('数据库初始化完成')
--- a/simple_deploy.sh
+++ b/simple_deploy.sh
@@ -0,0 +1,72 @@
+#!/bin/bash
+# 此脚本用来一键部署到生产服务器
+# 需事先配置好ssh免密登录，目标服务器需要安装好node、pnpm和pm2来运行容器
+set -e
+
+# 配置
+REMOTE_USER=""
+REMOTE_HOST=""
+REMOTE_PORT=""
+PROJECT_NAME=""
+REMOTE_DIR="~/$PROJECT_NAME"
+
+echo "🔨 开始构建项目..."
+pnpm run build
+
+echo "📦 准备部署文件..."
+# 创建临时目录
+TEMP_DIR=$(mktemp -d)
+trap "rm -rf $TEMP_DIR" EXIT
+
+# 复制必要文件
+cp -r .next $TEMP_DIR/
+cp -r public $TEMP_DIR/
+cp -r prisma $TEMP_DIR/
+cp package.json $TEMP_DIR/
+cp pnpm-lock.yaml $TEMP_DIR/
+cp next.config.ts $TEMP_DIR/
+
+echo "🚀 上传文件到服务器..."
+ssh ${REMOTE_USER}@${REMOTE_HOST} "mkdir -p ${REMOTE_DIR}"
+rsync -avz --delete \
+  --exclude=node_modules \
+  --exclude=.git \
+  $TEMP_DIR/ ${REMOTE_USER}@${REMOTE_HOST}:${REMOTE_DIR}/
+
+# 上传环境变量文件
+echo "📝 上传环境变量文件..."
+[ -f .env ] && scp .env ${REMOTE_USER}@${REMOTE_HOST}:${REMOTE_DIR}/.env
+[ -f .env.production ] && scp .env.production ${REMOTE_USER}@${REMOTE_HOST}:${REMOTE_DIR}/.env.production
+
+echo "⚙️  在服务器上配置和启动服务..."
+ssh ${REMOTE_USER}@${REMOTE_HOST} << ENDSSH
+cd ${REMOTE_DIR}
+
+# 安装生产依赖（包括prisma用于数据库迁移和pm2用于进程管理）
+echo "📥 安装依赖..."
+pnpm install --prod
+
+# 等待数据库启动
+echo "⏳ 等待数据库启动..."
+sleep 5
+
+# 运行数据库迁移
+echo "🗄️  运行数据库迁移..."
+npx prisma migrate deploy
+npx prisma generate
+
+# 使用PM2管理Next.js服务
+echo "🔄 使用PM2重启服务..."
+/home/user/.local/share/pnpm/pm2 delete $PROJECT_NAME || true
+/home/user/.local/share/pnpm/pm2 start pnpm --name $PROJECT_NAME -- start -p ${REMOTE_PORT}
+# 保存当前 PM2 进程列表的快照，使其在系统重启后能自动恢复
+/home/user/.local/share/pnpm/pm2 save
+
+echo "✅ 部署完成！服务运行在端口 ${REMOTE_PORT}"
+echo "📊 查看服务状态: pm2 status"
+echo "📝 查看日志: pm2 logs $PROJECT_NAME"
+echo "❌ 关闭服务: pm2 delete $PROJECT_NAME"
+ENDSSH
+
+echo "🎉 部署成功！"
+echo "访问地址: http://${REMOTE_HOST}:${REMOTE_PORT}"
--- a/src/app/(main)/users/dept-admin/columns.tsx
+++ b/src/app/(main)/users/dept-admin/columns.tsx
@@ -0,0 +1,247 @@
+'use client'
+
+import { ColumnDef } from '@tanstack/react-table'
+import { Button } from '@/components/ui/button'
+import { Edit, Trash2, MoreHorizontal } from 'lucide-react'
+import { formatDate } from '@/lib/format'
+import { Checkbox } from '@/components/ui/checkbox'
+import { DataTableColumnHeader } from '@/components/data-table/column-header'
+import {
+  DropdownMenu,
+  DropdownMenuContent,
+  DropdownMenuItem,
+  DropdownMenuTrigger,
+} from '@/components/ui/dropdown-menu'
+import type { DeptAdmin } from '@/server/routers/dept-admin'
+
+// 操作回调类型
+export type DeptAdminActions = {
+  onEdit: (id: number) => void
+  onDelete: (id: number) => void
+}
+
+// 列定义选项类型
+export type DeptAdminColumnsOptions = {
+  depts?: Array<{ code: string; name: string; fullName: string }>
+}
+
+// 创建院系管理员表格列定义
+export const createDeptAdminColumns = (
+  actions: DeptAdminActions,
+  options: DeptAdminColumnsOptions = {}
+): ColumnDef<DeptAdmin>[] => [
+  {
+    id: "select",
+    header: ({ table }) => (
+      <Checkbox
+        checked={
+          table.getIsAllPageRowsSelected() ||
+          (table.getIsSomePageRowsSelected() && "indeterminate")
+        }
+        onCheckedChange={(value) =>
+          table.toggleAllPageRowsSelected(!!value)
+        }
+        aria-label="Select all"
+      />
+    ),
+    cell: ({ row }) => (
+      <Checkbox
+        checked={row.getIsSelected()}
+        onCheckedChange={(value) => row.toggleSelected(!!value)}
+        aria-label="Select row"
+      />
+    ),
+    size: 32,
+    enableSorting: false,
+    enableHiding: false,
+  },
+  {
+    id: 'id',
+    accessorKey: 'id',
+    header: ({ column }) => (
+      <DataTableColumnHeader column={column} title="ID" />
+    ),
+    cell: ({ row }) => <div className="font-medium">{row.original.id}</div>,
+    meta: {
+      label: 'ID',
+    },
+  },
+  {
+    id: 'uid',
+    accessorKey: 'uid',
+    header: ({ column }) => (
+      <DataTableColumnHeader column={column} title="用户ID" />
+    ),
+    cell: ({ row }) => <div className="font-medium">{row.original.uid}</div>,
+    enableColumnFilter: true,
+    meta: {
+      label: '用户ID',
+      filter: {
+        placeholder: '请输入用户ID',
+        variant: 'text',
+      }
+    },
+  },
+  {
+    id: 'userName',
+    accessorKey: 'user.name',
+    header: ({ column }) => (
+      <DataTableColumnHeader column={column} title="姓名" />
+    ),
+    cell: ({ row }) => <div>{row.original.user?.name || '-'}</div>,
+    enableColumnFilter: true,
+    meta: {
+      label: '姓名',
+      filter: {
+        placeholder: '请输入姓名',
+        variant: 'text',
+      }
+    },
+  },
+  {
+    id: 'deptCode',
+    accessorKey: 'deptCode',
+    header: ({ column }) => (
+      <DataTableColumnHeader column={column} title="院系" />
+    ),
+    cell: ({ row }) => (
+      <div>
+        <div className="font-medium">{row.original.dept?.name || '-'}</div>
+        <div className="text-xs text-muted-foreground">{row.original.deptCode}</div>
+      </div>
+    ),
+    enableColumnFilter: true,
+    meta: {
+      label: '院系',
+      filter: {
+        variant: 'multiSelect',
+        options: options.depts?.map(dept => ({
+          id: dept.code,
+          name: dept.fullName,
+        })) || [],
+      }
+    },
+  },
+  {
+    id: 'adminEmail',
+    accessorKey: 'adminEmail',
+    header: ({ column }) => (
+      <DataTableColumnHeader column={column} title="邮箱" />
+    ),
+    cell: ({ row }) => <div>{row.original.adminEmail || '-'}</div>,
+    enableColumnFilter: true,
+    meta: {
+      label: '邮箱',
+      filter: {
+        placeholder: '请输入邮箱',
+        variant: 'text',
+      }
+    },
+  },
+  {
+    id: 'adminLinePhone',
+    accessorKey: 'adminLinePhone',
+    header: ({ column }) => (
+      <DataTableColumnHeader column={column} title="座机" />
+    ),
+    cell: ({ row }) => <div>{row.original.adminLinePhone || '-'}</div>,
+    enableColumnFilter: true,
+    meta: {
+      label: '座机',
+      filter: {
+        placeholder: '请输入座机',
+        variant: 'text',
+      }
+    },
+  },
+  {
+    id: 'adminMobilePhone',
+    accessorKey: 'adminMobilePhone',
+    header: ({ column }) => (
+      <DataTableColumnHeader column={column} title="手机" />
+    ),
+    cell: ({ row }) => <div>{row.original.adminMobilePhone || '-'}</div>,
+    enableColumnFilter: true,
+    meta: {
+      label: '手机',
+      filter: {
+        placeholder: '请输入手机',
+        variant: 'text',
+      }
+    },
+  },
+  {
+    id: 'note',
+    accessorKey: 'note',
+    header: ({ column }) => (
+      <DataTableColumnHeader column={column} title="备注" />
+    ),
+    cell: ({ row }) => (
+      <div className="max-w-[200px] truncate" title={row.original.note || ''}>
+        {row.original.note || '-'}
+      </div>
+    ),
+    enableSorting: false,
+    meta: {
+      label: '备注',
+    },
+  },
+  {
+    id: 'createdAt',
+    accessorKey: 'createdAt',
+    header: ({ column }) => (
+      <DataTableColumnHeader column={column} title="创建时间" />
+    ),
+    cell: ({ row }) => {
+      return <div>{formatDate(row.original.createdAt) || '-'}</div>
+    },
+    meta: {
+      label: '创建时间',
+    }
+  },
+  {
+    id: 'updatedAt',
+    accessorKey: 'updatedAt',
+    header: ({ column }) => (
+      <DataTableColumnHeader column={column} title="更新时间" />
+    ),
+    cell: ({ row }) => {
+      return <div>{formatDate(row.original.updatedAt) || '-'}</div>
+    },
+    meta: {
+      label: '更新时间',
+    }
+  },
+  {
+    id: 'actions',
+    cell: ({ row }) => {
+      const deptAdmin = row.original
+      return (
+        <DropdownMenu>
+          <DropdownMenuTrigger asChild>
+            <Button variant="ghost" size="icon" className="h-6 w-6 md:w-9">
+              <MoreHorizontal className="h-4 w-4" />
+              <span className="sr-only">打开菜单</span>
+            </Button>
+          </DropdownMenuTrigger>
+          <DropdownMenuContent align="end">
+            <DropdownMenuItem onClick={() => actions.onEdit(deptAdmin.id)}>
+              <Edit className="h-4 w-4" />
+              编辑
+            </DropdownMenuItem>
+            <DropdownMenuItem
+              variant="destructive"
+              onClick={() => actions.onDelete(deptAdmin.id)}
+            >
+              <Trash2 className="h-4 w-4" />
+              删除
+            </DropdownMenuItem>
+          </DropdownMenuContent>
+        </DropdownMenu>
+      )
+    },
+    size: 32,
+    enableSorting: false,
+    enableHiding: false,
+  },
+]
--- a/src/app/(main)/users/dept-admin/components/DeptAdminCreateDialog.tsx
+++ b/src/app/(main)/users/dept-admin/components/DeptAdminCreateDialog.tsx
@@ -0,0 +1,186 @@
+'use client'
+
+import React, { useState } from 'react'
+import { useForm } from 'react-hook-form'
+import { z } from 'zod'
+import { zodResolver } from '@hookform/resolvers/zod'
+import { trpc } from '@/lib/trpc'
+import { Button } from '@/components/ui/button'
+import { Input } from '@/components/ui/input'
+import { Dialog, DialogTrigger } from '@/components/ui/dialog'
+import { Plus } from 'lucide-react'
+import { toast } from 'sonner'
+import { FormDialog, FormActionBar, FormGridContent, FormCancelAction, FormSubmitAction, type FormFieldConfig } from '@/components/common/form-dialog'
+import {
+  AdvancedSelect,
+  SelectPopover,
+  SelectTrigger,
+  SelectContent,
+  SelectInput,
+  SelectItemList,
+  SelectedName
+} from '@/components/common/advanced-select'
+import { useSmartSelectOptions } from '@/hooks/use-smart-select-options'
+import { Textarea } from '@/components/ui/textarea'
+
+// 创建院系管理员的 schema
+const createDeptAdminSchema = z.object({
+  uid: z.string().min(1, '用户ID不能为空'),
+  deptCode: z.string().min(1, '院系代码不能为空'),
+  adminEmail: z.string().email('邮箱格式不正确').optional().or(z.literal('')),
+  adminLinePhone: z.string().optional(),
+  adminMobilePhone: z.string().optional(),
+  note: z.string().optional(),
+})
+
+type CreateDeptAdminInput = z.input<typeof createDeptAdminSchema>
+
+const createDeptAdminDefaultValues: CreateDeptAdminInput = {
+  uid: '',
+  deptCode: '',
+  adminEmail: '',
+  adminLinePhone: '',
+  adminMobilePhone: '',
+  note: '',
+}
+
+interface DeptAdminCreateDialogProps {
+  onDeptAdminCreated: () => void
+}
+
+export function DeptAdminCreateDialog({ onDeptAdminCreated }: DeptAdminCreateDialogProps) {
+  // 表单 dialog 控制
+  const [isCreateDialogOpen, setIsCreateDialogOpen] = useState(false)
+
+  // react-hook-form 管理创建表单
+  const createForm = useForm<CreateDeptAdminInput>({
+    resolver: zodResolver(createDeptAdminSchema),
+    defaultValues: createDeptAdminDefaultValues,
+  })
+
+  // 获取院系列表
+  const { data: depts } = trpc.common.getDepts.useQuery()
+
+  const deptOptions = depts?.map(dept => ({ id: dept.code, name: dept.fullName, shortName: dept.name })) || []
+  const { sortedOptions: sortedDeptOptions, logSelection: logDeptSelection } = useSmartSelectOptions({
+    options: deptOptions,
+    context: 'deptAdmin.create.dept',
+    scope: 'personal',
+  })
+
+  // 创建院系管理员 mutation
+  const createDeptAdminMutation = trpc.deptAdmin.create.useMutation({
+    onSuccess: () => {
+      setIsCreateDialogOpen(false)
+      createForm.reset(createDeptAdminDefaultValues)
+      toast.success('院系管理员创建成功')
+      onDeptAdminCreated()
+    },
+    onError: (error) => {
+      toast.error(error.message || '创建院系管理员失败')
+    },
+  })
+
+  // 定义字段配置
+  const formFields: FormFieldConfig[] = React.useMemo(() => [
+    {
+      name: 'uid',
+      label: '用户ID',
+      required: true,
+      render: ({ field }) => (
+        <Input {...field} placeholder="请输入用户ID（职工号）" />
+      ),
+    },
+    {
+      name: 'deptCode',
+      label: '院系',
+      required: true,
+      render: ({ field }) => (
+        <AdvancedSelect
+          {...field}
+          options={sortedDeptOptions}
+          onChange={(value) => { logDeptSelection(value); field.onChange(value) }}
+          filterFunction={(option, searchValue) => {
+            const search = searchValue.toLowerCase()
+            return option.id.includes(search) || option.name.toLowerCase().includes(search) ||
+                  (option.shortName && option.shortName.toLowerCase().includes(search))
+          }}
+        >
+          <SelectPopover>
+            <SelectTrigger placeholder="请选择院系">
+              <SelectedName />
+            </SelectTrigger>
+            <SelectContent>
+              <SelectInput placeholder="搜索院系名称/代码" />
+              <SelectItemList />
+            </SelectContent>
+          </SelectPopover>
+        </AdvancedSelect>
+      ),
+    },
+    {
+      name: 'adminEmail',
+      label: '邮箱',
+      render: ({ field }) => (
+        <Input {...field} type="email" placeholder="请输入邮箱" />
+      ),
+    },
+    {
+      name: 'adminLinePhone',
+      label: '座机',
+      render: ({ field }) => (
+        <Input {...field} placeholder="请输入座机号码" />
+      ),
+    },
+    {
+      name: 'adminMobilePhone',
+      label: '手机',
+      render: ({ field }) => (
+        <Input {...field} placeholder="请输入手机号码" />
+      ),
+    },
+    {
+      name: 'note',
+      label: '备注',
+      render: ({ field }) => (
+        <Textarea {...field} placeholder="请输入备注信息" className="min-h-[80px]" />
+      ),
+    },
+  ], [sortedDeptOptions, logDeptSelection])
+
+  const handleSubmit = async (data: CreateDeptAdminInput) => {
+    createDeptAdminMutation.mutate(data)
+  }
+
+  const handleClose = () => {
+    setIsCreateDialogOpen(false)
+  }
+
+  return (
+    <>
+      <Dialog open={isCreateDialogOpen} onOpenChange={setIsCreateDialogOpen}>
+        <DialogTrigger asChild>
+          <Button className="flex items-center gap-2">
+            <Plus className="h-4 w-4" />
+            创建院系管理员
+          </Button>
+        </DialogTrigger>
+      </Dialog>
+      
+      <FormDialog
+        isOpen={isCreateDialogOpen}
+        title="创建院系管理员"
+        description="请填写院系管理员信息"
+        form={createForm}
+        fields={formFields}
+        onClose={handleClose}
+      >
+        <FormGridContent />
+        <FormActionBar>
+          <FormCancelAction />
+          <FormSubmitAction onSubmit={handleSubmit} isSubmitting={createDeptAdminMutation.isPending}>创建</FormSubmitAction>
+        </FormActionBar>
+      </FormDialog>
+    </>
+  )
+}
--- a/src/app/(main)/users/dept-admin/components/DeptAdminDeleteDialog.tsx
+++ b/src/app/(main)/users/dept-admin/components/DeptAdminDeleteDialog.tsx
@@ -0,0 +1,84 @@
+'use client'
+
+import React from 'react'
+import { trpc } from '@/lib/trpc'
+import {
+  AlertDialog,
+  AlertDialogAction,
+  AlertDialogCancel,
+  AlertDialogContent,
+  AlertDialogDescription,
+  AlertDialogFooter,
+  AlertDialogHeader,
+  AlertDialogTitle,
+} from '@/components/ui/alert-dialog'
+import { toast } from 'sonner'
+
+interface DeptAdminDeleteDialogProps {
+  deptAdminId: number | null
+  isOpen: boolean
+  onClose: () => void
+  onDeptAdminDeleted: () => void
+}
+
+export function DeptAdminDeleteDialog({
+  deptAdminId,
+  isOpen,
+  onClose,
+  onDeptAdminDeleted,
+}: DeptAdminDeleteDialogProps) {
+  // 获取院系管理员详情
+  const { data: deptAdmin } = trpc.deptAdmin.getById.useQuery(
+    { id: deptAdminId! },
+    { enabled: !!deptAdminId && isOpen }
+  )
+
+  // 删除院系管理员 mutation
+  const deleteDeptAdminMutation = trpc.deptAdmin.delete.useMutation({
+    onSuccess: () => {
+      onClose()
+      toast.success('院系管理员删除成功')
+      onDeptAdminDeleted()
+    },
+    onError: (error) => {
+      toast.error(error.message || '删除院系管理员失败')
+    },
+  })
+
+  const handleConfirm = () => {
+    if (deptAdminId) {
+      deleteDeptAdminMutation.mutate({ id: deptAdminId })
+    }
+  }
+
+  return (
+    <AlertDialog open={isOpen} onOpenChange={(open) => !open && onClose()}>
+      <AlertDialogContent>
+        <AlertDialogHeader>
+          <AlertDialogTitle>确认删除</AlertDialogTitle>
+          <AlertDialogDescription>
+            {deptAdmin ? (
+              <>
+                确定要删除院系管理员 <strong>{deptAdmin.user?.name || deptAdmin.uid}</strong> 在 <strong>{deptAdmin.dept?.name || deptAdmin.deptCode}</strong> 的管理权限吗？
+                <br />
+                此操作无法撤销。
+              </>
+            ) : (
+              '确定要删除该院系管理员吗？此操作无法撤销。'
+            )}
+          </AlertDialogDescription>
+        </AlertDialogHeader>
+        <AlertDialogFooter>
+          <AlertDialogCancel disabled={deleteDeptAdminMutation.isPending}>取消</AlertDialogCancel>
+          <AlertDialogAction
+            onClick={handleConfirm}
+            disabled={deleteDeptAdminMutation.isPending}
+            className="bg-destructive text-destructive-foreground hover:bg-destructive/90"
+          >
+            {deleteDeptAdminMutation.isPending ? '删除中...' : '确认删除'}
+          </AlertDialogAction>
+        </AlertDialogFooter>
+      </AlertDialogContent>
+    </AlertDialog>
+  )
+}
--- a/src/app/(main)/users/dept-admin/components/DeptAdminUpdateDialog.tsx
+++ b/src/app/(main)/users/dept-admin/components/DeptAdminUpdateDialog.tsx
@@ -0,0 +1,194 @@
+'use client'
+
+import React, { useEffect } from 'react'
+import { useForm } from 'react-hook-form'
+import { z } from 'zod'
+import { zodResolver } from '@hookform/resolvers/zod'
+import { trpc } from '@/lib/trpc'
+import { Input } from '@/components/ui/input'
+import { toast } from 'sonner'
+import { FormDialog, FormActionBar, FormGridContent, FormCancelAction, FormSubmitAction, type FormFieldConfig } from '@/components/common/form-dialog'
+import {
+  AdvancedSelect,
+  SelectPopover,
+  SelectTrigger,
+  SelectContent,
+  SelectInput,
+  SelectItemList,
+  SelectedName
+} from '@/components/common/advanced-select'
+import { useSmartSelectOptions } from '@/hooks/use-smart-select-options'
+import { Textarea } from '@/components/ui/textarea'
+
+// 更新院系管理员的 schema
+const updateDeptAdminSchema = z.object({
+  id: z.number(),
+  uid: z.string().min(1, '用户ID不能为空'),
+  deptCode: z.string().min(1, '院系代码不能为空'),
+  adminEmail: z.string().email('邮箱格式不正确').optional().or(z.literal('')),
+  adminLinePhone: z.string().optional(),
+  adminMobilePhone: z.string().optional(),
+  note: z.string().optional(),
+})
+
+type UpdateDeptAdminInput = z.input<typeof updateDeptAdminSchema>
+
+interface DeptAdminUpdateDialogProps {
+  deptAdminId: number | null
+  isOpen: boolean
+  onClose: () => void
+  onDeptAdminUpdated: () => void
+}
+
+export function DeptAdminUpdateDialog({
+  deptAdminId,
+  isOpen,
+  onClose,
+  onDeptAdminUpdated,
+}: DeptAdminUpdateDialogProps) {
+  // react-hook-form 管理更新表单
+  const updateForm = useForm<UpdateDeptAdminInput>({
+    resolver: zodResolver(updateDeptAdminSchema),
+    defaultValues: {
+      id: 0,
+      uid: '',
+      deptCode: '',
+      adminEmail: '',
+      adminLinePhone: '',
+      adminMobilePhone: '',
+      note: '',
+    },
+  })
+
+  // 获取院系列表
+  const { data: depts } = trpc.common.getDepts.useQuery()
+
+  const deptOptions = depts?.map(dept => ({ id: dept.code, name: dept.fullName, shortName: dept.name })) || []
+  const { sortedOptions: sortedDeptOptions, logSelection: logDeptSelection } = useSmartSelectOptions({
+    options: deptOptions,
+    context: 'deptAdmin.update.dept',
+    scope: 'personal',
+  })
+
+  // 获取院系管理员详情
+  const { data: deptAdmin, isLoading } = trpc.deptAdmin.getById.useQuery(
+    { id: deptAdminId! },
+    { enabled: !!deptAdminId && isOpen }
+  )
+
+  // 更新院系管理员 mutation
+  const updateDeptAdminMutation = trpc.deptAdmin.update.useMutation({
+    onSuccess: () => {
+      onClose()
+      toast.success('院系管理员更新成功')
+      onDeptAdminUpdated()
+    },
+    onError: (error) => {
+      toast.error(error.message || '更新院系管理员失败')
+    },
+  })
+
+  // 当获取到院系管理员数据时，填充表单
+  useEffect(() => {
+    if (deptAdmin) {
+      updateForm.reset({
+        id: deptAdmin.id,
+        uid: deptAdmin.uid,
+        deptCode: deptAdmin.deptCode,
+        adminEmail: deptAdmin.adminEmail || '',
+        adminLinePhone: deptAdmin.adminLinePhone || '',
+        adminMobilePhone: deptAdmin.adminMobilePhone || '',
+        note: deptAdmin.note || '',
+      })
+    }
+  }, [deptAdmin, updateForm])
+
+  // 定义字段配置
+  const formFields: FormFieldConfig[] = React.useMemo(() => [
+    {
+      name: 'uid',
+      label: '用户ID',
+      required: true,
+      render: ({ field }) => (
+        <Input {...field} placeholder="请输入用户ID（职工号）" />
+      ),
+    },
+    {
+      name: 'deptCode',
+      label: '院系',
+      required: true,
+      render: ({ field }) => (
+        <AdvancedSelect
+          {...field}
+          options={sortedDeptOptions}
+          onChange={(value) => { logDeptSelection(value); field.onChange(value) }}
+          filterFunction={(option, searchValue) => {
+            const search = searchValue.toLowerCase()
+            return option.id.includes(search) || option.name.toLowerCase().includes(search) ||
+                  (option.shortName && option.shortName.toLowerCase().includes(search))
+          }}
+        >
+          <SelectPopover>
+            <SelectTrigger placeholder="请选择院系">
+              <SelectedName />
+            </SelectTrigger>
+            <SelectContent>
+              <SelectInput placeholder="搜索院系名称/代码" />
+              <SelectItemList />
+            </SelectContent>
+          </SelectPopover>
+        </AdvancedSelect>
+      ),
+    },
+    {
+      name: 'adminEmail',
+      label: '邮箱',
+      render: ({ field }) => (
+        <Input {...field} type="email" placeholder="请输入邮箱" />
+      ),
+    },
+    {
+      name: 'adminLinePhone',
+      label: '座机',
+      render: ({ field }) => (
+        <Input {...field} placeholder="请输入座机号码" />
+      ),
+    },
+    {
+      name: 'adminMobilePhone',
+      label: '手机',
+      render: ({ field }) => (
+        <Input {...field} placeholder="请输入手机号码" />
+      ),
+    },
+    {
+      name: 'note',
+      label: '备注',
+      render: ({ field }) => (
+        <Textarea {...field} placeholder="请输入备注信息" className="min-h-[80px]" />
+      ),
+    },
+  ], [sortedDeptOptions, logDeptSelection])
+
+  const handleSubmit = async (data: UpdateDeptAdminInput) => {
+    updateDeptAdminMutation.mutate(data)
+  }
+
+  return (
+    <FormDialog
+      isOpen={isOpen}
+      title="编辑院系管理员"
+      description="修改院系管理员信息"
+      form={updateForm}
+      fields={formFields}
+      onClose={onClose}
+      isLoading={isLoading}
+    >
+      <FormGridContent />
+      <FormActionBar>
+        <FormCancelAction />
+        <FormSubmitAction onSubmit={handleSubmit} isSubmitting={updateDeptAdminMutation.isPending}>保存</FormSubmitAction>
+      </FormActionBar>
+    </FormDialog>
+  )
+}
--- a/src/app/(main)/users/dept-admin/page.tsx
+++ b/src/app/(main)/users/dept-admin/page.tsx
@@ -0,0 +1,143 @@
+'use client'
+
+import React, { useState, useCallback, useMemo, Suspense } from 'react'
+import { trpc } from '@/lib/trpc'
+import { Card, CardContent, CardHeader, CardTitle } from '@/components/ui/card'
+import { DeptAdminCreateDialog } from './components/DeptAdminCreateDialog'
+import { DeptAdminUpdateDialog } from './components/DeptAdminUpdateDialog'
+import { DeptAdminDeleteDialog } from './components/DeptAdminDeleteDialog'
+import { DataTable } from '@/components/data-table/data-table'
+import { DataTableToolbar } from '@/components/data-table/toolbar'
+import { createDeptAdminColumns, type DeptAdminColumnsOptions } from './columns'
+import type { DeptAdmin } from '@/server/routers/dept-admin'
+import { useDataTable } from '@/hooks/use-data-table'
+import { keepPreviousData } from '@tanstack/react-query'
+import { DataTableSortList } from '@/components/data-table/sort-list'
+import { toast } from 'sonner'
+import { DataTableSkeleton } from '@/components/data-table/table-skeleton'
+
+interface DeptAdminPageDataTableProps {
+  onEdit: (id: number) => void
+  onDelete: (id: number) => void
+}
+
+function DeptAdminPageDataTable({ onEdit, onDelete }: DeptAdminPageDataTableProps) {
+  // 获取部门列表用于过滤器选项
+  const { data: depts } = trpc.common.getDepts.useQuery()
+
+  // 创建表格列定义选项
+  const columnsOptions: DeptAdminColumnsOptions = useMemo(() => ({
+    depts: depts || [],
+  }), [depts])
+
+  // 创建表格列定义
+  const columns = useMemo(() => createDeptAdminColumns({
+    onEdit,
+    onDelete,
+  }, columnsOptions), [onEdit, onDelete, columnsOptions])
+
+  // 使用 useDataTable hook，传入 queryFn
+  const { table, queryResult } = useDataTable<DeptAdmin>({
+    columns,
+    initialState: {
+      pagination: { pageIndex: 1, pageSize: 10 },
+      columnPinning: { left: ["select"], right: ["actions"] },
+      columnVisibility: { id: false }
+    },
+    getRowId: (row) => row.id.toString(),
+    queryFn: useCallback((params) => {
+      const result = trpc.deptAdmin.list.useQuery(params, {
+        placeholderData: keepPreviousData,
+      })
+      if (result.error) {
+        toast.error("获取院系管理员数据失败:" + result.error.toString().substring(0, 100))
+      }
+      return result
+    }, []),
+  })
+
+  return (
+    <DataTable table={table} isLoading={queryResult.isLoading}>
+      <DataTableToolbar table={table}>
+        <DataTableSortList table={table} />
+      </DataTableToolbar>
+    </DataTable>
+  )
+}
+
+export default function DeptAdminPage() {
+  // 更新院系管理员对话框状态
+  const [updateDeptAdminId, setUpdateDeptAdminId] = useState<number | null>(null)
+  const [isUpdateDialogOpen, setIsUpdateDialogOpen] = useState(false)
+
+  // 删除院系管理员对话框状态
+  const [deleteDeptAdminId, setDeleteDeptAdminId] = useState<number | null>(null)
+  const [isDeleteDialogOpen, setIsDeleteDialogOpen] = useState(false)
+
+  // 用于刷新数据的 utils
+  const utils = trpc.useUtils()
+
+  // 处理编辑院系管理员
+  const handleEditDeptAdmin = useCallback((id: number) => {
+    setUpdateDeptAdminId(id)
+    setIsUpdateDialogOpen(true)
+  }, [])
+
+  // 关闭更新对话框
+  const handleCloseUpdateDialog = useCallback(() => {
+    setIsUpdateDialogOpen(false)
+    setUpdateDeptAdminId(null)
+  }, [])
+
+  // 处理删除院系管理员
+  const handleDeleteDeptAdmin = useCallback((id: number) => {
+    setDeleteDeptAdminId(id)
+    setIsDeleteDialogOpen(true)
+  }, [])
+
+  // 关闭删除对话框
+  const handleCloseDeleteDialog = useCallback(() => {
+    setIsDeleteDialogOpen(false)
+    setDeleteDeptAdminId(null)
+  }, [])
+
+  // 刷新院系管理员列表
+  const handleRefreshDeptAdmins = useCallback(() => {
+    utils.deptAdmin.list.invalidate()
+  }, [utils])
+
+  return (
+    <div className="space-y-6">
+      {/* 院系管理员列表和创建按钮 */}
+      <Card>
+        <CardHeader className="flex items-center justify-between">
+          <CardTitle className="text-lg">院系管理员列表</CardTitle>
+          <div className="flex items-center gap-2">
+            <DeptAdminCreateDialog onDeptAdminCreated={handleRefreshDeptAdmins} />
+          </div>
+        </CardHeader>
+        <CardContent>
+          <Suspense fallback={<DataTableSkeleton columnCount={10} rowCount={10} />}>
+            <DeptAdminPageDataTable onEdit={handleEditDeptAdmin} onDelete={handleDeleteDeptAdmin} />
+          </Suspense>
+        </CardContent>
+      </Card>
+
+      {/* 更新院系管理员对话框 */}
+      <DeptAdminUpdateDialog
+        deptAdminId={updateDeptAdminId}
+        isOpen={isUpdateDialogOpen}
+        onClose={handleCloseUpdateDialog}
+        onDeptAdminUpdated={handleRefreshDeptAdmins}
+      />
+
+      {/* 删除院系管理员对话框 */}
+      <DeptAdminDeleteDialog
+        deptAdminId={deleteDeptAdminId}
+        isOpen={isDeleteDialogOpen}
+        onClose={handleCloseDeleteDialog}
+        onDeptAdminDeleted={handleRefreshDeptAdmins}
+      />
+    </div>
+  )
+}
--- a/src/app/(main)/users/layout.tsx
+++ b/src/app/(main)/users/layout.tsx
@@ -0,0 +1,13 @@
+"use client";
+
+export default function UsersLayout({
+  children,
+}: {
+  children: React.ReactNode;
+}) {
+  return (
+    <>
+      {children}
+    </>
+  );
+}
--- a/src/app/(main)/users/user-info/columns.tsx
+++ b/src/app/(main)/users/user-info/columns.tsx
--- a/src/app/(main)/users/user-info/components/BatchAuthorizationDialog.tsx
+++ b/src/app/(main)/users/user-info/components/BatchAuthorizationDialog.tsx
--- a/src/app/(main)/users/user-info/components/RoleManagementDialog.tsx
+++ b/src/app/(main)/users/user-info/components/RoleManagementDialog.tsx
--- a/src/app/(main)/users/user-info/components/UserCreateDialog.tsx
+++ b/src/app/(main)/users/user-info/components/UserCreateDialog.tsx
--- a/src/app/(main)/users/user-info/components/UserDeleteDialog.tsx
+++ b/src/app/(main)/users/user-info/components/UserDeleteDialog.tsx
--- a/src/app/(main)/users/user-info/components/UserUpdateDialog.tsx
+++ b/src/app/(main)/users/user-info/components/UserUpdateDialog.tsx
@@ -218,6 +218,7 @@ export function UserUpdateDialog({ userId, isOpen, onClose, onUserUpdated }: Use
      form={updateForm}
      fields={formFields}
      onClose={handleClose}
+      isLoading={isLoadingUser}
    >
      <FormGridContent />
      <FormActionBar>
--- a/src/app/(main)/users/user-info/page.tsx
+++ b/src/app/(main)/users/user-info/page.tsx
--- a/src/components/common/form-dialog.tsx
+++ b/src/components/common/form-dialog.tsx
@@ -32,12 +32,14 @@ import {
 import { useIsMobile } from '@/hooks/use-mobile'
 import { cn } from '@/lib/utils'
 import { Loader2 } from 'lucide-react'
+import { Skeleton } from '@/components/ui/skeleton'

 // FormDialog Context
 export interface FormDialogContextValue {
  form: UseFormReturn<any>
  close: () => void
  fields: FormFieldConfig[]
+  isLoading?: boolean
 }

 const FormDialogContext = createContext<FormDialogContextValue | null>(null)
@@ -77,7 +79,7 @@ export function FormCancelAction({ children = '取消', variant = 'outline', onC
  }
  
  return (
-    <Button type="button" variant={variant} onClick={handleClick} {...props}>
+    <Button type="button" variant={variant} onClick={handleClick} disabled={props.disabled} {...props}>
      {children}
    </Button>
  )
@@ -99,7 +101,7 @@ export function FormResetAction({
  confirmDescription = '确定要重置表单吗？表单将回到打开时的状态。',
  ...props
 }: FormResetActionProps) {
-  const { form } = useFormDialogContext()
+  const { form, isLoading } = useFormDialogContext()
  const [showConfirm, setShowConfirm] = useState(false)
  
  const handleConfirm = () => {
@@ -113,7 +115,7 @@ export function FormResetAction({
  
  return (
    <>
-      <Button type="button" variant={variant} onClick={() => setShowConfirm(true)} {...props}>
+      <Button type="button" variant={variant} onClick={() => setShowConfirm(true)} disabled={isLoading || props.disabled} {...props}>
        {children}
      </Button>
      
@@ -151,14 +153,14 @@ export function FormSubmitAction({
  variant = 'default',
  ...props
 }: FormSubmitActionProps) {
-  const { form } = useFormDialogContext()
+  const { form, isLoading } = useFormDialogContext()
  
  return (
    <Button
      type="button"
      variant={variant}
      onClick={form.handleSubmit(onSubmit)}
-      disabled={isSubmitting || disabled}
+      disabled={isSubmitting || disabled || isLoading}
      {...props}
    >
      {children}
@@ -186,7 +188,21 @@ export interface FormGridContentProps {
 }

 export function FormGridContent({ className = 'grid grid-cols-1 gap-4' }: FormGridContentProps) {
-  const { form, fields } = useFormDialogContext()
+  const { form, fields, isLoading } = useFormDialogContext()
+  
+  // 如果正在加载，显示骨架屏
+  if (isLoading) {
+    return (
+      <div className={cn("p-1", className)}>
+        {fields.map((fieldConfig) => (
+          <div key={fieldConfig.name} className={cn("space-y-2", fieldConfig.className || '')}>
+            <Skeleton className="h-4 w-20" />
+            <Skeleton className="h-10 w-full" />
+          </div>
+        ))}
+      </div>
+    )
+  }
  
  return (
    <div className={cn("p-1", className)}>
@@ -223,6 +239,7 @@ export interface FormDialogProps {
  className?: string // 允许自定义对话框内容样式，可控制宽度
  formClassName?: string // 允许自定义表格样式
  children: React.ReactNode // 操作按钮区域内容
+  isLoading?: boolean // 是否正在加载数据
 }

 export function FormDialog({
@@ -235,13 +252,14 @@ export function FormDialog({
  className = 'max-w-md',
  formClassName,
  children,
+  isLoading = false,
 }: FormDialogProps) {
  const isMobile = useIsMobile()
  const formRef = useRef<HTMLFormElement>(null)

  // 当对话框打开时，自动聚焦到第一个表单输入控件
  useEffect(() => {
-    if (isOpen) {
+    if (isOpen && !isLoading) {
      // 使当前拥有焦点的元素（通常是用来触发打开这个drawer的控件）失去焦点，不然控制台会警告焦点在一个要被隐藏于屏幕阅读器的控件上
      (document.activeElement as HTMLElement)?.blur();
      // 使用 setTimeout 确保 DOM 已完全渲染
@@ -259,7 +277,7 @@ export function FormDialog({

      return () => clearTimeout(timer)
    }
-  }, [isOpen])
+  }, [isOpen, isLoading])

  const close = () => {
    onClose()
@@ -269,7 +287,8 @@ export function FormDialog({
  const contextValue: FormDialogContextValue = {
    form,
    close,
-    fields
+    fields,
+    isLoading
  }

  // 表单内容组件，在 Dialog 和 Drawer 中复用
--- a/src/components/layout/app-sidebar.tsx
+++ b/src/components/layout/app-sidebar.tsx
@@ -45,7 +45,7 @@ export function AppSidebar({ menuItems, ...props }: AppSidebarProps) {
      // 等待侧边栏关闭动画完成后再导航
      setTimeout(() => {
        router.push(href)
-      }, 300)
+      }, 350)
    }
  }, [isMobile, setOpenMobile, router])

--- a/src/components/layout/header.tsx
+++ b/src/components/layout/header.tsx
@@ -1,6 +1,6 @@
 'use client'

-import { useState } from 'react'
+import { useEffect, useState } from 'react'
 import { User, LogOut, KeyRound } from 'lucide-react'
 import { DevPanel } from '@/app/(main)/dev/panel'
 import { ChangePasswordDialog } from '@/components/layout/change-password-dialog'
@@ -14,7 +14,6 @@ import {
  DropdownMenuSeparator,
  DropdownMenuTrigger,
 } from '@/components/ui/dropdown-menu'
-import { Badge } from '@/components/ui/badge'
 import { Separator } from '@/components/ui/separator'
 import { SidebarTrigger } from '@/components/ui/sidebar'
 import { signOut } from 'next-auth/react'
@@ -23,6 +22,11 @@ import { useTheme } from 'next-themes'
 import { ThemeToggleButton, useThemeTransition } from '@/components/common/theme-toggle-button'
 import { getMenuTitle } from '@/constants/menu'
 import type { User as AppUser } from '@/types/user'
+import { useUserStore } from '@/lib/stores/userStore'
+import { toast } from 'sonner'
+import { trpc } from '@/lib/trpc'
+import { AdvancedSelect, SelectContent, SelectedName, SelectInput, SelectItemList, SelectPopover, SelectTrigger } from '@/components/common/advanced-select'
+import type { Dept } from '@prisma/client'

 interface HeaderProps {
  user?: AppUser
@@ -38,6 +42,47 @@ export function Header({ user }: HeaderProps) {

  const pageTitle = getMenuTitle(pathname, 2) // 只匹配到第二级菜单

+  // 从zustand store获取当前管理的院系信息
+  const { setCurrentManagedDept } = useUserStore()
+
+  // 获取可管理的院系列表（包含当前管理的院系信息）
+  const { data: managedDeptsData } = trpc.users.getManagedDepts.useQuery()
+  
+  // 本地状态管理
+  const [currentManagedDeptCode, setCurrentManagedDeptCode] = useState<string | null>(null)
+  const [managedDepts, setManagedDepts] = useState<Array<Dept>>([])
+  
+  // 初始化数据
+  useEffect(() => {
+    if (managedDeptsData && managedDeptsData.currentDept !== undefined) {
+      setCurrentManagedDeptCode(managedDeptsData.currentDept)
+      setManagedDepts(managedDeptsData.depts)
+      
+      // 更新store中的当前管理院系信息
+      const deptInfo = managedDeptsData.depts.find(dept => dept.code === managedDeptsData.currentDept) || null
+      setCurrentManagedDept(deptInfo)
+    }
+  }, [managedDeptsData, setCurrentManagedDept])
+  
+  // 切换管理院系
+  const switchManagedDeptMutation = trpc.users.switchManagedDept.useMutation({
+    onSuccess: (data) => {
+      toast.success('切换管理院系成功')
+      // 更新本地状态
+      setCurrentManagedDeptCode(data.deptCode)
+      // 更新store中的当前管理院系信息 
+      setCurrentManagedDept(managedDepts.find(dept => dept.code === data.deptCode) || null)
+    },
+    onError: (error) => {
+      toast.error(error.message || '切换管理院系失败')
+    },
+  })
+  
+  // 处理院系切换
+  const handleDeptChange = (deptCode: string | null) => {
+    switchManagedDeptMutation.mutate({ deptCode })
+  }
+
  const handleThemeToggle = () => {
    startTransition(() => {
      setTheme(theme === 'dark' ? 'light' : 'dark')
@@ -105,6 +150,52 @@ export function Header({ user }: HeaderProps) {
              <DropdownMenuItem disabled>
                {user.isSuperAdmin ? '超级管理员' : (Array.isArray(user.roles) ? user.roles.join('、') : user.roles)}
              </DropdownMenuItem>
+              {/* 管理院系 - 根据可管理院系数量决定显示方式 */}
+              {managedDepts.length > 0 && (
+                <>
+                  <DropdownMenuSeparator />
+                  <DropdownMenuLabel>管理院系</DropdownMenuLabel>
+                  {managedDepts.length === 1 ? (
+                    // 只有一个可管理院系时，直接显示院系名称
+                    <DropdownMenuItem disabled>
+                      {managedDepts[0].fullName}
+                    </DropdownMenuItem>
+                  ) : (
+                    // 多个可管理院系时，显示下拉选择器
+                    <div className="px-2 py-1.5">
+                      <AdvancedSelect
+                        value={currentManagedDeptCode}
+                        onChange={handleDeptChange}
+                        options={managedDepts.map(dept => ({
+                          id: dept.code,
+                          name: dept.fullName,
+                          shortName: dept.name
+                        }))}
+                        disabled={switchManagedDeptMutation.isPending}
+                        filterFunction={(option, searchValue) => {
+                          const search = searchValue.toLowerCase()
+                          return option.id.includes(search) ||
+                                 option.name.toLowerCase().includes(search) ||
+                                 (option.shortName && option.shortName.toLowerCase().includes(search))
+                        }}
+                      >
+                        <SelectPopover>
+                          <SelectTrigger
+                            placeholder="请选择管理院系"
+                            className="h-9"
+                          >
+                            <SelectedName />
+                          </SelectTrigger>
+                          <SelectContent>
+                            {managedDepts.length > 5 && <SelectInput placeholder="搜索院系名称/代码" />}
+                            <SelectItemList />
+                          </SelectContent>
+                        </SelectPopover>
+                      </AdvancedSelect>
+                    </div>
+                  )}
+                </>
+              )}
              <DropdownMenuSeparator />
              <DropdownMenuItem
                className="text-red-600 cursor-pointer"
--- a/src/constants/menu-icons.ts
+++ b/src/constants/menu-icons.ts
@@ -27,7 +27,9 @@ import {
  FileBarChart,
  Globe,
  Menu,
-  LucideIcon
+  LucideIcon,
+  User,
+  Building
 } from 'lucide-react'

 /**
@@ -62,6 +64,8 @@ export const menuIconMap: Record<string, LucideIcon> = {
  'ClipboardCheck': ClipboardCheck,
  'FileBarChart': FileBarChart,
  'Globe': Globe,
+  'User': User,
+  'Building': Building
 }

 /**
--- a/src/constants/menu.ts
+++ b/src/constants/menu.ts
@@ -220,6 +220,20 @@ export const menuItems: MenuItem[] = [
    href: '/users',
    icon: 'UserCog',
    permission: Permissions.USER_MANAGE,
+    children: [
+      {
+        title: '用户与授权',
+        href: '/users/user-info',
+        icon: 'UserCog',
+        permission: Permissions.USER_MANAGE,
+      },
+      {
+        title: '院系管理员',
+        href: '/users/dept-admin',
+        icon: 'Building',
+        permission: Permissions.USER_MANAGE,
+      }
+    ]
  },
  {
    title: '系统设置',
--- a/src/constants/site.ts
+++ b/src/constants/site.ts
@@ -3,4 +3,4 @@
 */
 export const SITE_NAME = 'Hair Keeper'
 export const SITE_DESCRIPTION = '高度集成、深度定制、约定优于配置的全栈Web应用模板，旨在保持灵活性的同时提供一套基于成熟架构的开发底座，自带身份认证、权限控制、丰富前端组件、文件上传、后台任务、智能体开发等丰富功能，提供AI开发辅助，免于纠结功能如何实现，可快速上手专注于业务逻辑'
-export const SITE_VERSION = 'v1.0.0'
+export const SITE_VERSION = 'v1.1.0'
--- a/src/instrumentation.ts
+++ b/src/instrumentation.ts
--- a/src/lib/stores/userStore.ts
+++ b/src/lib/stores/userStore.ts
@@ -0,0 +1,18 @@
+import { create } from 'zustand'
+import type { Dept } from '@prisma/client'
+
+/**
+ * 用户状态管理Store
+ * 用于管理用户相关的全局状态，如当前管理的院系
+ */
+interface UserStore {
+  // 当前管理的院系
+  currentManagedDept: Dept | null
+  // 设置当前管理的院系
+  setCurrentManagedDept: (deptInfo: Dept | null) => void
+}
+
+export const useUserStore = create<UserStore>((set) => ({
+  currentManagedDept: null,
+  setCurrentManagedDept: (deptInfo) => set({ currentManagedDept: deptInfo }),
+}))
--- a/src/server/routers/_app.ts
+++ b/src/server/routers/_app.ts
@@ -1,5 +1,6 @@
 import { createTRPCRouter } from '@/server/trpc'
 import { usersRouter } from './users'
+import { deptAdminRouter } from './dept-admin'
 import { selectionRouter } from './selection'
 import { uploadRouter } from './upload'
 import { globalRouter } from './global'
@@ -14,6 +15,7 @@ import { commonRouter } from './common'
 export const appRouter = createTRPCRouter({
  common: commonRouter,
  users: usersRouter,
+  deptAdmin: deptAdminRouter,
  selection: selectionRouter,
  upload: uploadRouter,
  global: globalRouter,
--- a/src/server/routers/common.ts
+++ b/src/server/routers/common.ts
@@ -1,8 +1,12 @@
 // 通用接口，与特定业务关联性不强，需要在不同的地方反复使用
 import { createTRPCRouter, permissionRequiredProcedure } from '@/server/trpc'
+import { inferProcedureOutput } from '@trpc/server';

 export const commonRouter = createTRPCRouter({
  getDepts: permissionRequiredProcedure('').query(({ ctx }) =>
    ctx.db.dept.findMany({ orderBy: { code: 'asc' } })
  ),
 })
+
+export type CommonRouter = typeof commonRouter;
+export type Dept = inferProcedureOutput<CommonRouter['getDepts']>[number]
--- a/src/server/routers/dept-admin.ts
+++ b/src/server/routers/dept-admin.ts
@@ -0,0 +1,206 @@
+import { createTRPCRouter, permissionRequiredProcedure } from '@/server/trpc'
+import { Permissions } from '@/constants/permissions'
+import { dataTableQueryParamsSchema } from '@/lib/schema/data-table'
+import { transformDataTableQueryParams } from '@/server/utils/data-table-helper'
+import { z } from 'zod'
+import { inferProcedureOutput, TRPCError } from '@trpc/server'
+
+// 创建院系管理员的 schema
+const createDeptAdminSchema = z.object({
+  uid: z.string().min(1, '用户ID不能为空'),
+  deptCode: z.string().min(1, '院系代码不能为空'),
+  adminEmail: z.string().email('邮箱格式不正确').optional().or(z.literal('')),
+  adminLinePhone: z.string().optional(),
+  adminMobilePhone: z.string().optional(),
+  note: z.string().optional(),
+})
+
+// 更新院系管理员的 schema
+const updateDeptAdminSchema = z.object({
+  id: z.number(),
+  uid: z.string().min(1, '用户ID不能为空'),
+  deptCode: z.string().min(1, '院系代码不能为空'),
+  adminEmail: z.string().email('邮箱格式不正确').optional().or(z.literal('')),
+  adminLinePhone: z.string().optional(),
+  adminMobilePhone: z.string().optional(),
+  note: z.string().optional(),
+})
+
+export const deptAdminRouter = createTRPCRouter({
+  list: permissionRequiredProcedure(Permissions.USER_MANAGE)
+    .input(dataTableQueryParamsSchema)
+    .query(async ({ ctx, input }) => {
+      const { where, orderBy, skip, take } = transformDataTableQueryParams(input, {
+        model: 'DeptAdmin',
+        columns: {
+          id: { field: 'id', variant: 'number', sortable: true },
+          uid: { field: 'uid', variant: 'text', sortable: true },
+          userName: { field: 'user.name', variant: 'text', sortable: true },
+          deptCode: { field: 'deptCode', variant: 'multiSelect', sortable: true },
+          adminEmail: { field: 'adminEmail', variant: 'text', sortable: true },
+          adminLinePhone: { field: 'adminLinePhone', variant: 'text', sortable: true },
+          adminMobilePhone: { field: 'adminMobilePhone', variant: 'text', sortable: true },
+          createdAt: { field: 'createdAt', sortable: true },
+          updatedAt: { field: 'updatedAt', sortable: true },
+        },
+      })
+
+      const [data, total] = await Promise.all([
+        ctx.db.deptAdmin.findMany({
+          where,
+          orderBy: orderBy.some(item => 'id' in item) ? orderBy : [...orderBy, { id: 'asc' }],
+          skip,
+          take,
+          include: {
+            user: { select: { id: true, name: true } },
+            dept: { select: { code: true, name: true, fullName: true } },
+          },
+        }),
+        ctx.db.deptAdmin.count({ where }),
+      ])
+
+      return { data, total }
+    }),
+
+  create: permissionRequiredProcedure(Permissions.USER_MANAGE)
+    .input(createDeptAdminSchema)
+    .mutation(async ({ ctx, input }) => {
+      const { uid, deptCode, adminEmail, adminLinePhone, adminMobilePhone, note } = input
+
+      // 检查用户是否存在
+      const user = await ctx.db.user.findUnique({ where: { id: uid } })
+      if (!user) {
+        throw new TRPCError({ code: 'NOT_FOUND', message: '用户不存在' })
+      }
+
+      // 检查院系是否存在
+      const dept = await ctx.db.dept.findUnique({ where: { code: deptCode } })
+      if (!dept) {
+        throw new TRPCError({ code: 'NOT_FOUND', message: '院系不存在' })
+      }
+
+      // 检查是否已存在相同的用户-院系组合
+      const existing = await ctx.db.deptAdmin.findUnique({
+        where: {
+          uidx_uid_dept_code: {
+            uid,
+            deptCode,
+          },
+        },
+      })
+      if (existing) {
+        throw new TRPCError({ code: 'BAD_REQUEST', message: '该用户已是该院系的管理员' })
+      }
+
+      return ctx.db.deptAdmin.create({
+        data: {
+          uid,
+          deptCode,
+          adminEmail: adminEmail?.trim() || null,
+          adminLinePhone: adminLinePhone?.trim() || null,
+          adminMobilePhone: adminMobilePhone?.trim() || null,
+          note: note?.trim() || null,
+        },
+        include: {
+          user: { select: { id: true, name: true } },
+          dept: { select: { code: true, name: true, fullName: true } },
+        },
+      })
+    }),
+
+  update: permissionRequiredProcedure(Permissions.USER_MANAGE)
+    .input(updateDeptAdminSchema)
+    .mutation(async ({ ctx, input }) => {
+      const { id, uid, deptCode, adminEmail, adminLinePhone, adminMobilePhone, note } = input
+
+      // 检查院系管理员是否存在
+      const existing = await ctx.db.deptAdmin.findUnique({ where: { id } })
+      if (!existing) {
+        throw new TRPCError({ code: 'NOT_FOUND', message: '院系管理员不存在' })
+      }
+
+      // 检查用户是否存在
+      const user = await ctx.db.user.findUnique({ where: { id: uid } })
+      if (!user) {
+        throw new TRPCError({ code: 'NOT_FOUND', message: '用户不存在' })
+      }
+
+      // 检查院系是否存在
+      const dept = await ctx.db.dept.findUnique({ where: { code: deptCode } })
+      if (!dept) {
+        throw new TRPCError({ code: 'NOT_FOUND', message: '院系不存在' })
+      }
+
+      // 如果修改了 uid 或 deptCode，检查新的组合是否已存在
+      if (uid !== existing.uid || deptCode !== existing.deptCode) {
+        const duplicate = await ctx.db.deptAdmin.findUnique({
+          where: {
+            uidx_uid_dept_code: {
+              uid,
+              deptCode,
+            },
+          },
+        })
+        if (duplicate) {
+          throw new TRPCError({ code: 'BAD_REQUEST', message: '该用户已是该院系的管理员' })
+        }
+      }
+
+      return ctx.db.deptAdmin.update({
+        where: { id },
+        data: {
+          uid,
+          deptCode,
+          adminEmail: adminEmail?.trim() || null,
+          adminLinePhone: adminLinePhone?.trim() || null,
+          adminMobilePhone: adminMobilePhone?.trim() || null,
+          note: note?.trim() || null,
+        },
+        include: {
+          user: { select: { id: true, name: true } },
+          dept: { select: { code: true, name: true, fullName: true } },
+        },
+      })
+    }),
+
+  getById: permissionRequiredProcedure(Permissions.USER_MANAGE)
+    .input(z.object({ id: z.number() }))
+    .query(async ({ ctx, input }) => {
+      const deptAdmin = await ctx.db.deptAdmin.findUnique({
+        where: { id: input.id },
+        include: {
+          user: { select: { id: true, name: true } },
+          dept: { select: { code: true, name: true, fullName: true } },
+        },
+      })
+
+      if (!deptAdmin) {
+        throw new TRPCError({ code: 'NOT_FOUND', message: '院系管理员不存在' })
+      }
+
+      return deptAdmin
+    }),
+
+  delete: permissionRequiredProcedure(Permissions.USER_MANAGE)
+    .input(z.object({ id: z.number() }))
+    .mutation(async ({ ctx, input }) => {
+      const { id } = input
+
+      // 检查院系管理员是否存在
+      const existing = await ctx.db.deptAdmin.findUnique({ where: { id } })
+      if (!existing) {
+        throw new TRPCError({ code: 'NOT_FOUND', message: '院系管理员不存在' })
+      }
+
+      return ctx.db.deptAdmin.delete({
+        where: { id },
+        include: {
+          user: { select: { id: true, name: true } },
+          dept: { select: { code: true, name: true, fullName: true } },
+        },
+      })
+    }),
+})
+
+export type DeptAdminRouter = typeof deptAdminRouter
+export type DeptAdmin = inferProcedureOutput<DeptAdminRouter['list']>['data'][number]
--- a/src/server/routers/users.ts
+++ b/src/server/routers/users.ts
@@ -6,6 +6,10 @@ import { transformDataTableQueryParams } from '@/server/utils/data-table-helper'
 import bcrypt from 'bcryptjs'
 import { z } from 'zod'
 import { inferProcedureOutput, TRPCError } from '@trpc/server'
+import pLimit from 'p-limit'
+
+// 从环境变量获取并发限制，默认为16
+const dbParallelLimit = pLimit(parseInt(process.env.DB_PARALLEL_LIMIT || '16', 10))

 export const usersRouter = createTRPCRouter({
  list: permissionRequiredProcedure(Permissions.USER_MANAGE)
@@ -186,14 +190,16 @@ export const usersRouter = createTRPCRouter({
        
        await Promise.all(
          batch.map(user =>
-            ctx.db.user.update({
-              where: { id: user.id },
-              data: {
-                roles: action === 'grant'
-                  ? { connect: { id: roleId } }
-                  : { disconnect: { id: roleId } }
-              }
-            })
+            dbParallelLimit(() =>
+              ctx.db.user.update({
+                where: { id: user.id },
+                data: {
+                  roles: action === 'grant'
+                    ? { connect: { id: roleId } }
+                    : { disconnect: { id: roleId } }
+                }
+              })
+            )
          )
        )
        
@@ -206,6 +212,11 @@ export const usersRouter = createTRPCRouter({
  create: permissionRequiredProcedure(Permissions.USER_MANAGE).input(createUserSchema).mutation(async ({ ctx, input }) => {
    const { id, name, status, deptCode, password, roleIds, isSuperAdmin } = input

+    // 检查是否尝试创建超级管理员，只有超级管理员才能创建超级管理员
+    if (isSuperAdmin && !ctx.session?.user?.isSuperAdmin) {
+      throw new TRPCError({ code: 'FORBIDDEN', message: '只有超级管理员才能创建超级管理员用户' })
+    }
+
    const existingUser = await ctx.db.user.findUnique({ where: { id } })
    if (existingUser) throw new TRPCError({ code: 'BAD_REQUEST', message: '用户ID已存在' })

@@ -235,6 +246,11 @@ export const usersRouter = createTRPCRouter({
    const existingUser = await ctx.db.user.findUnique({ where: { id } })
    if (!existingUser) throw new TRPCError({ code: 'NOT_FOUND', message: '用户不存在' })

+    // 检查是否尝试修改 isSuperAdmin 字段，只有超级管理员才能操作
+    if (isSuperAdmin !== existingUser.isSuperAdmin && !ctx.session?.user?.isSuperAdmin) {
+      throw new TRPCError({ code: 'FORBIDDEN', message: '只有超级管理员才能修改超级管理员权限' })
+    }
+
    // 准备更新数据
    const updateData: any = {
      name: name?.trim() || '',
@@ -372,6 +388,102 @@ export const usersRouter = createTRPCRouter({
          ))
        ).sort((a, b) => a.id - b.id),
      }
+    }),
+
+  // 获取当前用户可管理的院系列表和正在管理的院系
+  getManagedDepts: permissionRequiredProcedure('')
+    .query(async ({ ctx }) => {
+      const userId = ctx.session!.user.id
+      
+      // 获取用户当前信息
+      const currentUser = await ctx.db.user.findUnique({
+        where: { id: userId },
+        select: { currentManagedDept: true }
+      })
+
+      let depts: Array<{ code: string; name: string; fullName: string }>
+      
+      // 超级管理员可以管理所有院系
+      if (ctx.session?.user?.isSuperAdmin) {
+        depts = await ctx.db.dept.findMany({
+          orderBy: { code: 'asc' }
+        })
+      } else {
+        // 普通用户只能管理自己被授权的院系
+        const deptAdmins = await ctx.db.deptAdmin.findMany({
+          where: { uid: userId },
+          include: { dept: true },
+          orderBy: { deptCode: 'asc' }
+        })
+        depts = deptAdmins.map(da => da.dept)
+      }
+
+      // 如果用户当前没有管理院系，但有可管理的院系，自动设置为第一个
+      let currentDept = currentUser?.currentManagedDept
+      if (!currentDept && depts.length > 0) {
+        currentDept = depts[0].code
+        await ctx.db.user.update({
+          where: { id: userId },
+          data: { currentManagedDept: currentDept }
+        })
+      }
+
+      return {
+        currentDept,
+        depts
+      }
+    }),
+
+  // 切换当前管理的院系
+  switchManagedDept: permissionRequiredProcedure('')
+    .input(z.object({
+      deptCode: z.string().nullable()
+    }))
+    .mutation(async ({ ctx, input }) => {
+      const { deptCode } = input
+
+      // 如果要切换到某个院系，需要验证权限
+      if (deptCode) {
+        // 超级管理员可以切换到任意院系
+        if (!ctx.session?.user?.isSuperAdmin) {
+          // 普通用户需要验证是否有该院系的管理权限
+          const deptAdmin = await ctx.db.deptAdmin.findUnique({
+            where: {
+              uidx_uid_dept_code: {
+                uid: ctx.session!.user.id,
+                deptCode: deptCode
+              }
+            }
+          })
+
+          if (!deptAdmin) {
+            throw new TRPCError({
+              code: 'FORBIDDEN',
+              message: '您没有该院系的管理权限'
+            })
+          }
+        }
+
+        // 验证院系是否存在
+        const dept = await ctx.db.dept.findUnique({
+          where: { code: deptCode }
+        })
+
+        if (!dept) {
+          throw new TRPCError({
+            code: 'NOT_FOUND',
+            message: '院系不存在'
+          })
+        }
+      }
+
+      // 更新用户的当前管理院系
+      await ctx.db.user.update({
+        where: { id: ctx.session!.user.id },
+        data: { currentManagedDept: deptCode }
+      })
+
+      return { success: true, deptCode }
    })
 })
Author	SHA1	Message	Date
liuyh	91d39b3145	fix: 手机端关闭侧边栏后刷新页面的延迟300ms=>350ms，instrumentation.ts好像得写在src内部以适配生产环境，新增simple_deploy.sh便于部署	2025-11-18 20:32:28 +08:00
liuyh	2a80a44972	feat: 增加DEFAULT_USER_PASSWORD，作为创建用户时的默认密码，添加p-limit库，添加DB_PARALLEL_LIMIT = 32环境变量作为“数据库批次操作默认并发数” 限制只有超级管理员才能创建超级管理员用户删除用户时可以级联删除SelectionLog 添加zustand全局状态管理一对多的院系管理功能，支持增删改查院系管理员信息、用户可以在header中切换管理的院系	2025-11-18 20:10:48 +08:00
liuyh	7f3190a223	fix: docker-compose.yml添加全局的name属性吗，让docker-compose控制容器、卷和网络的命名	2025-11-16 15:51:15 +08:00