鸿蒙端云一体记账应用拆解:account_book 案例的三层架构与数据流
一、为什么看这个案例
鸿蒙开发实践中心上架了一个「个人记账本」案例,标签是 ArkTS、云函数、端云同步、数据持久化,难度标为进阶,预计学习时间 180 分钟。它和常见的鸿蒙单机 Demo 不同——云侧不是调一个现成 BaaS 接口就完事,而是在华为云 ECS 上自托管了一套 Appwrite,再用云函数把业务逻辑包起来。
把它当作端云一体应用的最小完整样本,比只看官方文档更容易理解边界该怎么划。
二、端侧:三个 Tab 对应三类状态
案例的端侧是 ArkTS 写的三 Tab 结构:记账、明细、统计。
三个 Tab 看上去只是页面划分,实际对应三种不同的数据形态:
- 记账是写入侧,只需要表单校验和一次提交,状态最轻;
- 明细是列表侧,要分页、要按时间倒序、要处理空态和失败重试;
- 统计是聚合侧,要的是「按分类汇总后的数字」,不是原始流水。
这个划分的意义在于:写入、查询、聚合三种诉求对后端的要求完全不同。如果都塞进一个接口,端侧就要自己算聚合,代码会迅速膨胀。
三、云侧:为什么在 ECS 上自托管 Appwrite
案例用的不是托管型后端服务,而是在华为云 ECS 上自己跑 Appwrite 1.9。
自托管的好处很直接:数据库、认证、权限都落在自己机器上,数据不出自己的环境,也没有按调用量计费的顾虑;代价是要自己管机器、管升级、管备份。案例把它归到「进阶」难度,主要成本就在这里——已有 ECS 和 Appwrite 环境约 1 到 2 小时能跑通,从零准备云环境要 3 到 4 小时。
如果只是想验证端侧 UI,完全没必要走这条路;但只要涉及真实账号体系和长期数据,自托管的可控性就开始值钱。
四、六个云函数怎么分工
案例的云侧逻辑由 6 个 node-16 运行时、零第三方依赖的云函数承担:注册、登录、增、删、查,以及一个专门做聚合的 get-stats。
「零依赖」是个值得注意的细节。Appwrite 的云函数运行时本身提供了访问数据库的 SDK,业务代码只要读写集合即可,不需要再引 ORM 或者数据库驱动。少一层依赖,冷启动更快,部署包也更小。
而把 get-stats 单独拆出来,说明聚合没有被当成「查询的一种」,而是当成独立能力对待——它的输入是时间范围和分类维度,输出是汇总数字,和取流水完全是两条路径。
五、数据模型
数据库叫 account_book_db,里面两个集合:
- users:账号信息,和 Appwrite 自带的认证体系配合使用;
- transactions:账目流水,一条记录对应一笔收入或支出。
模型刻意做得很薄。分类没有单独建集合,而是作为字段挂在流水上;统计需要的分类占比交给云端聚合函数现算,不落中间表。对记账这种写入频繁、查询维度单一的场景,这个取舍是合理的——少一张表就少一次一致性维护。
六、安全边界:三处不能省
案例描述里有一句关键的话:端侧只带公开的项目 ID 调 executing 接口。
这句话背后是三件事:
- 项目 ID 是公开的,它可以出现在客户端代码里,本身不构成密钥;
- 真正的密钥只放在云函数的环境变量里,端侧永远拿不到;
- 业务校验放在云端,包括这笔账目是否属于当前用户、字段是否合法。
很多端云应用的漏洞都出在第三条:把校验写在端侧,客户端改个参数就能写别人的数据。案例把校验收口到云函数,端侧只负责收集输入和展示结果。
七、聚合为什么要放到云端
统计 Tab 需要「本月餐饮花了多少、占比多少」这类数字。两种做法:
- 端侧拉全量流水,本地算;
- 云端算好,端侧只拿结果。
前者实现简单,但流水一多,每次进统计页都要传几百上千条记录,流量和耗时都难看;后者多写一个函数,换来的是常量级的响应体。
案例选了后者。这也解释了为什么 6 个函数里要专门留一个给 get-stats——它承担的是「让端侧不必知道全量数据」的职责。
八、上手成本
按案例页的标注:已有 ECS + Appwrite 环境约 1 到 2 小时;含云环境准备约 3 到 4 小时;预计学习时间 180 分钟。
实际投入主要花在环境上,代码量并不大。如果之前没碰过 Appwrite,建议先把它在 ECS 上跑起来、能用控制台建库建集合,再回来看这个案例,会顺很多。
九、小结
这个案例值得看的地方不在 UI,而在三条边界的划法:
- 端侧按「写入 / 查询 / 聚合」拆 Tab,而不是只按页面美观拆;
- 云侧把聚合单独成函数,不让端侧碰全量数据;
- 校验和密钥全部收口在云端,端侧只保留公开标识。
记住这三条,再去看其他端云一体的案例,结构基本都能对上。
- 点赞
- 收藏
- 关注作者
评论(0)