AquaGuard
家庭用水管理 Android App
把一次用水记录,
变成可追踪的节水习惯。
面向家庭节水场景的 Android 应用,连接用水记录、模拟传感器监测与统计洞察。我主要负责 Room 数据层、活动记录 CRUD、历史筛选,以及 Room 到 Insights 的数据联动。
为什么做这个项目
AquaGuard 是 FIT5046 Group 302 的 Android 小组项目,面向家庭用水记录、节水建议和可能漏水的提示。团队应用集成身份认证、天气、家庭设置、模拟传感器及提醒;我的工作聚焦真实记录如何持久化、如何随用户切换,以及如何稳定驱动统计界面。
个人负责 Room Entity / DAO / Repository / ViewModel 数据链路,Add / Edit 表单、History 的 CRUD 与搜索筛选,并完成按 UID 的记录隔离和 Room → Insights 联调。身份认证、天气、模拟传感器、设置和提醒等属于团队整体功能。
记录用水
按类型、日期、用量与备注添加、修改记录。
查看历史
按关键字、活动类型、日期组合筛选本人的记录。
联动统计
将真实 Room 记录供给 Insights,观察总量和图表更新。
从输入,到可检查的结果
- 01
识别当前用户
从团队身份认证链路获取 Firebase UID,确定本轮记录订阅的数据范围。
- 02
校验并保存
校验活动类型、日期和正数用量;编辑时保持记录 ID,将操作交给 ViewModel 与 Repository。
- 03
观察数据库
DAO 返回按 userId 查询的 Flow,History 收集记录并以 LazyColumn 展示。
- 04
筛选与统计联动
在当前用户的记录上执行组合筛选,并将 Room 记录映射给 Insights 进行日期和分类统计。
架构与职责划分
把不同的职责放在明确的边界内,让每一步的输入、输出和失败方式都可以单独理解。
UI 向下发起事件,Flow 向上返回数据;Insights 为团队页面,本人负责 Room 数据联调。
分层职责速览
核心工程实现
Room Entity / DAO 与单向数据链路
个人负责的数据链路沿用课程 Week 7 的 Compose UI → AndroidViewModel → Repository → DAO → Room Database。WaterActivity 将 ID、活动类型、日期、用量和备注持久化;DAO 提供 Flow 列表与 suspend insert / update / delete,Repository 封装页面需要的读写入口。
ViewModel 使用 viewModelScope 在 IO 调度器执行数据库操作,Compose 收集 Flow 渲染 History。新增、编辑或删除后由数据库变化推动列表刷新,数据库中的记录同时成为后续统计的输入,避免页面和图表分别维护样例数据。
Add / Edit 复用与稳定记录 ID
新增与编辑复用同一表单,通过 activityId 导航参数加载已有记录。表单使用 ExposedDropdownMenu、DatePicker、十进制用量输入和可选备注,保存前检查类型、日期及正数用量;无效输入在字段附近给出反馈。
编辑使用原 ID 更新记录,取消只退出表单,不执行数据库写入;History 删除先确认再提交。保持同一记录的身份,可以避免编辑操作变成额外插入,或表单返回后出现重复用水记录。
Firebase UID 作用域与组合筛选
记录附带 userId,DAO 按当前 Firebase UID 返回对应 Flow;账号切换后重新收集新用户的数据范围。History 在本人记录上组合关键字、活动类型和日期条件,以 LazyColumn 展示结果,并区分没有记录与筛选无匹配的状态。
UID 查询用于本地页面的数据隔离,不能替代云端安全规则。日期在 History、日期筛选和 Insights 中使用一致解释,已有课程验证在 Melbourne 时区模拟器上核对显示,减少日期转换带来的一天偏差。
Room → Insights 联动与课程验收
将当前用户的 Room 记录映射到团队 Insights 所需的数据结构,按日期与活动类型聚合总用水量和分类统计。新增、修改、删除沿同一数据链路更新列表及图表,个人负责的是持久化、记录操作与统计数据对接。
已有课程记录检查表单无效输入、取消、编辑不重复插入、重启后数据保留、A/B 用户数据分离和图表更新。身份认证、天气、设置、提醒及模拟传感器属于团队功能;漏水演示使用模拟数据,不代表接入真实家庭设备。
技术难点与设计取舍
为什么使用 Flow 驱动界面?
记录新增、编辑或删除后,数据库发出的新列表会推动页面刷新,避免让界面维护另一份独立的样例列表。
为什么按 UID 查询?
设备可能被不同账号使用。记录携带 userId,DAO 按当前 UID 查询,账号切换后重新订阅,以减少界面展示跨账号记录的风险。
如何保持日期语义一致?
History、日期筛选与 Insights 对日期的解释保持一致,并在 Melbourne 时区的模拟器上核对,避免本地日期转换产生前后一天偏移。
项目实景
来自本地课程报告资料的 Pixel_9 模拟器原始截图,展示课程测试记录。点击图片可打开原图查看细节。
如何验证,以及做到哪里
模拟器操作证据
已有 Pixel_9 / API 37 截图记录新增、编辑、历史、筛选、删除确认和 Insights 联动。
CRUD 与持久化
既有验收记录覆盖无效输入、表单取消、重启后记录保留,以及编辑不重复生成记录。
用户与图表联动
既有回归核对 A/B 用户数据分离,以及增删改后统计值与图表随 Room 数据变化。
当前实现边界
这是团队课程项目,展示重点为我的 Member 3 工作范围。漏水相关功能使用课程模拟传感器数据,不代表已接入真实家庭传感器。本页展示的是既有课程验收截图,本轮没有重新执行 Android 全量回归。
资料来源
内容依据当前项目 README 与架构文档整理;展示工程设计和验证方式,不将示意图或流程描述作为实时运行数据。PatchCanopy
墨尔本社区绿地 Web 应用


