用途:指导构建响应式、类型安全、生产级的后端,避免通用“AI 味”架构。资料称其原则适用于任何后端技术栈,如 Firebase、Supabase、tRPC、Prisma、Convex、GraphQL 或传统 REST,具体语法因平台而异。
主要能力与原则:默认实时(所有查询为活查询,数据变更自动推送,无需轮询或 webhook 变通);数据访问经服务端函数中介,不直接把数据库暴露给客户端;以查询、变更、动作等普通函数作为 API,函数签名即 API 契约;模式优先设计,模式是唯一事实来源并生成类型、写入时校验;端到端类型安全,无 any、无手工接口漂移;变更默认在 ACID 事务中运行;避免请求瀑布,在服务端一次加载关联数据;按领域共置服务端逻辑;面向智能体的开发体验;尽量降低基础设施负担;优先使用平台原语(认证、文件存储、定时任务、向量搜索、文本搜索);支持乐观更新;无状态设计;优雅降级;函数级限流。
按资料,反模式包括:为每个资源生成 REST 样板、以行级安全作为主要认证模型、客户端直连数据库、隐藏查询的 ORM、轮询获取新鲜度、单独搭实时基础设施、手工缓存失效、分层架构、客户端请求瀑布、以迁移文件为事实来源、拼接原始 SQL、硬编码配置、缺少输入校验、错误形状不一致、过深中间件链、新鲜度混用、无界查询、热路径同步外部调用、缺少超时、大规模偏移分页。
使用方式:资料未提供具体安装命令或调用步骤,仅给出设计原则与不完整的代码示例(如 getMessages、sendMessage、cleanupExpiredTokens),代码示例为示意,需按所选技术栈调整。资料末尾在 helper 函数处被截断。
适用场景:需要实时、类型安全、可横向扩展的后端功能,如聊天、仪表盘、队列监控、AI 智能体监控等。
限制:资料未说明定价、平台支持范围、性能数据或具体安装方式;部分内容为不完整的代码片段,实施时需结合自身技术栈。