个人记账本：鸿蒙端云一体记账与云端聚合统计：鸿蒙端云开发实践记录

最近在鸿蒙开发实践中心完整走了一遍「个人记账本：鸿蒙端云一体记账与云端聚合统计」这个案例，把过程和一些体会记下来，方便后面复盘。

一、案例场景

用 ArkTS 构建端侧三 Tab 记账 App（记账 / 明细 / 统计），云侧在华为云 ECS 自托管 Appwrite 1.9：6 个 node-16 零依赖云函数负责注册 / 登录 / 增删查与 get-stats 云端聚合，账目存入 account_book_db 的 users / transactions 集合；端侧只带公开项目 ID 调 executions 接口，业务校验与分类占比计算全部收口云端。附幂等初始化与一键部署脚本，verify-api 19 项端到端验收全绿。难度进阶：已有 ECS + Appwrite 环境约 1-2 小时，含云环境准备约 3-4 小时（本案例时长按 180 分钟计）。

难度定位：入门。

二、环境准备

• 华为云账号（用于云端开发环境与代码托管）
• DevEco Studio + HarmonyOS SDK
• 了解 ArkTS 的基本语法与 ArkUI 的声明式布局

三、涉及到的技术点

• ArkTS：这是本案例的核心技术点之一，实际编码时值得单独过一遍。
• 云函数：这是本案例的核心技术点之一，实际编码时值得单独过一遍。
• 端云同步：这是本案例的核心技术点之一，实际编码时值得单独过一遍。
• 数据持久化：这是本案例的核心技术点之一，实际编码时值得单独过一遍。

四、实践中的几个体会

1. 先跑通再优化：把工程模板跑起来、能在预览器里看到界面，比一上来就抠细节更有正反馈。
2. 状态驱动 UI：ArkUI 里把数据状态理清楚，界面基本就顺了；反过来先堆布局容易返工。
3. 端云之间的边界：哪些数据放端侧、哪些收口到云端，最好在写第一行代码前定下来。
4. 善用案例仓：遇到不确定的写法，直接对照案例仓里的实现比自己猜要快。

五、小结

这个案例把「从需求到能跑起来的应用」这条链路串了一遍，适合当作鸿蒙入门的练手项目。
下一步我打算把它和自己手上的业务场景结合，做一次改造练习。

案例代码仓：https://gitcode.com/harmony-practice-center/account_book.git