核心内容摘要
细胞电生理仿真软件:GENESIS_(4).GENESIS的图形用户界面使用
下载源码「2026-宿舍管理系统」链接https://pan.quark.cn/s/502eae455030宿舍管理系统 (Dormitory Management System)企业级宿舍管理系统采用前后端分离架构支持三种角色系统管理员、宿管员、学生。
当前版本: v
0 (功能100%完整所有已知问题已修复)技术栈后端FastAPI
104 (Web框架)SQLAlchemy
0 (ORM)SQLite (数据库)Pydantic (数据验证)JWT (身份认证)Passlib bcrypt (密码加密)Uvicorn (ASGI服务器)前端Vue.js
7 (渐进式框架)Element UI
15 (组件库)Axios (HTTP请求)ECharts (数据可视化)功能特性✅ 管理员端 (admin.html)控制台数据统计、图表展示、关键指标概览楼栋管理CRUD操作、分配宿管员、楼栋统计房间管理房间列表、床位配置、状态管理、房间详情学生管理学生列表、入住管理、分配宿舍、学生详情宿管员管理宿管列表、重置密码、排班管理费用管理批量生成账单、缴费记录、费用统计、欠费提醒公告管理发布公告、置顶管理、公告统计✅ 宿管员端 (dormkeeper.html)工作台统计概览、待办事项、数据统计入住登记办理入住、分配床位、入住记录退宿管理办理退宿、释放床位、退宿记录报修处理接单、派工、完成报修、进度跟踪访客登记登记访客、状态管理、访客记录卫生检查房间卫生评分、检查记录、批量检查晚归记录晚归登记、记录查询、统计报表物品出入物品登记、出入记录、物品管理消息通知发送通知、消息记录、已读管理✅ 学生端 (student.html)我的宿舍查看宿舍信息、室友列表、房间详情报修申请提交报修、查看进度、报修历史费用查询查看账单、在线缴费、费用统计公告浏览查看系统公告、公告详情访客预约预约访客、查看记录、访客状态调宿申请提交调宿申请、查看进度、申请历史个人中心查看和编辑个人信息、修改密码意见反馈提交反馈、查看回复、反馈历史安装步骤
环境要求Python
8推荐使用虚拟环境
安装依赖cd backend pip install -r ../requirements.txt
初始化数据库cd backend python seed_data.py初始化脚本会创建1个管理员账号 (admin/admin
3个宿管员账号 (dormkeeper01~03/dk
50个学生账号 (student01~50/stu
2个楼栋男生A栋、女生B栋每栋6层每层5个房间共60个床位测试用的住宿记录、费用记录、公告等
启动后端服务cd backend python -m uvicorn main:app --reload --host
0.
0.
0 --port 8001服务将运行在 http://localhost:8001API文档http://localhost:8001/docs
访问前端直接在浏览器中打开前端HTML文件登录页frontend/index.html管理员端frontend/admin.html宿管员端frontend/dormkeeper.html学生端frontend/student.html测试账号管理员用户名admin密码admin123宿管员用户名dormkeeper01/dormkeeper02/dormkeeper03密码dk123学生用户名student01~student50密码stu123项目结构dormitory_system/ ├── backend/ │ ├── main.py # FastAPI入口 │ ├── database.py # 数据库连接 │ ├── models.py # SQLAlchemy模型16张表 │ ├── schemas.py # Pydantic验证模型 │ ├── auth.py # JWT认证、密码加密 │ ├── config.py # 配置文件 │ ├── seed_data.py # 初始化测试数据 │ └── routers/ │ ├── __init__.py │ ├── auth.py # 认证路由 │ ├── admin.py # 管理员API │ ├── dormkeeper.py # 宿管员API │ └── student.py # 学生API ├── frontend/ │ ├── asset/ # 静态资源 │ │ ├── vue.js │ │ ├── element-ui.js │ │ ├── element-ui.css │ │ ├── axios.min.js │ │ └── echarts.min.js │ ├── index.html # 登录页 │ ├── admin.html # 管理员端 │ ├── dormkeeper.html # 宿管员端 │ └── student.html # 学生端 ├── uploads/ # 文件上传目录 ├── requirements.txt # Python依赖 ├── 项目构建参考文档.txt # 需求文档 ├── README.md # 本文件 └── FIXES_SUMMARY.md # 问题修复
总结数据库模型系统包含16张数据表User用户表- 存储所有用户的基本信息Student学生表- 学生扩展信息DormKeeper宿管员表- 宿管员扩展信息、负责楼栋Building楼栋表- 楼栋基本信息Room房间表- 房间信息、床位配置Accommodation住宿记录表- 学生住宿历史RepairRequest报修表- 报修单和处理记录Fee费用表- 费用账单和缴费记录Announcement公告表- 系统公告Visitor访客表- 访客记录Inspection卫生检查表- 卫生检查记录LateRecord晚归记录表- 学生晚归记录ItemPass物品出入表- 物品出入记录RoomChangeRequest调宿申请表- 调宿申请和审批Notification通知表- 系统通知消息Feedback意见反馈表- 学生反馈和回复API接口认证接口POST /api/auth/login- 用户登录GET /api/auth/me- 获取当前用户信息POST /api/auth/change-password- 修改密码POST /api/auth/logout- 退出登录管理员接口 (/api/admin/)GET /dashboard- 控制台统计GET /building-stats- 楼栋统计GET /fee-stats- 费用统计GET/POST/PUT/DELETE /buildings- 楼栋管理GET/POST/PUT/DELETE /rooms- 房间管理GET /rooms/{room_id}/beds- 房间床位详情GET/POST/PUT/DELETE /students- 学生管理GET/POST/PUT/DELETE /dormkeepers- 宿管员管理GET/POST /fees- 费用管理GET/POST/PUT/DELETE /announcements- 公告管理宿管员接口 (/api/dormkeeper/)GET /dashboard- 工作台统计GET /buildings- 获取负责的楼栋列表 ✨GET /rooms- 获取负责的房间列表 ✨POST /check-in- 办理入住POST /check-out- 办理退宿GET /students/{student_no}/accommodation- 查询学生住宿信息GET/PUT /repairs- 报修处理GET/POST /visitors- 访客登记GET/POST /inspections- 卫生检查POST /inspections/batch- 批量卫生检查GET/POST /late-records- 晚归记录GET/POST /item-passes- 物品出入GET/POST /notifications- 消息通知POST /notifications/batch- 批量发送通知PUT /notifications/read- 标记消息已读学生接口 (/api/student/)GET /my-accommodation- 我的宿舍GET /roommates- 室友列表GET/POST /repairs- 报修申请GET/POST /fees- 费用查询GET /announcements- 公告浏览GET/POST /visitors- 访客预约GET/POST/DELETE /room-change-requests- 调宿申请GET/PUT /profile- 个人中心GET/POST /feedbacks- 意见反馈GET /notifications- 通知列表开发说明后端开发所有API返回统一格式ResponseModel或直接返回数据使用依赖注入获取当前用户current_user: User Depends(get_current_user)数据库查询使用SQLAlchemy ORM避免N1问题密码使用bcrypt加密存储JWT Token有效期24小时角色权限控制通过装饰器实现require_role(admin)前端开发使用Vue
x Element UI所有API请求使用axios携带JWT TokenToken存储在localStorage页面采用单文件组件形式统一的错误处理和消息提示安全特性✅ 密码加密存储bcrypt✅ JWT身份认证✅ Token过期时间24小时✅ 角色权限控制RBAC✅ SQL注入防护ORM✅ XSS防护✅ CORS配置最新更新 (v
1.