SuperAPI AI 工具集

schema-builder

编程与开发

查看项目

更新于 10-16 06:44

技能介绍

该技能用于构建结构良好的 Convex schema,遵循关系、索引和校验器的最佳实践。适用场景包括:创建新的 convex/schema.ts 文件、向现有 schema 添加表、设计数据模型关系、添加或优化索引,以及将嵌套数据转换为关系结构。

设计原则:采用文档-关系型结构,使用扁平文档加 ID 引用而非深度嵌套;为外键字段建立索引(如 userId、teamId);数组仅用于小型有界集合(少于 8192 项);使用 v.* 类型的严格校验器。

常用模式涵盖一对多关系、通过连接表实现的多对多关系,以及借助可选 parentId 和相应索引实现的层级数据。校验器参考包括 v.string()、v.number()、v.boolean()、v.null()、v.id("tableName")、v.optional()、v.union(v.literal(...))、v.object()、v.array()、v.record() 和 v.any()。

索引策略:单字段索引用于简单查找;复合索引用于过滤查询;注意 by_a_and_b 通常可覆盖 by_a,应移除冗余索引。检查清单要求所有外键都有索引、常见查询模式有复合索引、数组小型且有界(或转换为关系)、所有字段有正确校验器、枚举使用 union literal 模式、时间戳用 v.number()(毫秒)。

限制:资料未说明具体安装命令、价格或运行平台要求,暂未提供。