SuperAPI AI 工具集

backend-building

编程与开发

查看项目

更新于 11-06 16:18

技能介绍

Backend Building 是一个仅面向后端的技能,需叠加在由 webapp-building 生成的现有项目上。它向项目加入 api/ 与 contracts/ 目录,并按需加入 db/,但不会替换或修改已有前端文件。技术栈为 tRPC + Drizzle ORM + Hono + MySQL + OAuth 2.0。

主要能力:基础部分(Hono 服务器、tRPC、contracts)在首次运行时自动安装,并会就地修改 vite.config.ts、新增 tsconfig.server.json、合并 package.json、生成 .env 并执行 npm install。功能可增量安装:db 提供 Drizzle ORM + MySQL,添加 db/、api/queries/connection.ts、drizzle.config.ts,以及 DATABASE_URL 环境变量和 db/seed.ts 种子脚本脚手架;auth 提供 Kimi OAuth 与用户管理,添加 api/kimi/、登录页、useAuth、AuthLayout,并自动把 Login/NotFound 路由接入 App.tsx,auth 依赖 db 并自动包含。默认不带 --features 时等同于 auth(即 db + auth)。

使用方式:先 webapp-building 初始化前端,再运行 backend-building 的 init.sh 脚本并传入应用名,可选 --features db 或 --features auth。首次运行会自动将 TRPCProvider 接入 src/main.tsx,安装 auth 时还会把 Login/NotFound 路由接入 src/App.tsx;若输出提示需要手动接线,则按提示补充导入与包裹。之后运行 npm run check 验证零类型错误、npm run dev 启动开发服务器(默认 3000 端口)。数据库功能可运行 npm run db:push 同步 schema;生产迁移使用 db:generate 与 db:migrate。

适用场景:前端页面已完成、需要补后端 API 与数据库的项目;需要立即具备后端能力的全栈新项目;以及按需逐步增加数据库或登录能力的项目。

限制与注意事项:必须已有 webapp-building 项目;不要手写数据库实体的 TypeScript 接口,应使用 typeof table.$inferSelect;不要写原生 SQL;不要修改 api/lib/、api/kimi/ 等框架内部文件;前端不要从 api/ 导入,跨界类型用 @contracts/;tRPC 客户端名称为 trpc;输入需用 Zod 校验;外键列应使用 bigint 并匹配主键类型;不要为修复迁移失败而删表,也不要使用 db:push --force;不要修改 init.sh 生成的 .env 与基础设施文件;不要更改默认端口 3000。代码示例、安装命令与文档路径均以原文为准,未在资料中出现的功能、收费或平台信息暂未提供。