SuperAPI AI 工具集

convex-backend-development

编程与开发

查看项目

更新于 10-16 05:53

技能介绍

用途:该技能用于为 dev-quiz-battle 应用构建和维护 Convex 后端函数,覆盖查询、变更与操作三类后端逻辑。

主要能力:按项目结构组织后端代码,convex/ 目录下包含 queries/(只读函数,如 games、users、answers、leaderboard)、mutations/(写操作,如创建游戏、提交答案、更新用户分数)、actions/(长时运行操作,如 AI 出题)、schema.ts(数据库模式定义)和 auth.ts(身份验证配置)。

使用方式:查询用 query 获取数据而不修改;变更用 mutation 修改数据库状态并校验输入;操作用 action 处理异步任务,例如调用外部 API。身份验证通过 ctx.auth.getUserIdentity() 获取已认证用户,未认证时抛错,并使用 identity.subject 作为用户 ID。参数统一使用 Convex 校验器(如 v.string()、v.id("users"))进行验证。

适用场景:数据库读写、身份验证、游戏数据管理、答案提交、排行榜与 AI 题目生成等。

限制与注意事项:需处理无效游戏代码(操作前先检查游戏是否存在)、并发提交(利用游戏状态防止重复答题)、敏感变更的身份验证,以及分数计算中基于时间的奖励与难度系数。