校园宿舍报修管理系统

### 校园宿舍报修管理系统开发实现方案

#### 功能需求分析
校园宿舍报修管理系统旨在提高学校宿舍设施维护效率，方便学生及时上报维修请求并跟踪处理进度。该系统主要面向三类用户群体：

- **管理员**：负责整体系统的管理和监督工作，包括但不限于审核和分配工单给相应的维修人员。
- **宿管员**：接收来自学生的报修申请，并初步确认问题；安排技术人员上门服务以及反馈最终修复情况。
- **学生**：提交个人遇到的问题描述及其所在位置信息；查询自己所提报告的状态更新。

具体功能模块如下[^1]：
- 学生端可以发起新的报修请求、查看历史报修记录；
- 宿管端能够浏览待处理的任务列表、指派任务给特定工作人员；
- 维修工人接收到指定的工作订单后前往现场解决问题并将结果汇报上级；
- 系统还应具备消息通知机制来提醒相关人员关注重要事件进展。

#### 技术栈选择
考虑到项目的实际应用场景和技术可行性，推荐采用Java语言配合Spring Boot框架构建后台API接口，前端则可以选择Vue.js或其他轻量级JavaScript库来进行页面渲染。数据库方面MySQL是一个不错的选择，因为它稳定可靠且易于上手操作。

对于初学者而言，在决定是否着手此类项目之前确实应该先征询指导老师的意见，确保课题方向符合预期要求[^2]。

#### 数据模型设计
以下是几个核心实体的数据表结构示意（简化版），用于支撑上述业务逻辑流程：

| 表名 | 字段 |
|--|--|
| `student` (学生) | id, name, dormitory_id... |
| `repair_request` (报修请求)| id, student_id, description, status, created_at ... |
| `maintenance_staff` (维修人员)| id, name, specialty... |

CREATE TABLE IF NOT EXISTS repair_request (
    id INT AUTO_INCREMENT PRIMARY KEY,
    student_id INT NOT NULL,
    description TEXT NOT NULL,
    status ENUM('pending', 'in_progress', 'completed') DEFAULT 'pending',
    created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
    FOREIGN KEY(student_id) REFERENCES student(id)
);

#### API 接口定义
为了便于前后端分离式的应用架构搭建，这里给出部分RESTful风格的服务端点说明：

- POST `/api/requests/new`: 创建一个新的报修条目
- GET `/api/requests/{id}`: 获取某个具体的报修详情
- PUT `/api/requests/updateStatus/:id`: 更新某项任务状态至进行中或已完成
- DELETE `/api/requests/delete/:id`: 删除不再需要保留的历史数据记录

from flask import Flask, request, jsonify
import mysql.connector as sql

app = Flask(__name__)
db_config = {
    "host": "localhost",
    "user": "root",
    "password": "",
    "database": "dorm_repair"
}

@app.route('/api/requests/new', methods=['POST'])
def create_new_request():
    conn = sql.connect(**db_config)
    cursor = conn.cursor()
    
    data = request.get_json(force=True)

    query = """
        INSERT INTO repair_request (student_id, description)
        VALUES (%s,%s)
    """

    try:
        cursor.execute(query,(data['studentId'],data['description']))
        conn.commit()

        response_data={
            "message":"success",
            "requestId":cursor.lastrowid
        }
        
        return jsonify(response_data), 201
    
    except Exception as e:
        raise(e)
        return {"error":str(e)},500
        
if __name__ == '__main__':
    app.run(debug=True,port=8080)