SuperAPI AI 工具集

scaffolding-api-routes

编程与开发

查看项目

更新于 10-15 21:54

技能介绍

用途:依据旧系统审计产出的 docs/legacy-audit/API_Contracts.md,把既有的 Express 路由定义与中间件链迁移重建为 Next.js Route Handlers 或 Server Actions,目标是实现与旧系统 1:1 的功能对等。

主要能力:按资源在 src/app/api/ 下建立路由结构,动态段(如 [id])承载单个资源的 GET、PUT、DELETE,索引段(如 /api/posts/route.ts)承载集合的 GET 列表与 POST 新建;将旧中间件映射为模块化路由守卫,例如把 requiresLogin 映射为 getServerSession(authOptions) 检查,把资源所有权检查映射为资源归属守卫,把角色中间件映射为 session.user.role 校验;对 POST、PUT、PATCH 请求使用 src/lib/models/schema.ts 中的 Zod Schema 校验 req.json(),校验失败返回 422 Unprocessable Entity 或 400 Bad Request 及详细错误负载。

使用方式:按清单推进——分析 API 契约、确立路由架构、映射中间件到守卫、实现 Zod 校验、实现资源处理器;实现时需匹配审计中确定的响应封装形式,按 skip、limit、sort 参数还原分页与排序行为,并对齐 API_Contracts.md 中记录的成功与错误状态码。

适用场景:适用于从旧 Express 系统向 Next.js App Router 迁移、需要保持接口行为一致的改造工作。

限制:资料未提供具体运行命令、依赖安装方式、版本要求及完整代码示例;执行效果依赖已存在的 API_Contracts.md 与 Zod Schema。