读鸿蒙案例笔记：单词打卡学习（HarmonyOS + Appwrite 端云一体化）

今天在鸿蒙开发实践中心读了“单词打卡学习：HarmonyOS + Appwrite 端云一体化”案例（仓库 harmony-practice-center/word-check-in），把要点记下来，方便以后照着动手。

一、案例是做什么的
一个卡片式背单词应用：首页展示今日 10 个未学单词，进入闪卡模式点卡片翻转看释义；完成看词选义测试后计入学习进度，进度条更新；学完一个单词，打卡状态变为“已完成”，连续打卡天数累加。

二、端云怎么分工
端侧用 ArkTS/ArkUI，4 个页面：登录、首页、闪卡、测试。云侧用自托管 Appwrite，6 个云函数（register、login、getDailyWords、learnWord、getProgress、db-init），数据库 word_db 下有 users_col、words_col、learn_records_col 3 个集合，种子词库 58 个单词。
关键链路：端侧不直接持有数据库凭据，通过 POST /v1/functions/{id}/executions 调用 Function 执行端点，Function 用 Server SDK（API Key）读写数据库，再把结果包在 responseBody 里返回。

三、阅读时记下的注意事项

1. 案例 README 明确：函数 execute=[“any”] 为无鉴权公开访问，仅面向学习演示，不含正式上架所需的鉴权、限流等生产化改造。
2. 自托管 Appwrite 需确认 node-16.0 运行时可用，部署前先查 runtimes；依赖 node-appwrite v11，版本不匹配会报 EBADENGINE。
3. API Key、APPWRITE_HOST、Project ID 等占位符只放在函数环境变量或本地 .env（已加入 .gitignore），不要写进代码或提交。
4. 完成标志很具体：6 个函数调用全部返回 code:0，word_db 下 3 个集合与 58 个单词就绪，端侧能登录并看到打卡状态与连续天数。

四、说明
这篇是阅读笔记，还没有实际部署和跑通；下一步有环境时，再按 README 的“快速体验”路线（获取已验证版本、配最小配置、启动云侧、构建安装端侧）动手验证，到时再补一篇实操记录。