1.1 项目背景#

高校后勤管理中，学生宿舍水费管理是一项日常工作。传统的人工抄表和纸质记录方式效率低下，数据容易丢失，不便于统计查询。本课题旨在开发一套现代化的宿舍水费管理系统，实现宿舍信息、学生入住、用水记录的信息化管理，提高管理效率。

1.2 项目目标#

• 提供直观的图形化操作界面
• 实现宿舍信息的增删改查
• 实现学生入住管理（添加、编辑、删除）
• 实现用水记录的登记与维护
• 自动计算阶梯水费
• 支持数据持久化存储与加载

1.3 技术选型#

选型理由：WinUI 3是微软最新的原生UI框架，提供现代化的Fluent Design界面风格，支持亚克力材质、圆角控件、流畅动画等视觉效果。C++/WinRT编译为原生代码，启动速度快、内存占用低、性能优异。相较于传统的Qt Widgets或MFC，WinUI 3在界面美观度和用户体验上有显著优势。

1.4 项目分工#

2.1 功能需求#

2.2 非功能需求#

• 界面响应流畅，操作反馈及时
• 数据自动保存，避免意外退出导致数据丢失
• 界面布局自适应窗口大小
• 错误提示友好明确，避免程序崩溃
• 编译为原生x64代码，充分利用硬件性能

3.1 系统架构#

本系统采用基于MVC思想的分层架构，结合实际开发需求，设计为MVM（Model-View-Manager）模式：

各层职责：

• **View层：**负责界面展示和用户交互，通过IObservableVector数据绑定与Manager层联动。不对数据做直接修改，所有操作通过Manager层完成。
• **Manager层：**系统的核心枢纽。MainManager持有全局数据集合dorms（IObservableVector），提供所有业务操作的统一入口。内部委托DormManager处理单宿舍的学生和用水记录操作，委托RecordManager处理用水记录的年月索引管理。
• **Model层：**定义数据结构。所有Model类均实现INotifyPropertyChanged接口，属性变更时可自动通知UI刷新。
• **持久化层：**负责数据的序列化与反序列化。通过StdModelsConverter在WinRT对象和普通C++结构体之间转换，利用cereal库实现JSON格式的读写。

3.2 数据绑定机制#

本项目采用IObservableVector + INotifyPropertyChanged双层通知机制：
集合层面：MainManager持有IObservableVector，各页面通过绑定该集合获取数据。当集合发生Append、RemoveAt、SetAt等操作时，自动触发VectorChanged事件，ListView等列表控件自动刷新。
属性层面：所有Model类（Dorm、DormInfo、Student、WaterRecord）均实现INotifyPropertyChanged接口。当对象的某个属性被修改时，触发PropertyChanged事件，绑定到该属性的控件自动更新，无需整体替换对象。

3.3 核心数据结构#

4.1 主界面（MainPage）#

主界面采用NavigationView控件实现侧边导航布局：

• 顶部为应用标题和深色模式切换按钮
• 左侧为导航菜单（宿舍列表、设置等）
• 右侧为Frame控件承载子页面，实现页面间导航

4.2 宿舍列表页（DormListPage）#

功能：

• 展示所有宿舍信息列表
• 提供”添加宿舍”按钮
• 点击宿舍行查看/管理详细信息
• 列表项绑定Dorm对象，显示DormId、区域、楼栋等信息

4.3 宿舍管理表单（DormManageForm）#

功能：

• 显示宿舍详细信息（区域、楼栋、楼层、房间号、入住日期）
• 管理入住学生列表（添加、编辑、删除）
• 管理用水记录列表（添加、编辑、删除）
• 编辑宿舍基本信息（通过ContentDialog弹窗）
• 关闭按钮触发回调，通知父页面移除本表单

关键技术：

• 表单通过DataContext绑定到Dorm对象
• 编辑操作通过ContentDialog弹出EditDormForm、EditStudentForm、EditRecordForm
• 异步操作使用C++20协程（IAsyncAction、co_await）
• 关闭回调采用std::function实现，避免循环引用

4.4 编辑表单控件#

4.5 数据验证#

学生验证：

• 姓名不能为空
• 学号不能为空
• 学号长度必须为10位
• 学号必须全为数字字符
• 全局学号唯一性检查（遍历所有宿舍）

用水记录验证：

• 年份不低于2026年
• 月份在1-12之间
• 用水量不能为负数
• 用水量上限检查（不超过30000吨，含友好提示）

宿舍验证：

• 房间号格式检查
• 宿舍ID唯一性检查

4.6 数据持久化#

序列化流程

反序列化流程

4.7 深色模式#

通过ElementTheme枚举实现深色/浅色主题切换：

• 设置页面提供ToggleSwitch开关
• 切换时修改XamlRoot().Content()的RequestedTheme属性
• 使用ApplicationData::LocalSettings持久化用户偏好
• 应用启动时自动读取偏好并应用

4.8 月份补全逻辑#

当修改宿舍入住起始日期时，系统自动补全对应月份的用水记录：

• 若有已有记录，从最后一条记录的上一个月开始补
• 若无记录，从当前年月开始补
• 仅当新起始日期早于旧起始日期时才执行补全
• 补全年份和月份保持连续，不重复生成已有记录

5.1 C++/WinRT数据绑定的线程问题#

问题：在后台线程修改数据时，INotifyPropertyChanged的PropertyChanged事件必须在UI线程触发，否则会抛出RPC_E_WRONG_THREAD异常。

解决方案：

• 确保所有Model对象的属性修改均在UI线程执行
• 使用DispatcherQueue在需要时将操作调度到UI线程
• 数据加载和保存操作在UI线程完成，避免跨线程数据操作

5.2 多页面数据同步#

问题：DormListPage和DormManageForm可能同时引用同一个Dorm对象，一处修改需要多处感知。

解决方案：

• 所有数据由MainManager统一持有IObservableVector集合
• 各页面绑定同一个集合引用
• 修改后通过SetAt触发VectorChanged事件，所有绑定处自动刷新
• 属性级变更通过INotifyPropertyChanged自动通知

5.3 序列化与UI绑定的兼容#

问题：加载数据时如果直接替换整个集合引用，会导致UI绑定断开。

解决方案：

• 加载数据后不替换集合引用
• 使用Clear()清空原有数据
• 使用Append()逐个添加新数据
• 保持IObservableVector引用不变，UI绑定持续有效

5.4 编译资源不足#

问题：项目包含大量WinRT头文件，预编译头体积可达数GB，编译时虚拟内存不足导致失败。

解决方案：

• 增大Windows虚拟内存（页面文件）至16GB以上
• 使用x64编译配置（x86有4GB内存限制）
• 关闭不必要的后台程序释放内存
• 减少pch.h中不必要的头文件包含

5.5 月份补全年份与循环变量类型安全#

问题：月份补全逻辑涉及多年跨度的循环，使用size_t（无符号类型）作为循环变量时，递减到0后会溢出变成极大值，导致死循环或无限追加。

解决方案：使用有符号整数类型（int或int32_t）作为循环变量，确保递减到边界值时循环正确终止。

6.1 测试环境#

6.2 功能测试#

6.3 运行截图#

7.1 项目总结#

本项目基于WinUI 3 + C++/WinRT技术栈，成功实现了一套功能完整、界面现代的学生宿舍水费管理系统。系统采用MVM分层架构，通过IObservableVector和INotifyPropertyChanged实现响应式UI数据绑定，具备宿舍管理、学生管理、用水记录管理、阶梯水费自动计算、数据JSON序列化持久化、深色模式切换等完整功能。

在开发过程中，深入研究了C++/WinRT的运行时特性与线程模型、WinUI 3的数据绑定机制、现代C++的协程与智能指针、软件分层架构设计等核心技术。解决了多线程UI更新、跨页面数据同步、编译资源优化、序列化与UI绑定兼容等多个工程实际问题。

7.2 技术收获#

通过本次课程设计，加深了对以下知识的理解：

• C++/WinRT的COM接口机制与对象生命周期管理
• WinUI 3的XAML数据绑定与MV*架构模式
• 现代C++的协程（co_await、IAsyncAction）在异步UI操作中的应用
• JSON序列化库cereal在C++项目中的集成
• 桌面应用的分层架构设计与模块解耦
• 编译优化与调试技巧

7.3 未来改进方向#

• 引入图表组件，实现用水趋势的可视化展示
• 支持数据导出为Excel格式
• 添加管理员登录与权限管理功能
• 部署到局域网环境，支持多客户端同时访问
• 增加单元测试，提高代码质量保障
• 优化数据加载性能，支持更大规模数据量