鸿蒙端云一体记账应用拆解:account_book 案例的三层架构与数据流

举报
yd_235984788 发表于 2026/11/11 10:02:49 2026/11/11
【摘要】 一、为什么看这个案例鸿蒙开发实践中心上架了一个「个人记账本」案例,标签是 ArkTS、云函数、端云同步、数据持久化,难度标为进阶,预计学习时间 180 分钟。它和常见的鸿蒙单机 Demo 不同——云侧不是调一个现成 BaaS 接口就完事,而是在华为云 ECS 上自托管了一套 Appwrite,再用云函数把业务逻辑包起来。把它当作端云一体应用的最小完整样本,比只看官方文档更容易理解边界该怎么...

一、为什么看这个案例

鸿蒙开发实践中心上架了一个「个人记账本」案例,标签是 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 接口。

这句话背后是三件事:

  1. 项目 ID 是公开的,它可以出现在客户端代码里,本身不构成密钥;
  2. 真正的密钥只放在云函数的环境变量里,端侧永远拿不到;
  3. 业务校验放在云端,包括这笔账目是否属于当前用户、字段是否合法。

很多端云应用的漏洞都出在第三条:把校验写在端侧,客户端改个参数就能写别人的数据。案例把校验收口到云函数,端侧只负责收集输入和展示结果。

七、聚合为什么要放到云端

统计 Tab 需要「本月餐饮花了多少、占比多少」这类数字。两种做法:

  • 端侧拉全量流水,本地算;
  • 云端算好,端侧只拿结果。

前者实现简单,但流水一多,每次进统计页都要传几百上千条记录,流量和耗时都难看;后者多写一个函数,换来的是常量级的响应体。

案例选了后者。这也解释了为什么 6 个函数里要专门留一个给 get-stats——它承担的是「让端侧不必知道全量数据」的职责。

八、上手成本

按案例页的标注:已有 ECS + Appwrite 环境约 1 到 2 小时;含云环境准备约 3 到 4 小时;预计学习时间 180 分钟。

实际投入主要花在环境上,代码量并不大。如果之前没碰过 Appwrite,建议先把它在 ECS 上跑起来、能用控制台建库建集合,再回来看这个案例,会顺很多。

九、小结

这个案例值得看的地方不在 UI,而在三条边界的划法:

  • 端侧按「写入 / 查询 / 聚合」拆 Tab,而不是只按页面美观拆;
  • 云侧把聚合单独成函数,不让端侧碰全量数据;
  • 校验和密钥全部收口在云端,端侧只保留公开标识。

记住这三条,再去看其他端云一体的案例,结构基本都能对上。

【声明】本内容来自华为云开发者社区博主,不代表华为云及华为云开发者社区的观点和立场。转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息,否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0)

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。