SuperAPI AI 工具集

full-stack

编程与开发

查看项目

更新于 10-16 01:50

技能介绍

用途:面向同时涉及 FastAPI 后端与 Next.js 前端的跨层功能开发,例如新增 API 端点加 UI、数据模型变更等。

架构:后端为 FastAPI + Python 3.13+、TinyDB、LiteLLM;前端为 Next.js 16 + React 19、Tailwind CSS v4,采用 Swiss International Style;API 为 /api/v1/* 下的 REST 端点。

工作流:先设计 API 契约(路由、请求、响应),再实现后端(schema 放 apps/backend/app/schemas/,service 放 apps/backend/app/services/,router 放 apps/backend/app/routers/,并在 apps/backend/app/main.py 注册),然后实现前端(API 调用放 apps/frontend/lib/,组件放 apps/frontend/components/,页面集成放 apps/frontend/app/),最后端到端验证数据、样式与错误状态。

硬性规则:后端所有函数加类型提示,可变默认值用 copy.deepcopy(),错误在服务端记录、对客户端返回通用信息,API key 通过 api_key= 参数传入;前端遵循 Swiss International Style(rounded-none、硬阴影、Swiss 配色),运行 npm run lint && npm run format,处理 textarea 回车键,独立请求用 Promise.all()。

关键文件:后端启动 apps/backend/app/main.py,后端配置 apps/backend/app/config.py,前端页面 apps/frontend/app/,API 客户端 apps/frontend/lib/。

参考文档:API 契约 docs/agent/apis/front-end-apis.md,后端指南 docs/agent/architecture/backend-guide.md,前端流程 docs/agent/architecture/frontend-workflow.md,样式指南 docs/agent/design/style-guide.md。

限制:资料未提供安装命令、收费、平台与效果信息。