1. 项目背景与核心价值
宿舍管理一直是高校后勤工作的重点和难点。传统的人工登记、纸质表格方式效率低下，数据更新不及时，查寝结果难以追溯。我在大四实习期间就亲眼目睹过宿管阿姨抱着一摞厚厚的登记本在楼道里奔走，遇到学生调换宿舍时往往要翻找半天记录。
这个小程序的设计初衷就是要解决这些痛点。通过移动端实现宿舍信息数字化管理，让宿管人员可以随时用手机完成查寝、报修、访客登记等工作。学生也能自主查询宿舍信息、提交报修申请，减少中间环节。整个系统基于微信小程序开发，无需安装额外App，扫码即用，特别适合高校这种用户群体高度集中的场景。
从技术角度看，这个项目完整覆盖了小程序前端开发、云数据库设计、后台接口编写等核心技能点。对于计算机相关专业的同学来说，既能展示技术能力，又具备实际应用价值，是非常理想的毕业设计选题方向。
2. 系统架构设计
2.1 技术选型分析
前端采用微信小程序原生框架，主要考虑三点：
- 微信生态普及度高，学生用户几乎都有微信，无需额外安装
- 原生框架性能优于uniapp等跨平台方案，适合表单类应用
- 官方文档完善，开发调试工具链成熟
后端选择Node.js + Express的组合，主要优势在于：
- 与小程序天然契合，都是JavaScript技术栈
- 轻量级框架适合学生项目快速开发
- 中间件机制方便实现权限控制等业务逻辑
数据库使用腾讯云开发提供的云数据库，省去了自建数据库服务器的麻烦。云开发还提供了现成的用户认证、存储等服务，可以显著降低开发难度。
2.2 功能模块划分
系统主要分为三大角色模块：
学生端功能：
- 个人信息查看与编辑
- 宿舍信息查询（室友、床位等）
- 在线报修与进度跟踪
- 访客预约登记
- 公告通知查看
宿管端功能：
- 学生信息管理（增删改查）
- 宿舍分配与调整
- 报修工单处理
- 查寝记录登记
- 数据统计与分析
管理员端功能：
- 账号权限管理
- 系统参数配置
- 数据备份恢复
- 操作日志审计
3. 核心功能实现细节
3.1 微信小程序前端开发
小程序端采用模块化开发结构：
pages/ ├── index/ // 首页 ├── login/ // 登录页 ├── repair/ // 报修模块 ├── visitor/ // 访客模块 └── my/ // 个人中心 components/ ├── navbar/ // 自定义导航 └── toast/ // 提示组件关键代码示例 - 报修表单提交：
// pages/repair/submit.js Page({ data: { formData: { type: '', // 报修类型 desc: '', // 问题描述 images: [] // 上传图片 } }, // 表单提交 submitForm() { wx.cloud.callFunction({ name: 'repair', data: this.data.formData }).then(res => { wx.showToast({ title: '提交成功' }) }).catch(err => { console.error('报修失败', err) }) } })注意事项：小程序上传图片需要配置合法域名，建议使用云开发存储功能避免此问题
3.2 后端接口设计
采用RESTful风格API设计，主要接口示例：
| 接口路径 | 方法 | 描述 | 权限 |
|---|---|---|---|
| /api/student | GET | 获取学生列表 | 宿管 |
| /api/student/:id | PUT | 更新学生信息 | 宿管 |
| /api/repair | POST | 提交报修单 | 学生 |
| /api/repair/:id | PATCH | 更新报修状态 | 宿管 |
权限控制中间件实现：
// middleware/auth.js const auth = async (ctx, next) => { const token = ctx.header.authorization if (!token) { ctx.status = 401 return } try { const decoded = verifyToken(token) ctx.state.user = decoded await next() } catch (err) { ctx.status = 403 } }3.3 数据库设计
主要集合结构设计：
students集合：
{ "_id": "ObjectId", "studentId": "20201123", "name": "张三", "gender": "男", "college": "计算机学院", "class": "软件工程2001", "room": "A501", "bed": 3, "status": 1 }repairs集合：
{ "_id": "ObjectId", "studentId": "20201123", "type": "水电维修", "desc": "卫生间水管漏水", "images": ["cloud://xxx.jpg"], "status": "待处理", "createdAt": "2023-05-10T08:00:00Z" }数据库索引优化：在studentId、room等查询频繁的字段上建立索引，提升查询性能
4. 开发中的难点与解决方案
4.1 权限控制实现
系统涉及三种角色权限，采用RBAC（基于角色的访问控制）模型实现。关键点在于：
- 登录时根据用户类型返回不同的token
- 中间件校验token中的角色信息
- 前端根据角色动态渲染菜单
角色权限对照表：
| 角色 | 可访问路由 | 可操作资源 |
|---|---|---|
| 学生 | /home, /repair | 自己的信息、报修记录 |
| 宿管 | /student, /dorm | 管理范围内的学生和宿舍 |
| 管理员 | /system, /log | 所有系统管理功能 |
4.2 数据统计可视化
宿管端需要展示宿舍入住率、报修处理时效等统计数据。使用ECharts实现动态图表：
// 获取报修统计 const pipeline = [ { $match: { createdAt: { $gte: startDate } } }, { $group: { _id: "$status", count: { $sum: 1 } } } ] const result = await db.collection('repairs').aggregate(pipeline)4.3 微信消息通知
重要操作需要触发微信模板消息通知，如：
- 报修单状态更新
- 访客预约审核结果
- 紧急通知公告
实现代码：
const sendTemplateMsg = async (openid, templateId, data) => { return wx.cloud.callFunction({ name: 'sendMessage', data: { openid, templateId, data } }) }5. 项目部署与上线
5.1 小程序发布流程
开发环境配置：
- 在微信公众平台申请小程序账号
- 配置服务器域名（如使用云开发可跳过）
- 下载开发者工具创建项目
代码上传审核：
# 通过CLI工具上传 npm run build && miniprogram-ci upload提交审核注意事项：
- 确保所有功能有完整的测试用例
- 准备详细的功能说明文档
- 敏感权限（如获取手机号）需要特别说明
5.2 后台服务部署
推荐两种部署方案：
方案一：云开发全托管
- 优点：无需关心服务器运维，自动扩容
- 缺点：长期使用可能有费用产生
方案二：自建服务器
# 使用PM2进程管理 npm install -g pm2 pm2 start app.js --name dorm-manager6. 毕业设计答辩要点
6.1 技术亮点展示
- 前后端分离架构设计
- 基于token的权限控制系统
- 微信生态深度集成（小程序+云开发）
- 数据可视化分析功能
6.2 答辩常见问题准备
Q：为什么选择微信小程序而不是原生App？ A：主要考虑用户使用成本，微信小程序无需安装，扫码即用，更适合校园场景。
Q：系统安全性如何保证？ A：采用HTTPS传输、接口签名验证、敏感数据加密存储等多重防护措施。
Q：如果用户量突然增加，系统如何应对？ A：云开发服务会自动扩容，自建服务器方案可以通过负载均衡和数据库读写分离来提升性能。
7. 源码使用指南
项目源码已托管在Gitee平台，包含完整的前后端代码和数据库初始化脚本。使用步骤：
- 克隆仓库
git clone https://gitee.com/example/dorm-manager.git- 安装依赖
cd client && npm install # 小程序端 cd server && npm install # 后端- 配置环境变量 创建
.env文件：
DB_URL=mongodb://localhost:27017/dorm WX_APPID=your_appid WX_SECRET=your_secret- 启动服务
npm run dev # 开发模式 npm start # 生产模式在实际开发中，我发现云开发的环境初始化特别重要。建议先在小程序后台开通云开发服务，然后在项目中初始化环境ID，否则会遇到各种奇怪的报错。数据库设计阶段要多考虑查询场景，适当添加索引可以显著提升性能。
