实验教学管理系统

一个基于 Laravel + Vue.js 的现代化实验教学管理系统，支持实验计划申报、实验记录填报、实验记录审核等完整的实验教学流程管理。

🚀 功能特性

核心功能模块

1. 实验计划申报功能 ✅

• 计划管理：创建、编辑、删除实验计划
• 审批流程：支持多级审批，状态跟踪
• 资源管理：设备和材料需求管理
• 统计分析：计划执行情况统计
• 权限控制：基于角色的访问控制

2. 实验记录填报功能 ✅

• 记录管理：详细的实验执行记录
• 照片上传：支持多种类型照片上传和管理
• 数据验证：自动验证记录完整性
• 器材确认：实验器材准备确认
• 进度跟踪：实时显示完成度

3. 实验记录审核功能 ✅

• 批量审核：支持批量通过/拒绝操作
• AI检查：照片合规性自动检查
• 审核日志：完整的审核历史记录
• 强制完成：管理员强制完成功能
• 统计分析：审核效率和质量分析

4. 基础数据管理 ✅

• 用户管理：多角色用户体系
• 组织机构管理：学校、区域层级管理
• 权限管理：细粒度权限控制
• 实验目录管理：实验分类和版本控制
• 设备材料管理：库存和借用管理

技术特性

• 响应式设计：支持桌面端和移动端
• 统一API响应：标准化的API响应格式
• 错误处理：完善的错误处理机制
• 性能优化：缓存和查询优化
• 安全防护：多层安全防护机制

🛠️ 技术栈

后端

• 框架：Laravel 10.x
• 数据库：MySQL 8.0
• 缓存：Redis
• 队列：Laravel Queue
• 文件存储：Laravel Storage

前端

• 框架：Vue.js 3.x
• UI库：Element Plus
• 状态管理：Pinia
• 路由：Vue Router 4.x
• 构建工具：Vite

📦 安装部署

环境要求

• PHP >= 8.1
• Node.js >= 16.0
• MySQL >= 8.0
• Redis >= 6.0 (可选)
• Composer
• npm/yarn

后端安装

# 克隆项目
git clone <repository-url>
cd gcqets

# 安装后端依赖
cd backend
composer install

# 环境配置
cp .env.example .env
php artisan key:generate

# 数据库配置
# 编辑 .env 文件，配置数据库连接

# 运行迁移
php artisan migrate

# 运行种子数据
php artisan db:seed

# 启动服务
php artisan serve

前端安装

# 安装前端依赖
cd frontend
npm install

# 开发模式启动
npm run dev

# 生产构建
npm run build

🔧 配置说明

环境变量配置

# 应用配置
APP_NAME="实验教学管理系统"
APP_ENV=production
APP_DEBUG=false
APP_URL=http://localhost

# 数据库配置
DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=gcqets
DB_USERNAME=root
DB_PASSWORD=

# Redis配置 (可选)
REDIS_HOST=127.0.0.1
REDIS_PASSWORD=null
REDIS_PORT=6379

📚 使用指南

测试账号

系统管理员：sysadmin / 123456
学校管理员：dongcheng_principal / 123456
区域管理员：lianzhou_admin / 123456
教师账号：hh78@163.com / 123456

基本流程

1. 计划申报：教师创建实验计划并提交审核
2. 计划审批：管理员审核并批准实验计划
3. 执行记录：教师执行实验并填写记录
4. 记录审核：管理员审核实验记录
5. 数据统计：查看各类统计报表

功能测试

访问系统后，可以通过以下路径进行功能测试：

• /experiment-plans - 实验计划管理
• /experiment-records - 实验记录管理
• /experiment-review - 实验记录审核
• /system-test - 系统功能测试页面

🧪 系统测试

系统提供了完整的测试功能，访问 /system-test 页面可以进行：

• API接口测试：测试所有核心API接口
• 业务流程测试：测试完整的业务流程
• 性能测试：测试系统响应性能
• 集成测试：测试模块间的集成

📊 开发进度

• 基础架构搭建
• 用户权限系统
• 组织机构管理
• 实验目录管理
• 设备材料管理
• 实验计划申报功能
• 实验记录填报功能
• 实验记录审核功能
• 系统优化和测试
• 统一API响应格式
• 错误处理优化
• 性能优化
• 文档完善

🔒 安全特性

• 身份认证：JWT Token 认证
• 权限控制：基于角色的访问控制
• 数据验证：前后端双重验证
• 错误处理：统一的错误处理机制
• 输入过滤：防止XSS和SQL注入

📈 性能优化

• 数据库优化：合理的索引设计和查询优化
• 缓存策略：Redis缓存和查询结果缓存
• 前端优化：组件懒加载和代码分割
• API优化：响应压缩和分页查询

🤝 贡献指南

1. Fork 项目
2. 创建功能分支
3. 提交更改
4. 推送到分支
5. 创建 Pull Request

📄 许可证

本项目采用 MIT 许可证。

---

实验教学管理系统 - 让实验教学管理更简单、更高效！