SuperAPI AI 工具集

vercel-reference-architecture

设计与创作

查看项目

更新于 10-15 23:30

技能介绍

用途:为 Vercel 项目提供可上生产的分层参考架构,明确边缘、服务端、静态、客户端各层职责,适合新项目设计或架构评审。

主要能力:一是目录结构约定,public 存放静态资源,src/app 使用按路由,api 目录放无服务器函数,lib 放共享工具,components 分 ui 与 features;二是使用 zod 在导入时校验环境变量,缺失即快速失败,并提供类型安全访问;三是用惰性单例初始化数据库客户端,减少冷启动,开发环境避免多实例;四是 API 路由模式,包含查询参数处理、缓存头 s-maxage 与 stale-while-revalidate、统一错误响应与 requestId;五是边缘中间件做鉴权与重定向,通过 matcher 排除 _next/static、_next/image、favicon.ico;六是健康检查端点,强制不缓存,检查数据库连通性并返回版本、区域与时间戳;七是 vercel.json 配置区域、安全响应头、重写与永久重定向。

使用方式:按步骤建立目录与文件,安装 zod、Prisma 等依赖,在 Vercel 控制台为目标环境配置所需变量,将代码放入对应文件后部署。

适用场景:设计新的 Vercel 项目、审查现有项目分层、为 API 与中间件建立统一规范。

限制与注意事项:文档未提供具体收费、价格或性能数据;需理解 Vercel 部署模型并使用 TypeScript,推荐 Next.js 14+;中间件 matcher 过宽会命中静态资源,数据库连接池可能耗尽,需使用连接池器;API 路由必须放在 src/app/api/ 下且文件名为 route.ts。多环境设置见 vercel-multi-env-setup,本资料未展开。