初识 HarmonyOS 单词打卡案例：端云一体化开发学习笔记

最近在鸿蒙开发实践中心浏览了“单词打卡学习”案例，这是一个用 HarmonyOS 端侧加 Appwrite 自托管 Serverless 云侧搭建的卡片式背单词应用，记录一下学习笔记。

案例的端侧用 ArkTS 加 ArkUI 实现登录、首页、闪卡、测试 4 个页面：首页展示今日打卡状态与连续天数，点击卡片翻转查看释义，看词选义测试答对计入学习进度，学完一个单词后打卡状态更新、连续天数累加。云侧用 Appwrite Functions 实现 register、login、getDailyWords、learnWord、getProgress、db-init 共 6 个函数，数据放在 3 个 NoSQL 文档集合中，58 词词库通过 db-init 初始化。

学习这个案例有几点收获：一是理解了端云一体化的调用链路，端侧通过 POST 方式调用云函数执行端点，结果包在 responseBody 字段内，需要二次解析；二是 Appwrite Functions 的编写规范，如 ESM 默认导出、node-appwrite v11、Server SDK 用 API Key 在服务端读写数据库，客户端不直接持有数据库凭据；三是自托管部署的注意事项，包括运行时选择 node-16.0、依赖打包进 tar.gz、execute 权限与 401 排障。

这个案例适合有 HarmonyOS 或后端基础、希望了解 Appwrite 端云一体化开发的读者，也可以作为教师指导下的自托管 Serverless 实践。下一步可以先在云端实践中把现成案例跑起来，再按完整实践步骤复现一次，加深对闪卡翻转、连续打卡逻辑与 NoSQL 数据模型的理解。