整体技术栈：HTML/CSS/JS + jQuery + Java Servlet + JDBC + MySQL，分层架构：Entity 实体层 → Dao 数据访问层 → Servlet 控制层，分为两大前端页面模块、配套全套后端代码。
一、整体项目分层结构
- entity（实体类）：映射数据库表，封装数据
- Dao（数据访问层）：纯 JDBC 操作 MySQL，增查改工单、维修分类
- servlet（控制层）：接收前端 AJAX / 表单请求，权限校验、调用 Dao、返回数据
- util 工具包：DBUtil 统一管理数据库连接与资源关闭
- webapp 前端页面：
- 分类管理页 main.html（管理员页面）
- 维修工工单列表页 orderList.html（维修人员页面）
二、分模块完整实现过程
模块 1：管理员页面（main.html + 分类管理后端代码）
1. 前端页面实现过程
- 搭建 HTML 骨架：页面标题、新增分类输入框、分类展示列表、返回登录按钮；
- CSS 样式：校园清新风格卡片布局、按钮 hover 交互、响应式适配；
- JS 交互逻辑：
- 页面加载 AJAX 请求
/getCategory，加载所有维修分类并渲染列表； - 输入分类名称，点击新增按钮提交 AJAX 到
addCategory接口； - 统一弹窗提示成功 / 失败、输入非空校验、无数据友好提示。
- 页面加载 AJAX 请求
2. 配套后端代码实现流程
- 实体
RepairCategory.java封装 id、categoryName 两个属性，对应数据库 repair_type 表，提供 get/set，用于存放查询出的分类数据。 - Dao 层
RepairCategoryDao.java- findAllCategory：获取数据库连接，查询 repair_type 全部分类，循环封装为 RepairCategory 对象集合返回；
- addCategory：接收前端传入分类名称，执行 INSERT 新增分类，返回受影响行数判断是否新增成功；
- finally 统一关闭连接、语句、结果集，防止数据库连接泄漏。
- 配套 Servlet（补充业务逻辑）
- GetCategoryServlet：调用 Dao 查询分类，手动拼接 JSON 返回前端渲染列表；
- AddCategoryServlet：接收前端分类名称，参数校验，调用 Dao 新增，弹窗提示新增结果。
3. 管理员页面核心作用
- 业务功能：系统后台维护维修故障分类（水电、空调、门窗等），新增统一工单类型；
- 数据支撑：给学生报修页、维修工工单页提供下拉选择数据；
- 权限定位：仅管理员使用，统一管理系统基础数据。
模块 2：维修工页面（orderList.html + 工单全套后端代码）
1. 前端页面实现过程
- HTML 结构：页面标题、工单表格容器、操作按钮（接单、填写备注、修改状态）；
- CSS：表格样式、不同状态文字区分、功能按钮配色区分；
- JS 核心交互：
- 页面加载校验登录状态，未登录跳转 login.html；
- AJAX 请求
/query接口获取全部工单，动态渲染表格； - 绑定按钮点击事件： 接单 → 请求
/receiveOrder； 新增 / 修改备注 → 请求/updateNote； 维修完成 → 请求/finishOrder； 手动修改工单状态 → 请求/updateStatus； - 自动根据工单状态禁用对应按钮，防止越权操作。
2. 配套后端完整代码实现流程
（1）实体类
- RepairType.java：封装维修类型 id、typeName，对应 repair_type 表；
- RepairOrder.java：工单核心实体，存储工单 id、报修学生、地址、故障描述、状态、维修员、维修备注，对应 repair_order 工单主表。
（2）Dao 数据访问层
- RepairTypeDao：findAllType () 查询全部故障类型，给前端下拉框提供数据；
- RepairOrderDao：findAllOrder () 查询所有工单，按 id 倒序（最新工单置顶），兼容数据库 NULL 空值、tinyblob 状态字段转换，封装为工单集合返回 Servlet。
（3）Servlet 控制层（全部工单业务接口）
- QueryOrderServlet（/query） 接收前端工单列表请求，调用 RepairOrderDao 查询全部工单，手动拼接 JSON，特殊字符转义防止前端解析报错，将数字状态转为中文文本（待接单 / 维修中 / 已完成 / 已取消）返回前端渲染表格。
- GetTypeServlet（/getType） 查询所有维修类型，返回 JSON，供页面筛选、展示故障名称。
- ReceiveOrderServlet（/receiveOrder）接单接口 ① Session 校验登录，限制仅维修工账号可操作； ② 校验工单 ID 参数非空、数字格式； ③ 更新 SQL：绑定当前登录维修工姓名，工单状态改为 1（维修中）； ④ 返回弹窗提示，页面刷新工单列表。
- FinishOrderServlet（/finishOrder）完成维修 校验登录，接收工单 ID 和维修备注，更新工单状态为 2（已完成），保存维修备注。
- UpdateNoteServlet（/updateNote）单独修改维修备注 仅更新 repair_note 字段，不改动工单状态，灵活补充维修记录。
- UpdateStatusServlet（/updateStatus）通用状态修改 限制仅允许修改为维修中、已完成、已取消三种合法状态，统一管控工单流转。
3. 维修工页面核心作用
- 工单可视化：展示全校所有报修工单，清晰查看报修人、地点、故障、处理进度；
- 完整维修业务流程：实现接单、填写维修记录、完工、取消工单全流程操作；
- 权限管控：后端校验登录身份、角色，避免游客 / 学生操作工单。
三、整套项目统一完整实现流程（从访问页面到数据库交互）
流程 1：管理员加载分类页面
- 浏览器访问 main.html；
- 页面 JS 发起 AJAX GET 请求
/getCategory； - GetCategoryServlet 接收请求，调用 RepairCategoryDao.findAllCategory ();
- Dao 执行 MySQL 查询 repair_type 表，封装分类实体集合；
- Servlet 将列表转为 JSON 字符串返回前端；
- JS 解析 JSON，循环生成分类卡片展示在页面；
- 管理员输入名称点击新增，POST 请求
addCategory； - AddCategoryServlet 校验参数，调用 Dao 新增分类；
- 数据库插入新分类，前端提示成功并自动刷新分类列表。
流程 2：维修工加载工单列表并接单维修
- 维修工登录后访问 orderList.html；
- 前端 JS 校验 Session 登录状态，未登录跳转登录页；
- AJAX 请求
/query获取全部工单； - QueryOrderServlet 调用 RepairOrderDao.findAllOrder () 查询工单；
- Dao 读取 repair_order 工单表，处理空值、状态字段，封装 RepairOrder 集合；
- Servlet 拼接 JSON 并转义特殊字符，返回前端；
- JS 循环渲染工单表格，根据 status 展示不同操作按钮；
- 点击接单按钮，请求
/receiveOrder； - ReceiveOrderServlet 校验维修工权限、工单 ID 参数；
- 执行 UPDATE SQL，绑定维修工姓名、状态改为维修中；
- 前端弹窗提示接单成功，重新请求 /query 刷新工单列表；
- 维修结束后，调用 finishOrder 接口，标记工单完成并填写维修备注。
四、整套项目代码整体核心作用
1. 业务层面
- 搭建完整校园报修闭环：管理员维护故障分类 → 学生提交报修工单 → 维修工查看、接单、处理工单；
- 工单全生命周期管理：0 待接单、1 维修中、2 已完成、3 已取消，覆盖全部维修场景；
- 分工明确：管理员负责基础数据维护，维修工负责工单处理，角色权限隔离。
2. 技术层面
- 分层解耦：实体层只存数据、Dao 只操作数据库、Servlet 只处理请求，修改页面不改动 SQL，修改数据库不影响前端；
- 安全保障：
- PreparedStatement 参数化 SQL，防止 SQL 注入；
- Session 登录校验，区分管理员 / 维修工角色，非法访问拦截；
- 所有接口参数非空、格式校验，避免程序异常崩溃；
- 兼容性处理：统一 UTF-8 编码解决中文乱码，数据库 NULL 值转空字符串、特殊 JSON 字符转义，前端无渲染报错；
- 资源优化：所有 JDBC 操作在 finally 块关闭连接、语句、结果集，避免数据库连接池耗尽；
- 低耦合前后端交互：前端 AJAX 异步请求，页面无整体刷新，操作体验流畅。
3. 项目价值
实现一套轻量化校园报修管理系统，满足校园日常设施维修登记、分配、跟踪需求，代码分层清晰、易于拓展，可新增分页、报修学生页面、管理员工单统计等功能。