SuperAPI AI 工具集

real-time-backend

编程与开发

查看项目

更新于 10-16 06:44

技能介绍

用途:指导构建响应式、类型安全、生产级的后端,避免通用“AI 堆砌”式架构,适用于 Web、移动端等各类前端背后的后端系统。

主要能力与原则:默认响应式,所有查询都是实时查询,数据变化时消费者自动收到更新,无需轮询或 webhook;数据读写一律经服务端函数,认证、校验、限流与业务逻辑集中于此;以函数作为 API,查询、变更、动作即普通函数,函数签名即契约,无路由文件与控制器类;Schema 优先,类型化 Schema 作为唯一事实来源,生成类型并在写入时校验;端到端类型安全,类型从 Schema 流向服务端函数与客户端,避免 any 与手写接口;默认 ACID 事务,每次变更在一致快照上运行;避免请求瀑布,服务端组合一次往返加载关联数据;服务端逻辑按领域就近组织;面向智能体的开发体验,签名自文档化;最小化基础设施负担,优先托管服务;使用平台原语(认证、文件存储、定时任务、向量与文本搜索);支持乐观更新;设计为无状态;优雅降级(超时、部分结果);限流。

反模式:REST 样板工厂、以行级安全作为主要鉴权、客户端直连数据库、隐藏查询的 ORM、轮询刷新、独立的实时基础设施、手动缓存失效、分层架构拆分单一操作、客户端请求瀑布、以迁移文件为事实来源、无界查询、大规模下的偏移分页。

实现建议:在函数边界校验输入;查询保持确定性只读;优先数据库约束;设计幂等写入;返回结构化错误;为每条查询路径建索引;读写分离;按读取方式建模数据;使用游标分页;尽早规划多租户。注意事项:实现复杂度应与问题匹配,简单 CRUD 无需事件溯源与 CQRS。文中代码示例为示意,需按所选技术栈调整。