用途:该技能提供通用后端开发工作流,适用于设计、构建、重构后端 API,数据与业务逻辑建模,部署或 CI/CD 准备,以及代码质量审查。不适用于技术特定代码(应使用 nodejs、express、nest 等技能)或前端开发。
主要能力与约定: 一是 API 设计与版本化。新端点按 /api/v1/feature 组织,破坏性变更新建 /api/v2 并弃用 v1;推荐 URL 版本化,避免查询参数版本化。 二是数据建模与校验。在 API 边界(controller/route)始终校验,领域逻辑与数据库层不再重复校验;推荐 zod,已有 yup 项目保持一致,旧 JavaScript 可用 joi;数据持久化按结构化关系选 PostgreSQL、文档型选 MongoDB、缓存选 Redis,ORM 推荐 Prisma,需原生 SQL 可用 Knex 或 Drizzle。 三是集中错误处理。区分可预期运维错误与编程错误,统一响应格式(如 REST 的 status/message/code),并按 400/401/403/404/409/500 分类。 四是环境配置。所有配置使用环境变量,如 DATABASE_URL、JWT_SECRET、PORT,启动时用 zod 校验,缺失即快速失败。 五是性能优化。先测量再优化,常见手段包括索引、EXPLAIN ANALYZE、修复 N+1、Redis 缓存、分页(每页 50–100 条)、gzip 压缩与限流;避免过早优化。
使用方式:先定义契约与 schema 并文档化,再按 controller 校验、service 承载业务规则、repository 抽象数据库的方式实现,示例中 POST /api/v1/orders 即遵循此流程。配套检查项涵盖版本化、边界校验、集中错误中间件、环境变量、迁移回滚、鉴权、限流、日志上下文、API 文档、单元与集成测试、CI/CD、健康检查与监控告警。
适用场景与限制:适用于通用后端架构与流程指导;具体框架实现需委派给相应技术技能。资料未提供收费、价格、平台或效果数据。