cap-apps-appdb

用途：面向 Domo App Platform 的 AppDB 开发，规则要求以 Toolkit 优先，使用 AppDBClient 而非裸调 domo.get/post/put/delete 端点，旧端点方案已归档至 archive/legacy-rules/domo-appdb.md。安装与引入：yarn add @domoinc/toolkit，import { AppDBClient } from '@domoinc/toolkit'，并用 new AppDBClient.DocumentsClient('TasksCollection') 建立客户端。主要能力：create 创建文档；get 支持查询操作符如 $eq、$ne、$in 及 $and 组合；update 与 partialUpdate（配合 $set、$inc 等）；delete 支持单个或 ID 数组。关键坑：.get() 返回的文档字段嵌套在 doc.content 中，不在顶层；doc.id 用于 update/delete，datastoreId、collectionId、owner、createdOn 等为顶层元数据；结果可能在 response.body 或直接是数组，需按 response.body || response 并校验 Array.isArray 再映射。使用要求：集合仍需在 manifest.json 的 collections 中声明并定义 schema 列。检查清单：确认 manifest 集合映射、使用 AppDBClient 做 CRUD、从 content 解包后再用于 UI、正确使用查询与更新操作符、补充错误处理与加载状态。限制：资料未提供更多平台版本、权限或性能说明。