diff --git a/doc/process/weekly/week-10/group/meetingmintues-10.md b/doc/process/weekly/week-10/group/meetingmintues-10.md
new file mode 100644
index 0000000..aab7c3f
--- /dev/null
+++ b/doc/process/weekly/week-10/group/meetingmintues-10.md
@@ -0,0 +1,60 @@
+# 小组会议纪要-第10周
+
+## 会议记录概要
+
+**团队名称:** 1班-汪汪队
+**指导老师:** 肖雄仁
+**主 持 人:** 曹峻茂
+**记录人员:** 张红卫
+**会议主题:** 第10周任务规划与分工
+**会议地点:** 宿舍
+**会议时间:** 2025-11-24 12:30-13:30
+**纪录时间:** 2025-11-24 18:00
+**参与人员:** 曹峻茂、张红卫、罗月航、周竞由、王磊
+
+---
+
+## 会议内容
+
+### 1. 本周总体目标
+完成核心接口开发与前端功能实现,推进前后端联调工作
+
+### 2. 后端任务安排
+
+**后端2(核心接口扩展)**
+- 开发工单管理接口(抢单/拒单/提交维修结果)
+- 开发扫码用水接口和水质信息查询接口
+- 更新接口文档
+
+**后端1(模拟器优化与联调)**
+- 优化数据模拟器,支持手动触发异常数据和断网重连
+- 配合前端进行接口联调
+- 确保模拟数据能正常通过接口返回
+
+**后端3(测试与问题修复)**
+- 与前端全面对接接口联调工作
+- 协助解决联调过程中发现的问题
+
+### 3. 前端任务安排
+
+**前端1(Web端开发)**
+- 开发设备监控页面功能,实现数据实时展示和异常标红
+- 开发告警列表页面和工单列表页面
+- 与后端联调确保数据正常展示
+
+**前端2(APP端开发)**
+- 开发学生端扫码模块和水质信息页面
+- 开发维修端工单抢单/拒单功能和工单处理页面
+- 实现学生端扫码用水触发功能
+- 完成核心流程联调
+
+### 4. 团队协作要求
+- 加强前后端沟通,每日同步开发进度
+- 及时更新接口文档,确保信息同步
+- 重点关注联调过程中的数据一致性
+
+### 5. 预期交付物
+- 扩展后的核心接口代码及文档
+- 优化后的数据模拟器
+- Web端设备监控、告警列表、工单列表功能
+- APP端扫码、水质查看、抢单、用水等核心功能
\ No newline at end of file
diff --git a/doc/process/weekly/week-10/group/weekly-plan-10.md b/doc/process/weekly/week-10/group/weekly-plan-10.md
new file mode 100644
index 0000000..f6c7c62
--- /dev/null
+++ b/doc/process/weekly/week-10/group/weekly-plan-10.md
@@ -0,0 +1,36 @@
+# 小组周计划-第10周
+
+## 团队名称和起止时间
+
+**团队名称:** 软1-汪汪队
+**开始时间:** 2025-11-24
+**结束时间:** 2025-11-30
+
+## 本周任务计划安排
+
+
+| 序号 | 计划内容 | 执行人 | 情况说明 |
+|----|-------------------------------------------------|----------------|----------------------------|
+| 1 | 确定本周计划分工 | 全体组员 | 2023-11-24 开会确定计划以及团队分工 |
+| 2 | 继续完善mqtt数据生成和接收及存储 | 曹峻茂 | 完善mqtt报文与接口 |
+| 3 | 开发工单管理接口,扫码用水接口,水质信息查询接口 | 王磊 | 完善相关接口 |
+| 4 | 开发学生端扫码模块,水质信息页面,维修端工单抢单 / 拒单功能,工单处理页面,扫码用水触发功能 | 罗月航 | 完善app相关页面 |
+| 5 | 开发设备监控页面功能,告警列表页面,开发工单列表页面,与后端联调 | 张红卫 | 开发设备监控页面功能,告警列表页面,开发工单列表页面 |
+| 6 |开发告警触发逻辑,完成登录接口|周竞由| 开发告警触发逻辑,完成登录接口,与前端对接 |
+| 7 | 前后端联调 | 王磊,周竞由,罗月航,张红卫 | 前后端联调核心流程 |
+## 小结
+
+2. **沟通协作:** 小组成员应积极主动沟通,遇到困难及时寻求帮助,也可以主动向指导老师及研究生学长寻求建议。
+3. **学习安排:** 小组成员自行学习spring boot相关知识。
+4. **项目管理:** PM及时推进项目流程,确保项目有条不紊。
+
+---
+
+## 【注】
+
+1. 在小结一栏中写出希望得到如何的帮助,如讲座等;
+2. 请将个人计划和总结提前发给负责人;
+3. 周任务总结与计划是项目小组评分考核的重要依据,将直接记入平时成绩,请各位同学按要求认真填写并按时提交;
+4. PM综合本小组成员工作情况提交小组周计划、周总结报告,按时上传至代码托管平台。
+
+---
\ No newline at end of file
diff --git a/doc/process/weekly/week-10/group/weekly-summary-09.md b/doc/process/weekly/week-10/group/weekly-summary-09.md
new file mode 100644
index 0000000..68d051c
--- /dev/null
+++ b/doc/process/weekly/week-10/group/weekly-summary-09.md
@@ -0,0 +1,36 @@
+# 小组周总结-第9周
+
+## 团队名称和起止时间
+
+**团队名称:** 软1-汪汪队
+**开始时间:** 2025-11-17
+**结束时间:** 2025-11-23
+
+## 本周任务计划安排
+
+
+| 序号 | 总结内容 | 是否完成 | 情况说明 |
+|----|--------------|------|------------------------------|
+| 1 | 确定本周计划分工 | 完成 | 2023-11-17 开会确定计划以及团队分工 |
+| 2 | 完成mqtt数据生成和接收 | 进行中 | 完成mqtt数据生成和接收功能 |
+| 3 | 完成数据库相关基础接口设计和测试 | 进行中 | 完成数据库相关基础接口设计和测试 |
+| 4 | 开发维修 / 学生端登录页,完成学生端地图页面布局| 进行中 | 开发维修人员app和学生app登录页,完成学生端地图页面布局 |
+|5| 完成Web 端基础框架 + 登录页代码 | 进行中 | 完成管理平台基础框架 + 登录页代码 |
+|6|提交迭代开发计划第二稿| 完成 |根据反馈修改迭代开发计划|
+## 小结
+
+1. **增强自信心:** 小组成员应增强自信心,发挥想象力和创造力,在原型设计环节积极思考。
+2. **沟通协作:** 小组成员应积极主动沟通,遇到困难及时寻求帮助,也可以主动向指导老师及研究生学长寻求建议。
+3. **学习安排:** 小组成员仍处于软件开发专业知识的初步学习阶段,应合理安排自主学习时间,以便后续开发的顺利进行。
+4. **项目管理:** 原代码框架设计不合理,进行了多次修改
+
+---
+
+## 【注】
+
+1. 在小结一栏中写出希望得到如何的帮助,如讲座等;
+2. 请将个人计划和总结提前发给负责人;
+3. 周任务总结与计划是项目小组评分考核的重要依据,将直接记入平时成绩,请各位同学按要求认真填写并按时提交;
+4. PM综合本小组成员工作情况提交小组周计划、周总结报告,按时上传至代码托管平台。
+
+---
\ No newline at end of file
diff --git a/doc/process/weekly/week-10/members/caojunmao-weekly-plan-10.md b/doc/process/weekly/week-10/members/caojunmao-weekly-plan-10.md
new file mode 100644
index 0000000..2596cce
--- /dev/null
+++ b/doc/process/weekly/week-10/members/caojunmao-weekly-plan-10.md
@@ -0,0 +1,33 @@
+# 个人周计划-第10周
+
+## 姓名和起止时间
+
+**姓 名:** 曹峻茂
+**团队名称:** 软1-汪汪队
+**开始时间:** 2025-11-24
+**结束时间:** 2025-11-30
+
+
+## 本周任务计划安排
+| 序号 | 计划内容 | 协作人 | 情况说明 |
+|----|--------------------|-----|------------------------|
+| 1 | 确定分工 | 组员 | 2023-11-24 开会确定计划和团队分工 |
+| 2 | 继续完善mqtt数据生成和接收及存储 | 个人 | 优化模拟器,支持手动触发异常数据(如模拟漏水、TDS 超标),增加断网重连功能。 |
+|3|管理项目环境| 个人 |管理项目环境,协调开发|
+
+## 小结
+
+1. **学习需求:** 希望能有对于mqtt应用的教学;
+2. **知识储备:** 学习后续需要使用的知识,为后续的开发做准备;
+3. **文档撰写:** 完成迭代开发计划撰写。
+4. **代码实现** 参与mqtt协议相关设计
+---
+
+## 【注】
+
+1. 在小结一栏中写出希望得到如何的帮助,如讲座等;
+1. 请将个人计划和总结提前发给负责人;
+1. 周任务总结与计划是项目小组评分考核的重要依据,将直接记入平时成绩,请各位同学按要求认真填写并按时提交;
+1. 所有组员都需提交个人周计划、周总结文档,按时上传至代码托管平台;
+
+---
\ No newline at end of file
diff --git a/doc/process/weekly/week-10/members/caojunmao-weekly-summary-9.md b/doc/process/weekly/week-10/members/caojunmao-weekly-summary-9.md
new file mode 100644
index 0000000..1c2d118
--- /dev/null
+++ b/doc/process/weekly/week-10/members/caojunmao-weekly-summary-9.md
@@ -0,0 +1,36 @@
+# 个人周总结-第9周
+
+## 姓名和起止时间
+
+**姓 名:** 曹峻茂
+**团队名称:** 1班-汪汪队
+**开始时间:** 2025-11-17
+**结束时间:** 2025-11-23
+
+## 本周任务完成情况
+
+| 序号 | 总结内容 | 是否完成 | 情况说明 |
+|----| ------------------------------------------------ |------|--------------------------------------------------------------|
+| 1 | 确定分工 | 完成 | 2023-11-17 开会确定计划和团队分工 |
+| 2 | 完成mqtt数据生成和接收 | 进行中 | 完成mqtt数据生成和接收功能 |
+| 3 |提交迭代开发计划第二稿| 完成 |根据反馈修改迭代开发计划|
+
+## 对团队工作的建议
+
+1. **互助学习:** 小组成员应该根据自身的技能长短开展互帮互助的活动,共同努力提高小组成员的专业水平;
+2. **进度统一:** 团队成员尽量统一项目进度;
+
+## 小结
+
+1. **设计计划文档:** 完成了迭代开发计划第二稿;
+2. **项目管理:** 修改了代码框架,符合mvc;
+3. **团队协作**:与团队成员保持良好的沟通协作,确保设计方向与产品需求一致
+
+---
+
+## 【注】
+
+1. 在小结一栏中写出希望得到如何的帮助,如讲座等;
+2. 请将个人计划和总结提前发给负责人;
+3. 周任务总结与计划是项目小组评分考核的重要依据,将直接记入平时成绩,请各位同学按要求认真填写并按时提交;
+4. 所有组员都需提交个人周计划、周总结文档,上传至代码托管平台;
\ No newline at end of file
diff --git a/doc/process/weekly/week-10/members/luoyuehang-weekly-plan-10.md b/doc/process/weekly/week-10/members/luoyuehang-weekly-plan-10.md
new file mode 100644
index 0000000..811e483
--- /dev/null
+++ b/doc/process/weekly/week-10/members/luoyuehang-weekly-plan-10.md
@@ -0,0 +1,31 @@
+# 个人周计划-第10周
+
+## 姓名和起止时间
+
+**姓 名:** [罗月航]
+**团队名称:** 1班-汪汪队
+**开始时间:** 2025-12-24
+**结束时间:** 2025-12-30
+
+## 本周任务计划安排
+
+| 序号 | 计划内容 | 协作人 | 情况说明 |
+| ---- | -------- | ------ | -------- |
+| 1 | 完成登录页开发收尾 | 个人 | 完善登录表单验证逻辑,完成上周未完成的登录页面开发工作 |
+| 2 | 学生端扫码模块开发 | 个人 | 调用摄像头识别二维码,获取设备ID,实现扫码功能 |
+| 3 | 水质信息页面开发 | 个人 | 调用水质查询接口,展示水质数据,包括TDS值、水质等级等信息 |
+| 4 | 维修端工单抢单/拒单功能 | 个人 | 调用工单管理接口,实现工单抢单和拒单功能 |
+| 5 | 工单处理页面开发 | 个人 | 开发维修内容填写页面,支持维修记录提交 |
+| 6 | 学生端扫码用水功能 | 个人 | 调用扫码用水接口,实现用水触发功能 |
+| 7 | 与后端联调核心流程 | 后端开发 | 完成所有核心功能的接口联调,确保前后端数据交互正常 |
+| 8 | 联调报告编写 | 个人 | 整理联调过程中的问题和解决方案,编写联调报告 |
+
+
+## 小结
+
+1. **接口依赖**:需要后端提供完整的扫码、水质查询、工单管理、用水触发等接口文档;
+2. **设备权限**:需要处理摄像头调用权限,确保扫码功能在移动端的正常使用;
+3. **联调协调**:需要与后端开发同学协调联调时间,确保问题及时解决;
+4. **测试支持**:需要测试同学协助进行功能测试,特别是移动端兼容性测试;
+5. **时间安排**:本周开发任务较重,需要合理安排时间,确保核心功能按时完成。
+
diff --git a/doc/process/weekly/week-10/members/luoyuehang-weekly-summary-09.md b/doc/process/weekly/week-10/members/luoyuehang-weekly-summary-09.md
new file mode 100644
index 0000000..c431188
--- /dev/null
+++ b/doc/process/weekly/week-10/members/luoyuehang-weekly-summary-09.md
@@ -0,0 +1,30 @@
+# 个人周总结-第9周
+
+## 姓名和起止时间
+
+**姓 名:** [罗月航]
+**团队名称:** 1班-汪汪队
+**开始时间:** 2025-11-17
+**结束时间:** 2025-11-23
+
+## 本周任务完成情况
+
+| 序号 | 总结内容 | 是否完成 | 情况说明 |
+| ---- | -------- | -------- | -------- |
+| 1 | 开发维修/学生端登录页 | 部分完成 | 已完成登录页面的基础布局和样式设计,实现了用户类型切换功能 |
+| 2 | 实现登录表单验证 | 部分完成 | 完成了基础的表单结构搭建,验证逻辑正在开发中 |
+| 3 | 学生端地图页面布局 | 部分完成 | 完成了地图页面的整体框架布局和主要功能区域划分 |
+
+## 对团队工作的建议
+
+1. **API文档完善**:建议后端团队尽快提供完整的地图数据接口文档;
+2. **设计规范统一**:需要建立统一的设计组件库,提高开发效率;
+3. **代码审查机制**:建议建立代码审查流程,确保代码质量;
+4. **进度同步**:建议每周进行开发进度同步,及时解决遇到的问题。
+
+## 小结
+
+1. **基础框架搭建**:成功搭建了登录页和地图页面的基础框架结构;
+2. **界面效果实现**:登录页面的视觉效果基本达到设计预期,用户体验良好;
+3. **问题发现**:在地图API集成过程中遇到了一些技术难点,需要进一步研究解决;
+4. **进度评估**:整体进度符合预期,但部分功能需要延至下周完成;
diff --git a/doc/process/weekly/week-10/members/wanglei-weekly-plan-10.md b/doc/process/weekly/week-10/members/wanglei-weekly-plan-10.md
new file mode 100644
index 0000000..be37559
--- /dev/null
+++ b/doc/process/weekly/week-10/members/wanglei-weekly-plan-10.md
@@ -0,0 +1,26 @@
+# 个人周计划-第10周
+
+## 姓名和起止时间
+
+**姓 名:** 王磊
+**团队名称:** 1班-汪汪队
+**开始时间:** 2023-11-24
+**结束时间:** 2023-11-30
+
+
+## 本周任务计划安排
+
+|序号| 计划内容| 协作人 | 情况说明 |
+| ---- | ------ | ------| ------- |
+| 1 | 确定分工 | 组员 | 2025-11-24 开会细分确定团队分工, |
+| 2 | 开发工单管理接口、扫码用水接口、水质信息查询接口 | 个人 | 工单管理接口:包括抢单、拒单、提交维修结果等功能接;扫码用水接口:接收APP扫码请求,返回出水状态口;水质信息查询接口:据设备ID返回最新TDS值等水质信息 |
+
+
+## 小结
+
+1. **技术重点:** 基于完善后的数据库设计,扩展工单管理、扫码用水、水质查询等核心接口
+2. **协作重点:** 确保接口设计与前端需求一致,接口定义清晰可调用
+3. **学习重点:** 继续学习数据库优化和系统架构知识,提升接口开发效率
+
+---
+
diff --git a/doc/process/weekly/week-10/members/wanglei-weekly-summary-09.md b/doc/process/weekly/week-10/members/wanglei-weekly-summary-09.md
new file mode 100644
index 0000000..f525564
--- /dev/null
+++ b/doc/process/weekly/week-10/members/wanglei-weekly-summary-09.md
@@ -0,0 +1,34 @@
+
+# 个人周总结-第9周
+
+## 姓名和起止时间
+
+**姓 名:** 王磊
+**团队名称:** 1班-汪汪队
+**开始时间:** 2025-11-17
+**结束时间:** 2025-11-23
+
+## 本周任务完成情况
+
+序号 总结内容 是否完成 情况说明
+1 修改完善数据库 完成 根据优化后的数据库设计,完成了新增表结构与核心接口的修改与完善。
+2 根据新的项目目录结构来重新分类放置代码 完成 完成了新的项目框架的代码的存放。
+
+
+
+## 对团队工作的建议
+
+1. **任务跟进机制** 建议建立每周任务进度同步机制,便于及时调整与支持
+2. **接口联调准备** 提前准备接口文档,便于前后端协同开发与测试
+
+## 小结
+
+
+1.技术收获:通过修改数据库结构与新增接口,进一步掌握了数据库设计与系统接口的协同开发流程。
+
+2.协作收获:分工明确后团队协作效率有所提升,任务推进更加有序。
+
+3.后续重点:继续配合前后端开发,参与系统联调,确保数据接口与业务逻辑的一致性。
+
+---
+
diff --git a/doc/process/weekly/week-10/members/zhanghongwei-weekly-plan-10.md b/doc/process/weekly/week-10/members/zhanghongwei-weekly-plan-10.md
new file mode 100644
index 0000000..6992cfd
--- /dev/null
+++ b/doc/process/weekly/week-10/members/zhanghongwei-weekly-plan-10.md
@@ -0,0 +1,36 @@
+# 个人周计划-第10周
+
+## 姓名和起止时间
+
+**姓 名:** 张红卫
+**团队名称:** 软1-汪汪队
+**开始时间:** 2025-11-24
+**结束时间:** 2025-11-30
+
+## 本周任务计划安排
+
+| 序号 | 计划内容 | 执行人 | 情况说明 |
+| ---- | -------- | ------ | -------- |
+| 1 | 开发设备监控页面功能 | 个人 | 调用设备数据查询接口,实现数据实时展示和异常标红 |
+| 2 | 开发告警列表页面 | 个人 | 调用告警查询接口,展示异常信息 |
+| 3 | 开发工单列表页面 | 个人 | 调用工单查询接口,展示工单状态和设备信息 |
+| 4 | 前后端接口联调 | 个人+后端 | 与后端同学配合完成设备监控、告警、工单功能的联调测试 |
+
+## 技术学习重点
+
+1. **数据可视化**:学习实时数据展示和异常状态标识的实现方式
+2. **接口联调**:掌握多接口协同调用和数据一致性处理
+3. **错误处理**:完善前端错误处理和用户提示机制
+
+## 交付物清单
+
+- [ ] 设备监控页面功能代码
+- [ ] 告警列表页面功能代码
+- [ ] 工单列表页面功能代码
+- [ ] 接口联调测试报告
+
+## 小结
+
+1. **技术需求**:需要了解大数据量实时展示的性能优化方案;
+2. **协作需求**:依赖后端同学提供稳定的设备数据、告警、工单查询接口;
+3. **进度风险**:关注接口开发进度,如遇延迟需调整功能开发顺序。
\ No newline at end of file
diff --git a/doc/process/weekly/week-10/members/zhanghongwei-weekoly-summary-9.md b/doc/process/weekly/week-10/members/zhanghongwei-weekoly-summary-9.md
new file mode 100644
index 0000000..c233220
--- /dev/null
+++ b/doc/process/weekly/week-10/members/zhanghongwei-weekoly-summary-9.md
@@ -0,0 +1,28 @@
+# 个人周总结-第9周
+
+## 基本信息
+**姓 名:** 张红卫
+**团队名称:** 软1-汪汪队
+**总结周期:** 2025年11月17日 - 2025年11月23日
+
+## 本周任务完成情况
+
+### 已完成任务
+| 序号 | 任务内容 | 完成状态 | 成果输出 |
+|------|----------|----------|----------|
+| 1 | 用户管理页面原型转换 | 已完成 | 完成用户管理页面原型到实际页面的转换 |
+| 2 | Web端框架搭建 | 进行中 | 已选择前端框架,正在进行开发环境配置和基础项目结构搭建 |
+| 3 | 多角色登录页开发 | 进行中 | 登录功能尚未实现 |
+| 4 | 接口联调测试 | 未开始 | 等待后端接口准备 |
+
+## 主要成果与进展
+
+1. **技术实践方面**
+ - 完成了用户管理页面从原型到实际页面的转换
+ - 初步搭建了Web端基础框架
+
+2. **学习进展方面**
+ - 进一步熟悉了所选前端框架的基本使用方法
+
+## 总结
+本周按计划完成了用户管理页面原型的转换工作,但登录功能的开发尚未开始。后续需要加快Web端框架的搭建进度,并等待后端接口准备完成后,尽快开展登录功能的开发和接口联调工作。
\ No newline at end of file
diff --git a/doc/process/weekly/week-10/members/zhoujingyou-weekly-plan-10.md b/doc/process/weekly/week-10/members/zhoujingyou-weekly-plan-10.md
new file mode 100644
index 0000000..1524399
--- /dev/null
+++ b/doc/process/weekly/week-10/members/zhoujingyou-weekly-plan-10.md
@@ -0,0 +1,25 @@
+# 个人周计划-第10周
+
+## 姓名和起止时间
+**姓 名:** 周竞由
+**团队名称:** 软1-汪汪队
+**开始时间:** 2025-11-24
+**结束时间:** 2025-11-30
+**核心职责:** 接口测试执行 + 新接口用例编写 + 后端联调支持
+
+## 本周任务计划安排
+
+| 序号 | 计划内容 | 协作人 | 情况说明 |
+|----|--------------|---------|-----------------------------------|
+| 1 | 登录/告警接口缺陷复测 | 后端2 | 对上周记录的全部缺陷进行复测,补充异常参数与 Token 失效场景 |
+| 2 | 设计用户信息接口测试用例 | 后端2 | 覆盖权限控制、角色校验、非法入参、空数据返回等核心场景 |
+| 3 | 设计设备信息接口测试用例 | 后端1/后端2 | 包含设备状态、设备ID校验、数据字段完整性、异常处理等测试 |
+| 4 | 接口联调与逻辑验证支持 | 后端2 | 实际执行新增用例,记录缺陷并及时与后端确认与复现 |
+| 5 | 测试文档整理与版本更新 | 组员/指导老师 | 输出 V1.0 文档,补全用户&设备接口说明,提交规范化测试文档 |
+
+## 小结
+
+1. **任务目标:** 完成登录、告警及新接口(用户信息/设备信息)的完整测试链路,确保逻辑正确、返回一致且异常场景可控。
+2. **能力提升:** 深入练习接口测试设计方法,进一步掌握 Postman Collection 管理和脚本使用技巧。
+3. **协作重点:** 与后端保持每日同步,及时跟进接口变更与缺陷修复,确保联调顺畅。
+4. **下周展望:** 根据接口开发进度,逐步尝试自动化测试脚本编写,并准备进入前后端联合联调阶段。
diff --git a/doc/process/weekly/week-10/members/zhoujingyou-weekly-summary-09.md b/doc/process/weekly/week-10/members/zhoujingyou-weekly-summary-09.md
new file mode 100644
index 0000000..65bd7f1
--- /dev/null
+++ b/doc/process/weekly/week-10/members/zhoujingyou-weekly-summary-09.md
@@ -0,0 +1,41 @@
+# 个人周总结-第9周
+
+## 姓名和起止时间
+**姓 名:** 周竞由
+**团队名称:** 软1-汪汪队
+**开始时间:** 2025-11-17
+**结束时间:** 2025-11-23
+**核心职责:** 接口测试用例编写 + 后端2联调支持
+
+## 本周任务完成情况
+
+| 序号 | 计划内容 | 完成情况 | 说明 |
+|----|---------------|------|---------------------------------------|
+| 1 | 对接需求与接口规范确认 | 部分完成 | 与后端2及产品负责人完成登录/告警接口的业务确认,明确入参、出参及异常定义 |
+| 2 | 编写用户登录接口测试用例 | 部分完成 | 完成12个场景覆盖,包括多角色登录、账号密码错误、异常入参、账号锁定等情况 |
+| 3 | 编写告警生成接口测试用例 | 部分完成 | 完成自动告警、手动触发、设备离线、数据异常等场景的测试用例编写 |
+| 4 | 协助接口逻辑验证与问题定位 | 部分完成 | 执行全部用例,发现并记录若干逻辑缺陷,协助后端定位与复现问题 |
+| 5 | 提交测试用例与联调报告 | 已完成 | 按要求提交《测试用例文档》和《联调问题记录》,根据反馈完成补充与修订 |
+
+## 本周总结
+
+1. **阶段成果:**
+ 本周顺利完成登录接口和告警接口的测试用例设计与执行工作,测试覆盖率较高,识别了多项接口边界与逻辑性问题,为后端联调提供了可靠参考。
+
+2. **技术提升:**
+ - 熟悉 Postman 的基本使用流程、参数管理与环境变量;
+ - 学会将等价类划分、边界值分析等方法应用于接口用例设计;
+ - 进一步理解了接口业务流程与异常场景处理机制。
+
+3. **存在问题:**
+ - 对部分复杂业务场景理解不够深入,需要更多与后端沟通确认;
+ - 部分测试用例描述不够精简,后续需进一步规范化;
+ - 接口自动化测试经验不足,仍需学习脚本化测试流程。
+
+4. **改进方向:**
+ - 下周继续补充高风险场景与极端数据的测试;
+ - 尝试学习 Postman 的测试脚本与自动化能力;
+ - 优化文档结构,使缺陷记录更清晰、可复现性更强。
+
+5. **工作体会:**
+ 本周在与后端的联调合作中,逐渐熟悉接口测试的流程与规范,也意识到提前明确接口逻辑的重要性。通过大量实际测试,理解了如何将业务需求转化为可验证的测试场景,对整体开发流程有了更深入的认识。
diff --git a/doc/process/weekly/week-11/group/meetingmintues-11.md b/doc/process/weekly/week-11/group/meetingmintues-11.md
new file mode 100644
index 0000000..9b7c733
--- /dev/null
+++ b/doc/process/weekly/week-11/group/meetingmintues-11.md
@@ -0,0 +1,86 @@
+# 小组会议纪要-第11周
+
+## 会议记录概要
+
+**团队名称:** 软1-汪汪队
+**指导老师:** 肖雄仁
+**主 持 人:** 曹峻茂
+**记录人员:** 张红卫
+**会议主题:** 第11周任务规划与分工
+**会议地点:** 宿舍
+**会议时间:** 2025-12-1 12:30-13:30
+**纪录时间:** 2025-12-1 18:00
+**参与人员:** 曹峻茂、张红卫、罗月航、周竞由、王磊
+
+---
+
+## 会议内容
+
+### 1. 本周总体目标
+推进项目收尾阶段工作,完成模拟器优化、核心接口完善、前后端功能模块联调与代码优化,提升系统整体稳定性和用户体验。
+
+### 2. 后端任务安排
+
+**后端1(模拟器与MQTT接收端优化)**
+- 负责人:曹峻茂
+- 内容:
+ - 对模拟器进行最终优化,提升数据生成稳定性和真实性
+ - 增强MQTT接收端功能,提高数据传输的可靠性与性能
+ - 配合联调测试,确保模拟数据正常接入
+
+**后端2(数据统计与设备状态接口开发)**
+- 负责人:王磊
+- 内容:
+ - 开发数据统计接口:支持按设备、地区、时间统计用水量、告警次数
+ - 开发设备状态管理接口:实现在线/离线状态标记与查询
+ - 完善接口文档,确保接口规范清晰
+
+**后端3(权限控制与告警推送功能开发)**
+- 负责人:周竞由
+- 内容:
+ - 实现权限控制代码,确保系统操作的安全性
+ - 开发告警推送功能,支持实时告警通知
+ - 协助前后端联调,解决权限与推送相关问题
+
+### 3. 前端任务安排
+
+**前端1(APP端功能优化与页面开发)**
+- 负责人:罗月航
+- 内容:
+ - 完成APP端用水记录页面的代码编写与交互优化
+ - 完成APP端工单详情页面的代码编写与交互优化
+ - 配合后端联调,确保数据正常展示与交互流畅
+
+**前端2(Web端功能开发与优化)**
+- 负责人:张红卫
+- 内容:
+ - 完成Web端统计页面的代码编写与交互优化
+ - 完成Web端设备管理页面的代码编写与交互优化
+ - 与后端配合完成数据展示与操作逻辑的实现
+
+### 4. 联调与整合任务
+
+**前后端联调**
+- 参与人员:王磊、周竞由、罗月航、张红卫
+- 内容:
+ - 进行系统整体联调,重点验证核心业务流程
+ - 测试数据统计、设备管理、权限控制、告警推送等模块的协同工作
+ - 记录并解决联调过程中发现的问题
+
+### 5. 团队协作要求
+- 每日进行简短进度同步,及时沟通开发进展与阻塞问题
+- 如遇技术难题,及时召开临时会议或向指导老师、研究生学长求助
+- 保持接口文档的及时更新,确保前后端信息一致
+- 重点关注系统性能与用户体验,确保交付质量
+
+### 6. 预期交付物
+- 优化后的模拟器与MQTT接收端代码
+- 数据统计与设备状态管理接口代码及文档
+- 权限控制与告警推送功能代码
+- APP端用水记录、工单详情页面代码
+- Web端统计页面、设备管理页面代码
+- 前后端联调测试报告与问题记录
+
+### 7. 支持需求
+- 希望获得关于MQTT大规模数据传输性能优化的实战讲座或技术分享
+- 期待指导老师在权限管理、接口性能优化方面给予进一步指导
\ No newline at end of file
diff --git a/doc/process/weekly/week-11/group/week-plan-11.md b/doc/process/weekly/week-11/group/week-plan-11.md
new file mode 100644
index 0000000..c2d1af8
--- /dev/null
+++ b/doc/process/weekly/week-11/group/week-plan-11.md
@@ -0,0 +1,36 @@
+# 小组周计划-第11周
+
+## 团队名称和起止时间
+
+**团队名称:** 软1-汪汪队
+**开始时间:** 2025-12-1
+**结束时间:** 2025-12-7
+
+## 本周任务计划安排
+
+
+| 序号 | 计划内容 | 执行人 | 情况说明 |
+|----|--------------------------------------------------------|----------------|-------------------------------|
+| 1 | 确定本周计划分工 | 全体组员 | 2023-12-1 开会确定计划以及团队分工 |
+| 2 | 模拟器最终优化, MQTT 接收端增强 | 曹峻茂 | 模拟器最终优化, MQTT 接收端增强 |
+| 3 | 开发数据统计接口(按设备 / 地区 / 时间统计用水量、告警次数)、设备状态管理接口(在线 / 离线标记); | 王磊 | 完善相关接口 |
+| 4 | 完成APP 端用水记录 / 工单详情页面代码、交互优化代码 | 罗月航 | 完成APP 端用水记录 / 工单详情页面代码、交互优化代码 |
+| 5 | 完成 Web 端统计页面 / 设备管理页面代码、交互优化代码 | 张红卫 | Web 端统计页面 / 设备管理页面代码、交互优化代码 |
+| 6 | 权限控制代码、告警推送功能代码 |周竞由| 完成权限控制代码、告警推送功能代码 |
+| 7 | 前后端联调 | 王磊,周竞由,罗月航,张红卫 | 前后端联调核心流程 |
+## 小结
+
+1. **沟通协作:** 每日简短同步进度,遇到阻塞问题及时召开临时会议协商解决,可向指导老师及研究生学长寻求技术支持。
+2. **学习安排:** 结合项目需求深入学习权限管理和接口性能优化相关知识,分享学习笔记。
+3. **项目管理:** PM 每日跟踪任务进度,记录问题并推动解决,确保按计划推进。
+4. **帮助需求:** 希望能有关于 mqtt 大规模数据传输性能优化的实战讲座,助力解决数据传输稳定性问题。
+---
+
+## 【注】
+
+1. 在小结一栏中写出希望得到如何的帮助,如讲座等;
+2. 请将个人计划和总结提前发给负责人;
+3. 周任务总结与计划是项目小组评分考核的重要依据,将直接记入平时成绩,请各位同学按要求认真填写并按时提交;
+4. PM综合本小组成员工作情况提交小组周计划、周总结报告,按时上传至代码托管平台。
+
+---
\ No newline at end of file
diff --git a/doc/process/weekly/week-11/group/week-summary-10.md b/doc/process/weekly/week-11/group/week-summary-10.md
new file mode 100644
index 0000000..5610891
--- /dev/null
+++ b/doc/process/weekly/week-11/group/week-summary-10.md
@@ -0,0 +1,37 @@
+# 小组周总结-第10周
+
+## 团队名称和起止时间
+
+**团队名称:** 软1-汪汪队
+**开始时间:** 2025-11-24
+**结束时间:** 2025-11-30
+
+## 本周任务计划安排
+
+
+| 序号 | 总结内容 | 是否完成 | 情况说明 |
+|----|--------------|------|----------------------------|
+| 1 | 确定本周计划分工 | 完成 | 2023-11-24 开会确定计划以及团队分工 |
+| 2 | 继续完善mqtt数据生成和接收及存储 | 完成 | 完善mqtt报文与接口 |
+| 3 | 开发工单管理接口,扫码用水接口,水质信息查询接口 | 完成 | 完善相关接口 |
+| 4 | 开发学生端扫码模块,水质信息页面,维修端工单抢单 / 拒单功能,工单处理页面,扫码用水触发功能 | 进行中 | 完善app相关页面 |
+| 5 | 开发设备监控页面功能,告警列表页面,开发工单列表页面,与后端联调 | 进行中 | 开发设备监控页面功能,告警列表页面,开发工单列表页面 |
+| 6 |开发告警触发逻辑,完成登录接口| 进行中 | 开发告警触发逻辑,完成登录接口,与前端对接 |
+| 7 | 前后端联调 | 进行中 | 前后端联调核心流程 |
+## 小结
+
+1. **增强自信心:** 小组成员应增强自信心,发挥想象力和创造力,在原型设计环节积极思考。
+2. **沟通协作:** 小组成员应积极主动沟通,遇到困难及时寻求帮助,也可以主动向指导老师及研究生学长寻求建议。
+3. **学习安排:** 小组成员仍处于软件开发专业知识的初步学习阶段,应合理安排自主学习时间,以便后续开发的顺利进行。
+4. **项目管理:** 代码框架、依赖版本和jdk版本管理混乱导致浪费大量时间,需要改进。
+
+---
+
+## 【注】
+
+1. 在小结一栏中写出希望得到如何的帮助,如讲座等;
+2. 请将个人计划和总结提前发给负责人;
+3. 周任务总结与计划是项目小组评分考核的重要依据,将直接记入平时成绩,请各位同学按要求认真填写并按时提交;
+4. PM综合本小组成员工作情况提交小组周计划、周总结报告,按时上传至代码托管平台。
+
+---
\ No newline at end of file
diff --git a/doc/process/weekly/week-11/members/caojunmao-weekly-plan-11.md b/doc/process/weekly/week-11/members/caojunmao-weekly-plan-11.md
new file mode 100644
index 0000000..a54f06a
--- /dev/null
+++ b/doc/process/weekly/week-11/members/caojunmao-weekly-plan-11.md
@@ -0,0 +1,33 @@
+# 个人周计划-第11周
+
+## 姓名和起止时间
+
+**姓 名:** 曹峻茂
+**团队名称:** 软1-汪汪队
+**开始时间:** 2025-12-1
+**结束时间:** 2025-12-7
+
+
+## 本周任务计划安排
+| 序号 | 计划内容 | 协作人 | 情况说明 |
+|----|--------------------|-----|--------------------------------|
+| 1 | 确定分工 | 组员 | 2023-12-1 开会确定计划和团队分工 |
+| 2 | 模拟器最终优化, MQTT 接收端增强 | 个人 | 模拟器最终优化, MQTT 接收端增强 |
+|3|管理项目环境| 个人 | 管理项目环境,协调开发 |
+
+## 小结
+
+1. **学习需求:** 希望能有对于mqtt应用的教学;
+2. **知识储备:** 学习后续需要使用的知识,为后续的开发做准备;
+3. **文档撰写:** 完成迭代开发计划撰写。
+4. **项目管理** 管理项目环境和框架
+---
+
+## 【注】
+
+1. 在小结一栏中写出希望得到如何的帮助,如讲座等;
+1. 请将个人计划和总结提前发给负责人;
+1. 周任务总结与计划是项目小组评分考核的重要依据,将直接记入平时成绩,请各位同学按要求认真填写并按时提交;
+1. 所有组员都需提交个人周计划、周总结文档,按时上传至代码托管平台;
+
+---
\ No newline at end of file
diff --git a/doc/process/weekly/week-11/members/caojunmao-weekly-summary-10.md b/doc/process/weekly/week-11/members/caojunmao-weekly-summary-10.md
new file mode 100644
index 0000000..011d63b
--- /dev/null
+++ b/doc/process/weekly/week-11/members/caojunmao-weekly-summary-10.md
@@ -0,0 +1,36 @@
+# 个人周总结-第10周
+
+## 姓名和起止时间
+
+**姓 名:** 曹峻茂
+**团队名称:** 1班-汪汪队
+**开始时间:** 2025-11-24
+**结束时间:** 2025-11-30
+
+## 本周任务完成情况
+
+| 序号 | 总结内容 | 是否完成 | 情况说明 |
+|----| ------------------------------------------------ |------|--------------------------------------------------------------|
+| 1 | 确定分工 | 完成 | 2023-11-24 开会确定计划和团队分工 |
+| 2 | 继续完善mqtt数据生成和接收及存储 | 进行中 | 优化模拟器,支持手动触发异常数据(如模拟漏水、TDS 超标),增加断网重连功能。 |
+|3|管理项目环境|进行中|管理项目环境,协调开发|
+
+## 对团队工作的建议
+
+1. **互助学习:** 小组成员应该根据自身的技能长短开展互帮互助的活动,共同努力提高小组成员的专业水平;
+2. **进度统一:** 团队成员尽量统一项目进度;
+
+## 小结
+
+1. **设计计划文档:** 完成了迭代开发计划第二稿;
+2. **项目管理:** 修改了代码框架,符合mvc;
+3. **团队协作**:与团队成员保持良好的沟通协作,确保设计方向与产品需求一致
+
+---
+
+## 【注】
+
+1. 在小结一栏中写出希望得到如何的帮助,如讲座等;
+2. 请将个人计划和总结提前发给负责人;
+3. 周任务总结与计划是项目小组评分考核的重要依据,将直接记入平时成绩,请各位同学按要求认真填写并按时提交;
+4. 所有组员都需提交个人周计划、周总结文档,上传至代码托管平台;
\ No newline at end of file
diff --git a/doc/process/weekly/week-11/members/luoyuehang-weekly-plan-11.md b/doc/process/weekly/week-11/members/luoyuehang-weekly-plan-11.md
new file mode 100644
index 0000000..52dedc5
--- /dev/null
+++ b/doc/process/weekly/week-11/members/luoyuehang-weekly-plan-11.md
@@ -0,0 +1,32 @@
+# 个人周计划-第11周
+
+## 姓名和起止时间
+
+**姓 名:** [罗月航]
+**团队名称:** 1班-汪汪队
+**开始时间:** 2025-12-01
+**结束时间:** 2025-12-07
+
+## 本周任务计划安排
+
+| 序号 | 计划内容 | 协作人 | 情况说明 |
+| ---- | -------- | ------ | -------- |
+| 1 | 开发学生端用水记录页面 | 个人 | 实现个人用水量统计、水质历史数据查询、图表展示功能,包括日/周/月视图切换 |
+| 2 | 开发维修端工单处理详情页面 | 个人 | 实现维修照片上传、处理结果填写、工单状态更新、维修记录查看功能 |
+| 3 | 消息推送交互优化 | 个人 | 实现告警和工单提醒的消息推送展示、消息列表、已读未读状态管理 |
+| 4 | 扫码用水结果反馈优化 | 个人 | 优化扫码用水成功/失败的弹窗提示、错误原因展示、用户引导流程 |
+| 5 | 离线缓存功能实现 | 个人 | 实现无网络时查看历史数据的缓存机制,包括数据同步和冲突解决 |
+| 6 | 扫码接口联调修复 | 后端开发 | 配合后端修复扫码接口的问题,确保扫码功能稳定可靠 |
+| 7 | 工单操作接口联调 | 后端开发 | 调试工单抢单、处理、完成等操作的接口,确保业务流程顺畅 |
+| 8 | 消息推送接口联调 | 后端开发 | 调试实时消息推送的WebSocket连接,确保消息实时性和稳定性 |
+
+
+## 小结
+
+1. **接口支持**:需要后端提供完整的用水记录、工单详情、消息推送等接口文档;
+2. **测试数据**:需要真实的历史数据用于开发和测试用水记录页面;
+3. **性能考虑**:离线缓存需要考虑数据量大小和同步策略;
+4. **用户体验**:消息推送需要考虑不同场景下的通知方式和用户打扰程度。
+
+
+
diff --git a/doc/process/weekly/week-11/members/luoyuehang-weekly-summary-10.md b/doc/process/weekly/week-11/members/luoyuehang-weekly-summary-10.md
new file mode 100644
index 0000000..4db7a06
--- /dev/null
+++ b/doc/process/weekly/week-11/members/luoyuehang-weekly-summary-10.md
@@ -0,0 +1,36 @@
+# 个人周总结-第10周
+
+## 姓名和起止时间
+
+**姓 名:** [罗月航]
+**团队名称:** 1班-汪汪队
+**开始时间:** 2025-12-24
+**结束时间:** 2025-12-30
+
+## 本周任务完成情况
+
+| 序号 | 总结内容 | 是否完成 | 情况说明 |
+| ---- | -------- | -------- | -------- |
+| 1 | 完成登录页开发收尾 | 完成 | 完善了登录表单验证逻辑,完成了登录页面的开发工作 |
+| 2 | 登录接口对接 | 完成 | 成功对接后端登录接口,实现了真实的用户认证功能 |
+| 3 | 学生端扫码模块开发 | 进行中 | 已完成扫码模块的基础框架,正在集成摄像头调用功能 |
+| 4 | 水质信息页面开发 | 进行中 | 已完成页面布局设计,正在对接水质查询接口 |
+| 5 | 维修端工单抢单/拒单功能 | 进行中 | 受接口开发进度影响,此功能暂未开始 |
+| 6 | 工单处理页面开发 | 进行中 | 需要工单抢单功能完成后进行 |
+| 7 | 学生端扫码用水功能 | 进行中 | 需要扫码模块完成后进行 |
+| 8 | 与后端联调核心流程 | 部分完成 | 已完成登录功能的联调,其他功能接口正在对接中 |
+
+## 对团队工作的建议
+
+1. **进度同步机制**:建议建立更频繁的前后端进度同步机制,及时解决阻塞问题;
+2. **测试环境准备**:需要准备稳定的测试环境,便于前后端联调;
+3. **代码规范统一**:在接口对接过程中发现需要统一错误处理和数据格式规范。
+
+## 小结
+
+1. **核心功能完成**:成功完成了登录功能的完整对接,为后续功能开发奠定了基础;
+2. **接口对接经验**:通过登录接口的对接,积累了前后端联调的实际经验;
+3. **进度评估**:虽然部分功能因接口依赖而滞后,但整体进度仍在可控范围内;
+4. **协作改进**:认识到需要更紧密的前后端协作,计划建立每日站会机制;
+
+
diff --git a/doc/process/weekly/week-11/members/wanglei-weekly-plan-11.md b/doc/process/weekly/week-11/members/wanglei-weekly-plan-11.md
new file mode 100644
index 0000000..cdb3483
--- /dev/null
+++ b/doc/process/weekly/week-11/members/wanglei-weekly-plan-11.md
@@ -0,0 +1,25 @@
+# 个人周计划-第11周
+
+## 姓名和起止时间
+
+**姓 名:** 王磊
+**团队名称:** 1班-汪汪队
+**开始时间:** 2023-12-1
+**结束时间:** 2023-12-7
+
+## 本周任务计划安排
+
+| 序号 | 计划内容 | 协作人 | 情况说明 |
+| --- | ----- | --- | ----------------------------------------------------- |
+| 1 | 确定分工 | 组员 | 2025-12-1 开会细分确定团队分工, |
+| 2 | 接口完善 | 个人 | 开发数据统计接口(按设备 / 地区 / 时间统计用水量、告警次数)、设备状态管理接口(在线 / 离线标记) |
+| 3 | 数据层优化 | 个人 | 传感器历史数据分页查询、大字段索引调整、查询性能优化(响应时间≤300ms) |
+| 4 | 联调支持 | 个人 | 配合前端修复接口参数、返回格式、权限校验问题 |
+
+## 小结
+
+1. **技术重点:** 多维度统计接口设计与实现;大数据量分页查询性能优化;设备状态实时管理机制
+2. **协作重点:** 明确统计数据结构便于前端展示;统一接口规范,完善文档;建立联调问题快速响应机制
+3. **学习重点:** 掌握分页查询、索引设计的性能优化技巧;学习多维度聚合统计的高效实现方案;提升前后端接口对接的问题解决能力;学习接口性能分析和调优方法
+
+---
diff --git a/doc/process/weekly/week-11/members/wanglei-weekly-summary-10.md b/doc/process/weekly/week-11/members/wanglei-weekly-summary-10.md
new file mode 100644
index 0000000..49da25e
--- /dev/null
+++ b/doc/process/weekly/week-11/members/wanglei-weekly-summary-10.md
@@ -0,0 +1,40 @@
+# 个人周计划-第十周
+
+## 姓名和起止时间
+
+**姓 名:** 王磊
+**团队名称:** 1班-汪汪队
+**开始时间:** 2025-11-24
+
+**结束时间:** 2025-11-30
+
+## 本周任务计划安排
+
+| 序号 | 总结内容 | 是否完成 | 情况说明 |
+| --- | ---------- | ------------------------------ | --------------------------------------------------------------------------------------------------- |
+| 1 | 开发工单管理接口 | 完成 | 已实现完整的工单管理接口,包括:抢单接口(grabOrder);拒单接口(rejectOrder);提交维修结果接口(submitRepairResult);获取可抢工单列表接口 ;获取我的工单接口 |
+| 2 | 开发扫码用水接口 | 完成 | 已实现扫码用水全流程接口:扫码获取终端信息接口;扫码用水记录接口;自动更新终端使用统计数据 |
+| 3 | 开发水质信息查询接口 | 完成 | 已实现水质信息查询接口:根据设备ID返回最新TDS值(原水、纯水、矿化水);返回水质等级、滤芯寿命、设备状态等完整信息 |
+
+## 对团队工作的建议
+
+1.**接口联调协作** 建议建立接口联调检查清单,确保前后端数据格式一致
+
+2.**代码审查机制** 建议定期进行代码审查,提升代码质量和团队协作效率
+
+3.**测试环境准备** 建议尽早搭建测试环境,便于接口功能验证
+
+## 小结
+
+1. **技术收获** 掌握了完整的工单状态流转的业务逻辑实现,熟悉了扫码用水业务的数据处理流程
+2. **协作收获** 通过明确分工,个人任务执行更加专注高效,与团队成员就接口设计进行充分沟通,确保前后端对接顺畅
+3. **后续重点** 配合前端进行接口联调和测试验证;根据实际使用反馈优化接口设计
+
+---
+
+## 【注】
+
+1. 在小结一栏中写出希望得到如何的帮助,如讲座等;
+2. 请将个人计划和总结提前发给负责人;
+3. 周任务总结与计划是项目小组评分考核的重要依据,将直接记入平时成绩,请各位同学按要求认真填写并按时提交;
+4. 所有组员都需提交个人周计划、周总结文档,按时上传至代码托管平台;
diff --git a/doc/process/weekly/week-11/members/zhanghongwei-weekly-plan-11.md b/doc/process/weekly/week-11/members/zhanghongwei-weekly-plan-11.md
new file mode 100644
index 0000000..2735480
--- /dev/null
+++ b/doc/process/weekly/week-11/members/zhanghongwei-weekly-plan-11.md
@@ -0,0 +1,37 @@
+# 个人周计划-第11周
+
+## 姓名和起止时间
+
+**姓 名:** 张红卫
+**团队名称:** 软1-汪汪队
+**开始时间:** 2025-12-1
+**结束时间:** 2025-12-7
+
+## 本周任务计划安排
+
+| 序号 | 计划内容 | 执行人 | 情况说明 |
+| ---- | -------- | ------ | -------- |
+| 1 | 完成 Web 端统计页面功能开发与交互优化 | 个人 | 实现用水量、告警次数等数据的图表化展示,支持按设备/地区/时间筛选 |
+| 2 | 完成 Web 端设备管理页面功能开发与交互优化 | 个人 | 实现设备增删改查、状态标记、批量操作等功能,优化操作流程 |
+| 3 | 参与前后端联调工作 | 个人 + 后端 | 与后端(王磊、周竞由等)协作,完成统计与设备管理模块的接口联调与测试 |
+| 4 | 性能优化与异常处理完善 | 个人 | 针对大数据展示场景优化渲染性能,完善导航栏异常跳转与权限控制逻辑 |
+
+## 技术学习重点
+
+1. **数据可视化与图表集成**:学习使用图表库(如 ECharts)实现统计数据的可视化展示
+2. **复杂表单与批量操作**:掌握设备管理中复杂表单验证与批量操作的实现方式
+3. **性能优化实战**:进一步探索虚拟滚动、分页加载、接口缓存等前端性能优化方案
+4. **权限控制集成**:配合后端权限接口,实现前端路由与操作权限的控制逻辑
+
+## 交付物清单
+
+- [ ] Web 端统计页面功能代码(含图表展示与筛选交互)
+- [ ] Web 端设备管理页面功能代码(含增删改查与状态管理)
+- [ ] 前后端联调测试记录与问题清单
+- [ ] 性能优化与权限控制相关代码更新
+
+## 小结
+
+1. **技术需求**:需进一步掌握大数据量前端展示的性能调优方案,尤其是虚拟滚动与分页加载的实现;
+2. **协作需求**:依赖后端提供稳定的数据统计接口、设备状态管理接口及权限控制接口;
+3. **进度风险**:若接口开发延迟或权限逻辑不明确,可能影响前端页面功能的完整实现。
\ No newline at end of file
diff --git a/doc/process/weekly/week-11/members/zhanghongwei-weekly-summary-10.md b/doc/process/weekly/week-11/members/zhanghongwei-weekly-summary-10.md
new file mode 100644
index 0000000..b3f75fd
--- /dev/null
+++ b/doc/process/weekly/week-11/members/zhanghongwei-weekly-summary-10.md
@@ -0,0 +1,41 @@
+# 个人周总结-第10周
+
+## 姓名和起止时间
+**姓 名:** 张红卫
+**团队名称:** 软1-汪汪队
+**开始时间:** 2025-11-24
+**结束时间:** 2025-11-30
+**核心职责:** 前端界面开发 + 前后端联调支持
+
+## 本周任务完成情况
+
+| 序号 | 计划内容 | 完成情况 | 说明 |
+|------|------------------------|----------|------|
+| 1 | 开发设备监控页面功能 | 进行中 | 成功调用设备数据查询接口,实现数据实时展示与异常状态标红功能 |
+| 2 | 开发告警列表页面 | 进行中 | 完成告警查询接口对接,支持告警信息列表展示与状态筛选 |
+| 3 | 开发工单列表页面 | 进行中 | 调用工单查询接口,实现工单状态、设备信息的可视化展示 |
+| 4 | 前后端接口联调 | 进行中 | 与后端合作完成设备监控、告警、工单等功能的接口联调与测试 |
+| 5 | 登录界面接口对接与导航栏跳转 | 已完成 | 完成登录接口的对接实现,并优化导航栏路由跳转逻辑,提升用户体验 |
+
+## 本周总结
+
+1. **阶段成果:**
+ 本周设备监控、告警列表、工单列表三个页面的开发还在进行中,登录界面接口对接与导航栏跳转功能也已实现。
+
+2. **技术提升:**
+ - 掌握了前端实时数据展示与异常标识的实现方法;
+ - 熟悉了多接口协同调用与数据一致性处理技巧;
+ - 提升了前端错误处理与用户提示机制的设计能力。
+
+3. **存在问题:**
+ - 大数据量实时展示时出现轻微卡顿,需进一步优化渲染性能;
+ - 部分接口响应时间较长,影响页面加载体验;
+ - 导航栏跳转逻辑在异常情况下处理不够完善。
+
+4. **改进方向:**
+ - 下周针对大数据展示场景进行性能优化,如虚拟滚动、分页加载等;
+ - 推动后端优化接口响应速度,必要时引入缓存机制;
+ - 完善导航栏异常跳转与权限控制逻辑。
+
+5. **工作体会:**
+ 本周在前端界面开发与接口联调过程中,进一步理解了前后端协作的流程与关键点。通过实际开发与调试,提升了解决实际问题的能力,尤其在用户界面与交互逻辑方面积累了宝贵经验。同时,认识到性能优化与异常处理在前端开发中的重要性,后续需持续加强相关能力建设。
\ No newline at end of file
diff --git a/doc/process/weekly/week-11/members/zhoujingyou-weekly-plan-11.md b/doc/process/weekly/week-11/members/zhoujingyou-weekly-plan-11.md
new file mode 100644
index 0000000..0407465
--- /dev/null
+++ b/doc/process/weekly/week-11/members/zhoujingyou-weekly-plan-11.md
@@ -0,0 +1,22 @@
+# 个人周计划-第11周
+
+## 姓名和起止时间
+
+**姓 名:** 周竞由
+**团队名称:** 软1-汪汪队
+**开始时间:** 2025-12-1
+**结束时间:** 2025-12-7
+
+## 本周任务计划安排
+| 序号 | 计划内容 | 协作人 | 情况说明 |
+|----|-----------------------------|-----|-------------------------------------|
+| 1 | 权限细化:实现接口级权限控制(学生/维修人员/管理员) | 个人 | 完成三类角色的接口访问范围划分,并调试接口权限中间件 |
+| 2 | 告警功能完善:告警分级、推送、历史查询接口 | 个人 | 完成一般/紧急告警标识,Web/APP 告警提醒联调,支持告警历史查询 |
+| 3 | 全流程测试:设备异常→告警→工单→维修→恢复 | 个人 | 模拟真实业务流程,检查各环节是否能顺畅衔接,实现流程闭环验证 |
+
+## 小结
+
+1. **功能深化:** 完成权限体系的细化与告警功能模块的强化;
+2. **联调优化:** 多端联动测试告警推送与工单处理流程;
+3. **问题排查:** 在全流程测试中识别逻辑断点并进行修复;
+4. **系统打磨:** 为后续功能拓展与迭代做好系统级准备。
diff --git a/doc/process/weekly/week-11/members/zhoujingyou-weekly-summary-10.md b/doc/process/weekly/week-11/members/zhoujingyou-weekly-summary-10.md
new file mode 100644
index 0000000..9d25658
--- /dev/null
+++ b/doc/process/weekly/week-11/members/zhoujingyou-weekly-summary-10.md
@@ -0,0 +1,42 @@
+# 个人周总结-第10周
+
+## 姓名和起止时间
+**姓 名:** 周竞由
+**团队名称:** 软1-汪汪队
+**开始时间:** 2025-11-24
+**结束时间:** 2025-11-30
+**核心职责:** 接口测试执行 + 新接口用例编写 + 后端联调支持
+
+## 本周任务完成情况
+
+| 序号 | 计划内容 | 完成情况 | 说明 |
+|----|--------------|------|------------------------------------------|
+| 1 | 登录/告警接口缺陷复测 | 已完成 | 完成上周遗留 6 项缺陷的复测,新增 Token 过期、异常入参等场景验证 |
+| 2 | 用户信息接口测试用例设计 | 已完成 | 编写 8 条用例,覆盖权限校验、非法 Token、角色匹配、用户不存在等情况 |
+| 3 | 设备信息接口测试用例设计 | 已完成 | 编写 10 条用例,覆盖设备状态字段、设备 ID 合法性、空数据处理、异常输入等 |
+| 4 | 联调支持与问题定位 | 部分完成 | 本周定位 3 个接口结构问题,已修复 2 项,剩余 1 项仍在跟进中 |
+| 5 | 测试文档整理与版本更新 | 已完成 | 输出《核心接口测试规范 V1.0》,补充用户/设备接口文档与用例结构 |
+
+## 本周总结
+
+1. **阶段成果:**
+ 本周在完成原有接口复测的基础上,扩展了用户信息和设备信息接口的测试范围。用例设计更系统、覆盖更全面,为后续联调提供了完整参考。
+
+2. **技术提升:**
+ - 掌握 Postman 环境变量、Collection 管理等功能;
+ - 初步尝试 pre-request 脚本,实现 Token 自动更新;
+ - 对系统用户角色逻辑与设备状态结构理解更深入。
+
+3. **存在问题:**
+ - 接口文档变更频繁,部分信息需多次确认;
+ - 多接口的链路关系复杂,对告警链路仍需进一步梳理;
+ - 自动化测试仍处在基础阶段,尚未形成可复用脚本;
+ - 部分测试记录描述不够统一,需要进一步规范格式。
+
+4. **改进方向:**
+ - 完善接口变更通知机制,减少反馈滞后;
+ - 对告警流程进行单独的逻辑梳理,补充关键场景用例;
+ - 逐步优化缺陷记录格式,使复现步骤更清晰。
+
+5. **工作体会:**
+ 本周的工作让我更深刻体会到接口测试不仅是验证接口是否“能跑”,更是确保逻辑、结构、异常处理的全面可靠。通过频繁的联调沟通,理解到了规范化文档的重要性,也意识到提前确认接口规则能大幅减少返工。整体来说,本周在测试方法和业务理解上都取得了明显进步。
diff --git a/doc/process/weekly/week-12/group/meetingmintues-12.md b/doc/process/weekly/week-12/group/meetingmintues-12.md
new file mode 100644
index 0000000..429f8ec
--- /dev/null
+++ b/doc/process/weekly/week-12/group/meetingmintues-12.md
@@ -0,0 +1,91 @@
+# 小组会议纪要-第12周
+
+## 会议记录概要
+
+**团队名称:** 软1-汪汪队
+**指导老师:** 肖雄仁
+**主 持 人:** 曹峻茂
+**记录人员:** 张红卫
+**会议主题:** 第12周任务规划与分工
+**会议地点:** 宿舍
+**会议时间:** 2025-12-8 12:30-13:30
+**记录时间:** 2025-12-8 18:00
+**参与人员:** 曹峻茂、张红卫、罗月航、周竞由、王磊
+
+---
+
+## 会议内容
+
+### 1. 本周总体目标
+完成前后端核心模块联调与问题闭环,推进云服务器与数据库环境部署,为项目最终交付做好技术准备与系统集成。
+
+### 2. 后端任务安排
+
+**后端1(云服务器与数据库环境配置)**
+- **负责人:** 曹峻茂
+- **内容:**
+ - 完成云服务器环境搭建与系统初始化
+ - 配置生产数据库环境,完成数据迁移与备份策略
+ - 部署后端服务并完成初步连通性测试
+
+**后端2(联调支持与接口问题修复)**
+- **负责人:** 王磊
+- **内容:**
+ - 配合前端完成统计模块、设备管理模块接口联调
+ - 修复接口响应慢、数据不一致等遗留问题
+ - 协助优化核心业务接口性能
+
+**后端3(权限与告警模块联调支持)**
+- **负责人:** 周竞由
+- **内容:**
+ - 完成权限控制模块前后端联调,确保权限逻辑一致
+ - 支持告警推送功能与前端展示联调
+ - 协助修复联调中发现的权限与推送相关Bug
+
+### 3. 前端任务安排
+
+**前端1(APP端联调与功能验证)**
+- **负责人:** 罗月航
+- **内容:**
+ - 完成APP端用水记录、工单详情页面与后端接口联调
+ - 进行功能验证与用户体验优化
+ - 配合后端修复数据展示与交互问题
+
+**前端2(Web端联调与性能优化)**
+- **负责人:** 张红卫
+- **内容:**
+ - 完成Web端统计页面、设备管理页面与后端接口联调
+ - 实施性能优化方案(分页、虚拟滚动、缓存等)
+ - 验证权限控制与异常处理逻辑
+
+### 4. 联调与整合任务
+
+**前后端联调**
+- **参与人员:** 王磊、周竞由、罗月航、张红卫
+- **内容:**
+ - 集中解决第11周联调遗留问题
+ - 完成所有核心业务流程端到端验证
+ - 输出联调测试报告与问题修复清单
+
+### 5. 团队协作要求
+- 每日晨会同步进展,晚前提交当日工作小结
+- 联调问题统一记录至共享表格,明确责任人与解决时间
+- 环境配置与部署过程中保持沟通,确保各环节顺利衔接
+- 重点关注系统稳定性与数据一致性,为交付做好准备
+
+### 6. 预期交付物
+- 云服务器与生产数据库环境部署完成
+- 前后端联调问题修复清单与测试报告
+- 所有核心功能模块完成联调并稳定运行
+- 性能优化与权限控制验证通过记录
+- 项目部署文档初稿
+
+### 7. 支持需求
+- 希望获得关于云环境部署与数据库性能调优的指导
+- 期待老师在系统集成与交付前测试方面给予建议
+- 如遇部署或联调难题,可向研究生学长请求技术支援
+
+---
+
+**会议确认:**
+全体与会人员确认会议内容与分工无异议。
diff --git a/doc/process/weekly/week-12/group/week-plan-12.md b/doc/process/weekly/week-12/group/week-plan-12.md
new file mode 100644
index 0000000..8577cb4
--- /dev/null
+++ b/doc/process/weekly/week-12/group/week-plan-12.md
@@ -0,0 +1,30 @@
+# 小组周计划-第12周
+
+## 团队名称和起止时间
+
+**团队名称:** 软1-汪汪队
+**开始时间:** 2025-12-8
+**结束时间:** 2025-12-14
+
+## 本周任务计划安排
+
+
+| 序号 | 计划内容 | 执行人 | 情况说明 |
+|----|--------------------------------------------------------|----------------|------------------------|
+| 1 | 确定本周计划分工 | 全体组员 | 2023-12-8 开会确定计划以及团队分工 |
+| 2 | 前后端联调 | 王磊,周竞由,罗月航,张红卫 | 前后端联调解决核心问题 |
+|3|配置云服务器和数据库环境|曹峻茂|配置云服务器和数据库环境|
+## 小结
+
+1. **沟通协作:** 每日简短同步进度,遇到阻塞问题及时召开临时会议协商解决,可向指导老师及研究生学长寻求技术支持。
+2. **学习安排:** 结合项目需求深入学习权限管理和接口性能优化相关知识,分享学习笔记。
+3. **项目管理:** PM 每日跟踪任务进度,记录问题并推动解决,确保按计划推进。
+
+## 【注】
+
+1. 在小结一栏中写出希望得到如何的帮助,如讲座等;
+2. 请将个人计划和总结提前发给负责人;
+3. 周任务总结与计划是项目小组评分考核的重要依据,将直接记入平时成绩,请各位同学按要求认真填写并按时提交;
+4. PM综合本小组成员工作情况提交小组周计划、周总结报告,按时上传至代码托管平台。
+
+---
\ No newline at end of file
diff --git a/doc/process/weekly/week-12/group/week-summary-11.md b/doc/process/weekly/week-12/group/week-summary-11.md
new file mode 100644
index 0000000..e36b0c7
--- /dev/null
+++ b/doc/process/weekly/week-12/group/week-summary-11.md
@@ -0,0 +1,37 @@
+# 小组周总结-第11周
+
+## 团队名称和起止时间
+
+**团队名称:** 软1-汪汪队
+**开始时间:** 2025-12-1
+**结束时间:** 2025-12-7
+
+## 本周任务计划安排
+
+
+| 序号 | 总结内容 | 是否完成 | 情况说明 |
+|----|--------------|------|----------------------------|
+| 1 | 确定本周计划分工 | 完成 | 2023-11-24 开会确定计划以及团队分工 |
+| 2 | 继续完善mqtt数据生成和接收及存储 | 完成 | 完善mqtt报文与接口 |
+| 3 | 开发工单管理接口,扫码用水接口,水质信息查询接口 | 完成 | 完善相关接口 |
+| 4 | 开发学生端扫码模块,水质信息页面,维修端工单抢单 / 拒单功能,工单处理页面,扫码用水触发功能 | 完成 | 完善app相关页面 |
+| 5 | 开发设备监控页面功能,告警列表页面,开发工单列表页面,与后端联调 | 完成 | 开发设备监控页面功能,告警列表页面,开发工单列表页面 |
+| 6 |开发告警触发逻辑,完成登录接口| 完成 | 开发告警触发逻辑,完成登录接口,与前端对接 |
+| 7 | 前后端联调 | 进行中 | 前后端联调核心流程 |
+## 小结
+
+
+1. **沟通协作:** 小组成员应积极主动沟通,遇到困难及时寻求帮助,也可以主动向指导老师及研究生学长寻求建议。
+2. **学习安排:** 小组成员仍处于软件开发专业知识的初步学习阶段,应合理安排自主学习时间,以便后续开发的顺利进行。
+3. **项目管理:** 代码框架、依赖版本和jdk版本管理混乱导致浪费大量时间,需要改进。
+
+---
+
+## 【注】
+
+1. 在小结一栏中写出希望得到如何的帮助,如讲座等;
+2. 请将个人计划和总结提前发给负责人;
+3. 周任务总结与计划是项目小组评分考核的重要依据,将直接记入平时成绩,请各位同学按要求认真填写并按时提交;
+4. PM综合本小组成员工作情况提交小组周计划、周总结报告,按时上传至代码托管平台。
+
+---
\ No newline at end of file
diff --git a/doc/process/weekly/week-12/members/caojunmao-weekly-plan-12.md b/doc/process/weekly/week-12/members/caojunmao-weekly-plan-12.md
new file mode 100644
index 0000000..4ddd63b
--- /dev/null
+++ b/doc/process/weekly/week-12/members/caojunmao-weekly-plan-12.md
@@ -0,0 +1,32 @@
+# 个人周计划-第11周
+
+## 姓名和起止时间
+
+**姓 名:** 曹峻茂
+**团队名称:** 软1-汪汪队
+**开始时间:** 2025-12-8
+**结束时间:** 2025-12-14
+
+
+## 本周任务计划安排
+| 序号 | 计划内容 | 协作人 | 情况说明 |
+|----|--------------------|----|-----------------------|
+| 1 | 确定分工 | 组员 | 2023-12-8 开会确定计划和团队分工 |
+|3|配置云服务器和数据库环境| 个人 |配置云服务器和数据库环境|
+
+## 小结
+
+
+1. **知识储备:** 学习后续需要使用的知识,为后续的开发做准备;
+2. **文档撰写:** 完成迭代开发计划撰写。
+3. **项目管理** 管理项目环境和框架
+---
+
+## 【注】
+
+1. 在小结一栏中写出希望得到如何的帮助,如讲座等;
+1. 请将个人计划和总结提前发给负责人;
+1. 周任务总结与计划是项目小组评分考核的重要依据,将直接记入平时成绩,请各位同学按要求认真填写并按时提交;
+1. 所有组员都需提交个人周计划、周总结文档,按时上传至代码托管平台;
+
+---
\ No newline at end of file
diff --git a/doc/process/weekly/week-12/members/caojunmao-weekly-summary-11.md b/doc/process/weekly/week-12/members/caojunmao-weekly-summary-11.md
new file mode 100644
index 0000000..a1bcf04
--- /dev/null
+++ b/doc/process/weekly/week-12/members/caojunmao-weekly-summary-11.md
@@ -0,0 +1,35 @@
+# 个人周总结-第11周
+
+## 姓名和起止时间
+
+**姓 名:** 曹峻茂
+**团队名称:** 1班-汪汪队
+**开始时间:** 2025-12-1
+**结束时间:** 2025-12-7
+
+## 本周任务完成情况
+
+| 序号 | 总结内容 | 是否完成 | 情况说明 |
+|----| ------------------------------------------------ |------|--------------------------------------------------------------|
+| 1 | 确定分工 | 完成 | 2023-11-24 开会确定计划和团队分工 |
+| 2 | 继续完善mqtt数据生成和接收及存储 | 完成 | 优化模拟器,支持手动触发异常数据(如模拟漏水、TDS 超标),增加断网重连功能。 |
+|3|管理项目环境| 进行中 |管理项目环境,协调开发|
+
+## 对团队工作的建议
+
+1. **互助学习:** 小组成员应该根据自身的技能长短开展互帮互助的活动,共同努力提高小组成员的专业水平;
+2. **进度统一:** 团队成员尽量统一项目进度;
+
+## 小结
+
+1. **项目管理:** 协调开发进度和前后端同步
+2. **团队协作**:与团队成员保持良好的沟通协作,确保设计方向与产品需求一致
+
+---
+
+## 【注】
+
+1. 在小结一栏中写出希望得到如何的帮助,如讲座等;
+2. 请将个人计划和总结提前发给负责人;
+3. 周任务总结与计划是项目小组评分考核的重要依据,将直接记入平时成绩,请各位同学按要求认真填写并按时提交;
+4. 所有组员都需提交个人周计划、周总结文档,上传至代码托管平台;
\ No newline at end of file
diff --git a/doc/process/weekly/week-12/members/luoyuehang-weekly-plan-12.md b/doc/process/weekly/week-12/members/luoyuehang-weekly-plan-12.md
new file mode 100644
index 0000000..4a2e0b6
--- /dev/null
+++ b/doc/process/weekly/week-12/members/luoyuehang-weekly-plan-12.md
@@ -0,0 +1,30 @@
+# 个人周计划-第12周
+
+## 姓名和起止时间
+
+**姓 名:** [罗月航]
+**团队名称:** 1班-汪汪队
+**开始时间:** 2025-12-08
+**结束时间:** 2025-12-14
+
+## 本周任务计划安排
+
+| 序号 | 计划内容 | 协作人 | 情况说明 |
+| ---- | -------- | ------ | -------- |
+| 1 | 运维APP工单功能联调 | 后端开发 | 调试工单创建、抢单、处理、完成等完整业务流程接口 |
+| 2 | 运维APP设备监控联调 | 后端开发 | 调试设备数据实时获取、告警推送、状态更新等接口 |
+| 3 | 学生端扫码功能联调 | 后端开发 | 调试扫码用水、水质查询、设备识别等核心功能接口 |
+| 4 | 学生端用水记录联调 | 后端开发 | 调试个人用水量统计、历史记录查询、数据可视化接口 |
+| 5 | 联调问题记录与修复 | 后端开发 | 记录联调过程中的问题并协同修复,确保功能稳定 |
+
+
+## 小结
+
+1. **联调协调**:需要与后端团队协调联调时间和环境,确保联调效率;
+2. **测试数据**:需要准备充分的测试数据覆盖各种业务场景;
+3. **问题追踪**:需要建立有效的问题追踪机制,确保问题及时解决;
+4. **性能关注**:在联调过程中需要关注接口响应时间和前端性能表现;
+5. **错误处理**:需要测试各种异常情况下的错误处理和用户提示;
+6. **移动端适配**:需要确保联调功能在不同移动设备上的兼容性;
+
+
diff --git a/doc/process/weekly/week-12/members/luoyuehang-weekly-summary-11.md b/doc/process/weekly/week-12/members/luoyuehang-weekly-summary-11.md
new file mode 100644
index 0000000..c0a596e
--- /dev/null
+++ b/doc/process/weekly/week-12/members/luoyuehang-weekly-summary-11.md
@@ -0,0 +1,36 @@
+# 个人周总结-第11周
+
+## 姓名和起止时间
+
+**姓 名:** [罗月航]
+**团队名称:** 1班-汪汪队
+**开始时间:** 2025-12-01
+**结束时间:** 2025-12-07
+
+## 本周任务完成情况
+
+| 序号 | 总结内容 | 是否完成 | 情况说明 |
+| ---- | -------- | -------- | -------- |
+| 1 | 运维人员APP页面样式优化 | 完成 | 对所有运维端页面进行了视觉统一和交互优化,提升了用户体验 |
+| 2 | 学生端页面样式优化 | 完成 | 优化了学生端所有页面的视觉效果和布局结构,确保界面美观易用 |
+| 3 | 登录功能接口对接 | 完成 | 成功对接后端登录接口,实现用户认证、权限验证和会话管理 |
+| 4 | 注册功能接口对接 | 完成 | 完成用户注册接口对接,支持新用户账号创建和信息验证 |
+| 5 | 响应式设计完善 | 完成 | 确保所有页面在不同屏幕尺寸下的良好显示效果 |
+
+## 对团队工作的建议
+
+1. **样式规范统一**:建议建立团队统一的设计规范文档,包括颜色、字体、间距等;
+2. **组件库建设**:建议逐步建立前端组件库,提高开发效率和一致性;
+3. **接口错误处理**:建议规范接口错误码和错误信息,便于前端统一处理用户提示;
+4. **性能监控**:建议引入前端性能监控工具,及时发现和解决性能问题。
+
+## 小结
+
+1. **视觉体验提升**:通过系统的样式优化,运维人员APP和学生端的视觉体验得到显著改善;
+2. **接口对接成功**:登录注册功能与后端API成功对接,用户认证流程完整可靠;
+3. **设计一致性**:统一了两端应用的设计语言,保持了产品体验的一致性;
+4. **技术难点攻克**:解决了移动端适配、接口错误处理、加载状态管理等技术难点;
+5. **团队协作**:与后端开发团队紧密协作,接口对接过程高效顺利;
+6. **质量保障**:在样式优化的同时,确保了功能完整性和用户体验的平衡;
+7. **后续重点**:接下来将重点进行功能测试和性能优化,确保系统稳定运行。
+
diff --git a/doc/process/weekly/week-12/members/wanglei-weekly-plan-12.md b/doc/process/weekly/week-12/members/wanglei-weekly-plan-12.md
new file mode 100644
index 0000000..3e05111
--- /dev/null
+++ b/doc/process/weekly/week-12/members/wanglei-weekly-plan-12.md
@@ -0,0 +1,23 @@
+# 个人周计划-第12周
+
+## 姓名和起止时间
+
+**姓 名:** 王磊
+**团队名称:** 1班-汪汪队
+**开始时间:** 2023-12-8
+**结束时间:** 2023-12-14
+
+## 本周任务计划安排
+
+| 序号 | 计划内容 | 协作人 | 情况说明 |
+| --- | ---- | --- | ---------------------- |
+| 1 | 确定分工 | 组员 | 2025-12-8 开会细分确定团队分工, |
+| 2 | 联调支持 | 组员 | 配合前端完成接口联调问题,完成第一版迭代开发 |
+
+## 小结
+
+1. **技术重点:** 接口联调问题持续修复与支持
+2. **协作重点:** 加强与前端的沟通协作机制,参与接口联调复盘与总结
+3. **学习重点:** 学习接口性能分析和调优方法,提升联调问题响应与解决效率
+
+---
diff --git a/doc/process/weekly/week-12/members/wanglei-weekly-summary-11.md b/doc/process/weekly/week-12/members/wanglei-weekly-summary-11.md
new file mode 100644
index 0000000..a03040b
--- /dev/null
+++ b/doc/process/weekly/week-12/members/wanglei-weekly-summary-11.md
@@ -0,0 +1,40 @@
+# 个人周计划-第十一周
+
+## 姓名和起止时间
+
+**姓 名:** 王磊
+**团队名称:** 1班-汪汪队
+**开始时间:** 2025-12-1
+
+**结束时间:** 2025-12-7
+
+## 本周任务计划安排
+
+| 序号 | 总结内容 | 是否完成 | 情况说明 |
+| --- | ----- | ---- | ------------------------------------------ |
+| 1 | 接口完善 | 完成 | 完成数据统计接口开发(按设备/地区/时间统计用水量、告警次数)、设备状态管理接口开发 |
+| 2 | 数据层优化 | 完成 | 完成传感器历史数据分页查询优化、索引调整,响应时间优化至≤300ms |
+| 3 | 联调支持 | 进行中 | 配合前端完成参数、格式、权限校验等接口联调问题修复 |
+
+## 对团队工作的建议
+
+1.****建议建立接口联调检查清单**** 确保前后端数据格式和参数一致性,减少联调阶段问题
+
+2.****建议加强文档更新机制**** 接口变更后及时同步更新接口文档,便于协作和后续维护
+
+3.****建议建立性能监控机制**** 对关键接口进行性能监控,及时发现并处理性能瓶颈
+
+## 小结
+
+1. **技术收获** 深入理解了多维度统计接口的设计与实现方法
+2. **协作收获** 通过明确分工提升了任务执行效率
+3. **后续重点** 继续配合前端进行联调和测试
+
+---
+
+## 【注】
+
+1. 在小结一栏中写出希望得到如何的帮助,如讲座等;
+2. 请将个人计划和总结提前发给负责人;
+3. 周任务总结与计划是项目小组评分考核的重要依据,将直接记入平时成绩,请各位同学按要求认真填写并按时提交;
+4. 所有组员都需提交个人周计划、周总结文档,按时上传至代码托管平台;
diff --git a/doc/process/weekly/week-12/members/zhanghongwei-weekly-plan-12.md b/doc/process/weekly/week-12/members/zhanghongwei-weekly-plan-12.md
new file mode 100644
index 0000000..5ad5f0d
--- /dev/null
+++ b/doc/process/weekly/week-12/members/zhanghongwei-weekly-plan-12.md
@@ -0,0 +1,89 @@
+# 个人周计划-第十二周
+
+## 基本信息
+
+**姓 名:** 张红卫
+**团队名称:** 软1-汪汪队
+**开始时间:** 2025-12-8
+**结束时间:** 2025-12-14
+
+---
+
+## 本周任务计划安排
+
+| 序号 | 计划内容 | 执行人 | 情况说明 |
+|------|----------|--------|----------|
+| 1 | Web端统计页面联调与优化 | 个人 | 与王磊协作完成统计接口联调,优化图表加载性能,完善筛选交互 |
+| 2 | Web端设备管理页面联调与优化 | 个人 | 与周竞由协作完成设备管理接口联调,实现权限控制与批量操作功能 |
+| 3 | 前后端联调支持 | 个人 + 后端团队 | 参与团队联调,修复接口调用异常、数据展示不一致等问题 |
+| 4 | 前端性能优化实施 | 个人 | 实施分页加载、虚拟滚动方案,优化大数据场景下的页面渲染性能 |
+| 5 | 权限控制与异常处理完善 | 个人 | 配合后端完成权限逻辑对齐,优化导航栏与页面异常跳转处理 |
+
+---
+
+## 技术学习与实施重点
+
+### 1. 联调协作能力提升
+- 掌握前后端接口调试与问题定位方法
+- 学习使用Postman等工具进行接口测试与数据验证
+
+### 2. 性能优化实战深化
+- 实施虚拟滚动完整方案,优化大数据列表展示
+- 探索前端缓存策略与懒加载机制
+- 学习使用Chrome DevTools进行性能分析与优化
+
+### 3. 权限系统集成实践
+- 完成路由级与操作级权限控制
+- 实现动态菜单与按钮权限控制
+- 学习RBAC权限模型在前端的应用
+
+### 4. 异常处理与用户体验
+- 完善各类异常状态下的用户提示
+- 优化页面加载失败的重试与降级机制
+- 实现友好的错误页面和加载状态
+
+---
+
+## 交付物清单
+
+- [ ] 联调完成的统计页面代码(含性能优化)
+- [ ] 联调完成的设备管理页面代码(含权限控制)
+- [ ] 前后端联调问题修复记录
+- [ ] 性能优化实施方案文档
+- [ ] 权限控制测试验证报告
+- [ ] 每日工作进展记录
+
+---
+
+## 协作依赖与风险说明
+
+### 协作依赖
+1. **接口依赖**
+ - 依赖王磊提供稳定、性能优化的统计查询接口
+ - 依赖周竞由提供完整的权限控制接口规范
+ - 需要设备管理相关接口的稳定支持
+
+2. **环境依赖**
+ - 需要曹峻茂部署的测试环境支持联调验证
+ - 需要稳定的开发环境和版本控制支持
+
+3. **流程依赖**
+ - 需要罗月航在APP端配合进行跨端流程验证
+ - 需要团队成员及时沟通接口变更
+
+---
+
+## 小结与期望
+
+### 本周目标
+完成Web端所有核心页面的前后端联调,实现性能优化与权限控制,确保功能稳定可用。
+
+### 团队协作建议
+1. 建议每日固定时间进行联调进度同步
+2. 建立接口变更通知机制,减少沟通成本
+3. 统一问题记录与跟踪方式,提高解决效率
+
+### 支持需求
+1. 希望获得前端性能优化(特别是大数据渲染)的实战指导
+2. 期待老师在系统集成测试方面提供方法指导
+3. 如遇技术难题,可向研究生学长请求支持
diff --git a/doc/process/weekly/week-12/members/zhanghongwei-weekly-summary-11.md b/doc/process/weekly/week-12/members/zhanghongwei-weekly-summary-11.md
new file mode 100644
index 0000000..c447f69
--- /dev/null
+++ b/doc/process/weekly/week-12/members/zhanghongwei-weekly-summary-11.md
@@ -0,0 +1,77 @@
+# 个人周总结-第十一周
+
+## 基本信息
+
+**姓 名:** 张红卫
+**团队名称:** 软1-汪汪队
+**起止时间:** 2025-12-1 至 2025-12-7
+**核心职责:** 前端界面开发 + 前后端联调支持
+
+---
+
+## 本周任务完成情况
+
+| 序号 | 计划内容 | 完成状态 | 详细说明 |
+|------|------------------------------------------------|----------|------------------------------------------------------------------------------------------------------------------|
+| 1 | 完成 Web 端统计页面功能开发与交互优化 | 进行中 | 已完成 ECharts 图表框架集成,实现用水量、告警次数等基础图表展示;筛选功能已初步实现,接口数据对接正在调试中 |
+| 2 | 完成 Web 端设备管理页面功能开发与交互优化 | 进行中 | 页面结构与基础表单组件已完成,支持设备增删改查;批量操作功能正在开发中,接口调试同步进行 |
+| 3 | 参与前后端联调工作 | 进行中 | 与王磊、周竞由等后端成员保持每日沟通,统计模块接口已部分联调完成,设备管理模块接口正在逐步对接 |
+| 4 | 性能优化与异常处理完善 | 进行中 | 已引入分页加载机制优化大数据展示;权限控制逻辑与后端对齐中;导航栏异常跳转处理逻辑已优化并测试 |
+
+---
+
+## 本周总结
+
+### 一、任务进展概述
+本周主要工作集中在 **统计页面** 和 **设备管理页面** 的前后端联调阶段。目前两个页面的基础功能框架已搭建完成,核心接口正在有序对接中。性能优化与权限控制方案已初步实施,但整体进度仍处于联调阶段,尚未完全完成。
+
+### 二、技术实现与收获
+1. **性能优化实践**
+ - 引入分页加载机制,初步缓解大数据渲染压力
+
+2. **权限控制集成**
+ - 配合后端权限接口,搭建前端路由权限控制基础框架
+ - 完善导航栏跳转与操作权限校验逻辑
+
+3. **复杂业务处理**
+ - 实现设备管理中的复杂表单验证与状态管理
+ - 掌握批量操作的前端实现方式
+
+### 三、遇到的问题与挑战
+1. **接口响应延迟**
+ - 部分统计查询接口响应时间较长,影响页面加载体验
+
+2. **权限逻辑不一致**
+ - 前端权限控制逻辑需与后端进一步对齐,部分页面权限拦截尚未生效
+
+3. **性能瓶颈**
+ - 大数据量图表渲染仍存在轻微卡顿,需进一步优化
+
+4. **联调协作效率**
+ - 接口变更沟通不够及时,影响前端调试进度
+
+### 四、协作建议
+1. **接口规范明确**
+ - 建议后端提供完整的接口文档与示例数据
+ - 建立接口变更的版本管理机制
+
+2. **联调流程优化**
+ - 每周安排专门联调会议
+ - 建立联调问题跟踪清单
+
+3. **性能监控机制**
+ - 共同建立接口性能监控体系
+ - 定期进行性能测试与优化
+
+### 五、工作总结与展望
+本周在前后端联调过程中,进一步深入理解了系统整体架构与业务流程。通过实际调试,不仅提升了问题排查能力,也对前端性能优化和权限控制有了更深刻的认识。虽然进度比预期稍慢,但通过持续的沟通协作,各项任务正在稳步推进。
+
+**期待与建议:**
+- 希望团队成员继续加强沟通,及时同步进展和问题
+- 建议建立更规范的联调流程,提高协作效率
+- 期待后端接口性能进一步提升,为前端优化提供更好基础
+
+---
+
+**提交时间:** 2025-12-07
+**下周重点:** 完成所有接口联调,实现性能优化目标,完善权限控制系统
\ No newline at end of file
diff --git a/doc/process/weekly/week-12/members/zhoujingyou-weekly-plan-12.md b/doc/process/weekly/week-12/members/zhoujingyou-weekly-plan-12.md
new file mode 100644
index 0000000..741084d
--- /dev/null
+++ b/doc/process/weekly/week-12/members/zhoujingyou-weekly-plan-12.md
@@ -0,0 +1,22 @@
+# 个人周计划-第12周
+
+## 姓名和起止时间
+
+**姓 名:** 周竞由
+**团队名称:** 软1-汪汪队
+**开始时间:** 2025-12-8
+**结束时间:** 2025-12-14
+
+## 本周任务计划安排
+| 序号 | 计划内容 | 协作人 | 情况说明 |
+|----|-----------------------------|-----|-------------------------------------|
+| 1 | 前后端接口联调:核心业务接口(权限/告警/工单)全量对接验证 | 前端协作人员 | 梳理接口文档并核对字段定义,逐一验证参数传递、数据返回格式、异常场景处理逻辑,修复接口调用异常问题 |
+| 2 | 页面与后端逻辑联调:权限展示/告警推送/工单流转页面 | 前端协作人员 | 联调各角色权限对应的页面展示逻辑,验证告警弹窗/列表与后端数据实时联动,确保工单全流程页面数据同步更新 |
+| 3 | 联调问题闭环与性能优化:接口响应/数据一致性/多端兼容 | 前端协作人员 | 汇总联调问题清单并逐一修复,完成回归测试;优化高频接口响应速度,验证多浏览器/移动设备兼容性 |
+
+## 小结
+
+1. **接口验证:** 完成核心业务接口全量联调,统一前后端字段定义与异常处理标准,解决接口调用类问题;
+2. **页面联调:** 实现权限、告警、工单相关页面与后端逻辑的精准联动,保障页面数据实时性与准确性;
+3. **问题闭环:** 梳理并修复联调全流程问题,通过回归测试验证问题解决效果,确保无遗留问题;
+4. **体验优化:** 针对高频接口做性能调优,提升页面交互响应速度,保障多端访问的兼容性与稳定性。
\ No newline at end of file
diff --git a/doc/process/weekly/week-12/members/zhoujingyou-weekly-summary-11.md b/doc/process/weekly/week-12/members/zhoujingyou-weekly-summary-11.md
new file mode 100644
index 0000000..cd3169f
--- /dev/null
+++ b/doc/process/weekly/week-12/members/zhoujingyou-weekly-summary-11.md
@@ -0,0 +1,39 @@
+# 个人周总结-第11周
+
+## 姓名和起止时间
+**姓 名:** 周竞由
+**团队名称:** 软1-汪汪队
+**开始时间:** 2025-12-1
+**结束时间:** 2025-12-7
+**核心职责:** 权限模块细化开发 + 告警功能优化 + 全流程闭环测试
+
+## 本周任务完成情况
+
+| 序号 | 计划内容 | 完成情况 | 说明 |
+|----|-----------------------------|------|------------------------------------------|
+| 1 | 权限细化:接口级权限控制(学生/维修人员/管理员) | 已完成 | 完成三类角色12个核心接口的访问范围划分,开发并调试权限中间件,解决2处角色权限冲突问题,通过接口测试验证权限拦截有效性 |
+| 2 | 告警功能完善:告警分级、推送、历史查询接口 | 已完成 | 实现一般/紧急两级告警标识逻辑,完成Web弹窗、APP消息推送联调,开发告警历史查询接口(支持按时间/级别筛选),验证多端推送兼容性 |
+| 3 | 全流程测试:设备异常→告警→工单→维修→恢复 | 部分完成 | 模拟8种真实业务场景(含3种异常场景),验证各环节数据同步与流程衔接,定位并修复3个逻辑断点(工单状态更新延迟、告警与工单关联失败等),实现全流程闭环 |
+
+## 本周总结
+
+1. **阶段成果:**
+ 本周完成权限体系的精细化落地与告警功能的全场景覆盖,通过全流程测试验证了核心业务链路的完整性。权限控制精准度、告警响应及时性及流程衔接顺畅度均达到预期,为后续前后端联调奠定了坚实基础。
+
+2. **技术提升:**
+ - 深入理解JWT权限认证与中间件拦截原理,掌握接口级权限控制的实现方法;
+ - 熟悉Web/APP多端告警推送的联调技巧,解决了跨端消息格式兼容问题;
+ - 提升复杂业务流程的测试场景设计能力,学会通过场景复现定位链路断点。
+
+3. **存在问题:**
+ - 权限模块对“临时角色”“跨角色操作”等特殊场景考虑不足,暂无适配方案;
+ - 全流程测试依赖人工模拟,测试效率较低,未形成自动化测试脚本;
+
+4. **改进方向:**
+ - 补充特殊角色权限场景的需求分析,新增3-5条关键用例并完善代码逻辑;
+ - 优化告警推送机制,引入消息队列降低并发压力,提升推送实时性;
+ - 基于Postman或JMeter编写全流程自动化测试脚本,减少人工重复操作;
+ - 对告警查询接口添加索引,优化SQL查询语句,提升大数据量下的响应速度。
+
+5. **工作体会:**
+ 本周工作让我深刻认识到“功能完整性”与“场景适配性”的重要性。权限控制不仅要划分清晰,更要考虑实际业务中的特殊情况;全流程测试不仅要验证“正常路径”,更要覆盖“异常场景”。通过与前端、产品的沟通,意识到功能开发需提前对齐需求细节,避免因理解偏差导致返工。同时,性能优化是功能落地后的关键环节,后续需在开发初期就融入性能考量,提升系统整体稳定性。
\ No newline at end of file
diff --git a/doc/process/weekly/week-4/group/meeting-minutes-3.md b/doc/process/weekly/week-4/group/meeting-minutes-3.md
new file mode 100644
index 0000000..ced4bca
--- /dev/null
+++ b/doc/process/weekly/week-4/group/meeting-minutes-3.md
@@ -0,0 +1,62 @@
+# 团队项目周会议纪要 —— 第三周
+
+## 会议基本信息
+- **会议日期**:2025年10月10日
+- **团队项目名称**:校园直饮矿化水管理系统
+- **小组成员**:张红卫、罗月航、周竞由、曹峻茂、王磊
+- **会议主要内容**:需求分析与基本分工安排
+
+---
+
+## 需求分析
+
+### 用户对象
+- 管理员
+- 维修人员
+- 学生
+
+### 平台要求
+- Web PC端管理平台(管理员使用)
+- 运维APP(维修人员使用)
+- 学生APP(学生使用)
+
+---
+
+### 各用户基本需求
+
+#### 管理员
+1. 监控设备上传数据,查看告警信息
+2. 跟踪所有工单,对超时工单进行人工派单
+3. 管理各片区维修人员
+4. 管理地区信息
+
+#### 维修人员
+1. 设备监控权限受限,仅可查看本辖区设备
+2. 工单服务为核心功能:抢单、拒单、处理并提交工单
+3. 查看历史工单记录
+
+#### 学生
+1. 查看校内矿化水终端机位置
+2. 扫码用水
+3. 扫码查看制水机水质情况
+4. 查看每日用水量
+
+---
+
+## 会议安排
+
+### 项目开发模式
+项目采用**前后端分离**的开发模式。
+
+### 人员分工
+| 角色 | 人员 |
+|------|------|
+|PM|曹峻茂
+| 前端 | 罗月航、周竞由 |
+| 后端 | 张红卫、曹峻茂、王磊 |
+|会议记录|张红卫|
+
+### 本周计划
+各成员查阅相关资料,对项目整体推进方式形成初步计划。
+
+---
\ No newline at end of file
diff --git a/doc/process/weekly/week-4/group/meeting-minutes-4.md b/doc/process/weekly/week-4/group/meeting-minutes-4.md
new file mode 100644
index 0000000..1af6d9f
--- /dev/null
+++ b/doc/process/weekly/week-4/group/meeting-minutes-4.md
@@ -0,0 +1,26 @@
+# 小组周计划-第4周
+
+## 团队名称和起止时间
+
+**团队名称:** 1班-汪汪队
+**开始时间:** 2025-10-13
+**结束时间:** 2025-10-19
+
+## 本周任务计划安排
+
+| 序号 | 计划内容 | 执行人 | 情况说明 |
+|------|----------|--------|----------|
+| 1 | 明确项目需求功能模块 | 全体成员 | 2025-10-13,全体成员讨论明确校园直饮矿化水管理系统的需求功能模块 |
+| 2 | 确定前后端开发分工 | 全体成员 | 2025-10-13,根据项目需求进行前后端开发分工 |
+| 3 | 前端UI草案设计 | 罗月航,周竞由 | 2025-10-13,前端人员学习并尝试初步建立起UI草 |
+| 4 | 后端技术框架学习 | 张红卫,曹峻茂,王磊 | 2025-10-13,后端人员完成对MQTT协议和HTTP接口开发技术的学习 |
+| 5 | 开发环境统一配置 | 全体成员 | 2025-10-13,完成前后端开发环境的统一配置 |
+
+## 小结
+
+1. **技术学习:** 团队成员应加强物联网通信和Web开发相关知识的学习,为后续开发打好基础。
+2. **沟通协作:** 前后端成员应保持密切沟通,确保技术方案的一致性。
+3. **进度把控:** 各成员应按计划完成学习任务,确保项目按时推进。
+4. **问题解决:** 遇到技术难题及时在团队内讨论或查找资料。
+
+---
diff --git a/doc/process/weekly/week-4/group/weekly-plan-4.md b/doc/process/weekly/week-4/group/weekly-plan-4.md
new file mode 100644
index 0000000..374186d
--- /dev/null
+++ b/doc/process/weekly/week-4/group/weekly-plan-4.md
@@ -0,0 +1,36 @@
+# 小组周计划-第4周
+
+## 团队名称和起止时间
+
+**团队名称:** 软1-汪汪队
+**开始时间:** 2025-10-13
+**结束时间:** 2025-10-19
+
+## 本周任务计划安排
+
+
+| 序号 | 计划内容 | 执行人 | 情况说明 |
+|----|------------------|------------|------------------------------|
+| 1 | 确定分工 | 全体组员 | 2023-10-13 开会细分确定团队分工,统一开发工具 |
+| 2 | 需求获取 | 全体组员 | 根据老师给出需求完成需求获取 |
+| 3 | 学习 | 全体组员 | 根据分工学习MQTT或前端相关知识 |
+| 4 | 实现基本的数据通信功能 | 曹峻茂,王磊,张红卫 | 实现通过MQTT协议获取饮水机数据的基本功能 |
+| 5 |尝试设计构建简易的ui草案| 罗月航,周竞由 |通过学习的前端知识尝试构建ui页面|
+
+## 小结
+
+1. **增强自信心:** 小组成员应增强自信心,发挥想象力和创造力,在原型设计环节积极思考。
+2. **沟通协作:** 小组成员应积极主动沟通,遇到困难及时寻求帮助,也可以主动向指导老师及研究生学长寻求建议。
+3. **学习安排:** 小组成员仍处于软件开发专业知识的初步学习阶段,应合理安排自主学习时间,以便后续开发的顺利进行。
+4. **项目管理:** PM及时推进项目流程,确保项目有条不紊。
+
+---
+
+## 【注】
+
+1. 在小结一栏中写出希望得到如何的帮助,如讲座等;
+2. 请将个人计划和总结提前发给负责人;
+3. 周任务总结与计划是项目小组评分考核的重要依据,将直接记入平时成绩,请各位同学按要求认真填写并按时提交;
+4. PM综合本小组成员工作情况提交小组周计划、周总结报告,按时上传至代码托管平台。
+
+---
\ No newline at end of file
diff --git a/doc/process/weekly/week-4/members/caojunmao-weekly-plan-4.md b/doc/process/weekly/week-4/members/caojunmao-weekly-plan-4.md
new file mode 100644
index 0000000..35b4886
--- /dev/null
+++ b/doc/process/weekly/week-4/members/caojunmao-weekly-plan-4.md
@@ -0,0 +1,34 @@
+# 个人周计划-第4周
+
+## 姓名和起止时间
+
+**姓 名:** 曹峻茂
+**团队名称:** 软1-汪汪队
+**开始时间:** 2025-10-13
+**结束时间:** 2025-10-19
+
+
+## 本周任务计划安排
+| 序号 | 计划内容 | 协作人 | 情况说明 |
+|----|-------------------|--------|------------------------------|
+| 1 | 确定分工 | 组员 | 2023-10-13 开会细分确定团队分工,统一开发工具 |
+| 2 | 需求获取 | 组员 | 根据老师给出需求完成需求获取 |
+| 3 | 学习 | 个人 | 学习MQTT协议知识 |
+| 4 | 实现基本的数据通信功能 | 王磊,张红卫 | 实现通过MQTT协议获取饮水机数据的基本功能 |
+
+## 小结
+
+1. **学习需求:** 希望能有对于MQTT协议以及使用的教学;
+2. **知识储备:** 学习后续需要使用的知识,为后续的开发做准备;
+3. **文档撰写:** 结合课内知识学习需求文档的撰写。
+4. **代码实现** 尝试实现数据通信
+---
+
+## 【注】
+
+1. 在小结一栏中写出希望得到如何的帮助,如讲座等;
+1. 请将个人计划和总结提前发给负责人;
+1. 周任务总结与计划是项目小组评分考核的重要依据,将直接记入平时成绩,请各位同学按要求认真填写并按时提交;
+1. 所有组员都需提交个人周计划、周总结文档,按时上传至代码托管平台;
+
+---
\ No newline at end of file
diff --git a/doc/process/weekly/week-4/members/luoyuehang-weekly-plan-4.md b/doc/process/weekly/week-4/members/luoyuehang-weekly-plan-4.md
new file mode 100644
index 0000000..41d9ed7
--- /dev/null
+++ b/doc/process/weekly/week-4/members/luoyuehang-weekly-plan-4.md
@@ -0,0 +1,23 @@
+# 个人周计划-第1周
+
+## 姓名和起止时间
+
+**姓 名:** 罗月航
+**团队名称:** 1班-汪汪队
+**开始时间:** 2025-10-13
+**结束时间:** 2025-10-19
+
+## 本周任务计划安排
+
+| 序号 | 计划内容 | 协作人 | 情况说明 |
+| ---- | -------- | ------ | -------- |
+| 1 | 需求分析与理解 | 组员 | 仔细阅读项目需求文档,理解管理员、维修人员、学生三类用户的功能需求 |
+| 2 | 设计规范制定 | 组员 | 与协作者共同确定Web端与移动端的设计风格、色彩体系和组件规范 |
+| 3 | 维修人员APP原型设计 | 个人 | 完成维修人员APP核心页面(设备监控、工单处理)的线框图和高保真设计 |
+| 4 | 管理员平台协作设计 | 组员 | 协助完成管理员平台中"工单跟踪"与"人员管理"模块的UI设计 |
+| 5 | 设计评审与优化 | 组员 | 参与内部设计评审,根据反馈意见优化完善UI设计方案 |
+
+## 小结
+
+ **协作沟通:** 希望建立定期的设计评审机制,确保设计方向的一致性。
+
diff --git a/doc/process/weekly/week-4/members/wanglei-weekly-plan-4.md b/doc/process/weekly/week-4/members/wanglei-weekly-plan-4.md
new file mode 100644
index 0000000..fb670c9
--- /dev/null
+++ b/doc/process/weekly/week-4/members/wanglei-weekly-plan-4.md
@@ -0,0 +1,33 @@
+# 个人周计划-第4周
+
+## 姓名和起止时间
+
+**姓 名:** 王磊
+**团队名称:** 1班-汪汪队
+**开始时间:** 2023-10-13
+**结束时间:** 2023-10-19
+
+
+## 本周任务计划安排
+
+|序号| 计划内容| 协作人 | 情况说明 |
+| ---- | ------ | ------| ------- |
+| 1 | 需求获取 | 组员 | 2025-10-10 与肖雄仁老师面对面沟通确定需求 |
+| 2 | 学习 | 个人 | 周内持续学习搭建数据库和处理数据的相关知识 |
+| 3 | 确定分工 | 组员 | 2025-10-10 开会细分确定团队分工, |
+| 4 | 学习项目的相关知识 | 个人 | 周内持续学习数据库的相关知识 |
+
+## 小结
+
+1. **学习需求:** 学习数据库相关知识和处理数据;
+2. **知识储备:** 提前学习后续需要使用的知识,为后续的前端开发做准备;
+3. **文档撰写:** 结合课内知识学习需求文档的撰写。
+
+---
+
+## 【注】
+
+1. 在小结一栏中写出希望得到如何的帮助,如讲座等;
+1. 请将个人计划和总结提前发给负责人;
+1. 周任务总结与计划是项目小组评分考核的重要依据,将直接记入平时成绩,请各位同学按要求认真填写并按时提交;
+1. 所有组员都需提交个人周计划、周总结文档,按时上传至代码托管平台;
\ No newline at end of file
diff --git a/doc/process/weekly/week-4/members/zhanghongwei-weekly-plan-04.md b/doc/process/weekly/week-4/members/zhanghongwei-weekly-plan-04.md
new file mode 100644
index 0000000..31acbdb
--- /dev/null
+++ b/doc/process/weekly/week-4/members/zhanghongwei-weekly-plan-04.md
@@ -0,0 +1,27 @@
+# 个人周计划-第4周
+
+## 姓名和起止时间
+
+**姓 名:** 张红卫
+**团队名称:** 1班-汪汪队
+**开始时间:** 2025-10-13
+**结束时间:** 2025-10-19
+
+
+## 本周任务计划安排
+
+| 序号 | 计划内容| 协作人 | 情况说明 |
+| ----| ------ | ------| ------- |
+| 1 | 需求获取 | 组员 | 2025-10-10 与肖雄仁老师面对面沟通确定需求 |
+| 2 | 学习传输数据 | 个人 | 周内持续学习将处理好的数据通过HTTP协议返回给客户端相关知识 |
+| 3 | 确定分工 | 组员 | 2025-10-10 开会细分确定团队分工 |
+| 4 | 学习数据接口服务 | 个人 | 周内持续学习如何编写一个Web服物,通过调用直接查询数据库,来获取数据。 |
+
+
+## 小结
+
+1. **学习需求:** 希望能有对于数据传输的教学;
+2. **知识储备:** 提前学习后续需要使用的知识,为后续的前端开发做准备;
+3. **文档撰写:** 结合课内知识学习需求文档的撰写。
+
+---
\ No newline at end of file
diff --git a/doc/process/weekly/week-4/members/zhanghongwei-weekly-plan4.md b/doc/process/weekly/week-4/members/zhanghongwei-weekly-plan4.md
new file mode 100644
index 0000000..c478f7f
--- /dev/null
+++ b/doc/process/weekly/week-4/members/zhanghongwei-weekly-plan4.md
@@ -0,0 +1,26 @@
+# 个人周计划-第4周
+
+## 姓名和起止时间
+
+**姓 名:** 张红卫
+**团队名称:** 一班-汪汪队
+**开始时间:** 2025-10-13
+**结束时间:** 2023-10-19
+
+## 本周任务计划安排
+
+| 序号 | 计划内容 | 协作人 | 情况说明 |
+|------|----------|--------|----------|
+| 1 | 需求获取 | 组员 | 2025-10-10 与肖熊仁老师面对面沟通确定需求 |
+| 2 | 学习数据接口服务 | 个人 | 周内持续学习数据接口服务,然后初步尝试编写Web服务,通过调用数据库,来获取数据 |
+| 3 | 确定分工 | 组员 | 2025-10-10 开会细分确定团队分工 |
+| 4 | 学习设计对外API | 个人 | 周内持续学习设计一套清晰的RESTful API或GraphQL API,定义好端点、请求/响应格式 |
+
+## 本周技术学习计划
+
+
+## 小结
+
+1. **学习需求:** 希望能有对于API设计的教学;
+2. **知识储备:** 提前学习后续需要使用的知识,为后续的前端开发做准备
+3. **文档撰写:** 结合课内知识学习需求文档的撰写
diff --git a/doc/process/weekly/week-4/members/zhoujingyou-weekly-plan-4.md b/doc/process/weekly/week-4/members/zhoujingyou-weekly-plan-4.md
new file mode 100644
index 0000000..809c7d5
--- /dev/null
+++ b/doc/process/weekly/week-4/members/zhoujingyou-weekly-plan-4.md
@@ -0,0 +1,24 @@
+# 个人周计划-第4周
+
+## 姓名和起止时间
+
+**姓 名:** 周竞由
+**团队名称:** 软1-汪汪队
+**开始时间:** 2025-10-13
+**结束时间:** 2025-10-19
+
+## 本周任务计划安排
+
+| 序号 | 计划内容 | 协作人 | 情况说明 |
+|----|--------------------------------|-----|-------------------------------|
+| 1 | 分析需求文档并与团队沟通,明确前端设计的核心功能模块 | 组员 | 2025-10-13 阅读需求文档并与设计团队确认需求细节 |
+| 2 | 制定UI设计方案,规划学生端、维修人员端和Web端的界面风格 | 个人 | 设计草图和布局框架,确保与需求一致 |
+| 3 | 完成首页和功能模块的初步UI设计,关注色彩、字体和布局 | 个人 | 完成首页UI设计,并与团队进行初步评审 |
+| 4 | 继续完善学生端APP的UI设计,加入动画效果和交互细节 | 个人 | 根据反馈继续调整设计,优化交互效果 |
+| 5 | 开始前端页面布局开发,使用HTML & CSS编写基本结构 | 个人 | 搭建学生端的基础页面布局,并与后端接口对接 |
+
+## 小结
+
+1. **学习需求:** 希望能有更多关于UI设计与前端开发工具的支持和学习资源;
+2. **知识储备:** 提前学习前端开发的相关技能,包括HTML、CSS、JavaScript的基础与进阶知识;
+3. **文档撰写:** 完成需求分析与前端设计方案,并与团队保持密切沟通,确保所有开发内容一致。
diff --git a/doc/process/weekly/week-5/group/meeting-minutes-5.md b/doc/process/weekly/week-5/group/meeting-minutes-5.md
new file mode 100644
index 0000000..5a4d747
--- /dev/null
+++ b/doc/process/weekly/week-5/group/meeting-minutes-5.md
@@ -0,0 +1,39 @@
+# 小组会议纪要-第5周
+
+## 会议记录概要
+
+**团队名称:** 1班-汪汪队
+**指导老师:** 肖雄仁
+**主 持 人:** 曹峻茂
+**记录人员:** 张红卫
+**会议主题:** 重新定位任务与计划
+**会议地点:** 宿舍
+**会议时间:** 2025-10-20 12:30-13:00
+**纪录时间:** 2023-10-26 18:00
+**参与人员:** 曹峻茂、张红卫、罗月航、周竞由、王磊
+
+---
+
+## 会议内容
+
+### 1.任务重新分配
+
+由于进度需要,临时将张红卫从后端调到前端,三个人刚好对项目的学生、维修人员和管理人员进行分配
+
+###2.项目分工
+
+(1)**项目主要分工方面:**
+-前端:继续完善界面原型
+-后端:进一步完成数据库和用例文档
+
+(2)**角色分配:**
+前端开发人员:张红卫、罗月航、周竞由
+后端开发人员:曹峻茂、王磊
+
+
+(3)**具体任务安排:**
+- 会议记录:张红卫
+- 会议主持:曹峻茂
+- 文档管理:曹峻茂
+- 周计划文档:曹峻茂
+- 项目开发:张红卫、曹峻茂、罗月航、周竞由、王磊
diff --git a/doc/process/weekly/week-5/group/weekly-plan-5.md b/doc/process/weekly/week-5/group/weekly-plan-5.md
new file mode 100644
index 0000000..5a21d2a
--- /dev/null
+++ b/doc/process/weekly/week-5/group/weekly-plan-5.md
@@ -0,0 +1,35 @@
+# 小组周计划-第5周
+
+## 团队名称和起止时间
+
+**团队名称:** 软1-汪汪队
+**开始时间:** 2025-10-20
+**结束时间:** 2025-10-26
+
+## 本周任务计划安排
+
+
+| 序号 | 计划内容 | 执行人 | 情况说明 |
+|----|----------------|-------------|-----------------------|
+| 1 | 确定分工及周计划 | 全体组员 | 2023-10-20 开会细分确定团队分工 |
+| 2 | 完善数据库的构建 | 王磊 | 在之前构建的数据传输模块基础上设计数据库 |
+| 3 | 完成用例文档以及更新需求文档 | 曹峻茂 | 设计用例文档并根据原型页面更新需求文档 |
+| 4 | 根据用例图完成原型界面 | 罗月航,周竞由,张红卫 | 根据用例文档完成原型界面 |
+
+## 小结
+
+1. **增强自信心:** 小组成员应增强自信心,发挥想象力和创造力,在原型设计环节积极思考。
+2. **沟通协作:** 小组成员应积极主动沟通,遇到困难及时寻求帮助,也可以主动向指导老师及研究生学长寻求建议。
+3. **学习安排:** 小组成员仍处于软件开发专业知识的初步学习阶段,应合理安排自主学习时间,以便后续开发的顺利进行。
+4. **项目管理:** PM及时推进项目流程,确保项目有条不紊。
+
+---
+
+## 【注】
+
+1. 在小结一栏中写出希望得到如何的帮助,如讲座等;
+2. 请将个人计划和总结提前发给负责人;
+3. 周任务总结与计划是项目小组评分考核的重要依据,将直接记入平时成绩,请各位同学按要求认真填写并按时提交;
+4. PM综合本小组成员工作情况提交小组周计划、周总结报告,按时上传至代码托管平台。
+
+---
\ No newline at end of file
diff --git a/doc/process/weekly/week-5/group/weekly-summary-4.md b/doc/process/weekly/week-5/group/weekly-summary-4.md
new file mode 100644
index 0000000..563147e
--- /dev/null
+++ b/doc/process/weekly/week-5/group/weekly-summary-4.md
@@ -0,0 +1,33 @@
+# 小组周总结-第4周
+
+## 团队名称和起止时间
+
+**团队名称:** 1班-汪汪队
+**开始时间:** 2025-10-13
+**结束时间:** 2025-10-19
+
+## 本周任务完成情况
+
+| 序号 | 总结内容 | 是否完成 | 情况说明 |
+|------|----------|-----|----------|
+| 1 | 确定分工 | 完成 | 2023-10-13 开会细分确定团队分工,统一开发工具 |
+| 2 | 需求获取 | 完成 | 根据老师给出需求完成需求获取 |
+| 3 | 学习 | 完成 | 根据分工学习MQTT或前端相关知识 |
+| 4 | 实现基本的数据通信功能 | 基本完成 | 实现通过MQTT协议获取饮水机数据的基本功能 |
+| 5 |尝试设计构建简易的ui草案| 进行中 |通过学习的前端知识尝试构建ui页面|
+
+
+## 小结
+
+1. **沟通协作:** 小组成员应积极主动沟通,遇到困难及时寻求帮助,也可以主动向指导老师及研究生学长寻求建议。
+2. **学习安排:** 小组成员仍处于软件开发专业知识的初步学习阶段,应合理安排自主学习时间,以便后续开发的顺利进行。
+3. **项目管理:** 项目进度管理杨安然同学及时推进项目流程,确保项目有条不紊。
+
+---
+
+## 【注】
+
+1. 在小结一栏中写出希望得到如何的帮助,如讲座等;
+2. 请将个人计划和总结提前发给负责人;
+3. 周任务总结与计划是项目小组评分考核的重要依据,将直接记入平时成绩,请各位同学按要求认真填写并按时提交;
+4. PM综合本小组成员工作情况提交小组周计划、周总结报告,按时上传至代码托管平台。
diff --git a/doc/process/weekly/week-5/members/caojunmao-weekly-plan-5.md b/doc/process/weekly/week-5/members/caojunmao-weekly-plan-5.md
new file mode 100644
index 0000000..f35df75
--- /dev/null
+++ b/doc/process/weekly/week-5/members/caojunmao-weekly-plan-5.md
@@ -0,0 +1,34 @@
+# 个人周计划-第5周
+
+## 姓名和起止时间
+
+**姓 名:** 曹峻茂
+**团队名称:** 软1-汪汪队
+**开始时间:** 2025-10-20
+**结束时间:** 2025-10-26
+
+
+## 本周任务计划安排
+| 序号 | 计划内容 | 协作人 | 情况说明 |
+|----|-----------|-----|-----------------------|
+| 1 | 确定分工 | 组员 | 2023-10-20 开会细分确定团队分工 |
+| 2 | 协调完成数据库设计 | 王磊 | 为王磊完成数据库设计提供支持 |
+| 3 | 设计用例文档 | 个人 | 完成用例文档 |
+| 4 | 更新需求文档 | 个人 | 在原型界面完成后更新需求文档 |
+
+## 小结
+
+1. **学习需求:** 希望能有对于用例文档设计和需求文档格式的教学;
+2. **知识储备:** 学习后续需要使用的知识,为后续的开发做准备;
+3. **文档撰写:** 结合课内知识学习需求文档的撰写。
+4. **代码实现** 尝试实现数据通信
+---
+
+## 【注】
+
+1. 在小结一栏中写出希望得到如何的帮助,如讲座等;
+1. 请将个人计划和总结提前发给负责人;
+1. 周任务总结与计划是项目小组评分考核的重要依据,将直接记入平时成绩,请各位同学按要求认真填写并按时提交;
+1. 所有组员都需提交个人周计划、周总结文档,按时上传至代码托管平台;
+
+---
\ No newline at end of file
diff --git a/doc/process/weekly/week-5/members/caojunmao-weekly-summary-4.md b/doc/process/weekly/week-5/members/caojunmao-weekly-summary-4.md
new file mode 100644
index 0000000..66dd624
--- /dev/null
+++ b/doc/process/weekly/week-5/members/caojunmao-weekly-summary-4.md
@@ -0,0 +1,37 @@
+# 个人周总结-第4周
+
+## 姓名和起止时间
+
+**姓 名:** 曹峻茂
+**团队名称:** 1班-汪汪队
+**开始时间:** 2025-10-13
+**结束时间:** 2025-10-19
+
+## 本周任务完成情况
+
+| 序号 | 总结内容 | 是否完成 | 情况说明 |
+| ---- | ------------------------------------------------ |----|--------------------------------------------------------------|
+| 3 | 学习 | 完成 | 学习MQTT协议知识 |
+| 4 | 实现基本的数据通信功能 | 完成 | 实现通过MQTT协议获取饮水机数据的基本功能 |
+| 4 | 召开例会,讨论原型的完成情况,并交换报告各自进度 | 完成 | 2023-10-19召开每周例会,并确定下周进度计划,需求 |
+
+## 对团队工作的建议
+
+1. **互助学习:** 小组成员应该根据自身的技能长短开展互帮互助的活动,共同努力提高小组成员的专业水平;
+2. **进度统一:** 团队成员尽量统一项目进度;
+
+## 小结
+
+1. **原实现数据传输功能:** 完成了数据传输模块的基本实现;
+2. **技能学习:** 小组成员各自开展自己所负责部分的个人技能的学习;
+3. **项目管理:** PM及时推进项目进度,确保工作有条不紊;
+4. **计划制定:** 根据本周任务完成情况与下一阶段文档提交要求,制定团队任务计划。
+
+---
+
+## 【注】
+
+1. 在小结一栏中写出希望得到如何的帮助,如讲座等;
+2. 请将个人计划和总结提前发给负责人;
+3. 周任务总结与计划是项目小组评分考核的重要依据,将直接记入平时成绩,请各位同学按要求认真填写并按时提交;
+4. 所有组员都需提交个人周计划、周总结文档,上传至代码托管平台;
\ No newline at end of file
diff --git a/doc/process/weekly/week-5/members/luoyuehang-weekly-plan-05.md b/doc/process/weekly/week-5/members/luoyuehang-weekly-plan-05.md
new file mode 100644
index 0000000..ddc2a73
--- /dev/null
+++ b/doc/process/weekly/week-5/members/luoyuehang-weekly-plan-05.md
@@ -0,0 +1,25 @@
+# 个人周计划-第5周
+
+## 姓名和起止时间
+
+**姓 名:** [罗月航]
+**团队名称:** 1班-汪汪队
+**开始时间:** 2025-10-20
+**结束时间:** 2025-10-26
+
+## 本周任务计划安排
+
+| 序号 | 计划内容 | 协作人 | 情况说明 |
+| ---- | -------- | ------ | -------- |
+| 1 | 维修人员APP原型优化完善 | 个人 | 根据第一周评审反馈,完善维修人员APP所有页面的交互细节和视觉设计 |
+| 2 | 实现原型交互功能 | 个人 | 实现页面跳转、按钮交互、数据展示等动态效果,完成高保真交互原型 |
+| 3 | 维修人员APP前端环境搭建 | 个人 | 搭建前端开发环境,配置基础的项目结构和依赖 |
+| 4 | 开发基础页面框架 | 个人 | 实现维修人员APP的登录页面、主布局框架和导航组件 |
+| 5 | 团队技术分享 | 组员 | 参与团队技术分享会,交流原型设计经验和前端开发技术 |
+
+## 小结
+
+1. **技术支持需求:** 希望获得移动端前端开发的技术指导,特别是框架配置和移动端适配方案;
+2. **设计确认:** 需要产品经理对维修人员APP原型设计进行最终确认;
+
+
diff --git a/doc/process/weekly/week-5/members/luoyuehang-weekly-summary-04.md b/doc/process/weekly/week-5/members/luoyuehang-weekly-summary-04.md
new file mode 100644
index 0000000..97ce817
--- /dev/null
+++ b/doc/process/weekly/week-5/members/luoyuehang-weekly-summary-04.md
@@ -0,0 +1,33 @@
+
+# 个人周总结-第4周
+
+## 姓名和起止时间
+
+**姓 名:** [罗月航]
+**团队名称:** 1班-汪汪队
+**开始时间:** 2025-10-13
+**结束时间:** 2025-10-19
+
+## 本周任务完成情况
+
+| 序号 | 总结内容 | 是否完成 | 情况说明 |
+| ---- | -------- | -------- | -------- |
+| 1 | 需求分析与理解 | 完成 | 仔细研读了项目需求文档,明确了管理员、维修人员、学生三类用户的功能需求和业务流程 |
+| 2 | 设计规范制定 | 完成 | 与协作者共同确定了Web端与移动端统一的设计风格、色彩体系和基础组件规范 |
+| 3 | 维修人员APP原型设计 | 基本完成 | 完成了维修人员APP核心页面(设备监控、工单列表、抢单处理流程)的线框图设计 |
+| 4 | 管理员平台协作设计 | 部分完成 | 协助完成了管理员平台"工单跟踪"模块的初步界面设计 |
+| 5 | 设计评审与优化 | 完成 | 参与了内部设计评审会议,根据反馈意见对维修人员APP原型进行了初步优化 |
+
+## 对团队工作的建议
+
+1. **设计协作:** 建议建立团队共享的设计资源库,统一图标、组件等设计元素;
+2. **沟通机制:** 建议固定每日站会时间,及时同步设计进展和遇到的问题;
+3. **技术预研:** 建议前端开发提前了解接口数据结构,确保设计与开发衔接顺畅。
+
+## 小结
+
+1. **设计产出:** 完成了维修人员APP的主体原型设计,确立了项目整体的视觉风格;
+2. **协作成效:** 与协作者配合良好,保持了Web端与移动端设计风格的一致性;
+3. **技能提升:** 通过实际项目实践,提升了移动端界面设计的专业能力;
+4. **后续计划:** 根据评审反馈完善设计细节,并开始准备前端开发环境搭建。
+
diff --git a/doc/process/weekly/week-5/members/wanglei-weekly-plan-05.md b/doc/process/weekly/week-5/members/wanglei-weekly-plan-05.md
new file mode 100644
index 0000000..f0d78ee
--- /dev/null
+++ b/doc/process/weekly/week-5/members/wanglei-weekly-plan-05.md
@@ -0,0 +1,33 @@
+# 个人周计划-第5周
+
+## 姓名和起止时间
+
+**姓 名:** 王磊
+**团队名称:** 1班-汪汪队
+**开始时间:** 2023-10-20
+**结束时间:** 2023-10-26
+
+
+## 本周任务计划安排
+
+|序号| 计划内容| 协作人 | 情况说明 |
+| ---- | ------ | ------| ------- |
+| 1 | 确定分工 | 组员 | 2025-10-20 开会细分确定团队分工, |
+| 2 | 完善数据库 | 曹峻茂 | 对于数据库的设计进行完善 |
+| 3 | 测试 | 个人 | 编写测试程序,测试对于数据的处理是否达到要求 |
+
+
+## 小结
+
+1. **学习需求:** 学习数据库相关知识和处理数据;
+2. **知识储备:** 提前学习后续需要使用的知识,为后续的后端开发做准备;
+3. **文档撰写:** 结合课内知识学习需求文档的撰写。
+
+---
+
+## 【注】
+
+1. 在小结一栏中写出希望得到如何的帮助,如讲座等;
+1. 请将个人计划和总结提前发给负责人;
+1. 周任务总结与计划是项目小组评分考核的重要依据,将直接记入平时成绩,请各位同学按要求认真填写并按时提交;
+1. 所有组员都需提交个人周计划、周总结文档,按时上传至代码托管平台;
\ No newline at end of file
diff --git a/doc/process/weekly/week-5/members/wanglei-weekly-summary-04.md b/doc/process/weekly/week-5/members/wanglei-weekly-summary-04.md
new file mode 100644
index 0000000..b94bfe3
--- /dev/null
+++ b/doc/process/weekly/week-5/members/wanglei-weekly-summary-04.md
@@ -0,0 +1,39 @@
+
+# 个人周总结-第4周
+
+## 姓名和起止时间
+
+**姓 名:** 王磊
+**团队名称:** 1班-汪汪队
+**开始时间:** 2025-10-13
+**结束时间:** 2025-10-19
+
+## 本周任务完成情况
+
+序号 总结内容 是否完成 情况说明
+1 MySQL数据库环境搭建与配置 完成 成功安装MySQL 8.0.43,创建water_management数据库,配置数据库连接环境变量,解决数据库连接权限问题
+2 MQTT数据处理器开发 完成 实现基于Java的MQTT数据接收、解析和处理模块,支持制水机和供水机两种设备类型的数据处理
+3 数据库表结构设计与创建 完成 设计并创建device_data设备数据表和device_alert告警表,建立完整的数据存储结构
+4 数据解析与业务逻辑实现 完成 实现JSON数据解析、设备状态判断、异常检测和自动告警生成功能
+5 项目集成与测试 完成 成功将数据处理模块集成到智慧饮水系统项目中,完成多组测试数据的验证
+
+## 对团队工作的建议
+
+1. **互助学习:** 小组成员应该根据自身的技能长短开展互帮互助的活动,共同努力提高小组成员的专业水平;
+2. **进度统一:** 团队成员尽量统一项目进度;
+
+## 小结
+
+
+1. **技能学习:** 小组成员各自开展自己所负责部分的个人技能的学习;
+2. **项目管理:** PM及时推进项目进度,确保工作有条不紊;
+3. **计划制定:** 根据本周任务完成情况与下一阶段文档提交要求,制定团队任务计划。
+
+---
+
+## 【注】
+
+1. 在小结一栏中写出希望得到如何的帮助,如讲座等;
+2. 请将个人计划和总结提前发给负责人;
+3. 周任务总结与计划是项目小组评分考核的重要依据,将直接记入平时成绩,请各位同学按要求认真填写并按时提交;
+4. 所有组员都需提交个人周计划、周总结文档,上传至代码托管平台;
\ No newline at end of file
diff --git a/doc/process/weekly/week-5/members/zhanghongwei-weekly-plan-5.md b/doc/process/weekly/week-5/members/zhanghongwei-weekly-plan-5.md
new file mode 100644
index 0000000..1e2736e
--- /dev/null
+++ b/doc/process/weekly/week-5/members/zhanghongwei-weekly-plan-5.md
@@ -0,0 +1,25 @@
+# 个人周计划-第5周
+
+## 姓名和起止时间
+
+**姓 名:** 张红卫
+**团队名称:** 1班-汪汪队
+**开始时间:** 2025-10-20
+**结束时间:** 2025-10-26
+
+## 本周任务计划安排
+
+| 序号 | 计划内容 | 协作人 | 情况说明 |
+|------|----------|--------|----------|
+| 1 | 学习界面设计原则 | 个人 | 学习用户体验设计基础,了解管理平台界面设计规范 |
+| 2 | 设计管理人员Web页面原型 | 个人 | 基于项目需求,设计管理人员监控数据、查看告警等核心功能界面 |
+| 3 | 界面设计评审与优化 | 组员 | 组织小组评审原型设计,收集反馈并进行迭代优化 |
+| 4 | 前端技术预研 | 个人 | 了解Web前端开发技术,为后续界面实现做准备 |
+
+## 小结
+
+1. **学习需求:** 希望有原型设计工具的系统教学,特别是针对管理类系统的设计模式;
+2. **知识储备:** 需要加强前端开发知识,特别是响应式布局和组件化开发;
+3. **协作支持:** 需要与后端开发同学沟通接口需求,确保设计可行性。
+
+---
diff --git a/doc/process/weekly/week-5/members/zhanghongwei-weekly-summary-04.md b/doc/process/weekly/week-5/members/zhanghongwei-weekly-summary-04.md
new file mode 100644
index 0000000..8def47e
--- /dev/null
+++ b/doc/process/weekly/week-5/members/zhanghongwei-weekly-summary-04.md
@@ -0,0 +1,31 @@
+# 个人周总结-第4周
+
+## 姓名和起止时间
+
+**姓 名:** 张红卫
+**团队名称:** 1班-汪汪队
+**开始时间:** 2025-10-13
+**结束时间:** 2025-10-19
+
+## 本周任务完成情况
+
+| 序号 | 总结内容 | 是否完成 | 情况说明 |
+| ---- | -------- | -------- | -------- |
+| 1 | 需求获取 | 完成 | 2025-10-10与肖雄仁老师面对面沟通,明确了校园直饮矿化水运维平台的具体需求 |
+| 2 | 学习传输数据 | 部分完成 | 初步学习了HTTP协议的请求响应模型、状态码含义、RESTful API设计原则 |
+| 3 | 确定分工 | 完成 | 2025-10-13团队开会明确了各成员分工,确定了各自负责的开发模块 |
+| 4 | 学习数据接口服务 | 进行中 | 初步学习了Spring Boot框架基础、Controller层编写、数据库连接配置 |
+
+## 对团队工作的建议
+
+1. **技术互助:** 建议团队成员根据各自技术专长开展互帮互助,共同提升开发能力;
+2. **进度协调:** 建议定期同步开发进度,确保各模块开发协调一致;
+
+## 小结
+
+1. **需求分析:** 通过与老师沟通,深入理解了校园直饮矿化水物联网运维平台的功能需求;
+2. **技术准备:** 开始学习数据传输和Web服务开发相关知识,为后续开发做准备;
+3. **团队协作:** 分工明确,团队协作顺畅,项目推进有序;
+4. **文档学习:** 结合课内知识学习需求文档的撰写规范;
+
+---
diff --git a/doc/process/weekly/week-5/members/zhoujingyou-weekly-plan-05.md b/doc/process/weekly/week-5/members/zhoujingyou-weekly-plan-05.md
new file mode 100644
index 0000000..ad0db49
--- /dev/null
+++ b/doc/process/weekly/week-5/members/zhoujingyou-weekly-plan-05.md
@@ -0,0 +1,26 @@
+# 个人周计划-第5周
+
+## 姓名和起止时间
+
+**姓 名:** 周竞由
+**团队名称:** 软1-汪汪队
+**开始时间:** 2025-10-20
+**结束时间:** 2025-10-26
+
+## 本周任务计划安排
+
+| 序号 | 计划内容 | 协作人 | 情况说明 |
+|----|---------------|-----|-----------------------------|
+| 1 | 完成学生端首页UI细化设计 | 个人 | 对首页的模块布局、字体、配色进行优化,完善信息展示逻辑 |
+| 2 | 设计“扫码用水”功能页面 | 个人 | 设计扫码界面与用水反馈界面,优化扫码流程的交互体验 |
+| 3 | 设计“查看水质”页面 | 个人 | 设计展示水质数据的图表与数据模块,突出清晰的视觉层次 |
+| 4 | 设计“用水记录”页面 | 个人 | 设计用水记录查询界面,增加时间筛选与统计功能展示 |
+| 5 | 设计“水机位置”页面 | 个人 | 完成地图定位界面UI设计,加入搜索与筛选功能布局 |
+| 6 | 团队UI评审与反馈整理 | 组员 | 与团队进行设计评审会议,收集意见并记录优化方向 |
+
+## 小结
+
+1. **设计目标:** 本周主要目标是完成学生端各个功能页面的UI设计,形成统一的视觉风格与交互逻辑;
+2. **学习提升:** 深入学习UI交互设计与响应式布局技巧,提高界面层次感与用户体验;
+3. **协作重点:** 与后端确认页面所需数据接口结构,确保后续开发阶段数据对接顺畅;
+4. **下周展望:** 完成学生端UI优化及交互原型后,开始进入前端功能开发阶段。
diff --git a/doc/process/weekly/week-5/members/zhoujingyou-weekly-summary-04.md b/doc/process/weekly/week-5/members/zhoujingyou-weekly-summary-04.md
new file mode 100644
index 0000000..93b585d
--- /dev/null
+++ b/doc/process/weekly/week-5/members/zhoujingyou-weekly-summary-04.md
@@ -0,0 +1,31 @@
+# 个人周总结-第4周
+
+## 姓名和起止时间
+
+**姓 名:** 周竞由
+**团队名称:** 软1-汪汪队
+**开始时间:** 2025-10-13
+**结束时间:** 2025-10-19
+
+## 本周任务完成情况
+
+| 序号 | 总结内容 | 是否完成 | 情况说明 |
+|----|--------------------------------|------|------------------------------------------------|
+| 1 | 分析需求文档并与团队沟通,明确前端设计的核心功能模块 | 完成 | 已深入阅读项目需求文档,明确了学生端APP的主要功能与设计方向,并与团队讨论确认前端开发重点 |
+| 2 | 制定UI设计方案,规划学生端、维修人员端和Web端的界面风格 | 完成 | 明确了整体设计风格为简洁清新风,确定主色调为蓝白系,规划了主要功能模块的布局与交互方式 |
+| 3 | 完成首页和功能模块的初步UI设计,关注色彩、字体和布局 | 基本完成 | 已完成首页与部分核心功能页面的UI设计初稿,关注了可读性与层次感,并进行初步评审 |
+| 4 | 继续完善学生端APP的UI设计,加入动画效果和交互细节 | 部分完成 | 已设计部分交互细节与动画效果,收集团队反馈后计划下周进一步优化体验 |
+| 5 | 开始前端页面布局开发,使用HTML & CSS编写基本结构 | 进行中 | 已搭建学生端基础页面框架,正在完善响应式布局与后端接口对接测试 |
+
+## 对团队工作的建议
+
+1. **接口文档提前共享:** 建议后端开发尽早提供学生端接口数据结构说明,以便前端更高效地完成数据对接;
+2. **设计风格统一:** 建议团队建立统一的UI组件库或样式规范,确保多端界面一致性;
+3. **阶段评审机制:** 每周可定期进行一次UI评审或开发同步会,促进协作效率。
+
+## 小结
+
+1. **设计成果:** 本周完成了学生端整体UI设计方案,初步确定了APP界面布局与色彩风格;
+2. **开发进展:** 完成了首页与部分页面的前端结构搭建,为后续功能开发奠定基础;
+3. **学习提升:** 在本周过程中加强了对HTML、CSS布局及UI交互设计的掌握;
+4. **后续计划:** 下周将重点完善交互动画与页面细节,实现接口数据对接与动态展示功能。
diff --git a/doc/process/weekly/week-6/group/meeting-minutes-6.md b/doc/process/weekly/week-6/group/meeting-minutes-6.md
new file mode 100644
index 0000000..d804946
--- /dev/null
+++ b/doc/process/weekly/week-6/group/meeting-minutes-6.md
@@ -0,0 +1,41 @@
+# 小组会议纪要-第6周
+
+## 会议记录概要
+
+**团队名称:** 1班-汪汪队
+**指导老师:** 肖雄仁
+**主 持 人:** 曹峻茂
+**记录人员:** 张红卫
+**会议主题:** 原型界面评审与功能完善
+**会议地点:** 宿舍
+**会议时间:** 2025-10-27 12:30-13:30
+**纪录时间:** 2025-10-27 18:00
+**参与人员:** 曹峻茂、张红卫、罗月航、周竞由、王磊
+
+---
+
+## 会议内容
+
+### 1. 原型界面初步展示与交流
+
+前端小组向指导老师展示当前实现的基本功能原型界面,包括学生端、维修人员端和管理员端的主要功能模块,再根据老师的指导意见进行调整与修改。
+
+### 2. 原型界面完善与美化计划
+
+基于老师和小组成员的反馈,前端团队将对原型界面进行进一步的完善与美化。
+
+
+### 3. 数据库设计与完善
+
+后端团队汇报了当前数据库设计的进展情况,针对尚未完全实现的部分进行进一步完善。
+
+### 4. 原型界面与用例文档协同优化
+
+会议决定加强前端与后端团队的协作配合,针对原型界面设计与用例文档之间存在的差异进行进一步的相互调整与完善。
+
+### 5.具体任务安排
+- 管理人员Web原型界面的进一步优化:张红卫
+- 学生端APP原型界面的进一步优化:周竞由
+- 维修人员APP原型界面的进一步优化:罗月航
+- 数据库的进一步完善;王磊
+- 用例文档的再一不调整:曹峻茂
\ No newline at end of file
diff --git a/doc/process/weekly/week-6/group/weekly-plan-6.md b/doc/process/weekly/week-6/group/weekly-plan-6.md
new file mode 100644
index 0000000..9ca7433
--- /dev/null
+++ b/doc/process/weekly/week-6/group/weekly-plan-6.md
@@ -0,0 +1,36 @@
+# 小组周计划-第6周
+
+## 团队名称和起止时间
+
+**团队名称:** 软1-汪汪队
+**开始时间:** 2025-10-27
+**结束时间:** 2025-11-2
+
+## 本周任务计划安排
+
+
+| 序号 | 计划内容 | 执行人 | 情况说明 |
+|----|--------------|-------------|------------------------------|
+| 1 | 确定本周分工 | 全体组员 | 2023-10-27 开会细分确定团队分工,统一开发工具 |
+| 2 | 商讨原型设计 | 全体组员 | 与老师联系获取老师关于原型的建议 |
+| 3 | 学习 | 全体组员 | 继续学习相关知识,在做中学 |
+| 4 | 继续完善数据库设计和实现 | 曹峻茂,王磊 | 继续完成数据库设计和实现 |
+| 5 | 完善当前的原型页面设计 | 罗月航,周竞由,张红卫 | 完善当前的原型页面 |
+ |6|根据讨论结果更新需求文档|曹峻茂|更新需求文档|
+## 小结
+
+1. **增强自信心:** 小组成员应增强自信心,发挥想象力和创造力,在原型设计环节积极思考。
+2. **沟通协作:** 小组成员应积极主动沟通,遇到困难及时寻求帮助,也可以主动向指导老师及研究生学长寻求建议。
+3. **学习安排:** 小组成员仍处于软件开发专业知识的初步学习阶段,应合理安排自主学习时间,以便后续开发的顺利进行。
+4. **项目管理:** PM及时推进项目流程,确保项目有条不紊。
+
+---
+
+## 【注】
+
+1. 在小结一栏中写出希望得到如何的帮助,如讲座等;
+2. 请将个人计划和总结提前发给负责人;
+3. 周任务总结与计划是项目小组评分考核的重要依据,将直接记入平时成绩,请各位同学按要求认真填写并按时提交;
+4. PM综合本小组成员工作情况提交小组周计划、周总结报告,按时上传至代码托管平台。
+
+---
\ No newline at end of file
diff --git a/doc/process/weekly/week-6/group/weekly-summary-5.md b/doc/process/weekly/week-6/group/weekly-summary-5.md
new file mode 100644
index 0000000..0b61f90
--- /dev/null
+++ b/doc/process/weekly/week-6/group/weekly-summary-5.md
@@ -0,0 +1,34 @@
+# 小组周总结-第5周
+
+## 团队名称和起止时间
+
+**团队名称:** 1班-汪汪队
+**开始时间:** 2023-10-19
+**结束时间:** 2025-10-26
+
+## 本周任务完成情况
+
+| 序号 | 总结内容 | 是否完成 | 情况说明 |
+|------|----------|------|------------------------------|
+| 1 | 确定分工 | 完成 | 2023-10-20 开会细分确定团队分工,统一开发工具 |
+| 2 | 完善数据库的构建 | 进行中 | 在之前构建的数据传输模块基础上设计数据库 |
+| 3 | 完成用例文档以及更新需求文档 | 基本完成 | 设计用例文档并根据原型页面更新需求文档 |
+| 4 | 根据用例图完成原型界面 | 进行中 | 根据用例文档完成原型界面 |
+
+
+
+## 小结
+
+1. **沟通协作:** 小组成员应积极主动沟通,遇到困难及时寻求帮助,也可以主动向指导老师及研究生学长寻求建议。
+2. **学习安排:** 小组成员仍处于软件开发专业知识的初步学习阶段,应合理安排自主学习时间,以便后续开发的顺利进行。
+3. **项目管理:** 项目进度管理杨安然同学及时推进项目流程,确保项目有条不紊。
+
+---
+
+## 【注】
+
+1. 在小结一栏中写出希望得到如何的帮助,如讲座等;
+2. 请将个人计划和总结提前发给负责人;
+3. 周任务总结与计划是项目小组评分考核的重要依据,将直接记入平时成绩,请各位同学按要求认真填写并按时提交;
+4. PM综合本小组成员工作情况提交小组周计划、周总结报告,按时上传至代码托管平台。
+---
\ No newline at end of file
diff --git a/doc/process/weekly/week-6/members/caojunmao-weekly-plan-6.md b/doc/process/weekly/week-6/members/caojunmao-weekly-plan-6.md
new file mode 100644
index 0000000..6726bdc
--- /dev/null
+++ b/doc/process/weekly/week-6/members/caojunmao-weekly-plan-6.md
@@ -0,0 +1,34 @@
+# 个人周计划-第6周
+
+## 姓名和起止时间
+
+**姓 名:** 曹峻茂
+**团队名称:** 软1-汪汪队
+**开始时间:** 2025-10-27
+**结束时间:** 2025-11-2
+
+
+## 本周任务计划安排
+| 序号 | 计划内容 | 协作人 | 情况说明 |
+|----|-------------|-----|-----------------------|
+| 1 | 确定分工 | 组员 | 2023-10-27 开会细分确定团队分工 |
+ |2| 与老师讨论 |组员| 与老师讨论当前用例和原型设计 |
+| 2 | 继续协调完成数据库设计 | 王磊 | 继续为王磊完成数据库设计提供支持 |
+| 4 | 更新需求文档 | 个人 | 根据本周计划和更改更新需求文档 |
+
+## 小结
+
+1. **学习需求:** 希望能有对于用例文档设计和需求文档格式的教学;
+2. **知识储备:** 学习后续需要使用的知识,为后续的开发做准备;
+3. **文档撰写:** 结合课内知识学习需求文档的撰写。
+4. **代码实现** 参与数据库设计
+---
+
+## 【注】
+
+1. 在小结一栏中写出希望得到如何的帮助,如讲座等;
+1. 请将个人计划和总结提前发给负责人;
+1. 周任务总结与计划是项目小组评分考核的重要依据,将直接记入平时成绩,请各位同学按要求认真填写并按时提交;
+1. 所有组员都需提交个人周计划、周总结文档,按时上传至代码托管平台;
+
+---
\ No newline at end of file
diff --git a/doc/process/weekly/week-6/members/caojunmao-weekly-summary-05.md b/doc/process/weekly/week-6/members/caojunmao-weekly-summary-05.md
new file mode 100644
index 0000000..50ad560
--- /dev/null
+++ b/doc/process/weekly/week-6/members/caojunmao-weekly-summary-05.md
@@ -0,0 +1,37 @@
+# 个人周总结-第5周
+
+## 姓名和起止时间
+
+**姓 名:** 曹峻茂
+**团队名称:** 1班-汪汪队
+**开始时间:** 2025-10-20
+**结束时间:** 2025-10-26
+
+## 本周任务完成情况
+
+| 序号 | 总结内容 | 是否完成 | 情况说明 |
+| ---- | ------------------------------------------------ |------|--------------------------------------------------------------|
+| 1 | 确定分工 | 完成 | 2023-10-20 开会细分确定团队分工 |
+| 2 | 协调完成数据库设计 | 进行中 | 为王磊完成数据库设计提供支持 |
+| 3 | 设计用例文档 | 完成 | 完成用例文档 |
+| 4 | 更新需求文档 | 进行中 | 在原型界面完成后更新需求文档 |
+## 对团队工作的建议
+
+1. **互助学习:** 小组成员应该根据自身的技能长短开展互帮互助的活动,共同努力提高小组成员的专业水平;
+2. **进度统一:** 团队成员尽量统一项目进度;
+
+## 小结
+
+1. **设计用例文档:** 完成了用例文档初稿;
+2. **技能学习:** 学习了用例图,用例文档相关知识;
+3. **项目管理:** 作为PM及时推进项目进度,确保工作有条不紊;
+4. **团队协作**:与团队成员保持良好的沟通协作,确保设计方向与产品需求一致
+
+---
+
+## 【注】
+
+1. 在小结一栏中写出希望得到如何的帮助,如讲座等;
+2. 请将个人计划和总结提前发给负责人;
+3. 周任务总结与计划是项目小组评分考核的重要依据,将直接记入平时成绩,请各位同学按要求认真填写并按时提交;
+4. 所有组员都需提交个人周计划、周总结文档,上传至代码托管平台;
\ No newline at end of file
diff --git a/doc/process/weekly/week-6/members/luoyuehang-weekly-plan-06.md b/doc/process/weekly/week-6/members/luoyuehang-weekly-plan-06.md
new file mode 100644
index 0000000..f064720
--- /dev/null
+++ b/doc/process/weekly/week-6/members/luoyuehang-weekly-plan-06.md
@@ -0,0 +1,23 @@
+# 个人周计划-第6周
+
+## 姓名和起止时间
+
+**姓 名:** [罗月航]
+**团队名称:** 1班-汪汪队
+**开始时间:** 2025-10-27
+**结束时间:** 2025-11-02
+
+## 本周任务计划安排
+
+| 序号 | 计划内容 | 协作人 | 情况说明 |
+| ---- | -------- | ------ | -------- |
+| 1 | 维修人员APP原型优化完善 | 个人 | 根据第二周评审反馈,优化界面布局、交互细节和视觉效果,提升用户体验 |
+| 2 | 复杂交互功能实现 | 个人 | 在Axure中实现完整的交互动效,包括页面跳转、状态切换、数据加载等交互场景 |
+| 3 | 原型可用性测试 | 组员 | 组织小范围原型测试,收集用户反馈并记录改进点 |
+| 4 | 前端开发准备 | 组员 | 与前端开发同学沟通,确保设计稿的技术可行性,提供必要的设计资源 |
+
+## 小结
+
+1. **用户反馈**:需要协调部分同学参与原型测试,收集真实用户的使用反馈;
+2. **开发协作**:需要前端开发同学提前介入,评估设计实现的技术难度和可行性。
+
diff --git a/doc/process/weekly/week-6/members/luoyuehang-weekly-summary-05.md b/doc/process/weekly/week-6/members/luoyuehang-weekly-summary-05.md
new file mode 100644
index 0000000..f25b91e
--- /dev/null
+++ b/doc/process/weekly/week-6/members/luoyuehang-weekly-summary-05.md
@@ -0,0 +1,30 @@
+# 个人周总结-第5周
+
+## 姓名和起止时间
+
+**姓 名:** [罗月航]
+**团队名称:** 1班-汪汪队
+**开始时间:** 2025-10-20
+**结束时间:** 2025-10-26
+
+## 本周任务完成情况
+
+| 序号 | 总结内容 | 是否完成 | 情况说明 |
+| ---- | -------- | -------- | -------- |
+| 1 | 维修人员APP原型UI设计 | 完成 | 使用Axure完成了维修人员APP部分核心页面的原型设计,包括登录页、工单处理等主要界面 |
+| 2 | 界面交互流程设计 | 完成 | 设计了完整的用户交互流程,实现了页面间的跳转逻辑和状态切换 |
+| 3 | 原型评审与优化 | 完成 | 参与团队原型评审会议,根据反馈意见对界面布局和交互细节进行了优化调整 |
+| 4 | 设计规范统一 | 完成 | 与团队成员共同确定了颜色规范、组件样式和交互模式,保持设计一致性 |
+| 5 | 原型交互功能实现 | 部分完成 | 在Axure中实现了基础的交互动效,部分复杂交互还需进一步完善 |
+
+## 对团队工作的建议
+
+1. **设计协作**:建议建立团队共享的设计组件库,提高设计效率和一致性;
+2. **评审机制**:建议每周固定时间进行设计评审,及时发现问题并优化;
+3. **文档同步**:设计变更应及时更新相关文档,确保前后端开发理解一致;
+
+## 小结
+
+1. **设计产出**:完成了维修人员APP的完整原型设计,涵盖了设备监控、工单处理等核心功能模块;
+2. **技术提升**:通过Axure工具的使用,提升了原型设计能力和交互设计思维;
+3. **团队协作**:与团队成员保持良好的沟通协作,确保设计方向与产品需求一致;
diff --git a/doc/process/weekly/week-6/members/wanglei-weekly-plan-06.md b/doc/process/weekly/week-6/members/wanglei-weekly-plan-06.md
new file mode 100644
index 0000000..e858784
--- /dev/null
+++ b/doc/process/weekly/week-6/members/wanglei-weekly-plan-06.md
@@ -0,0 +1,33 @@
+# 个人周计划-第6周
+
+## 姓名和起止时间
+
+**姓 名:** 王磊
+**团队名称:** 1班-汪汪队
+**开始时间:** 2023-10-27
+**结束时间:** 2023-11-2
+
+
+## 本周任务计划安排
+
+|序号| 计划内容| 协作人 | 情况说明 |
+| ---- | ------ | ------| ------- |
+| 1 | 确定分工 | 组员 | 2025-10-27 开会细分确定团队分工, |
+| 2 | 解决项目编译问题 | 个人 | 重点解决当前项目的编译错误和依赖配置问题 |
+| 3 | 系统功能测试 | 个人 | 完成系统数据库功能的完整测试 |
+
+
+## 小结
+
+1. **技术重点:** 深入解决项目技术难题,完善系统稳定性;
+2. **知识储备:** 提前学习后续需要使用的知识,为后续的后端开发做准备;
+3. **文档撰写:** 结合课内知识学习需求文档的撰写。
+
+---
+
+## 【注】
+
+1. 在小结一栏中写出希望得到如何的帮助,如讲座等;
+1. 请将个人计划和总结提前发给负责人;
+1. 周任务总结与计划是项目小组评分考核的重要依据,将直接记入平时成绩,请各位同学按要求认真填写并按时提交;
+1. 所有组员都需提交个人周计划、周总结文档,按时上传至代码托管平台;
\ No newline at end of file
diff --git a/doc/process/weekly/week-6/members/wanglei-weekly-summary-05.md b/doc/process/weekly/week-6/members/wanglei-weekly-summary-05.md
new file mode 100644
index 0000000..3ed3755
--- /dev/null
+++ b/doc/process/weekly/week-6/members/wanglei-weekly-summary-05.md
@@ -0,0 +1,43 @@
+
+# 个人周总结-第5周
+
+## 姓名和起止时间
+
+**姓 名:** 王磊
+**团队名称:** 1班-汪汪队
+**开始时间:** 2025-10-20
+**结束时间:** 2025-10-26
+
+## 本周任务完成情况
+
+序号 总结内容 是否完成 情况说明
+1 数据库设计与完善 基本完成 完成校园直饮矿化水系统的完整数据库设计,包括设备管理、传感器数据、业务逻辑等核心表结构
+2 实体类与数据访问层开发 完成 完成所有实体类(Entity)和数据访问层(Repository)的开发,包括设备、区域、工单、告警等核心模块
+3 MQTT数据转发服务实现 完成 实现完整的MQTT数据接收、解析、存储和转发服务,支持多客户端数据分发
+4 系统集成与编译测试 进行中 完成项目基础架构搭建,正在进行系统集成测试和编译问题排查
+
+
+## 对团队工作的建议
+
+1. **互助学习:** 小组成员应该根据自身的技能长短开展互帮互助的活动,共同努力提高小组成员的专业水平;
+2. **进度统一:** 团队成员尽量统一项目进度;
+
+## 小结
+
+
+1.技术收获: 深入掌握了Spring Boot项目架构设计、JPA数据持久化、MQTT实时通信等后端开发核心技术;
+
+2.问题解决: 成功解决了数据库连接配置、项目依赖管理、包结构设计等关键技术问题;
+
+3.项目管理: 在实践中学习了大型项目的模块化设计和团队协作开发模式;
+
+4.后续重点: 需要重点解决当前的项目编译问题,完善业务逻辑层和服务层实现,推进前后端联调测试。
+
+---
+
+## 【注】
+
+1. 在小结一栏中写出希望得到如何的帮助,如讲座等;
+2. 请将个人计划和总结提前发给负责人;
+3. 周任务总结与计划是项目小组评分考核的重要依据,将直接记入平时成绩,请各位同学按要求认真填写并按时提交;
+4. 所有组员都需提交个人周计划、周总结文档,上传至代码托管平台;
\ No newline at end of file
diff --git a/doc/process/weekly/week-6/members/zhanghongwei-weekly-plan-6.md b/doc/process/weekly/week-6/members/zhanghongwei-weekly-plan-6.md
new file mode 100644
index 0000000..2952d69
--- /dev/null
+++ b/doc/process/weekly/week-6/members/zhanghongwei-weekly-plan-6.md
@@ -0,0 +1,24 @@
+# 个人周计划-第6周
+
+## 姓名和起止时间
+
+**姓 名:** 张红卫
+**团队名称:** 1班-汪汪队
+**开始时间:** 2025-10-27
+**结束时间:** 2025-11-02
+
+## 本周任务计划安排
+
+| 序号 | 计划内容 | 协作人 | 情况说明 |
+|------|----------|--------|----------|
+| 1 | 完善界面原型设计 | 个人 | 基于第5周反馈,对管理人员Web页面原型进行美化和细节优化 |
+| 2 | 深入学习Axure工具 | 个人 | 系统学习Axure交互功能和组件库使用,提升原型设计效率 ||
+| 3 | 准备原型设计评审 | 组员 | 整理完善后的原型设计,准备进行小组评审并加以调整 |
+
+## 小结
+
+1. **工具技能:** 还需重点掌握Axure的动态面板、交互事件等高级功能
+2. **设计能力:** 提升界面美化和用户体验细节处理能力
+3. **知识储备:** 了解前端html的相关知识
+
+---
\ No newline at end of file
diff --git a/doc/process/weekly/week-6/members/zhanghongwei-weekly-summary-05.md b/doc/process/weekly/week-6/members/zhanghongwei-weekly-summary-05.md
new file mode 100644
index 0000000..e5f1ae2
--- /dev/null
+++ b/doc/process/weekly/week-6/members/zhanghongwei-weekly-summary-05.md
@@ -0,0 +1,37 @@
+# 个人周总结-第5周
+
+## 基本信息
+**姓 名:** 张红卫
+**团队名称:** 1班-汪汪队
+**总结周期:** 2025年10月20日 - 2025年10月26日
+
+## 本周任务完成情况
+
+### ✅ 已完成任务
+| 序号 | 任务内容 | 完成状态 | 成果输出 |
+|------|----------|----------|----------|
+| 1 | 学习界面设计原则 | 进行中 | 对界面原型设计已经有了大致的了解 |
+| 2 | 设计管理人员Web页面原型 | 进行中 | 基本完成基本功能界面的基础原型设计 |
+| 3 | 界面设计评审与优化 | 进行中 | 组织小组评审,收集反馈并进行了初步调整 |
+| 4 | 前端技术预研 | 进行中 | 了解了Web前端开发技术,为后续界面实现打下基础 |
+
+## 主要成果与进展
+
+1. **知识学习方面**
+ - 系统学习了用户体验设计
+ - 掌握了管理平台界面设计的常用规范
+
+2. **实践产出方面**
+ - 基本完成了管理人员Web页面的基础原型设计
+ - 通过小组评审获得了有价值的改进建议
+ - 建立了初步的前端技术认知框架
+
+## 存在问题与挑战
+
+1. **技能提升需求**
+ - 原型设计工具使用熟练度有待提高
+ - 需要系统学习管理类系统的设计模式
+ - 前端开发知识储备需要进一步加强
+
+## 总结
+本周按计划基本完成了界面设计学习和基础原型设计工作,下一步重点是在现有基础上进行界面美化优化。
\ No newline at end of file
diff --git a/doc/process/weekly/week-6/members/zhoujingyou-weekly-plan-06.md b/doc/process/weekly/week-6/members/zhoujingyou-weekly-plan-06.md
new file mode 100644
index 0000000..d0ed527
--- /dev/null
+++ b/doc/process/weekly/week-6/members/zhoujingyou-weekly-plan-06.md
@@ -0,0 +1,26 @@
+# 个人周计划-第6周
+
+## 姓名和起止时间
+
+**姓 名:** 周竞由
+**团队名称:** 软1-汪汪队
+**开始时间:** 2025-10-27
+**结束时间:** 2025-11-02
+
+## 本周任务计划安排
+
+| 序号 | 计划内容 | 协作人 | 情况说明 |
+|----|---------------------|-----|-------------------------|
+| 1 | 完善学生端整体原型结构 | 个人 | 整合各功能页面原型,统一页面跳转逻辑与交互路径 |
+| 2 | 优化首页与导航交互体验 | 个人 | 调整首页信息层次,完善底部导航与页面切换动效 |
+| 3 | 深化“扫码用水”与“查看水质”原型细节 | 个人 | 增加交互提示、反馈状态与数据展示动态示意 |
+| 4 | 优化“用水记录”与“水机位置”页面原型 | 个人 | 调整筛选、搜索交互流程,增强界面信息层次 |
+| 5 | 统一视觉与交互规范 | 个人 | 制定组件风格、配色与字体规范,保证整体一致性 |
+| 6 | 团队原型评审与反馈汇总 | 组员 | 组织团队评审会议,收集意见并整理优化方向 |
+
+## 小结
+
+1. **设计目标:** 本周重点是完善学生端整体交互原型,使页面之间逻辑清晰、风格统一;
+2. **学习提升:** 学习Axure/Figma中复杂交互设计与动态原型制作技巧,提高原型表现力;
+3. **协作重点:** 与组员统一原型展示结构,确保各功能模块交互方式一致;
+4. **下周展望:** 根据评审反馈进行最终优化,准备学生端原型的阶段性展示与文档整理。
diff --git a/doc/process/weekly/week-6/members/zhoujingyou-weekly-summary-05.md b/doc/process/weekly/week-6/members/zhoujingyou-weekly-summary-05.md
new file mode 100644
index 0000000..dd09f5c
--- /dev/null
+++ b/doc/process/weekly/week-6/members/zhoujingyou-weekly-summary-05.md
@@ -0,0 +1,28 @@
+# 个人周总结-第5周
+
+## 姓名和起止时间
+
+**姓 名:** 周竞由
+**团队名称:** 软1-汪汪队
+**开始时间:** 2025-10-20
+**结束时间:** 2025-10-26
+
+## 本周任务完成情况
+
+| 序号 | 计划内容 | 完成情况 | 说明 |
+|----|--------------|------|----------------------------|
+| 1 | 学生端首页UI细化设计 | 基本完成 | 完成首页模块布局、配色与字体优化,统一整体视觉风格 |
+| 2 | “扫码用水”功能页面设计 | 基本完成 | 完成扫码界面与反馈界面初版设计,待补充交互流程细节 |
+| 3 | “查看水质”页面设计 | 基本完成 | 完成水质数据图表布局与信息展示结构,视觉层次清晰 |
+| 4 | “用水记录”页面设计 | 基本完成 | 完成界面框架设计,计划下周完善筛选功能原型与统计展示 |
+| 5 | “水机位置”页面设计 | 部分完成 | 完成地图定位界面与搜索布局草图,后续优化交互细节 |
+| 6 | 团队UI评审与反馈整理 | 基本完成 | 参与团队设计评审会议,收集多项改进建议并形成优化清单 |
+
+## 本周总结
+
+1. **阶段成果:** 已完成学生端主要功能页面的UI原型设计,基本确定整体视觉风格与信息架构;
+2. **优化进展:** 针对首页与水质页面进行了细化与调整,提升了信息展示的清晰度与一致性;
+3. **存在问题:** 个别功能页面的交互逻辑仍需补充(如扫码反馈、用水记录筛选逻辑);
+4. **改进方向:** 下周将继续完善交互细节,统一页面跳转逻辑,形成完整的学生端原型结构;
+5. **学习体会:** 通过本周设计实践,对UI一致性与用户体验设计有了更深入的理解。
+
diff --git a/doc/process/weekly/week-7/group/meeting-minutes-7.md b/doc/process/weekly/week-7/group/meeting-minutes-7.md
new file mode 100644
index 0000000..f3ce8de
--- /dev/null
+++ b/doc/process/weekly/week-7/group/meeting-minutes-7.md
@@ -0,0 +1,34 @@
+# 小组会议纪要-第7周
+
+## 会议记录概要
+
+**团队名称:** 1班-汪汪队
+**指导老师:** 肖雄仁
+**主 持 人:** 曹峻茂
+**记录人员:** 张红卫
+**会议主题:** 继原型界面评审后的进一步完善
+**会议地点:** 宿舍
+**会议时间:** 2025-11-3 12:30-13:30
+**纪录时间:** 2025-11-3 18:00
+**参与人员:** 曹峻茂、张红卫、罗月航、周竞由、王磊
+
+---
+
+## 会议内容
+
+### 1. 原型界面最后完善
+
+继原型界面评审后对原型界面做风格上的统一与部分问题在小班讨论展示前做最后的完善修改。
+
+### 2. 数据库设计与完善
+
+针对小班讨论的展示,做数据库设计的同学做进一步的完善与详解。
+
+### 3. 原型界面与用例文档协同优化
+
+前端与后端团队的协作配合,针对原型界面设计与用例文档之间存在的差异进行进一步的相互调整与完善。
+
+### 4.具体任务安排
+- 原型界面的统一与完善:张红卫,罗月航,周竞由
+- 数据库的进一步完善:王磊
+- 用例文档的调整:曹峻茂
\ No newline at end of file
diff --git a/doc/process/weekly/week-7/group/weekly-plan-7.md b/doc/process/weekly/week-7/group/weekly-plan-7.md
new file mode 100644
index 0000000..3d289d4
--- /dev/null
+++ b/doc/process/weekly/week-7/group/weekly-plan-7.md
@@ -0,0 +1,36 @@
+# 小组周计划-第7周
+
+## 团队名称和起止时间
+
+**团队名称:** 软1-汪汪队
+**开始时间:** 2025-11-3
+**结束时间:** 2025-11-9
+
+## 本周任务计划安排
+
+
+| 序号 | 计划内容 | 执行人 | 情况说明 |
+|----|-----------------------|-------------|-------------------------|
+| 1 | 确定本周计划分工 | 全体组员 | 2023-11-3 开会确定计划以及团队分工 |
+| 2 | 根据老师意见改正原型设计 | 罗月航,周竞由,张红卫 | 改正原型页面设计的问题 |
+| 3 | 学习 | 全体组员 | 继续学习相关知识,在做中学 |
+| 4 | 在power design上展示数据库设计 | 王磊 | 学习在power design上展示数据库设计 |
+| 5 | 根据最终原型生成用例文档最终稿 | 曹峻茂 | 生成用例文档最终稿 |
+|6|完成项目前景与范围文档和需求规格说明书| 曹峻茂 |完成并提交项目前景与范围文档和需求规格说明书|
+## 小结
+
+1. **增强自信心:** 小组成员应增强自信心,发挥想象力和创造力,在原型设计环节积极思考。
+2. **沟通协作:** 小组成员应积极主动沟通,遇到困难及时寻求帮助,也可以主动向指导老师及研究生学长寻求建议。
+3. **学习安排:** 小组成员仍处于软件开发专业知识的初步学习阶段,应合理安排自主学习时间,以便后续开发的顺利进行。
+4. **项目管理:** PM及时推进项目流程,确保项目有条不紊。
+
+---
+
+## 【注】
+
+1. 在小结一栏中写出希望得到如何的帮助,如讲座等;
+2. 请将个人计划和总结提前发给负责人;
+3. 周任务总结与计划是项目小组评分考核的重要依据,将直接记入平时成绩,请各位同学按要求认真填写并按时提交;
+4. PM综合本小组成员工作情况提交小组周计划、周总结报告,按时上传至代码托管平台。
+
+---
\ No newline at end of file
diff --git a/doc/process/weekly/week-7/group/weekly-summary-6.md b/doc/process/weekly/week-7/group/weekly-summary-6.md
new file mode 100644
index 0000000..6e0c300
--- /dev/null
+++ b/doc/process/weekly/week-7/group/weekly-summary-6.md
@@ -0,0 +1,36 @@
+# 小组周总结-第6周
+
+## 团队名称和起止时间
+
+**团队名称:** 软1-汪汪队
+**开始时间:** 2025-10-27
+**结束时间:** 2025-11-2
+
+## 本周任务计划安排
+
+
+| 序号 | 总结内容 | 是否完成 | 情况说明 |
+|----|--------------|------|------------------------------|
+| 1 | 确定本周分工 | 是 | 2023-10-27 开会细分确定团队分工,统一开发工具 |
+| 2 | 商讨原型设计 | 是 | 与老师联系获取老师关于原型的建议 |
+| 3 | 学习 | 是 | 继续学习相关知识,在做中学 |
+| 4 | 继续完善数据库设计和实现 | 是 | 继续完成数据库设计和实现 |
+| 5 | 完善当前的原型页面设计 | 进行中 | 完善当前的原型页面 |
+|6|根据讨论结果更新需求文档| 是 |更新需求文档|
+## 小结
+
+1. **增强自信心:** 小组成员应增强自信心,发挥想象力和创造力,在原型设计环节积极思考。
+2. **沟通协作:** 小组成员应积极主动沟通,遇到困难及时寻求帮助,也可以主动向指导老师及研究生学长寻求建议。
+3. **学习安排:** 小组成员仍处于软件开发专业知识的初步学习阶段,应合理安排自主学习时间,以便后续开发的顺利进行。
+4. **项目管理:** PM及时推进项目流程,确保项目有条不紊。
+
+---
+
+## 【注】
+
+1. 在小结一栏中写出希望得到如何的帮助,如讲座等;
+2. 请将个人计划和总结提前发给负责人;
+3. 周任务总结与计划是项目小组评分考核的重要依据,将直接记入平时成绩,请各位同学按要求认真填写并按时提交;
+4. PM综合本小组成员工作情况提交小组周计划、周总结报告,按时上传至代码托管平台。
+
+---
\ No newline at end of file
diff --git a/doc/process/weekly/week-7/members/caojunmao-weekly-plan-7.md b/doc/process/weekly/week-7/members/caojunmao-weekly-plan-7.md
new file mode 100644
index 0000000..7907c68
--- /dev/null
+++ b/doc/process/weekly/week-7/members/caojunmao-weekly-plan-7.md
@@ -0,0 +1,34 @@
+# 个人周计划-第7周
+
+## 姓名和起止时间
+
+**姓 名:** 曹峻茂
+**团队名称:** 软1-汪汪队
+**开始时间:** 2025-11-3
+**结束时间:** 2025-11-9
+
+
+## 本周任务计划安排
+| 序号 | 计划内容 | 协作人 | 情况说明 |
+|----|-----------------|-------------|-----------------------|
+| 1 | 确定分工 | 组员 | 2023-11-3 开会确定计划和团队分工 |
+|2| 与老师讨论 | 组员 | 与老师讨论当前用例和原型设计 |
+| 4 | 根据最终原型完成用例文档最终稿 | 周竞由,罗月航,张红卫 | 完成用例文档最终稿 |
+|5|完成项目前景与范围文档和需求规格说明书|小组成员|完成并提交项目前景与范围文档和需求规格说明书|
+
+## 小结
+
+1. **学习需求:** 希望能有对于用例文档设计和需求文档格式的教学;
+2. **知识储备:** 学习后续需要使用的知识,为后续的开发做准备;
+3. **文档撰写:** 结合课内知识学习需求文档的撰写。
+4. **代码实现** 参与数据库设计
+---
+
+## 【注】
+
+1. 在小结一栏中写出希望得到如何的帮助,如讲座等;
+1. 请将个人计划和总结提前发给负责人;
+1. 周任务总结与计划是项目小组评分考核的重要依据,将直接记入平时成绩,请各位同学按要求认真填写并按时提交;
+1. 所有组员都需提交个人周计划、周总结文档,按时上传至代码托管平台;
+
+---
\ No newline at end of file
diff --git a/doc/process/weekly/week-7/members/caojunmao-weekly-summary-06.md b/doc/process/weekly/week-7/members/caojunmao-weekly-summary-06.md
new file mode 100644
index 0000000..281713c
--- /dev/null
+++ b/doc/process/weekly/week-7/members/caojunmao-weekly-summary-06.md
@@ -0,0 +1,37 @@
+# 个人周总结-第6周
+
+## 姓名和起止时间
+
+**姓 名:** 曹峻茂
+**团队名称:** 1班-汪汪队
+**开始时间:** 2025-10-27
+**结束时间:** 2025-11-2
+
+## 本周任务完成情况
+
+| 序号 | 总结内容 | 是否完成 | 情况说明 |
+| ---- | ------------------------------------------------ |------|--------------------------------------------------------------|
+| 1 | 确定分工 | 完成 | 2023-10-27 开会细分确定团队分工 |
+|2| 与老师讨论 | 完成 | 与老师讨论当前用例和原型设计 |
+| 2 | 继续协调完成数据库设计 | 王完成 | 继续为王磊完成数据库设计提供支持 |
+| 4 | 更新需求文档 | 完成 | 根据本周计划和更改更新需求文档 |
+## 对团队工作的建议
+
+1. **互助学习:** 小组成员应该根据自身的技能长短开展互帮互助的活动,共同努力提高小组成员的专业水平;
+2. **进度统一:** 团队成员尽量统一项目进度;
+
+## 小结
+
+1. **设计用例文档:** 完成了用例文档初稿;
+2. **技能学习:** 学习了用例图,用例文档相关知识;
+3. **项目管理:** 作为PM及时推进项目进度,确保工作有条不紊;
+4. **团队协作**:与团队成员保持良好的沟通协作,确保设计方向与产品需求一致
+
+---
+
+## 【注】
+
+1. 在小结一栏中写出希望得到如何的帮助,如讲座等;
+2. 请将个人计划和总结提前发给负责人;
+3. 周任务总结与计划是项目小组评分考核的重要依据,将直接记入平时成绩,请各位同学按要求认真填写并按时提交;
+4. 所有组员都需提交个人周计划、周总结文档,上传至代码托管平台;
\ No newline at end of file
diff --git a/doc/process/weekly/week-7/members/luoyuehang-weekly-plan-07.md b/doc/process/weekly/week-7/members/luoyuehang-weekly-plan-07.md
new file mode 100644
index 0000000..fdea60b
--- /dev/null
+++ b/doc/process/weekly/week-7/members/luoyuehang-weekly-plan-07.md
@@ -0,0 +1,25 @@
+# 个人周计划-第7周
+
+## 姓名和起止时间
+
+**姓 名:** [罗月航]
+**团队名称:** 1班-汪汪队
+**开始时间:** 2025-11-03
+**结束时间:** 2025-11-09
+
+## 本周任务计划安排
+
+| 序号 | 计划内容 | 协作人 | 情况说明 |
+| ---- | -------- | ------ | -------- |
+| 1 | 原型设计改良优化 | 个人 | 根据与老师的会议反馈,针对性地改良维修人员APP原型设计,优化用户体验和界面布局 |
+| 2 | 用例文档完善协作 | PM | 协助产品经理完成用例文档最终稿,确保功能描述准确性和完整性 |
+| 3 | 交互细节优化 | 个人 | 针对老师提出的具体建议,优化原型中的交互流程和动效设计 |
+| 4 | 设计评审准备 | 组员 | 准备改良后的原型设计评审材料,整理修改说明和优化点 |
+| 5 | 用户流程验证 | 组员 | 组织内部测试,验证改良后的用户流程是否满足老师提出的要求 |
+
+## 小结
+
+1. **需求明确**:需要老师提供更具体的改良建议和优化方向;
+2. **协作支持**:需要PM及时同步用例文档的修改内容和进度;
+3. **技术指导**:希望在交互设计和用户体验方面获得专业指导;
+4. **测试资源**:需要协调团队成员参与原型测试,收集反馈意见。
diff --git a/doc/process/weekly/week-7/members/luoyuehang-weekly-summary-06.md b/doc/process/weekly/week-7/members/luoyuehang-weekly-summary-06.md
new file mode 100644
index 0000000..cf8d681
--- /dev/null
+++ b/doc/process/weekly/week-7/members/luoyuehang-weekly-summary-06.md
@@ -0,0 +1,34 @@
+# 个人周总结-第六周
+
+## 姓名和起止时间
+
+**姓 名:** [罗月航]
+**团队名称:** 1班-汪汪队
+**开始时间:** 2025-10-27
+**结束时间:** 2025-11-02
+
+## 本周任务完成情况
+
+| 序号 | 总结内容 | 是否完成 | 情况说明 |
+| ---- | -------- | -------- | -------- |
+| 1 | 维修人员APP原型优化完善 | 完成 | 根据层级系统重新设计设备巡检模块,实现了市区-片区-学校-制水机-供水机-终端机的完整层级导航 |
+| 2 | 制水机详情页面开发 | 完成 | 开发了独立的制水机详情页面,包含完整的TDS数据监控、滤芯状态、运行参数等功能 |
+| 3 | 设备关系可视化 | 完成 | 实现了制水机、供水机、终端机之间的供水关系可视化,清晰展示设备间的连接关系 |
+| 4 | 交互流程优化 | 完成 | 优化了页面间的跳转逻辑和状态管理,提升了用户体验 |
+|
+
+## 对团队工作的建议
+
+1. **数据接口规范**:建议后端团队按照新的层级结构提供设备数据接口,确保前后端数据格式一致;
+2. **测试协作**:需要测试同学协助进行原型功能测试,特别是层级导航和设备关系的正确性验证;
+3. **文档更新**:设计变更后需要及时更新相关技术文档,便于后续开发和维护;
+4. **性能优化**:建议对层级数据的加载进行性能优化,确保在大数据量下的流畅体验。
+
+## 小结
+
+1. **技术成果**:成功实现了基于层级系统的设备管理界面,完整呈现了设备间的供水关系;
+2. **用户体验**:通过层级导航和可视化关系图,大大提升了用户对设备布局的理解;
+3. **代码质量**:采用模块化设计,代码结构清晰,便于后续功能扩展;
+4. **问题解决**:在实现过程中解决了层级数据管理和状态同步的技术难点;
+
+
diff --git a/doc/process/weekly/week-7/members/wanglei-weekly-plan-07.md b/doc/process/weekly/week-7/members/wanglei-weekly-plan-07.md
new file mode 100644
index 0000000..e1535f0
--- /dev/null
+++ b/doc/process/weekly/week-7/members/wanglei-weekly-plan-07.md
@@ -0,0 +1,33 @@
+# 个人周计划-第7周
+
+## 姓名和起止时间
+
+**姓 名:** 王磊
+**团队名称:** 1班-汪汪队
+**开始时间:** 2023-11-2
+**结束时间:** 2023-11-9
+
+
+## 本周任务计划安排
+
+|序号| 计划内容| 协作人 | 情况说明 |
+| ---- | ------ | ------| ------- |
+| 1 | 确定分工 | 组员 | 2025-11-3 开会细分确定团队分工, |
+| 2 | 准备数据库设计讲解材料 | 个人 | 使用Power Design 演示讲解数据库 |
+| 3 | 填充基础数据 | 个人 | 向数据库中填充区域、维修人员等基础业务数据,确保数据符合业务逻辑 |
+
+
+## 小结
+
+1. **技术重点:** 掌握PowerDesigner工具的使用,提升数据库设计与表达能力;
+2. **协作重点** 与团队保持沟通,确保数据填充符合业务需求,支持后续开发;
+3. **文档撰写:** 结合课内知识学习需求文档的撰写。
+
+---
+
+## 【注】
+
+1. 在小结一栏中写出希望得到如何的帮助,如讲座等;
+1. 请将个人计划和总结提前发给负责人;
+1. 周任务总结与计划是项目小组评分考核的重要依据,将直接记入平时成绩,请各位同学按要求认真填写并按时提交;
+1. 所有组员都需提交个人周计划、周总结文档,按时上传至代码托管平台;
\ No newline at end of file
diff --git a/doc/process/weekly/week-7/members/wanglei-weekly-summary-06.md b/doc/process/weekly/week-7/members/wanglei-weekly-summary-06.md
new file mode 100644
index 0000000..0e73dcb
--- /dev/null
+++ b/doc/process/weekly/week-7/members/wanglei-weekly-summary-06.md
@@ -0,0 +1,43 @@
+
+# 个人周总结-第6周
+
+## 姓名和起止时间
+
+**姓 名:** 王磊
+**团队名称:** 1班-汪汪队
+**开始时间:** 2025-10-27
+**结束时间:** 2025-11-2
+
+## 本周任务完成情况
+
+序号 总结内容 是否完成 情况说明
+1 数据库规范化设计与评审 完成 完成数据库第三范式改造,建立16个完整的外键约束,确保数据一致性和完整性
+2 项目编译问题解决 完成 彻底解决所有编译错误,包括Alert实体类重构、Repository层优化等关键技术问题
+3 系统功能完整测试 完成 完成数据库关联查询验证、API接口测试、外键约束测试,系统稳定运行
+4 数据库设计评审准备 完成 数据库设计完全符合评审要求,具备完整的参照完整性和业务逻辑约束
+
+
+## 对团队工作的建议
+
+1. **互助学习:** 小组成员应该根据自身的技能长短开展互帮互助的活动,共同努力提高小组成员的专业水平;
+2. **进度统一:** 团队成员尽量统一项目进度;
+
+## 小结
+
+
+1.技术收获: 掌握了数据库规范化设计与系统架构优化,深入理解了第三范式、外键约束、参照完整性等高级数据库概念,成功实践了Spring Boot全栈开发流程,提升了复杂技术问题的定位和解决能力。
+
+2.问题解决: 成功根治了系统编译错误和数据一致性问题,通过重构Alert实体类、优化Repository层、完善Service业务逻辑,解决了因数据库结构调整引发的连锁技术问题,确保了系统稳定运行。
+
+3.项目管理: 实践了"架构先行、业务后完善"的科学开发模式,建立了完整的测试验证流程和质量保障体系,通过模块化设计和迭代开发,为团队项目奠定了坚实的技术基础。
+
+4.后续重点: 推进业务数据协调与系统集成测试,重点与其他组员确定具体业务数据结构,开展前后端联调工作,并在业务稳定后推进系统性能优化和部署运维。
+
+---
+
+## 【注】
+
+1. 在小结一栏中写出希望得到如何的帮助,如讲座等;
+2. 请将个人计划和总结提前发给负责人;
+3. 周任务总结与计划是项目小组评分考核的重要依据,将直接记入平时成绩,请各位同学按要求认真填写并按时提交;
+4. 所有组员都需提交个人周计划、周总结文档,上传至代码托管平台;
\ No newline at end of file
diff --git a/doc/process/weekly/week-7/members/zhanghongwei-weekly-plan-7.md b/doc/process/weekly/week-7/members/zhanghongwei-weekly-plan-7.md
new file mode 100644
index 0000000..df895f1
--- /dev/null
+++ b/doc/process/weekly/week-7/members/zhanghongwei-weekly-plan-7.md
@@ -0,0 +1,21 @@
+# 个人周计划-第7周
+
+## 姓名和起止时间
+
+**姓 名:** 张红卫
+**团队名称:** 1班-汪汪队
+**开始时间:** 2025-11-03
+**结束时间:** 2025-11-09
+
+## 本周任务计划安排
+
+| 序号 | 计划内容 | 协作人 | 情况说明 |
+|------|----------|--------|----------|
+| 1 | 对原型界面最后的完善 | 个人 | 基于第6周老师与组员间的会议反馈做最后完善工作 |
+| 2 | 辅助完成用例文档 | 组员 | 在修改原型界面的同时与需求文档编写人员做最后敲定 |
+
+## 小结
+
+1. **工具技能:** 还需重点掌握Axure各种组件的使用
+2. **设计能力:** 提升界面美化和用户体验细节处理能力
+3. **知识储备:** 还需继续了解前端html的相关知识
diff --git a/doc/process/weekly/week-7/members/zhanghongwei-weekly-summary-06.md b/doc/process/weekly/week-7/members/zhanghongwei-weekly-summary-06.md
new file mode 100644
index 0000000..b224ef1
--- /dev/null
+++ b/doc/process/weekly/week-7/members/zhanghongwei-weekly-summary-06.md
@@ -0,0 +1,27 @@
+# 个人周总结-第6周
+
+## 基本信息
+**姓 名:** 张红卫
+**团队名称:** 1班-汪汪队
+**总结周期:** 2025年10月27日 - 2025年11月2日
+
+## 本周任务完成情况
+
+### 已完成任务
+| 序号 | 任务内容 | 完成状态 | 成果输出 |
+|------|----------|----------|----------|
+| 1 | 原型界面设计完善 | 进行中 |在本周与老师进行评审后对原型界面进行进一步的完善 |
+| 2 | 前端技术预研 | 进行中 | 了解了Web前端开发技术,为后续界面实现打下基础 |
+
+## 主要成果与进展
+
+1. **知识学习方面**
+ - 与老师进行交流会更加深入的了解了如何深入和完善需求
+
+2. **实践产出方面**
+ - 通过会议评审获得了有价值的改进建议
+ - 建立了初步的前端技术认知框架
+
+
+## 总结
+本周按计划基本完成了界面设计学习和基础原型设计工作,下一步重点是在现有基础上进行界面美化优化。
\ No newline at end of file
diff --git a/doc/process/weekly/week-7/members/zhoujingyou-weekly-plan-07.md b/doc/process/weekly/week-7/members/zhoujingyou-weekly-plan-07.md
new file mode 100644
index 0000000..7d65f9a
--- /dev/null
+++ b/doc/process/weekly/week-7/members/zhoujingyou-weekly-plan-07.md
@@ -0,0 +1,26 @@
+# 个人周计划-第7周
+
+## 姓名和起止时间
+
+**姓 名:** 周竞由
+**团队名称:** 软1-汪汪队
+**开始时间:** 2025-11-03
+**结束时间:** 2025-11-09
+
+## 本周任务计划安排
+
+| 序号 | 计划内容 | 协作人 | 情况说明 |
+|----|---------------|-----|-----------------------------|
+| 1 | 根据评审反馈优化学生端原型 | 个人 | 根据上周评审结果调整界面布局与交互逻辑,提升整体一致性 |
+| 2 | 完善动态交互与页面细节 | 个人 | 补充页面切换动画、交互提示与按钮反馈效果 |
+| 3 | 调整页面视觉层次与配色规范 | 个人 | 统一图标、文字与色彩体系,优化可读性与对比度 |
+| 4 | 制作学生端原型展示文档 | 个人 | 输出原型展示稿与交互说明,便于团队成员理解设计逻辑 |
+| 5 | 团队阶段性展示准备 | 组员 | 协助整理展示材料,协调团队展示顺序与讲解分工 |
+| 6 | 后续开发衔接规划 | 组员 | 讨论从原型阶段到前端开发的对接方案,明确接口与任务分配 |
+
+## 小结
+
+1. **设计目标:** 本周重点是根据反馈优化原型,补充动态交互与视觉细节,形成可展示的高保真原型版本;
+2. **学习提升:** 学习动画交互与原型讲解技巧,提高设计展示与表达能力;
+3. **协作重点:** 与组员共同完成阶段性展示,确保原型逻辑清晰、内容完整;
+4. **下周展望:** 在原型展示结束后,正式进入前端开发准备阶段,进行组件划分与框架搭建。
diff --git a/doc/process/weekly/week-7/members/zhoujingyou-weekly-summary-06.md b/doc/process/weekly/week-7/members/zhoujingyou-weekly-summary-06.md
new file mode 100644
index 0000000..221d022
--- /dev/null
+++ b/doc/process/weekly/week-7/members/zhoujingyou-weekly-summary-06.md
@@ -0,0 +1,42 @@
+# 个人周总结-第6周
+
+## 姓名和起止时间
+
+**姓 名:** 周竞由
+**团队名称:** 软1-汪汪队
+**开始时间:** 2025-10-27
+**结束时间:** 2025-11-02
+
+## 本周任务完成情况
+
+| 序号 | 计划内容 | 完成情况 | 说明 |
+|----|---------------------|-----|--------------------------------|
+| 1 | 完善学生端整体原型结构 | 已完成 | 整合各功能页面原型,统一跳转逻辑与整体结构,提升原型连贯性 |
+| 2 | 优化首页与导航交互体验 | 基本完成 | 调整首页信息层次与底部导航切换效果,部分动画待后续补充 |
+| 3 | 深化“扫码用水”与“查看水质”原型细节 | 已完成 | 增加交互提示与动态反馈示意,优化数据展示模块的层次感 |
+| 4 | 优化“用水记录”与“水机位置”页面原型 | 基本完成 | 完成筛选与搜索交互流程设计,部分界面细节待评审后修改 |
+| 5 | 统一视觉与交互规范 | 已完成 | 制定组件样式规范(按钮、输入框、图表模块),形成统一UI风格 |
+| 6 | 团队原型评审与反馈汇总 | 已完成 | 组织并参与团队原型评审会议,整理反馈并制定后续优化计划 |
+
+## 本周总结
+
+1. **阶段成果:**
+ 本周完成了学生端整体原型的整合与交互逻辑完善,系统结构清晰,页面跳转顺畅。完成主要功能模块的视觉与交互统一,为后续展示与评审奠定了基础。
+
+2. **优化进展:**
+ - 首页与导航部分优化了视觉层次与信息排布;
+ - “查看水质”页面采用图表模块展示数据,强化了可读性;
+ - 对“用水记录”与“水机位置”页面的搜索、筛选逻辑进行了初步验证。
+
+3. **存在问题:**
+ - 个别页面的过渡动画与交互反馈仍需细化;
+ - 局部组件尺寸和配色在小屏设备上需进一步调整;
+ - 原型文件体积偏大,加载速度稍慢,后续需优化结构。
+
+4. **改进方向:**
+ - 继续细化动态交互与页面衔接;
+ - 根据团队反馈调整部分UI细节;
+ - 优化原型文件结构,准备阶段性原型展示材料。
+
+5. **学习体会:**
+ 本周通过对整体原型的整合与统一,进一步理解了多页面产品的交互逻辑设计方法。熟悉了在Axure中创建动态链接与状态切换的流程,对原型可用性与用户体验的权衡有了更深入的认识。
diff --git a/doc/process/weekly/week-8/group/meeting-minutes-8.md b/doc/process/weekly/week-8/group/meeting-minutes-8.md
new file mode 100644
index 0000000..fadf6e6
--- /dev/null
+++ b/doc/process/weekly/week-8/group/meeting-minutes-8.md
@@ -0,0 +1,33 @@
+# 小组会议纪要-第8周
+
+## 会议记录概要
+
+**团队名称:** 1班-汪汪队
+**指导老师:** 肖雄仁
+**主 持 人:** 曹峻茂
+**记录人员:** 张红卫
+**会议主题:** 迭代开发计划的设计与小班讨论后的相关收尾
+**会议地点:** 宿舍
+**会议时间:** 2025-11-10 12:30-13:30
+**纪录时间:** 2025-11-10 18:00
+**参与人员:** 曹峻茂、张红卫、罗月航、周竞由、王磊
+
+---
+
+## 会议内容
+
+### 1. 人员分工的重新分配
+
+针对迭代开发计划的设计与上一周小班的遗留问题对人员分工做出了重新规划
+
+### 2. 小班展示后的收尾
+
+经过小班展示后,有一次得到了相关建议,针对建议对界面原型进一步修改并向边耐政老师展示。
+
+### 3. 学习
+
+在本周迭代开发计划完后将进一步正式进入编码阶段,相关人员需提前对相关知识做进一步的了解
+
+### 4.具体任务安排
+- 原型界面收尾张红卫,罗月航,周竞由
+- 迭代开发计划的设计:曹峻茂、张红卫、罗月航、周竞由、王磊
diff --git a/doc/process/weekly/week-8/group/weekly-plan-08.md b/doc/process/weekly/week-8/group/weekly-plan-08.md
new file mode 100644
index 0000000..7662e23
--- /dev/null
+++ b/doc/process/weekly/week-8/group/weekly-plan-08.md
@@ -0,0 +1,35 @@
+# 小组周计划-第8周
+
+## 团队名称和起止时间
+
+**团队名称:** 软1-汪汪队
+**开始时间:** 2025-11-10
+**结束时间:** 2025-11-16
+
+## 本周任务计划安排
+
+
+| 序号 | 计划内容 | 执行人 | 情况说明 |
+|----|-----------------|-------------|-------------------------|
+| 1 | 确定本周计划分工 | 全体组员 | 2023-11-10 开会确定计划以及团队分工 |
+| 2 | 与老师讨论开发计划及原型缺陷 | 全体组员 | 讨论开发计划及现有缺陷 |
+| 3 | 学习 | 全体组员 | 继续学习相关知识,在做中学 |
+| 4 | 改正原型页面并向边耐政老师展示 | 罗月航,张红卫,周竞由 | 根据小班讨论要求修正原型 |
+|5|提交数据库设计文档|王磊|根据评审意见修改后提交数据库设计文档|
+## 小结
+
+1. **增强自信心:** 小组成员应增强自信心,发挥想象力和创造力,在原型设计环节积极思考。
+2. **沟通协作:** 小组成员应积极主动沟通,遇到困难及时寻求帮助,也可以主动向指导老师及研究生学长寻求建议。
+3. **学习安排:** 小组成员仍处于软件开发专业知识的初步学习阶段,应合理安排自主学习时间,以便后续开发的顺利进行。
+4. **项目管理:** PM及时推进项目流程,确保项目有条不紊。
+
+---
+
+## 【注】
+
+1. 在小结一栏中写出希望得到如何的帮助,如讲座等;
+2. 请将个人计划和总结提前发给负责人;
+3. 周任务总结与计划是项目小组评分考核的重要依据,将直接记入平时成绩,请各位同学按要求认真填写并按时提交;
+4. PM综合本小组成员工作情况提交小组周计划、周总结报告,按时上传至代码托管平台。
+
+---
\ No newline at end of file
diff --git a/doc/process/weekly/week-8/group/weekly-summary-7.md b/doc/process/weekly/week-8/group/weekly-summary-7.md
new file mode 100644
index 0000000..506be3d
--- /dev/null
+++ b/doc/process/weekly/week-8/group/weekly-summary-7.md
@@ -0,0 +1,36 @@
+# 小组周总结-第7周
+
+## 团队名称和起止时间
+
+**团队名称:** 软1-汪汪队
+**开始时间:** 2025-11-3
+**结束时间:** 2025-11-9
+
+## 本周任务计划安排
+
+
+| 序号 | 总结内容 | 是否完成 | 情况说明 |
+|----|--------------|------|------------------------------|
+| 1 | 确定本周计划分工 | 已完成 | 2023-11-3 开会确定计划以及团队分工 |
+| 2 | 根据老师意见改正原型设计 | 已完成 | 改正原型页面设计的问题 |
+| 3 | 学习 | 已完成 | 继续学习相关知识,在做中学 |
+| 4 | 在power design上展示数据库设计 | 已完成 | 学习在power design上展示数据库设计 |
+| 5 | 根据最终原型生成用例文档最终稿 | 已完成 | 生成用例文档最终稿 |
+|6|完成项目前景与范围文档和需求规格说明书| 已完成 |完成并提交项目前景与范围文档和需求规格说明书|
+## 小结
+
+1. **增强自信心:** 小组成员应增强自信心,发挥想象力和创造力,在原型设计环节积极思考。
+2. **沟通协作:** 小组成员应积极主动沟通,遇到困难及时寻求帮助,也可以主动向指导老师及研究生学长寻求建议。
+3. **学习安排:** 小组成员仍处于软件开发专业知识的初步学习阶段,应合理安排自主学习时间,以便后续开发的顺利进行。
+4. **项目管理:** PM及时推进项目流程,确保项目有条不紊。
+
+---
+
+## 【注】
+
+1. 在小结一栏中写出希望得到如何的帮助,如讲座等;
+2. 请将个人计划和总结提前发给负责人;
+3. 周任务总结与计划是项目小组评分考核的重要依据,将直接记入平时成绩,请各位同学按要求认真填写并按时提交;
+4. PM综合本小组成员工作情况提交小组周计划、周总结报告,按时上传至代码托管平台。
+
+---
\ No newline at end of file
diff --git a/doc/process/weekly/week-8/members/caojunmao-weekly-plan-08.md b/doc/process/weekly/week-8/members/caojunmao-weekly-plan-08.md
new file mode 100644
index 0000000..5223863
--- /dev/null
+++ b/doc/process/weekly/week-8/members/caojunmao-weekly-plan-08.md
@@ -0,0 +1,33 @@
+# 个人周计划-第8周
+
+## 姓名和起止时间
+
+**姓 名:** 曹峻茂
+**团队名称:** 软1-汪汪队
+**开始时间:** 2025-11-3
+**结束时间:** 2025-11-9
+
+
+## 本周任务计划安排
+| 序号 | 计划内容 | 协作人 | 情况说明 |
+|----|-----------------|------|------------------------|
+| 1 | 确定分工 | 组员 | 2023-11-10 开会确定计划和团队分工 |
+| 2 | 与老师讨论开发计划及原型缺陷 | 全体组员 | 讨论开发计划及现有缺陷 |
+| 3 | 学习 | 个人 | 继续学习相关知识,在做中学 |
+
+## 小结
+
+
+1**知识储备:** 学习后续需要使用的知识,为后续的开发做准备;
+2**文档撰写:** 结合课内知识完成迭代开发计划的撰写。
+
+---
+
+## 【注】
+
+1. 在小结一栏中写出希望得到如何的帮助,如讲座等;
+1. 请将个人计划和总结提前发给负责人;
+1. 周任务总结与计划是项目小组评分考核的重要依据,将直接记入平时成绩,请各位同学按要求认真填写并按时提交;
+1. 所有组员都需提交个人周计划、周总结文档,按时上传至代码托管平台;
+
+---
\ No newline at end of file
diff --git a/doc/process/weekly/week-8/members/caojunmao-weekly-summary-07.md b/doc/process/weekly/week-8/members/caojunmao-weekly-summary-07.md
new file mode 100644
index 0000000..720bff6
--- /dev/null
+++ b/doc/process/weekly/week-8/members/caojunmao-weekly-summary-07.md
@@ -0,0 +1,38 @@
+# 个人周总结-第7周
+
+## 姓名和起止时间
+
+**姓 名:** 曹峻茂
+**团队名称:** 1班-汪汪队
+**开始时间:** 2025-11-3
+**结束时间:** 2025-11-9
+
+## 本周任务完成情况
+
+| 序号 | 总结内容 | 是否完成 | 情况说明 |
+| ---- | ------------------------------------------------ |------|--------------------------------------------------------------|
+| 1 | 确定分工 | 完成 | 2023-11-3 开会确定计划和团队分工 |
+|2| 与老师讨论 | 完成 | 与老师讨论当前用例和原型设计 |
+| 4 | 根据最终原型完成用例文档最终稿 | 完成 | 完成用例文档最终稿 |
+|5|完成项目前景与范围文档和需求规格说明书| 完成 |完成并提交项目前景与范围文档和需求规格说明书|
+
+## 对团队工作的建议
+
+1. **互助学习:** 小组成员应该根据自身的技能长短开展互帮互助的活动,共同努力提高小组成员的专业水平;
+2. **进度统一:** 团队成员尽量统一项目进度;
+
+## 小结
+
+1. **设计用例文档:** 完成了用例文档最终稿;
+2. **技能学习:** 学习了用例图,用例文档相关知识;
+3. **项目管理:** 作为PM及时推进项目进度,确保工作有条不紊;
+4. **团队协作**:与团队成员保持良好的沟通协作,确保设计方向与产品需求一致
+
+---
+
+## 【注】
+
+1. 在小结一栏中写出希望得到如何的帮助,如讲座等;
+2. 请将个人计划和总结提前发给负责人;
+3. 周任务总结与计划是项目小组评分考核的重要依据,将直接记入平时成绩,请各位同学按要求认真填写并按时提交;
+4. 所有组员都需提交个人周计划、周总结文档,上传至代码托管平台;
\ No newline at end of file
diff --git a/doc/process/weekly/week-8/members/luoyuehang-weekly-plan-08.md b/doc/process/weekly/week-8/members/luoyuehang-weekly-plan-08.md
new file mode 100644
index 0000000..5256266
--- /dev/null
+++ b/doc/process/weekly/week-8/members/luoyuehang-weekly-plan-08.md
@@ -0,0 +1,25 @@
+# 个人周计划-第8周
+
+## 姓名和起止时间
+
+**姓 名:** [罗月航]
+**团队名称:** 1班-汪汪队
+**开始时间:** 2025-11-10
+**结束时间:** 2025-11-16
+
+## 本周任务计划安排
+
+| 序号 | 计划内容 | 协作人 | 情况说明 |
+| ---- | -------- | ------ | -------- |
+| 1 | 与老师讨论开发计划 | 老师/组员 | 安排专门会议与老师讨论项目开发计划、时间安排和技术路线 |
+| 2 | 原型缺陷分析与记录 | 个人 | 系统性地分析现有原型设计中存在的缺陷和不足 |
+| 3 | 前端技术学习 | 个人 | 针对项目需求,学习前端框架及相关技术知识 |
+| 4 | 原型界面改正优化 | 个人 | 根据老师反馈和自查结果,对原型界面进行针对性的改正和优化 |
+| 5 | 改正后原型展示 | 老师/组员 | 向老师展示改正后的原型界面,收集进一步改进意见 |
+
+## 小结
+
+1. **指导需求**:需要老师提供具体的开发计划指导和技术路线建议;
+2. **学习资源**:希望获得前端框架学习的推荐资源和实践指导;
+3. **反馈机制**:需要建立与老师的定期沟通机制,及时获取设计改进意见;
+4. **测试支持**:需要团队成员协助进行原型测试,发现潜在问题。
diff --git a/doc/process/weekly/week-8/members/luoyuehang-weekly-summary-07.md b/doc/process/weekly/week-8/members/luoyuehang-weekly-summary-07.md
new file mode 100644
index 0000000..d8548b0
--- /dev/null
+++ b/doc/process/weekly/week-8/members/luoyuehang-weekly-summary-07.md
@@ -0,0 +1,32 @@
+# 个人周总结-第7周
+
+## 姓名和起止时间
+
+**姓 名:** [罗月航]
+**团队名称:** 1班-汪汪队
+**开始时间:** 2025-11-03
+**结束时间:** 2025-11-09
+
+## 本周任务完成情况
+
+| 序号 | 总结内容 | 是否完成 | 情况说明 |
+| ---- | -------- | -------- | -------- |
+| 1 | 原型设计改良优化 | 完成 | 根据与老师的会议反馈,对维修人员APP原型进行了针对性优化,重点改进了设备监控界面 |
+| 2 | 用例文档完善协作 | 完成 | 协助产品经理完成用例文档最终稿,确保功能描述的准确性和完整性 |
+| 3 | 制水机详情页面开发 | 完成 | 开发了完整的制水机详情页面,包含传感器监控、TDS数据、滤芯状态等功能 |
+| 4 | 供水机详情页面开发 | 完成 | 新增供水机详情页面,包含水位监控、双浮球阀传感器、漏水检测等核心功能 |
+| 5 | 传感器数据可视化 | 完成 | 实现了流量计、压力传感器、浮球阀等传感器数据的实时显示和告警功能 |
+
+## 对团队工作的建议
+
+1. **数据接口标准化**:建议后端团队按照新的设备详情页面需求提供标准化的数据接口;
+2. **测试重点**:需要重点测试传感器数据的实时更新和告警功能的准确性;
+3. **文档同步**:设计变更后应及时更新技术文档,便于前后端开发对接;
+
+
+## 小结
+
+1. **技术成果**:成功开发了制水机和供水机的完整详情页面,实现了设备运行状态的全面监控;
+2. **用户体验**:通过可视化的水位显示、传感器状态监控和智能告警,大大提升了运维效率;
+3. **功能完善**:新增的双浮球阀监控和漏水检测功能,增强了设备的安全性和可靠性;
+4. **协作成效**:与PM紧密合作,确保原型设计与用例文档的一致性;
diff --git a/doc/process/weekly/week-8/members/wanglei-weekly-plan-08.md b/doc/process/weekly/week-8/members/wanglei-weekly-plan-08.md
new file mode 100644
index 0000000..e248da0
--- /dev/null
+++ b/doc/process/weekly/week-8/members/wanglei-weekly-plan-08.md
@@ -0,0 +1,33 @@
+# 个人周计划-第8周
+
+## 姓名和起止时间
+
+**姓 名:** 王磊
+**团队名称:** 1班-汪汪队
+**开始时间:** 2023-11-10
+**结束时间:** 2023-11-16
+
+
+## 本周任务计划安排
+
+|序号| 计划内容| 协作人 | 情况说明 |
+| ---- | ------ | ------| ------- |
+| 1 | 确定分工 | 组员 | 2025-11-10 开会细分确定团队分工, |
+| 2 | 根据功能需求优化数据库设计 | 个人 | 结合原型讨论结果,调整和优化数据库表结构及关系 |
+| 3 | 完善外键约束与业务逻辑约束 | 个人 | 确保数据一致性与完整性,支持后续开发|
+| 4 | 编写数据库设计文档 | 个人 | 根据所设计的数据库来编写设计文档|
+
+## 小结
+
+1. **技术重点:** 深入理解业务需求,优化数据库设计,确保系统可扩展性和性能;
+2. **协作重点:** 积极配合原型修改,及时调整数据模型,保持前后端一致性;
+3. **学习重点:** 继续学习数据库优化和系统架构知识,提升全栈开发能力;
+
+---
+
+## 【注】
+
+1. 在小结一栏中写出希望得到如何的帮助,如讲座等;
+1. 请将个人计划和总结提前发给负责人;
+1. 周任务总结与计划是项目小组评分考核的重要依据,将直接记入平时成绩,请各位同学按要求认真填写并按时提交;
+1. 所有组员都需提交个人周计划、周总结文档,按时上传至代码托管平台;
\ No newline at end of file
diff --git a/doc/process/weekly/week-8/members/wanglei-weekly-summary-07.md b/doc/process/weekly/week-8/members/wanglei-weekly-summary-07.md
new file mode 100644
index 0000000..926a973
--- /dev/null
+++ b/doc/process/weekly/week-8/members/wanglei-weekly-summary-07.md
@@ -0,0 +1,38 @@
+
+# 个人周总结-第7周
+
+## 姓名和起止时间
+
+**姓 名:** 王磊
+**团队名称:** 1班-汪汪队
+**开始时间:** 2025-11-3
+**结束时间:** 2025-11-9
+
+## 本周任务完成情况
+
+序号 总结内容 是否完成 情况说明
+1 准备数据库设计讲解材料 完成 使用PowerDesigner完成数据库设计讲解材料,涵盖表结构、关系与业务逻辑说明
+2 填充基础数据 进行中 完成区域、维修人员等基础业务数据的录入,确保数据符合业务逻辑与规范
+
+
+
+## 对团队工作的建议
+
+1. **互助学习:** 小组成员应该根据自身的技能长短开展互帮互助的活动,共同努力提高小组成员的专业水平;
+2. **进度统一:** 团队成员尽量统一项目进度;
+
+## 小结
+
+
+1.技术收获: 熟练掌握了PowerDesigner工具的使用,提升了数据库设计与可视化表达能力;
+
+2.后续重点: 对数据库进行进一步优化修改,完成所有基础数据填充工作,并配合团队开展前后端联调准备;
+
+---
+
+## 【注】
+
+1. 在小结一栏中写出希望得到如何的帮助,如讲座等;
+2. 请将个人计划和总结提前发给负责人;
+3. 周任务总结与计划是项目小组评分考核的重要依据,将直接记入平时成绩,请各位同学按要求认真填写并按时提交;
+4. 所有组员都需提交个人周计划、周总结文档,上传至代码托管平台;
\ No newline at end of file
diff --git a/doc/process/weekly/week-8/members/zhanghongwei-weekly-plan-8.md b/doc/process/weekly/week-8/members/zhanghongwei-weekly-plan-8.md
new file mode 100644
index 0000000..e87111b
--- /dev/null
+++ b/doc/process/weekly/week-8/members/zhanghongwei-weekly-plan-8.md
@@ -0,0 +1,32 @@
+# 个人周计划-第8周
+
+## 团队名称和起止时间
+
+**姓 名:** 张红卫
+**团队名称:** 软1-汪汪队
+**开始时间:** 2025-11-10
+**结束时间:** 2023-11-16
+
+## 本周任务计划安排
+
+
+| 序号 | 计划内容 | 执行人 | 情况说明 |
+|----|-----------------|-------------|-------------------------|
+| 1 | 与老师讨论开发计划及原型缺陷 | 全体组员 | 讨论开发计划及现有缺陷 |
+| 2 | 前端技术预研 | 个人 | 了解若依管理系统为后续界面实现打下基础 |
+| 3 | 改正原型页面并向边耐政老师和指导老师展示 | 罗月航,张红卫,周竞由 | 根据小班讨论要求修正原型 |
+
+## 小结
+
+1. **工具技能:** 进一步了解和使用若依管理系统
+2. **设计能力:** 提升界面美化和用户体验细节处理能力
+3. **知识储备:** 学习若依管理系统相关知识以便后续的界面开发
+
+---
+
+## 【注】
+
+1. 在小结一栏中写出希望得到如何的帮助,如讲座等;
+2. 请将个人计划和总结提前发给负责人;
+3. 周任务总结与计划是项目小组评分考核的重要依据,将直接记入平时成绩,请各位同学按要求认真填写并按时提交;
+4. PM综合本小组成员工作情况提交小组周计划、周总结报告,按时上传至代码托管平台。
\ No newline at end of file
diff --git a/doc/process/weekly/week-8/members/zhanghongwei-weekly-summary-07.md b/doc/process/weekly/week-8/members/zhanghongwei-weekly-summary-07.md
new file mode 100644
index 0000000..e8cf01c
--- /dev/null
+++ b/doc/process/weekly/week-8/members/zhanghongwei-weekly-summary-07.md
@@ -0,0 +1,26 @@
+# 个人周总结-第7周
+
+## 基本信息
+**姓 名:** 张红卫
+**团队名称:** 1班-汪汪队
+**总结周期:** 2025年10月3日 - 2025年11月9日
+
+## 本周任务完成情况
+
+### 已完成任务
+| 序号 | 任务内容 | 完成状态 | 成果输出 |
+|------|----------|----------|----------|
+| 1 | 原型界面设计完善 | 进行中 |界面原型基本功能与需求基本达标,但仍存在界面美观与操作习性的问题 |
+| 2 | 辅助完成用例文档 | 完成 | 在功能与需求上的要求已经基本敲定 |
+
+## 主要成果与进展
+
+1. **知识学习方面**
+ - 通过小班讨论课的展示进一步学习到了做界面原型要考虑的更多方因素
+
+2. **实践产出方面**
+ - 通过小班讨论课的展示学到了许多界面原型设计的技巧
+
+
+## 总结
+本周按计划基本对给出的建议做了修改,下一步针对小班讨论课的建议做进一步的修改并重新给老师评审。
\ No newline at end of file
diff --git a/doc/process/weekly/week-8/members/zhoujingyou-weekly-plan-08.md b/doc/process/weekly/week-8/members/zhoujingyou-weekly-plan-08.md
new file mode 100644
index 0000000..aa52da6
--- /dev/null
+++ b/doc/process/weekly/week-8/members/zhoujingyou-weekly-plan-08.md
@@ -0,0 +1,25 @@
+# 个人周计划-第8周
+
+## 姓名和起止时间
+
+**姓 名:** 周竞由
+**团队名称:** 软1-汪汪队
+**开始时间:** 2025-11-10
+**结束时间:** 2025-11-16
+
+## 本周任务计划安排
+
+| 序号 | 计划内容 | 协作人 | 情况说明 |
+|----|-------------|-------|--------------------------------|
+| 1 | 与老师讨论开发阶段规划 | 老师/组员 | 参与项目会议,与老师讨论学生端前端开发计划与时间进度安排 |
+| 2 | 原型整体复盘与问题记录 | 个人 | 对上阶段原型进行系统复盘,记录界面交互、逻辑衔接等问题 |
+| 3 | 前端开发知识学习与预研 | 个人 | 学习Java前端开发基础与页面结构搭建方法,为后续开发做准备 |
+| 4 | 原型交互与布局优化 | 个人 | 根据评审反馈优化页面逻辑与界面细节,完善动态交互表现 |
+| 5 | 优化后原型展示与讲解 | 老师/组员 | 展示优化后的学生端原型,接受老师与团队成员的改进建议 |
+
+## 小结
+
+1. **指导需求:** 希望老师提供前端框架选型与项目结构搭建的指导,明确下一阶段的开发方向;
+2. **学习重点:** 重点学习页面结构设计、组件划分与数据交互基础;
+3. **协作机制:** 与组员共同确认页面开发顺序及接口需求,保持设计与开发同步;
+4. **成果目标:** 本周完成原型优化与前端开发准备工作,为正式编码阶段做好技术与逻辑铺垫。
diff --git a/doc/process/weekly/week-8/members/zhoujingyou-weekly-summary-07.md b/doc/process/weekly/week-8/members/zhoujingyou-weekly-summary-07.md
new file mode 100644
index 0000000..677794a
--- /dev/null
+++ b/doc/process/weekly/week-8/members/zhoujingyou-weekly-summary-07.md
@@ -0,0 +1,42 @@
+# 个人周总结-第7周
+
+## 姓名和起止时间
+
+**姓 名:** 周竞由
+**团队名称:** 软1-汪汪队
+**开始时间:** 2025-11-03
+**结束时间:** 2025-11-09
+
+## 本周任务完成情况
+
+| 序号 | 计划内容 | 完成情况 | 说明 |
+|----|---------------|------|------------------------------|
+| 1 | 根据评审反馈优化学生端原型 | 已完成 | 按团队建议优化页面层级与交互逻辑,统一操作流程与反馈设计 |
+| 2 | 完善动态交互与页面细节 | 已完成 | 补充主要页面的过渡动画与交互提示,提升原型流畅度与真实感 |
+| 3 | 调整页面视觉层次与配色规范 | 已完成 | 统一配色与字体规范,改进视觉对比度与可读性 |
+| 4 | 制作学生端原型展示文档 | 已完成 | 输出交互说明文档及原型展示稿,用于团队汇报与演示 |
+| 5 | 团队阶段性展示准备 | 已完成 | 与组员完成原型演示讲解分工,并顺利完成阶段性展示 |
+| 6 | 后续开发衔接规划 | 基本完成 | 初步确定前端开发方向与页面组件划分,接口细节待进一步确认 |
+
+## 本周总结
+
+1. **阶段成果:**
+ 本周圆满完成学生端原型优化与展示准备工作,形成较为完善的高保真交互原型。团队在阶段性汇报中展示了应用的主要功能与交互逻辑,获得了积极反馈。
+
+2. **优化进展:**
+ - 调整页面布局与交互节奏,使操作路径更加清晰;
+ - 增加动态过渡与点击反馈,提高原型真实感;
+ - 统一配色与组件样式,强化整体视觉一致性。
+
+3. **存在问题:**
+ - 个别页面的交互细节仍可进一步精简;
+ - 原型文档中部分说明待补充截图与标注;
+ - 对接开发阶段的接口定义尚未完全确定。
+
+4. **改进方向:**
+ - 在下周明确接口格式与数据结构;
+ - 整理UI组件库,为前端实现做准备;
+ - 根据展示反馈进一步优化用户体验设计。
+
+5. **学习体会:**
+ 本周通过原型展示与讲解,进一步提升了设计表达与团队协作能力。对如何在展示中突出设计逻辑与用户体验重点有了更深的理解,也为后续进入前端开发阶段奠定了良好基础。
diff --git a/doc/process/weekly/week-9/group/meeting-minutes-9.md b/doc/process/weekly/week-9/group/meeting-minutes-9.md
new file mode 100644
index 0000000..f744408
--- /dev/null
+++ b/doc/process/weekly/week-9/group/meeting-minutes-9.md
@@ -0,0 +1,36 @@
+# 小组会议纪要-第9周
+
+## 会议记录概要
+
+**团队名称:** 1班-汪汪队
+**指导老师:** 肖雄仁
+**主 持 人:** 曹峻茂
+**记录人员:** 张红卫
+**会议主题:** 本周的任务与分工
+**会议地点:** 宿舍
+**会议时间:** 2025-11-17 12:30-13:30
+**纪录时间:** 2025-11-17 18:00
+**参与人员:** 曹峻茂、张红卫、罗月航、周竞由、王磊
+
+---
+
+## 会议内容
+
+### 1. 大致任务规划
+- 完成mqtt数据的生成与接收
+- 完成数据库和基础接口设计和测试
+- 完成Web端基础框架
+- 开发维修与学生端的界面的布局
+
+### 2. 对迭代开发计划的二次校审
+
+- 在上一周与指导老师讨论后敲定了迭代开发计划的大致规划,针对迭代开发计划再次细化开发计划并提交第二稿
+
+### 3. 团队合作交流
+
+- 小组成员间互相表达对问题的看法与见解,大家互帮互助一起有条不紊的进行开发
+
+### 4.具体任务安排
+- 后端人员:曹峻茂、周竞由、王磊
+- 前端人员:罗月航、张红卫
+
diff --git a/doc/process/weekly/week-9/group/weekly-plan-9.md b/doc/process/weekly/week-9/group/weekly-plan-9.md
new file mode 100644
index 0000000..cf89f2c
--- /dev/null
+++ b/doc/process/weekly/week-9/group/weekly-plan-9.md
@@ -0,0 +1,36 @@
+# 小组周计划-第9周
+
+## 团队名称和起止时间
+
+**团队名称:** 软1-汪汪队
+**开始时间:** 2025-11-17
+**结束时间:** 2025-11-23
+
+## 本周任务计划安排
+
+
+| 序号 | 计划内容 | 执行人 | 情况说明 |
+|----|------------------|--------|--------------------------------|
+| 1 | 确定本周计划分工 | 全体组员 | 2023-11-17 开会确定计划以及团队分工 |
+| 2 | 完成mqtt数据生成和接收 | 曹峻茂 | 完成mqtt数据生成和接收功能 |
+| 3 | 完成数据库相关基础接口设计和测试 | 王磊,周竞由 | 完成数据库相关基础接口设计和测试 |
+| 4 | 开发维修 / 学生端登录页,完成学生端地图页面布局| 罗月航 | 开发维修人员app和学生app登录页,完成学生端地图页面布局 |
+|5| 完成Web 端基础框架 + 登录页代码 | 张红卫 | 完成管理平台基础框架 + 登录页代码 |
+|6|提交迭代开发计划第二稿|曹峻茂|根据反馈修改迭代开发计划|
+## 小结
+
+1. **增强自信心:** 小组成员应增强自信心,发挥想象力和创造力,在原型设计环节积极思考。
+2. **沟通协作:** 小组成员应积极主动沟通,遇到困难及时寻求帮助,也可以主动向指导老师及研究生学长寻求建议。
+3. **学习安排:** 小组成员仍处于软件开发专业知识的初步学习阶段,应合理安排自主学习时间,以便后续开发的顺利进行。
+4. **项目管理:** PM及时推进项目流程,确保项目有条不紊。
+
+---
+
+## 【注】
+
+1. 在小结一栏中写出希望得到如何的帮助,如讲座等;
+2. 请将个人计划和总结提前发给负责人;
+3. 周任务总结与计划是项目小组评分考核的重要依据,将直接记入平时成绩,请各位同学按要求认真填写并按时提交;
+4. PM综合本小组成员工作情况提交小组周计划、周总结报告,按时上传至代码托管平台。
+
+---
\ No newline at end of file
diff --git a/doc/process/weekly/week-9/group/weekly-summary-8.md b/doc/process/weekly/week-9/group/weekly-summary-8.md
new file mode 100644
index 0000000..41fa4cc
--- /dev/null
+++ b/doc/process/weekly/week-9/group/weekly-summary-8.md
@@ -0,0 +1,36 @@
+# 小组周总结-第8周
+
+## 团队名称和起止时间
+
+**团队名称:** 软1-汪汪队
+**开始时间:** 2025-11-10
+**结束时间:** 2025-11-16
+
+## 本周任务计划安排
+
+
+| 序号 | 总结内容 | 是否完成 | 情况说明 |
+|----|--------------|------|------------------------------|
+| 1 | 确定本周计划分工 | 完成 | 2023-11-10 开会确定计划以及团队分工 |
+| 2 | 与老师讨论开发计划及原型缺陷 | 完成 | 讨论开发计划及现有缺陷 |
+| 3 | 学习 | 完成 | 继续学习相关知识,在做中学 |
+| 4 | 改正原型页面并向边耐政老师展示 | 完成 | 根据小班讨论要求修正原型 |
+|5|提交数据库设计文档| 完成 |根据评审意见修改后提交数据库设计文档|
+|6|提交迭代开发计划|完成|与老师讨论开发计划后完成迭代开发计划第一稿|
+## 小结
+
+1. **增强自信心:** 小组成员应增强自信心,发挥想象力和创造力,在原型设计环节积极思考。
+2. **沟通协作:** 小组成员应积极主动沟通,遇到困难及时寻求帮助,也可以主动向指导老师及研究生学长寻求建议。
+3. **学习安排:** 小组成员仍处于软件开发专业知识的初步学习阶段,应合理安排自主学习时间,以便后续开发的顺利进行。
+4. **项目管理:** PM及时推进项目流程,确保项目有条不紊。
+
+---
+
+## 【注】
+
+1. 在小结一栏中写出希望得到如何的帮助,如讲座等;
+2. 请将个人计划和总结提前发给负责人;
+3. 周任务总结与计划是项目小组评分考核的重要依据,将直接记入平时成绩,请各位同学按要求认真填写并按时提交;
+4. PM综合本小组成员工作情况提交小组周计划、周总结报告,按时上传至代码托管平台。
+
+---
\ No newline at end of file
diff --git a/doc/process/weekly/week-9/members/caojunmao-weekly-plan-9.md b/doc/process/weekly/week-9/members/caojunmao-weekly-plan-9.md
new file mode 100644
index 0000000..f82efea
--- /dev/null
+++ b/doc/process/weekly/week-9/members/caojunmao-weekly-plan-9.md
@@ -0,0 +1,33 @@
+# 个人周计划-第9周
+
+## 姓名和起止时间
+
+**姓 名:** 曹峻茂
+**团队名称:** 软1-汪汪队
+**开始时间:** 2025-11-17
+**结束时间:** 2025-11-23
+
+
+## 本周任务计划安排
+| 序号 | 计划内容 | 协作人 | 情况说明 |
+|----|-----------------|-----|------------------------|
+| 1 | 确定分工 | 组员 | 2023-11-17 开会确定计划和团队分工 |
+| 2 | 完成mqtt数据生成和接收 | 个人 | 完成mqtt数据生成和接收功能 |
+| 3 |提交迭代开发计划第二稿| 组员 |根据反馈修改迭代开发计划|
+
+## 小结
+
+1. **学习需求:** 希望能有对于mqtt应用的教学;
+2. **知识储备:** 学习后续需要使用的知识,为后续的开发做准备;
+3. **文档撰写:** 完成迭代开发计划撰写。
+4. **代码实现** 参与mqtt协议相关设计
+---
+
+## 【注】
+
+1. 在小结一栏中写出希望得到如何的帮助,如讲座等;
+1. 请将个人计划和总结提前发给负责人;
+1. 周任务总结与计划是项目小组评分考核的重要依据,将直接记入平时成绩,请各位同学按要求认真填写并按时提交;
+1. 所有组员都需提交个人周计划、周总结文档,按时上传至代码托管平台;
+
+---
\ No newline at end of file
diff --git a/doc/process/weekly/week-9/members/caojunmao-weekly-summary-8.md b/doc/process/weekly/week-9/members/caojunmao-weekly-summary-8.md
new file mode 100644
index 0000000..60d8540
--- /dev/null
+++ b/doc/process/weekly/week-9/members/caojunmao-weekly-summary-8.md
@@ -0,0 +1,37 @@
+# 个人周总结-第8周
+
+## 姓名和起止时间
+
+**姓 名:** 曹峻茂
+**团队名称:** 1班-汪汪队
+**开始时间:** 2025-11-10
+**结束时间:** 2025-11-16
+
+## 本周任务完成情况
+
+| 序号 | 总结内容 | 是否完成 | 情况说明 |
+|----| ------------------------------------------------ |------|--------------------------------------------------------------|
+| 1 | 确定分工 | 完成 | 2023-11-10 开会确定计划和团队分工 |
+| 2 | 与老师讨论开发计划及原型缺陷 | 完成 | 讨论开发计划及现有缺陷 |
+| 3 | 学习 | 完成 | 继续学习相关知识,在做中学 |
+| 4 |提交迭代开发计划|完成|与老师讨论开发计划后完成迭代开发计划第一稿|
+
+## 对团队工作的建议
+
+1. **互助学习:** 小组成员应该根据自身的技能长短开展互帮互助的活动,共同努力提高小组成员的专业水平;
+2. **进度统一:** 团队成员尽量统一项目进度;
+
+## 小结
+
+
+3. **项目管理:** 作为PM及时推进项目进度,确保工作有条不紊;
+4. **团队协作**:与团队成员保持良好的沟通协作,确保设计方向与产品需求一致
+
+---
+
+## 【注】
+
+1. 在小结一栏中写出希望得到如何的帮助,如讲座等;
+2. 请将个人计划和总结提前发给负责人;
+3. 周任务总结与计划是项目小组评分考核的重要依据,将直接记入平时成绩,请各位同学按要求认真填写并按时提交;
+4. 所有组员都需提交个人周计划、周总结文档,上传至代码托管平台;
\ No newline at end of file
diff --git a/doc/process/weekly/week-9/members/luoyuehang-weekly-plan-08.md b/doc/process/weekly/week-9/members/luoyuehang-weekly-plan-08.md
new file mode 100644
index 0000000..5256266
--- /dev/null
+++ b/doc/process/weekly/week-9/members/luoyuehang-weekly-plan-08.md
@@ -0,0 +1,25 @@
+# 个人周计划-第8周
+
+## 姓名和起止时间
+
+**姓 名:** [罗月航]
+**团队名称:** 1班-汪汪队
+**开始时间:** 2025-11-10
+**结束时间:** 2025-11-16
+
+## 本周任务计划安排
+
+| 序号 | 计划内容 | 协作人 | 情况说明 |
+| ---- | -------- | ------ | -------- |
+| 1 | 与老师讨论开发计划 | 老师/组员 | 安排专门会议与老师讨论项目开发计划、时间安排和技术路线 |
+| 2 | 原型缺陷分析与记录 | 个人 | 系统性地分析现有原型设计中存在的缺陷和不足 |
+| 3 | 前端技术学习 | 个人 | 针对项目需求,学习前端框架及相关技术知识 |
+| 4 | 原型界面改正优化 | 个人 | 根据老师反馈和自查结果,对原型界面进行针对性的改正和优化 |
+| 5 | 改正后原型展示 | 老师/组员 | 向老师展示改正后的原型界面,收集进一步改进意见 |
+
+## 小结
+
+1. **指导需求**:需要老师提供具体的开发计划指导和技术路线建议;
+2. **学习资源**:希望获得前端框架学习的推荐资源和实践指导;
+3. **反馈机制**:需要建立与老师的定期沟通机制,及时获取设计改进意见;
+4. **测试支持**:需要团队成员协助进行原型测试,发现潜在问题。
diff --git a/doc/process/weekly/week-9/members/luoyuehang-weekly-summary-08.md b/doc/process/weekly/week-9/members/luoyuehang-weekly-summary-08.md
new file mode 100644
index 0000000..362785d
--- /dev/null
+++ b/doc/process/weekly/week-9/members/luoyuehang-weekly-summary-08.md
@@ -0,0 +1,34 @@
+# 个人周总结-第8周
+
+## 姓名和起止时间
+
+**姓 名:** [罗月航]
+**团队名称:** 1班-汪汪队
+**开始时间:** 2025-11-10
+**结束时间:** 2025-11-16
+
+## 本周任务完成情况
+
+| 序号 | 总结内容 | 是否完成 | 情况说明 |
+| ---- | -------- | -------- | -------- |
+| 1 | 与老师讨论开发计划 | 完成 | 本周二与李老师进行了深入的项目开发讨论,明确了开发时间节点和技术要求 |
+| 2 | 原型缺陷分析与记录 | 完成 | 系统分析了现有原型在用户体验、交互逻辑和数据展示方面的缺陷,整理出15项改进点 |
+| 3 | 前端技术学习 | 进行中 | 开始学习Vue.js框架基础,掌握了组件化开发和数据绑定的基本概念 |
+| 4 | 原型界面改正优化 | 完成 | 根据老师反馈优化了设备监控页面的布局,改进了导航结构和信息展示方式 |
+| 5 | 改正后原型展示 | 完成 | 周五向老师展示了优化后的原型,获得了肯定并收集到3条进一步改进建议 |
+
+## 对团队工作的建议
+
+1. **技术学习共享**:建议建立团队技术学习分享机制,定期交流学习心得;
+2. **代码规范统一**:在进入开发阶段前,需要统一前端代码规范和项目结构;
+3. **文档完善**:技术学习过程中应及时整理学习笔记,形成团队知识库。
+
+## 小结
+
+1. **明确方向**:通过与老师的深入交流,明确了项目的技术路线和开发重点;
+2. **问题识别**:系统性地识别了原型设计中的用户体验问题,为后续改进提供了明确方向;
+3. **技术储备**:开始了前端技术的学习积累,为后续实际开发做好准备;
+4. **持续改进**:原型设计经过多轮优化,界面更加符合用户使用习惯;
+5. **反馈积极**:老师对改进后的原型给予了肯定,证明优化方向正确;
+6. **后续计划**:继续深入学习Vue.js,开始搭建项目基础框架,准备进入实际开发阶段。
+
diff --git a/doc/process/weekly/week-9/members/wanglei-weekly-plan-09.md b/doc/process/weekly/week-9/members/wanglei-weekly-plan-09.md
new file mode 100644
index 0000000..e1218c4
--- /dev/null
+++ b/doc/process/weekly/week-9/members/wanglei-weekly-plan-09.md
@@ -0,0 +1,26 @@
+# 个人周计划-第9周
+
+## 姓名和起止时间
+
+**姓 名:** 王磊
+**团队名称:** 1班-汪汪队
+**开始时间:** 2023-11-17
+**结束时间:** 2023-11-23
+
+
+## 本周任务计划安排
+
+|序号| 计划内容| 协作人 | 情况说明 |
+| ---- | ------ | ------| ------- |
+| 1 | 确定分工 | 组员 | 2025-11-17 开会细分确定团队分工, |
+| 2 | 修改完善数据库 | 个人 | 根据完善后的数据库的设计,修改完善我之前设计的数据库,新增表和接口 |
+
+
+## 小结
+
+1. **技术重点:** 基于完善后的数据库设计,修改原有设计,新增表结构和核心接口
+2. **协作重点:** 确保数据库设计与前端需求一致,接口定义清晰
+3. **学习重点:** 继续学习数据库优化和系统架构知识;
+
+---
+
diff --git a/doc/process/weekly/week-9/members/wanglei-weekly-summary-08.md b/doc/process/weekly/week-9/members/wanglei-weekly-summary-08.md
new file mode 100644
index 0000000..0c40389
--- /dev/null
+++ b/doc/process/weekly/week-9/members/wanglei-weekly-summary-08.md
@@ -0,0 +1,33 @@
+
+# 个人周总结-第8周
+
+## 姓名和起止时间
+
+**姓 名:** 王磊
+**团队名称:** 1班-汪汪队
+**开始时间:** 2025-11-10
+**结束时间:** 2025-11-16
+
+## 本周任务完成情况
+
+序号 总结内容 是否完成 情况说明
+1 根据功能需求优化数据库设计 完成 结合原型讨论结果,完成数据库表结构及关系的调整与优化。
+2 完善外键约束与业务逻辑约束 完成 完成外键与业务逻辑约束的添加,确保数据一致性与完整性,支持后续开发。
+3 编写数据库设计文档 完成 基于优化后的数据库设计,编写了完整的数据库设计文档,包含表结构、关系图、字段说明等内容。
+
+
+
+## 对团队工作的建议
+
+1. **沟通及时性** 建议团队在任务调整或遇到问题时及时沟通,避免信息滞后
+2. **文档同步** 关键设计变更应及时更新至共享文档,保持团队信息一致
+
+## 小结
+
+
+1.技术收获: 通过优化数据库设计和编写设计文档,加深了对业务逻辑与数据一致性的理解,提升了数据库建模和文档编写能力;
+
+2.后续重点: 配合前后端开发进度,持续优化数据库性能,并参与联调准备工作;
+
+---
+
diff --git a/doc/process/weekly/week-9/members/zhanghongwei-weekly-plan-9.md b/doc/process/weekly/week-9/members/zhanghongwei-weekly-plan-9.md
new file mode 100644
index 0000000..7dd65f8
--- /dev/null
+++ b/doc/process/weekly/week-9/members/zhanghongwei-weekly-plan-9.md
@@ -0,0 +1,37 @@
+# 个人周计划-第9周
+
+## 姓名和起止时间
+
+**姓 名:** 张红卫
+**团队名称:** 软1-汪汪队
+**开始时间:** 2025-11-17
+**结束时间:** 2025-11-23
+
+## 本周任务计划安排
+
+| 序号 | 计划内容 | 执行人 | 情况说明 |
+| ---- | -------- | ------ | -------- |
+| 1 | Web端框架搭建 | 个人 | 选择合适的前端框架,配置开发环境,搭建基础项目结构 |
+| 2 | 多角色登录页开发 | 个人 | 设计并实现支持管理员角色的登录界面 |
+| 3 | 用户管理页面原型 | 个人 | 设计用户管理页面的新增/编辑功能原型,完成界面交互设计 |
+| 4 | 接口联调测试 | 后端3 | 与后端联调登录接口,验证多角色登录功能及权限校验 |
+
+## 技术学习重点
+
+1. **前端框架深入**:重点学习所选框架的路由管理、状态管理
+2. **接口对接**:掌握axios等HTTP库的使用,学习错误处理和加载状态管理
+
+## 交付物清单
+
+- [ ] Web端基础框架源码
+- [ ] 多角色登录页面代码
+- [ ] 用户管理页面原型设计稿
+- [ ] 接口联调测试报告
+
+## 小结
+
+1. **技术需求**:希望有前端权限控制的最佳实践分享;
+2. **协作需求**:需要后端同学及时提供接口文档和测试环境;
+3. **进度风险**:关注接口开发进度,及时调整前端开发计划。
+
+---
\ No newline at end of file
diff --git a/doc/process/weekly/week-9/members/zhanghongwei-weekly-summary-8.md b/doc/process/weekly/week-9/members/zhanghongwei-weekly-summary-8.md
new file mode 100644
index 0000000..d2c37d2
--- /dev/null
+++ b/doc/process/weekly/week-9/members/zhanghongwei-weekly-summary-8.md
@@ -0,0 +1,26 @@
+# 个人周总结-第7周
+
+## 基本信息
+**姓 名:** 张红卫
+**团队名称:** 1班-汪汪队
+**总结周期:** 2025年11月10日 - 2025年11月16日
+
+## 本周任务完成情况
+
+### 已完成任务
+| 序号 | 任务内容 | 完成状态 | 成果输出 |
+|----|----------|----------|----------|
+| 1 | 与老师讨论开发计划及原型缺陷 | 已完成 | 已经完成迭代开发计划的讨论 |
+| 2 | 前端技术预研 | 进行中 | 了解若依管理系统为后续界面实现打下基础 |
+| 3 | 改正原型页面并向边耐政老师和指导老师展示 | 已完成 | 将修改之后的原型界面演示视频已经发送 |
+## 主要成果与进展
+
+1. **知识学习方面**
+ - 对若依操作系统有了进一步的了解
+
+2. **实践产出方面**
+ - 经过与指导老师的讨论会议已经设计了大致的迭代开发计划
+
+
+## 总结
+本周按计划完成了原型界面最后的修改与迭代开发计划的敲定,并且对若以操作系统有了一定的了解。
\ No newline at end of file
diff --git a/doc/process/weekly/week-9/members/zhoujingyou-weekly-plan-09.md b/doc/process/weekly/week-9/members/zhoujingyou-weekly-plan-09.md
new file mode 100644
index 0000000..ee5ff7d
--- /dev/null
+++ b/doc/process/weekly/week-9/members/zhoujingyou-weekly-plan-09.md
@@ -0,0 +1,25 @@
+# 个人周计划-第9周
+
+## 姓名和起止时间
+**姓 名:** 周竞由
+**团队名称:** 软1-汪汪队
+**开始时间:** 2025-11-17
+**结束时间:** 2025-11-23
+**核心职责:** 接口测试用例编写 + 后端2联调支持
+
+## 本周任务计划安排
+
+| 序号 | 计划内容 | 协作人 | 情况说明 |
+|----|---------------|-----------|------------------------------------|
+| 1 | 对接需求与接口规范确认 | 后端2、产品负责人 | 11-17 完成,明确登录/告警接口业务逻辑、入参出参格式及异常定义 |
+| 2 | 编写用户登录接口测试用例 | 后端2 | 11-18至19完成,覆盖多角色登录、账号密码错误等12类场景 |
+| 3 | 编写告警生成接口测试用例 | 后端2、后端1 | 11-20至21完成,关联设备异常数据,区分自动/手动触发场景 |
+| 4 | 协助接口逻辑验证与问题定位 | 后端2 | 11-22完成,执行测试用例并记录缺陷,同步调试建议 |
+| 5 | 提交测试用例与联调报告 | 组员、指导老师 | 11-23完成,根据反馈修订文档并归档 |
+
+## 小结
+1. **学习需求:** 希望获取接口测试工具(Postman)实操指导,及接口自动化测试基础教学;
+2. **知识储备:** 提前学习等价类划分、边界值分析等测试方法,提升用例设计覆盖率;
+3. **文档撰写:** 完成2份标准化测试用例文档,清晰标注测试步骤、预期结果与优先级;
+4. **协作支持:** 每日同步测试进度,及时反馈接口问题,保障后端2开发与前端联调衔接顺畅。
+
\ No newline at end of file
diff --git a/doc/process/weekly/week-9/members/zhoujingyou-weekly-summary-08.md b/doc/process/weekly/week-9/members/zhoujingyou-weekly-summary-08.md
new file mode 100644
index 0000000..3a9183a
--- /dev/null
+++ b/doc/process/weekly/week-9/members/zhoujingyou-weekly-summary-08.md
@@ -0,0 +1,24 @@
+
+# 个人周总结-第8周
+
+## 姓名和起止时间
+**姓 名:** 周竞由
+**团队名称:** 软1-汪汪队
+**开始时间:** 2025-11-10
+**结束时间:** 2025-11-16
+
+## 本周任务完成情况
+
+| 序号 | 计划内容 | 协作人 | 完成情况 | 成果说明 |
+|----|-------------|-------|------|-----------------------------------------------------------------------|
+| 1 | 与老师讨论开发阶段规划 | 老师/组员 | 已完成 | 全程参与项目会议,明确学生端前端开发优先级,确定以"首页-课程列表-个人中心"为开发顺序,形成2份会议纪要并同步至团队群 |
+| 2 | 原型整体复盘与问题记录 | 个人 | 已完成 | 梳理出原型中3类核心问题:导航逻辑混乱、表单验证缺失、数据展示冗余,形成《原型问题清单》共18项问题及初步改进思路 |
+| 3 | 前端开发知识学习与预研 | 个人 | 已完成 | 系统学习Vue3基础语法与组件开发,掌握页面布局Flex/Grid用法,完成3个基础页面demo开发,整理《前端开发学习笔记》约5000字 |
+| 4 | 原型交互与布局优化 | 个人 | 已完成 | 基于问题清单优化原型,简化导航层级、补充表单验证提示、优化数据卡片布局,更新后原型交互流畅度提升,逻辑漏洞减少80% |
+| 5 | 优化后原型展示与讲解 | 老师/组员 | 已完成 | 通过屏幕共享完成原型讲解,收集到老师关于"增加暗黑模式适配"及组员关于"统一按钮样式"的建议,形成《原型优化反馈表》 |
+
+## 小结
+1. **成果收获:** 本周高效完成原型优化与前端技术储备,明确了开发方向与优先级,掌握Vue3基础开发能力,产出会议纪要、问题清单、学习笔记等多份成果物,为正式开发奠定坚实基础;
+2. **问题与不足:** 原型优化中对跨设备适配考虑不足,前端学习时在组件通信部分理解较慢,需加强实战练习;与组员沟通时,对接口需求的讨论不够深入,需进一步明确数据交互标准;
+3. **后续计划:** 结合反馈完善原型的暗黑模式与样式统一;重点攻克前端组件通信与接口调用知识;与组员共同制定接口文档规范,启动首页前端开发工作;
+4. **支持需求:** 希望团队提供已确定的接口字段说明,以便前端开发时进行数据模拟;申请加入前端技术交流群,获取更多开发经验支持。
\ No newline at end of file
diff --git a/doc/project/01-需求文档/模板1-项目前景与范围文档.docx b/doc/project/01-需求文档/模板1-项目前景与范围文档.docx
new file mode 100644
index 0000000..f245d79
Binary files /dev/null and b/doc/project/01-需求文档/模板1-项目前景与范围文档.docx differ
diff --git a/doc/project/01-需求文档/用例文档最终稿.docx b/doc/project/01-需求文档/用例文档最终稿.docx
new file mode 100644
index 0000000..f33427b
Binary files /dev/null and b/doc/project/01-需求文档/用例文档最终稿.docx differ
diff --git a/doc/project/01-需求文档/用例文档第一稿.docx b/doc/project/01-需求文档/用例文档第一稿.docx
new file mode 100644
index 0000000..41d735b
Binary files /dev/null and b/doc/project/01-需求文档/用例文档第一稿.docx differ
diff --git a/doc/project/01-需求文档/需求规格说明书第一稿.docx b/doc/project/01-需求文档/需求规格说明书第一稿.docx
new file mode 100644
index 0000000..6d6eeec
Binary files /dev/null and b/doc/project/01-需求文档/需求规格说明书第一稿.docx differ
diff --git a/doc/project/02-设计文档/6.(校园直饮矿化水物联网运维平台)数据库设计文档.docx b/doc/project/02-设计文档/6.(校园直饮矿化水物联网运维平台)数据库设计文档.docx
new file mode 100644
index 0000000..5a730dc
Binary files /dev/null and b/doc/project/02-设计文档/6.(校园直饮矿化水物联网运维平台)数据库设计文档.docx differ
diff --git a/doc/project/02-设计文档/UML-活动图-顺序图-类图.pdf b/doc/project/02-设计文档/UML-活动图-顺序图-类图.pdf
new file mode 100644
index 0000000..2ccd17b
Binary files /dev/null and b/doc/project/02-设计文档/UML-活动图-顺序图-类图.pdf differ
diff --git a/doc/project/03-计划文档/迭代开发计划第一稿.docx b/doc/project/03-计划文档/迭代开发计划第一稿.docx
new file mode 100644
index 0000000..53344af
Binary files /dev/null and b/doc/project/03-计划文档/迭代开发计划第一稿.docx differ
diff --git a/doc/project/03-计划文档/迭代开发计划第三稿 .docx b/doc/project/03-计划文档/迭代开发计划第三稿 .docx
new file mode 100644
index 0000000..0970f0a
Binary files /dev/null and b/doc/project/03-计划文档/迭代开发计划第三稿 .docx differ
diff --git a/doc/project/03-计划文档/迭代开发计划第二稿 .docx b/doc/project/03-计划文档/迭代开发计划第二稿 .docx
new file mode 100644
index 0000000..0d378f5
Binary files /dev/null and b/doc/project/03-计划文档/迭代开发计划第二稿 .docx differ
diff --git a/pom.xml b/pom.xml
new file mode 100644
index 0000000..dfe31eb
--- /dev/null
+++ b/pom.xml
@@ -0,0 +1,149 @@
+
+
+ 4.0.0
+
+ com.campus.water
+ water-management-system
+ 1.0.0
+ jar
+
+ Water Machine Management System
+ 校园直饮矿化水物联网运维平台
+
+
+ org.springframework.boot
+ spring-boot-starter-parent
+ 3.3.5
+
+
+
+
+ 23
+ 23
+ 23
+ UTF-8
+
+
+
+
+
+ org.springframework.boot
+ spring-boot-starter-web
+
+
+
+
+ org.springframework.boot
+ spring-boot-starter-validation
+
+
+
+
+ org.springframework.boot
+ spring-boot-starter-data-jpa
+
+
+
+
+ org.springframework.integration
+ spring-integration-core
+
+
+
+
+ org.springframework.integration
+ spring-integration-mqtt
+
+
+
+
+ com.mysql
+ mysql-connector-j
+ 8.0.33
+
+
+
+
+ org.eclipse.paho
+ org.eclipse.paho.client.mqttv3
+ 1.2.5
+
+
+
+
+ com.alibaba.fastjson2
+ fastjson2
+ 2.0.43
+
+
+
+
+ org.projectlombok
+ lombok
+ true
+
+
+
+
+
+ org.springframework.boot
+ spring-boot-starter-test
+ test
+
+
+
+ org.springframework.boot
+ spring-boot-starter-security
+
+
+ io.jsonwebtoken
+ jjwt-api
+ 0.11.5
+
+
+ io.jsonwebtoken
+ jjwt-impl
+ 0.11.5
+ runtime
+
+
+ io.jsonwebtoken
+ jjwt-jackson
+ 0.11.5
+ runtime
+
+
+
+ org.springdoc
+ springdoc-openapi-starter-webmvc-ui
+ 2.2.0
+
+
+
+
+
+ src
+
+
+ src/main/resources
+
+
+
+
+ org.springframework.boot
+ spring-boot-maven-plugin
+
+
+
+ org.projectlombok
+ lombok
+
+
+
+
+
+
+
\ No newline at end of file
diff --git a/src/main/java/com/campus/water/CampusWaterApplication.java b/src/main/java/com/campus/water/CampusWaterApplication.java
new file mode 100644
index 0000000..375cd42
--- /dev/null
+++ b/src/main/java/com/campus/water/CampusWaterApplication.java
@@ -0,0 +1,23 @@
+package com.campus.water;
+
+import org.springframework.boot.SpringApplication;
+import org.springframework.boot.autoconfigure.SpringBootApplication;
+import org.springframework.integration.config.EnableIntegration;
+import org.springframework.integration.config.EnableIntegrationManagement;
+import org.springframework.scheduling.annotation.EnableScheduling;
+
+/**
+ * Spring Boot 主启动类
+ * 核心注解:开启自动配置、定时任务、Spring Integration
+ */
+@SpringBootApplication(scanBasePackages = "com.campus.water") // 扫描所有业务组件
+@EnableScheduling // 开启定时任务(支持@Scheduled)
+@EnableIntegration // 开启Spring Integration(支持MQTT集成)
+@EnableIntegrationManagement // 开启Integration管理(监控消息流转)
+public class CampusWaterApplication {
+ public static void main(String[] args) {
+ SpringApplication.run(CampusWaterApplication.class, args);
+ System.out.println("=== 校园直饮矿化水系统(Spring Boot版)启动成功 ===");
+ System.out.println("=== MQTT传感器模拟、数据接收、持久化功能已启用 ===");
+ }
+}
\ No newline at end of file
diff --git a/src/main/java/com/campus/water/config/MD5PasswordEncoder.java b/src/main/java/com/campus/water/config/MD5PasswordEncoder.java
new file mode 100644
index 0000000..061d491
--- /dev/null
+++ b/src/main/java/com/campus/water/config/MD5PasswordEncoder.java
@@ -0,0 +1,26 @@
+// com/campus/water/config/MD5PasswordEncoder.java
+package com.campus.water.config;
+
+import org.springframework.security.crypto.password.PasswordEncoder;
+import org.springframework.util.DigestUtils;
+
+import java.nio.charset.StandardCharsets;
+
+/**
+ * 自定义MD5密码编码器,实现Spring Security的PasswordEncoder接口
+ */
+public class MD5PasswordEncoder implements PasswordEncoder {
+
+ @Override
+ public String encode(CharSequence rawPassword) {
+ // 对原始密码进行MD5加密(与注册时的加密方式保持一致)
+ return DigestUtils.md5DigestAsHex(rawPassword.toString().getBytes(StandardCharsets.UTF_8));
+ }
+
+ @Override
+ public boolean matches(CharSequence rawPassword, String encodedPassword) {
+ // 验证时:将原始密码MD5加密后与数据库中存储的加密密码对比
+ String rawEncoded = encode(rawPassword);
+ return rawEncoded.equals(encodedPassword);
+ }
+}
\ No newline at end of file
diff --git a/src/main/java/com/campus/water/config/MqttConfig.java b/src/main/java/com/campus/water/config/MqttConfig.java
new file mode 100644
index 0000000..e86e4ab
--- /dev/null
+++ b/src/main/java/com/campus/water/config/MqttConfig.java
@@ -0,0 +1,84 @@
+package com.campus.water.config;
+
+import org.eclipse.paho.client.mqttv3.MqttConnectOptions;
+import org.springframework.context.annotation.Bean;
+import org.springframework.context.annotation.Configuration;
+import org.springframework.integration.channel.DirectChannel;
+import org.springframework.integration.mqtt.core.DefaultMqttPahoClientFactory;
+import org.springframework.integration.mqtt.core.MqttPahoClientFactory;
+import org.springframework.integration.mqtt.outbound.MqttPahoMessageHandler;
+import org.springframework.messaging.MessageChannel;
+
+@Configuration
+public class MqttConfig {
+ // MQTT 基础配置(可迁移到 application.yml 中,用 @ConfigurationProperties 绑定)
+ public static final String BROKER = "ssl://b17be106.ala.cn-hangzhou.emqxsl.cn:8883";
+ public static final String USERNAME = "test1";
+ public static final String PASSWORD = "123456";
+ public static final int QOS = 1; // 消息质量等级(1=确保送达,不重复)
+ public static final int CONNECTION_TIMEOUT = 30000; // 连接超时(毫秒)
+ public static final int KEEP_ALIVE_INTERVAL = 60; // 心跳间隔(秒)
+
+ // MQTT 主题定义(按设备类型+功能分层)
+ public static final String TOPIC_WATER_MAKER_STATE = "/device/state/water_maker/";
+ public static final String TOPIC_WATER_MAKER_WARN = "/device/warn/water_maker/";
+ public static final String TOPIC_WATER_SUPPLIER_STATE = "/device/state/water_supply/";
+ public static final String TOPIC_WATER_SUPPLIER_WARN = "/device/warn/water_supply/";
+
+ /**
+ * MQTT 客户端工厂(Spring 管理,统一创建客户端)
+ */
+ @Bean
+ public MqttPahoClientFactory mqttClientFactory() {
+ DefaultMqttPahoClientFactory factory = new DefaultMqttPahoClientFactory();
+ MqttConnectOptions options = new MqttConnectOptions();
+
+ // 配置连接参数
+ options.setServerURIs(new String[]{BROKER});
+ options.setUserName(USERNAME);
+ options.setPassword(PASSWORD.toCharArray());
+ options.setConnectionTimeout(CONNECTION_TIMEOUT / 1000); // 转换为秒
+ options.setKeepAliveInterval(KEEP_ALIVE_INTERVAL);
+ options.setAutomaticReconnect(true); // 断线自动重连
+ options.setCleanSession(true); // 断开后清除会话
+
+ // 在 MqttConfig 的 mqttClientFactory() 中增强连接选项
+ options.setAutomaticReconnect(true); // 启用自动重连
+ options.setMaxReconnectDelay(5000); // 重连间隔(毫秒,与原 5 秒一致)
+
+ factory.setConnectionOptions(options);
+ return factory;
+ }
+
+ /**
+ * 发送消息通道(DirectChannel:同步发送,确保消息顺序)
+ */
+ @Bean
+ public MessageChannel mqttOutboundChannel() {
+ return new DirectChannel();
+ }
+
+ /**
+ * MQTT 消息发送处理器(封装发送逻辑)
+ */
+ @Bean
+ public MqttPahoMessageHandler mqttOutbound() {
+ // 客户端ID:前缀+时间戳,避免重复
+ String clientId = "sensor-sender-" + System.currentTimeMillis();
+ MqttPahoMessageHandler handler = new MqttPahoMessageHandler(clientId, mqttClientFactory());
+
+ handler.setAsync(true); // 异步发送(不阻塞主线程)
+ handler.setDefaultQos(QOS); // 默认QOS等级
+ handler.setDefaultTopic(TOPIC_WATER_MAKER_STATE); // 默认主题(可在发送时覆盖)
+
+ return handler;
+ }
+
+ /**
+ * 接收消息通道(用于接收端转发消息)
+ */
+ @Bean
+ public MessageChannel mqttInputChannel() {
+ return new DirectChannel();
+ }
+}
\ No newline at end of file
diff --git a/src/main/java/com/campus/water/config/MqttInboundConfig.java b/src/main/java/com/campus/water/config/MqttInboundConfig.java
new file mode 100644
index 0000000..ba546c4
--- /dev/null
+++ b/src/main/java/com/campus/water/config/MqttInboundConfig.java
@@ -0,0 +1,34 @@
+package com.campus.water.config;
+import com.campus.water.config.MqttConfig;//编译器问题
+import org.springframework.context.annotation.Bean;
+import org.springframework.context.annotation.Configuration;
+import org.springframework.integration.mqtt.inbound.MqttPahoMessageDrivenChannelAdapter;
+import org.springframework.integration.mqtt.support.DefaultPahoMessageConverter;
+
+
+@Configuration
+public class MqttInboundConfig {
+
+ /**
+ * MQTT 接收适配器(监听MQTT主题,接收消息并转发到通道)
+ */
+ @Bean
+ public MqttPahoMessageDrivenChannelAdapter mqttInbound(MqttConfig mqttConfig) {
+ // 接收端客户端ID(与发送端区分)
+ String clientId = "sensor-receiver-" + System.currentTimeMillis();
+
+ // 创建适配器:指定客户端ID、工厂、默认订阅主题(可后续动态添加)
+ MqttPahoMessageDrivenChannelAdapter adapter = new MqttPahoMessageDrivenChannelAdapter(
+ clientId,
+ mqttConfig.mqttClientFactory()
+ );
+
+ // 配置消息转换器(默认UTF-8编码,支持JSON格式)
+ adapter.setConverter(new DefaultPahoMessageConverter());
+ adapter.setQos(mqttConfig.QOS); // 订阅QOS等级与发送端一致
+ adapter.setOutputChannel(mqttConfig.mqttInputChannel()); // 消息转发到接收通道
+
+
+ return adapter;
+ }
+}
\ No newline at end of file
diff --git a/src/main/java/com/campus/water/config/SecurityConfig.java b/src/main/java/com/campus/water/config/SecurityConfig.java
new file mode 100644
index 0000000..5f3e4cc
--- /dev/null
+++ b/src/main/java/com/campus/water/config/SecurityConfig.java
@@ -0,0 +1,112 @@
+// com/campus/water/config/SecurityConfig.java
+package com.campus.water.config;
+
+import com.campus.water.security.JwtAuthenticationFilter;
+import com.campus.water.security.UserDetailsServiceImpl;
+import org.springframework.context.annotation.Bean;
+import org.springframework.context.annotation.Configuration;
+import org.springframework.security.authentication.AuthenticationManager;
+import org.springframework.security.authentication.dao.DaoAuthenticationProvider;
+import org.springframework.security.config.annotation.authentication.configuration.AuthenticationConfiguration;
+import org.springframework.security.config.annotation.method.configuration.EnableMethodSecurity;
+import org.springframework.security.config.annotation.web.builders.HttpSecurity;
+import org.springframework.security.config.annotation.web.configuration.EnableWebSecurity;
+import org.springframework.security.config.http.SessionCreationPolicy;
+import org.springframework.security.crypto.password.PasswordEncoder;
+import org.springframework.security.web.SecurityFilterChain;
+import org.springframework.security.web.authentication.UsernamePasswordAuthenticationFilter;
+import org.springframework.web.cors.CorsConfiguration;
+import org.springframework.web.cors.CorsConfigurationSource;
+import org.springframework.web.cors.UrlBasedCorsConfigurationSource;
+
+import java.util.Arrays;
+
+/**
+ * 安全配置类
+ */
+@Configuration
+@EnableWebSecurity
+@EnableMethodSecurity()
+public class SecurityConfig {
+
+ private final UserDetailsServiceImpl userDetailsService;
+ private final JwtAuthenticationFilter jwtAuthenticationFilter;
+
+ public SecurityConfig(UserDetailsServiceImpl userDetailsService,
+ JwtAuthenticationFilter jwtAuthenticationFilter) {
+ this.userDetailsService = userDetailsService;
+ this.jwtAuthenticationFilter = jwtAuthenticationFilter;
+ }
+
+ /**
+ * 认证提供者
+ */
+ @Bean
+ public DaoAuthenticationProvider authenticationProvider() {
+ DaoAuthenticationProvider authProvider = new DaoAuthenticationProvider();
+ authProvider.setUserDetailsService(userDetailsService);
+ authProvider.setPasswordEncoder(passwordEncoder());
+ return authProvider;
+ }
+
+ /**
+ * 密码加密器(使用BCrypt替代MD5)
+ */
+ @Bean
+ public PasswordEncoder passwordEncoder() {
+ // 替换BCrypt加密为自定义MD5加密器
+ return new MD5PasswordEncoder();
+ }
+
+ /**
+ * 认证管理器
+ */
+ @Bean
+ public AuthenticationManager authenticationManager(AuthenticationConfiguration authConfig) throws Exception {
+ return authConfig.getAuthenticationManager();
+ }
+
+ /**
+ * 安全过滤链
+ */
+ @Bean
+ public SecurityFilterChain filterChain(HttpSecurity http) throws Exception {
+ http
+ .cors(cors -> cors.configurationSource(corsConfigurationSource()))
+ .csrf(csrf -> csrf.disable())
+ .sessionManagement(session -> session.sessionCreationPolicy(SessionCreationPolicy.STATELESS))
+ .authorizeHttpRequests(auth -> auth
+ .requestMatchers("/api/app/student/login", "/api/app/repair/login", "/api/web/login", "/api/common/login").permitAll()
+ .requestMatchers("/api/common/register").permitAll()
+ .requestMatchers("/static/**", "/templates/**").permitAll()
+ .requestMatchers(request -> "OPTIONS".equals(request.getMethod())).permitAll()
+ .requestMatchers("/api/alerts/**").hasAnyRole("ADMIN", "REPAIRMAN")
+ .requestMatchers("/api/app/student/**").hasAnyRole("STUDENT", "ADMIN")
+ .requestMatchers("/api/app/repair/**").hasAnyRole("REPAIRMAN", "ADMIN")
+ .requestMatchers("/api/web/**").hasAnyRole("SUPER_ADMIN", "AREA_ADMIN", "VIEWER","REPAIRMAN")
+ .anyRequest().authenticated()
+ )
+ .addFilterBefore(jwtAuthenticationFilter, UsernamePasswordAuthenticationFilter.class)
+ .authenticationProvider(authenticationProvider());
+
+ return http.build();
+ }
+
+ /**
+ * CORS配置源
+ */
+ @Bean
+ public CorsConfigurationSource corsConfigurationSource() {
+ CorsConfiguration configuration = new CorsConfiguration();
+ configuration.setAllowedOrigins(Arrays.asList("http://localhost:5173"));
+ configuration.setAllowedMethods(Arrays.asList("GET", "POST", "PUT", "DELETE", "OPTIONS"));
+ configuration.setAllowedHeaders(Arrays.asList("Authorization", "Content-Type", "X-Requested-With"));
+ configuration.setAllowCredentials(true);
+ configuration.setMaxAge(3600L);
+ configuration.setExposedHeaders(Arrays.asList("Authorization", "Content-Length"));
+
+ UrlBasedCorsConfigurationSource source = new UrlBasedCorsConfigurationSource();
+ source.registerCorsConfiguration("/**", configuration);
+ return source;
+ }
+}
\ No newline at end of file
diff --git a/src/main/java/com/campus/water/config/先读我.md b/src/main/java/com/campus/water/config/先读我.md
new file mode 100644
index 0000000..3b52c1f
--- /dev/null
+++ b/src/main/java/com/campus/water/config/先读我.md
@@ -0,0 +1 @@
+# 本md仅用于初始化目录,未创建所有子一级目录,在当前目录创建文件后请自行删除
\ No newline at end of file
diff --git a/src/main/java/com/campus/water/controller/AlertController.java b/src/main/java/com/campus/water/controller/AlertController.java
new file mode 100644
index 0000000..dd2e766
--- /dev/null
+++ b/src/main/java/com/campus/water/controller/AlertController.java
@@ -0,0 +1,74 @@
+package com.campus.water.controller;
+
+import com.campus.water.entity.Alert;
+import com.campus.water.mapper.AlertRepository;
+import com.campus.water.util.ResultVO;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.Parameter;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import lombok.RequiredArgsConstructor;
+import org.springframework.security.access.prepost.PreAuthorize;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RequestParam;
+import org.springframework.web.bind.annotation.RestController;
+
+import java.time.LocalDateTime;
+import java.util.List;
+
+@RestController
+@RequestMapping("/api/alerts")
+@RequiredArgsConstructor
+@Tag(name = "告警管理接口")
+public class AlertController {
+
+ private final AlertRepository alertRepository;
+
+ @GetMapping("/history")
+ @PreAuthorize("hasAnyRole('ADMIN', 'REPAIRMAN')")
+ @Operation(summary = "分页查询告警历史(支持多条件筛选)")
+ public ResultVO> getAlertHistory(
+ @Parameter(description = "设备ID(可选)") @RequestParam(required = false) String deviceId,
+ @Parameter(description = "告警级别(可选,如error、critical)") @RequestParam(required = false) String level,
+ @Parameter(description = "告警状态(可选,如pending、resolved)") @RequestParam(required = false) String status,
+ @Parameter(description = "开始时间(可选,格式:yyyy-MM-dd HH:mm:ss)") @RequestParam(required = false) LocalDateTime startTime,
+ @Parameter(description = "结束时间(可选)") @RequestParam(required = false) LocalDateTime endTime,
+ @Parameter(description = "所属区域(维修人员仅能查询自己的区域)") @RequestParam(required = false) String areaId
+ ) {
+ List alerts;
+
+ if (deviceId != null) {
+ alerts = alertRepository.findByDeviceIdAndTimestampBetween(deviceId, startTime, endTime);
+ } else if (level != null) {
+ alerts = alertRepository.findByAlertLevelAndTimestampBetween(
+ Alert.AlertLevel.valueOf(level), startTime, endTime);
+ } else if (status != null) {
+ alerts = alertRepository.findByStatusAndTimestampBetween(
+ Alert.AlertStatus.valueOf(status), startTime, endTime);
+ } else if (areaId != null) {
+ alerts = alertRepository.findByAreaIdAndTimestampBetween(areaId, startTime, endTime);
+ } else {
+ alerts = alertRepository.findByTimestampBetween(startTime, endTime);
+ }
+
+ return ResultVO.success(alerts);
+ }
+
+ /**
+ * 查询未处理告警(紧急优先)
+ */
+ @GetMapping("/pending")
+ @PreAuthorize("hasAnyRole('ADMIN', 'REPAIRMAN')")
+ public ResultVO> getPendingAlerts(
+ @Parameter(description = "区域ID(可选)") @RequestParam(required = false) String areaId) {
+ List pendingAlerts = areaId != null
+ ? alertRepository.findByAreaIdAndStatus(areaId, Alert.AlertStatus.pending)
+ : alertRepository.findByStatus(Alert.AlertStatus.pending);
+
+ // 按优先级排序(紧急在前)- 使用方法引用替代lambda
+ pendingAlerts.sort((a1, a2) ->
+ Integer.compare(a2.getAlertLevel().getPriority(), a1.getAlertLevel().getPriority()));
+
+ return ResultVO.success(pendingAlerts);
+ }
+}
\ No newline at end of file
diff --git a/src/main/java/com/campus/water/controller/GlobalExceptionHandler.java b/src/main/java/com/campus/water/controller/GlobalExceptionHandler.java
new file mode 100644
index 0000000..ba66090
--- /dev/null
+++ b/src/main/java/com/campus/water/controller/GlobalExceptionHandler.java
@@ -0,0 +1,80 @@
+package com.campus.water.controller;
+
+import com.campus.water.util.ResultVO;
+import org.springframework.security.access.AccessDeniedException;
+import org.springframework.web.bind.annotation.ExceptionHandler;
+import org.springframework.web.bind.annotation.RestControllerAdvice;
+import org.springframework.web.method.annotation.MethodArgumentTypeMismatchException;
+import org.springframework.web.bind.MethodArgumentNotValidException;
+
+import java.time.format.DateTimeParseException;
+import java.util.Objects;
+
+/**
+ * 全局异常处理器 - 统一处理项目中所有控制器层异常
+ */
+@RestControllerAdvice
+public class GlobalExceptionHandler {
+
+ /**
+ * 处理参数格式/值错误(如枚举值非法、参数为空等)
+ */
+ @ExceptionHandler(IllegalArgumentException.class)
+ public ResultVO handleIllegalArgument(IllegalArgumentException e) {
+ // 针对告警级别/状态参数错误做友好提示
+ String msg = e.getMessage();
+ if (msg.contains("AlertLevel") || msg.contains("AlertStatus")) {
+ msg = "参数错误:告警级别可选值(info/warning/error/critical),告警状态可选值(pending/resolved/closed)";
+ }
+ return ResultVO.error(400, "参数错误:" + msg);
+ }
+
+ /**
+ * 处理参数类型不匹配(如时间格式错误、字符串转数字失败等)
+ */
+ @ExceptionHandler(MethodArgumentTypeMismatchException.class)
+ public ResultVO handleTypeMismatch(MethodArgumentTypeMismatchException e) {
+ String errorMsg;
+ // 特殊处理时间格式错误(告警查询的时间参数)
+ if (e.getCause() instanceof DateTimeParseException) {
+ errorMsg = "时间参数格式错误,正确格式:yyyy-MM-dd HH:mm:ss(示例:2025-12-05 10:30:00)";
+ } else {
+ // 通用类型不匹配提示
+ errorMsg = String.format(
+ "参数[%s]类型错误,期望类型:%s,实际传入值:%s",
+ e.getName(),
+ e.getRequiredType() != null ? e.getRequiredType().getSimpleName() : "未知",
+ e.getValue()
+ );
+ }
+ return ResultVO.error(400, errorMsg);
+ }
+
+ /**
+ * 处理权限不足异常(如非管理员/维修人员访问告警接口)
+ */
+ @ExceptionHandler(AccessDeniedException.class)
+ public ResultVO handleAccessDenied(AccessDeniedException e) {
+ return ResultVO.error(403, "权限不足:仅管理员/维修人员可访问告警相关功能");
+ }
+
+ /**
+ * 处理通用运行时异常(兜底)
+ */
+ @ExceptionHandler(RuntimeException.class)
+ public ResultVO handleRuntimeException(RuntimeException e) {
+ // 生产环境建议添加日志记录,此处简化
+ // log.error("服务器运行时异常", e);
+ return ResultVO.error(500, "服务器内部错误:" + e.getMessage());
+ }
+
+ /**
+ * 处理请求参数验证失败(如@NotBlank/@Pattern等注解验证失败)
+ */
+ @ExceptionHandler(MethodArgumentNotValidException.class)
+ public ResultVO handleMethodArgumentNotValid(MethodArgumentNotValidException e) {
+ // 获取第一个验证失败的字段和消息
+ String errorMsg = Objects.requireNonNull(e.getBindingResult().getFieldError()).getDefaultMessage();
+ return ResultVO.badRequest(errorMsg); // 返回400状态码和具体错误信息
+ }
+}
\ No newline at end of file
diff --git a/src/main/java/com/campus/water/controller/LoginController.java b/src/main/java/com/campus/water/controller/LoginController.java
new file mode 100644
index 0000000..eecab39
--- /dev/null
+++ b/src/main/java/com/campus/water/controller/LoginController.java
@@ -0,0 +1,37 @@
+package com.campus.water.controller; // 修正包路径:去掉main.java + 按规范放在common子包
+
+import com.campus.water.entity.dto.request.LoginRequest; // 替换原LoginDTO为规范的LoginRequest
+import com.campus.water.entity.vo.LoginVO;
+import com.campus.water.service.LoginService;
+import com.campus.water.util.ResultVO;
+import org.springframework.beans.factory.annotation.Autowired;
+import org.springframework.http.ResponseEntity;
+import org.springframework.web.bind.annotation.PostMapping;
+import org.springframework.web.bind.annotation.RequestBody;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RestController;
+
+import jakarta.validation.Valid;
+
+/**
+ * 登录接口控制器(公共接口)
+ */
+@RestController
+@RequestMapping("/api/common") // 保持统一接口前缀
+public class LoginController {
+
+ @Autowired
+ private LoginService loginService;
+
+ /**
+ * 登录接口
+ * @param loginRequest 登录请求参数(替换原LoginDTO)
+ * @return 登录响应结果
+ */
+ // 修改LoginController的login方法
+ @PostMapping("/login")
+ public ResponseEntity> login(@Valid @RequestBody LoginRequest loginRequest) {
+ LoginVO loginVO = loginService.login(loginRequest);
+ return ResponseEntity.ok(ResultVO.success(loginVO)); // 用ResultVO包装
+ }
+}
\ No newline at end of file
diff --git a/src/main/java/com/campus/water/controller/RegisterController.java b/src/main/java/com/campus/water/controller/RegisterController.java
new file mode 100644
index 0000000..1abe416
--- /dev/null
+++ b/src/main/java/com/campus/water/controller/RegisterController.java
@@ -0,0 +1,35 @@
+package com.campus.water.controller;
+
+import com.campus.water.entity.dto.request.RegisterRequest;
+import com.campus.water.service.RegisterService;
+import com.campus.water.util.ResultVO;
+import org.springframework.beans.factory.annotation.Autowired;
+import org.springframework.http.ResponseEntity;
+import org.springframework.web.bind.annotation.PostMapping;
+import org.springframework.web.bind.annotation.RequestBody;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RestController;
+
+import jakarta.validation.Valid;
+
+/**
+ * 注册接口控制器(公共接口)
+ */
+@RestController
+@RequestMapping("/api/common")
+public class RegisterController {
+
+ @Autowired
+ private RegisterService registerService;
+
+ /**
+ * 用户注册接口
+ * @param registerRequest 注册请求参数
+ * @return 注册结果
+ */
+ @PostMapping("/register")
+ public ResponseEntity> register(@Valid @RequestBody RegisterRequest registerRequest) {
+ boolean success = registerService.register(registerRequest);
+ return ResponseEntity.ok(ResultVO.success(success, "注册成功"));
+ }
+}
\ No newline at end of file
diff --git a/src/main/java/com/campus/water/controller/WaterUsageController.java b/src/main/java/com/campus/water/controller/WaterUsageController.java
new file mode 100644
index 0000000..31c2671
--- /dev/null
+++ b/src/main/java/com/campus/water/controller/WaterUsageController.java
@@ -0,0 +1,185 @@
+package com.campus.water.controller;
+
+import com.campus.water.entity.*;
+import com.campus.water.mapper.*;
+import org.springframework.beans.factory.annotation.Autowired;
+import org.springframework.stereotype.Controller;
+import org.springframework.transaction.annotation.Transactional;
+
+import java.math.BigDecimal;
+import java.time.LocalDateTime;
+import java.util.HashMap;
+import java.util.Map;
+import java.util.Optional;
+
+@Controller
+public class WaterUsageController {
+
+ @Autowired
+ private DeviceTerminalMappingRepository deviceTerminalMappingRepository;
+
+ @Autowired
+ private WaterMakerRealtimeDataRepository waterMakerRealtimeDataRepository;
+
+ @Autowired
+ private WaterQualityHistoryRepository waterQualityHistoryRepository;
+
+ @Autowired
+ private DrinkRecordRepository drinkRecordRepository;
+
+ @Autowired
+ private TerminalUsageStatsRepository terminalUsageStatsRepository;
+
+ // 扫码用水
+ @Transactional
+ public Map scanToDrink(String terminalId, String studentId, Double waterConsumption) {
+ Map result = new HashMap<>();
+
+ try {
+ Optional mappingOpt = deviceTerminalMappingRepository.findByTerminalId(terminalId);
+ if (mappingOpt.isEmpty()) {
+ result.put("success", false);
+ result.put("message", "终端设备不存在");
+ return result;
+ }
+
+ DeviceTerminalMapping mapping = mappingOpt.get();
+ if (mapping.getTerminalStatus() != DeviceTerminalMapping.TerminalStatus.active) {
+ result.put("success", false);
+ result.put("message", "终端设备未激活");
+ return result;
+ }
+
+ Optional realtimeDataOpt =
+ waterMakerRealtimeDataRepository.findLatestByDeviceId(mapping.getDeviceId());
+
+ DrinkRecord drinkRecord = new DrinkRecord();
+ drinkRecord.setStudentId(studentId);
+ drinkRecord.setTerminalId(terminalId);
+ drinkRecord.setDeviceId(mapping.getDeviceId());
+
+ // 错误1修复:Double转BigDecimal(适配DrinkRecord的BigDecimal类型字段)
+ drinkRecord.setWaterConsumption(waterConsumption != null ? BigDecimal.valueOf(waterConsumption) : BigDecimal.ZERO);
+ drinkRecord.setDrinkTime(LocalDateTime.now());
+ drinkRecord.setLocation(mapping.getTerminalName());
+
+ if (realtimeDataOpt.isPresent()) {
+ WaterMakerRealtimeData realtimeData = realtimeDataOpt.get();
+ drinkRecord.setTdsValue(realtimeData.getTdsValue3());
+ drinkRecord.setWaterQuality(realtimeData.getWaterQuality());
+ }
+
+ drinkRecordRepository.save(drinkRecord);
+ // 传入BigDecimal类型的用水量
+ updateTerminalUsageStats(terminalId, BigDecimal.valueOf(waterConsumption));
+
+ result.put("success", true);
+ result.put("message", "用水成功");
+ result.put("waterConsumption", waterConsumption);
+ result.put("timestamp", LocalDateTime.now());
+ return result;
+
+ } catch (Exception e) {
+ result.put("success", false);
+ result.put("message", "用水失败: " + e.getMessage());
+ return result;
+ }
+ }
+
+ // 更新终端使用统计(参数改为BigDecimal)
+ private void updateTerminalUsageStats(String terminalId, BigDecimal waterConsumption) {
+ LocalDateTime now = LocalDateTime.now();
+ Optional statsOpt = terminalUsageStatsRepository
+ .findByTerminalIdAndStatDate(terminalId, now.toLocalDate());
+
+ TerminalUsageStats stats;
+ if (statsOpt.isPresent()) {
+ stats = statsOpt.get();
+ stats.setUsageCount(stats.getUsageCount() + 1);
+
+ // 错误2&3修复:BigDecimal加法(替代+运算符)
+ stats.setTotalWaterOutput(stats.getTotalWaterOutput().add(waterConsumption));
+
+ // 错误4修复:BigDecimal除法(替代/运算符,指定精度和舍入模式)
+ stats.setAvgWaterPerUse(
+ stats.getTotalWaterOutput()
+ .divide(BigDecimal.valueOf(stats.getUsageCount()), 2, BigDecimal.ROUND_HALF_UP)
+ );
+ } else {
+ stats = new TerminalUsageStats();
+ stats.setTerminalId(terminalId);
+ stats.setStatDate(now.toLocalDate());
+ stats.setUsageCount(1);
+
+ // 错误5&6修复:直接赋值BigDecimal(适配TerminalUsageStats的BigDecimal字段)
+ stats.setTotalWaterOutput(waterConsumption);
+ stats.setAvgWaterPerUse(waterConsumption);
+ stats.setPeakHour(String.format("%02d:00", now.getHour()));
+ }
+
+ stats.setUpdatedTime(now);
+ terminalUsageStatsRepository.save(stats);
+ }
+
+ // 获取水质信息
+ public Map getWaterQualityInfo(String deviceId) {
+ Map result = new HashMap<>();
+
+ try {
+ Optional realtimeDataOpt =
+ waterMakerRealtimeDataRepository.findLatestByDeviceId(deviceId);
+
+ Optional qualityHistoryOpt =
+ waterQualityHistoryRepository.findLatestByDeviceId(deviceId);
+
+ if (realtimeDataOpt.isPresent()) {
+ WaterMakerRealtimeData realtimeData = realtimeDataOpt.get();
+ result.put("deviceId", deviceId);
+ // 如需返回Double给前端:BigDecimal转Double
+ result.put("rawWaterTds", realtimeData.getTdsValue1() != null ? realtimeData.getTdsValue1().doubleValue() : null);
+ result.put("pureWaterTds", realtimeData.getTdsValue2() != null ? realtimeData.getTdsValue2().doubleValue() : null);
+ result.put("mineralWaterTds", realtimeData.getTdsValue3() != null ? realtimeData.getTdsValue3().doubleValue() : null);
+ result.put("waterQuality", realtimeData.getWaterQuality());
+ result.put("filterLife", realtimeData.getFilterLife());
+ result.put("status", realtimeData.getStatus());
+ result.put("updateTime", realtimeData.getRecordTime());
+ }
+
+ if (qualityHistoryOpt.isPresent()) {
+ WaterQualityHistory qualityHistory = qualityHistoryOpt.get();
+ result.put("lastDetectionTime", qualityHistory.getDetectedTime());
+ }
+
+ result.put("success", true);
+ return result;
+
+ } catch (Exception e) {
+ result.put("success", false);
+ result.put("message", "获取水质信息失败: " + e.getMessage());
+ return result;
+ }
+ }
+
+ // 获取终端设备信息
+ public Map getTerminalInfo(String terminalId) {
+ Map result = new HashMap<>();
+
+ Optional mappingOpt = deviceTerminalMappingRepository.findByTerminalId(terminalId);
+ if (mappingOpt.isPresent()) {
+ DeviceTerminalMapping mapping = mappingOpt.get();
+ result.put("terminalId", terminalId);
+ result.put("terminalName", mapping.getTerminalName());
+ result.put("deviceId", mapping.getDeviceId());
+ result.put("status", mapping.getTerminalStatus());
+ result.put("success", true);
+
+ Map qualityInfo = getWaterQualityInfo(mapping.getDeviceId());
+ result.putAll(qualityInfo);
+ } else {
+ result.put("success", false);
+ result.put("message", "终端设备不存在");
+ }
+
+ return result;
+ }
+}
\ No newline at end of file
diff --git a/src/main/java/com/campus/water/controller/WorkOrderController.java b/src/main/java/com/campus/water/controller/WorkOrderController.java
new file mode 100644
index 0000000..327cfe1
--- /dev/null
+++ b/src/main/java/com/campus/water/controller/WorkOrderController.java
@@ -0,0 +1,174 @@
+package com.campus.water.controller;
+
+import com.campus.water.entity.WorkOrder;
+import com.campus.water.service.WorkOrderService;
+import com.campus.water.util.ResultVO;
+import org.springframework.beans.factory.annotation.Autowired;
+import org.springframework.security.access.prepost.PreAuthorize;
+import org.springframework.security.core.Authentication;
+import org.springframework.security.core.authority.SimpleGrantedAuthority;
+import org.springframework.web.bind.annotation.*;
+
+import java.util.List;
+
+@RestController
+@RequestMapping("/api/work-orders")
+public class WorkOrderController {
+
+ private final WorkOrderService workOrderService;
+
+ @Autowired
+ public WorkOrderController(WorkOrderService workOrderService) {
+ this.workOrderService = workOrderService;
+ }
+
+ // 抢单功能 - 维修人员和管理员可访问
+ @PostMapping("/grab")
+ @PreAuthorize("hasAnyRole('REPAIRMAN', 'SUPER_ADMIN', 'AREA_ADMIN')")
+ public ResultVO grabOrder(
+ @RequestParam String orderId,
+ @RequestParam String repairmanId) {
+ try {
+ boolean result = workOrderService.grabOrder(orderId, repairmanId);
+ return result ? ResultVO.success(true, "抢单成功")
+ : ResultVO.error(400, "抢单失败,工单可能已被抢走或状态异常");
+ } catch (Exception e) {
+ return ResultVO.error(500, "抢单失败:" + e.getMessage());
+ }
+ }
+
+ // 拒单功能 - 维修人员和管理员可访问
+ @PostMapping("/reject")
+ @PreAuthorize("hasAnyRole('REPAIRMAN', 'SUPER_ADMIN', 'AREA_ADMIN')")
+ public ResultVO rejectOrder(
+ @RequestParam String orderId,
+ @RequestParam String repairmanId,
+ @RequestParam String reason) {
+ try {
+ boolean result = workOrderService.rejectOrder(orderId, repairmanId, reason);
+ return result ? ResultVO.success(true, "拒单成功")
+ : ResultVO.error(400, "拒单失败,工单状态异常");
+ } catch (Exception e) {
+ return ResultVO.error(500, "拒单失败:" + e.getMessage());
+ }
+ }
+
+ // 提交维修结果 - 维修人员和管理员可访问
+ @PostMapping("/submit")
+ @PreAuthorize("hasAnyRole('REPAIRMAN', 'SUPER_ADMIN', 'AREA_ADMIN')")
+ public ResultVO submitRepairResult(
+ @RequestParam String orderId,
+ @RequestParam String repairmanId,
+ @RequestParam String dealNote,
+ @RequestParam(required = false) String imgUrl) {
+ try {
+ boolean result = workOrderService.submitRepairResult(orderId, repairmanId, dealNote, imgUrl);
+ return result ? ResultVO.success(true, "维修结果提交成功,等待审核")
+ : ResultVO.error(400, "提交失败,工单状态异常");
+ } catch (Exception e) {
+ return ResultVO.error(500, "提交失败:" + e.getMessage());
+ }
+ }
+
+ // 新增:审核工单接口(管理员专用)
+ @PostMapping("/review")
+ @PreAuthorize("hasAnyRole('SUPER_ADMIN', 'AREA_ADMIN')")
+ public ResultVO reviewOrder(
+ @RequestParam String orderId,
+ @RequestParam boolean approved) {
+ try {
+ boolean result = workOrderService.reviewOrder(orderId, approved);
+ return result ? ResultVO.success(true, approved ? "审核通过" : "审核不通过")
+ : ResultVO.error(400, "审核失败,工单状态异常");
+ } catch (Exception e) {
+ return ResultVO.error(500, "审核失败:" + e.getMessage());
+ }
+ }
+
+ // 获取可抢工单列表 - 维修人员和管理员可访问
+ @GetMapping("/available")
+ @PreAuthorize("hasAnyRole('REPAIRMAN','SUPER_ADMIN', 'AREA_ADMIN')")
+ public ResultVO> getAvailableOrders(
+ @RequestParam(required = false) String areaId, // 改为非必填
+ Authentication authentication) { // 获取当前登录用户的认证信息
+ try {
+ // 1. 判断当前用户角色
+ boolean isRepairman = authentication.getAuthorities().contains(
+ new SimpleGrantedAuthority("ROLE_REPAIRMAN")
+ );
+ boolean isAdmin = authentication.getAuthorities().stream()
+ .anyMatch(auth -> auth.getAuthority().equals("ROLE_SUPER_ADMIN")
+ || auth.getAuthority().equals("ROLE_AREA_ADMIN"));
+
+ // 2. 角色逻辑校验
+ List orders;
+ if (isRepairman) {
+ // 维修人员:必须传areaId,否则抛异常
+ if (areaId == null || areaId.trim().isEmpty()) {
+ return ResultVO.error(400, "维修人员查询可抢工单必须传入区域ID");
+ }
+ // 维修人员:查指定区域的可抢工单
+ orders = workOrderService.getAvailableOrders(areaId);
+ } else if (isAdmin) {
+ // 管理员:无需传areaId,查所有区域的可抢工单
+ // 给service层传null,让service层识别为"查所有"
+ orders = workOrderService.getAvailableOrders(null);
+ } else {
+ // 非授权角色(理论上被@PreAuthorize拦截,不会走到这)
+ return ResultVO.error(403, "无权限访问");
+ }
+
+ return ResultVO.success(orders);
+ } catch (Exception e) {
+ return ResultVO.error(500, "获取工单列表失败:" + e.getMessage());
+ }
+ }
+
+ // 管理员按状态查询工单
+ @GetMapping("/by-status")
+ @PreAuthorize("hasAnyRole('SUPER_ADMIN', 'AREA_ADMIN')")
+ public ResultVO> getOrdersByStatus(
+ @RequestParam WorkOrder.OrderStatus status,
+ @RequestParam(required = false) String areaId) {
+ try {
+ List orders;
+ if (areaId == null || areaId.trim().isEmpty()) {
+ // 查所有区域的指定状态工单
+ orders = workOrderService.getOrdersByStatus(status);
+ } else {
+ // 查指定区域的指定状态工单
+ orders = workOrderService.getOrdersByAreaAndStatus(areaId, status);
+ }
+ return ResultVO.success(orders);
+ } catch (Exception e) {
+ return ResultVO.error(500, "获取工单失败:" + e.getMessage());
+ }
+ }
+
+ // 获取维修工自己的工单 - 维修人员和管理员可访问
+ @GetMapping("/my")
+ @PreAuthorize("hasAnyRole('REPAIRMAN', 'SUPER_ADMIN', 'AREA_ADMIN')")
+ public ResultVO> getMyOrders(@RequestParam String repairmanId) {
+ try {
+ List orders = workOrderService.getMyOrders(repairmanId);
+ return ResultVO.success(orders);
+ } catch (Exception e) {
+ return ResultVO.error(500, "获取我的工单失败:" + e.getMessage());
+ }
+ }
+
+ // 管理员手动派单接口
+ @PostMapping("/assign")
+ @PreAuthorize("hasAnyRole('SUPER_ADMIN', 'AREA_ADMIN')")
+ public ResultVO assignOrderByAdmin(
+ @RequestParam String orderId,
+ @RequestParam String repairmanId) {
+ try {
+ boolean result = workOrderService.assignOrderByAdmin(orderId, repairmanId);
+ return result ? ResultVO.success(true, "派单成功")
+ : ResultVO.error(400, "派单失败,工单或维修人员状态异常");
+ } catch (Exception e) {
+ return ResultVO.error(500, "派单失败:" + e.getMessage());
+ }
+ }
+}
\ No newline at end of file
diff --git a/src/main/java/com/campus/water/controller/app/RepairmanAppController.java b/src/main/java/com/campus/water/controller/app/RepairmanAppController.java
new file mode 100644
index 0000000..2e3202f
--- /dev/null
+++ b/src/main/java/com/campus/water/controller/app/RepairmanAppController.java
@@ -0,0 +1,48 @@
+package com.campus.water.controller.app;
+
+import com.campus.water.entity.WorkOrder;
+import com.campus.water.service.app.RepairmanAppService;
+import com.campus.water.util.ResultVO;
+import org.springframework.beans.factory.annotation.Autowired;
+import org.springframework.web.bind.annotation.*;
+
+import java.util.List;
+import java.util.Map;
+
+@RestController
+@RequestMapping("/api/app/repairman") // 维修人员APP端接口前缀
+public class RepairmanAppController {
+
+ @Autowired
+ private RepairmanAppService repairmanAppService;
+
+ // 获取可抢工单列表
+ @GetMapping("/available-orders")
+ public ResultVO> getAvailableOrders(@RequestParam String areaId) {
+ return repairmanAppService.getAvailableOrders(areaId);
+ }
+
+ // 抢单
+ @PostMapping("/grab-order")
+ public ResultVO grabOrder(@RequestBody Map request) {
+ return repairmanAppService.grabOrder(request);
+ }
+
+ // 拒单
+ @PostMapping("/reject-order")
+ public ResultVO rejectOrder(@RequestBody Map request) {
+ return repairmanAppService.rejectOrder(request);
+ }
+
+ // 提交维修结果
+ @PostMapping("/submit-result")
+ public ResultVO submitRepairResult(@RequestBody Map request) {
+ return repairmanAppService.submitRepairResult(request);
+ }
+
+ // 获取我的工单
+ @GetMapping("/my-orders")
+ public ResultVO> getMyOrders(@RequestParam String repairmanId) {
+ return repairmanAppService.getMyOrders(repairmanId);
+ }
+}
\ No newline at end of file
diff --git a/src/main/java/com/campus/water/controller/app/先读我.md b/src/main/java/com/campus/water/controller/app/先读我.md
new file mode 100644
index 0000000..3b52c1f
--- /dev/null
+++ b/src/main/java/com/campus/water/controller/app/先读我.md
@@ -0,0 +1 @@
+# 本md仅用于初始化目录,未创建所有子一级目录,在当前目录创建文件后请自行删除
\ No newline at end of file
diff --git a/src/main/java/com/campus/water/controller/common/先读我.md b/src/main/java/com/campus/water/controller/common/先读我.md
new file mode 100644
index 0000000..3b52c1f
--- /dev/null
+++ b/src/main/java/com/campus/water/controller/common/先读我.md
@@ -0,0 +1 @@
+# 本md仅用于初始化目录,未创建所有子一级目录,在当前目录创建文件后请自行删除
\ No newline at end of file
diff --git a/src/main/java/com/campus/water/controller/web/AdminController.java b/src/main/java/com/campus/water/controller/web/AdminController.java
new file mode 100644
index 0000000..3407f85
--- /dev/null
+++ b/src/main/java/com/campus/water/controller/web/AdminController.java
@@ -0,0 +1,103 @@
+package com.campus.water.controller.web;
+
+import com.campus.water.entity.Admin;
+import com.campus.water.service.AdminService;
+import com.campus.water.util.ResultVO;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import lombok.RequiredArgsConstructor;
+import org.springframework.http.ResponseEntity;
+import org.springframework.security.access.prepost.PreAuthorize;
+import org.springframework.web.bind.annotation.*;
+
+import java.util.List;
+import java.util.Optional;
+
+@RestController
+@RequestMapping("/api/web/admin")
+@RequiredArgsConstructor
+@Tag(name = "管理员管理接口", description = "Web管理端管理员操作接口")
+public class AdminController {
+
+ private final AdminService adminService;
+
+ /**
+ * 获取管理员列表(支持姓名/角色筛选)
+ */
+ @GetMapping("/list")
+ @PreAuthorize("hasAnyRole('SUPER_ADMIN', 'AREA_ADMIN')") // 超级/区域管理员可查看
+ @Operation(summary = "获取管理员列表", description = "支持按姓名模糊搜索、按角色筛选")
+ public ResponseEntity>> getAdminList(
+ @RequestParam(required = false) String name,
+ @RequestParam(required = false) Admin.AdminRole role // 角色筛选参数
+ ) {
+ try {
+ List adminList = adminService.getAdminList(name, role);
+ return ResponseEntity.ok(ResultVO.success(adminList));
+ } catch (Exception e) {
+ return ResponseEntity.ok(ResultVO.error(500, "查询失败:" + e.getMessage()));
+ }
+ }
+
+ /**
+ * 获取所有管理员角色枚举
+ */
+ @GetMapping("/roles")
+ @PreAuthorize("hasAnyRole('SUPER_ADMIN', 'AREA_ADMIN')")
+ @Operation(summary = "获取管理员角色列表", description = "返回所有可选角色(super_admin/area_admin/viewer)")
+ public ResponseEntity> getAllRoles() {
+ try {
+ Admin.AdminRole[] roles = adminService.getAllRoles();
+ return ResponseEntity.ok(ResultVO.success(roles));
+ } catch (Exception e) {
+ return ResponseEntity.ok(ResultVO.error(500, "获取角色列表失败:" + e.getMessage()));
+ }
+ }
+
+ /**
+ * 新增/编辑管理员
+ */
+ @PostMapping("/save")
+ @PreAuthorize("hasRole('SUPER_ADMIN')") // 仅超级管理员可新增/编辑
+ @Operation(summary = "保存管理员", description = "新增/编辑管理员,支持指定角色")
+ public ResponseEntity> saveAdmin(@RequestBody Admin admin) {
+ try {
+ Admin savedAdmin = adminService.saveAdmin(admin);
+ return ResponseEntity.ok(ResultVO.success(savedAdmin));
+ } catch (Exception e) {
+ return ResponseEntity.ok(ResultVO.error(500, "保存失败:" + e.getMessage()));
+ }
+ }
+
+ /**
+ * 删除管理员
+ */
+ @DeleteMapping("/{adminId}")
+ @PreAuthorize("hasRole('SUPER_ADMIN')") // 仅超级管理员可删除
+ @Operation(summary = "删除管理员", description = "按ID删除管理员")
+ public ResponseEntity> deleteAdmin(@PathVariable String adminId) {
+ try {
+ adminService.deleteAdmin(adminId);
+ return ResponseEntity.ok(ResultVO.success(null));
+ } catch (Exception e) {
+ return ResponseEntity.ok(ResultVO.error(500, "删除失败:" + e.getMessage()));
+ }
+ }
+
+ /**
+ * 管理员登录
+ */
+ @PostMapping("/login")
+ @Operation(summary = "管理员登录", description = "用户名+密码验证,返回管理员信息(含角色)")
+ public ResponseEntity> login(
+ @RequestParam String adminName,
+ @RequestParam String password
+ ) {
+ Optional admin = adminService.login(adminName, password);
+ if (admin.isPresent()) {
+ return ResponseEntity.ok(ResultVO.success(admin.get()));
+ } else {
+ return ResponseEntity.ok(ResultVO.error(401, "用户名或密码错误"));
+ }
+ }
+}
\ No newline at end of file
diff --git a/src/main/java/com/campus/water/controller/web/DeviceController.java b/src/main/java/com/campus/water/controller/web/DeviceController.java
new file mode 100644
index 0000000..8163470
--- /dev/null
+++ b/src/main/java/com/campus/water/controller/web/DeviceController.java
@@ -0,0 +1,140 @@
+package com.campus.water.controller.web;
+
+import com.campus.water.entity.Device;
+import com.campus.water.entity.RepairerAuth;
+import com.campus.water.mapper.RepairerAuthRepository;
+import com.campus.water.service.DeviceService;
+import com.campus.water.entity.Repairman;
+import com.campus.water.mapper.RepairmanRepository;
+import com.campus.water.util.ResultVO;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.validation.Valid;
+import lombok.RequiredArgsConstructor;
+import org.springframework.http.ResponseEntity;
+import org.springframework.web.bind.annotation.*;
+import org.springframework.security.core.Authentication;
+import org.springframework.security.access.prepost.PreAuthorize;
+
+import java.util.List; // 新增List的导入语句
+
+@RestController
+@RequestMapping("/api/web/device")
+@RequiredArgsConstructor
+@Tag(name = "设备管理接口", description = "Web管理端设备新增与删除接口")
+public class DeviceController {
+
+ private final DeviceService deviceService;
+ private final RepairmanRepository repairmanRepository;
+ private final RepairerAuthRepository repairerAuthRepository;
+
+ /**
+ * 新增设备
+ */
+ @PostMapping("/add")
+ @Operation(summary = "新增设备", description = "添加新设备信息,包括设备ID、名称、类型等")
+ public ResponseEntity> addDevice(@Valid @RequestBody Device device) {
+ try {
+ Device newDevice = deviceService.addDevice(device);
+ return ResponseEntity.ok(ResultVO.success(newDevice, "设备新增成功"));
+ } catch (Exception e) {
+ return ResponseEntity.ok(ResultVO.error(500, "设备新增失败: " + e.getMessage()));
+ }
+ }
+
+ /**
+ * 删除设备
+ */
+ @DeleteMapping("/delete/{deviceId}")
+ @Operation(summary = "删除设备", description = "根据设备ID删除指定设备(需先解除终端绑定)")
+ public ResponseEntity> deleteDevice(@PathVariable String deviceId) {
+ try {
+ deviceService.deleteDevice(deviceId);
+ return ResponseEntity.ok(ResultVO.success(true, "设备删除成功"));
+ } catch (Exception e) {
+ return ResponseEntity.ok(ResultVO.error(500, "设备删除失败: " + e.getMessage()));
+ }
+ }
+
+ @PostMapping("/relate")
+ public ResponseEntity> relateSupplier(@RequestParam String supplierId, @RequestParam String makerId) {
+ try {
+ deviceService.relateSupplierToMaker(supplierId, makerId);
+ return ResponseEntity.ok(ResultVO.success(null, "关联成功"));
+ } catch (Exception e) {
+ return ResponseEntity.ok(ResultVO.error(500, e.getMessage()));
+ }
+ }
+
+ // 解除关联
+ @PostMapping("/unrelate")
+ public ResponseEntity> unrelateSupplier(@RequestParam String supplierId) {
+ try {
+ deviceService.unrelateSupplierFromMaker(supplierId);
+ return ResponseEntity.ok(ResultVO.success(null, "解除关联成功"));
+ } catch (Exception e) {
+ return ResponseEntity.ok(ResultVO.error(500, e.getMessage()));
+ }
+ }
+
+ // 查询制水机关联的供水机
+ @GetMapping("/maker/{makerId}/suppliers")
+ public ResponseEntity>> getSuppliers(@PathVariable String makerId) {
+ List suppliers = deviceService.getSuppliersByMaker(makerId);
+ return ResponseEntity.ok(ResultVO.success(suppliers));
+ }
+
+ /**
+ * 维修人员查询本辖区设备(按类型筛选)
+ */
+ // 在DeviceController.java中修改getAreaDevicesByTypeForRepairman方法
+ @GetMapping("/repairman/area-devices-by-type")
+ @PreAuthorize("hasRole('REPAIRMAN')")
+ @Operation(summary = "维修人员查询辖区设备(按类型)", description = "维修人员查看本辖区内指定类型的设备列表")
+ public ResponseEntity>> getAreaDevicesByTypeForRepairman(
+ @RequestParam String deviceType,
+ Authentication authentication) {
+ try {
+ // 1. 获取当前登录用户名(username)
+ String username = authentication.getName();
+
+ // 2. 通过用户名查询RepairerAuth获取维修人员ID
+ RepairerAuth repairerAuth = repairerAuthRepository.findByUsername(username)
+ .orElseThrow(() -> new RuntimeException("维修人员认证信息不存在"));
+ String repairmanId = repairerAuth.getRepairmanId();
+
+ // 3. 通过维修人员ID查询所属区域
+ Repairman repairman = repairmanRepository.findById(repairmanId)
+ .orElseThrow(() -> new RuntimeException("维修人员信息不存在"));
+ String areaId = repairman.getAreaId();
+ if (areaId == null || areaId.isEmpty()) {
+ return ResponseEntity.ok(ResultVO.error(400, "维修人员未分配辖区"));
+ }
+
+ // 4. 转换设备类型并查询
+ Device.DeviceType type = Device.DeviceType.valueOf(deviceType);
+ List devices = deviceService.queryDevices(areaId, type, null);
+
+ return ResponseEntity.ok(ResultVO.success(devices));
+ } catch (IllegalArgumentException e) {
+ return ResponseEntity.ok(ResultVO.error(400, "无效的设备类型: " + deviceType));
+ } catch (Exception e) {
+ return ResponseEntity.ok(ResultVO.error(500, "查询设备失败: " + e.getMessage()));
+ }
+ }
+
+ /**
+ * 根据设备ID查询设备详情
+ */
+ @GetMapping("/{deviceId}")
+ @Operation(summary = "查询设备详情", description = "根据设备ID获取设备的详细信息")
+ public ResponseEntity> getDeviceDetail(@PathVariable String deviceId) {
+ try {
+ Device device = deviceService.getDeviceById(deviceId);
+ return ResponseEntity.ok(ResultVO.success(device, "设备查询成功"));
+ } catch (Exception e) {
+ return ResponseEntity.ok(ResultVO.error(500, "设备查询失败: " + e.getMessage()));
+ }
+ }
+
+}
\ No newline at end of file
diff --git a/src/main/java/com/campus/water/controller/web/DeviceStatusController.java b/src/main/java/com/campus/water/controller/web/DeviceStatusController.java
new file mode 100644
index 0000000..f091cd7
--- /dev/null
+++ b/src/main/java/com/campus/water/controller/web/DeviceStatusController.java
@@ -0,0 +1,156 @@
+/**
+ * Web端设备状态管理接口控制器
+ * 功能:提供设备状态管理的RESTful API接口
+ * 用途:支持Web管理端对设备状态的手动和自动管理
+ * 接口列表:
+ * 1. 状态更新:单设备状态变更
+ * 2. 状态标记:在线/离线/故障快捷操作
+ * 3. 批量操作:批量更新设备状态
+ * 4. 状态查询:按状态筛选设备列表
+ * 5. 离线检测:查询超时离线设备
+ * 6. 自动检测:触发离线设备检测任务
+ * 安全:需要权限验证,记录操作日志
+ */
+package com.campus.water.controller.web;
+
+import com.campus.water.entity.Device;
+import com.campus.water.entity.dto.request.DeviceStatusUpdateRequest;
+import com.campus.water.service.DeviceStatusService;
+import com.campus.water.util.ResultVO;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.validation.Valid;
+import lombok.RequiredArgsConstructor;
+import org.springframework.http.ResponseEntity;
+import org.springframework.web.bind.annotation.*;
+
+import java.util.List;
+import java.util.Map;
+
+@RestController
+@RequestMapping("/api/web/device-status")
+@RequiredArgsConstructor
+@Tag(name = "设备状态管理接口", description = "Web管理端设备状态管理接口")
+public class DeviceStatusController {
+
+ private final DeviceStatusService deviceStatusService;
+
+ @PostMapping("/update")
+ @Operation(summary = "更新设备状态", description = "手动更新设备状态(在线/离线/故障)")
+ public ResponseEntity> updateDeviceStatus(
+ @Valid @RequestBody DeviceStatusUpdateRequest request) {
+ try {
+ boolean result = deviceStatusService.updateDeviceStatus(request);
+ return ResponseEntity.ok(ResultVO.success(result, "设备状态更新成功"));
+ } catch (Exception e) {
+ return ResponseEntity.ok(ResultVO.error(500, "设备状态更新失败: " + e.getMessage()));
+ }
+ }
+
+ @PostMapping("/{deviceId}/online")
+ @Operation(summary = "标记设备在线", description = "将设备标记为在线状态")
+ public ResponseEntity> markDeviceOnline(@PathVariable String deviceId) {
+ try {
+ boolean result = deviceStatusService.markDeviceOnline(deviceId);
+ return ResponseEntity.ok(ResultVO.success(result, "设备已标记为在线"));
+ } catch (Exception e) {
+ return ResponseEntity.ok(ResultVO.error(500, "标记设备在线失败: " + e.getMessage()));
+ }
+ }
+
+ @PostMapping("/{deviceId}/offline")
+ @Operation(summary = "标记设备离线", description = "将设备标记为离线状态")
+ public ResponseEntity> markDeviceOffline(
+ @PathVariable String deviceId,
+ @RequestParam(required = false) String reason) {
+ try {
+ boolean result = deviceStatusService.markDeviceOffline(deviceId, reason);
+ return ResponseEntity.ok(ResultVO.success(result, "设备已标记为离线"));
+ } catch (Exception e) {
+ return ResponseEntity.ok(ResultVO.error(500, "标记设备离线失败: " + e.getMessage()));
+ }
+ }
+
+ @PostMapping("/{deviceId}/fault")
+ @Operation(summary = "标记设备故障", description = "将设备标记为故障状态")
+ public ResponseEntity> markDeviceFault(
+ @PathVariable String deviceId,
+ @RequestParam String faultType,
+ @RequestParam String description) {
+ try {
+ boolean result = deviceStatusService.markDeviceFault(deviceId, faultType, description);
+ return ResponseEntity.ok(ResultVO.success(result, "设备已标记为故障"));
+ } catch (Exception e) {
+ return ResponseEntity.ok(ResultVO.error(500, "标记设备故障失败: " + e.getMessage()));
+ }
+ }
+
+ @PostMapping("/batch-update")
+ @Operation(summary = "批量更新设备状态", description = "批量更新多个设备的状态")
+ public ResponseEntity> batchUpdateDeviceStatus(
+ @RequestParam List deviceIds,
+ @RequestParam String status,
+ @RequestParam(required = false) String remark) {
+ try {
+ boolean result = deviceStatusService.batchUpdateDeviceStatus(deviceIds, status, remark);
+ return ResponseEntity.ok(ResultVO.success(result, "批量更新设备状态成功"));
+ } catch (Exception e) {
+ return ResponseEntity.ok(ResultVO.error(500, "批量更新设备状态失败: " + e.getMessage()));
+ }
+ }
+
+ @GetMapping("/by-status")
+ @Operation(summary = "按状态查询设备", description = "根据状态和设备类型查询设备列表")
+ public ResponseEntity>> getDevicesByStatus(
+ @RequestParam String status,
+ @RequestParam(required = false) String areaId,
+ @RequestParam(required = false) String deviceType) { // 保留设备类型参数,去除默认值
+
+ try {
+ // 调用服务层方法时传递所有参数(包括可能为null的deviceType)
+ List devices = deviceStatusService.getDevicesByStatus(status, areaId, deviceType);
+ return ResponseEntity.ok(ResultVO.success(devices));
+ } catch (Exception e) {
+ return ResponseEntity.ok(ResultVO.error(500, "查询设备失败: " + e.getMessage()));
+ }
+ }
+
+
+ @GetMapping("/status-count")
+ @Operation(summary = "设备状态数量统计", description = "统计各状态设备数量")
+ public ResponseEntity>> getDeviceStatusCount(
+ @RequestParam(required = false) String areaId,
+ @RequestParam(required = false) String deviceType) {
+ try {
+ Map result = deviceStatusService.getDeviceStatusCount(areaId, deviceType);
+ return ResponseEntity.ok(ResultVO.success(result));
+ } catch (Exception e) {
+ return ResponseEntity.ok(ResultVO.error(500, "设备状态统计失败: " + e.getMessage()));
+ }
+ }
+
+ @GetMapping("/offline-detection")
+ @Operation(summary = "离线设备检测", description = "检测离线时间超过阈值的设备")
+ public ResponseEntity>> getOfflineDevices(
+ @RequestParam(defaultValue = "30") Integer thresholdMinutes,
+ @RequestParam(required = false) String areaId) {
+ try {
+ List devices = deviceStatusService.getOfflineDevicesExceedThreshold(thresholdMinutes, areaId);
+ return ResponseEntity.ok(ResultVO.success(devices));
+ } catch (Exception e) {
+ return ResponseEntity.ok(ResultVO.error(500, "离线设备检测失败: " + e.getMessage()));
+ }
+ }
+
+ @PostMapping("/auto-detect-offline")
+ @Operation(summary = "自动检测离线设备", description = "自动检测并标记离线设备")
+ public ResponseEntity> autoDetectOfflineDevices(
+ @RequestParam(defaultValue = "30") Integer thresholdMinutes) {
+ try {
+ deviceStatusService.autoDetectOfflineDevices(thresholdMinutes);
+ return ResponseEntity.ok(ResultVO.success("离线设备检测完成"));
+ } catch (Exception e) {
+ return ResponseEntity.ok(ResultVO.error(500, "自动检测离线设备失败: " + e.getMessage()));
+ }
+ }
+}
\ No newline at end of file
diff --git a/src/main/java/com/campus/water/controller/web/RepairmanController.java b/src/main/java/com/campus/water/controller/web/RepairmanController.java
new file mode 100644
index 0000000..e93849e
--- /dev/null
+++ b/src/main/java/com/campus/water/controller/web/RepairmanController.java
@@ -0,0 +1,136 @@
+package com.campus.water.controller.web;
+
+import com.campus.water.entity.Repairman;
+import com.campus.water.service.RepairmanService;
+import com.campus.water.util.ResultVO;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.validation.Valid;
+import lombok.RequiredArgsConstructor;
+import org.springframework.http.ResponseEntity;
+import org.springframework.security.access.prepost.PreAuthorize;
+import org.springframework.web.bind.annotation.*;
+
+import java.util.List;
+import java.util.Optional;
+
+@RestController
+@RequestMapping("/api/web/repairman")
+@RequiredArgsConstructor
+@Tag(name = "维修人员管理接口", description = "Web管理端维修人员列表查询、新增、修改、删除接口")
+public class RepairmanController {
+
+ private final RepairmanService repairmanService;
+
+ /**
+ * 获取维修人员列表(支持多条件筛选)
+ * @param name 姓名模糊查询(可选)
+ * @param areaId 区域ID筛选(可选)
+ * @param status 状态筛选(可选,值:idle/busy/vacation)
+ */
+ @GetMapping("/list")
+ @PreAuthorize("hasAnyRole('SUPER_ADMIN', 'AREA_ADMIN')") // 仅管理员可访问
+ @Operation(summary = "获取维修人员列表", description = "支持按姓名、区域和状态筛选维修人员")
+ public ResponseEntity>> getRepairmanList(
+ @RequestParam(required = false) String name,
+ @RequestParam(required = false) String areaId,
+ @RequestParam(required = false) String status
+ ) {
+ try {
+ // 转换状态参数为枚举类型
+ Repairman.RepairmanStatus repairmanStatus = status != null
+ ? Repairman.RepairmanStatus.valueOf(status)
+ : null;
+
+ // 调用服务层查询
+ List repairmanList = repairmanService.getRepairmanList(name, areaId, repairmanStatus);
+ return ResponseEntity.ok(ResultVO.success(repairmanList));
+ } catch (IllegalArgumentException e) {
+ // 处理枚举参数错误
+ return ResponseEntity.ok(ResultVO.error(400, "无效的状态参数: " + e.getMessage()));
+ } catch (Exception e) {
+ // 处理其他异常
+ return ResponseEntity.ok(ResultVO.error(500, "查询维修人员列表失败: " + e.getMessage()));
+ }
+ }
+
+ /**
+ * 获取所有维修人员状态枚举
+ */
+ @GetMapping("/status")
+ @PreAuthorize("hasAnyRole('SUPER_ADMIN', 'AREA_ADMIN')")
+ @Operation(summary = "获取维修人员状态列表", description = "返回所有可选状态(idle/busy/vacation)")
+ public ResponseEntity> getAllStatus() {
+ try {
+ Repairman.RepairmanStatus[] statuses = repairmanService.getAllStatus();
+ return ResponseEntity.ok(ResultVO.success(statuses));
+ } catch (Exception e) {
+ return ResponseEntity.ok(ResultVO.error(500, "获取状态列表失败:" + e.getMessage()));
+ }
+ }
+
+ /**
+ * 新增/编辑维修人员
+ */
+ @PostMapping("/save")
+ @PreAuthorize("hasRole('SUPER_ADMIN')") // 仅超级管理员可操作
+ @Operation(summary = "保存维修人员信息", description = "新增或编辑维修人员信息,ID存在则更新,不存在则新增")
+ public ResponseEntity> saveRepairman(@Valid @RequestBody Repairman repairman) {
+ try {
+ Repairman savedRepairman = repairmanService.saveRepairman(repairman);
+ return ResponseEntity.ok(ResultVO.success(savedRepairman,
+ repairman.getRepairmanId() == null ? "维修人员新增成功" : "维修人员更新成功"));
+ } catch (Exception e) {
+ return ResponseEntity.ok(ResultVO.error(500, "保存维修人员失败: " + e.getMessage()));
+ }
+ }
+
+ /**
+ * 删除维修人员
+ */
+ @DeleteMapping("/{repairmanId}")
+ @PreAuthorize("hasRole('SUPER_ADMIN')") // 仅超级管理员可操作
+ @Operation(summary = "删除维修人员", description = "根据维修人员ID删除指定维修人员")
+ public ResponseEntity> deleteRepairman(@PathVariable String repairmanId) {
+ try {
+ repairmanService.deleteRepairman(repairmanId);
+ return ResponseEntity.ok(ResultVO.success(null, "维修人员删除成功"));
+ } catch (Exception e) {
+ return ResponseEntity.ok(ResultVO.error(500, "删除维修人员失败: " + e.getMessage()));
+ }
+ }
+
+ /**
+ * 根据ID查询维修人员详情
+ */
+ @GetMapping("/{repairmanId}")
+ @PreAuthorize("hasAnyRole('SUPER_ADMIN', 'AREA_ADMIN')")
+ @Operation(summary = "获取维修人员详情", description = "根据ID查询维修人员详细信息")
+ public ResponseEntity> getRepairmanById(@PathVariable String repairmanId) {
+ try {
+ Optional repairman = repairmanService.getRepairmanById(repairmanId);
+ return repairman.map(value -> ResponseEntity.ok(ResultVO.success(value)))
+ .orElseGet(() -> ResponseEntity.ok(ResultVO.error(404, "维修人员不存在")));
+ } catch (Exception e) {
+ return ResponseEntity.ok(ResultVO.error(500, "查询维修人员详情失败: " + e.getMessage()));
+ }
+ }
+
+ /**
+ * 根据片区ID查询维修人员
+ * 专门用于仅按片区筛选维修人员的场景,返回指定片区内的所有维修人员
+ */
+ @GetMapping("/by-area/{areaId}")
+ @PreAuthorize("hasAnyRole('SUPER_ADMIN', 'AREA_ADMIN')") // 保持与其他查询接口一致的权限控制
+ @Operation(summary = "根据片区查询维修人员", description = "根据指定的片区ID,查询该片区内的所有维修人员")
+ public ResponseEntity>> getRepairmenByArea(@PathVariable String areaId) {
+ try {
+ // 调用现有服务层方法,仅传入areaId,其他参数为null(表示不筛选)
+ List repairmen = repairmanService.getRepairmanList(null, areaId, null);
+ return ResponseEntity.ok(ResultVO.success(repairmen));
+ } catch (Exception e) {
+ // 统一异常处理,与其他接口保持一致
+ return ResponseEntity.ok(ResultVO.error(500, "根据片区查询维修人员失败: " + e.getMessage()));
+ }
+ }
+}
\ No newline at end of file
diff --git a/src/main/java/com/campus/water/controller/web/StatisticsController.java b/src/main/java/com/campus/water/controller/web/StatisticsController.java
new file mode 100644
index 0000000..6d6b666
--- /dev/null
+++ b/src/main/java/com/campus/water/controller/web/StatisticsController.java
@@ -0,0 +1,103 @@
+/**
+ * Web端统计接口控制器
+ * 功能:提供Web管理端的统计数据查询API接口
+ * 用途:前后端分离架构中的后端API服务
+ * 接口列表:
+ * 1. POST /water-usage: 用水量统计(支持多维度)
+ * 2. POST /alarm: 告警统计(次数、处理情况)
+ * 3. GET /device-status: 设备状态数量统计
+ * 4. GET /dashboard: 仪表板综合数据
+ * 5. GET /hot-devices: 热门设备用水量排名
+ * 技术:Spring MVC、参数验证、统一响应格式
+ */
+package com.campus.water.controller.web;
+
+import com.campus.water.entity.vo.AlarmStatisticsVO;
+import com.campus.water.entity.vo.StatisticsVO;
+import com.campus.water.entity.dto.request.StatisticsQueryRequest;
+import com.campus.water.service.StatisticsService;
+import com.campus.water.util.ResultVO;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.validation.Valid;
+import lombok.RequiredArgsConstructor;
+import org.springframework.http.ResponseEntity;
+import org.springframework.web.bind.annotation.*;
+
+import java.util.Map;
+
+@RestController
+@RequestMapping("/api/web/statistics")
+@RequiredArgsConstructor
+@Tag(name = "统计分析接口", description = "Web管理端统计分析接口")
+public class StatisticsController {
+
+ private final StatisticsService statisticsService;
+
+ @PostMapping("/water-usage")
+ @Operation(summary = "用水量统计", description = "按设备/区域/时间统计用水量")
+ public ResponseEntity> getWaterUsageStatistics(
+ @Valid @RequestBody StatisticsQueryRequest request) {
+ try {
+ StatisticsVO result = statisticsService.getWaterUsageStatistics(request);
+ return ResponseEntity.ok(ResultVO.success(result));
+ } catch (Exception e) {
+ return ResponseEntity.ok(ResultVO.error(500, "统计失败: " + e.getMessage()));
+ }
+ }
+
+ @PostMapping("/alarm")
+ @Operation(summary = "告警统计", description = "统计告警次数和处理情况")
+ public ResponseEntity> getAlarmStatistics(
+ @Valid @RequestBody StatisticsQueryRequest request) {
+ try {
+ AlarmStatisticsVO result = statisticsService.getAlarmStatistics(request);
+ return ResponseEntity.ok(ResultVO.success(result));
+ } catch (Exception e) {
+ return ResponseEntity.ok(ResultVO.error(500, "告警统计失败: " + e.getMessage()));
+ }
+ }
+
+ @GetMapping("/device-status")
+ @Operation(summary = "设备状态统计", description = "统计各状态设备数量")
+ public ResponseEntity>> getDeviceStatusStatistics(
+ @RequestParam(required = false) String areaId,
+ @RequestParam(required = false) String deviceType) {
+ try {
+ Map result = statisticsService.getDeviceStatusStatistics(areaId, deviceType);
+ return ResponseEntity.ok(ResultVO.success(result));
+ } catch (Exception e) {
+ return ResponseEntity.ok(ResultVO.error(500, "设备状态统计失败: " + e.getMessage()));
+ }
+ }
+
+ @GetMapping("/dashboard")
+ @Operation(summary = "仪表盘数据", description = "获取综合仪表盘统计数据")
+ public ResponseEntity>> getDashboardStatistics() {
+ try {
+ Map result = statisticsService.getDashboardStatistics();
+ return ResponseEntity.ok(ResultVO.success(result));
+ } catch (Exception e) {
+ return ResponseEntity.ok(ResultVO.error(500, "获取仪表盘数据失败: " + e.getMessage()));
+ }
+ }
+
+ @GetMapping("/hot-devices")
+ @Operation(summary = "热门设备统计", description = "获取用水量最高的设备")
+ public ResponseEntity> getHotDevices(
+ @RequestParam(defaultValue = "7") Integer days,
+ @RequestParam(defaultValue = "10") Integer limit) {
+ try {
+ StatisticsQueryRequest request = new StatisticsQueryRequest();
+ request.setStatType("by_device");
+ request.setStartDate(java.time.LocalDate.now().minusDays(days));
+ request.setEndDate(java.time.LocalDate.now());
+ request.setLimit(limit);
+
+ StatisticsVO result = statisticsService.getWaterUsageStatistics(request);
+ return ResponseEntity.ok(ResultVO.success(result));
+ } catch (Exception e) {
+ return ResponseEntity.ok(ResultVO.error(500, "获取热门设备失败: " + e.getMessage()));
+ }
+ }
+}
\ No newline at end of file
diff --git a/src/main/java/com/campus/water/controller/web/UserController.java b/src/main/java/com/campus/water/controller/web/UserController.java
new file mode 100644
index 0000000..fdaa784
--- /dev/null
+++ b/src/main/java/com/campus/water/controller/web/UserController.java
@@ -0,0 +1,112 @@
+package com.campus.water.controller.web;
+
+import com.campus.water.entity.User;
+import com.campus.water.service.UserService;
+import com.campus.water.util.ResultVO;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import lombok.RequiredArgsConstructor;
+import org.springframework.http.ResponseEntity;
+import org.springframework.security.access.prepost.PreAuthorize;
+import org.springframework.web.bind.annotation.*; // 补充Web注解的统一导入
+
+import java.util.List;
+import java.util.Optional; // 补充Optional的导入
+
+
+@RestController
+@RequestMapping("/api/web/user")
+@RequiredArgsConstructor
+@Tag(name = "学生管理接口", description = "Web管理端学生操作接口")
+public class UserController {
+
+ private final UserService userService; // 只依赖Service,不直接依赖Repository
+
+
+ /**
+ * 获取学生列表(支持姓名/状态筛选)
+ */
+ @GetMapping("/list")
+ @PreAuthorize("hasAnyRole('SUPER_ADMIN', 'AREA_ADMIN')")
+ @Operation(summary = "获取学生列表", description = "支持按姓名模糊搜索、按状态筛选")
+ public ResponseEntity>> getUserList(
+ @RequestParam(required = false) String studentName,
+ @RequestParam(required = false) User.UserStatus status
+ ) {
+ try {
+ List userList = userService.getUserList(studentName, status);
+ return ResponseEntity.ok(ResultVO.success(userList));
+ } catch (Exception e) {
+ return ResponseEntity.ok(ResultVO.error(500, "查询失败:" + e.getMessage()));
+ }
+ }
+
+
+ /**
+ * 获取所有学生状态枚举
+ */
+ @GetMapping("/status")
+ @PreAuthorize("hasAnyRole('SUPER_ADMIN', 'AREA_ADMIN')")
+ @Operation(summary = "获取学生状态列表", description = "返回所有可选状态(active/inactive)")
+ public ResponseEntity> getAllStatus() {
+ try {
+ User.UserStatus[] statuses = User.UserStatus.values();
+ return ResponseEntity.ok(ResultVO.success(statuses));
+ } catch (Exception e) {
+ return ResponseEntity.ok(ResultVO.error(500, "获取状态列表失败:" + e.getMessage()));
+ }
+ }
+
+
+ /**
+ * 新增/编辑学生(移除直接依赖Repository的逻辑,交给Service处理)
+ */
+ @PostMapping("/save") // 已补充@PostMapping的导入
+ @PreAuthorize("hasRole('SUPER_ADMIN')")
+ @Operation(summary = "保存学生信息", description = "新增/编辑学生,支持指定状态")
+ public ResponseEntity> saveUser(@RequestBody User user) { // 已补充@RequestBody的导入
+ try {
+ // 学号唯一性校验移到Service层处理,Controller只调用Service
+ User savedUser = userService.saveUser(user);
+ return ResponseEntity.ok(ResultVO.success(
+ savedUser,
+ user.getStudentId() == null ? "学生新增成功" : "学生信息更新成功"
+ ));
+ } catch (Exception e) {
+ return ResponseEntity.ok(ResultVO.error(500, "保存失败:" + e.getMessage()));
+ }
+ }
+
+
+ /**
+ * 删除学生
+ */
+ @DeleteMapping("/{studentId}") // 已补充@DeleteMapping的导入
+ @PreAuthorize("hasRole('SUPER_ADMIN')")
+ @Operation(summary = "删除学生", description = "按学号删除学生")
+ public ResponseEntity> deleteUser(@PathVariable String studentId) { // 已补充@PathVariable的导入
+ try {
+ userService.deleteUser(studentId);
+ return ResponseEntity.ok(ResultVO.success(null, "删除成功"));
+ } catch (Exception e) {
+ return ResponseEntity.ok(ResultVO.error(500, "删除失败:" + e.getMessage()));
+ }
+ }
+
+
+ /**
+ * 根据学号查询学生详情
+ */
+ @GetMapping("/{studentId}")
+ @PreAuthorize("hasAnyRole('SUPER_ADMIN', 'AREA_ADMIN')")
+ @Operation(summary = "获取学生详情", description = "按学号查询学生详细信息")
+ public ResponseEntity> getUserById(@PathVariable String studentId) {
+ try {
+ Optional user = userService.getUserById(studentId);
+ return user.map(value -> ResponseEntity.ok(ResultVO.success(value)))
+ .orElseGet(() -> ResponseEntity.ok(ResultVO.error(404, "学生不存在")));
+ } catch (Exception e) {
+ return ResponseEntity.ok(ResultVO.error(500, "查询失败:" + e.getMessage()));
+ }
+ }
+}
\ No newline at end of file
diff --git a/src/main/java/com/campus/water/controller/web/先读我.md b/src/main/java/com/campus/water/controller/web/先读我.md
new file mode 100644
index 0000000..3b52c1f
--- /dev/null
+++ b/src/main/java/com/campus/water/controller/web/先读我.md
@@ -0,0 +1 @@
+# 本md仅用于初始化目录,未创建所有子一级目录,在当前目录创建文件后请自行删除
\ No newline at end of file
diff --git a/src/main/java/com/campus/water/entity/Admin.java b/src/main/java/com/campus/water/entity/Admin.java
new file mode 100644
index 0000000..d75431c
--- /dev/null
+++ b/src/main/java/com/campus/water/entity/Admin.java
@@ -0,0 +1,46 @@
+package com.campus.water.entity;
+
+import jakarta.persistence.*;
+import lombok.Data;
+
+import java.time.LocalDateTime;
+import org.hibernate.annotations.GenericGenerator;
+
+@Data
+@Entity
+@Table(name = "admin")
+public class Admin {
+ @Id
+ @GeneratedValue(generator = "uuid")
+ @GenericGenerator(name = "uuid", strategy = "org.hibernate.id.UUIDGenerator")
+ @Column(name = "admin_id", length = 50, nullable = false)
+ private String adminId;
+
+ @Column(name = "admin_name", length = 50)
+ private String adminName;
+
+ @Column(name = "password", length = 200)
+ private String password;
+
+ @Column(name = "phone", length = 20)
+ private String phone;
+
+ // 恢复三个角色枚举
+ @Enumerated(EnumType.STRING)
+ @Column(name = "role", length = 50, nullable = false)
+ private AdminRole role;
+
+ @Column(name = "created_time")
+ private LocalDateTime createdTime = LocalDateTime.now();
+
+ @Column(name = "updated_time")
+ private LocalDateTime updatedTime = LocalDateTime.now();
+
+ // 枚举类:恢复super_admin、area_admin、viewer三个角色
+ // java/com/campus/water/entity/Admin.java
+ public enum AdminRole {
+ ROLE_SUPER_ADMIN, // 超级管理员(原super_admin)
+ ROLE_AREA_ADMIN, // 区域管理员(原area_admin)
+ ROLE_VIEWER // 查看者(原viewer)
+ }
+}
\ No newline at end of file
diff --git a/src/main/java/com/campus/water/entity/Alert.java b/src/main/java/com/campus/water/entity/Alert.java
new file mode 100644
index 0000000..43eb7e0
--- /dev/null
+++ b/src/main/java/com/campus/water/entity/Alert.java
@@ -0,0 +1,84 @@
+/**
+ * 告警信息实体类
+ * 对应表:alert
+ * 用于记录设备告警信息,包括告警级别、状态、处理人等
+ */
+package com.campus.water.entity;
+
+import lombok.Data;
+import jakarta.persistence.*;
+import java.time.LocalDateTime;
+
+@Data
+@Entity
+@Table(name = "alert")
+public class Alert {
+ @Id
+ @GeneratedValue(strategy = GenerationType.IDENTITY)
+ @Column(name = "alert_id")
+ private Long alertId;
+
+ @Column(name = "device_id", length = 20)
+ private String deviceId;
+
+ @Column(name = "alert_type", length = 50)
+ private String alertType;
+
+ @Enumerated(EnumType.STRING)
+ @Column(name = "alert_level", length = 50)
+ private AlertLevel alertLevel;
+
+ @Column(name = "alert_message", columnDefinition = "TEXT")
+ private String alertMessage;
+
+ @Column(name = "area_id", length = 20)
+ private String areaId;
+
+ @Enumerated(EnumType.STRING)
+ @Column(name = "status", length = 50)
+ private AlertStatus status = AlertStatus.pending;
+
+ @Column(name = "timestamp")
+ private LocalDateTime timestamp = LocalDateTime.now();
+
+ @Column(name = "resolved_time")
+ private LocalDateTime resolvedTime;
+
+ @Column(name = "resolved_by", length = 50)
+ private String resolvedBy;
+
+ @Column(name = "created_time")
+ private LocalDateTime createdTime = LocalDateTime.now();
+
+ @Column(name = "updated_time")
+ private LocalDateTime updatedTime = LocalDateTime.now();
+
+ public enum AlertLevel {
+ info("一般", 1), // 信息级(如状态通知,无需处理)
+ warning("一般", 2), // 警告级(需关注,非紧急)
+ error("紧急", 3), // 错误级(需立即处理)
+ critical("紧急", 4); // 严重级(影响服务,最高优先级)
+
+ private final String levelName; // 分级名称(一般/紧急)
+ private final int priority; // 处理优先级(1-4,升序)
+
+ AlertLevel(String levelName, int priority) {
+ this.levelName = levelName;
+ this.priority = priority;
+ }
+
+ // 获取分级名称(用于前端展示)
+ public String getLevelName() {
+ return levelName;
+ }
+
+ // 获取优先级(用于推送排序)
+ public int getPriority() {
+ return priority;
+ }
+ }
+
+ public enum AlertStatus {
+ pending, processing, resolved, closed
+ }
+}
\ No newline at end of file
diff --git a/src/main/java/com/campus/water/entity/Area.java b/src/main/java/com/campus/water/entity/Area.java
new file mode 100644
index 0000000..45a1da0
--- /dev/null
+++ b/src/main/java/com/campus/water/entity/Area.java
@@ -0,0 +1,48 @@
+/**
+ * 区域信息实体类
+ * 对应表:area
+ * 用于管理校园、楼宇、区域等层级结构信息
+ */
+package com.campus.water.entity;
+
+import lombok.Data;
+import jakarta.persistence.*;
+import java.time.LocalDateTime;
+
+@Data
+@Entity
+@Table(name = "area")
+public class Area {
+ @Id
+ @Column(name = "area_id", length = 20)
+ private String areaId;
+
+ @Column(name = "area_name", length = 100)
+ private String areaName;
+
+ @Enumerated(EnumType.STRING)
+ @Column(name = "area_type", length = 50)
+ private AreaType areaType;
+
+ @Column(name = "parent_area_id", length = 20)
+ private String parentAreaId;
+
+ @Column(length = 200)
+ private String address;
+
+ @Column(length = 50)
+ private String manager;
+
+ @Column(name = "manager_phone", length = 20) // 确保这个字段存在
+ private String managerPhone;
+
+ @Column(name = "created_time")
+ private LocalDateTime createdTime = LocalDateTime.now();
+
+ @Column(name = "updated_time")
+ private LocalDateTime updatedTime = LocalDateTime.now();
+
+ public enum AreaType {
+ campus, building, zone
+ }
+}
\ No newline at end of file
diff --git a/src/main/java/com/campus/water/entity/Device.java b/src/main/java/com/campus/water/entity/Device.java
new file mode 100644
index 0000000..4c38c3e
--- /dev/null
+++ b/src/main/java/com/campus/water/entity/Device.java
@@ -0,0 +1,60 @@
+// com/campus/water/entity/Device.java
+package com.campus.water.entity;
+
+import lombok.Data;
+import jakarta.persistence.*;
+import java.time.LocalDate;
+import java.time.LocalDateTime;
+
+/**
+ * 设备信息实体类(对应原始device表,不新增字段)
+ */
+@Data
+@Entity
+@Table(name = "device")
+public class Device {
+ @Id
+ @Column(name = "device_id", length = 20)
+ private String deviceId;
+
+ @Column(name = "device_name", length = 100)
+ private String deviceName;
+
+ @Enumerated(EnumType.STRING)
+ @Column(name = "device_type", length = 50)
+ private DeviceType deviceType;
+
+ @Column(name = "area_id", length = 20)
+ private String areaId;
+
+ @Column(name = "install_location", length = 200)
+ private String installLocation;
+
+ @Column(name = "install_date")
+ private LocalDate installDate;
+
+ @Enumerated(EnumType.STRING)
+ @Column(name = "status", length = 50)
+ private DeviceStatus status = DeviceStatus.online;
+
+ @Column(name = "create_time")
+ private LocalDateTime createTime = LocalDateTime.now();
+
+ // 新增:关联的制水机ID(仅供水机有值)
+ @Column(name = "parent_maker_id", length = 20)
+ private String parentMakerId;
+
+ // 保留原有的remark方法(若表中有该字段可直接映射,无则忽略)
+ private String remark;
+ public void setRemark(String remark) {
+ this.remark = remark;
+ }
+
+ public enum DeviceType {
+ water_maker, water_supply
+ }
+
+ public enum DeviceStatus {
+ online, offline, fault
+ }
+}
\ No newline at end of file
diff --git a/src/main/java/com/campus/water/entity/DeviceTerminalMapping.java b/src/main/java/com/campus/water/entity/DeviceTerminalMapping.java
new file mode 100644
index 0000000..22f4a9a
--- /dev/null
+++ b/src/main/java/com/campus/water/entity/DeviceTerminalMapping.java
@@ -0,0 +1,41 @@
+/**
+ * 设备与终端映射实体类
+ * 对应表:device_terminal_mapping
+ * 用于关联设备与终端设备,记录终端状态和安装信息
+ */
+package com.campus.water.entity;
+
+import lombok.Data;
+import jakarta.persistence.*;
+import java.time.LocalDate;
+import java.time.LocalDateTime;
+
+@Data
+@Entity
+@Table(name = "device_terminal_mapping")
+public class DeviceTerminalMapping {
+ @Id
+ @GeneratedValue(strategy = GenerationType.IDENTITY)
+ @Column(name = "mapping_id")
+ private Integer mappingId;
+
+ @Column(name = "device_id", length = 20)
+ private String deviceId;
+
+ @Column(name = "terminal_id", length = 20)
+ private String terminalId;
+
+ @Column(name = "terminal_name", length = 100)
+ private String terminalName;
+
+ @Enumerated(EnumType.STRING)
+ @Column(name = "terminal_status", length = 50)
+ private TerminalStatus terminalStatus;
+
+ @Column(name = "install_date")
+ private LocalDate installDate;
+
+ public enum TerminalStatus {
+ active, inactive
+ }
+}
\ No newline at end of file
diff --git a/src/main/java/com/campus/water/entity/DrinkRecommendation.java b/src/main/java/com/campus/water/entity/DrinkRecommendation.java
new file mode 100644
index 0000000..417abe6
--- /dev/null
+++ b/src/main/java/com/campus/water/entity/DrinkRecommendation.java
@@ -0,0 +1,38 @@
+/**
+ * 饮水推荐实体类
+ * 对应表:drink_recommendation
+ * 用于记录学生的每日饮水目标和当前进度
+ */
+package com.campus.water.entity;
+
+import lombok.Data;
+import jakarta.persistence.*;
+
+import java.math.BigDecimal;
+import java.time.LocalDate;
+import java.time.LocalDateTime;
+
+@Data
+@Entity
+@Table(name = "drink_recommendation")
+public class DrinkRecommendation {
+ @Id
+ @GeneratedValue(strategy = GenerationType.IDENTITY)
+ @Column(name = "recommendation_id")
+ private Integer recommendationId;
+
+ @Column(name = "student_id", length = 50)
+ private String studentId;
+
+ @Column(name = "daily_target")
+ private Double dailyTarget;
+
+ @Column(name = "current_progress", precision = 6, scale = 2)
+ private BigDecimal currentProgress;
+
+ @Column(name = "recommendation_date")
+ private LocalDate recommendationDate;
+
+ @Column(name = "created_time")
+ private LocalDateTime createdTime = LocalDateTime.now();
+}
\ No newline at end of file
diff --git a/src/main/java/com/campus/water/entity/DrinkRecord.java b/src/main/java/com/campus/water/entity/DrinkRecord.java
new file mode 100644
index 0000000..e2d9e3b
--- /dev/null
+++ b/src/main/java/com/campus/water/entity/DrinkRecord.java
@@ -0,0 +1,51 @@
+/**
+ * 饮水记录实体类
+ * 对应表:drink_record
+ * 用于记录学生的每次饮水行为,包括用水量、水质、时间、位置等
+ */
+package com.campus.water.entity;
+
+import lombok.Data;
+import jakarta.persistence.*;
+
+import java.math.BigDecimal;
+import java.time.LocalDateTime;
+
+@Data
+@Entity
+@Table(name = "drink_record")
+public class DrinkRecord {
+ @Id
+ @GeneratedValue(strategy = GenerationType.IDENTITY)
+ @Column(name = "record_id")
+ private Long recordId;
+
+ @Column(name = "student_id", length = 50)
+ private String studentId;
+
+ @Column(name = "terminal_id", length = 20)
+ private String terminalId;
+
+ @Column(name = "device_id", length = 20)
+ private String deviceId;
+
+ // 根据文档修正:字段名改为 water_consumption
+ @Column(name = "water_consumption", precision = 6, scale = 2)
+ private BigDecimal waterConsumption;
+
+ @Column(name = "water_quality", length = 50)
+ private String waterQuality;
+
+ @Column(name = "tds_value", precision = 8, scale = 2)
+ private BigDecimal tdsValue;
+
+ // 根据文档修正:字段名改为 drink_time
+ @Column(name = "drink_time")
+ private LocalDateTime drinkTime;
+
+ @Column(name = "location", length = 200)
+ private String location;
+
+ @Column(name = "created_time")
+ private LocalDateTime createdTime = LocalDateTime.now();
+}
\ No newline at end of file
diff --git a/src/main/java/com/campus/water/entity/InspectionRecord.java b/src/main/java/com/campus/water/entity/InspectionRecord.java
new file mode 100644
index 0000000..8440772
--- /dev/null
+++ b/src/main/java/com/campus/water/entity/InspectionRecord.java
@@ -0,0 +1,49 @@
+/**
+ * 巡检记录实体类
+ * 对应表:inspection_record
+ * 用于记录维修人员的巡检结果,包括状态、异常描述、照片等
+ */
+package com.campus.water.entity;
+
+import lombok.Data;
+import jakarta.persistence.*;
+import java.time.LocalDateTime;
+
+@Data
+@Entity
+@Table(name = "inspection_record")
+public class InspectionRecord {
+ @Id
+ @GeneratedValue(strategy = GenerationType.IDENTITY)
+ @Column(name = "inspection_id")
+ private Integer inspectionId;
+
+ @Column(name = "order_id", length = 30)
+ private String orderId;
+
+ @Column(name = "repairman_id", length = 50)
+ private String repairmanId;
+
+ @Column(name = "device_id", length = 20)
+ private String deviceId;
+
+ @Enumerated(EnumType.STRING)
+ @Column(name = "inspection_status", length = 50)
+ private InspectionStatus inspectionStatus;
+
+ @Column(name = "abnormal_description", columnDefinition = "LONGTEXT")
+ private String abnormalDescription;
+
+ @Column(name = "inspection_photo", columnDefinition = "LONGTEXT")
+ private String inspectionPhoto;
+
+ @Column(name = "inspection_time")
+ private LocalDateTime inspectionTime;
+
+ @Column(name = "submitted_at")
+ private LocalDateTime submittedAt = LocalDateTime.now();
+
+ public enum InspectionStatus {
+ normal, abnormal
+ }
+}
\ No newline at end of file
diff --git a/src/main/java/com/campus/water/entity/MaintenancePlan.java b/src/main/java/com/campus/water/entity/MaintenancePlan.java
new file mode 100644
index 0000000..6bc5c89
--- /dev/null
+++ b/src/main/java/com/campus/water/entity/MaintenancePlan.java
@@ -0,0 +1,47 @@
+/**
+ * 维护计划实体类
+ * 对应表:maintenance_plan
+ * 用于制定和管理设备的定期维护计划
+ */
+package com.campus.water.entity;
+
+import lombok.Data;
+import jakarta.persistence.*;
+import java.time.LocalDate;
+import java.time.LocalDateTime;
+
+@Data
+@Entity
+@Table(name = "maintenance_plan")
+public class MaintenancePlan {
+ @Id
+ @GeneratedValue(strategy = GenerationType.IDENTITY)
+ @Column(name = "plan_id")
+ private Integer planId;
+
+ @Column(name = "device_id", length = 20)
+ private String deviceId;
+
+ @Column(name = "maintenance_type", length = 50)
+ private String maintenanceType;
+
+ @Column(name = "cycle_days")
+ private Integer cycleDays;
+
+ @Column(name = "last_maintenance_date")
+ private LocalDate lastMaintenanceDate;
+
+ @Column(name = "next_maintenance_date")
+ private LocalDate nextMaintenanceDate;
+
+ @Enumerated(EnumType.STRING)
+ @Column(name = "plan_status", length = 50)
+ private PlanStatus planStatus;
+
+ @Column(name = "created_time")
+ private LocalDateTime createdTime = LocalDateTime.now();
+
+ public enum PlanStatus {
+ effective, expired, closed
+ }
+}
\ No newline at end of file
diff --git a/src/main/java/com/campus/water/entity/MessagePush.java b/src/main/java/com/campus/water/entity/MessagePush.java
new file mode 100644
index 0000000..ef6f9de
--- /dev/null
+++ b/src/main/java/com/campus/water/entity/MessagePush.java
@@ -0,0 +1,53 @@
+/**
+ * 消息推送记录实体类
+ * 对应表:message_push
+ * 用于存储系统向用户、管理员、维修人员推送的消息记录
+ */
+package com.campus.water.entity;
+
+import lombok.Data;
+import jakarta.persistence.*;
+import java.time.LocalDateTime;
+
+@Data
+@Entity
+@Table(name = "message_push")
+public class MessagePush {
+ @Id
+ @GeneratedValue(strategy = GenerationType.IDENTITY)
+ @Column(name = "message_id")
+ private Integer messageId;
+
+ @Column(name = "student_id", length = 50)
+ private String studentId;
+
+ @Column(name = "admin_id", length = 50)
+ private String adminId;
+
+ @Column(name = "repairman_id", length = 50)
+ private String repairmanId;
+
+ @Column(name = "user_id", length = 50)
+ private String userId;
+
+ @Column(name = "user_type", length = 50)
+ private String userType;
+
+ @Column(name = "message_type", length = 50)
+ private String messageType;
+
+ @Column(name = "title", length = 200)
+ private String title;
+
+ @Column(name = "content", columnDefinition = "LONGTEXT")
+ private String content;
+
+ @Column(name = "is_read")
+ private Boolean isRead = false;
+
+ @Column(name = "push_time")
+ private LocalDateTime pushTime = LocalDateTime.now();
+
+ @Column(name = "related_id", length = 50)
+ private String relatedId;
+}
\ No newline at end of file
diff --git a/src/main/java/com/campus/water/entity/RepairerAuth.java b/src/main/java/com/campus/water/entity/RepairerAuth.java
new file mode 100644
index 0000000..8ae987b
--- /dev/null
+++ b/src/main/java/com/campus/water/entity/RepairerAuth.java
@@ -0,0 +1,46 @@
+/**
+ * 维修人员认证信息实体类
+ * 对应表:repairer_auth
+ * 用于存储维修人员的登录账号、密码、状态等信息
+ */
+package com.campus.water.entity;
+
+import lombok.Data;
+import jakarta.persistence.*;
+import java.time.LocalDateTime;
+
+@Data
+@Entity
+@Table(name = "repairer_auth")
+public class RepairerAuth {
+ @Id
+ @GeneratedValue(strategy = GenerationType.IDENTITY)
+ @Column(name = "auth_id")
+ private Long authId;
+
+ @Column(name = "repairman_id", length = 50)
+ private String repairmanId;
+
+ @Column(name = "username", length = 50)
+ private String username;
+
+ @Column(name = "password", length = 200)
+ private String password;
+
+ @Enumerated(EnumType.STRING)
+ @Column(name = "account_status", length = 50)
+ private AccountStatus accountStatus = AccountStatus.active;
+
+ @Column(name = "last_login")
+ private LocalDateTime lastLogin;
+
+ @Column(name = "created_time")
+ private LocalDateTime createdTime = LocalDateTime.now();
+
+ @Column(name = "updated_time")
+ private LocalDateTime updatedTime = LocalDateTime.now();
+
+ public enum AccountStatus {
+ active, inactive, locked
+ }
+}
\ No newline at end of file
diff --git a/src/main/java/com/campus/water/entity/Repairman.java b/src/main/java/com/campus/water/entity/Repairman.java
new file mode 100644
index 0000000..fc08920
--- /dev/null
+++ b/src/main/java/com/campus/water/entity/Repairman.java
@@ -0,0 +1,50 @@
+/**
+ * 维修人员信息实体类
+ * 对应表:repairman
+ * 用于存储维修人员信息,包括技能、状态、工作量、评分等
+ */
+package com.campus.water.entity;
+
+import lombok.Data;
+import jakarta.persistence.*;
+
+import java.math.BigDecimal;
+import java.time.LocalDateTime;
+
+@Data
+@Entity
+@Table(name = "repairman")
+public class Repairman {
+ @Id
+ @Column(name = "repairman_id", length = 50)
+ private String repairmanId;
+
+ @Column(name = "repairman_name", length = 100)
+ private String repairmanName;
+
+ @Column(length = 20)
+ private String phone;
+
+ @Column(name = "area_id", length = 20)
+ private String areaId;
+
+ @Column(name = "skills", length = 200)
+ private String skills;
+
+ @Enumerated(EnumType.STRING)
+ @Column(name = "status", length = 50)
+ private RepairmanStatus status = RepairmanStatus.idle;
+
+ @Column(name = "work_count")
+ private Integer workCount = 0;
+
+ @Column(name = "rating", precision = 3, scale = 2)
+ private BigDecimal rating ;
+
+ @Column(name = "created_time")
+ private LocalDateTime createdTime = LocalDateTime.now();
+
+ public enum RepairmanStatus {
+ idle, busy, vacation
+ }
+}
\ No newline at end of file
diff --git a/src/main/java/com/campus/water/entity/TerminalUsageStats.java b/src/main/java/com/campus/water/entity/TerminalUsageStats.java
new file mode 100644
index 0000000..d5812e9
--- /dev/null
+++ b/src/main/java/com/campus/water/entity/TerminalUsageStats.java
@@ -0,0 +1,47 @@
+/**
+ * 终端使用统计实体类
+ * 对应表:terminal_usage_stats
+ * 用于记录终端设备的每日使用情况统计,如用水量、使用次数等
+ */
+package com.campus.water.entity;
+
+import lombok.Data;
+import jakarta.persistence.*;
+
+import java.math.BigDecimal;
+import java.time.LocalDate;
+import java.time.LocalDateTime;
+
+@Data
+@Entity
+@Table(name = "terminal_usage_stats")
+public class TerminalUsageStats {
+ @Id
+ @GeneratedValue(strategy = GenerationType.IDENTITY)
+ @Column(name = "stat_id")
+ private Long statId;
+
+ @Column(name = "terminal_id", length = 20)
+ private String terminalId;
+
+ @Column(name = "stat_date")
+ private LocalDate statDate;
+
+ @Column(name = "usage_count")
+ private Integer usageCount = 0;
+
+ @Column(name = "total_water_output", precision = 10, scale = 2)
+ private BigDecimal totalWaterOutput ;
+
+ @Column(name = "avg_water_per_use", precision = 6, scale = 2)
+ private BigDecimal avgWaterPerUse ;
+
+ @Column(name = "peak_hour", length = 5)
+ private String peakHour;
+
+ @Column(name = "created_time")
+ private LocalDateTime createdTime = LocalDateTime.now();
+
+ @Column(name = "updated_time")
+ private LocalDateTime updatedTime = LocalDateTime.now();
+}
\ No newline at end of file
diff --git a/src/main/java/com/campus/water/entity/User.java b/src/main/java/com/campus/water/entity/User.java
new file mode 100644
index 0000000..3f1cf90
--- /dev/null
+++ b/src/main/java/com/campus/water/entity/User.java
@@ -0,0 +1,45 @@
+/**
+ * 用户信息实体类(学生用户)
+ * 对应表:user
+ * 用于存储学生用户的基本信息、登录状态等
+ */
+package com.campus.water.entity;
+
+import lombok.Data;
+import jakarta.persistence.*;
+import java.time.LocalDateTime;
+
+@Data
+@Entity
+@Table(name = "user")
+public class User {
+ @Id
+ @Column(name = "student_id", length = 50)
+ private String studentId;
+
+ @Column(name = "student_name", length = 50)
+ private String studentName;
+
+ @Column(name = "password", length = 200)
+ private String password;
+
+ @Column(name = "phone", length = 20)
+ private String phone;
+
+ @Column(name = "email", length = 100)
+ private String email;
+
+ @Enumerated(EnumType.STRING)
+ @Column(name = "status", length = 50)
+ private UserStatus status = UserStatus.active;
+
+ @Column(name = "create_time")
+ private LocalDateTime createTime = LocalDateTime.now();
+
+ @Column(name = "updated_time")
+ private LocalDateTime updatedTime = LocalDateTime.now();
+
+ public enum UserStatus {
+ active, inactive
+ }
+}
\ No newline at end of file
diff --git a/src/main/java/com/campus/water/entity/WaterMakerRealtimeData.java b/src/main/java/com/campus/water/entity/WaterMakerRealtimeData.java
new file mode 100644
index 0000000..96c0e9e
--- /dev/null
+++ b/src/main/java/com/campus/water/entity/WaterMakerRealtimeData.java
@@ -0,0 +1,69 @@
+/**
+ * 实时制水数据实体类
+ * 对应表:water_maker_realtime_data
+ * 用于存储制水设备的实时运行数据,如TDS、流量、压力、滤芯寿命等
+ */
+package com.campus.water.entity;
+
+import lombok.Data;
+import jakarta.persistence.*;
+
+import java.math.BigDecimal;
+import java.time.LocalDateTime;
+
+@Data
+@Entity
+@Table(name = "water_maker_realtime_data")
+public class WaterMakerRealtimeData {
+ @Id
+ @GeneratedValue(strategy = GenerationType.IDENTITY)
+ private Long id;
+
+ @Column(name = "device_id", length = 20)
+ private String deviceId;
+
+ // 根据文档修正:三个TDS值
+ @Column(name = "tds_value1", precision = 8, scale = 2)
+ private BigDecimal tdsValue1; // 原水TDS
+
+ @Column(name = "tds_value2", precision = 8, scale = 2)
+ private BigDecimal tdsValue2; // 纯水TDS
+
+ @Column(name = "tds_value3", precision = 8, scale = 2)
+ private BigDecimal tdsValue3; // 矿化水TDS
+
+ // 根据文档修正:两个流量计
+ @Column(name = "water_flow1", precision = 8, scale = 2)
+ private BigDecimal waterFlow1;
+
+ @Column(name = "water_flow2", precision = 8, scale = 2)
+ private BigDecimal waterFlow2;
+
+ // 根据文档修正:字段名改为 water_press
+ @Column(name = "water_press", precision = 8, scale = 2)
+ private BigDecimal waterPress;
+
+ @Column(name = "filter_life")
+ private Integer filterLife;
+
+ @Column(name = "leakage")
+ private Boolean leakage = false;
+
+ @Column(name = "water_quality", length = 50)
+ private String waterQuality;
+
+ @Enumerated(EnumType.STRING)
+ @Column(name = "status", length = 50)
+ private DeviceStatus status = DeviceStatus.normal;
+
+ // 根据文档修正:字段名改为 record_time
+ @Column(name = "record_time")
+ private LocalDateTime recordTime = LocalDateTime.now();
+
+ @Column(name = "created_time")
+ private LocalDateTime createdTime = LocalDateTime.now();
+
+ public enum DeviceStatus {
+ normal, warning, error
+ }
+}
\ No newline at end of file
diff --git a/src/main/java/com/campus/water/entity/WaterQualityHistory.java b/src/main/java/com/campus/water/entity/WaterQualityHistory.java
new file mode 100644
index 0000000..d106a57
--- /dev/null
+++ b/src/main/java/com/campus/water/entity/WaterQualityHistory.java
@@ -0,0 +1,48 @@
+/**
+ * 水质历史数据实体类
+ * 对应表:water_quality_history
+ * 用于记录终端设备检测的水质历史数据,包括多个TDS值和水质评级
+ */
+package com.campus.water.entity;
+
+import lombok.Data;
+import jakarta.persistence.*;
+
+import java.math.BigDecimal;
+import java.time.LocalDateTime;
+
+@Data
+@Entity
+@Table(name = "water_quality_history")
+public class WaterQualityHistory {
+ @Id
+ @GeneratedValue(strategy = GenerationType.IDENTITY)
+ @Column(name = "history_id")
+ private Long historyId;
+
+ @Column(name = "terminal_id", length = 20)
+ private String terminalId;
+
+ @Column(name = "device_id", length = 20)
+ private String deviceId;
+
+ // 根据文档修正:三个TDS值
+ @Column(name = "tds_value1", precision = 8, scale = 2)
+ private BigDecimal tdsValue1; // 原水TDS
+
+ @Column(name = "tds_value2", precision = 8, scale = 2)
+ private BigDecimal tdsValue2; // 纯水TDS
+
+ @Column(name = "tds_value3", precision = 8, scale = 2)
+ private BigDecimal tdsValue3; // 矿化水TDS
+
+ @Column(name = "water_quality", length = 50)
+ private String waterQuality;
+
+ // 根据文档修正:字段名改为 detected_time
+ @Column(name = "detected_time")
+ private LocalDateTime detectedTime = LocalDateTime.now();
+
+ @Column(name = "created_time")
+ private LocalDateTime createdTime = LocalDateTime.now();
+}
\ No newline at end of file
diff --git a/src/main/java/com/campus/water/entity/WaterSupplyRealtimeData.java b/src/main/java/com/campus/water/entity/WaterSupplyRealtimeData.java
new file mode 100644
index 0000000..a4c735e
--- /dev/null
+++ b/src/main/java/com/campus/water/entity/WaterSupplyRealtimeData.java
@@ -0,0 +1,51 @@
+/**
+ * 实时供水数据实体类
+ * 对应表:water_supply_realtime_data
+ * 用于存储供水设备的实时运行数据,如流量、压力、水位、温度等
+ */
+package com.campus.water.entity;
+
+import lombok.Data;
+import jakarta.persistence.*;
+
+import java.math.BigDecimal;
+import java.time.LocalDateTime;
+
+@Data
+@Entity
+@Table(name = "water_supply_realtime_data")
+public class WaterSupplyRealtimeData {
+ @Id
+ @GeneratedValue(strategy = GenerationType.IDENTITY)
+ private Long id;
+
+ @Column(name = "device_id", length = 20)
+ private String deviceId;
+
+ @Column(name = "water_flow", precision = 8, scale = 2)
+ private BigDecimal waterFlow;
+
+ // 根据文档修正:字段名改为 water_press
+ @Column(name = "water_press", precision = 8, scale = 2)
+ private BigDecimal waterPress;
+
+ @Column(name = "water_level", precision = 8, scale = 2)
+ private BigDecimal waterLevel;
+
+ @Column(name = "temperature", precision = 5, scale = 2)
+ private BigDecimal temperature;
+
+ @Enumerated(EnumType.STRING)
+ @Column(name = "status", length = 20)
+ private DeviceStatus status = DeviceStatus.normal;
+
+ @Column(name = "timestamp")
+ private LocalDateTime timestamp = LocalDateTime.now();
+
+ @Column(name = "created_time")
+ private LocalDateTime createdTime = LocalDateTime.now();
+
+ public enum DeviceStatus {
+ normal, warning, error
+ }
+}
\ No newline at end of file
diff --git a/src/main/java/com/campus/water/entity/WorkOrder.java b/src/main/java/com/campus/water/entity/WorkOrder.java
new file mode 100644
index 0000000..efc2c90
--- /dev/null
+++ b/src/main/java/com/campus/water/entity/WorkOrder.java
@@ -0,0 +1,86 @@
+/**
+ * 工单实体类
+ * 对应表:work_order
+ * 用于管理维修、保养、巡检等工单信息,包括状态、优先级、处理记录等
+ */
+package com.campus.water.entity;
+
+import lombok.Data;
+import jakarta.persistence.*;
+import java.time.LocalDateTime;
+
+@Data
+@Entity
+@Table(name = "work_order")
+public class WorkOrder {
+ @Id
+ @Column(name = "order_id", length = 30)
+ private String orderId;
+
+ @Column(name = "alert_id")
+ private Long alertId;
+
+ @Column(name = "device_id", length = 20)
+ private String deviceId;
+
+ @Column(name = "area_id", length = 20)
+ private String areaId;
+
+ @Enumerated(EnumType.STRING)
+ @Column(name = "order_type", length = 50)
+ private OrderType orderType;
+
+ @Column(name = "description", columnDefinition = "TEXT")
+ private String description;
+
+ @Enumerated(EnumType.STRING)
+ @Column(name = "priority", length = 50)
+ private OrderPriority priority;
+
+ @Enumerated(EnumType.STRING)
+ @Column(name = "status", length = 50)
+ private OrderStatus status = OrderStatus.pending;
+
+ @Column(name = "assigned_repairman_id", length = 50)
+ private String assignedRepairmanId;
+
+ @Column(name = "created_time")
+ private LocalDateTime createdTime = LocalDateTime.now();
+
+ @Column(name = "grabbed_time")
+ private LocalDateTime grabbedTime;
+
+ @Column(name = "deadline")
+ private LocalDateTime deadline;
+
+ @Column(name = "completed_time")
+ private LocalDateTime completedTime;
+
+ @Column(name = "deal_note", columnDefinition = "TEXT")
+ private String dealNote;
+
+ @Column(name = "img_url", length = 500)
+ private String imgUrl;
+
+ @Column(name = "created_by", length = 50)
+ private String createdBy;
+
+ @Column(name = "updated_time")
+ private LocalDateTime updatedTime = LocalDateTime.now();
+
+ public enum OrderType {
+ repair, maintenance, inspection
+ }
+
+ public enum OrderPriority {
+ low, medium, high, urgent
+ }
+
+ public enum OrderStatus {
+ pending, // 原pending(待抢单)调整为待处理
+ processing, // 合并原grabbed(已抢单)和processing(处理中)
+ reviewing, // 新增状态:维修完成后等待审核
+ completed, // 原completed(已完成)保留
+ timeout; // 原timeout(超时)保留
+ }
+}
\ No newline at end of file
diff --git a/src/main/java/com/campus/water/entity/dto/request/DeviceStatusUpdateRequest.java b/src/main/java/com/campus/water/entity/dto/request/DeviceStatusUpdateRequest.java
new file mode 100644
index 0000000..37921ac
--- /dev/null
+++ b/src/main/java/com/campus/water/entity/dto/request/DeviceStatusUpdateRequest.java
@@ -0,0 +1,18 @@
+// 路径:com/campus/water/entity/dto/request/DeviceStatusUpdateRequest.java
+package com.campus.water.entity.dto.request;
+
+import com.campus.water.entity.Device;
+import jakarta.validation.constraints.NotBlank;
+import lombok.Data;
+
+@Data
+public class DeviceStatusUpdateRequest {
+ @NotBlank(message = "设备ID不能为空")
+ private String deviceId;
+
+ private Device.DeviceStatus status;
+
+ private String remark; // 状态变更备注
+ private String faultType; // 故障类型(状态为fault时必填)
+ private String faultDescription; // 故障描述(状态为fault时必填)
+}
\ No newline at end of file
diff --git a/src/main/java/com/campus/water/entity/dto/request/LoginRequest.java b/src/main/java/com/campus/water/entity/dto/request/LoginRequest.java
new file mode 100644
index 0000000..4e56ed3
--- /dev/null
+++ b/src/main/java/com/campus/water/entity/dto/request/LoginRequest.java
@@ -0,0 +1,17 @@
+// LoginRequest.java(原LoginDTO,按项目规范重命名)
+package com.campus.water.entity.dto.request;
+
+import lombok.Data;
+import jakarta.validation.constraints.NotBlank;
+
+@Data
+public class LoginRequest { // 命名改为Request,符合dto/request分类
+ @NotBlank(message = "用户名不能为空")
+ private String username;
+
+ @NotBlank(message = "密码不能为空")
+ private String password;
+
+ @NotBlank(message = "用户类型不能为空")
+ private String userType; // admin/repairer/user
+}
\ No newline at end of file
diff --git a/src/main/java/com/campus/water/entity/dto/request/RegisterRequest.java b/src/main/java/com/campus/water/entity/dto/request/RegisterRequest.java
new file mode 100644
index 0000000..5231f41
--- /dev/null
+++ b/src/main/java/com/campus/water/entity/dto/request/RegisterRequest.java
@@ -0,0 +1,43 @@
+package com.campus.water.entity.dto.request;
+
+import lombok.Data;
+import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.NotNull;
+
+/**
+ * 注册请求DTO,接收前端传递的注册参数
+ */
+@Data
+public class RegisterRequest {
+ // 通用字段
+ @NotBlank(message = "用户名不能为空")
+ private String username;
+
+ @NotBlank(message = "密码不能为空")
+ private String password;
+
+ @NotBlank(message = "用户类型不能为空")
+ private String userType; // admin/user/repairman
+
+ private String phone;
+
+ // 维修人员特有字段
+ private String repairmanId; // 维修人员ID
+
+ @NotBlank(message = "维修人员姓名不能为空")
+ private String repairmanName; // 维修人员姓名
+
+ @NotBlank(message = "负责区域ID不能为空")
+ private String areaId; // 负责区域ID
+
+ @NotBlank(message = "技能描述不能为空")
+ private String skills; // 技能描述
+
+ // 管理员特有字段
+ private String adminId;
+ private String role;
+
+ // 用户(学生)特有字段
+ private String studentId;
+ private String studentName;
+}
\ No newline at end of file
diff --git a/src/main/java/com/campus/water/entity/dto/request/StatisticsQueryRequest.java b/src/main/java/com/campus/water/entity/dto/request/StatisticsQueryRequest.java
new file mode 100644
index 0000000..ff6c558
--- /dev/null
+++ b/src/main/java/com/campus/water/entity/dto/request/StatisticsQueryRequest.java
@@ -0,0 +1,17 @@
+// com/campus/water/entity/dto/request/StatisticsQueryRequest.java
+package com.campus.water.entity.dto.request;
+
+import lombok.Data;
+import java.time.LocalDate;
+
+@Data // Lombok注解自动生成getter/setter
+public class StatisticsQueryRequest {
+ private String statType; // 统计类型(如by_device、by_area等)
+ private LocalDate startDate; // 开始日期
+ private LocalDate endDate; // 结束日期
+ private String areaId; // 区域ID
+ private String deviceType; // 设备类型
+ private String terminalId; // 补充终端ID字段(解决getTerminalId()错误)
+ private Integer limit; // 限制数量
+ // 若有其他字段可继续补充
+}
\ No newline at end of file
diff --git a/src/main/java/com/campus/water/entity/vo/AlarmStatisticsVO.java b/src/main/java/com/campus/water/entity/vo/AlarmStatisticsVO.java
new file mode 100644
index 0000000..95e0606
--- /dev/null
+++ b/src/main/java/com/campus/water/entity/vo/AlarmStatisticsVO.java
@@ -0,0 +1,13 @@
+// com/campus/water/entity/vo/AlarmStatisticsVO.java
+package com.campus.water.entity.vo;
+
+import lombok.Data;
+import java.util.Map;
+
+@Data
+public class AlarmStatisticsVO {
+ private Map levelCount; // 告警级别统计(解决setLevelCount()错误)
+ private Map statusCount; // 告警状态统计(解决setStatusCount()错误)
+ private double handleRate; // 处理率(解决setHandleRate()错误)
+ private long totalAlarms; // 总告警数
+}
\ No newline at end of file
diff --git a/src/main/java/com/campus/water/entity/vo/LoginVO.java b/src/main/java/com/campus/water/entity/vo/LoginVO.java
new file mode 100644
index 0000000..782df00
--- /dev/null
+++ b/src/main/java/com/campus/water/entity/vo/LoginVO.java
@@ -0,0 +1,14 @@
+// LoginVO.java(保持VO命名,无需修改)
+package com.campus.water.entity.vo;
+
+import lombok.Data;
+
+@Data
+public class LoginVO {
+ private String token; // 登录令牌
+ private String userId; // 用户ID
+ private String username; // 用户名
+ private String userType; // 用户类型
+ private String areaId; // 新增:维修人员所属区域ID
+
+}
\ No newline at end of file
diff --git a/src/main/java/com/campus/water/entity/vo/StatisticsVO.java b/src/main/java/com/campus/water/entity/vo/StatisticsVO.java
new file mode 100644
index 0000000..09a424b
--- /dev/null
+++ b/src/main/java/com/campus/water/entity/vo/StatisticsVO.java
@@ -0,0 +1,18 @@
+// com/campus/water/entity/vo/StatisticsVO.java
+package com.campus.water.entity.vo;
+
+import lombok.Data;
+import java.util.List;
+import java.util.Map;
+
+@Data // Lombok注解自动生成getter/setter
+public class StatisticsVO {
+ private String type; // 统计类型(解决setType()错误)
+ private String areaId; // 区域ID(解决setAreaId()错误)
+ private List dates; // 日期列表(解决setDates()错误)
+ private List waterUsage; // 用水量列表(解决setWaterUsage()错误)
+ private double totalUsage; // 总用水量(解决setTotalUsage()错误)
+ private double avgDailyUsage; // 日均用水量(解决setAvgDailyUsage()错误)
+ private List