First commit

This commit is contained in:
2026-09-21 12:51:00 +08:00
commit 4fad31e438
145 changed files with 17216 additions and 0 deletions

4
frontend/.dockerignore Normal file
View File

@@ -0,0 +1,4 @@
node_modules/
dist/
.vite/
Dockerfile

29
frontend/Dockerfile Normal file
View File

@@ -0,0 +1,29 @@
# =====================================================================
# 前端镜像:pnpm 构建静态资源 -> Nginx 托管(同时反代 /api 到后端)
# 构建:docker build -t lab-frontend ./frontend
# =====================================================================
# ---------- 构建阶段 ----------
FROM node:24-alpine AS build
WORKDIR /app
# 使用与本地一致的 pnpm 主版本,锁定依赖保证可复现
RUN npm install -g pnpm@11.3.0
# 先装依赖,充分利用层缓存
COPY package.json pnpm-lock.yaml pnpm-workspace.yaml ./
RUN pnpm install --frozen-lockfile
COPY . .
RUN pnpm build
# ---------- 运行阶段 ----------
FROM nginx:1.27-alpine
COPY nginx.conf /etc/nginx/conf.d/default.conf
COPY --from=build /app/dist /usr/share/nginx/html
EXPOSE 80
HEALTHCHECK --interval=15s --timeout=3s --start-period=10s --retries=3 \
CMD wget -q -O /dev/null http://127.0.0.1/ || exit 1

12
frontend/index.html Normal file
View File

@@ -0,0 +1,12 @@
<!DOCTYPE html>
<html lang="zh-CN">
<head>
<meta charset="UTF-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<title>实验室预约与资源管理平台</title>
</head>
<body>
<div id="app"></div>
<script type="module" src="/src/main.ts"></script>
</body>
</html>

35
frontend/nginx.conf Normal file
View File

@@ -0,0 +1,35 @@
# Nginx 站点配置:SPA 路由回退 + /api 反向代理到后端容器
server {
listen 80;
server_name _;
root /usr/share/nginx/html;
index index.html;
# 静态资源压缩
gzip on;
gzip_min_length 1k;
gzip_types text/plain text/css application/javascript application/json image/svg+xml;
# 前端单页应用:刷新子路由时回退到 index.html
location / {
try_files $uri $uri/ /index.html;
}
# 后端接口:转发到 docker-compose 中的 backend 服务
location /api/ {
proxy_pass http://backend:8080;
proxy_http_version 1.1;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
proxy_read_timeout 60s;
}
# 带哈希的静态资源长期缓存
location /assets/ {
expires 7d;
add_header Cache-Control "public, max-age=604800";
}
}

29
frontend/package.json Normal file
View File

@@ -0,0 +1,29 @@
{
"name": "lab-frontend",
"version": "1.0.0",
"private": true,
"type": "module",
"description": "实验室预约与资源管理平台前端",
"scripts": {
"dev": "vite",
"build": "vue-tsc --noEmit && vite build",
"preview": "vite preview",
"typecheck": "vue-tsc --noEmit"
},
"dependencies": {
"@element-plus/icons-vue": "^2.3.1",
"axios": "^1.7.9",
"dayjs": "^1.11.13",
"element-plus": "^2.9.1",
"pinia": "^2.3.0",
"vue": "^3.5.13",
"vue-router": "^4.5.0"
},
"devDependencies": {
"@types/node": "^22.10.2",
"@vitejs/plugin-vue": "^5.2.1",
"typescript": "^5.7.2",
"vite": "^6.0.5",
"vue-tsc": "^2.2.0"
}
}

1432
frontend/pnpm-lock.yaml generated Normal file

File diff suppressed because it is too large Load Diff

View File

@@ -0,0 +1,7 @@
packages:
- '.'
# pnpm 11 起,依赖构建脚本白名单统一配置在 workspace 文件中
allowBuilds:
esbuild: true
vue-demi: true

9
frontend/src/App.vue Normal file
View File

@@ -0,0 +1,9 @@
<template>
<router-view />
</template>
<script setup lang="ts">
/**
* 根组件:仅承载路由出口。
*/
</script>

351
frontend/src/api/index.ts Normal file
View File

@@ -0,0 +1,351 @@
import { del, get, patch, post, put } from '@/api/request'
import type {
ApiResponse,
ConflictCheckVO,
Course,
Device,
Lab,
LoginResponse,
PageResult,
ReservationQuery,
ReservationVO,
UserVO
} from '@/types'
/** 认证接口 */
export const authApi = {
/**
* 登录。
*
* @param username 用户名
* @param password 密码
* @returns 登录响应
*/
login: (username: string, password: string) =>
post<LoginResponse>('/auth/login', { username, password }),
/**
* 查询当前用户。
*
* @returns 用户信息
*/
me: () => get<UserVO>('/auth/me'),
/**
* 登出(无状态令牌,前端自行清理)。
*/
logout: () => post<void>('/auth/logout')
}
/** 实验室接口 */
export const labApi = {
/**
* 分页查询实验室。
*
* @param params 查询参数
* @returns 分页结果
*/
page: (params: Record<string, unknown>) =>
get<PageResult<Lab>>('/labs', params),
/**
* 查询全部实验室。
*
* @returns 实验室列表
*/
all: () => get<Lab[]>('/labs/all'),
/**
* 查询单项时间段内可用实验室。
*
* @param start 开始时间
* @param end 结束时间
* @param capacity 最少容量
* @returns 可用实验室列表
*/
available: (start: string, end: string, capacity?: number) =>
get<Lab[]>('/labs/available', { start, end, capacity }),
/**
* 新增实验室。
*
* @param body 请求体
* @returns 新建实验室
*/
create: (body: Partial<Lab>) => post<Lab>('/labs', body),
/**
* 修改实验室。
*
* @param id 实验室 ID
* @param body 请求体
* @returns 更新后的实验室
*/
update: (id: number, body: Partial<Lab>) => put<Lab>(`/labs/${id}`, body),
/**
* 删除实验室。
*
* @param id 实验室 ID
*/
remove: (id: number) => del<void>(`/labs/${id}`),
/**
* 变更实验室状态。
*
* @param id 实验室 ID
* @param status 目标状态
* @returns 更新后的实验室
*/
changeStatus: (id: number, status: string) =>
patch<Lab>(`/labs/${id}/status`, { labStatus: status })
}
/** 设备接口 */
export const deviceApi = {
/**
* 分页查询设备。
*
* @param params 查询参数
* @returns 分页结果
*/
page: (params: Record<string, unknown>) => get<PageResult<Device>>('/devices', params),
/**
* 查询实验室下的设备。
*
* @param labId 实验室 ID
* @returns 设备列表
*/
byLab: (labId: number) => get<Device[]>(`/devices/by-lab/${labId}`),
/**
* 新增设备。
*
* @param body 请求体
* @returns 新建设备
*/
create: (body: Partial<Device>) => post<Device>('/devices', body),
/**
* 修改设备。
*
* @param id 设备 ID
* @param body 请求体
* @returns 更新后的设备
*/
update: (id: number, body: Partial<Device>) => put<Device>(`/devices/${id}`, body),
/**
* 删除设备。
*
* @param id 设备 ID
*/
remove: (id: number) => del<void>(`/devices/${id}`),
/**
* 变更设备状态。
*
* @param id 设备 ID
* @param status 目标状态
* @returns 更新后的设备
*/
changeStatus: (id: number, status: string) =>
patch<Device>(`/devices/${id}/status`, { deviceStatus: status })
}
/** 课程接口 */
export const courseApi = {
/**
* 分页查询课程。
*
* @param params 查询参数
* @returns 分页结果
*/
page: (params: Record<string, unknown>) => get<PageResult<Course>>('/courses', params),
/**
* 查询全部课程。
*
* @returns 课程列表
*/
all: () => get<Course[]>('/courses/all'),
/**
* 新增课程。
*
* @param body 请求体
* @returns 新建课程
*/
create: (body: Partial<Course>) => post<Course>('/courses', body),
/**
* 修改课程。
*
* @param id 课程 ID
* @param body 请求体
* @returns 更新后的课程
*/
update: (id: number, body: Partial<Course>) => put<Course>(`/courses/${id}`, body),
/**
* 结束课程。
*
* @param id 课程 ID
* @returns 更新后的课程
*/
finish: (id: number) => patch<Course>(`/courses/${id}/finish`),
/**
* 删除课程。
*
* @param id 课程 ID
*/
remove: (id: number) => del<void>(`/courses/${id}`)
}
/** 预约接口 */
export const reservationApi = {
/**
* 创建单次预约。
*
* @param body 请求体
* @returns 新建预约
*/
create: (body: Record<string, unknown>) => post<ReservationVO>('/reservations', body),
/**
* 创建多次预约。
*
* @param body 请求体
* @returns 生成的预约列表
*/
createRecurring: (body: Record<string, unknown>) =>
post<ReservationVO[]>('/reservations/recurring', body),
/**
* 创建课程绑定预约。
*
* @param body 请求体
* @returns 生成的预约列表
*/
createForCourse: (body: Record<string, unknown>) =>
post<ReservationVO[]>('/reservations/course', body),
/**
* 冲突预检。
*
* @param body 请求体
* @returns 预检结果
*/
check: (body: Record<string, unknown>) =>
post<ConflictCheckVO>('/reservations/check', body),
/**
* 分页查询预约。
*
* @param params 查询条件
* @returns 分页结果
*/
page: (params: ReservationQuery) =>
get<PageResult<ReservationVO>>('/reservations', params as Record<string, unknown>),
/**
* 查询预约详情。
*
* @param id 预约 ID
* @returns 预约详情
*/
detail: (id: number) => get<ReservationVO>(`/reservations/${id}`),
/**
* 查询实验室日历。
*
* @param labId 实验室 ID
* @param from 开始日期
* @param to 结束日期
* @returns 预约列表
*/
calendar: (labId: number, from: string, to: string) =>
get<ReservationVO[]>('/reservations/calendar', { labId, from, to }),
/**
* 审批通过。
*
* @param id 预约 ID
* @returns 更新后的预约
*/
approve: (id: number) => post<ReservationVO>(`/reservations/${id}/approve`),
/**
* 驳回预约。
*
* @param id 预约 ID
* @param reason 驳回原因
* @returns 更新后的预约
*/
reject: (id: number, reason: string) =>
post<ReservationVO>(`/reservations/${id}/reject`, { reason }),
/**
* 取消预约。
*
* @param id 预约 ID
* @param series 是否取消整个系列
* @returns 受影响的预约列表
*/
cancel: (id: number, series: boolean) =>
post<ReservationVO[]>(`/reservations/${id}/cancel?series=${series}`),
/**
* 开始使用。
*
* @param id 预约 ID
* @returns 更新后的预约
*/
start: (id: number) => post<ReservationVO>(`/reservations/${id}/start`),
/**
* 完成使用。
*
* @param id 预约 ID
* @returns 更新后的预约
*/
complete: (id: number) => post<ReservationVO>(`/reservations/${id}/complete`)
}
/** 用户管理接口 */
export const userApi = {
/**
* 查询全部用户。
*
* @returns 用户列表
*/
list: () => get<UserVO[]>('/users'),
/**
* 新增用户。
*
* @param body 请求体
* @returns 新建用户
*/
create: (body: Record<string, unknown>) => post<UserVO>('/users', body),
/**
* 修改用户。
*
* @param id 用户 ID
* @param body 请求体
* @returns 更新后的用户
*/
update: (id: number, body: Record<string, unknown>) => put<UserVO>(`/users/${id}`, body),
/**
* 删除用户。
*
* @param id 用户 ID
*/
remove: (id: number) => del<void>(`/users/${id}`)
}
export type { ApiResponse }

136
frontend/src/api/request.ts Normal file
View File

@@ -0,0 +1,136 @@
import axios, { type AxiosInstance, type AxiosRequestConfig } from 'axios'
import { ElMessage } from 'element-plus'
/** 令牌在 localStorage 中的键名 */
const TOKEN_KEY = 'lab-token'
/**
* 读取本地令牌。
*
* @returns JWT 字符串或空串
*/
export function getToken(): string {
return localStorage.getItem(TOKEN_KEY) ?? ''
}
/**
* 写入本地令牌。
*
* @param token JWT 字符串
*/
export function setToken(token: string): void {
localStorage.setItem(TOKEN_KEY, token)
}
/** 清除本地令牌 */
export function clearToken(): void {
localStorage.removeItem(TOKEN_KEY)
}
/** axios 实例,统一以 /api 为前缀(开发环境由 Vite 代理) */
const request: AxiosInstance = axios.create({
baseURL: '/api',
timeout: 15000
})
/**
* 请求拦截器:附加 Bearer 令牌。
*/
request.interceptors.request.use((config) => {
const token = getToken()
if (token) {
config.headers.Authorization = `Bearer ${token}`
}
return config
})
/**
* 响应拦截器:统一解包业务码,401 时跳转登录页。
*/
request.interceptors.response.use(
(response) => {
const body = response.data
if (body && typeof body.code === 'number' && body.code !== 0) {
ElMessage.error(body.message || '请求失败')
return Promise.reject(new Error(body.message))
}
return response
},
(error) => {
const status = error?.response?.status
if (status === 401) {
clearToken()
ElMessage.error('登录已失效,请重新登录')
if (window.location.pathname !== '/login') {
window.location.href = '/login'
}
} else if (status === 403) {
ElMessage.error('无权限执行该操作')
} else {
ElMessage.error(error?.response?.data?.message || error.message || '网络异常')
}
return Promise.reject(error)
}
)
/**
* 发起 GET 请求。
*
* @param url 接口路径
* @param params 查询参数
* @returns 业务数据
*/
export async function get<T>(url: string, params?: Record<string, unknown>): Promise<T> {
const { data } = await request.get(url, { params })
return data.data as T
}
/**
* 发起 POST 请求。
*
* @param url 接口路径
* @param body 请求体
* @param config 额外配置
* @returns 业务数据
*/
export async function post<T>(url: string, body?: unknown, config?: AxiosRequestConfig): Promise<T> {
const { data } = await request.post(url, body, config)
return data.data as T
}
/**
* 发起 PUT 请求。
*
* @param url 接口路径
* @param body 请求体
* @returns 业务数据
*/
export async function put<T>(url: string, body?: unknown): Promise<T> {
const { data } = await request.put(url, body)
return data.data as T
}
/**
* 发起 PATCH 请求。
*
* @param url 接口路径
* @param body 请求体
* @returns 业务数据
*/
export async function patch<T>(url: string, body?: unknown): Promise<T> {
const { data } = await request.patch(url, body)
return data.data as T
}
/**
* 发起 DELETE 请求。
*
* @param url 接口路径
* @returns 业务数据
*/
export async function del<T>(url: string): Promise<T> {
const { data } = await request.delete(url)
return data.data as T
}
export default request

7
frontend/src/env.d.ts vendored Normal file
View File

@@ -0,0 +1,7 @@
/// <reference types="vite/client" />
declare module '*.vue' {
import type { DefineComponent } from 'vue'
const component: DefineComponent<Record<string, never>, Record<string, never>, unknown>
export default component
}

View File

@@ -0,0 +1,150 @@
<template>
<el-container class="layout">
<el-aside width="220px" class="aside">
<div class="logo">实验室预约平台</div>
<el-menu :default-active="activeMenu" router class="menu">
<el-menu-item v-for="item in menus" :key="item.path" :index="item.path">
<el-icon><component :is="item.icon" /></el-icon>
<span>{{ item.title }}</span>
</el-menu-item>
</el-menu>
</el-aside>
<el-container>
<el-header class="header">
<div class="header-title">{{ currentTitle }}</div>
<el-dropdown @command="onCommand">
<span class="user-info">
<el-icon><UserFilled /></el-icon>
{{ auth.user?.realName || auth.user?.username }}
<el-tag size="small" type="info" class="role-tag">{{ auth.user?.roleLabel }}</el-tag>
</span>
<template #dropdown>
<el-dropdown-menu>
<el-dropdown-item command="logout">退出登录</el-dropdown-item>
</el-dropdown-menu>
</template>
</el-dropdown>
</el-header>
<el-main class="main">
<router-view />
</el-main>
</el-container>
</el-container>
</template>
<script setup lang="ts">
import { computed } from 'vue'
import { useRoute, useRouter } from 'vue-router'
import { ElMessageBox } from 'element-plus'
import { useAuthStore } from '@/stores/auth'
import type { Role } from '@/types'
interface MenuItem {
path: string
title: string
icon: string
roles?: Role[]
}
const route = useRoute()
const router = useRouter()
const auth = useAuthStore()
/** 全部菜单项(含角色限制) */
const allMenus: MenuItem[] = [
{ path: '/dashboard', title: '工作台', icon: 'HomeFilled' },
{ path: '/reservations/new', title: '发起预约', icon: 'Plus' },
{ path: '/reservations/mine', title: '我的预约', icon: 'Tickets' },
{ path: '/calendar', title: '预约日历', icon: 'Calendar' },
{ path: '/approvals', title: '预约审批', icon: 'Checked', roles: ['ADMIN', 'TEACHER'] },
{ path: '/labs', title: '实验室管理', icon: 'OfficeBuilding' },
{ path: '/devices', title: '设备管理', icon: 'Monitor' },
{ path: '/courses', title: '实验课程', icon: 'Notebook' },
{ path: '/users', title: '用户管理', icon: 'User', roles: ['ADMIN'] }
]
/** 按当前角色过滤后的菜单 */
const menus = computed(() =>
allMenus.filter((item) => !item.roles || auth.hasRole(...item.roles))
)
/** 当前激活菜单 */
const activeMenu = computed(() => route.path)
/** 当前页面标题 */
const currentTitle = computed(() => (route.meta.title as string) ?? '')
/**
* 处理用户下拉菜单命令。
*
* @param command 命令名
*/
async function onCommand(command: string): Promise<void> {
if (command !== 'logout') {
return
}
await ElMessageBox.confirm('确认退出登录吗?', '提示', { type: 'warning' })
await auth.logout()
router.push('/login')
}
</script>
<style scoped>
.layout {
height: 100%;
}
.aside {
background-color: #1f2d3d;
color: #fff;
}
.logo {
height: 60px;
line-height: 60px;
text-align: center;
font-size: 16px;
font-weight: 600;
color: #fff;
border-bottom: 1px solid rgba(255, 255, 255, 0.08);
}
.menu {
border-right: none;
background-color: transparent;
--el-menu-text-color: #cfd8e3;
--el-menu-hover-bg-color: rgba(255, 255, 255, 0.08);
--el-menu-active-color: #409eff;
}
.header {
display: flex;
align-items: center;
justify-content: space-between;
background-color: #fff;
border-bottom: 1px solid #ebeef5;
}
.header-title {
font-size: 16px;
font-weight: 600;
}
.user-info {
display: inline-flex;
align-items: center;
gap: 6px;
cursor: pointer;
color: #303133;
}
.role-tag {
margin-left: 4px;
}
.main {
padding: 16px;
}
</style>

21
frontend/src/main.ts Normal file
View File

@@ -0,0 +1,21 @@
import { createApp } from 'vue'
import { createPinia } from 'pinia'
import ElementPlus from 'element-plus'
import zhCn from 'element-plus/es/locale/lang/zh-cn'
import * as ElementPlusIconsVue from '@element-plus/icons-vue'
import 'element-plus/dist/index.css'
import App from './App.vue'
import router from './router'
import './styles/index.css'
const app = createApp(App)
// 注册全部 Element Plus 图标,模板中可直接使用 <el-icon><Calendar /></el-icon>
for (const [name, component] of Object.entries(ElementPlusIconsVue)) {
app.component(name, component)
}
app.use(createPinia())
app.use(router)
app.use(ElementPlus, { locale: zhCn })
app.mount('#app')

View File

@@ -0,0 +1,122 @@
import { createRouter, createWebHistory, type RouteRecordRaw } from 'vue-router'
import { ElMessage } from 'element-plus'
import { useAuthStore } from '@/stores/auth'
import type { Role } from '@/types'
/**
* 路由表:meta.roles 为空表示登录即可访问。
*/
const routes: RouteRecordRaw[] = [
{
path: '/login',
name: 'login',
component: () => import('@/views/LoginView.vue'),
meta: { public: true, title: '登录' }
},
{
path: '/',
component: () => import('@/layouts/MainLayout.vue'),
redirect: '/dashboard',
children: [
{
path: 'dashboard',
name: 'dashboard',
component: () => import('@/views/DashboardView.vue'),
meta: { title: '工作台' }
},
{
path: 'labs',
name: 'labs',
component: () => import('@/views/LabView.vue'),
meta: { title: '实验室管理' }
},
{
path: 'devices',
name: 'devices',
component: () => import('@/views/DeviceView.vue'),
meta: { title: '设备管理' }
},
{
path: 'courses',
name: 'courses',
component: () => import('@/views/CourseView.vue'),
meta: { title: '实验课程' }
},
{
path: 'reservations/new',
name: 'reservation-create',
component: () => import('@/views/ReservationCreateView.vue'),
meta: { title: '发起预约' }
},
{
path: 'reservations/mine',
name: 'reservation-mine',
component: () => import('@/views/MyReservationsView.vue'),
meta: { title: '我的预约' }
},
{
path: 'approvals',
name: 'approvals',
component: () => import('@/views/ApprovalView.vue'),
meta: { title: '预约审批', roles: ['ADMIN', 'TEACHER'] as Role[] }
},
{
path: 'calendar',
name: 'calendar',
component: () => import('@/views/CalendarView.vue'),
meta: { title: '预约日历' }
},
{
path: 'users',
name: 'users',
component: () => import('@/views/UserView.vue'),
meta: { title: '用户管理', roles: ['ADMIN'] as Role[] }
}
]
},
{
path: '/:pathMatch(.*)*',
redirect: '/dashboard'
}
]
const router = createRouter({
history: createWebHistory(),
routes
})
/**
* 全局前置守卫:登录校验 + 角色校验。
*/
router.beforeEach(async (to) => {
const auth = useAuthStore()
if (to.meta.public) {
return true
}
if (!auth.loggedIn) {
return { path: '/login', query: { redirect: to.fullPath } }
}
if (!auth.user) {
try {
await auth.fetchMe()
} catch {
return { path: '/login' }
}
}
const roles = to.meta.roles as Role[] | undefined
if (roles && roles.length > 0 && !auth.hasRole(...roles)) {
ElMessage.error('无权限访问该页面')
return { path: '/dashboard' }
}
return true
})
/**
* 全局后置守卫:更新页面标题。
*/
router.afterEach((to) => {
const title = to.meta.title as string | undefined
document.title = title ? `${title} - 实验室预约平台` : '实验室预约平台'
})
export default router

View File

@@ -0,0 +1,68 @@
import { defineStore } from 'pinia'
import { computed, ref } from 'vue'
import { authApi } from '@/api'
import { clearToken, getToken, setToken } from '@/api/request'
import type { Role, UserVO } from '@/types'
/**
* 认证状态仓库:令牌与当前用户信息。
*/
export const useAuthStore = defineStore('auth', () => {
const token = ref<string>(getToken())
const user = ref<UserVO | null>(null)
/** 是否已登录 */
const loggedIn = computed(() => Boolean(token.value))
/** 当前角色 */
const role = computed<Role | ''>(() => user.value?.role ?? '')
/**
* 登录并保存令牌。
*
* @param username 用户名
* @param password 密码
*/
async function login(username: string, password: string): Promise<void> {
const result = await authApi.login(username, password)
token.value = result.token
user.value = result.user
setToken(result.token)
}
/**
* 拉取当前用户信息(刷新页面后恢复状态)。
*/
async function fetchMe(): Promise<void> {
if (!token.value) {
return
}
user.value = await authApi.me()
}
/**
* 判断当前用户是否属于给定角色集合。
*
* @param roles 允许的角色
* @returns 是否命中
*/
function hasRole(...roles: Role[]): boolean {
return user.value != null && roles.includes(user.value.role)
}
/**
* 退出登录并清理本地状态。
*/
async function logout(): Promise<void> {
try {
await authApi.logout()
} catch {
// 忽略登出接口异常,本地清理优先
}
token.value = ''
user.value = null
clearToken()
}
return { token, user, loggedIn, role, login, fetchMe, hasRole, logout }
})

View File

@@ -0,0 +1,27 @@
html,
body,
#app {
height: 100%;
margin: 0;
}
body {
font-family: 'Helvetica Neue', Arial, 'PingFang SC', 'Microsoft YaHei', sans-serif;
background-color: #f5f7fa;
}
.page-card {
margin-bottom: 16px;
}
.toolbar {
display: flex;
flex-wrap: wrap;
gap: 12px;
align-items: center;
margin-bottom: 16px;
}
.toolbar .spacer {
flex: 1;
}

153
frontend/src/types/index.ts Normal file
View File

@@ -0,0 +1,153 @@
/** 后端统一响应包装 */
export interface ApiResponse<T> {
code: number
message: string
data: T
}
/** 分页结果 */
export interface PageResult<T> {
records: T[]
total: number
page: number
size: number
}
/** 用户角色 */
export type Role = 'ADMIN' | 'TEACHER' | 'STUDENT'
/** 用户信息 */
export interface UserVO {
id: number
username: string
realName: string
role: Role
roleLabel: string
email?: string
phone?: string
enabled: boolean
}
/** 实验室状态 */
export type LabStatus = 'IDLE' | 'RESERVED' | 'IN_USE' | 'MAINTENANCE'
/** 设备状态 */
export type DeviceStatus = 'IDLE' | 'RESERVED' | 'IN_USE' | 'MAINTENANCE'
/** 实验室 */
export interface Lab {
id: number
code: string
name: string
location: string
capacity: number
description?: string
status: LabStatus
openTime: string
closeTime: string
}
/** 设备 */
export interface Device {
id: number
labId: number
code: string
name: string
model?: string
description?: string
status: DeviceStatus
}
/** 课程状态 */
export type CourseStatus = 'ACTIVE' | 'FINISHED'
/** 实验课程 */
export interface Course {
id: number
code: string
name: string
teacherId: number
labId: number
studentCount: number
startDate: string
endDate: string
weekdays: string
startTime: string
endTime: string
status: CourseStatus
}
/** 预约类型 */
export type ReservationType = 'SINGLE' | 'RECURRING' | 'COURSE'
/** 预约状态 */
export type ReservationStatus =
| 'PENDING'
| 'APPROVED'
| 'REJECTED'
| 'CANCELLED'
| 'IN_USE'
| 'COMPLETED'
/** 预约视图对象 */
export interface ReservationVO {
id: number
seriesId?: number
userId: number
userName?: string
labId: number
labName?: string
deviceId?: number
deviceName?: string
courseId?: number
courseName?: string
type: ReservationType
typeLabel: string
title: string
purpose?: string
startTime: string
endTime: string
participants: number
status: ReservationStatus
statusLabel: string
rejectReason?: string
approverId?: number
approverName?: string
approvedAt?: string
createdAt?: string
}
/** 冲突明细 */
export interface Conflict {
type: string
message: string
slotIndex?: number
conflictReservationId?: number
}
/** 冲突预检结果 */
export interface ConflictCheckVO {
passed: boolean
conflicts: Conflict[]
}
/** 登录响应 */
export interface LoginResponse {
token: string
expiresIn: number
user: UserVO
}
/** 预约查询条件 */
export interface ReservationQuery {
page?: number
size?: number
status?: ReservationStatus | ''
type?: ReservationType | ''
labId?: number | ''
userId?: number
keyword?: string
from?: string
to?: string
mine?: boolean
}

View File

@@ -0,0 +1,107 @@
import dayjs from 'dayjs'
/** 状态 -> 中文标签 */
export const LAB_STATUS_LABELS: Record<string, string> = {
IDLE: '空闲',
RESERVED: '已预约',
IN_USE: '使用中',
MAINTENANCE: '维护中'
}
/** 预约状态 -> 标签颜色 */
export const RESERVATION_STATUS_TYPES: Record<string, string> = {
PENDING: 'warning',
APPROVED: 'primary',
REJECTED: 'danger',
CANCELLED: 'info',
IN_USE: 'success',
COMPLETED: ''
}
/** 资源状态 -> 标签颜色 */
export const RESOURCE_STATUS_TYPES: Record<string, string> = {
IDLE: 'success',
RESERVED: 'warning',
IN_USE: 'primary',
MAINTENANCE: 'danger'
}
/** 星期数字 -> 中文 */
const WEEKDAY_LABELS: Record<string, string> = {
MON: '周一',
TUE: '周二',
WED: '周三',
THU: '周四',
FRI: '周五',
SAT: '周六',
SUN: '周日'
}
/**
* 格式化日期时间。
*
* @param value ISO 时间字符串
* @returns yyyy-MM-dd HH:mm
*/
export function formatDateTime(value?: string): string {
return value ? dayjs(value).format('YYYY-MM-DD HH:mm') : '-'
}
/**
* 格式化时间(HH:mm),兼容 "HH:mm:ss" 与 "HH:mm"。
*
* @param value 时间字符串
* @returns HH:mm
*/
export function formatTime(value?: string): string {
if (!value) {
return '-'
}
const match = value.match(/(\d{2}):(\d{2})/)
return match ? `${match[1]}:${match[2]}` : value
}
/**
* 格式化星期描述,如 "1,3" -> "周一 / 周三"。
*
* @param value 星期字符串
* @returns 可读文本
*/
export function formatWeekdays(value?: string): string {
if (!value) {
return '-'
}
const numeric = ['MON', 'TUE', 'WED', 'THU', 'FRI', 'SAT', 'SUN']
return value
.split(',')
.map((token) => token.trim())
.filter(Boolean)
.map((token) => {
if (/^[1-7]$/.test(token)) {
return WEEKDAY_LABELS[numeric[Number(token) - 1]]
}
return WEEKDAY_LABELS[token.toUpperCase()] ?? token
})
.join(' / ')
}
/**
* 生成日期偏移字符串。
*
* @param days 偏移天数
* @returns yyyy-MM-dd
*/
export function dateOffset(days: number): string {
return dayjs().add(days, 'day').format('YYYY-MM-DD')
}
/**
* 生成日期时间字符串。
*
* @param days 偏移天数
* @param time HH:mm
* @returns yyyy-MM-ddTHH:mm:ss
*/
export function dateTimeOffset(days: number, time: string): string {
return dayjs().add(days, 'day').format('YYYY-MM-DD') + 'T' + time + ':00'
}

View File

@@ -0,0 +1,161 @@
<template>
<el-card>
<div class="toolbar">
<el-radio-group v-model="query.status" @change="load">
<el-radio-button label="">全部</el-radio-button>
<el-radio-button label="PENDING">待审批</el-radio-button>
<el-radio-button label="APPROVED">已通过</el-radio-button>
<el-radio-button label="REJECTED">已驳回</el-radio-button>
</el-radio-group>
<el-select v-model="query.labId" placeholder="全部实验室" clearable style="width: 200px" @change="load">
<el-option v-for="lab in labs" :key="lab.id" :label="lab.name" :value="lab.id" />
</el-select>
<el-input v-model="query.keyword" placeholder="标题关键字" clearable style="width: 180px" @keyup.enter="load" @clear="load" />
<el-button type="primary" @click="load">查询</el-button>
</div>
<el-table :data="rows" v-loading="loading">
<el-table-column prop="title" label="标题" min-width="140" />
<el-table-column prop="userName" label="申请人" width="110" />
<el-table-column prop="labName" label="实验室" min-width="140" />
<el-table-column label="时间" min-width="220">
<template #default="{ row }">
{{ formatDateTime(row.startTime) }} ~ {{ formatDateTime(row.endTime) }}
</template>
</el-table-column>
<el-table-column prop="participants" label="人数" width="70" align="center" />
<el-table-column prop="typeLabel" label="类型" width="110" />
<el-table-column label="状态" width="100" align="center">
<template #default="{ row }">
<el-tag :type="RESERVATION_STATUS_TYPES[row.status] as any">{{ row.statusLabel }}</el-tag>
</template>
</el-table-column>
<el-table-column label="操作" width="180" fixed="right">
<template #default="{ row }">
<template v-if="row.status === 'PENDING'">
<el-button size="small" type="success" @click="approve(row)">通过</el-button>
<el-button size="small" type="danger" @click="openReject(row)">驳回</el-button>
</template>
<span v-else class="muted">已处理</span>
</template>
</el-table-column>
</el-table>
<el-pagination
class="pagination"
layout="total, prev, pager, next, sizes"
:total="total"
v-model:current-page="query.page"
v-model:page-size="query.size"
:page-sizes="[10, 20, 50]"
@current-change="load"
@size-change="load"
/>
<el-dialog v-model="rejectVisible" title="驳回预约" width="420px">
<el-form>
<el-form-item label="驳回原因" required>
<el-input v-model="rejectReason" type="textarea" :rows="3" placeholder="请输入驳回原因" />
</el-form-item>
</el-form>
<template #footer>
<el-button @click="rejectVisible = false">取消</el-button>
<el-button type="danger" @click="confirmReject">确认驳回</el-button>
</template>
</el-dialog>
</el-card>
</template>
<script setup lang="ts">
import { onMounted, reactive, ref } from 'vue'
import { ElMessage, ElMessageBox } from 'element-plus'
import { labApi, reservationApi } from '@/api'
import { RESERVATION_STATUS_TYPES, formatDateTime } from '@/utils/format'
import type { Lab, ReservationVO } from '@/types'
const loading = ref(false)
const rows = ref<ReservationVO[]>([])
const labs = ref<Lab[]>([])
const total = ref(0)
const rejectVisible = ref(false)
const rejectReason = ref('')
const rejectTarget = ref<ReservationVO | null>(null)
const query = reactive({ page: 1, size: 10, status: 'PENDING', labId: '' as number | '', keyword: '' })
/**
* 加载待审批列表。
*/
async function load(): Promise<void> {
loading.value = true
try {
const result = await reservationApi.page({
page: query.page,
size: query.size,
status: (query.status || undefined) as ReservationVO['status'] | undefined,
labId: query.labId || undefined,
keyword: query.keyword || undefined
})
rows.value = result.records
total.value = result.total
} finally {
loading.value = false
}
}
/**
* 审批通过。
*
* @param row 行数据
*/
async function approve(row: ReservationVO): Promise<void> {
await ElMessageBox.confirm(`确认通过「${row.title}」的预约申请吗?`, '审批', { type: 'info' })
await reservationApi.approve(row.id)
ElMessage.success('已通过')
await load()
}
/**
* 打开驳回对话框。
*
* @param row 行数据
*/
function openReject(row: ReservationVO): void {
rejectTarget.value = row
rejectReason.value = ''
rejectVisible.value = true
}
/**
* 提交驳回。
*/
async function confirmReject(): Promise<void> {
if (!rejectTarget.value) {
return
}
if (!rejectReason.value.trim()) {
ElMessage.warning('请填写驳回原因')
return
}
await reservationApi.reject(rejectTarget.value.id, rejectReason.value.trim())
ElMessage.success('已驳回')
rejectVisible.value = false
await load()
}
onMounted(async () => {
labs.value = await labApi.all()
await load()
})
</script>
<style scoped>
.pagination {
margin-top: 16px;
justify-content: flex-end;
}
.muted {
color: #c0c4cc;
font-size: 13px;
}
</style>

View File

@@ -0,0 +1,177 @@
<template>
<el-card>
<div class="toolbar">
<el-select v-model="labId" placeholder="请选择实验室" style="width: 260px" @change="load">
<el-option
v-for="lab in labs"
:key="lab.id"
:label="`${lab.name}(${lab.location})`"
:value="lab.id"
/>
</el-select>
<el-tag v-for="(color, status) in LEGEND" :key="status" :type="color as any">
{{ STATUS_LABELS[status] }}
</el-tag>
<div class="spacer" />
<el-button @click="load">刷新</el-button>
</div>
<el-calendar v-model="currentDate" v-loading="loading">
<template #date-cell="{ data }">
<div class="cell" :class="{ today: data.isSelected }">
<div class="day">{{ data.day.split('-')[2] }}</div>
<div
v-for="item in eventsOf(data.day)"
:key="item.id"
class="event"
:class="item.status.toLowerCase()"
@click.stop="showDetail(item)"
>
{{ formatTime(item.startTime) }} {{ item.title }}
</div>
</div>
</template>
</el-calendar>
<el-dialog v-model="detailVisible" title="预约详情" width="440px">
<el-descriptions v-if="detail" :column="1" border>
<el-descriptions-item label="标题">{{ detail.title }}</el-descriptions-item>
<el-descriptions-item label="申请人">{{ detail.userName }}</el-descriptions-item>
<el-descriptions-item label="实验室">{{ detail.labName }}</el-descriptions-item>
<el-descriptions-item label="时间">
{{ formatDateTime(detail.startTime) }} ~ {{ formatDateTime(detail.endTime) }}
</el-descriptions-item>
<el-descriptions-item label="状态">
<el-tag :type="RESERVATION_STATUS_TYPES[detail.status] as any">{{ detail.statusLabel }}</el-tag>
</el-descriptions-item>
<el-descriptions-item label="用途">{{ detail.purpose || '-' }}</el-descriptions-item>
</el-descriptions>
</el-dialog>
</el-card>
</template>
<script setup lang="ts">
import { computed, onMounted, ref, watch } from 'vue'
import dayjs from 'dayjs'
import { labApi, reservationApi } from '@/api'
import { RESERVATION_STATUS_TYPES, formatDateTime, formatTime } from '@/utils/format'
import type { Lab, ReservationVO } from '@/types'
const STATUS_LABELS: Record<string, string> = {
PENDING: '待审批',
APPROVED: '已通过',
IN_USE: '使用中',
COMPLETED: '已完成'
}
const LEGEND: Record<string, string> = {
PENDING: 'warning',
APPROVED: 'primary',
IN_USE: 'success',
COMPLETED: 'info'
}
const labs = ref<Lab[]>([])
const labId = ref<number | undefined>(undefined)
const currentDate = ref(new Date())
const loading = ref(false)
const events = ref<ReservationVO[]>([])
const detailVisible = ref(false)
const detail = ref<ReservationVO | null>(null)
/** 当前展示月份,格式 yyyy-MM */
const month = computed(() => dayjs(currentDate.value).format('YYYY-MM'))
/**
* 加载选中月份的预约。
*/
async function load(): Promise<void> {
if (!labId.value) {
events.value = []
return
}
loading.value = true
try {
const start = dayjs(month.value + '-01')
const end = start.endOf('month')
events.value = await reservationApi.calendar(
labId.value,
start.format('YYYY-MM-DD'),
end.format('YYYY-MM-DD')
)
} finally {
loading.value = false
}
}
/**
* 查询某天的预约。
*
* @param day yyyy-MM-dd
* @returns 预约列表
*/
function eventsOf(day: string): ReservationVO[] {
return events.value.filter((item) => item.startTime.startsWith(day))
}
/**
* 显示预约详情。
*
* @param item 预约
*/
function showDetail(item: ReservationVO): void {
detail.value = item
detailVisible.value = true
}
watch(currentDate, load)
onMounted(async () => {
labs.value = await labApi.all()
if (labs.value.length > 0) {
labId.value = labs.value[0].id
await load()
}
})
</script>
<style scoped>
.cell {
height: 100%;
padding: 2px 4px;
overflow: hidden;
}
.day {
font-size: 12px;
color: #909399;
}
.event {
margin-top: 2px;
padding: 1px 4px;
border-radius: 3px;
font-size: 11px;
white-space: nowrap;
overflow: hidden;
text-overflow: ellipsis;
cursor: pointer;
background-color: #ecf5ff;
color: #409eff;
}
.event.pending {
background-color: #fdf6ec;
color: #e6a23c;
}
.event.in_use {
background-color: #f0f9eb;
color: #67c23a;
}
.event.completed {
background-color: #f4f4f5;
color: #909399;
}
</style>

View File

@@ -0,0 +1,339 @@
<template>
<el-card>
<div class="toolbar">
<el-input
v-model="query.keyword"
placeholder="按名称/编号搜索"
clearable
style="width: 220px"
@keyup.enter="load"
@clear="load"
/>
<el-select v-model="query.labId" placeholder="全部实验室" clearable style="width: 200px" @change="load">
<el-option v-for="lab in labs" :key="lab.id" :label="lab.name" :value="lab.id" />
</el-select>
<el-select v-model="query.status" placeholder="全部状态" clearable style="width: 150px" @change="load">
<el-option label="进行中" value="ACTIVE" />
<el-option label="已结束" value="FINISHED" />
</el-select>
<el-button type="primary" @click="load">查询</el-button>
<div class="spacer" />
<el-button v-if="canManage" type="success" @click="openDialog()">
<el-icon><Plus /></el-icon>&nbsp;新增课程
</el-button>
</div>
<el-table :data="rows" v-loading="loading">
<el-table-column prop="code" label="编号" width="110" />
<el-table-column prop="name" label="课程名称" min-width="170" />
<el-table-column label="授课教师" width="110">
<template #default="{ row }">{{ userNames[row.teacherId] ?? `#${row.teacherId}` }}</template>
</el-table-column>
<el-table-column label="实验室" min-width="160">
<template #default="{ row }">{{ labName(row.labId) }}</template>
</el-table-column>
<el-table-column prop="studentCount" label="人数" width="70" align="center" />
<el-table-column label="排课" min-width="230">
<template #default="{ row }">
{{ row.startDate }} ~ {{ row.endDate }} / {{ formatWeekdays(row.weekdays) }}
{{ formatTime(row.startTime) }}~{{ formatTime(row.endTime) }}
</template>
</el-table-column>
<el-table-column label="状态" width="100" align="center">
<template #default="{ row }">
<el-tag :type="row.status === 'ACTIVE' ? 'success' : 'info'">
{{ row.status === 'ACTIVE' ? '进行中' : '已结束' }}
</el-tag>
</template>
</el-table-column>
<el-table-column label="操作" width="320" fixed="right">
<template #default="{ row }">
<el-button size="small" type="primary" @click="generate(row)">生成预约</el-button>
<el-button v-if="canManage" size="small" @click="openDialog(row)">编辑</el-button>
<el-button v-if="canManage" size="small" type="warning" @click="finish(row)">结束</el-button>
<el-button v-if="canManage" size="small" type="danger" @click="remove(row)">删除</el-button>
</template>
</el-table-column>
</el-table>
<el-pagination
class="pagination"
layout="total, prev, pager, next, sizes"
:total="total"
v-model:current-page="query.page"
v-model:page-size="query.size"
:page-sizes="[10, 20, 50]"
@current-change="load"
@size-change="load"
/>
<el-dialog v-model="dialogVisible" :title="form.id ? '编辑课程' : '新增课程'" width="560px">
<el-form ref="formRef" :model="form" :rules="rules" label-width="100px">
<el-form-item label="课程编号" prop="code">
<el-input v-model="form.code" />
</el-form-item>
<el-form-item label="课程名称" prop="name">
<el-input v-model="form.name" />
</el-form-item>
<el-form-item label="绑定实验室" prop="labId">
<el-select v-model="form.labId" placeholder="请选择">
<el-option v-for="lab in labs" :key="lab.id" :label="`${lab.name}(容量 ${lab.capacity})`" :value="lab.id" />
</el-select>
</el-form-item>
<el-form-item label="选课人数" prop="studentCount">
<el-input-number v-model="form.studentCount" :min="1" />
</el-form-item>
<el-form-item label="起止日期" prop="startDate">
<el-date-picker v-model="dateRange" type="daterange" value-format="YYYY-MM-DD" start-placeholder="开始" end-placeholder="结束" />
</el-form-item>
<el-form-item label="上课星期" prop="weekdays">
<el-select v-model="weekdayList" multiple placeholder="可多选">
<el-option v-for="(label, value) in WEEKDAY_OPTIONS" :key="value" :label="label" :value="value" />
</el-select>
</el-form-item>
<el-form-item label="上课时间" prop="startTime">
<el-time-picker v-model="form.startTime" format="HH:mm" value-format="HH:mm" placeholder="开始" />
<span class="time-sep">~</span>
<el-time-picker v-model="form.endTime" format="HH:mm" value-format="HH:mm" placeholder="结束" />
</el-form-item>
</el-form>
<template #footer>
<el-button @click="dialogVisible = false">取消</el-button>
<el-button type="primary" @click="submit">保存</el-button>
</template>
</el-dialog>
<el-dialog v-model="generateVisible" title="生成课程绑定预约" width="480px">
<el-alert
type="info"
:closable="false"
title="将按课程的排课规则一次性生成整期预约,系统会自动做冲突校验;如存在冲突会拒绝整批生成。"
/>
<el-form class="generate-form" label-width="90px">
<el-form-item label="设备(可选)">
<el-select v-model="generateDeviceId" clearable placeholder="不指定设备">
<el-option v-for="device in devices" :key="device.id" :label="device.name" :value="device.id" />
</el-select>
</el-form-item>
<el-form-item label="标题">
<el-input v-model="generateTitle" placeholder="默认使用课程名" />
</el-form-item>
</el-form>
<template #footer>
<el-button @click="generateVisible = false">取消</el-button>
<el-button type="primary" :loading="generating" @click="confirmGenerate">生成</el-button>
</template>
</el-dialog>
</el-card>
</template>
<script setup lang="ts">
import { computed, onMounted, reactive, ref } from 'vue'
import { ElMessage, ElMessageBox, type FormInstance, type FormRules } from 'element-plus'
import { courseApi, deviceApi, labApi, reservationApi, userApi } from '@/api'
import { useAuthStore } from '@/stores/auth'
import { formatTime, formatWeekdays } from '@/utils/format'
import type { Course, Device, Lab, ReservationVO } from '@/types'
const WEEKDAY_OPTIONS: Record<string, string> = {
MON: '周一',
TUE: '周二',
WED: '周三',
THU: '周四',
FRI: '周五',
SAT: '周六',
SUN: '周日'
}
const auth = useAuthStore()
const loading = ref(false)
const rows = ref<Course[]>([])
const labs = ref<Lab[]>([])
const devices = ref<Device[]>([])
const userNames = ref<Record<number, string>>({})
const total = ref(0)
const query = reactive({ page: 1, size: 10, keyword: '', labId: '' as number | '', status: '' })
const dialogVisible = ref(false)
const formRef = ref<FormInstance>()
const form = reactive<Partial<Course>>({})
const dateRange = ref<[string, string] | null>(null)
const weekdayList = ref<string[]>([])
const generateVisible = ref(false)
const generating = ref(false)
const generateCourse = ref<Course | null>(null)
const generateDeviceId = ref<number | undefined>(undefined)
const generateTitle = ref('')
/** 是否具备课程管理权限 */
const canManage = computed(() => auth.hasRole('ADMIN', 'TEACHER'))
/** 表单校验规则 */
const rules: FormRules = {
code: [{ required: true, message: '请输入编号', trigger: 'blur' }],
name: [{ required: true, message: '请输入名称', trigger: 'blur' }],
labId: [{ required: true, message: '请选择实验室', trigger: 'change' }],
studentCount: [{ required: true, message: '请输入人数', trigger: 'blur' }],
startDate: [{ required: true, message: '请选择日期', trigger: 'change' }],
weekdays: [{ required: true, message: '请选择星期', trigger: 'change' }],
startTime: [{ required: true, message: '请选择时间', trigger: 'change' }]
}
/**
* 加载课程列表。
*/
async function load(): Promise<void> {
loading.value = true
try {
const result = await courseApi.page({
page: query.page,
size: query.size,
keyword: query.keyword || undefined,
labId: query.labId || undefined,
status: query.status || undefined
})
rows.value = result.records
total.value = result.total
} finally {
loading.value = false
}
}
/**
* 取实验室名称。
*
* @param labId 实验室 ID
* @returns 名称
*/
function labName(labId: number): string {
return labs.value.find((item) => item.id === labId)?.name ?? `#${labId}`
}
/**
* 打开新增/编辑对话框。
*
* @param row 行数据
*/
function openDialog(row?: Course): void {
Object.keys(form).forEach((key) => delete (form as Record<string, unknown>)[key])
if (row) {
Object.assign(form, row)
dateRange.value = [row.startDate, row.endDate]
weekdayList.value = row.weekdays.split(',').map((token) => token.trim()).filter(Boolean)
} else {
form.studentCount = 30
form.startTime = '10:00'
form.endTime = '12:00'
dateRange.value = null
weekdayList.value = []
}
dialogVisible.value = true
}
/**
* 保存课程。
*/
async function submit(): Promise<void> {
const valid = await formRef.value?.validate().catch(() => false)
if (!valid || !dateRange.value || weekdayList.value.length === 0) {
ElMessage.warning('请完整填写排课信息')
return
}
const payload = {
...form,
startDate: dateRange.value[0],
endDate: dateRange.value[1],
weekdays: weekdayList.value.join(',')
}
if (form.id) {
await courseApi.update(form.id, payload)
ElMessage.success('修改成功')
} else {
await courseApi.create(payload)
ElMessage.success('新增成功')
}
dialogVisible.value = false
await load()
}
/**
* 结束课程。
*
* @param row 行数据
*/
async function finish(row: Course): Promise<void> {
await ElMessageBox.confirm(`确认结束课程「${row.name}」吗?`, '提示', { type: 'warning' })
await courseApi.finish(row.id)
ElMessage.success('课程已结束')
await load()
}
/**
* 删除课程。
*
* @param row 行数据
*/
async function remove(row: Course): Promise<void> {
await ElMessageBox.confirm(`确认删除课程「${row.name}」吗?`, '提示', { type: 'warning' })
await courseApi.remove(row.id)
ElMessage.success('删除成功')
await load()
}
/**
* 打开生成课程预约对话框。
*
* @param row 课程
*/
async function generate(row: Course): Promise<void> {
generateCourse.value = row
generateDeviceId.value = undefined
generateTitle.value = ''
devices.value = await deviceApi.byLab(row.labId)
generateVisible.value = true
}
/**
* 确认生成课程绑定预约。
*/
async function confirmGenerate(): Promise<void> {
if (!generateCourse.value) {
return
}
generating.value = true
try {
const created: ReservationVO[] = await reservationApi.createForCourse({
courseId: generateCourse.value.id,
deviceId: generateDeviceId.value,
title: generateTitle.value || undefined
})
ElMessage.success(`已生成 ${created.length} 场预约`)
generateVisible.value = false
} finally {
generating.value = false
}
}
onMounted(async () => {
const [labList, users] = await Promise.all([labApi.all(), userApi.list().catch(() => [])])
labs.value = labList
userNames.value = Object.fromEntries(users.map((user) => [user.id, user.realName]))
await load()
})
</script>
<style scoped>
.pagination {
margin-top: 16px;
justify-content: flex-end;
}
.time-sep {
margin: 0 8px;
}
.generate-form {
margin-top: 16px;
}
</style>

View File

@@ -0,0 +1,129 @@
<template>
<div>
<el-row :gutter="16">
<el-col v-for="card in cards" :key="card.title" :xs="12" :sm="6">
<el-card class="stat-card" shadow="hover">
<div class="stat-value">{{ card.value }}</div>
<div class="stat-title">{{ card.title }}</div>
</el-card>
</el-col>
</el-row>
<el-row :gutter="16" class="quick-row">
<el-col :span="24">
<el-card>
<template #header>
<span>快捷入口</span>
</template>
<el-space wrap>
<el-button type="primary" @click="router.push('/reservations/new')">
<el-icon><Plus /></el-icon>&nbsp;发起预约
</el-button>
<el-button @click="router.push('/calendar')">
<el-icon><Calendar /></el-icon>&nbsp;查看日历
</el-button>
<el-button v-if="auth.hasRole('ADMIN', 'TEACHER')" @click="router.push('/approvals')">
<el-icon><Checked /></el-icon>&nbsp;待我审批
</el-button>
<el-button v-if="auth.hasRole('ADMIN')" @click="router.push('/users')">
<el-icon><User /></el-icon>&nbsp;用户管理
</el-button>
</el-space>
</el-card>
</el-col>
</el-row>
<el-card class="table-card">
<template #header>
<span>我的最近预约</span>
</template>
<el-table :data="recent" v-loading="loading" empty-text="暂无预约">
<el-table-column prop="title" label="标题" min-width="140" />
<el-table-column prop="labName" label="实验室" min-width="140" />
<el-table-column label="时间" min-width="220">
<template #default="{ row }">
{{ formatDateTime(row.startTime) }} ~ {{ formatDateTime(row.endTime) }}
</template>
</el-table-column>
<el-table-column prop="typeLabel" label="类型" width="110" />
<el-table-column label="状态" width="100">
<template #default="{ row }">
<el-tag :type="RESERVATION_STATUS_TYPES[row.status] as any">{{ row.statusLabel }}</el-tag>
</template>
</el-table-column>
</el-table>
</el-card>
</div>
</template>
<script setup lang="ts">
import { onMounted, reactive, ref } from 'vue'
import { useRouter } from 'vue-router'
import { labApi, deviceApi, reservationApi } from '@/api'
import { useAuthStore } from '@/stores/auth'
import { RESERVATION_STATUS_TYPES, formatDateTime } from '@/utils/format'
import type { ReservationVO } from '@/types'
const router = useRouter()
const auth = useAuthStore()
const loading = ref(false)
const recent = ref<ReservationVO[]>([])
/** 顶部统计卡片数据 */
const cards = reactive([
{ title: '实验室总数', value: 0 },
{ title: '设备总数', value: 0 },
{ title: '我的预约', value: 0 },
{ title: '待审批预约', value: 0 }
])
/**
* 加载统计与最近预约。
*/
async function load(): Promise<void> {
loading.value = true
try {
const [labs, devices, mine, pending] = await Promise.all([
labApi.page({ page: 1, size: 1 }),
deviceApi.page({ page: 1, size: 1 }),
reservationApi.page({ page: 1, size: 5, mine: true }),
reservationApi.page({ page: 1, size: 1, status: 'PENDING' })
])
cards[0].value = labs.total
cards[1].value = devices.total
cards[2].value = mine.total
cards[3].value = pending.total
recent.value = mine.records
} finally {
loading.value = false
}
}
onMounted(load)
</script>
<style scoped>
.stat-card {
text-align: center;
}
.stat-value {
font-size: 28px;
font-weight: 600;
color: #409eff;
}
.stat-title {
margin-top: 8px;
color: #909399;
font-size: 13px;
}
.quick-row {
margin-top: 16px;
}
.table-card {
margin-top: 16px;
}
</style>

View File

@@ -0,0 +1,221 @@
<template>
<el-card>
<div class="toolbar">
<el-input
v-model="query.keyword"
placeholder="按名称/编号搜索"
clearable
style="width: 220px"
@keyup.enter="load"
@clear="load"
/>
<el-select v-model="query.labId" placeholder="全部实验室" clearable style="width: 200px" @change="load">
<el-option v-for="lab in labs" :key="lab.id" :label="lab.name" :value="lab.id" />
</el-select>
<el-select v-model="query.status" placeholder="全部状态" clearable style="width: 150px" @change="load">
<el-option v-for="(label, value) in LAB_STATUS_LABELS" :key="value" :label="label" :value="value" />
</el-select>
<el-button type="primary" @click="load">查询</el-button>
<div class="spacer" />
<el-button v-if="auth.hasRole('ADMIN')" type="success" @click="openDialog()">
<el-icon><Plus /></el-icon>&nbsp;新增设备
</el-button>
</div>
<el-table :data="rows" v-loading="loading">
<el-table-column prop="code" label="编号" width="150" />
<el-table-column prop="name" label="名称" min-width="150" />
<el-table-column prop="model" label="型号" min-width="150" />
<el-table-column label="所属实验室" min-width="160">
<template #default="{ row }">{{ labName(row.labId) }}</template>
</el-table-column>
<el-table-column label="状态" width="110" align="center">
<template #default="{ row }">
<el-tag :type="RESOURCE_STATUS_TYPES[row.status] as any">{{ LAB_STATUS_LABELS[row.status] }}</el-tag>
</template>
</el-table-column>
<el-table-column label="操作" width="250" fixed="right">
<template #default="{ row }">
<el-button size="small" @click="openDialog(row)">详情</el-button>
<el-dropdown v-if="auth.hasRole('ADMIN')" @command="(status: string) => changeStatus(row, status)">
<el-button size="small" type="primary">状态<el-icon class="el-icon--right"><ArrowDown /></el-icon></el-button>
<template #dropdown>
<el-dropdown-menu>
<el-dropdown-item command="IDLE">空闲</el-dropdown-item>
<el-dropdown-item command="MAINTENANCE">维护中</el-dropdown-item>
<el-dropdown-item command="RESERVED">已预约</el-dropdown-item>
<el-dropdown-item command="IN_USE">使用中</el-dropdown-item>
</el-dropdown-menu>
</template>
</el-dropdown>
<el-button v-if="auth.hasRole('ADMIN')" size="small" type="danger" @click="remove(row)">删除</el-button>
</template>
</el-table-column>
</el-table>
<el-pagination
class="pagination"
layout="total, prev, pager, next, sizes"
:total="total"
v-model:current-page="query.page"
v-model:page-size="query.size"
:page-sizes="[10, 20, 50]"
@current-change="load"
@size-change="load"
/>
<el-dialog v-model="dialogVisible" :title="form.id ? '设备详情' : '新增设备'" width="500px">
<el-form ref="formRef" :model="form" :rules="rules" label-width="90px">
<el-form-item label="所属实验室" prop="labId">
<el-select v-model="form.labId" :disabled="!editable" placeholder="请选择">
<el-option v-for="lab in labs" :key="lab.id" :label="lab.name" :value="lab.id" />
</el-select>
</el-form-item>
<el-form-item label="编号" prop="code">
<el-input v-model="form.code" :disabled="!editable" />
</el-form-item>
<el-form-item label="名称" prop="name">
<el-input v-model="form.name" :disabled="!editable" />
</el-form-item>
<el-form-item label="型号">
<el-input v-model="form.model" :disabled="!editable" />
</el-form-item>
<el-form-item label="描述">
<el-input v-model="form.description" type="textarea" :rows="3" :disabled="!editable" />
</el-form-item>
</el-form>
<template #footer>
<el-button @click="dialogVisible = false">{{ editable ? '取消' : '关闭' }}</el-button>
<el-button v-if="editable" type="primary" @click="submit">保存</el-button>
</template>
</el-dialog>
</el-card>
</template>
<script setup lang="ts">
import { computed, onMounted, reactive, ref } from 'vue'
import { ElMessage, ElMessageBox, type FormInstance, type FormRules } from 'element-plus'
import { deviceApi, labApi } from '@/api'
import { useAuthStore } from '@/stores/auth'
import { LAB_STATUS_LABELS, RESOURCE_STATUS_TYPES } from '@/utils/format'
import type { Device, Lab } from '@/types'
const auth = useAuthStore()
const loading = ref(false)
const rows = ref<Device[]>([])
const labs = ref<Lab[]>([])
const total = ref(0)
const query = reactive({ page: 1, size: 10, keyword: '', labId: '' as number | '', status: '' })
const dialogVisible = ref(false)
const formRef = ref<FormInstance>()
const form = reactive<Partial<Device>>({})
/** 是否可编辑(管理员) */
const editable = computed(() => auth.hasRole('ADMIN'))
/** 表单校验规则 */
const rules: FormRules = {
labId: [{ required: true, message: '请选择实验室', trigger: 'change' }],
code: [{ required: true, message: '请输入编号', trigger: 'blur' }],
name: [{ required: true, message: '请输入名称', trigger: 'blur' }]
}
/**
* 加载设备与实验室选项。
*/
async function load(): Promise<void> {
loading.value = true
try {
const result = await deviceApi.page({
page: query.page,
size: query.size,
keyword: query.keyword || undefined,
labId: query.labId || undefined,
status: query.status || undefined
})
rows.value = result.records
total.value = result.total
} finally {
loading.value = false
}
}
/**
* 根据实验室 ID 取名称。
*
* @param labId 实验室 ID
* @returns 名称
*/
function labName(labId: number): string {
return labs.value.find((item) => item.id === labId)?.name ?? `#${labId}`
}
/**
* 打开新增/详情对话框。
*
* @param row 行数据
*/
function openDialog(row?: Device): void {
Object.keys(form).forEach((key) => delete (form as Record<string, unknown>)[key])
if (row) {
Object.assign(form, row)
}
dialogVisible.value = true
}
/**
* 保存设备。
*/
async function submit(): Promise<void> {
const valid = await formRef.value?.validate().catch(() => false)
if (!valid) {
return
}
if (form.id) {
await deviceApi.update(form.id, form)
ElMessage.success('修改成功')
} else {
await deviceApi.create(form)
ElMessage.success('新增成功')
}
dialogVisible.value = false
await load()
}
/**
* 删除设备。
*
* @param row 行数据
*/
async function remove(row: Device): Promise<void> {
await ElMessageBox.confirm(`确认删除设备「${row.name}」吗?`, '提示', { type: 'warning' })
await deviceApi.remove(row.id)
ElMessage.success('删除成功')
await load()
}
/**
* 变更设备状态。
*
* @param row 行数据
* @param status 目标状态
*/
async function changeStatus(row: Device, status: string): Promise<void> {
await deviceApi.changeStatus(row.id, status)
ElMessage.success('状态已更新')
await load()
}
onMounted(async () => {
labs.value = await labApi.all()
await load()
})
</script>
<style scoped>
.pagination {
margin-top: 16px;
justify-content: flex-end;
}
</style>

View File

@@ -0,0 +1,223 @@
<template>
<el-card>
<div class="toolbar">
<el-input
v-model="query.keyword"
placeholder="按名称/编号搜索"
clearable
style="width: 220px"
@keyup.enter="load"
@clear="load"
/>
<el-select v-model="query.status" placeholder="全部状态" clearable style="width: 160px" @change="load">
<el-option v-for="(label, value) in LAB_STATUS_LABELS" :key="value" :label="label" :value="value" />
</el-select>
<el-button type="primary" @click="load">查询</el-button>
<div class="spacer" />
<el-button v-if="auth.hasRole('ADMIN')" type="success" @click="openDialog()">
<el-icon><Plus /></el-icon>&nbsp;新增实验室
</el-button>
</div>
<el-table :data="rows" v-loading="loading">
<el-table-column prop="code" label="编号" width="130" />
<el-table-column prop="name" label="名称" min-width="180" />
<el-table-column prop="location" label="位置" min-width="140" />
<el-table-column prop="capacity" label="容量" width="80" align="center" />
<el-table-column label="开放时间" width="140" align="center">
<template #default="{ row }">
{{ formatTime(row.openTime) }} ~ {{ formatTime(row.closeTime) }}
</template>
</el-table-column>
<el-table-column label="状态" width="110" align="center">
<template #default="{ row }">
<el-tag :type="RESOURCE_STATUS_TYPES[row.status] as any">{{ LAB_STATUS_LABELS[row.status] }}</el-tag>
</template>
</el-table-column>
<el-table-column label="操作" width="260" fixed="right">
<template #default="{ row }">
<el-button size="small" @click="openDialog(row)">详情</el-button>
<el-dropdown v-if="auth.hasRole('ADMIN')" @command="(status: string) => changeStatus(row, status)">
<el-button size="small" type="primary">状态<el-icon class="el-icon--right"><ArrowDown /></el-icon></el-button>
<template #dropdown>
<el-dropdown-menu>
<el-dropdown-item command="IDLE">空闲</el-dropdown-item>
<el-dropdown-item command="MAINTENANCE">维护中</el-dropdown-item>
<el-dropdown-item command="RESERVED">已预约</el-dropdown-item>
<el-dropdown-item command="IN_USE">使用中</el-dropdown-item>
</el-dropdown-menu>
</template>
</el-dropdown>
<el-button v-if="auth.hasRole('ADMIN')" size="small" type="danger" @click="remove(row)">删除</el-button>
</template>
</el-table-column>
</el-table>
<el-pagination
class="pagination"
layout="total, prev, pager, next, sizes"
:total="total"
v-model:current-page="query.page"
v-model:page-size="query.size"
:page-sizes="[10, 20, 50]"
@current-change="load"
@size-change="load"
/>
<el-dialog v-model="dialogVisible" :title="form.id ? '实验室详情' : '新增实验室'" width="520px">
<el-form ref="formRef" :model="form" :rules="rules" label-width="90px">
<el-form-item label="编号" prop="code">
<el-input v-model="form.code" :disabled="Boolean(form.id) && !auth.hasRole('ADMIN')" />
</el-form-item>
<el-form-item label="名称" prop="name">
<el-input v-model="form.name" :disabled="!editable" />
</el-form-item>
<el-form-item label="位置" prop="location">
<el-input v-model="form.location" :disabled="!editable" />
</el-form-item>
<el-form-item label="容量" prop="capacity">
<el-input-number v-model="form.capacity" :min="1" :disabled="!editable" />
</el-form-item>
<el-form-item label="开放时间">
<el-time-picker v-model="openTime" format="HH:mm" value-format="HH:mm" :disabled="!editable" placeholder="开始" />
<span class="time-sep">~</span>
<el-time-picker v-model="closeTime" format="HH:mm" value-format="HH:mm" :disabled="!editable" placeholder="结束" />
</el-form-item>
<el-form-item label="描述">
<el-input v-model="form.description" type="textarea" :rows="3" :disabled="!editable" />
</el-form-item>
</el-form>
<template #footer>
<el-button @click="dialogVisible = false">{{ editable ? '取消' : '关闭' }}</el-button>
<el-button v-if="editable" type="primary" @click="submit">保存</el-button>
</template>
</el-dialog>
</el-card>
</template>
<script setup lang="ts">
import { computed, onMounted, reactive, ref } from 'vue'
import { ElMessage, ElMessageBox, type FormInstance, type FormRules } from 'element-plus'
import { labApi } from '@/api'
import { useAuthStore } from '@/stores/auth'
import { LAB_STATUS_LABELS, RESOURCE_STATUS_TYPES, formatTime } from '@/utils/format'
import type { Lab } from '@/types'
const auth = useAuthStore()
const loading = ref(false)
const rows = ref<Lab[]>([])
const total = ref(0)
const query = reactive({ page: 1, size: 10, keyword: '', status: '' })
const dialogVisible = ref(false)
const formRef = ref<FormInstance>()
const form = reactive<Partial<Lab>>({})
const openTime = ref('08:00')
const closeTime = ref('22:00')
/** 是否处于可编辑模式(非管理员只读) */
const editable = computed(() => auth.hasRole('ADMIN'))
/** 表单校验规则 */
const rules: FormRules = {
code: [{ required: true, message: '请输入编号', trigger: 'blur' }],
name: [{ required: true, message: '请输入名称', trigger: 'blur' }],
location: [{ required: true, message: '请输入位置', trigger: 'blur' }],
capacity: [{ required: true, message: '请输入容量', trigger: 'blur' }]
}
/**
* 加载实验室列表。
*/
async function load(): Promise<void> {
loading.value = true
try {
const result = await labApi.page({
page: query.page,
size: query.size,
keyword: query.keyword || undefined,
status: query.status || undefined
})
rows.value = result.records
total.value = result.total
} finally {
loading.value = false
}
}
/**
* 打开新增/详情对话框。
*
* @param row 行数据,空表示新增
*/
function openDialog(row?: Lab): void {
Object.keys(form).forEach((key) => delete (form as Record<string, unknown>)[key])
if (row) {
Object.assign(form, row)
openTime.value = formatTime(row.openTime)
closeTime.value = formatTime(row.closeTime)
} else {
form.capacity = 30
openTime.value = '08:00'
closeTime.value = '22:00'
}
dialogVisible.value = true
}
/**
* 保存实验室。
*/
async function submit(): Promise<void> {
const valid = await formRef.value?.validate().catch(() => false)
if (!valid) {
return
}
const payload = { ...form, openTime: openTime.value, closeTime: closeTime.value }
if (form.id) {
await labApi.update(form.id, payload)
ElMessage.success('修改成功')
} else {
await labApi.create(payload)
ElMessage.success('新增成功')
}
dialogVisible.value = false
await load()
}
/**
* 删除实验室。
*
* @param row 行数据
*/
async function remove(row: Lab): Promise<void> {
await ElMessageBox.confirm(`确认删除实验室「${row.name}」吗?`, '提示', { type: 'warning' })
await labApi.remove(row.id)
ElMessage.success('删除成功')
await load()
}
/**
* 变更实验室状态。
*
* @param row 行数据
* @param status 目标状态
*/
async function changeStatus(row: Lab, status: string): Promise<void> {
await labApi.changeStatus(row.id, status)
ElMessage.success('状态已更新')
await load()
}
onMounted(load)
</script>
<style scoped>
.pagination {
margin-top: 16px;
justify-content: flex-end;
}
.time-sep {
margin: 0 8px;
}
</style>

View File

@@ -0,0 +1,127 @@
<template>
<div class="login-page">
<el-card class="login-card">
<h2 class="title">实验室预约与资源管理平台</h2>
<p class="subtitle">Laboratory Reservation & Resource Management</p>
<el-form ref="formRef" :model="form" :rules="rules" label-position="top" @submit.prevent>
<el-form-item label="用户名" prop="username">
<el-input v-model="form.username" placeholder="请输入用户名" size="large" clearable />
</el-form-item>
<el-form-item label="密码" prop="password">
<el-input
v-model="form.password"
type="password"
placeholder="请输入密码"
size="large"
show-password
@keyup.enter="onSubmit"
/>
</el-form-item>
<el-button type="primary" size="large" class="submit" :loading="loading" @click="onSubmit">
登 录
</el-button>
</el-form>
<el-divider>演示账号</el-divider>
<div class="demo-accounts">
<el-button size="small" @click="fill('admin', 'admin123')">管理员 admin</el-button>
<el-button size="small" @click="fill('teacher1', '123456')">教师 teacher1</el-button>
<el-button size="small" @click="fill('student1', '123456')">学生 student1</el-button>
</div>
</el-card>
</div>
</template>
<script setup lang="ts">
import { reactive, ref } from 'vue'
import { useRoute, useRouter } from 'vue-router'
import { ElMessage, type FormInstance, type FormRules } from 'element-plus'
import { useAuthStore } from '@/stores/auth'
const router = useRouter()
const route = useRoute()
const auth = useAuthStore()
const formRef = ref<FormInstance>()
const loading = ref(false)
const form = reactive({ username: '', password: '' })
/** 表单校验规则 */
const rules: FormRules = {
username: [{ required: true, message: '请输入用户名', trigger: 'blur' }],
password: [{ required: true, message: '请输入密码', trigger: 'blur' }]
}
/**
* 快速填充演示账号。
*
* @param username 用户名
* @param password 密码
*/
function fill(username: string, password: string): void {
form.username = username
form.password = password
}
/**
* 提交登录。
*/
async function onSubmit(): Promise<void> {
const valid = await formRef.value?.validate().catch(() => false)
if (!valid) {
return
}
loading.value = true
try {
await auth.login(form.username, form.password)
ElMessage.success('登录成功')
const redirect = (route.query.redirect as string) || '/dashboard'
router.push(redirect)
} finally {
loading.value = false
}
}
</script>
<style scoped>
.login-page {
height: 100%;
display: flex;
align-items: center;
justify-content: center;
background: linear-gradient(135deg, #1f2d3d 0%, #3a6073 100%);
}
.login-card {
width: 420px;
padding: 8px 12px;
}
.title {
margin: 0 0 4px;
text-align: center;
font-size: 20px;
}
.subtitle {
margin: 0 0 24px;
text-align: center;
color: #909399;
font-size: 12px;
}
.submit {
width: 100%;
}
.demo-accounts {
display: flex;
justify-content: space-between;
gap: 8px;
}
.demo-accounts .el-button {
flex: 1;
margin: 0;
}
</style>

View File

@@ -0,0 +1,230 @@
<template>
<el-card>
<div class="toolbar">
<el-select v-model="query.status" placeholder="全部状态" clearable style="width: 150px" @change="load">
<el-option v-for="(label, value) in STATUS_LABELS" :key="value" :label="label" :value="value" />
</el-select>
<el-select v-model="query.type" placeholder="全部类型" clearable style="width: 160px" @change="load">
<el-option label="单次预约" value="SINGLE" />
<el-option label="多次预约" value="RECURRING" />
<el-option label="课程绑定" value="COURSE" />
</el-select>
<el-select v-model="query.labId" placeholder="全部实验室" clearable style="width: 200px" @change="load">
<el-option v-for="lab in labs" :key="lab.id" :label="lab.name" :value="lab.id" />
</el-select>
<el-input v-model="query.keyword" placeholder="标题关键字" clearable style="width: 180px" @keyup.enter="load" @clear="load" />
<el-date-picker v-model="dateRange" type="daterange" value-format="YYYY-MM-DD" start-placeholder="开始日期" end-placeholder="结束日期" @change="onDateChange" />
<el-button type="primary" @click="load">查询</el-button>
<div class="spacer" />
<el-button type="success" @click="router.push('/reservations/new')">发起预约</el-button>
</div>
<el-table :data="rows" v-loading="loading">
<el-table-column prop="title" label="标题" min-width="150" />
<el-table-column prop="labName" label="实验室" min-width="150" />
<el-table-column prop="deviceName" label="设备" min-width="120">
<template #default="{ row }">{{ row.deviceName || '-' }}</template>
</el-table-column>
<el-table-column label="时间" min-width="230">
<template #default="{ row }">
{{ formatDateTime(row.startTime) }}<br />
{{ formatDateTime(row.endTime) }}
</template>
</el-table-column>
<el-table-column prop="participants" label="人数" width="70" align="center" />
<el-table-column prop="typeLabel" label="类型" width="110" />
<el-table-column label="状态" width="110" align="center">
<template #default="{ row }">
<el-tag :type="RESERVATION_STATUS_TYPES[row.status] as any">{{ row.statusLabel }}</el-tag>
</template>
</el-table-column>
<el-table-column label="操作" width="260" fixed="right">
<template #default="{ row }">
<el-button size="small" @click="showDetail(row)">详情</el-button>
<el-button
v-if="['PENDING', 'APPROVED'].includes(row.status)"
size="small"
type="warning"
@click="cancel(row)"
>
取消
</el-button>
<el-button v-if="row.status === 'APPROVED'" size="small" type="primary" @click="start(row)">
开始使用
</el-button>
<el-button v-if="row.status === 'IN_USE'" size="small" type="success" @click="complete(row)">
完成
</el-button>
</template>
</el-table-column>
</el-table>
<el-pagination
class="pagination"
layout="total, prev, pager, next, sizes"
:total="total"
v-model:current-page="query.page"
v-model:page-size="query.size"
:page-sizes="[10, 20, 50]"
@current-change="load"
@size-change="load"
/>
<el-drawer v-model="detailVisible" title="预约详情" size="440px">
<el-descriptions v-if="detail" :column="1" border>
<el-descriptions-item label="标题">{{ detail.title }}</el-descriptions-item>
<el-descriptions-item label="预约人">{{ detail.userName }}</el-descriptions-item>
<el-descriptions-item label="实验室">{{ detail.labName }}</el-descriptions-item>
<el-descriptions-item label="设备">{{ detail.deviceName || '-' }}</el-descriptions-item>
<el-descriptions-item label="课程">{{ detail.courseName || '-' }}</el-descriptions-item>
<el-descriptions-item label="开始">{{ formatDateTime(detail.startTime) }}</el-descriptions-item>
<el-descriptions-item label="结束">{{ formatDateTime(detail.endTime) }}</el-descriptions-item>
<el-descriptions-item label="人数">{{ detail.participants }}</el-descriptions-item>
<el-descriptions-item label="类型">{{ detail.typeLabel }}</el-descriptions-item>
<el-descriptions-item label="状态">{{ detail.statusLabel }}</el-descriptions-item>
<el-descriptions-item label="审批人">{{ detail.approverName || '-' }}</el-descriptions-item>
<el-descriptions-item label="驳回原因">{{ detail.rejectReason || '-' }}</el-descriptions-item>
<el-descriptions-item label="用途">{{ detail.purpose || '-' }}</el-descriptions-item>
</el-descriptions>
</el-drawer>
</el-card>
</template>
<script setup lang="ts">
import { onMounted, reactive, ref } from 'vue'
import { useRouter } from 'vue-router'
import { ElMessage, ElMessageBox } from 'element-plus'
import { labApi, reservationApi } from '@/api'
import { RESERVATION_STATUS_TYPES, formatDateTime } from '@/utils/format'
import type { Lab, ReservationVO } from '@/types'
const STATUS_LABELS: Record<string, string> = {
PENDING: '待审批',
APPROVED: '已通过',
REJECTED: '已驳回',
CANCELLED: '已取消',
IN_USE: '使用中',
COMPLETED: '已完成'
}
const router = useRouter()
const loading = ref(false)
const rows = ref<ReservationVO[]>([])
const labs = ref<Lab[]>([])
const total = ref(0)
const dateRange = ref<[string, string] | null>(null)
const query = reactive({
page: 1,
size: 10,
status: '',
type: '',
labId: '' as number | '',
keyword: '',
mine: true
})
const detailVisible = ref(false)
const detail = ref<ReservationVO | null>(null)
/**
* 加载我的预约列表。
*/
async function load(): Promise<void> {
loading.value = true
try {
const result = await reservationApi.page({
page: query.page,
size: query.size,
mine: true,
status: (query.status || undefined) as ReservationVO['status'] | undefined,
type: (query.type || undefined) as ReservationVO['type'] | undefined,
labId: query.labId || undefined,
keyword: query.keyword || undefined,
from: dateRange.value?.[0],
to: dateRange.value?.[1]
})
rows.value = result.records
total.value = result.total
} finally {
loading.value = false
}
}
/**
* 日期范围变更后重新查询。
*/
function onDateChange(): void {
query.page = 1
load()
}
/**
* 展示预约详情。
*
* @param row 行数据
*/
function showDetail(row: ReservationVO): void {
detail.value = row
detailVisible.value = true
}
/**
* 取消预约,系列预约可选择整体取消。
*
* @param row 行数据
*/
async function cancel(row: ReservationVO): Promise<void> {
const wholeSeries = row.seriesId != null
? await ElMessageBox.confirm('该预约属于重复系列,是否取消整个系列?', '取消预约', {
confirmButtonText: '取消整个系列',
cancelButtonText: '仅取消本次',
distinguishCancelAndClose: true,
type: 'warning'
})
.then(() => true)
.catch((action) => {
if (action === 'cancel') {
return false
}
throw action
})
: false
await reservationApi.cancel(row.id, wholeSeries)
ElMessage.success('已取消')
await load()
}
/**
* 开始使用。
*
* @param row 行数据
*/
async function start(row: ReservationVO): Promise<void> {
await reservationApi.start(row.id)
ElMessage.success('已开始使用')
await load()
}
/**
* 完成使用。
*
* @param row 行数据
*/
async function complete(row: ReservationVO): Promise<void> {
await reservationApi.complete(row.id)
ElMessage.success('已完成')
await load()
}
onMounted(async () => {
labs.value = await labApi.all()
await load()
})
</script>
<style scoped>
.pagination {
margin-top: 16px;
justify-content: flex-end;
}
</style>

View File

@@ -0,0 +1,372 @@
<template>
<el-row :gutter="16">
<el-col :xs="24" :lg="16">
<el-card>
<template #header>
<span>发起预约</span>
</template>
<el-tabs v-model="activeTab" @tab-change="onTabChange">
<el-tab-pane label="单次预约" name="SINGLE" />
<el-tab-pane label="多次预约" name="RECURRING" />
<el-tab-pane v-if="canUseCourse" label="课程绑定预约" name="COURSE" />
</el-tabs>
<el-form ref="formRef" :model="form" :rules="rules" label-width="110px">
<el-form-item v-if="activeTab === 'COURSE'" label="实验课程" prop="courseId">
<el-select v-model="form.courseId" placeholder="请选择课程" @change="onCourseChange">
<el-option
v-for="course in courses"
:key="course.id"
:label="`${course.name}(${course.code})`"
:value="course.id"
/>
</el-select>
</el-form-item>
<el-form-item label="实验室" prop="labId">
<el-select v-model="form.labId" placeholder="请选择实验室" @change="onLabChange">
<el-option
v-for="lab in labs"
:key="lab.id"
:label="`${lab.name}(${lab.location},容量 ${lab.capacity})`"
:value="lab.id"
:disabled="lab.status === 'MAINTENANCE'"
/>
</el-select>
</el-form-item>
<el-form-item label="设备(可选)">
<el-select v-model="form.deviceId" clearable placeholder="不指定设备" :disabled="!form.labId">
<el-option
v-for="device in devices"
:key="device.id"
:label="`${device.name}(${device.code})`"
:value="device.id"
:disabled="device.status === 'MAINTENANCE'"
/>
</el-select>
</el-form-item>
<template v-if="activeTab === 'SINGLE'">
<el-form-item label="使用时间" prop="timeRange">
<el-date-picker
v-model="form.timeRange"
type="datetimerange"
start-placeholder="开始时间"
end-placeholder="结束时间"
format="YYYY-MM-DD HH:mm"
value-format="YYYY-MM-DDTHH:mm:ss"
/>
</el-form-item>
</template>
<template v-else-if="activeTab === 'RECURRING'">
<el-form-item label="重复日期" prop="dateRange">
<el-date-picker
v-model="form.dateRange"
type="daterange"
start-placeholder="开始日期"
end-placeholder="结束日期"
value-format="YYYY-MM-DD"
/>
</el-form-item>
<el-form-item label="重复星期" prop="weekdayList">
<el-checkbox-group v-model="form.weekdayList">
<el-checkbox v-for="(label, value) in WEEKDAYS" :key="value" :value="value">{{ label }}</el-checkbox>
</el-checkbox-group>
</el-form-item>
<el-form-item label="每次时段" prop="timeOfDay">
<el-time-picker v-model="form.timeOfDay" is-range format="HH:mm" value-format="HH:mm" start-placeholder="开始" end-placeholder="结束" />
</el-form-item>
</template>
<el-form-item label="标题" prop="title">
<el-input v-model="form.title" placeholder="例如:毕业设计调试" />
</el-form-item>
<el-form-item label="用途说明">
<el-input v-model="form.purpose" type="textarea" :rows="3" placeholder="选填" />
</el-form-item>
<el-form-item label="参与人数" prop="participants">
<el-input-number v-model="form.participants" :min="1" />
</el-form-item>
<el-form-item>
<el-button :loading="checking" @click="onCheck">
<el-icon><Search /></el-icon>&nbsp;冲突预检
</el-button>
<el-button type="primary" :loading="submitting" @click="onSubmit">
<el-icon><Check /></el-icon>&nbsp;提交预约
</el-button>
</el-form-item>
</el-form>
</el-card>
</el-col>
<el-col :xs="24" :lg="8">
<el-card>
<template #header>
<span>冲突校验结果</span>
</template>
<el-empty v-if="!checked" description="点击「冲突预检」查看结果" />
<el-result
v-else-if="conflicts.length === 0"
icon="success"
title="可以预约"
sub-title="未检测到时间冲突"
/>
<div v-else>
<el-alert type="error" :closable="false" title="存在冲突,无法提交" show-icon />
<el-table :data="conflicts" class="conflict-table" size="small">
<el-table-column prop="message" label="冲突说明" min-width="200" />
</el-table>
</div>
</el-card>
<el-card class="tips">
<template #header>
<span>预约规则提示</span>
</template>
<ul class="rule-list">
<li>同一实验室、设备在相同时间段内只能被一个有效预约占用</li>
<li>相邻时段首尾相接不算冲突(例如 10:00-12:00 与 12:00-14:00)</li>
<li>单次预约最长 8 小时,最多提前 60 天,且需落在实验室开放时间内</li>
<li>学生提交后需要教师或管理员审批,教师/管理员提交后自动通过</li>
</ul>
</el-card>
</el-col>
</el-row>
</template>
<script setup lang="ts">
import { computed, onMounted, reactive, ref } from 'vue'
import { useRouter } from 'vue-router'
import { ElMessage, type FormInstance, type FormRules } from 'element-plus'
import { courseApi, deviceApi, labApi, reservationApi } from '@/api'
import { useAuthStore } from '@/stores/auth'
import type { Conflict, Course, Device, Lab, ReservationType } from '@/types'
const WEEKDAYS: Record<string, string> = {
MON: '周一',
TUE: '周二',
WED: '周三',
THU: '周四',
FRI: '周五',
SAT: '周六',
SUN: '周日'
}
interface CreateForm {
courseId?: number
labId?: number
deviceId?: number
title: string
purpose: string
participants: number
timeRange: [string, string] | null
dateRange: [string, string] | null
weekdayList: string[]
timeOfDay: [string, string] | null
}
const router = useRouter()
const auth = useAuthStore()
const formRef = ref<FormInstance>()
const activeTab = ref<ReservationType>('SINGLE')
const labs = ref<Lab[]>([])
const devices = ref<Device[]>([])
const courses = ref<Course[]>([])
const checking = ref(false)
const submitting = ref(false)
const checked = ref(false)
const conflicts = ref<Conflict[]>([])
const form = reactive<CreateForm>({
title: '',
purpose: '',
participants: 1,
timeRange: null,
dateRange: null,
weekdayList: [],
timeOfDay: null
})
/** 是否可用课程绑定预约(教师与管理员) */
const canUseCourse = computed(() => auth.hasRole('ADMIN', 'TEACHER'))
/** 表单校验规则 */
const rules: FormRules = {
labId: [{ required: true, message: '请选择实验室', trigger: 'change' }],
title: [{ required: true, message: '请输入标题', trigger: 'blur' }],
courseId: [{ required: true, message: '请选择课程', trigger: 'change' }],
timeRange: [{ required: true, message: '请选择使用时间', trigger: 'change' }],
dateRange: [{ required: true, message: '请选择重复日期', trigger: 'change' }],
weekdayList: [{ required: true, message: '请选择重复星期', trigger: 'change' }],
timeOfDay: [{ required: true, message: '请选择每次时段', trigger: 'change' }]
}
/**
* 切换预约类型时清空校验结果。
*/
function onTabChange(): void {
checked.value = false
conflicts.value = []
formRef.value?.clearValidate()
}
/**
* 切换实验室时刷新设备列表。
*
* @param labId 实验室 ID
*/
async function onLabChange(labId: number): Promise<void> {
form.deviceId = undefined
devices.value = await deviceApi.byLab(labId)
}
/**
* 选择课程后自动带出实验室与标题。
*
* @param courseId 课程 ID
*/
async function onCourseChange(courseId: number): Promise<void> {
const course = courses.value.find((item) => item.id === courseId)
if (!course) {
return
}
form.labId = course.labId
form.title = course.name
form.participants = course.studentCount
await onLabChange(course.labId)
}
/**
* 构造后端请求体。
*
* @returns 请求体或 null(参数不完整)
*/
function buildPayload(): Record<string, unknown> | null {
if (!form.labId || !form.title) {
return null
}
const base = {
labId: form.labId,
deviceId: form.deviceId,
participants: form.participants,
title: form.title,
purpose: form.purpose
}
if (activeTab.value === 'SINGLE') {
if (!form.timeRange) {
return null
}
return {
...base,
type: 'SINGLE',
startTime: form.timeRange[0],
endTime: form.timeRange[1]
}
}
if (activeTab.value === 'RECURRING') {
if (!form.dateRange || !form.timeOfDay || form.weekdayList.length === 0) {
return null
}
return {
...base,
type: 'RECURRING',
startDate: form.dateRange[0],
endDate: form.dateRange[1],
weekdays: form.weekdayList.join(','),
startTimeOfDay: form.timeOfDay[0],
endTimeOfDay: form.timeOfDay[1]
}
}
if (!form.courseId) {
return null
}
return { ...base, type: 'COURSE', courseId: form.courseId }
}
/**
* 冲突预检。
*/
async function onCheck(): Promise<void> {
const payload = buildPayload()
if (!payload) {
ElMessage.warning('请先完整填写预约信息')
return
}
checking.value = true
try {
const result = await reservationApi.check(payload)
checked.value = true
conflicts.value = result.conflicts
if (result.passed) {
ElMessage.success('未检测到冲突')
}
} finally {
checking.value = false
}
}
/**
* 提交预约。
*/
async function onSubmit(): Promise<void> {
const valid = await formRef.value?.validate().catch(() => false)
if (!valid) {
return
}
const payload = buildPayload()
if (!payload) {
ElMessage.warning('请先完整填写预约信息')
return
}
submitting.value = true
try {
if (activeTab.value === 'SINGLE') {
await reservationApi.create(payload)
} else if (activeTab.value === 'RECURRING') {
const created = await reservationApi.createRecurring(payload)
ElMessage.success(`已生成 ${created.length} 场预约`)
} else {
const created = await reservationApi.createForCourse(payload)
ElMessage.success(`已生成 ${created.length} 场预约`)
}
if (activeTab.value === 'SINGLE') {
ElMessage.success('预约已提交')
}
router.push('/reservations/mine')
} finally {
submitting.value = false
}
}
onMounted(async () => {
labs.value = await labApi.all()
if (canUseCourse.value) {
courses.value = await courseApi.all()
}
if (auth.user?.role === 'STUDENT') {
form.participants = 1
}
})
</script>
<style scoped>
.conflict-table {
margin-top: 12px;
}
.tips {
margin-top: 16px;
}
.rule-list {
margin: 0;
padding-left: 18px;
color: #606266;
font-size: 13px;
line-height: 1.9;
}
</style>

View File

@@ -0,0 +1,170 @@
<template>
<el-card>
<div class="toolbar">
<div class="spacer" />
<el-button type="success" @click="openDialog()">
<el-icon><Plus /></el-icon>&nbsp;新增用户
</el-button>
</div>
<el-table :data="rows" v-loading="loading">
<el-table-column prop="id" label="ID" width="70" />
<el-table-column prop="username" label="用户名" width="140" />
<el-table-column prop="realName" label="姓名" width="120" />
<el-table-column prop="roleLabel" label="角色" width="100">
<template #default="{ row }">
<el-tag :type="row.role === 'ADMIN' ? 'danger' : row.role === 'TEACHER' ? 'warning' : 'info'">
{{ row.roleLabel }}
</el-tag>
</template>
</el-table-column>
<el-table-column prop="email" label="邮箱" min-width="180" />
<el-table-column prop="phone" label="电话" width="140" />
<el-table-column label="状态" width="90" align="center">
<template #default="{ row }">
<el-tag :type="row.enabled ? 'success' : 'info'">{{ row.enabled ? '启用' : '禁用' }}</el-tag>
</template>
</el-table-column>
<el-table-column label="操作" width="170" fixed="right">
<template #default="{ row }">
<el-button size="small" @click="openDialog(row)">编辑</el-button>
<el-button size="small" type="danger" @click="remove(row)">删除</el-button>
</template>
</el-table-column>
</el-table>
<el-dialog v-model="dialogVisible" :title="form.id ? '编辑用户' : '新增用户'" width="480px">
<el-form ref="formRef" :model="form" :rules="rules" label-width="90px">
<el-form-item label="用户名" prop="username">
<el-input v-model="form.username" :disabled="Boolean(form.id)" />
</el-form-item>
<el-form-item v-if="!form.id" label="初始密码" prop="password">
<el-input v-model="form.password" type="password" show-password />
</el-form-item>
<el-form-item v-else label="重置密码">
<el-input v-model="form.password" type="password" show-password placeholder="留空则不修改" />
</el-form-item>
<el-form-item label="姓名" prop="realName">
<el-input v-model="form.realName" />
</el-form-item>
<el-form-item label="角色" prop="role">
<el-select v-model="form.role">
<el-option label="管理员" value="ADMIN" />
<el-option label="教师" value="TEACHER" />
<el-option label="学生" value="STUDENT" />
</el-select>
</el-form-item>
<el-form-item label="邮箱">
<el-input v-model="form.email" />
</el-form-item>
<el-form-item label="电话">
<el-input v-model="form.phone" />
</el-form-item>
<el-form-item v-if="form.id" label="启用">
<el-switch v-model="form.enabled" />
</el-form-item>
</el-form>
<template #footer>
<el-button @click="dialogVisible = false">取消</el-button>
<el-button type="primary" @click="submit">保存</el-button>
</template>
</el-dialog>
</el-card>
</template>
<script setup lang="ts">
import { onMounted, reactive, ref } from 'vue'
import { ElMessage, ElMessageBox, type FormInstance, type FormRules } from 'element-plus'
import { userApi } from '@/api'
import type { Role, UserVO } from '@/types'
interface UserForm {
id?: number
username?: string
password?: string
realName?: string
role?: Role
email?: string
phone?: string
enabled?: boolean
}
const loading = ref(false)
const rows = ref<UserVO[]>([])
const dialogVisible = ref(false)
const formRef = ref<FormInstance>()
const form = reactive<UserForm>({ role: 'STUDENT', enabled: true })
/** 表单校验规则 */
const rules: FormRules = {
username: [{ required: true, message: '请输入用户名', trigger: 'blur' }],
password: [{ required: true, message: '请输入密码', trigger: 'blur' }],
realName: [{ required: true, message: '请输入姓名', trigger: 'blur' }],
role: [{ required: true, message: '请选择角色', trigger: 'change' }]
}
/**
* 加载用户列表。
*/
async function load(): Promise<void> {
loading.value = true
try {
rows.value = await userApi.list()
} finally {
loading.value = false
}
}
/**
* 打开新增/编辑对话框。
*
* @param row 行数据
*/
function openDialog(row?: UserVO): void {
Object.keys(form).forEach((key) => delete (form as Record<string, unknown>)[key])
if (row) {
Object.assign(form, row, { password: '' })
} else {
Object.assign(form, { role: 'STUDENT', enabled: true })
}
dialogVisible.value = true
}
/**
* 保存用户。
*/
async function submit(): Promise<void> {
const valid = await formRef.value?.validate().catch(() => false)
if (!valid) {
return
}
if (form.id) {
const payload: Record<string, unknown> = { ...form }
delete payload.username
if (!payload.password) {
delete payload.password
}
await userApi.update(form.id, payload)
ElMessage.success('修改成功')
} else {
await userApi.create(form as Record<string, unknown>)
ElMessage.success('新增成功')
}
dialogVisible.value = false
await load()
}
/**
* 删除用户。
*
* @param row 行数据
*/
async function remove(row: UserVO): Promise<void> {
await ElMessageBox.confirm(`确认删除用户「${row.realName}」吗?`, '提示', { type: 'warning' })
await userApi.remove(row.id)
ElMessage.success('删除成功')
await load()
}
onMounted(load)
</script>

25
frontend/tsconfig.json Normal file
View File

@@ -0,0 +1,25 @@
{
"compilerOptions": {
"target": "ES2020",
"useDefineForClassFields": true,
"module": "ESNext",
"lib": ["ES2020", "DOM", "DOM.Iterable"],
"skipLibCheck": true,
"moduleResolution": "bundler",
"allowImportingTsExtensions": true,
"resolveJsonModule": true,
"isolatedModules": true,
"noEmit": true,
"jsx": "preserve",
"strict": true,
"noUnusedLocals": true,
"noUnusedParameters": true,
"noFallthroughCasesInSwitch": true,
"baseUrl": ".",
"paths": {
"@/*": ["./src/*"]
},
"types": ["node"]
},
"include": ["src/**/*.ts", "src/**/*.d.ts", "src/**/*.vue", "vite.config.ts"]
}

24
frontend/vite.config.ts Normal file
View File

@@ -0,0 +1,24 @@
import { fileURLToPath, URL } from 'node:url'
import { defineConfig } from 'vite'
import vue from '@vitejs/plugin-vue'
/**
* Vite 配置:开发代理 /api 到后端 8080,避免跨域。
*/
export default defineConfig({
plugins: [vue()],
resolve: {
alias: {
'@': fileURLToPath(new URL('./src', import.meta.url))
}
},
server: {
port: 5173,
proxy: {
'/api': {
target: 'http://localhost:8080',
changeOrigin: true
}
}
}
})