jw_JIAWEI WANG运行实景 ↗
← 返回项目作品
05 / FIT5046 · ANDROID DEVELOPMENT / CASE STUDY

AquaGuard

家庭用水管理 Android App

把一次用水记录,
变成可追踪的节水习惯。

面向家庭节水场景的 Android 应用,连接用水记录、模拟传感器监测与统计洞察。我主要负责 Room 数据层、活动记录 CRUD、历史筛选,以及 Room 到 Insights 的数据联动。

ROLE小组课程项目 · Member 3
FOCUS家庭用水管理 Android App
SOURCE课程报告 / 模拟器实景 ↗
KotlinJetpack ComposeRoomFlowAndroidViewModelFirebase Auth
01 / THE PROBLEM

为什么做这个项目

AquaGuard 是 FIT5046 Group 302 的 Android 小组项目,面向家庭用水记录、节水建议和可能漏水的提示。团队应用集成身份认证、天气、家庭设置、模拟传感器及提醒;我的工作聚焦真实记录如何持久化、如何随用户切换,以及如何稳定驱动统计界面。

MY CONTRIBUTION / 个人贡献

个人负责 Room Entity / DAO / Repository / ViewModel 数据链路,Add / Edit 表单、History 的 CRUD 与搜索筛选,并完成按 UID 的记录隔离和 Room → Insights 联调。身份认证、天气、模拟传感器、设置和提醒等属于团队整体功能。

01

记录用水

按类型、日期、用量与备注添加、修改记录。

02

查看历史

按关键字、活动类型、日期组合筛选本人的记录。

03

联动统计

将真实 Room 记录供给 Insights,观察总量和图表更新。

02 / HOW IT WORKS

从输入,到可检查的结果

  1. 01

    识别当前用户

    从团队身份认证链路获取 Firebase UID,确定本轮记录订阅的数据范围。

  2. 02

    校验并保存

    校验活动类型、日期和正数用量;编辑时保持记录 ID,将操作交给 ViewModel 与 Repository。

  3. 03

    观察数据库

    DAO 返回按 userId 查询的 Flow,History 收集记录并以 LazyColumn 展示。

  4. 04

    筛选与统计联动

    在当前用户的记录上执行组合筛选,并将 Room 记录映射给 Insights 进行日期和分类统计。

03 / SYSTEM DESIGN

架构与职责划分

把不同的职责放在明确的边界内,让每一步的输入、输出和失败方式都可以单独理解。

ARCHITECTURE MAPAquaGuard · Room 数据与界面联动
个人负责的 Room 数据层与活动管理链路,使用 UID 作用域和 Flow 驱动 History 及团队 Insights 的数据展示。
蓝色:核心模块 · 虚线:辅助依赖 / 独立路径↔ 横向滑动查看完整架构

UI 向下发起事件,Flow 向上返回数据;Insights 为团队页面,本人负责 Room 数据联调。

分层职责速览

01 / 界面层Compose Add / Edit / History + 团队 Insights 页面
02 / 状态层AndroidViewModel → Repository
03 / 持久化层DAO → Room water_activities
04 / 用户范围Firebase UID → Flow<List<WaterActivity>>

核心工程实现

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 用户数据分离和图表更新。身份认证、天气、设置、提醒及模拟传感器属于团队功能;漏水演示使用模拟数据,不代表接入真实家庭设备。

04 / ENGINEERING DECISIONS

技术难点与设计取舍

01

为什么使用 Flow 驱动界面?

记录新增、编辑或删除后,数据库发出的新列表会推动页面刷新,避免让界面维护另一份独立的样例列表。

02

为什么按 UID 查询?

设备可能被不同账号使用。记录携带 userId,DAO 按当前 UID 查询,账号切换后重新订阅,以减少界面展示跨账号记录的风险。

03

如何保持日期语义一致?

History、日期筛选与 Insights 对日期的解释保持一致,并在 Melbourne 时区的模拟器上核对,避免本地日期转换产生前后一天偏移。

06 / VERIFY & REFLECT

如何验证,以及做到哪里

01

模拟器操作证据

已有 Pixel_9 / API 37 截图记录新增、编辑、历史、筛选、删除确认和 Insights 联动。

02

CRUD 与持久化

既有验收记录覆盖无效输入、表单取消、重启后记录保留,以及编辑不重复生成记录。

03

用户与图表联动

既有回归核对 A/B 用户数据分离,以及增删改后统计值与图表随 Room 数据变化。

CURRENT SCOPE

当前实现边界

这是团队课程项目,展示重点为我的 Member 3 工作范围。漏水相关功能使用课程模拟传感器数据,不代表已接入真实家庭传感器。本页展示的是既有课程验收截图,本轮没有重新执行 Android 全量回归。

资料来源

内容依据当前项目 README 与架构文档整理;展示工程设计和验证方式,不将示意图或流程描述作为实时运行数据。
NEXT PROJECT / 06

PatchCanopy

墨尔本社区绿地 Web 应用

↗